yard-virtus

This is a fork of yard-virtus which relaxes the YARD requirement to allow working with later versions of YARD. The gem is called "yard-virtus2" but all other interactions use "yard-virtus" as in the original.

This gem helps to generate YARD documentation for classes built using Virtus. It extracts information about attributes, their types and writers so you don't need to specify it manually.

This gem depends on exact details of implementation of Virtus so it's locked to a particular version. In the future I wan to adapt versioning scheme for this gem which will reflect supported Virtus version.

Add the gem to your Gemfile (inside development or documentation group):

  gem "yard-virtus2", "= 0.0.5"

If you use YARD via Rake and YARD::Rake::YardocTask or via custom ruby script add

  require "yard-virtus2"

If you use YARD command line tool use --plugin switch like this

 yard --plugin virtus

Standard YARD mixin handler throws UndocumentableError when it encounters mixin which uses method call (like include Virtus.model). It serves as a warning and does not break parsing process but it could be annoying if you have a lot of Virtus based models. This gem includes mokey-patch for YARD::Handlers::Ruby::MixinHandler. It is not loaded by default and you need to do it explicitly in your Rakefile with:

  require "yard/virtus/mixin_handler_monkey_patch"

This library is still work in progress and is not recommended for production use.

• Detect if class gets virtus functionality via inheritance (partially done).
• Attach documentation about various features inherited from Virtus to namespaces.
• Extract default values of attributes.

This library uses eval with $SAFE level 3 to evaluate list of options in attribute declarations. Setting $SAFE to level 3 means it can not do destructive operations on your file system but it can damage objects which are already in memory.

Dmitry Dzema (@dzema)