busser-behave 0.1.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7878219471e70982ca971ce3715c2a5630833966
+  data.tar.gz: c6575b43b88301f438f4c2fd35a32eb20acbcf6a
+SHA512:
+  metadata.gz: 918c8026e3e6334872544adf893bbc9ae85b65e3e8c85493094509dbf43eba9152709ea3eca7228aca707258ef5e199df23114e9f25938aa622fb104a25559a1
+  data.tar.gz: 20f2fc2bb3d8253ec663faf50e2ff2a6cd8005dcd47aa4944e8917beba65f08d5eabfe70638129494f64c0e04c0febb201dd8e142697d1422da63fc6953e794c

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.tailor

@@ -0,0 +1,4 @@
+Tailor.config do |config|
+  config.formatters "text"
+  config.file_set 'lib/**/*.rb'
+end

data/.travis.yml

@@ -0,0 +1,11 @@
+language: ruby
+
+rvm:
+- 2.0.0
+- 1.9.3
+- 1.9.2
+- ruby-head
+
+matrix:
+  allow_failures:
+  - rvm: ruby-head

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+## 0.1.0 / Unreleased
+
+* Initial release

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE

@@ -0,0 +1,15 @@
+Author:: TODO: Write your name (<TODO: Write your email>)
+
+Copyright (C) 2017, TODO: Write your name
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/README.md

@@ -0,0 +1,41 @@
+# <a name="title"></a> Busser::RunnerPlugin::Behave
+
+A Busser runner plugin for Behave
+
+## <a name="installation"></a> Installation and Setup
+
+Please read the Busser [plugin usage][plugin_usage] page for more details.
+
+## <a name="usage"></a> Usage
+
+**TODO:** Write documentation explaining the structure/format of testing files.
+
+## <a name="development"></a> Development
+
+* Source hosted at [GitHub][repo]
+* Report issues/questions/feature requests on [GitHub Issues][issues]
+
+Pull requests are very welcome! Make sure your patches are well tested.
+Ideally create a topic branch for every separate change you make. For
+example:
+
+1. Fork the repo
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## <a name="authors"></a> Authors
+
+Created and maintained by [TODO: Write your name][author] (<TODO: Write your email>)
+
+## <a name="license"></a> License
+
+Apache 2.0 (see [LICENSE][license])
+
+
+[author]:           https://github.com/enter-github-user
+[issues]:           https://github.com/enter-github-user/busser-behave/issues
+[license]:          https://github.com/enter-github-user/busser-behave/blob/master/LICENSE
+[repo]:             https://github.com/enter-github-user/busser-behave
+[plugin_usage]:     http://docs.kitchen-ci.org/busser/plugin-usage

data/Rakefile

@@ -0,0 +1,68 @@
+require "bundler/gem_tasks"
+require 'cucumber/rake/task'
+require 'cane/rake_task'
+require 'tailor/rake_task'
+require "open-uri"
+
+namespace :behave do
+
+  url = "https://github.com/behave/behave/archive/master.tar.gz"
+  tarball = "tmp/behave-master.tar.gz"
+  vendor = "vendor/behave"
+
+  desc "Vendors behave latest source code into gem codebase"
+  task :vendor => "#{vendor}/VERSION.txt"
+
+  directory File.dirname(tarball)
+  directory vendor
+
+  file tarball => File.dirname(tarball) do |t|
+    begin
+      src = open(url).binmode
+      dst = open(t.name, "wb")
+      IO.copy_stream(src, dst)
+    ensure
+      src.close
+      dst.close
+    end
+  end
+
+  file "#{vendor}/VERSION.txt" => [vendor, tarball] do |t|
+    abs_tarball = File.expand_path(tarball)
+    Dir.chdir(vendor) { sh "tar xzf #{abs_tarball} --strip-components=1" }
+    rm_rf "#{vendor}/test"
+    IO.write(t.name, url + "\n")
+  end
+
+  desc "Clean up a vendored behave in preparation for a new vendored version"
+  task :clean do
+    rm_rf [vendor, tarball]
+  end
+end
+
+Cucumber::Rake::Task.new(:features) do |t|
+  t.cucumber_opts = ['features', '-x', '--format progress']
+end
+
+desc "Run all test suites"
+task :test => [:features]
+
+desc "Run cane to check quality metrics"
+Cane::RakeTask.new do |cane|
+  cane.canefile = './.cane'
+end
+
+Tailor::RakeTask.new
+
+desc "Display LOC stats"
+task :stats do
+  puts "\n## Production Code Stats"
+  sh "countloc -r lib"
+  puts "\n## Test Code Stats"
+  sh "countloc -r features"
+end
+
+desc "Run all quality tasks"
+task :quality => [:cane, :tailor, :stats]
+
+task :default => [:test, :quality]

