cucumber-in-the-yard 1.3 → 1.4

data/History.txt

@@ -1,3 +1,27 @@
+=== 1.4 / 2010-10-17
+
+* Tagusage has been retired
+* Tags are found during parsing by name or created and all uses are appended to the exising or newly created object
+* Tagusage template renamed and fixed up for just a tag and all the references
+* Tags are named tag_TAG (removed the @ as it was encoded during file serialization and I couldn't find an encoder helper)
+* Cleaned up all references in the fulldoc, full list to references tags
+
+* Moved Cucumber CodeObjects, Handlers, and Parsers to a Cucumber sub-directory
+* Moved StepDefinition and StepTransforms form extensions.rb to individual StepObject and Handlers files 
+
+* (lsegal advice) Created Cucumber Namespace and sub namespaces for features, tags, and step transformers.
+* (lsegal advice) Started to break apart the feature.erb into smaller digestable erb sections
+
+* Feature namespace now parallels the directory structure of the feature directory (from where it is parsed)
+* Feature files have simpler names; i.e. featurefile.html instead of featurefile.feature.html
+* Feature page title now states Feature: The Feature ( KEYWORD: FEATURE_TITLE )
+* Moved the templates to lib/templates so I could use yard/templates to override the YARD helpers
+
+* Changed document parsing to mirror the order imposed by Cucumber, this is to stop features being loaded before step definitions.
+  This should hopefully address the issue where steps were not being mapped correctly to step definitions.  This fixed the issue
+  in the small and large test suite I ran it against.
+  
+
 === 1.3 / 2010-10-13
 
 * (7rans requested) Step definitions to show their source code; required a better source definition to be stored during creation of the CodeObject

data/Manifest

@@ -4,49 +4,62 @@ README.md
 Rakefile
 example/empty.feature
 example/example.feature
-example/example.step.rb
 example/example.third.feature
 example/second_example.feature
+example/step_definitions/example.step.rb
+example/step_definitions/support/env.rb
+example/step_definitions/support/env_support.rb
+example/step_definitions/support/support.rb
+features/definitions/city_step.rb
+features/definitions/test.setup.and.teardown.rb
+features/features.feature
 lib/city.rb
 lib/cucumber/city_builder.rb
-lib/yard/code_objects/base.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/templates/default/feature/html/background.erb
+lib/templates/default/feature/html/feature.erb
+lib/templates/default/feature/html/no_steps_defined.erb
+lib/templates/default/feature/html/outline.erb
+lib/templates/default/feature/html/pystring.erb
+lib/templates/default/feature/html/scenario.erb
+lib/templates/default/feature/html/steps.erb
+lib/templates/default/feature/html/table.erb
+lib/templates/default/feature/setup.rb
+lib/templates/default/fulldoc/html/css/common.css
+lib/templates/default/fulldoc/html/full_list.erb
+lib/templates/default/fulldoc/html/full_list_features.erb
+lib/templates/default/fulldoc/html/full_list_requirements.erb
+lib/templates/default/fulldoc/html/full_list_scenarios.erb
+lib/templates/default/fulldoc/html/full_list_stepdefinitions.erb
+lib/templates/default/fulldoc/html/full_list_steps.erb
+lib/templates/default/fulldoc/html/full_list_tags.erb
+lib/templates/default/fulldoc/html/index.erb
+lib/templates/default/fulldoc/html/js/cucumber.js
+lib/templates/default/fulldoc/html/setup.rb
+lib/templates/default/layout/html/headers.erb
+lib/templates/default/layout/html/search.erb
+lib/templates/default/scenario/html/scenario.erb
+lib/templates/default/scenario/setup.rb
+lib/templates/default/steptransformers/html/stepdefinition.erb
+lib/templates/default/steptransformers/html/steptransformers.erb
+lib/templates/default/steptransformers/setup.rb
+lib/templates/default/tag/html/feature.erb
+lib/templates/default/tag/html/scenario.erb
+lib/templates/default/tag/html/tag.erb
+lib/templates/default/tag/setup.rb
+lib/yard/code_objects/cucumber/base.rb
+lib/yard/code_objects/cucumber/feature.rb
+lib/yard/code_objects/cucumber/namespace_object.rb
+lib/yard/code_objects/cucumber/scenario.rb
+lib/yard/code_objects/cucumber/step.rb
+lib/yard/code_objects/cucumber/tag.rb
+lib/yard/code_objects/namespace_object.rb
+lib/yard/code_objects/step_definition.rb
+lib/yard/code_objects/step_transform.rb
+lib/yard/handlers/cucumber/base.rb
+lib/yard/handlers/cucumber/feature_handler.rb
+lib/yard/handlers/step_definition_handler.rb
+lib/yard/handlers/step_transform_handler.rb
+lib/yard/parser/cucumber/feature.rb
+lib/yard/parser/source_parser.rb
 lib/yard/rake/city_task.rb
-lib/yard/rb_extensions.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
+lib/yard/templates/helpers/base_helper.rb

data/README.md

@@ -19,6 +19,8 @@ An example, particularly the example features included with the project, of CITY
 **1. Users are able to search by Feature, Tags, and Scenario.**
 
 Appended to the traditional search areas is the ability to now search by Feature, Tag, and Scenario.
+The user is able to search by steps, though I have not placed those links on the page, in step_list.html
+found in the root of the output directory.
 
 **2. Feature pages are displayed in a decently formatted HTML representation**
 
@@ -32,7 +34,7 @@ Providing quick access to the important tag divisions that have been created in
 On the top of the page there are some quick calculations of the number of features and scenarios that
 share the specified tag. 
 
-**4. Steps link to Step definitions.  Step definitions show all uses. **
+**4. Steps link to Step definitions.  Step definitions show all uses.**
 
 Step definitions are displayed in their own index page and for each step definition a list of implemented
 steps for this step definition.  This is useful for providing example documentation and quickly understanding
@@ -108,6 +110,48 @@ scale to test the functionality of small software component.  Though, ultimately
 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.
 
+Roadmap
+-------
+
+**Version 1**
+
+Current feature set is all that I had planned for this first release.  
+
+**1. Users are able to search by Feature, Tags, and Scenario.**
+**2. Feature pages are displayed in a decently formatted HTML representation**
+**3. Tag pages display all the Features and scenarios that currently employ the tag.**
+**4. Steps link to Step definitions.  Step definitions show all uses.**
+
+Subsequent updates are fixes or enhancements to the fundamental structure behind the scenes.  Lsegal,
+has been extremely helpful in assisting me with the re-organization and refinement of this first release.
+
+**Future Feature Ideas**
+
+**1. Users are able to search Features, Scenarios, and Tags in a unified search box.**
+
+I want to rid the three added search fields and provide one unified search field that will use YARD's
+namespace structure (similar to how Class List works).
+
+**2. Tag pages provide the ability to exclude other tags that intersect.**
+
+Adding a list of tags currently used by the features and scenarios in the below list (that are not the
+current tag).  Allowing the visualization of what the execution of the requirements pass would look like.
+Output of a sample generated tag command-line would be displayed to assist with execution.  On selection
+update of the total features and scenarios affected by the changes in the filtering.
+
+I would like to also address some layout and formatting on the page.  Scenarios will also link to the scenarios
+feature page, show their descriptions, and of course all their other tags.
+
+**3. Step Trasnforms would be displayed where they are used**
+
+These tricky pieces of code tend to trip me up and others on the project.  I want to be able to show which steps
+that have mapped to step definitions are being affected by step transforms.
+
+**4. Highlight the sections of steps that match in the step definition**
+
+Similar to the great output that Cucumber uses to show what is the variable part of the step definition, I would like
+to have the steps displayed differently to illustrate that they are the variable in the statement.
+
 
 LICENSE
 -------

data/Rakefile

@@ -4,11 +4,12 @@ require 'echoe'
 task :default => :gendoc
 
 task :gendoc do
-  `yardoc -e lib/city.rb -p lib/yard/templates 'example/**/*.rb' 'example/**/*.feature' --debug`
+  `rm -rf doc`
+  `yardoc -e lib/city.rb -p lib/templates 'example/**/*' --debug`
 end
 
-Echoe.new('cucumber-in-the-yard', '1.3') do |g|
-  g.author = "Frank;lin Webber"
+Echoe.new('cucumber-in-the-yard', '1.4') do |g|
+  g.author = "Franklin Webber"
   g.email = "franklin.webber@gmail.com"
   g.url = "http://github.com/burtlo/Cucumber-In-The-Yard"
   g.description = %{ 

data/cucumber-in-the-yard.gemspec

@@ -2,19 +2,19 @@
 
 Gem::Specification.new do |s|
   s.name = %q{cucumber-in-the-yard}
-  s.version = "1.3"
+  s.version = "1.4"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Frank;lin Webber"]
-  s.date = %q{2010-10-13}
+  s.authors = ["Franklin Webber"]
+  s.date = %q{2010-10-17}
   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.md", "lib/city.rb", "lib/cucumber/city_builder.rb", "lib/yard/code_objects/base.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/rake/city_task.rb", "lib/yard/rb_extensions.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", "Manifest", "README.md", "Rakefile", "example/empty.feature", "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/base.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/rake/city_task.rb", "lib/yard/rb_extensions.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", "cucumber-in-the-yard.gemspec"]
+  s.extra_rdoc_files = ["README.md", "lib/city.rb", "lib/cucumber/city_builder.rb", "lib/templates/default/feature/html/background.erb", "lib/templates/default/feature/html/feature.erb", "lib/templates/default/feature/html/no_steps_defined.erb", "lib/templates/default/feature/html/outline.erb", "lib/templates/default/feature/html/pystring.erb", "lib/templates/default/feature/html/scenario.erb", "lib/templates/default/feature/html/steps.erb", "lib/templates/default/feature/html/table.erb", "lib/templates/default/feature/setup.rb", "lib/templates/default/fulldoc/html/css/common.css", "lib/templates/default/fulldoc/html/full_list.erb", "lib/templates/default/fulldoc/html/full_list_features.erb", "lib/templates/default/fulldoc/html/full_list_requirements.erb", "lib/templates/default/fulldoc/html/full_list_scenarios.erb", "lib/templates/default/fulldoc/html/full_list_stepdefinitions.erb", "lib/templates/default/fulldoc/html/full_list_steps.erb", "lib/templates/default/fulldoc/html/full_list_tags.erb", "lib/templates/default/fulldoc/html/index.erb", "lib/templates/default/fulldoc/html/js/cucumber.js", "lib/templates/default/fulldoc/html/setup.rb", "lib/templates/default/layout/html/headers.erb", "lib/templates/default/layout/html/search.erb", "lib/templates/default/scenario/html/scenario.erb", "lib/templates/default/scenario/setup.rb", "lib/templates/default/steptransformers/html/stepdefinition.erb", "lib/templates/default/steptransformers/html/steptransformers.erb", "lib/templates/default/steptransformers/setup.rb", "lib/templates/default/tag/html/feature.erb", "lib/templates/default/tag/html/scenario.erb", "lib/templates/default/tag/html/tag.erb", "lib/templates/default/tag/setup.rb", "lib/yard/code_objects/cucumber/base.rb", "lib/yard/code_objects/cucumber/feature.rb", "lib/yard/code_objects/cucumber/namespace_object.rb", "lib/yard/code_objects/cucumber/scenario.rb", "lib/yard/code_objects/cucumber/step.rb", "lib/yard/code_objects/cucumber/tag.rb", "lib/yard/code_objects/namespace_object.rb", "lib/yard/code_objects/step_definition.rb", "lib/yard/code_objects/step_transform.rb", "lib/yard/handlers/cucumber/base.rb", "lib/yard/handlers/cucumber/feature_handler.rb", "lib/yard/handlers/step_definition_handler.rb", "lib/yard/handlers/step_transform_handler.rb", "lib/yard/parser/cucumber/feature.rb", "lib/yard/parser/source_parser.rb", "lib/yard/rake/city_task.rb", "lib/yard/templates/helpers/base_helper.rb"]
+  s.files = ["History.txt", "Manifest", "README.md", "Rakefile", "example/empty.feature", "example/example.feature", "example/example.third.feature", "example/second_example.feature", "example/step_definitions/example.step.rb", "example/step_definitions/support/env.rb", "example/step_definitions/support/env_support.rb", "example/step_definitions/support/support.rb", "features/definitions/city_step.rb", "features/definitions/test.setup.and.teardown.rb", "features/features.feature", "lib/city.rb", "lib/cucumber/city_builder.rb", "lib/templates/default/feature/html/background.erb", "lib/templates/default/feature/html/feature.erb", "lib/templates/default/feature/html/no_steps_defined.erb", "lib/templates/default/feature/html/outline.erb", "lib/templates/default/feature/html/pystring.erb", "lib/templates/default/feature/html/scenario.erb", "lib/templates/default/feature/html/steps.erb", "lib/templates/default/feature/html/table.erb", "lib/templates/default/feature/setup.rb", "lib/templates/default/fulldoc/html/css/common.css", "lib/templates/default/fulldoc/html/full_list.erb", "lib/templates/default/fulldoc/html/full_list_features.erb", "lib/templates/default/fulldoc/html/full_list_requirements.erb", "lib/templates/default/fulldoc/html/full_list_scenarios.erb", "lib/templates/default/fulldoc/html/full_list_stepdefinitions.erb", "lib/templates/default/fulldoc/html/full_list_steps.erb", "lib/templates/default/fulldoc/html/full_list_tags.erb", "lib/templates/default/fulldoc/html/index.erb", "lib/templates/default/fulldoc/html/js/cucumber.js", "lib/templates/default/fulldoc/html/setup.rb", "lib/templates/default/layout/html/headers.erb", "lib/templates/default/layout/html/search.erb", "lib/templates/default/scenario/html/scenario.erb", "lib/templates/default/scenario/setup.rb", "lib/templates/default/steptransformers/html/stepdefinition.erb", "lib/templates/default/steptransformers/html/steptransformers.erb", "lib/templates/default/steptransformers/setup.rb", "lib/templates/default/tag/html/feature.erb", "lib/templates/default/tag/html/scenario.erb", "lib/templates/default/tag/html/tag.erb", "lib/templates/default/tag/setup.rb", "lib/yard/code_objects/cucumber/base.rb", "lib/yard/code_objects/cucumber/feature.rb", "lib/yard/code_objects/cucumber/namespace_object.rb", "lib/yard/code_objects/cucumber/scenario.rb", "lib/yard/code_objects/cucumber/step.rb", "lib/yard/code_objects/cucumber/tag.rb", "lib/yard/code_objects/namespace_object.rb", "lib/yard/code_objects/step_definition.rb", "lib/yard/code_objects/step_transform.rb", "lib/yard/handlers/cucumber/base.rb", "lib/yard/handlers/cucumber/feature_handler.rb", "lib/yard/handlers/step_definition_handler.rb", "lib/yard/handlers/step_transform_handler.rb", "lib/yard/parser/cucumber/feature.rb", "lib/yard/parser/source_parser.rb", "lib/yard/rake/city_task.rb", "lib/yard/templates/helpers/base_helper.rb", "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.md"]
   s.require_paths = ["lib"]

data/features/definitions/city_step.rb

@@ -0,0 +1,89 @@
+require 'rexml/document'
+
+
+TARGET_MATCH = /the feature/
+
+Transform /^the feature$/ do |feauture|
+  @cache[:feature]
+end
+  
+
+Given /^the feature file, '([^']+)', is the (feature) for the scenario$/ do |name,type|
+  @cache[type.to_sym] = name
+end
+
+Then /^I expect (#{TARGET_MATCH}) file (\w+) to exist at '([^']+)'$/ do |target,file_type,path|
+  file = "#{$env[:documents]}/#{path}/#{target}.#{file_type}"
+  File.should exist(file)
+  file
+end
+
+Then /^I expect the feature title to be '([^']+)'$/ do |title|
+  xml = REXML::Document.new(File.open("doc/requirements/features/features.html"))
+  
+  actual_title = xml.elements["//title"].text
+  actual_title.should == title  
+end
+
+Then /^I expect the feature heading to be '([^']+)'$/ do |title|
+  xml = REXML::Document.new(File.open("doc/requirements/features/features.html"))
+  
+  actual_title = "#{xml.elements["//*[@class='feature']/*[@class='title']/*[@class='pre']"].text} " + 
+  "#{xml.elements["//*[@class='feature']/*[@class='title']/*[@class='name']"].text}"
+  
+  actual_title.should == title  
+end
+
+Then /^I expect the feature to have the (@\w+) tag$/ do |tag|
+  xml = REXML::Document.new(File.open("doc/requirements/features/features.html"))
+  
+  found = false
+  
+  xml.elements.each("//*[@class='feature']//*[@class='tags']/a") do |actual_tag|
+    found = true if actual_tag.text == tag
+  end
+  
+  found.should be_true
+  
+end
+
+Then /^I expect the feature description to be$/ do |description|
+  
+  xml = REXML::Document.new(File.open("doc/requirements/features/features.html"))
+  xml.elements["//*[@class='feature']//*[@class='description']"].text.strip.should == description.strip
+  
+end
+
+Then /^I expect the feature to have a background$/ do
+  
+  xml = REXML::Document.new(File.open("doc/requirements/features/features.html"))
+  xml.elements["//*[@id='background']"].should_not be_nil
+  
+end
+
+Then /^I expect the background to have steps?$/ do |string|
+  
+  found = true
+  
+  xml = REXML::Document.new(File.open("doc/requirements/features/features.html"))
+  xml.elements["//*[@id='backgroundSteps']"].elements.each do |step|
+    found = true if "#{step.elements["span[1]"].text}#{step.elements["span[2]"].text}" == string
+  end
+  
+  found.should be_true
+  
+end
+
+Then /^I expect the feature to have the scenarios:$/ do |string|
+  
+  xml = REXML::Document.new(File.open("doc/requirements/features/features.html"))
+  string.split("\n").each do |expected_title|
+    found = nil
+    xml.elements.each("//*[@class='scenario']/*[@class='title']/*[@class='name']") do |scenario|
+      found = scenario if scenario.text == expected_title
+    end
+    found.should_not be_nil
+  end
+  
+end
+

