cucumber-in-the-yard 1.0

data/History.txt

@@ -0,0 +1,3 @@
+=== 0.5.0 / 2010-10-02
+
+* Initial Release

data/Manifest

@@ -0,0 +1,51 @@
+History.txt
+README.txt
+Rakefile
+example/example.feature
+example/example.step.rb
+example/example.third.feature
+example/second_example.feature
+lib/city.rb
+lib/cucumber/city_builder.rb
+lib/yard/code_objects/cucumber_location_helper.rb
+lib/yard/code_objects/feature.rb
+lib/yard/code_objects/scenario.rb
+lib/yard/code_objects/step.rb
+lib/yard/code_objects/tags.rb
+lib/yard/extensions.rb
+lib/yard/handlers/base.rb
+lib/yard/handlers/feature_handler.rb
+lib/yard/parser/feature.rb
+lib/yard/rb_extensions.rb
+lib/yard/rake/city_task.rb
+lib/yard/templates/default/feature/html/feature.erb
+lib/yard/templates/default/feature/setup.rb
+lib/yard/templates/default/fulldoc/html/css/common.css
+lib/yard/templates/default/fulldoc/html/full_list.erb
+lib/yard/templates/default/fulldoc/html/full_list_features.erb
+lib/yard/templates/default/fulldoc/html/full_list_scenarios.erb
+lib/yard/templates/default/fulldoc/html/full_list_stepdefinitions.erb
+lib/yard/templates/default/fulldoc/html/full_list_steps.erb
+lib/yard/templates/default/fulldoc/html/full_list_tagusages.erb
+lib/yard/templates/default/fulldoc/html/index.erb
+lib/yard/templates/default/fulldoc/html/js/cucumber.js
+lib/yard/templates/default/fulldoc/html/setup.rb
+lib/yard/templates/default/layout/html/headers.erb
+lib/yard/templates/default/layout/html/search.erb
+lib/yard/templates/default/module/html/step_transforms.erb
+lib/yard/templates/default/module/setup.rb
+lib/yard/templates/default/scenario/html/scenario.erb
+lib/yard/templates/default/scenario/setup.rb
+lib/yard/templates/default/steptransformers/html/stepdefinition.erb
+lib/yard/templates/default/steptransformers/setup.rb
+lib/yard/templates/default/tagusage/html/tagusage.erb
+lib/yard/templates/default/tagusage/setup.rb
+spec/city/feature_parser_spec_examples.rb
+spec/city/gherkin_loader_spec.rb
+spec/city/test.feature
+spec/city/yard_handlers_cucumber_spec.rb
+spec/city/yard_namespace_object_spec.rb
+spec/city/yard_parser_cucumber_spec.rb
+spec/city/yard_rb_extensions_spec.rb
+spec/spec_helper.rb
+Manifest

data/README.txt

