Jeremy McAnally
2007-Jul-08 01:22 UTC
[ANN] dcov (the documentation analyzer for Ruby code) v.0.1.0 released!
I pushed version 0.1 of my Google Summer of Code project -- dcov -- to RubyForge yesterday, and I hope you guys can take advantage of it (and let me know if it breaks! :)). dcov is a tool to help you analyze the documentation of your Ruby code. At the present, it only checks for the presence of documentation and generates a report based on that, but in the future it will check for "quality" (e.g., did you document all the parameters? Is there an options list, and if so, is it documented? and so on). See my post about documentation quality on http://blog.mrneighborly.com/ if you''d like to voice your opinion on what should be used to measure quality. (Disclaimer: I realize quality is very subjective, and you are able to write your own analyzers very easily if you''d like to do your own subjective analysis) Now, on to the release. This is version 0.1 (Young and Feeble Edition). It will analyze your source code and produce an HTML report (using Ruport currently) of what it found out. It it invoked by simply running: dcov my_file.rb my_other_file.rb that_file.rb The coverage.html file will be created in the current working directory. Please do use the RubyForge bug tracker (right now) to file bugs. I''m working on a better solution, but for now that will function. If there''s enough interest, I''ll spin up a mailing list or you can join me in #dcov on Freenode. You can get the release one of three ways: (1) gem install dcov (2) download it from RubyForge here: http://rubyforge.org/projects/dcov/ (3) grab it from svn: svn co svn://rubyforge.org/var/svn/dcov Visit http://dcov.rubyforge.org/ to stay up to date on what''s going on with this project... Enjoy, Jeremy -- http://www.jeremymcanally.com/ http://www.railsdocumentation.org/ My free Ruby e-book: http://www.humblelittlerubybook.com/book/ My blogs: http://www.mrneighborly.com/ http://www.rubyinpractice.com/ --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Ruby on Rails: Talk" group. To post to this group, send email to rubyonrails-talk-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org To unsubscribe from this group, send email to rubyonrails-talk-unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org For more options, visit this group at http://groups.google.com/group/rubyonrails-talk?hl=en -~----------~----~----~----~------~----~------~--~---