data/busser-behave.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'busser/behave/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'busser-behave'
+  spec.version       = Busser::Behave::VERSION
+  spec.authors       = ['Srividya Raman']
+  spec.email         = ['srividya.ramank@gmail.com']
+  spec.description   = %q{A Busser runner plugin for Behave}
+  spec.summary       = spec.description
+  spec.homepage      = 'https://github.com/srividya-raman/busser-behave.git'
+  spec.license       = 'Apache-2.0'
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = []
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'busser'
+
+  spec.add_development_dependency 'bundler', '~> 1.3'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'aruba'
+
+  spec.add_development_dependency 'cane'
+  spec.add_development_dependency 'tailor'
+  spec.add_development_dependency 'countloc'
+end

data/features/plugin_install_command.feature

@@ -0,0 +1,11 @@
+Feature: Plugin install command
+  In order to use this plugin
+  As a user of Busser
+  I want to run the postinstall for this plugin
+
+  Background:
+    Given a test BUSSER_ROOT directory named "busser-behave-install"
+
+  Scenario: Running the postinstall generator
+    When I run `busser plugin install busser-behave --force-postinstall`
+    Then the exit status should be 0

data/features/plugin_list_command.feature

@@ -0,0 +1,8 @@
+Feature: Plugin list command
+  In order to use this plugin
+  As a user of Busser
+  I want to see this plugin in the 'busser plugin list' command
+
+  Scenario: Plugin appears in plugin list command
+    When I successfully run `busser plugin list`
+    Then the output should match /^behave\b/

data/features/support/env.rb

@@ -0,0 +1,13 @@
+require 'aruba/cucumber'
+require 'busser/cucumber'
+
+Before do
+  @aruba_timeout_seconds = 10
+end
+
+After do |s|
+  # Tell Cucumber to quit after this scenario is done - if it failed.
+  # This is useful to inspect the 'tmp/aruba' directory before any other
+  # steps are executed and clear it out.
+  Cucumber.wants_to_quit = true if s.failed?
+end

data/features/test_command.feature

@@ -0,0 +1,31 @@
+Feature: Test command
+  In order to run tests written with behave
+  As a user of Busser
+  I want my tests to run when the behave runner plugin is installed
+
+  Background:
+    Given a test BUSSER_ROOT directory named "busser-behave-test"
+    When I successfully run `busser plugin install busser-behave --force-postinstall`
+    Given a suite directory named "behave"
+
+  Scenario: A passing test suite
+    Given a file in suite "behave" named "<YOUR_FILE>" with:
+    """
+    TEST FILE CONTENT
+
+    A good test might be a simple passing statement
+    """
+    When I run `busser test behave`
+    Then I should verify some output for the behave plugin
+    And the exit status should be 0
+
+  Scenario: A failing test suite
+    Given a file in suite "behave" named "<YOUR_FILE>" with:
+    """
+    TEST FILE CONTENT
+
+    A good test might be a failing test case, raised exception, etc.
+    """
+    When I run `busser test behave`
+    Then I should verify some output for the behave plugin
+    And the exit status should not be 0

data/lib/busser/behave/version.rb

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+#
+# Author:: Srividya Raman <srividya.ramank@gmail.com>
+#
+# Copyright (C) 2017, Srividya Raman
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module Busser
+
+  module Behave
+
+    # Version string for the Behave Busser runner plugin
+    VERSION = "0.1.3"
+  end
+end

data/lib/busser/runner_plugin/behave.rb