@@ -0,0 +1,55 @@
+= CITY Cucumber-In-The-YARD (CITY): A Requirements Documentation Tool
+
+== DESCRIPTION:
+
+There are two things that I enjoy: a test framework written in my own Domain Specific Language (DSL) that is easily understood by all those on a project and the ability for all participants to easily read, search, and view the tests.
+
+Cucumber is an amazing tool that allowed me to define exercisable requirements.  My biggest obstacle was bringing these requirements to my team, the product owner, and other stakeholders.
+
+Initially I tried to expose more of the functionality by providing freshly authored requirements through email, attachments to JIRA tickets, or linked in wiki documents.  None of these methods were very sustainable or successful.  First, I was continually pushing out the documents to those interested.  Second, the documents were displayed to the user in text without the syntax highlighting that was exceedingly helpful for quickly understanding the requirements.
+
+I also found it hard to share the test framework that I had put together with another developer that joined the team.  It was difficult to direct them around the features, tags, step definitions, and transforms.  It was when I started to convey to them the conventions that I had established that I wished I had a tool that would allow me to provide documentation like one would find generated by a great tool like YARD.
+
+So I set out to integrate Cucumber objects like features, backgrounds, scenarios, tags, steps, step definitions, and transforms into a YARD template.  From my quick survey of the landscape I can see that the my needs are different than a lot of others that use Cucumber.  The entire project that spawned this effort was solely to exercise the functionality of a different, large project and so there is a huge dependence on having the requirements documented.  This is in contrast to other projects that are using this on a small scale to test the functionality of small software component.  Though, ultimately, I realized that the functionality may provide a valuable tool for many as I feel it helps more solidly bridge the reporting of the documentation by putting a coat of paint on it.
+
+
+== FEATURES/PROBLEMS:
+
+**1. Searchable Features, Scenarios, Steps, and Tags**: Similar to how YARD provides the ability to search through classes and methods, CITY provides the ability to search through all of the requirements documentation quickly and easily through the browser.  This makes it easy to provide reports for product owners and other stakeholders.
+
+**2. Tags**: Tag view will show all features and scenarios that employ the tag.
+
+**3. Steps map to Step Definitions**: Steps provide links to their step definitions so developers and maintainers of the requirements suite can quickly find their way around the project.  As well, step definitions report all their implemented step definitions to provide a quick way of understanding the impact of augmenting a step definition as well as providing examples.
+
+== SYNOPSIS:
+
+== REQUIREMENTS:
+
+== INSTALL:
+
+== DEVELOPERS:
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2010 FIX
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,28 @@
+require 'rake'
+require 'echoe'
+require 'yard'
+require 'rspec/core/rake_task'
+
+task :default => :yard
+
+task :gendoc do
+  `yardoc -e lib/city.rb -p lib/yard/templates 'example/**/*.rb' 'example/**/*.feature' --quiet --verbose`
+end
+
+yard_task = YARD::Rake::YardocTask.new
+yard_task.files = FileList['example/**/*.feature','example/**/*.rb']
+yard_task.options = %w{ -e lib/city.rb -p lib/yard/templates 'example/**/*.rb' 'examples/**/*.feature' --debug }
+
+
+Echoe.new('cucumber-in-the-yard', '1.0') do |g|
+  g.author = "Frank;lin Webber"
+  g.email = "franklin.webber@gmail.com"
+  g.url = "http://github.com/burtlo/Cucumber-In-The-Yard"
+  g.description = %{ 
+    Cucumber-In-The-Yard is a YARD extension that processes Cucumber Features, Scenarios, Steps,
+    Step Definitions, Transforms, and Tags and provides a documentation interface that allows you
+    easily view and investigate the test suite.  This tools hopes to bridge the gap of being able
+    to provide your feature descriptions to your Product Owners and Stakeholders.  }
+  g.ignore_pattern = FileList["{doc,autotest}/**/*"].to_a
+  g.runtime_dependencies = [ "cucumber >=0.7.5", "yard >=0.6.1" ]
+end

data/cucumber-in-the-yard.gemspec

