Repository is archived
No commit activity in last 3 years
No release in over 3 years
Displays Serverspec specs in YARD output.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.7
~> 10.0
~> 2.6

Runtime

~> 0.7
 Project Readme

Yard::Serverspec::Plugin

This plugin adds Serverspec specs to YARD output.

Installation

Add this line to your application's Gemfile:

gem 'yard-serverspec-plugin'

And then execute:

$ bundle

Or install it yourself as:

$ gem install yard-serverspec-plugin

Usage

Add comments to your specs.

# @param kernel.panic Kernel behaviour on panic: delay
# @note default: 0 (wait forever). Check 30 seconds before rebooting.
context linux_kernel_parameter('kernel.panic') do
  its(:value) { should <= 30 }
end

You're ready to go:

yardoc -e yard-serverspec spec/*_spec.rb

or You can do this by adding the following to your Rakefile:

namespace :doc do
  begin
    require 'yard'
    require 'yard/rake/yardoc_task'
    require 'yard/serverspec/plugin'
  rescue LoadError
    raise 'YARD is not available. Try installing it.'
  end
  YARD::Config.load_plugin('serverspec-plugin')
  YARD::Rake::YardocTask.new do |t|
    t.files = ['spec/*_spec.rb']
  end
end

and type:

rake doc:yard

then, you can see doc:

example-doc

Contributing

  1. Fork it ( https://github.com/rrreeeyyy/yard-serverspec-plugin/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request