data/features/definitions/test.setup.and.teardown.rb

@@ -0,0 +1,27 @@
+#
+# Before all of the scenarios....
+#
+Before do
+  $env = {}
+  $env[:documents] = 'doc'
+  @cache = {}
+end
+
+
+#
+# Before each scenario ...
+#
+Before do |scenario|
+end
+
+
+#
+# After each scenario...
+#
+After do |scenario|
+end
+
+
+at_exit do
+  
+end

data/features/features.feature

@@ -0,0 +1,44 @@
+@feature
+Feature: Features Page
+  As a Cucumber-In-The-YARD user I rely on the ability to view the details of each feature.
+
+  Background:
+    Given the feature file, 'features', is the feature for the scenario
+
+
+  Scenario: Location
+    Then I expect the feature file html to exist at 'requirements/features'
+
+  Scenario: Identification
+    Then I expect the feature title to be 'Feature: Features Page'
+	And I expect the feature heading to be 'Feature: Features Page'
+
+  Scenario: Tags
+    Then I expect the feature to have the @feature tag
+
+  Scenario: Description
+    Then I expect the feature description to be
+    """
+    As a Cucumber-In-The-YARD user I rely on the ability to view the details of each feature.
+    """
+
+  Scenario: Background
+    Then I expect the feature to have a background
+    And I expect the background to have steps
+    """
+    Given the feature, 'features.feature', is the feature for the scenario
+    """
+    
+  Scenario: Scenarios
+    Then I expect the feature to have the scenarios:
+    """
+    Location
+    Identification
+    Tags
+    Description
+    Background
+    Scenarios
+    """
+    
+
+

