There should be an API module that autogenerates an XML schema (kind of like a blueprint for the API's output, specs @ http://www.w3.org/XML/Schema#dev ), much like the current API help is autogenerated.
Version: 1.13.x
Severity: enhancement
Description
Description
Details
Details
- Reference
- bz14025
Related Objects
Related Objects
Event Timeline
Comment Actions
Since gerrit 6394 the api modules have a method getResultProperties, which is also outputted with action=paraminfo. So the information about the output exist and maybe can be processed to xml/xsd
Comment Actions
Victor:
This report has been in ASSIGNED status for more than one year and you are set as its assignee. In case that you are not actively working on a fix, please reset the bug status to NEW/UNCONFIRMED.
In case you do not plan to work on a fix in the near future: Please also edit the "Assigned To" field by clicking "Reset Assignee to default", in order to not prevent potential contributors from working on a fix. Thanks for your help!
[assigned>=1y]
Comment Actions
I'm proposing to WONTFIX this bug: situation has changed since then, XML requests are less than 10% overall, and all the API developers hate XML with passion. We should be working towards killing this format, not adding more enterprisey cruft to it.
Comment Actions
@MaxSem - i had to lookup "cruft" - the meaning seams to be unneccessary garbage. Thank you for having added this to my english vocabulary.
at https://github.com/WolfgangFahl/JMediawiki I am trying to generate just another Mediawiki Java API library. The approach is using JAXB which would work nicely if there was a XSD Schema. This would also have the advantage that the XML would eventually get a clean(er) structure e.g. not using the same node name for different concepts.. JAXB will automatically also create JSON from the Schema - so the question JSON/XML is not so much about the format itself but about the definitions behind it.
Currently as a workaround I am using some xml results to generate xsd from the xml. This does not give the proper result needed and is just a semi-automatic approach. I'd appreciate if this bug report would be reopened to make an XSD schema available that can be used for JAXB generation.
Comment Actions
Marking as "needs volunteer". Note that the XML format is headed for eventual death (or at least deprecation)
Comment Actions
Sorry, it's just not gonna happen even if we had a patch. That patch will not be accepted.
Comment Actions
Maybe we need another Bugreport / change request then. I there will be no XML/XSD it would still be great and useful to have something like a "Schema" as a basis. Obviously the generator that creates the help page could also generate a computer readable api description. So far I was able to create some 16 Java classes by reverse engineering the xml with a semi-automatic process:
See:
https://github.com/WolfgangFahl/Mediawiki-Japi/tree/master/src/main/java/com/bitplan/mediawiki/japi/api
It would be great to check the results against the "official" api. I'd like to make that part of the build process of Mediawiki-Japi