[yast-devel] Documenting REST API using restility
Hi all, I have integrated restility to WebYaST - restility is now available as a ruby gem (rubygem-restility) and there is a new rake task 'restdoc' which is called from 'package' task (the REST documentation is automatically generated during package build). If you want to check how it looks like then - install restility gem from YaST:Web repository [ well, the build has not been finished completely yet, e.g. FACTORY package still waits in the queue... :-( ] - update to the latest rest service from GIT - call 'rake restdoc' in plugins/system - restart the rest service (because of the new public/ overlay) - and finally point your browser to http://localhost:8080/system/restdoc/index.html You can look at plugins/system/restdoc/api.txt to see the source. (I'm going to write a wiki page how to create a REST documentation...) -- Best Regards Ladislav Slezák Yast Developer ------------------------------------------------------------------------ SUSE LINUX, s.r.o. e-mail: lslezak@suse.cz Lihovarská 1060/12 tel: +420 284 028 960 190 00 Prague 9 fax: +420 284 028 951 Czech Republic http://www.suse.cz/ -- To unsubscribe, e-mail: yast-devel+unsubscribe@opensuse.org For additional commands, e-mail: yast-devel+help@opensuse.org
On Thu, Sep 10, 2009 at 04:23:50PM +0200, Ladislav Slezak wrote:
- install restility gem from YaST:Web repository [ well, the build has not been finished completely yet, e.g. FACTORY package still waits in the queue... :-( ]
Workaround: get the *.gem (osc co YaST:Web rubygem-restility) and simply "gem install restility-0.0.1.gem"
- update to the latest rest service from GIT - call 'rake restdoc' in plugins/system - restart the rest service (because of the new public/ overlay) - and finally point your browser to http://localhost:8080/system/restdoc/index.html
Nice! -- Martin Vidner, YaST developer http://en.opensuse.org/User:Mvidner Kuracke oddeleni v restauraci je jako fekalni oddeleni v bazenu -- To unsubscribe, e-mail: yast-devel+unsubscribe@opensuse.org For additional commands, e-mail: yast-devel+help@opensuse.org
* Ladislav Slezak <lslezak@suse.cz> [Sep 10. 2009 16:24]:
Hi all,
I have integrated restility to WebYaST - restility is now available as a ruby gem (rubygem-restility) and there is a new rake task 'restdoc' which is called from 'package' task (the REST documentation is automatically generated during package build).
If you want to check how it looks like then - install restility gem from YaST:Web repository [ well, the build has not been finished completely yet, e.g. FACTORY package still waits in the queue... :-( ] - update to the latest rest service from GIT - call 'rake restdoc' in plugins/system - restart the rest service (because of the new public/ overlay) - and finally point your browser to http://localhost:8080/system/restdoc/index.html
Very nice, thank you ! Klaus --- SUSE LINUX Products GmbH, GF: Markus Rex, HRB 16746 (AG Nürnberg) -- To unsubscribe, e-mail: yast-devel+unsubscribe@opensuse.org For additional commands, e-mail: yast-devel+help@opensuse.org
participants (3)
-
Klaus Kaempf
-
Ladislav Slezak
-
Martin Vidner