data/lib/city.rb

@@ -3,21 +3,30 @@ require 'cucumber/parser/gherkin_builder'
 require 'gherkin/parser/parser'
 require 'gherkin/formatter/tag_count_formatter'
 
+require 'yard'
+
+require File.dirname(__FILE__) + "/yard/code_objects/cucumber/base.rb"
+require File.dirname(__FILE__) + "/yard/code_objects/cucumber/namespace_object.rb"
+require File.dirname(__FILE__) + "/yard/code_objects/cucumber/feature.rb"
+require File.dirname(__FILE__) + "/yard/code_objects/cucumber/scenario.rb"
+require File.dirname(__FILE__) + "/yard/code_objects/cucumber/step.rb"
+require File.dirname(__FILE__) + "/yard/code_objects/cucumber/tag.rb"
+
 require File.dirname(__FILE__) + "/cucumber/city_builder.rb"
 
-require 'yard'
+require File.dirname(__FILE__) + "/yard/code_objects/step_definition.rb"
+require File.dirname(__FILE__) + "/yard/code_objects/step_transform.rb"
+require File.dirname(__FILE__) + "/yard/code_objects/namespace_object.rb"
+
+require File.dirname(__FILE__) + "/yard/parser/cucumber/feature.rb"
 
-require File.dirname(__FILE__) + "/yard/code_objects/base.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/handlers/cucumber/base.rb"
+require File.dirname(__FILE__) + "/yard/handlers/cucumber/feature_handler.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/handlers/step_definition_handler.rb"
+require File.dirname(__FILE__) + "/yard/handlers/step_transform_handler.rb"
 
+require File.dirname(__FILE__) + "/yard/parser/source_parser.rb"
+require File.dirname(__FILE__) + "/yard/templates/helpers/base_helper.rb"
 require File.dirname(__FILE__) + "/yard/rake/city_task.rb"