68 Commits

Author SHA1 Message Date
Guilhem Niot
383fb78360 Add Api-Platform 3.x support 2022-09-25 21:32:09 +02:00
Emil Masiakowski
f808eafbe4
Read discriminator mapping from file configuration (#2034)
* Read discriminator mapping from file configuration

* Use more realistic test data
2022-09-25 19:56:43 +02:00
Christopher Davis
6b2ef45b24 Merge remote-tracking branch 'origin/master' into constraint_groups 2022-05-11 08:18:52 -05:00
Baptiste Lafontaine
1302bc7568
Create an enum model describer (#1965)
* Create an enum model describer

* Bump Api-Platform

Co-authored-by: Guilhem Niot <guilhem@gniot.fr>
2022-04-04 11:42:44 +02:00
Christopher Davis
7357de9c16 Add a Configuration Option to Enable Validation Groups
If this was turned on by default, that seems like a _large_ BC break as
folks entire OpenAPI doc could change underneath them.

The config option defaults to false and users can enable it if they
desire.
2021-11-06 07:13:56 -05:00
Guilhem Niot
9c729ab7b7
Fix support without twig (#1878)
* fix support without twig

* Support null openApiRenderer

* Register a twig extension instead of registering twig function at runtime

* fix tests
2021-09-22 23:43:32 +02:00
Zdeněk Drahoš
1f29be85f4 Use json renderer in controller 2021-07-29 12:01:54 +02:00
Zdeněk Drahoš
1b9be28ad6 Enable dumping docs to yaml 2021-07-29 11:57:00 +02:00
Zdeněk Drahoš
9cb6006b69 Refactoring including assets 2021-06-27 10:00:43 +02:00
Zdeněk Drahoš
5124f07ece Enable dumping html docs with cdn and offline assets 2021-06-27 09:24:35 +02:00
Zdeněk Drahoš
4ebee933c4 Extract rendering docs from command and controller 2021-06-27 08:41:33 +02:00
Saleh Saeed
774057a91a
Revert DocumentationController name 2021-02-08 22:54:21 +01:00
Saleh Saeed
46ef005787 Add Yaml Documentation
Fixes #1613
2021-02-01 23:29:53 +01:00
Guilhem Niot
bc2b3f7530 Merge branch '3.x' 2020-12-29 10:30:06 +01:00
Guilhem Niot
e57ede23ed Use annotations reader without cache 2020-12-29 10:27:09 +01:00
Filip Benčo
d932b06bbb
Add support for compound properties (#1651)
* Add support for compound properties

* Fix CS & Tests

* Another fixing :D

* Final CS fix

* Allow complex compound properties

* cs

* Update the Upgrading guide

* Update php doc

* Add Support for Nullable properties

* Fix CS

* Fix CS

* Add Support for Nullable Types & Schemas as in OA3

* Update Nullable Property handling

* CS

* Fix tests

* Accept also nullable config for Alternative model names

* Refactor nullable refs

* Fix CS & Tests

* Another CS

* Revert "Another CS"

This reverts commit 03ada32b3263f3537d2af63f0abe79bd4a9ac0b5.

* Revert "Fix CS & Tests"

This reverts commit 369f2ccd170aebeeb9d87e9e00cba5cea62d5529.

* Revert "Refactor nullable refs"

This reverts commit 91cdf6fd0130f3ebf415de99f8a91edbc764255e.

* Revert "Revert "Refactor nullable refs""

This reverts commit 0e50fc1938ce3e620fc655a7d1e9284a9f8c24f0.

* Revert "Revert "Fix CS & Tests""

This reverts commit 228d3ca994eb4622c4db81aaa5f32845862e5616.

* Revert "Revert "Another CS""

This reverts commit a5b08dedf5bca8fb711b816c62bed2de9f1c9521.

* Improve nullable refs description

Co-authored-by: Filip Benčo <filip.benco@websupport.sk>
Co-authored-by: Guilhem Niot <guilhem.niot@gmail.com>
2020-06-16 13:11:53 +02:00
Mantis Development
b3c53beead
Add dump command to print out swagger JSON. (#1537) (#1540)
* Add dump command to print out swagger JSON.

Command outputs to stdout, so can be redirected to a file.
Pretty prints output by default.
--no-pretty can be passed to remove whitespace from json output if it does not need to be human readable

* Update for styleci corrections

* Fix CS and add type hint

* REbase + Updates to documentation of dump command.

* Remove defaultName - config file specifies this
Add return value to dump command

* Update for OA3

* Add a test case

* update command name

* Fix the tests

Co-authored-by: Guilhem Niot <egetick@gmail.com>
Co-authored-by: Guilhem Niot <guilhem.niot@gmail.com>
2020-05-31 11:39:50 +02:00
Guilhem Niot
82d766bfe4 Merge branch 'v3' 2020-05-30 18:23:49 +02:00
Guilhem Niot
dfff2476d8
Add @SerializedName support (#1636)
* Add `@SerializedName` support

* Also test `@SerializedName` on properties

* Fix tests with sf < 4.2

* Fix the tests

* Update the CHANGELOG
2020-05-30 18:08:25 +02:00
Filip Benčo
78664ef9ec
OpenApi 3 Support (#1623)
* Initial pass for OA3 upgrade

* Fix Util Tests

* Fix first batch of Unit Tests. Up to Model

* Another batch of fixed tests

* Update annotations

* Convert Model & Property Describers

* Update tests, Fix RouteDescribers, FIx additional bugs

* Another batch of updates

* Another batch of fixed Functional Tests

* Fix FunctionalTest tests

* Fix Bazinga Tests

* FIx FOS Rest

* Fix JMS TEsts & describers

* Fix all Tests

* Fix few stuff from own CR

* CS Fixes

* CS Fixes 2

* CS Fixes 3

* CS Fixes 4

* Remove collection bug

* Updates after first CRs

* CS

* Drop support for SF3

* Update the docs

* Add an upgrade guide

* misc doc fixes

* Configurable media types

* Code Style Fixes

* Don't use ::$ref for @Response and @RequestBody

* Fix upgrading guide

* Fix OA case

Co-authored-by: Filip Benčo <filip.benco@websupport.sk>
Co-authored-by: Guilhem Niot <guilhem.niot@gmail.com>
Co-authored-by: Mantis Development <mantis@users.noreply.github.com>
2020-05-28 13:19:11 +02:00
Guilhem Niot
1a9a5d7ce6
Merge pull request #1552 from cyberemissary/duplicate-param-cleanup
Added describer that removes duplicate parameters when using $ref.
2020-03-14 11:41:27 +01:00
Filip Benčo
90bae6738a Update after PR 2020-02-18 20:45:58 +01:00
Guilhem Niot
3710e95d26 Rework PR 2020-01-09 21:45:37 +01:00
cyberemissary
9b9dbe69dd Added describer that removes duplicate parameters when using $ref. 2020-01-09 14:29:52 -05:00
Filip Benčo
e9926b8025 Fix BC 2019-12-13 23:32:30 +01:00
Filip Benčo
f16ac2e785 Fix tests 2019-12-13 22:54:58 +01:00
Filip Benčo
2de03859c0 Fix some bugs and confings 2019-12-13 22:20:13 +01:00
Filip Benčo
f9eacee3fd Add exntensible Property Describers 2019-12-13 21:40:42 +01:00
Maxime Helias
1464865de1 Remove deprecated notice about controller_name_converter 2019-11-19 17:23:12 +01:00
Asmir Mustafic
d6ea99420e Allow model describers on jms custom types (#1495)
* allow model describers on jms custom types

* add fallback describer

* test custom type def

* remove object_fallback describer from the container when jms is not active
2019-04-16 12:13:33 +02:00
Guilhem N
2cd7522d14
Add class attribute 2019-02-18 17:20:39 +01:00
Guilhem N
1db38a25b0
Do not autowire the form extension 2019-02-18 08:38:56 +01:00
Alexander Wenzel
f1bb40c6e4 Fix #1462 by allowing all supported implementations of NormalizerInterface in ApiPlatformDescriber
> add test
2019-01-11 16:54:58 +01:00
Guilhem N
37efa7228b
Add a documentation form extension (#1234)
* Adding format and example extensions. Getting child type better for collections

Fixing copyrights

Fixing style issues

Fixing style issues

Fixing style issues

* Adding DocumentationExtension

* Adding error for invalid properties

* Reverting switch

* Missing entity break

* Removing unecessary doc

* Removing unecessary method

* Style change

* Adding break for number, integer, and text types

* Extracts the documentation form extension
2018-02-19 10:56:51 +01:00
Guilhem N
5b574e883f
Fix Api-Platform support 2018-02-13 08:49:43 +01:00
Guilhem N
f193fdb1f1
Inject the AnnotationsReader in Model describers instead of internal classes (#1203) 2018-01-24 19:58:38 +01:00
Robert Gruber
fe9d12772b Add some missing property attributes for JMS model describer (#1196)
* Add some missing property attributes for JMS model describer

* Introduce own Swagger definition annotation reader

* Shorten annotation mapping by using merge
2018-01-24 15:20:20 +01:00
Michelle Sanver
7d01a420fa Made nelmio_api_doc.generator a public service
The service was not defined public or private, which threw deprecation notices in the tests where we use it from the container. It is now declared public explicitly to not have deprecations.
2018-01-15 17:05:34 +01:00
Guilhem N
393a6c061e
Add areas support (#1169)
* Add areas support

* Document the Areas feature

* Allow to expose swagger area as JSON

* Fixes

* last fixes
2018-01-05 13:08:02 +01:00
David Buchmann
3fa948aee8 set up DI and add type support 2017-12-19 08:56:35 +01:00
Myroslav
01f691c456 support swagger property annotation to extend description properties of model (#1125)
* support swagger property annotation to descripe properties of model

* support swagger property annotation to descripe properties of model

* fix issues from PR review

* rename method

* remove redundant annotations and revert changes into composer.json

* fix issues from PR comments

* use symfony 3 for default tests

* revert chages

* use symfony 3 for default tests

* revert changes in travis config
2017-12-03 19:30:44 +01:00
Guilhem Niot
9f2436dce3 fix tests 2017-10-22 11:48:33 +02:00
Guilhem Niot
eeeab29ec9 Execute the CollectionModelDescriber earlier 2017-08-01 22:13:01 +02:00
Guilhem Niot
bb14c85179 Merge pull request #1035 from nelmio/basepath
Use request base url
2017-07-25 11:26:14 +02:00
Guilhem Niot
1fb8371e80 Add DateTime support 2017-07-25 10:31:23 +02:00
Guilhem Niot
0b05a23625 Use request base url 2017-07-05 15:43:15 +02:00
Guilhem Niot
c7367d6644 Add a controller exposing the documentation in json 2017-06-26 11:32:23 +02:00
Guilhem Niot
0bd45e6486 Fix an issue caused by #1007 2017-06-22 22:30:56 +02:00
Guilhem Niot
18eec11ab0 Merge pull request #948 from nelmio/SWAGGERUI
[3.0] Add Swagger-ui support
2017-05-13 11:57:42 +00:00
Guilhem N
260a2689a6 Add Swagger-ui support 2017-05-13 13:55:13 +02:00