@@ -0,0 +1,42 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{cucumber-in-the-yard}
+  s.version = "1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Frank;lin Webber"]
+  s.cert_chain = ["/Users/frank/gem-public_cert.pem"]
+  s.date = %q{2010-10-10}
+  s.description = %q{ 
+    Cucumber-In-The-Yard is a YARD extension that processes Cucumber Features, Scenarios, Steps,
+    Step Definitions, Transforms, and Tags and provides a documentation interface that allows you
+    easily view and investigate the test suite.  This tools hopes to bridge the gap of being able
+    to provide your feature descriptions to your Product Owners and Stakeholders.  }
+  s.email = %q{franklin.webber@gmail.com}
+  s.extra_rdoc_files = ["README.txt", "lib/city.rb", "lib/cucumber/city_builder.rb", "lib/yard/code_objects/cucumber_location_helper.rb", "lib/yard/code_objects/feature.rb", "lib/yard/code_objects/scenario.rb", "lib/yard/code_objects/step.rb", "lib/yard/code_objects/tags.rb", "lib/yard/extensions.rb", "lib/yard/handlers/base.rb", "lib/yard/handlers/feature_handler.rb", "lib/yard/parser/feature.rb", "lib/yard/rb_extensions.rb", "lib/yard/rake/city_task.rb", "lib/yard/templates/default/feature/html/feature.erb", "lib/yard/templates/default/feature/setup.rb", "lib/yard/templates/default/fulldoc/html/css/common.css", "lib/yard/templates/default/fulldoc/html/full_list.erb", "lib/yard/templates/default/fulldoc/html/full_list_features.erb", "lib/yard/templates/default/fulldoc/html/full_list_scenarios.erb", "lib/yard/templates/default/fulldoc/html/full_list_stepdefinitions.erb", "lib/yard/templates/default/fulldoc/html/full_list_steps.erb", "lib/yard/templates/default/fulldoc/html/full_list_tagusages.erb", "lib/yard/templates/default/fulldoc/html/index.erb", "lib/yard/templates/default/fulldoc/html/js/cucumber.js", "lib/yard/templates/default/fulldoc/html/setup.rb", "lib/yard/templates/default/layout/html/headers.erb", "lib/yard/templates/default/layout/html/search.erb", "lib/yard/templates/default/module/html/step_transforms.erb", "lib/yard/templates/default/module/setup.rb", "lib/yard/templates/default/scenario/html/scenario.erb", "lib/yard/templates/default/scenario/setup.rb", "lib/yard/templates/default/steptransformers/html/stepdefinition.erb", "lib/yard/templates/default/steptransformers/setup.rb", "lib/yard/templates/default/tagusage/html/tagusage.erb", "lib/yard/templates/default/tagusage/setup.rb"]
+  s.files = ["History.txt", "README.txt", "Rakefile", "example/example.feature", "example/example.step.rb", "example/example.third.feature", "example/second_example.feature", "lib/city.rb", "lib/cucumber/city_builder.rb", "lib/yard/code_objects/cucumber_location_helper.rb", "lib/yard/code_objects/feature.rb", "lib/yard/code_objects/scenario.rb", "lib/yard/code_objects/step.rb", "lib/yard/code_objects/tags.rb", "lib/yard/extensions.rb", "lib/yard/handlers/base.rb", "lib/yard/handlers/feature_handler.rb", "lib/yard/parser/feature.rb", "lib/yard/rb_extensions.rb", "lib/yard/rake/city_task.rb", "lib/yard/templates/default/feature/html/feature.erb", "lib/yard/templates/default/feature/setup.rb", "lib/yard/templates/default/fulldoc/html/css/common.css", "lib/yard/templates/default/fulldoc/html/full_list.erb", "lib/yard/templates/default/fulldoc/html/full_list_features.erb", "lib/yard/templates/default/fulldoc/html/full_list_scenarios.erb", "lib/yard/templates/default/fulldoc/html/full_list_stepdefinitions.erb", "lib/yard/templates/default/fulldoc/html/full_list_steps.erb", "lib/yard/templates/default/fulldoc/html/full_list_tagusages.erb", "lib/yard/templates/default/fulldoc/html/index.erb", "lib/yard/templates/default/fulldoc/html/js/cucumber.js", "lib/yard/templates/default/fulldoc/html/setup.rb", "lib/yard/templates/default/layout/html/headers.erb", "lib/yard/templates/default/layout/html/search.erb", "lib/yard/templates/default/module/html/step_transforms.erb", "lib/yard/templates/default/module/setup.rb", "lib/yard/templates/default/scenario/html/scenario.erb", "lib/yard/templates/default/scenario/setup.rb", "lib/yard/templates/default/steptransformers/html/stepdefinition.erb", "lib/yard/templates/default/steptransformers/setup.rb", "lib/yard/templates/default/tagusage/html/tagusage.erb", "lib/yard/templates/default/tagusage/setup.rb", "spec/city/feature_parser_spec_examples.rb", "spec/city/gherkin_loader_spec.rb", "spec/city/test.feature", "spec/city/yard_handlers_cucumber_spec.rb", "spec/city/yard_namespace_object_spec.rb", "spec/city/yard_parser_cucumber_spec.rb", "spec/city/yard_rb_extensions_spec.rb", "spec/spec_helper.rb", "Manifest", "cucumber-in-the-yard.gemspec"]
+  s.homepage = %q{http://github.com/burtlo/Cucumber-In-The-Yard}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Cucumber-in-the-yard", "--main", "README.txt"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{cucumber-in-the-yard}
+  s.rubygems_version = %q{1.3.6}
+  s.signing_key = %q{/Users/frank/gem-private_key.pem}
+  s.summary = %q{Cucumber-In-The-Yard is a YARD extension that processes Cucumber Features, Scenarios, Steps, Step Definitions, Transforms, and Tags and provides a documentation interface that allows you easily view and investigate the test suite.  This tools hopes to bridge the gap of being able to provide your feature descriptions to your Product Owners and Stakeholders.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<cucumber>, [">= 0.7.5"])
+      s.add_runtime_dependency(%q<yard>, [">= 0.6.1"])
+    else
+      s.add_dependency(%q<cucumber>, [">= 0.7.5"])
+      s.add_dependency(%q<yard>, [">= 0.6.1"])
+    end
+  else
+    s.add_dependency(%q<cucumber>, [">= 0.7.5"])
+    s.add_dependency(%q<yard>, [">= 0.6.1"])
+  end
+end

data/example/example.feature

@@ -0,0 +1,13 @@
+@customer
+Feature: Customer Login Feature
+  As a customer of the product I am able to login as myself
+
+  Background:
+    Given this undefined step definition
+
+  @bvt
+  Scenario: Customer with valid login is able to login
+    Given that a customer is a valid customer
+    When a customer logs in as username 'frank' with password 'default'
+    Then I expect them to have logged in successfully
+

data/example/example.step.rb

@@ -0,0 +1,48 @@
+
+
+CUSTOMER = /(?:(?:an?|the) customer|#{TEDDY_BEAR})/
+
+TEDDY_BEAR = /teddy bear/
+
+Transform /^an? customer$/ do |customer|
+  "a transformed customer"
+end
+
+Transform /^the customer$/ do |customer|
+  "the transformed customer"
+end
+
+Given /^that (#{CUSTOMER}) is a valid customer$/ do |customer|
+  pending "Customer #{customer} validation"  
+end
+
+When /^a customer logs in as username '([^']+)' with password '([^']+)'$/ do |username,password|
+  pending "Customer logs in with #{username} and #{password}"
+end
+
+Then /^I expect them to have logged in successfully $/ do 
+  pending "Validation that the customer has logged in successfully"  
+end
+
+When /^the customer logs out$/ do
+  pending
+end
+
+Then /^I expect the customer to be shown the logout page$/ do 
+  pending
+end
+
+And /^this third defined step definition$/ do
+  pending
+end
+
+And /^edits their the biography to state:$/ do |bio|
+  pending "text_field not present for bio #{bio} for this release"
+end
+
+#
+# Some details about the helper method that might be picked up in the documentation.
+#
+def a_helper_method
+  puts "performs some operation"
+end

data/example/example.third.feature

@@ -0,0 +1,30 @@
+@customer
+Feature: Customer Account
+  As a customer of the product I am able to configure settings for my account
+
+  Background:
+    Given this third defined step definition
+
+  @bvt
+  Scenario: Customer is able to change their password
+    Given that a customer that is logged in to the system
+    When the customer changes their password to 'lions_tigers_and_bears'
+    Then I expect when they login again that it will use this new password
+
+  @wip
+  Scenario: Customer cannot change settings if they are not logged in
+    Given that a customer is a valid customer
+    When the customer visits the account settings page
+    Then I expect the customer to be presented with the login page
+	
+  @wip
+  Scenario: Customer cannot change settings if they are not logged in
+    Given that a customer that is logged in to the system
+	When the customer visits the account settings page
+	And edits their the biography to state:
+	"""
+		I am an avid golfer, spelunker, and designer of clothing for stuffed
+		animals.
+	"""
+    Then I expect the customer to be presented with the login page
+

data/example/second_example.feature

@@ -0,0 +1,36 @@
+@customer
+Feature: Customer Logout Feature
+  As a customer of the product I am able to logout
+
+  Background:
+    Given this undefined step definition
+
+  @bvt
+  Scenario: Customer that is logged in is able to log out
+    Given that a customer is a valid customer
+    And a customer logs in as username 'frank' with password 'default'
+    And I expect them to have logged in successfully
+    When the customer logs out
+	Then I expect the customer to be shown the logout page
+
+  Scenario: Customers with a complete profile are allowed to post
+    Given that a customer is a valid customer
+    And the customer has the following details:
+      | Name  | Email       | Age |
+      | Frank | f@email.com | 22  | 
+    When a customer logs in as username 'frank' with password 'default'
+	And visits the customer update page
+	Then I expect the customer is able able to post to their profile
+	
+  @product
+  Scenario Outline: Customers that bought a product are included in their product groups
+    Given that <Customer> is a valid customer
+    And that the product, named '<Product>', is a valid product
+    When the customer has purchased the product
+    Then I expect the customer to be a member of the '<Product>' group
+
+    Examples:
+     | Customer   | Product   |
+     | Customer A | Product A |
+     | Customer A | Product B |
+     | Customer A | Product C |

data/lib/city.rb

@@ -0,0 +1,23 @@
+require 'gherkin/rubify'
+require 'cucumber/parser/gherkin_builder'
+require 'gherkin/parser/parser'
+require 'gherkin/formatter/tag_count_formatter'
+
+require File.dirname(__FILE__) + "/cucumber/city_builder.rb"
+
+require 'yard'
+
+require File.dirname(__FILE__) + "/yard/code_objects/cucumber_location_helper.rb"
+require File.dirname(__FILE__) + "/yard/code_objects/feature.rb"
+require File.dirname(__FILE__) + "/yard/code_objects/scenario.rb"
+require File.dirname(__FILE__) + "/yard/code_objects/step.rb"
+require File.dirname(__FILE__) + "/yard/code_objects/tags.rb"
+
+require File.dirname(__FILE__) + "/yard/extensions.rb"
+require File.dirname(__FILE__) + "/yard/rb_extensions.rb"
+require File.dirname(__FILE__) + "/yard/parser/feature.rb"
+require File.dirname(__FILE__) + "/yard/handlers/base.rb"
+require File.dirname(__FILE__) + "/yard/handlers/feature_handler.rb"
+
+require File.dirname(__FILE__) + "/yard/rake/city_task.rb"
+

data/lib/cucumber/city_builder.rb

@@ -0,0 +1,130 @@
+
+module Cucumber
+  module Parser
+    class CityBuilder
+      include Gherkin::Rubify
+
+      def initialize(file)
+        @file = file
+      end
+
+      def ast
+        @feature || @multiline_arg
+      end
+
+      def feature(feature)
+        #log.debug  "FEATURE: #{feature.name} #{feature.line} #{feature.keyword} #{feature.description}"
+        @feature = YARD::CodeObjects::Cucumber::Feature.new(:root,@file.gsub('.','_')) do |f|
+          f.comments = feature.comments.map{|comment| comment.value}.join("\n")
+          f.description = feature.description
+          f.add_file(@file,feature.line)
+          f.keyword = feature.keyword
+          f.value = feature.name
+          f.tags = []
+          
+          feature.tags.map{|tag| tag.name}.each_with_index do |tag,index|
+            f.tags << YARD::CodeObjects::Cucumber::Tag.new(:root,"#{f.name}_feature_tag_#{index}") do |t| 
+              t.value = tag
+              t.add_file(@file,feature.line)
+              t.feature = f
+            end
+          end
+          
+        end
+          
+      end
+
+      def background(background)
+        #log.debug "BACKGROUND #{background.keyword} #{background.name} #{background.line} #{background.description}"
+        @background = YARD::CodeObjects::Cucumber::Scenario.new(:root,"#{@feature.name}_background") do |b|
+          b.comments = background.comments.map{|comment| comment.value}.join("\n")
+          b.description = background.description
+          b.keyword = background.keyword
+          b.value = background.name
+          b.add_file(@file,background.line)
+        end
+        
+        @feature.background = @background
+        @background.feature = @feature
+        @step_container = @background
+      end
+
+      def scenario(statement)
+        #log.debug "SCENARIO"
+        scenario = YARD::CodeObjects::Cucumber::Scenario.new(:root,"#{@feature.name}_scenario_#{@feature.scenarios.length + 1}") do |s|
+          s.comments = statement.comments.map{|comment| comment.value}.join("\n")
+          s.description = statement.description
+          s.add_file(@file,statement.line)
+          s.keyword = statement.keyword
+          s.value = statement.name
+          
+          statement.tags.map{|tag| tag.name}.each_with_index do |tag,index|
+            s.tags << YARD::CodeObjects::Cucumber::Tag.new(:root,"#{s.name}_tag_#{index}") do |t| 
+              t.value = tag
+              t.add_file(@file,@feature.line)
+              t.scenario = s
+            end
+          end
+        end
+        
+        scenario.feature = @feature
+        @feature.scenarios << scenario
+        @step_container = scenario
+      end
+
+      def scenario_outline(statement)
+        scenario(statement)
+      end
+
+      def examples(examples)
+        #log.debug "EXAMPLES"
+        @step_container.examples << [
+          examples.keyword,
+          examples.name,
+          examples.line,
+          examples.comments.map{|comment| comment.value}.join("\n"),
+          matrix(examples.rows) ]
+      end
+
+      def step(step)
+        #log.debug "STEP #{step.multiline_arg}"
+        @table_owner = YARD::CodeObjects::Cucumber::Step.new(:root,"#{@feature.name}_#{step.line}") do |s|
+          s.keyword = step.keyword
+          s.value = step.name
+          s.add_file(@file,step.line)
+        end
+                
+        multiline_arg = rubify(step.multiline_arg)
+        case(multiline_arg)
+        when Gherkin::Formatter::Model::PyString
+          @table_owner.text = multiline_arg.value
+        when Array
+          @table_owner.table = matrix(multiline_arg)
+        end
+        
+        @table_owner.scenario = @step_container
+        @step_container.steps << @table_owner
+      end
+
+      def eof
+      end
+
+      def syntax_error(state, event, legal_events, line)
+        # raise "SYNTAX ERROR"
+      end
+
+      private
+
+      def matrix(gherkin_table)
+        gherkin_table.map do |gherkin_row|
+          row = gherkin_row.cells
+          class << row
+            attr_accessor :line
+          end
+          row.line = gherkin_row.line
+          row
+        end
+      end
+    end
+  end
+end

data/lib/yard/code_objects/cucumber_location_helper.rb

@@ -0,0 +1,15 @@
+module CucumberLocationHelper
+
+  def line_number
+    files.first.last
+  end
+
+  def file
+    files.first.first
+  end
+
+  def location
+    "#{files.first.first}:#{files.first.last}"
+  end
+
+end

data/lib/yard/code_objects/feature.rb

@@ -0,0 +1,24 @@
+
+
+module YARD::CodeObjects::Cucumber
+
+  class Feature < YARD::CodeObjects::Base
+    include CucumberLocationHelper
+
+    attr_accessor :background, :comments, :description, :keyword, :scenarios, :tags, :value
+
+    def initialize(namespace,name)
+      super(namespace,name.to_s.strip)
+      @comments = []
+      @scenarios = []
+      @tags = []
+    end
+
+    #TODO: this is likely a bad hack because I couldn't understand path
+    def filename
+      "#{self.name.to_s.gsub(/\//,'_')}.html"
+    end
+
+  end
+
+end

data/lib/yard/code_objects/scenario.rb

@@ -0,0 +1,25 @@
+
+
+module YARD::CodeObjects::Cucumber
+
+  class Scenario < YARD::CodeObjects::Base
+    include CucumberLocationHelper
+
+    attr_accessor :value, :description, :steps, :tags, :feature, :examples
+    
+    def initialize(namespace,name)
+      super(namespace,name.to_s.strip)
+      @description = @value = @feature = nil
+      @steps = []
+      @tags = []
+      @examples = []
+    end
+
+    #TODO: this is likely a bad hack because I couldn't understand path
+    def filename
+      "#{self.name.to_s.gsub(/\//,'_')}.html"
+    end
+
+  end
+
+end

data/lib/yard/code_objects/step.rb

@@ -0,0 +1,25 @@
+
+
+module YARD::CodeObjects::Cucumber
+
+  class Step < YARD::CodeObjects::Base
+    include CucumberLocationHelper
+
+    attr_accessor :definition, :keyword, :scenario, :table, :text, :value
+    
+    def initialize(namespace,name)
+      super(namespace,name.to_s.strip)
+      @definition = @description = @keyword = @table = @text = @value = nil
+    end
+
+    def has_table?
+      !@table.nil?
+    end
+
+    def has_text?
+      !@text.nil?
+    end
+
+  end
+
+end

data/lib/yard/code_objects/tags.rb

@@ -0,0 +1,63 @@
+
+
+module YARD::CodeObjects::Cucumber
+
+  class Tag < YARD::CodeObjects::Base
+    include CucumberLocationHelper
+
+    attr_accessor :value, :feature, :scenario
+
+    def filename
+      "#{self.name.to_s.gsub(/\//,'_')}.html"
+    end
+
+  end
+
+  
+  class TagUsage < YARD::CodeObjects::Base
+
+    attr_reader :value
+
+    attr_accessor :tags
+
+    def filename
+      "#{self.name}.html"
+    end
+
+    def push(tag)
+      @tags = [] unless @tags
+      @tags << tag
+
+      if tag.scenario
+        @scenario_count = 0 unless @scenario_count
+        @scenario_count += 1 
+      else
+        @feature_count = 0 unless @feature_count
+        @indirect_scenario_count = 0 unless @indirect_scenario_count
+        @feature_count += 1
+        @indirect_scenario_count += tag.feature.scenarios.length
+      end
+
+    end
+
+    def scenario_count
+      @scenario_count || 0
+    end
+
+    def feature_count
+      @feature_count || 0
+    end
+
+    def indirect_scenario_count
+      @indirect_scenario_count || 0
+    end
+
+    def total_scenario_count
+      scenario_count + indirect_scenario_count
+    end        
+
+    alias_method :<<, :push
+
+  end
+
+end