@@ -0,0 +1,37 @@
+# -*- encoding: utf-8 -*-
+#
+# Author:: Srividya Raman <srividya.ramank@gmail.com>
+#
+# Copyright (C) 2017, Srividya Raman
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'busser/runner_plugin'
+
+# A Busser runner plugin for Behave.
+#
+# @author Srividya Raman <srividya.ramank@gmail.com>
+#
+class Busser::RunnerPlugin::Behave < Busser::RunnerPlugin::Base
+  postinstall do
+     run!("curl -O 'https://bootstrap.pypa.io/get-pip.py'")
+     run!("python get-pip.py")
+     inside(Pathname.new(__FILE__).dirname.join("../../../vendor/behave")) do
+      run!("python setup.py install")
+    end
+  end
+
+  def test
+    run!("behave --summary -o behavelog.out #{suite_path("behave")}")
+  end
+end

data/vendor/behave/CHANGES.rst

@@ -0,0 +1,483 @@
+Version History
+===============================================================================
+
+Version: 1.2.6 (unreleased)
+-------------------------------------------------------------------------------
+
+GOALS:
+
+  - Improve support for Windows
+
+DOCUMENTATION:
+
+  * pull  #545: Spell "section" correctly (provided by: chelmertz)
+  * pull  #489: Fix link to Selenium docs in Django chapter (provided by: bittner)
+  * pull  #469: Fix typo in "formatters.rst" (provided by: ab9-er)
+  * pull  #443: Fixing grammar in philosophy.rst (provided by: jamesroutley)
+  * pull  #441: Integrate hint on testing more nicely (provided by: bittner)
+  * pull  #429: Replace "Manual Integration" by "Automation Libraries" section (provided by: bittner)
+  * pull  #379: Correct wording in README.rst (provided by: franklinchou)
+  * pull  #362: docs/tutorial.rst: fixed non-monospace font (provided by: spacediver)
+  * pull  #359: Update documentation related to Django (behave-django) (provided by: bittner)
+  * pull  #326: docs/tutorial.rst: Correct features directory path creation (provided by: memee)
+  * issue #356: docs/api.rst: type in implementation (submitted by: tomxtobin)
+  * pull  #335: docs/api.rst: execute_steps() example (provided by: miabbott)
+  * pull  #339: Adapt wording in install.rst (provided by: charleswhchan)
+  * pull  #338: docs/philosophy.rst: Correct to uppercase in example (provided by: charleswhchan)
+  * issue #323: Update Django Example to work with version >=1.7 (submitted by: mpetyx, provided by: bittner)
+  * pull  #327: Fix typo in Django doc (provided by: nikolas)
+  * pull  #321: Update Django integration (provided by: bittner, contains: #315, #316)
+  * FIX: cmdline/config-param doc-generator, avoid duplicated param entries (related to: #318)
+  * issue #317: Update comparison: lettuce tags (provided by: ramiabughazaleh)
+  * pull  #307: Typo in readme (provided by: dflock)
+  * pull  #305: behave.rst related fixes reapplied (provided by: bittner)
+  * pull  #292: Use title-cased keywords in tutorial scenario (provided by: neoblackcap)
+  * pull  #291: Tiny tweaks in tutorial docs (provided by: bernardpaulus)
+
+SITE:
+
+  * pull #343: Update/fix badges in README (provided by: mixxorx)
+
+ENHANCEMENTS:
+
+  * Tagged Examples: Examples in a ScenarioOutline can now have tags.
+  * pull  #447: behave settings from tox.ini (provided by: bittner)
+  * issue #411: Support multiple active-tags with same category (submitted by: Kani999)
+  * issue #409: Support async/@asyncio.coroutine steps (submitted by: dcarp)
+  * issue #357: Add language attribute to Feature class
+  * pull  #328: Auto-retry failed scenarios in unreliable environment (provided by: MihaiBalint, robertknight)
+  * issue #302: Support escaped-pipe in Gherkin table cell value (provided by: connorsml, pull #360)
+  * issue #301: Support default tags in configfile
+  * issue #299: Runner can continue after a failed step (same as: #314)
+  * issue #197: Hooks processing should be more exception safe (provided by: vrutkovs, jenisys, pull #205)
+
+FORMATTERS:
+
+  * pull  #446: Remove Formatter scenario_outline(), examples() method (provided by:  aisbaa, jenisys)
+  * pull  #448: json: Add status to scenarios in JSON report (provided by: remcowesterhoud)
+  * issue #462: json: Invalid JSON output when no features are selected (submitted by: remcowesterhoud)
+  * pull  #423: sphinx.steps: Support ref link for each step (provided by: ZivThaller)
+  * pull  #460: pretty: Print the step implementation location when dry-run (provided by: unklhe, jenisys)
+
+REPORTERS:
+
+  * junit: Add timestamp and hostname attributes to testsuite XML element.
+  * junit: Support to tweak output with userdata (experimental).
+  * junit: Support scenario hook-errors with JUnitReporter (related to: #466)
+
+CHANGES:
+
+  * status: Use Status enum-class for feature/scenario/step.status (was: string)
+  * hook-processing: Skips now feature/scenario/step if before-hook fails (related to: #454)
+  * parser: language comment in feature file has higher priority than --lang option (related to: #334).
+  * issue #385: before_scenario/before_feature called too late (submitted by: BRevzin)
+
+FIXED:
+
+  * pull  #476: scenario.status when scenario without steps is skipped (provided by: ar45, jenisys)
+  * pull  #471: convert an object to unicode (py2) using __unicode__ method first  unicode (provided by: ftartaggia)
+  * issue #458: UnicodeEncodeError inside naked except block in __main__.py (submitted by: 	mseery)
+  * issue #453: Unicode chars are broken in stacktrace (submitted by: throwable-one)
+  * issue #455: Restore backward compatibility to Cucumber style RegexMatcher (submitted by:  avabramov)
+  * issue #449: Unicode is processed incorrectly for Py2 in "textutil.text" (submitted by: throwable-one)
+  * issue #446: after_scenario HOOK-ERROR asserts with jUnit reporter (submitted by: lagin)
+  * issue #424: Exception message with unicode characters in nested steps (submitted by: yucer)
+  * issue #416: JUnit report messages cut off (submitted by: remcowesterhoud, provided by: bittner)
+  * issue #414: Support for Jython 2.7 (submitted by: gabtwi...)
+  * issue #384: Active Tags fail with ScenarioOutline (submitted by: BRevzin)
+  * issue #383: Handle (custom) Type parsing errors better (submitted by: zsoldosp)
+  * pull  #382: fix typo in tag name (provided by: zsoldosp)
+  * issue #361: utf8 file with BOM (provided by: karulis)
+  * issue #349: ScenarioOutline skipped with --format=json
+  * issue #336: Stacktrace contents getting illegal characters inserted with text function (submited by: fj40bryan)
+  * issue #330: Skipped scenarios are included in junit reports when --no-skipped is specified (provided by: vrutkovs, pull #331)
+  * issue #320: Userdata is case-insensitive when read from config file (provided by: mixxorz)
+  * issue #319: python-version requirements in behave.whl for Python2.6 (submitted by: darkfoxprime)
+  * issue #310: Use setuptools_behave.py with behave module
+  * issue #309: behave --lang-list fails on Python3 (and Python2)
+  * issue #300: UnicodeDecodeError when read steps.py (similar to: #361)
+  * issue #288: Use print function instead print statement in environment/steps files
+
+
+Version: 1.2.5 (2015-01-31)
+-------------------------------------------------------------------------------
+
+:Same as: Version 1.2.5a1 (unreleased).
+
+NEWS and CHANGES:
+
+  - General:
+
+    * Improve support for Python3 (py3.3, py3.4; #268)
+    * Various unicode related fixes (Unicode errors with non-ASCII, etc.)
+    * Drop support for Python 2.5
+
+  - Running:
+
+    * ScenarioOutline: Annotates name with row.id, ... to better represent row.
+    * NEW: Active Tags, see docs (`New and Noteworthy`_).
+    * NEW: Test stages, see docs (`New and Noteworthy`_).
+    * NEW: User-specific configuration data, see docs (`New and Noteworthy`_).
+    * CHANGED: Undefined step snippet uses now NotImplementedError (related to: #254)
+
+  - Model:
+
+    * ScenarioOutline: Various improvements, see docs (`New and Noteworthy`_).
+
+  - Formatters:
+
+    * plain: Can now show tags, but currently disabled per default
+    * NEW: steps.catalog: Readable summary of all steps (similar to: steps.doc, #271)
+    * NEW: User-defined formatters, see docs (`New and Noteworthy`_).
+
+ENHANCEMENTS:
+
+  * pull #285: Travis CI improvements to use container environment, etc. (provided by: thedrow)
+  * pull #272: Use option role to format command line arg docs (provided by: helenst)
+  * pull #271: Provide steps.catalog formatter (provided by: berdroid)
+  * pull #261: Support "setup.cfg" as configuration file, too (provided by: bittner)
+  * pull #260: Documentation tweaks and typo fixes (provided by: bittner)
+  * pull #254: Undefined step raises NotImplementedError instead of assert False (provided by: mhfrantz)
+  * issue #242: JUnitReporter can show scenario tags (provided by: rigomes)
+  * issue #240: Test Stages with different step implementations (provided by: attilammagyar, jenisys)
+  * issue #238: Allow to skip scenario in step function (provided by: hotgloupi, jenisys)
+  * issue #228: Exclude scenario fron run (provided by: jdeppe, jenisys)
+  * issue #227: Add a way to add command line options to behave (provided by: attilammagyar, jenisys)
+
+FIXED:
+
+  * pull  #283: Fix "fork me" image in docs (provided by: frodopwns)
+  * issue #280: Fix missing begin/end-markers in RegexMatcher (provided by: tomekwszelaki, jenisys)
+  * pull  #268: Fix py3 compatibility with all tests passed (provided by: sunliwen)
+  * pull  #252: Related to #251 (provided by: mcepl)
+  * pull  #190: UnicodeDecodeError in tracebacks (provided by: b3ni, vrutkovs, related to: #226, #230)
+  * issue #257: Fix JUnitReporter (XML) for Python3 (provided by: actionless)
+  * issue #249: Fix a number of docstring problems (provided by: masak)
+  * issue #253: Various problems in PrettyFormatter.exception()
+  * issue #251: Unicode crash in model.py (provided by: mcepl, jenisys)
+  * issue #236: Command line docs are confusing (solved by: #272)
+  * issue #230: problem with assert message that contains ascii over 128 value (provided by: jenisys)
+  * issue #226: UnicodeDecodeError in tracebacks (provided by: md1023, karulis, jenisys)
+  * issue #221: Fix some PY2/PY3 incompatibilities (provided by: johbo)
+  * pull  #219: IDE's unknown modules import issue (provided by: xbx)
+  * issue #216: Using --wip option does not disable ANSI escape sequences (coloring).
+  * issue #119: Python3 support for behave (solved by: #268 and ...)
+  * issue #82:  JUnitReporter fails with Python 3.x (fixed with: #257, #268)
+
+
+.. _`New and Noteworthy`: https://github.com/behave/behave/blob/master/docs/new_and_noteworthy.rst
+
+
+Version: 1.2.4 (2014-03-02)
+-------------------------------------------------------------------------------
+
+:Same as: Version 1.2.4a1 (unreleased).
+
+NEWS and CHANGES:
+
+  - Running:
+
+    * ABORT-BY-USER: Better handle KeyboardInterrupt to abort a test run.
+    * feature list files (formerly: feature configfiles) support wildcards.
+    * Simplify and improve setup of logging subsystem (related to: #143, #177)
+
+  - Step matchers:
+
+    * cfparse: Step matcher with "Cardinality Field" support (was: optional).
+
+  - Formatters:
+
+    * steps.usage: Avoid duplicated steps usage due to Scenario Outlines.
+    * json: Ensures now that matched step params (match args) cause valid JSON.
+
+
+IMPROVEMENT:
+
+  * issue #108: behave.main() can be called with command-line args (provided by: medwards, jenisys)
+  * issue #172: Subfolders in junit XML filenames (provided by: roignac).
+  * issue #203: Integration with pdb (debug on error; basic support)
+  * Simple test runner to run behave tests from "setup.py"
+
+FIXED:
+
+  * issue #143: Logging starts with a StreamHandler way too early (provided by: jtatum, jenisys).
+  * issue #175: Scenario isn't marked as 'failed' when Background step fails
+  * issue #177: Cannot setup logging_format
+  * issue #181: Escape apostrophes in undefined steps snippets
+  * issue #184: TypeError when running behave with --include option (provided by: s1ider).
+  * issue #186: ScenarioOutline uses wrong return value when if fails (provided by: mdavezac)
+  * issue #188: Better diagnostics if nested step is undefined
+  * issue #191: Using context.execute_steps() may change context.table/.text
+  * issue #194: Nested steps prevent that original stdout/stderr is restored
+  * issue #199: behave tag expression bug when or-not logic is used
+
+
+Version: 1.2.3 (2013-07-08)
+-------------------------------------------------------------------------------
+
+Latest stable version.
+Same as last development version.
+
+
+Version: 1.2.3a20 (2013-07-08)
+-------------------------------------------------------------------------------
+
+NEWS and CHANGES:
+
+  - Install:
+
+    * Require now parse>=1.6.2 to enforce log-bugfix #14 (was: parse>=1.6)
+
+  - Running:
+
+    * load_step_definitions: Are now sorted before loading (due to: Linux, ...).
+    * NEW: Use lazy-loading for formatters if possible (speed up self-tests by 20%).
+
+  - Model:
+
+    * location: Now a FileLocation object (was: string), required for ordering.
+
+  - Formatters:
+
+    * NEW: progress3 formatter, ScenarioStepProgressFormatter (provided by: roignac).
+    * NEW: sphinx.steps formatter, generate Sphinx-based docs for step definitions (related to #166).
+    * NEW: steps formatter, shows available step definitions.
+    * NEW: steps.doc formatter, shows documentation of step definitions (related to: #55).
+    * NEW: steps.usage formatter, shows where step definitions are used.
+    * RENAMED: json-pretty, tag_count, tag_location => json.pretty, tags, tags.location
+    * help: Shows now a better formatted list (improve readability).
+
+IMPROVEMENT:
+
+  * issue #166: behave should have a tool (or formatter) that generates Sphinx-based documentation (basics provided).
+
+FIXED:
+
+  * issue #172: JUnit report filename sometimes truncated (provided by: roignac).
+  * issue #171: Importing step from other step file fails with AmbiguousStep Error.
+  * issue #165: FIX issue #114: do not print a blank line when the feature is skipped (provided by: florentx).
+  * issue #164: StepRegistry.find_match() extends registered step_type lists.
+  * issue #122: Failing selftest feature: selftest.features/duplicated_step.feature.
+  * issue #110: Normalize paths provided at the command line (provided by: jesper).
+
+
+Version: 1.2.3a19 (2013-05-18)
+-------------------------------------------------------------------------------
+
+NEWS and CHANGES:
+
+  - Running (and model):
+
+    * NEW: Support scenario file locations on command-line, ala: "{filename}:{line}" (related to: #160).
+    * Formatters are now created only once (was: once for each feature).
+    * Scenarios can be now be selected by name or regular expression (#87).
+    * Dry-run mode: Detects now undefined steps.
+    * Dry-run mode: Uses untested counts now (was using: skipped counts).
+    * Run decision logic: Use ModelElement.mark_skipped() to preselect what not to run.
+    * Run decision logic: Use ModelElement.should_run() to decide if element should run.
+
+  - Parsing (and model):
+
+    * Parser: Add support for Scenario/ScenarioOutline descriptions (related to: #79).
+    * Parser: Refactor to simplify and avoid code duplications (related to: #79).
+    * Parser: Improve diagnostics when parse errors occur.
+    * Parser: Check that Backgrounds have no tags.
+    * NEW: json_parser, parses JSON output and builds model.
+    * json_parser: Add support for scenario descriptions (related to: #79).
+
+  - Formatters:
+
+    * INCOMPATIBLE CHANGE:
+      Formatter Ctor uses now StreamOpener instead of opened Stream.
+      Formatter output streams are now opened late, under control of the formatter.
+      This allows the formatter to support also directory mode (if needed).
+      Needed for RerunFormatter whose file was overwritten before it was read (#160).
+
+    * NEW: RerunFormatter to simplify to rerun last failing scenarios (related to: #160).
+    * NEW: TagLocationFormatter, shows where tags are used.
+    * NEW: TagCountFormatter, shows which tags are used and how often (reborn).
+    * JSONFormatter: Use JSON array mode now (related to: #161).
+    * JSONFormatter: Added "type" to Background, Scenario, ScenerioOutline (related to: #161).
+    * JSONFormatter: Added "error_message" to result (related to: #161).
+    * JSONFormatter: Use now list<lines> instead of string for multi-line text (related to: #161).
+    * JSONFormatter: Add support for scenario descriptions (related to: #79).
+    * JSONFormatter: Generates now valid JSON (well-formed).
+    * PlainFormatter: Shows now multi-line step parts (text, table), too.
+    * PrettyFormatter: Enters now monochrome mode if output is piped/redirected.
+    * ProgressFormatter: Flushes now output to provide better feedback.
+
+  - Reporters:
+
+    * JUnitReporter: Show complete scenario w/ text/tables. Improve readability.
+    * SummaryReporter: Summary shows now untested items if one or more exist.
+
+  - Testing, development:
+
+    * tox: Use tox now in off-line mode per default (use: "tox -e init"...).
+    * Add utility script to show longest step durations based on JSON data.
+    * JSON: Add basic JSON schema to support JSON output validation (related to: #161).
+    * JSON: Add helper script to validate JSON output against its schema (related to: #161).
+
+
+IMPROVEMENT:
+
+  * issue #161: JSONFormatter: Should use a slightly different output schema (provided by: jenisys)
+  * issue #160: Support rerun file with failed features/scenarios during the last test run (provided by: jenisys)
+  * issue #154: Support multiple formatters (provided by: roignac, jenisys)
+  * issue #103: sort feature file by name in a given directory (provided by: gurneyalex).
+  * issue #102: Add configuration file setting for specifying default feature paths (provided by: lrowe).
+  * issue  #87: Add --name option support (provided by: johbo, jenisys).
+  * issue  #79: Provide Support for Scenario Descriptions (provided by: caphrim007, jenisys).
+  * issue  #42: Show all undefined steps taking tags into account (provided by: roignac, jenisys)
+
+FIXED:
+
+  * issue #162 Unnecessary ContextMaskWarnings when assert fails or exception is raised (provided by: jenisys).
+  * issue #159: output stream is wrapped twice in the codecs.StreamWriter (provided by: florentx).
+  * issue #153: The runtime should not by-pass the formatter to print line breaks minor.
+  * issue #152: Fix encoding issues (provided by: devainandor)
+  * issue #145: before_feature/after_feature should not be skipped (provided by: florentx).
+  * issue #141: Don't check for full package in issue 112 (provided by: roignac).
+  * issue #125: Duplicate "Captured stdout" if substep has failed (provided by: roignac).
+  * issue  #60: JSONFormatter has several problems (last problem fixed).
+  * issue  #48: Docs aren't clear on how Background is to be used.
+  * issue  #47: Formatter processing chain is broken (solved by: #154).
+  * issue  #33: behave 1.1.0: Install fails under Windows (verified, solved already some time ago).
+  * issue  #28: Install fails on Windows (verified, solved already some time ago).
+
+
+Version: 1.2.2.18 (2013-03-20)
+-------------------------------------------------------------------------------
+
+NEWS and CHANGES:
+
+  * NullFormatter provided
+  * model.Row: Changed Ctor parameter ordering, move seldom used to the end.
+  * model.Row: Add methods .get(), .as_dict() and len operator (related to: #27).
+  * Introduce ``behave.compat`` as compatibility layer for Python versions.
+
+IMPROVEMENT:
+
+  * issue #117: context.execute_steps() should also support steps with multi-line text or table
+  * issue #116: SummaryReporter shows list of failing scenarios (provided by: roignac).
+  * issue #112: Improvement to AmbiguousStep error diagnostics
+  * issue #74:  django-behave module now available at pypi (done: 2012-10-04).
+  * issue #27:  Row should support .get() to be more dict-like
+
+FIXED:
+
+  * issue #135: Avoid leaking globals between step modules.
+  * issue #114: No blank lines when option --no-skipped is used (provided by: florentx).
+  * issue #111: Comment following @wip tag results in scenario being ignored
+  * issue  #83: behave.__main__:main() Various sys.exit issues
+  * issue  #80: source file names not properly printed with python 3.3.0
+  * issue  #62: --format=json: Background steps are missing (fixed: some time ago).
+
+RESOLVED:
+
+ * issue #98: Summary should include the names of the first X tests that failed (solved by: #116).
+
+
+Version: 1.2.2.16 (2013-02-10)
+-------------------------------------------------------------------------------
+
+NEW:
+
+  * "progress" formatter added (from jenisy-repo).
+  * Add "issue.features/" to simplify verification/validation of issues (from jenisy-repo).
+
+FIXED:
+
+  * issue #107: test/ directory gets installed into site-packages
+  * issue #99: Layout variation "a directory containing your feature files" is broken for running single features
+  * issue #96: Sub-steps failed without any error info to help debug issue
+  * issue #85: AssertionError with nested regex and pretty formatter
+  * issue #84: behave.runner behave does not reliably detected failed test runs
+  * issue #75: behave @list_of_features.txt is broken.
+  * issue #73: current_matcher is not predictable.
+  * issue #72: Using GHERKIN_COLORS caused an TypeError.
+  * issue #70: JUnitReporter: Generates invalid UTF-8 in CDATA sections (stdout/stderr output) when ANSI escapes are used.
+  * issue #69: JUnitReporter: Fault when processing ScenarioOutlines with failing steps
+  * issue #67: JSON formatter cannot serialize tables.
+  * issue #66: context.table and context.text are not cleared.
+  * issue #65: unrecognized --tag-help argument.
+  * issue #64: Exit status not set to 1 even there are failures in certain cases (related to: #52)
+  * issue #63: 'ScenarioOutline' object has no attribute 'stdout'.
+  * issue #35: "behave --format=plain --tags @one" seems to execute right scenario w/ wrong steps
+  * issue #32: "behave ... --junit-directory=xxx" fails for more than 1 level
+
+RESOLVED:
+
+  * issue #81: Allow defining steps in a separate library.
+  * issue #78: Added references to django-behave (pull-request).
+  * issue #77: Does not capture stdout from sub-processes
+
+REJECTED:
+
+  * issue #109: Insists that implemented tests are not implemented (not reproducable)
+  * issue #100: Forked package installs but won't run on RHEL.
+  * issue #88: Python 3 compatibility changes (=> use 2to3 tool instead).
+
+DUPLICATED:
+
+  * issue #106: When path is to a feature file only one folder level usable (same as #99).
+  * issue #105: behave's exit code only depends on the last scenario of the last feature (same as #95).
+  * issue #95: Failed test run still returns exit code 0 (same as #84, #64).
+  * issue #94: JUnit format does not handle ScenarioOutlines (same as #69).
+  * issue #92: Output from --format=plain shows skipped steps in next scenario (same as #35).
+  * issue #34: "behave --version" runs features, but shows no version (same as #30)
+
+
+
+Version 1.2.2 - August 21, 2012
+-------------------------------------------------------------------------------
+
+* Fix for an error when an assertion message contains Unicode characters.
+* Don't repr() the step text in snippets to avoid turning Unicode text into
+  backslash hell.
+
+
+Version 1.2.1 - August 19, 2012
+-------------------------------------------------------------------------------
+
+* Fixes for JSON output.
+* Move summary reporter and snippet output to stderr.
+
+
+Version 1.2.0 - August 18, 2012
+-------------------------------------------------------------------------------
+
+* Changed step name provided in snippets to avoid issues with the @step
+  decorator.
+* Use setup to create console scripts.
+* Fixed installation on Windows.
+* Fix ANSI escape sequences for cursor movement and text colourisation.
+* Fixes for various command-line argument issues.
+* Only print snippets once per unique step.
+* Reworked logging capture.
+* Fixes for dry-run mode.
+* General fixes.
+
+
+Version 1.1.0 - January 23, 2012
+-------------------------------------------------------------------------------
+
+* Context variable now contains current configuration.
+* Context values can now be tested for (``name in context``) and deleted.
+* ``__file__`` now available inside step definition files.
+* Fixes for various formatting issues.
+* Add support for configuration files.
+* Add finer-grained controls for various things like log capture, coloured
+  output, etc.
+* Fixes for tag handling.
+* Various documentation enhancements, including an example of full-stack
+  testing with Django thanks to David Eyk.
+* Split reports into a set of modules, add junit output.
+* Added work-in-progress ("wip") mode which is useful when developing new code
+  or new tests. See documentation for more details.
+
+
+Version 1.0.0 - December 5, 2011
+-------------------------------------------------------------------------------
+
+* Initial release