bc/php-rest

0.1.4 2017-05-26 12:47 UTC

Requires

• composer/composer: 1.3.*
• gossi/php-code-generator: ~0
• gossi/swagger: ~0
• rest-suite/lib: ~0
• symfony/console: 3.1.*
• symfony/yaml: 3.1.*

Requires (Dev)

• codeception/codeception: 2.2.*
• slim/slim: 3.*

MIT

• inpu
• iD

README

php-rest (work in progress)

RESTapi server generator based on openapi specs and slim framework

Install

Command line: composer require rest-suite/generator
-or-
In composer.json

{
  "require-dev": {
    "rest-suite/generator" : "~0"
  }
}

Usage

Generate code

./vendor/bin/apigen generate --namespace 'Example\Api' --output ./examples ./tests/_data/swagger.yml

Usage:
  generate [options] [--] [<spec>]
  gen
  g

Arguments:
  spec                        path to swagger specs [default: "swagger.yml"]

Options:
  -o, --output[=OUTPUT]       output path for generated code [default: "./"]
  -ns, --namespace=NAMESPACE  base namespace for generated code
  -m, --models                only generate files for models
  -c, --controllers           only generate files for controllers
  -t, --tests                 only generate files for tests
  -s, --settings              only generate dist settings files
      --override              override existing files  
      --sync                  uses with "--override" option, sync client code between re-generations

Synchronization

TODO: Two-way sync (schema <=> code) with user-code preservation

Examples

Examples of generated code:

• Simple api - specs, code

• Pet Shop - specs, code

Documentation

TODO

Contribution

Feel free to PR, fork and whatever