Comments (3)
dbu
commented on August 26, 2024
we have good experiences with swagger, which is relatively lightweight.
i did not find what ALPS would look like but it seems to be on a more
abstract level? if the two are similar, we can maybe generate both from
the same data.
i am not sure to what extent we can actually do this. afaik the main
challenge is to describe the data models. we could generate model
description from phpdoc + doctrine mappings. but a user might decide to
let some mapped properties be handled by doctrine listeners or something
rather than editable by the client.
from resource-rest-bundle.
ElectricMaxxx
commented on August 26, 2024
Generating that stuff out of the doctrine metadata is a good idea, Would work for both. I really love swagger.io too, but do we have a chance to dynamically create documentations? Ah, yea that is the point swagger and RAML a kind of documentations, but ALPS is a little bit different, it describes the semantics what you can do on resources, and what you can do on its properties. You can find nice slides here.
@olivergierke provided both in his example app (alps and schema) but i think that is automaticially created by a spring rest component and their swagger annotations. He described it in some slides. But Maybe wo should push that feature into HateoasBundle or FosRestBundle to get a generic solution, that we can implement in here?
from resource-rest-bundle.
dbu
commented on August 26, 2024
i am unsure how much we can automate semantic things. but if its
possible then FOSRestBundle or the HateoasBundle sound like the best
place for that. or maybe even a stand alone library/bundle if none
exists yet (though i don't intend to start yet another project).
for swagger, there is https://github.com/zircote/swagger-php which would
really profit from a symfony integration.
from resource-rest-bundle.
Related Issues (19)
- Check that JmsSerializerBundle is enabled HOT 9
- Access security HOT 5
- Add depth setting HOT 4
- Add a depth request parameter HOT 1
- create api endpoint to serve partials HOT 19
- Add support for nelmio ApidocBundle
- jms/serializer-bundle 1.0.0 version support HOT 2
- Switch to Puli 1.0.x (dev-master is behind and there are conflicts) HOT 1
- Move SonataEnhancer to SonataAdminBundle HOT 4
- Support the Resource Descriptions (remove Enhancers from here).
- Add configuration option for security paths
- Temprorary require symfony/translation HOT 8
- Remove temporary required symfony/translation
- Support REST, not just GET HOT 10
- Broken Master Branch HOT 2
- bug: bad verification guardAccess with tree block HOT 2
- Add node type to the response HOT 9
- JMS\Serializer error
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from resource-rest-bundle.