feat: add OpenAPI support (#368)

Author: alanpoulain

README.md

@@ -2,10 +2,10 @@
 
 `schema` is a command line tool part of [the API Platform framework](https://api-platform.com) that instantly generates a set
 of PHP classes from vocabularies such as (but not limited to) [Schema.org](https://schema.org)
-or [ActivityStreams](https://www.w3.org/TR/activitystreams-core/).
+or [ActivityStreams](https://www.w3.org/TR/activitystreams-core/) or from an [OpenAPI](https://www.openapis.org/) documentation.
 
-[![GitHub Actions](https://github.com/api-platform/schema-generator/workflows/CI/badge.svg?branch=master)](https://github.com/api-platform/schema-generator/actions?query=workflow%3ACI+branch%3Amaster)
-[![Coverage Status](https://coveralls.io/repos/github/api-platform/schema-generator/badge.svg?branch=master)](https://coveralls.io/github/api-platform/schema-generator?branch=master)
+[![GitHub Actions](https://github.com/api-platform/schema-generator/workflows/CI/badge.svg?branch=main)](https://github.com/api-platform/schema-generator/actions?query=workflow%3ACI+branch%3Amain)
+[![Coverage Status](https://coveralls.io/repos/github/api-platform/schema-generator/badge.svg?branch=main)](https://coveralls.io/github/api-platform/schema-generator?branch=main)
 
 ## Documentation
 

bin/compile

@@ -8,20 +8,33 @@ rm -rf tmp/original
 
 php schema.phar generate tmp/original tests/e2e/schema.yml -n -vv --ansi;
 
-diff tests/e2e/original/App/Entity/Brand.php tmp/original/App/Entity/Brand.php;
-diff tests/e2e/original/App/Entity/Person.php tmp/original/App/Entity/Person.php;
-diff tests/e2e/original/App/Entity/PostalAddress.php tmp/original/App/Entity/PostalAddress.php;
-diff tests/e2e/original/App/Entity/Thing.php tmp/original/App/Entity/Thing.php;
-diff tests/e2e/original/App/Enum/GenderType.php tmp/original/App/Enum/GenderType.php;
+diff tests/e2e/original/App/Schema/Entity/Brand.php tmp/original/App/Schema/Entity/Brand.php;
+diff tests/e2e/original/App/Schema/Entity/Person.php tmp/original/App/Schema/Entity/Person.php;
+diff tests/e2e/original/App/Schema/Entity/PostalAddress.php tmp/original/App/Schema/Entity/PostalAddress.php;
+diff tests/e2e/original/App/Schema/Entity/Thing.php tmp/original/App/Schema/Entity/Thing.php;
+diff tests/e2e/original/App/Schema/Enum/GenderType.php tmp/original/App/Schema/Enum/GenderType.php;
 
 # Already generated files
 
 cp -r tests/e2e/customized tmp/
 
 php schema.phar generate tmp/customized tests/e2e/schema.yml -n -vv --ansi;
 
-diff tests/e2e/customized/App/Entity/Brand.php tmp/customized/App/Entity/Brand.php;
-diff tests/e2e/customized/App/Entity/Person.php tmp/customized/App/Entity/Person.php;
-diff tests/e2e/customized/App/Entity/PostalAddress.php tmp/customized/App/Entity/PostalAddress.php;
-diff tests/e2e/customized/App/Entity/Thing.php tmp/customized/App/Entity/Thing.php;
-diff tests/e2e/customized/App/Enum/GenderType.php tmp/customized/App/Enum/GenderType.php;
+diff tests/e2e/customized/App/Schema/Entity/Brand.php tmp/customized/App/Schema/Entity/Brand.php;
+diff tests/e2e/customized/App/Schema/Entity/Person.php tmp/customized/App/Schema/Entity/Person.php;
+diff tests/e2e/customized/App/Schema/Entity/PostalAddress.php tmp/customized/App/Schema/Entity/PostalAddress.php;
+diff tests/e2e/customized/App/Schema/Entity/Thing.php tmp/customized/App/Schema/Entity/Thing.php;
+diff tests/e2e/customized/App/Schema/Enum/GenderType.php tmp/customized/App/Schema/Enum/GenderType.php;
+
+php schema.phar generate tmp/original tests/e2e/schema_openapi.yml -n -vv --ansi;
+
+diff tests/e2e/original/App/OpenApi/Entity/Book.php tmp/original/App/OpenApi/Entity/Book.php;
+diff tests/e2e/original/App/OpenApi/Entity/Parchment.php tmp/original/App/OpenApi/Entity/Parchment.php;
+diff tests/e2e/original/App/OpenApi/Entity/Review.php tmp/original/App/OpenApi/Entity/Review.php;
+diff tests/e2e/original/App/OpenApi/Entity/TopBook.php tmp/original/App/OpenApi/Entity/TopBook.php;
+
+php schema.phar generate tmp/original tests/e2e/schema_openapi_ref.yml -n -vv --ansi;
+
+diff tests/e2e/original/App/OpenApi/Entity/Order.php tmp/original/App/OpenApi/Entity/Order.php;
+diff tests/e2e/original/App/OpenApi/Entity/Pet.php tmp/original/App/OpenApi/Entity/Pet.php;
+diff tests/e2e/original/App/OpenApi/Entity/User.php tmp/original/App/OpenApi/Entity/User.php;

box.json.dist

@@ -14,6 +14,9 @@
   "files": [
     "vendor/twig/twig/src/TwigTest.php"
   ],
+  "directories": [
+    "vendor/cebe/php-openapi/src/spec"
+  ],
   "force-autodiscovery": true,
 
   "compression": "GZ",

composer.json

@@ -46,7 +46,9 @@
         "twig/twig": "^3.0",
         "nette/php-generator": "^3.6 || ^4.0-dev",
         "nette/utils": "^3.1 || ^4.0-dev",
-        "nikic/php-parser": "^4.13"
+        "nikic/php-parser": "^4.13",
+        "cebe/php-openapi": "^1.6",
+        "symfony/string": "^5.2 || ^6.0"
     },
     "require-dev": {
         "api-platform/core": "^2.5",