bryanl-gherkin 2.11.1.1

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009-2012 Mike Sassak, Gregory Hnatiuk, Aslak Hellesøy
+
+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/README.md

@@ -0,0 +1,272 @@
+[![Build Status](https://secure.travis-ci.org/cucumber/gherkin.png)](http://travis-ci.org/cucumber/gherkin)
+
+A fast lexer and parser for the Gherkin language based on Ragel. Gherkin is two things:
+
+* The language that has evolved out of the Cucumber project.
+* This library.
+
+Supported platforms:
+
+* [Ruby](https://rubygems.org/gems/gherkin) 1.8.7-1.9.3 (MRI, JRuby, REE, Rubinius)
+* [Pure Java](http://search.maven.org/#search%7Cga%7C1%7Cgherkin) (jar file)
+* [JavaScript](http://search.npmjs.org/#/gherkin) (Tested with V8/node.js/Chrome, but might work on other JavaScript engines)
+* [.NET](http://nuget.org/List/Packages/gherkin) (dll file)
+
+## Installation
+
+### Ruby/JRuby
+
+    gem install gherkin
+
+#### Troubleshooting
+
+On JRuby you may get an error saying:
+
+    ERROR:  While executing gem ... (ArgumentError)
+    undefined class/module YAML::Syck::DefaultKey
+
+You can get around this problem by upgrading rubygems:
+
+    jruby -S gem install rubygems-update
+    gem update --system
+
+Another problem you might encounter is:
+
+    ERROR: While executing gem ... (ArgumentError)
+    invalid byte sequence in US-ASCII
+
+If this happens, try defining your shell's encoding:
+
+    # Linux
+    export LANG=en_US.UTF-8
+
+    # OS X
+    export LC_CTYPE=en_US.UTF-8
+
+### Node.js
+
+    npm install gherkin
+
+### Java
+
+The jar file is in the central Maven repo.
+
+    <dependency>
+        <groupId>info.cukes</groupId>
+        <artifactId>gherkin</artifactId>
+        <version>2.11.1</version>
+    </dependency>
+
+You can get it manually from [Maven Central](http://search.maven.org/#browse%7C-2073395818)
+
+### .NET
+
+Get the dll from [NuGet](http://nuget.org/List/Packages/gherkin)
+
+## API Docs
+
+* [Ruby](http://cukes.info/gherkin/api/ruby/latest/)
+* [Java](http://cukes.info/gherkin/api/java/latest/apidocs/index.html)
+
+## Hacking: Installing the toolchain
+
+Due to the cross-platform nature of this library, you have to install a lot of tools to build gherkin yourself.
+In order to make it easier for occasional contributors to get the development environment up and running, you don't
+have to install everything up front. The build scripts should tell you if you are missing something. For example,
+you shouldn't have to install MinGW to build windows binaries if you are a Linux user and just want to fix a bug in
+the C code.
+
+### Common dependencies
+
+These are the minimal tools you need to install:
+
+* Ragel (brew install ragel or apt-get install ragel)
+* Ruby (any version should do).
+* A clone of the cucumber git repo to a "cucumber" sibling folder of your gherkin folder. (Only needed to run cucumber tests)
+* RVM (you may not need this if you are only building for a single platform)
+
+With this minimal tool chain installed, install Ruby gems needed by the build:
+
+    gem install bundler
+    bundle install
+
+Running RSpec and Cucumber tests
+
+    rake clean spec cucumber
+
+If the RL_LANGS environment variable is set, only the parsers for the languages specified there will be built.
+E.g. in Bash, export RL_LANGS="en,fr,no". This can be quite helpful when modifying the Ragel grammar.
+
+See subsections for building for a specific platform.
+
+### MRI, REE or Rubinius
+
+You'll need GCC installed.
+
+Build the gem with:
+
+    rake build
+
+### Pure Java and JRuby
+
+You must install JRuby to build the pure Java jar or the JRuby gem:
+
+    rvm install jruby
+    rvm use jruby
+    rvm gemset create cucumber
+    rvm gemset use cucumber
+    gem install bundler
+    bundle install
+
+Now you can build the jar with:
+
+    rake clean jar
+
+### JavaScript
+
+In order to build and test Gherkin for JavaScript you must install:
+
+* Node.js (0.6.17 or higher with npm)
+* Ragel with JavaScript support: http://github.com/dominicmarks/ragel-js
+  * Make sure you have `autoconf` and `automake` (`brew install automake`)
+  * Make sure you have the official ragel (`brew install ragel`)
+  * Make sure you have kelbt (`brew install kelbt`). If that fails, install manually from http://www.complang.org/kelbt/
+  * `cd ragel-js/ragel-svn && ./autogen.sh && ./configure --disable-manual`
+  * `make && make install`
+* Define the GHERKIN_JS environment variable in your shell (any value will do)
+
+Now you can build the JavaScript with:
+
+    rake js
+
+And you can try it out with node.js:
+
+    node js/example/print.js spec/gherkin/fixtures/1.feature
+
+Or the json formatter:
+
+    node js/example/json_fomratter_example.js
+
+If you're hacking and just want to rebuild the English parser:
+
+    rake js/lib/gherkin/lexer/en.js
+
+In order to test the native JavaScript implementation of JSONFormatter, you also need to define the `GHERKIN_JS_NATIVE` environment
+variable. It's recommended you don't do this permanently, as it will disable testing the Ruby implementation. Try this instead:
+
+    GHERKIN_JS_NATIVE=true GHERKIN_JS=true bundle exec rake
+
+TODO: Make all specs pass with js lexer - replace 'c(listener)' with 'js(listener)' in i18n.rb
+
+### .NET dll
+
+You must install Mono SDK 2.10.8. The OS X package installer is not recommended as it modifies your system PATH and makes Homebrew unhappy. Install with homebrew instead:
+
+    brew install ikvm/mono.rb
+
+You must also download NuGet.exe from [CodePlex](http://nuget.codeplex.com/releases) and place it in `/usr/local/nuget/NuGet.exe`. When it's installed, update it and register your NuGet API Key:
+
+    # In case we need to update
+    mono /usr/local/nuget/NuGet.exe Update -self
+
+    # The key is at https://nuget.org/account
+    mono --runtime=v4.0.30319 /usr/local/nuget/NuGet.exe SetApiKey xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
+
+Now you can build the .NET dll with:
+
+	mkdir release
+    rake ikvm
+    rake release/nuspec/lib/gherkin.dll
+
+This should build `release/nuspec/lib/gherkin.dll`
+
+### MinGW Rubies (for Windows gems)
+
+In order to build Windows binaries (so we can release Windows gems from OS X/Linux) we first need to install MinGW:
+
+	./install_mingw_os_x.sh
+
+Now, make sure you have openssl installed - it's needed to build the rubies.
+
+    brew install openssl
+
+Next, we're going to install Ruby 1.8.7 and Ruby 1.9.3 for MinGW. We need both versions so we can build Windows binaries for both.
+OS X Lion (or later) doesn't ship with an LLVM free gcc, which you will need in order to install ruby 1.8.7. We can install it with:
+
+    brew install https://raw.github.com/Homebrew/homebrew-dupes/master/apple-gcc42.rb
+
+For more info see:
+
+* http://stackoverflow.com/questions/6170813/why-cant-i-install-rails-on-lion-using-rvm
+* https://github.com/mxcl/homebrew/wiki/Custom-GCC-and-cross-compilers
+
+Now we're ready to install the Windows rubies:
+
+    unset GHERKIN_JS
+
+    # 1.9.3
+    rvm install 1.9.3-p194
+    rvm use 1.9.3-p194
+    rvm gemset create cucumber
+    rvm gemset use cucumber
+    gem install bundler
+    bundle install
+    PATH=/usr/local/mingw/bin:$PATH CC=/usr/local/mingw/bin/i686-w64-mingw32-gcc rake-compiler cross-ruby VERSION=1.9.3-p194
+
+    # 1.8.7
+    CC=gcc-4.2 rvm install 1.8.7-p352
+    rvm use 1.8.7-p352
+    rvm gemset create cucumber
+    rvm gemset use cucumber
+    gem install bundler
+    bundle install
+    PATH=/usr/local/mingw/bin:$PATH CC=/usr/local/mingw/bin/i686-w64-mingw32-gcc rake-compiler cross-ruby VERSION=1.8.7-p352
+
+Now you can build Windows gems:
+
+    rake compile
+    mkdir release
+    rake gems:win
+
+## Release process
+
+Make sure you have access to all the servers where packages are being uploaded:
+
+* npm registry: `npm login`
+* rubygems.org: `gem push`
+* cukes.info: `ssh cukes.info`
+* sonatype: Check `~/.m2/settings.xml` and that you have gnupg (OS X users: Install [GPGTools](http://www.gpgtools.org/installer/index.html))
+  * Make sure you have a key [with no sub-key](https://docs.sonatype.org/display/Repository/How+To+Generate+PGP+Signatures+With+Maven)
+* nuget: See .NET section above
+
+Run tests once with GHERKIN_JS_NATIVE=true:
+
+    GHERKIN_JS_NATIVE=true GHERKIN_JS=true bundle exec rake
+
+Now we can release:
+
+* Make sure GHERKIN_JS is defined (see JavaScript section above)
+* Bump version in:
+  * This file (Installation/Java section)
+  * gherkin.gemspec
+  * java/pom.xml
+  * js/package.json
+* Run `bundle update`, so Gemfile.lock gets updated with the changes.
+* Commit changes, otherwise you will get an error at the end when a tag is made.
+* Run `bundle exec rake gems:prepare && ./build_native_gems.sh && bundle exec rake release:ALL`
+
+## Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Run rake ragel:rb to generate all the I18n lexers
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with Rakefile, VERSION, or History.txt.
+  (if you want to have your own version, that is fine but
+  bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+## Copyright
+
+Copyright (c) 2009-2012 Mike Sassak, Gregory Hnatiuk, Aslak Hellesøy. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,26 @@
+# encoding: utf-8
+GHERKIN_VERSION = Gem::Specification.load(File.dirname(__FILE__) + '/gherkin.gemspec').version.version
+require 'rubygems'
+unless ENV['RUBY_CC_VERSION']
+  require 'bundler'
+  Bundler.setup
+  Bundler::GemHelper.install_tasks
+end
+ENV['RUBYOPT'] = nil # Necessary to prevent Bundler from *&^%$#ing up rake-compiler.
+
+require 'rake/clean'
+
+begin
+  # Support Rake >= 0.9.0
+  require 'rake/dsl_definition'
+  include Rake::DSL
+rescue LoadError
+end
+
+$:.unshift(File.dirname(__FILE__) + '/lib')
+
+Dir['tasks/**/*.rake'].each { |rake| load File.expand_path(rake) }
+
+task :default  => [:spec, :cucumber]
+task :spec     => defined?(JRUBY_VERSION) ? :jar : :compile
+task :cucumber => defined?(JRUBY_VERSION) ? :jar : :compile

data/build_native_gems.sh

@@ -0,0 +1,7 @@
+#!/bin/sh
+rm -Rf release
+mkdir release
+GEM_PLATFORM=java gem build gherkin.gemspec
+GEM_PLATFORM=x86-mswin32 gem build gherkin.gemspec
+GEM_PLATFORM=x86-mingw32 gem build gherkin.gemspec
+mv *.gem release

data/cucumber.yml

@@ -0,0 +1,4 @@
+default: --format pretty --tags ~@pending,~@wip --strict --color --dotcucumber features/.cucumber features
+wip: --format pretty --tags @wip --wip features
+pending: --format pretty --tags @pending,~@native_lexer
+travis: --format pretty --tags ~@cucumber-source-available

data/examples/parse_and_output_json.rb

@@ -0,0 +1,19 @@
+require 'gherkin/parser/parser'
+require 'gherkin/formatter/json_formatter'
+require 'stringio'
+require 'json'
+
+# This example reads a couple of features and outputs them as JSON.
+
+io = StringIO.new
+formatter = Gherkin::Formatter::JSONFormatter.new(io)
+parser = Gherkin::Parser::Parser.new(formatter)
+
+sources = ["features/native_lexer.feature", "features/escaped_pipes.feature"]
+sources.each do |s|
+  path = File.expand_path(File.dirname(__FILE__) + '/../' + s)
+  parser.parse(IO.read(path), path, 0)
+end
+
+formatter.done
+puts JSON.pretty_generate(JSON.parse(io.string))

data/features/.cucumber/stepdefs.json

@@ -0,0 +1,244 @@
+[
+  {
+    "file_colon_line": "features/step_definitions/eyeball_steps.rb:1",
+    "flags": "",
+    "source": "^they have arrived$",
+    "steps": [
+      {
+        "args": [
+
+        ],
+        "name": "they have arrived"
+      }
+    ]
+  },
+  {
+    "file_colon_line": "features/step_definitions/gherkin_steps.rb:1",
+    "flags": "",
+    "source": "^a \"(ruby|native)\" \"([^\\\"]*)\" parser$",
+    "steps": [
+
+    ]
+  },
+  {
+    "file_colon_line": "features/step_definitions/gherkin_steps.rb:5",
+    "flags": "",
+    "source": "^the\\ following\\ text\\ is\\ parsed:$",
+    "steps": [
+      {
+        "args": [
+
+        ],
+        "name": "the following text is parsed:"
+      }
+    ]
+  },
+  {
+    "file_colon_line": "features/step_definitions/gherkin_steps.rb:9",
+    "flags": "",
+    "source": "^there\\ should\\ be\\ no\\ parse\\ errors$",
+    "steps": [
+      {
+        "args": [
+
+        ],
+        "name": "there should be no parse errors"
+      }
+    ]
+  },
+  {
+    "file_colon_line": "features/step_definitions/gherkin_steps.rb:13",
+    "flags": "",
+    "source": "^there should be a parse error on (line \\d+)$",
+    "steps": [
+      {
+        "args": [
+          {
+            "offset": 33,
+            "val": "line 1"
+          }
+        ],
+        "name": "there should be a parse error on line 1"
+      }
+    ]
+  },
+  {
+    "file_colon_line": "features/step_definitions/gherkin_steps.rb:17",
+    "flags": "",
+    "source": "^there should be parse errors on (lines .*)$",
+    "steps": [
+      {
+        "args": [
+          {
+            "offset": 32,
+            "val": "lines 1 and 2"
+          }
+        ],
+        "name": "there should be parse errors on lines 1 and 2"
+      },
+      {
+        "args": [
+          {
+            "offset": 32,
+            "val": "lines 1 through 3"
+          }
+        ],
+        "name": "there should be parse errors on lines 1 through 3"
+      },
+      {
+        "args": [
+          {
+            "offset": 32,
+            "val": "lines 10 and 17"
+          }
+        ],
+        "name": "there should be parse errors on lines 10 and 17"
+      },
+      {
+        "args": [
+          {
+            "offset": 32,
+            "val": "lines 3 and 5"
+          }
+        ],
+        "name": "there should be parse errors on lines 3 and 5"
+      },
+      {
+        "args": [
+          {
+            "offset": 32,
+            "val": "lines 5, 10 and 12"
+          }
+        ],
+        "name": "there should be parse errors on lines 5, 10 and 12"
+      }
+    ]
+  },
+  {
+    "file_colon_line": "features/step_definitions/json_formatter_steps.rb:13",
+    "flags": "",
+    "source": "^a JSON formatter$",
+    "steps": [
+
+    ]
+  },
+  {
+    "file_colon_line": "features/step_definitions/json_formatter_steps.rb:18",
+    "flags": "",
+    "source": "^the outputted JSON should be:$",
+    "steps": [
+      {
+        "args": [
+
+        ],
+        "name": "the outputted JSON should be:"
+      }
+    ]
+  },
+  {
+    "file_colon_line": "features/step_definitions/json_parser_steps.rb:5",
+    "flags": "",
+    "source": "^a PrettyFormatter$",
+    "steps": [
+
+    ]
+  },
+  {
+    "file_colon_line": "features/step_definitions/json_parser_steps.rb:10",
+    "flags": "",
+    "source": "^a JSON lexer$",
+    "steps": [
+
+    ]
+  },
+  {
+    "file_colon_line": "features/step_definitions/json_parser_steps.rb:14",
+    "flags": "",
+    "source": "^the following JSON is parsed:$",
+    "steps": [
+      {
+        "args": [
+
+        ],
+        "name": "the following JSON is parsed:"
+      }
+    ]
+  },
+  {
+    "file_colon_line": "features/step_definitions/json_parser_steps.rb:18",
+    "flags": "",
+    "source": "^the outputted text should be:$",
+    "steps": [
+      {
+        "args": [
+
+        ],
+        "name": "the outputted text should be:"
+      }
+    ]
+  },
+  {
+    "file_colon_line": "features/step_definitions/pretty_formatter_steps.rb:50",
+    "flags": "",
+    "source": "^I have Cucumber's source code next to Gherkin's$",
+    "steps": [
+      {
+        "args": [
+
+        ],
+        "name": "I have Cucumber's source code next to Gherkin's"
+      }
+    ]
+  },
+  {
+    "file_colon_line": "features/step_definitions/pretty_formatter_steps.rb:55",
+    "flags": "",
+    "source": "^I find all of the \\.feature files$",
+    "steps": [
+      {
+        "args": [
+
+        ],
+        "name": "I find all of the .feature files"
+      }
+    ]
+  },
+  {
+    "file_colon_line": "features/step_definitions/pretty_formatter_steps.rb:59",
+    "flags": "",
+    "source": "^I send each prettified original through the \"([^\"]*)\" machinery$",
+    "steps": [
+      {
+        "args": [
+          {
+            "offset": 45,
+            "val": "json"
+          }
+        ],
+        "name": "I send each prettified original through the \"json\" machinery"
+      },
+      {
+        "args": [
+          {
+            "offset": 45,
+            "val": "pretty"
+          }
+        ],
+        "name": "I send each prettified original through the \"pretty\" machinery"
+      }
+    ]
+  },
+  {
+    "file_colon_line": "features/step_definitions/pretty_formatter_steps.rb:83",
+    "flags": "",
+    "source": "^the machinery output should be identical to the prettified original$",
+    "steps": [
+      {
+        "args": [
+
+        ],
+        "name": "the machinery output should be identical to the prettified original"
+      }
+    ]
+  }
+]