swagger2

Archived

Watch

No description

This repository has been archived on 2026-08-22. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.

JavaScript 93.9%
Perl 6.1%

Find a file

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
Jan Henning Thorsen d06820caed Released version 0.89 - Deprecated for real		2017-03-02 23:03:45 +01:00
examples	Add http() to swagger2-client.js	2016-04-11 17:15:57 +02:00
lib	Released version 0.89	2017-03-02 23:03:45 +01:00
t	Deprecated for real	2017-03-02 23:03:28 +01:00
.gitignore	Swagger2::Editor can load specifications over HTTP	2015-07-07 09:37:59 +02:00
.perltidyrc	Change to 100 characters	2016-03-31 09:52:16 +02:00
.ship.conf	Initialized	2014-12-02 16:26:02 +01:00
.travis.yml	Will build JSON::Validator from master on github	2015-09-27 15:48:42 +02:00
Changes	Released version 0.89	2017-03-02 23:03:45 +01:00
cpanfile	Add deprecation warning to Mojolicious::Plugin::Swagger2	2016-12-24 14:34:27 +01:00
Makefile.PL	Released version 0.88	2016-12-24 14:35:54 +01:00
MANIFEST.SKIP	Avoid making a new cache file each time the tests are run	2015-07-07 08:33:56 +02:00
README	Released version 0.89	2017-03-02 23:03:45 +01:00
README.pod	Initialized	2014-12-02 16:26:02 +01:00

README

NAME
    Swagger2 - Deprecated

VERSION
    0.89

DEPRECATION WARNING
    The Swagger2 distribution is no longer actively maintained. Only severe
    bug fixes and pull requests will move this code forward. The reason
    behind this is that the code is too complex and hard to maintain.

    So what should you use instead?

    * Swagger2

      Swagger2 is either not very useful or replaced by JSON::Validator.

    * Swagger2::Client

      No alternatives. The issue with this module is that it does not
      understand if you have parameters with the same name. There might be a
      OpenAPI::Client at some point, but it is currently no plans to write
      it.

    * Swagger2::Editor

      No alternatives.

    * Swagger2::POD

      Swagger2::POD is not very good and also very hard to maintain.
      Mojolicious::Plugin::OpenAPI has a HTML renderer which makes
      documentation that is much easier to read and always in sync with the
      application.

      When that is said: The renderer in Mojolicious::Plugin::OpenAPI need
      refinement.

    * Swagger2::SchemaValidator

      Mojolicious::Plugin::OpenAPI has the validator built in. For other
      purposes, use JSON::Validator or JSON::Validator::OpenAPI instead.

    * Mojolicious::Command::swagger2

      No alternatives.

    * Mojolicious::Plugin::Swagger2

      Use Mojolicious::Plugin::OpenAPI instead. Mojolicious::Plugin::OpenAPI
      plays much nicer together with the Mojolicious framework.

COPYRIGHT AND LICENSE
    Copyright (C) 2014-2015, Jan Henning Thorsen

    This program is free software, you can redistribute it and/or modify it
    under the terms of the Artistic License version 2.0.

AUTHOR
    Jan Henning Thorsen - "jhthorsen@cpan.org"