swagger-codegen.java.txt

                   
   SWAGGER-CODEGEN  
                   



ALTERNATIVES ==>                  #OpenAPI:
                                  #  (OpenAPI 2.0, soon 3.0)
                                  #  - swagger-codegen (prefered):
                                  #     - most high-profile
                                  #     - in Java
                                  #     - generates client SDKs, API stubs from Mustache templates
                                  #     - many different languages
                                  #  (OpenAPI 2.0/3.0)
                                  #  - swagger-node-codegen:
                                  #     - JSON-SCHEMA-REF-PARSER: derererences JSON references
                                  #     - scaffolds Handlebars templates using OpenAPI specification
                                  #     - default template: EXPRESS, body parsing, cookies, logging, config, routing
                                  #  (OpenAPI 3.0)
                                  #  - autorest:
                                  #     - very Microsoft technologies specific, quite lot of boilerplate and bad documentation
                                  #     - many different languages
                                  #  - openapi-codegen:
                                  #     - like swagger-codegen (reuse same templates) but in JavaScript instead of Java
                                  #     - also uses:
                                  #        - REFTOOLS: dereferences JSON references
                                  #        - SWAGGER-TOOLS: specification validation
                                  #        - OPENAPI-SAMPLER: autogenerate examples if missing
                                  #  (OpenAPI 2.0)
                                  #  - swagger-node:
                                  #     - not well maintained
                                  #     - scaffolds template with SWAGGER-NODE-RUNNER (see its doc) + NODEMON
                                  #     - also uses:
                                  #        - SWAGGER-TOOLS: for the specification validation
                                  #        - SWAGGER-TEST-TEMPLATES + MOCHA
                                  #        - SWAGGER-EDITOR

AVAILABLES TEMPLATES ==>          #  - html (see widdershins docs)
                                  #  - bash (see swagger_codegen_bash docs)
                                  #  - node (see micro frameworks declarative summary docs)
                                  #  - javascript, typescript-fetch, typescript-node (see swagger-js)