In my neverending quest to generate documentation so I don''t have to
write it myself, I am proud to announce a new form of documentation
generation: Provider features.
Each resource type can now declarate "features" (currently defined as
a list of methods a provider must define). Providers can then be
tested to see whether they provide a given feature; for instance:
if package.provider.upgradeable?
...
end
This helps get rid of the messiness of testing for specific methods,
and it''s an intro into a framework that will allow us to be very
informative about how well a given provider functions. As a taste of
what this generated documentation will look like, check this out:
http://luke.madstop.com/typedocs.html#package
I''ve only added feature definitions to the package type so far, but I
hope to add a few more before I release 0.22.2 tomorrow.
Features still aren''t completely functional -- there are a couple of
tests I''d like them to be able to do that they can''t -- but I
think
they''re a great start.
Next I''d like to write a report that will tell us what providers are
functional on a given platform.
Cheers.
--
Levy''s Law:
The truth is always more interesting than your preconception of
what it might be.
---------------------------------------------------------------------
Luke Kanies | http://reductivelabs.com | http://madstop.com
