cuke_modeler 3.5.0 → 3.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ba3e400ea68f67944c0c5bf170179fb50a60237e507d3113a921c844010f7d91
-  data.tar.gz: 6224ca8ff2505acfb0415c82e9b1963ba5cf21573e2a9cac8857cb63171b288f
+  metadata.gz: d7821b738cb9b7436e38de701654c9ca04d087ba2e482f01af0600f86383b47d
+  data.tar.gz: 8b71afb721c52cc198243a468807547d45254dab84dd5bafcbec49e9bb4befb0
 SHA512:
-  metadata.gz: a447530c96482e6464ad31151262e5a0fbfd11527445ae8965c834e6ece15ee33f89381eb2276d7ee043823ab491eaed932bb35f492bfdb2fe8a43defd605e37
-  data.tar.gz: e8b05b052cad1f7395dec1e8da58bd84145c1699dce19b9bb261eb76bf29ceb1ebf3e7fa2cfe13773ff9f29f8c86d93543f9a5a34f79b1fc2fe402257618bbe7
+  metadata.gz: f114b4de2f4f2ef4ffd95078c7b8f72db2318174a75c4d4ed86a900ed21585e91e918afe97770afc1857b3cc80c904e471717f59a90c814bd7664575879e07e8
+  data.tar.gz: e870f0c73a8f296f6c8b108956d787586e9f47b3a2bff78db9a10db58c8df2ffc39fed04a1ace3629911c03f36ac6aee6c3e74475c60c58d7d0416f141d07037

data/CHANGELOG.md

@@ -8,6 +8,53 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 Nothing yet...
 
+
+## [3.10.0] - 2021-05-28
+
+### Added
+ - Support added for more versions of the `cucumber-gherkin` gem
+   - 19.x
+
+### Fixed
+ - `Rule` models now clear out parsing data for their tags. This data was an unintentional duplication of the 
+   parsing data that the `Tag` models already contained. 
+
+
+## [3.9.0] - 2021-04-23
+
+### Added
+ - `Rule` models are now taggable elements
+
+
+## [3.8.0] - 2021-04-18
+
+### Added
+ - Support added for more versions of the `cucumber-gherkin` gem
+   - 18.x
+
+
+## [3.7.0] - 2021-02-18
+
+### Added
+ - Support added for more versions of the `cucumber-gherkin` gem
+   - 17.x
+
+
+## [3.6.0] - 2021-01-05
+
+### Added
+ - Ruby 3.x is now supported
+ - All models are now `Enumerable`. However, some methods such as `Enumerable#max` and `Enumerable#sort` do not work 
+   because models do not meaningfully compare to each other.
+
+### Deprecated
+ - `Model#each_descendant` and `Model#each_model` will be removed on the next major release. `Model#each` and methods in 
+ the `Enumerable` module now provide this kind of functionality.
+
+### Fixed
+ - `Row#children` now returns the row's `Cell` models instead of returning an empty array
+
+
 ## [3.5.0] - 2020-12-19
 
 ### Added
@@ -329,7 +376,7 @@ Nothing yet...
 
 ### Fixed
 
- - Fixed a bug that was causing object comparison using #== to not 
+ - Fixed a bug that was causing object comparison using `#==` to not 
    work when comparing some models to other types of objects.
 
 
@@ -340,7 +387,12 @@ Nothing yet...
  - Initial release
 
 
-[Unreleased]: https://github.com/enkessler/cuke_modeler/compare/v3.5.0...HEAD
+[Unreleased]: https://github.com/enkessler/cuke_modeler/compare/v3.10.0...HEAD
+[3.10.0]: https://github.com/enkessler/cuke_modeler/compare/v3.9.0...v3.10.0
+[3.9.0]: https://github.com/enkessler/cuke_modeler/compare/v3.8.0...v3.9.0
+[3.8.0]: https://github.com/enkessler/cuke_modeler/compare/v3.7.0...v3.8.0
+[3.7.0]: https://github.com/enkessler/cuke_modeler/compare/v3.6.0...v3.7.0
+[3.6.0]: https://github.com/enkessler/cuke_modeler/compare/v3.5.0...v3.6.0
 [3.5.0]: https://github.com/enkessler/cuke_modeler/compare/v3.4.0...v3.5.0
 [3.4.0]: https://github.com/enkessler/cuke_modeler/compare/v3.3.0...v3.4.0
 [3.3.0]: https://github.com/enkessler/cuke_modeler/compare/v3.2.0...v3.3.0

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2014-2020 Eric Kessler, et al
+Copyright (c) 2014-2021 Eric Kessler, et al
 
 MIT License
 

data/README.md

@@ -4,15 +4,15 @@ Basic stuff:
 [![Downloads](https://img.shields.io/gem/dt/cuke_modeler.svg)](https://rubygems.org/gems/cuke_modeler)
 
 User stuff:
-[![Cucumber Docs](http://img.shields.io/badge/Documentation-Features-green.svg)](https://app.cucumber.pro/projects/cuke_modeler)
+[![Cucumber Docs](http://img.shields.io/badge/Documentation-Features-green.svg)](https://github.com/enkessler/cuke_modeler/tree/master/testing/cucumber/features)
 [![Yard Docs](http://img.shields.io/badge/Documentation-API-blue.svg)](https://www.rubydoc.info/gems/cuke_modeler)
 
 Developer stuff:
-[![Build Status](https://travis-ci.org/enkessler/cuke_modeler.svg)](https://travis-ci.org/enkessler/cuke_modeler)
-[![Build status](https://ci.appveyor.com/api/projects/status/is8xqvoqn3pjh9l0?svg=true)](https://ci.appveyor.com/project/enkessler/cuke-modeler)
-[![Coverage Status](https://coveralls.io/repos/github/enkessler/cuke_modeler/badge.svg)](https://coveralls.io/github/enkessler/cuke_modeler)
+[![Build Status](https://travis-ci.org/enkessler/cuke_modeler.svg?branch=master)](https://travis-ci.org/enkessler/cuke_modeler)
+[![Build status](https://ci.appveyor.com/api/projects/status/is8xqvoqn3pjh9l0/branch/master?svg=true)](https://ci.appveyor.com/project/enkessler/cuke-modeler)
+[![Coverage Status](https://coveralls.io/repos/github/enkessler/cuke_modeler/badge.svg?branch=master)](https://coveralls.io/github/enkessler/cuke_modeler?branch=master)
 [![Maintainability](https://api.codeclimate.com/v1/badges/83986d8f7a918fed9707/maintainability)](https://codeclimate.com/github/enkessler/cuke_modeler/maintainability)
-[![Inline docs](http://inch-ci.org/github/enkessler/cuke_modeler.svg)](https://inch-ci.org/github/enkessler/cuke_modeler)
+[![Inline docs](http://inch-ci.org/github/enkessler/cuke_modeler.svg?branch=master)](https://inch-ci.org/github/enkessler/cuke_modeler)
 
 ---
 
@@ -21,7 +21,7 @@ Developer stuff:
 There comes a time in every programmer's adventures with Cucumber when they 
 want to do Really Cool Stuff with their tests. This usually necessitates 
 scanning all of their feature files and playing with the output. While the 
-**[cucumber-gherkin](https://github.com/cucumber/cucumber/tree/master/gherkin)** gem does a fine job of parsing feature files, reading or even manipulating 
+**[cucumber-gherkin](https://github.com/cucumber/cucumber/tree/master/gherkin)** gem ([previously](https://github.com/enkessler/cuke_modeler/blob/master/CHANGELOG.md#300---2020-06-08) just the `gherkin` gem) does a fine job of parsing feature files, reading or even manipulating 
 the resulting Abstract Syntax Tree is not always fun. **cuke_modeler** comes to 
 the rescue by providing a modeling layer that is easier to work with.
  
@@ -84,7 +84,7 @@ an entire test suite!
 
 For more information on the different models (which more or less have the same relation 
 to each other as described in the AST [here](https://github.com/cucumber/cucumber/tree/master/gherkin#ast)) and how to use them, see the 
-[documentation](https://app.cucumber.pro/projects/cuke_modeler).
+[documentation](https://github.com/enkessler/cuke_modeler/tree/master/testing/cucumber/features).
 
 ## Modeling dialects other than English
 

data/cuke_modeler.gemspec

@@ -13,10 +13,18 @@ Gem::Specification.new do |spec|
                         "Abstract Syntax Tree that the 'cucumber-gherkin' gem generates when parsing features, ",
                         'as well as providing models for feature files and directories in order to be able to ',
                         "have a fully traversable model tree of a test suite's structure. These models can then ",
-                        'be analyzed or manipulated more easily than the underlying AST layer.'].join("\n")
+                        'be analyzed or manipulated more easily than the underlying AST layer.'].join
   spec.homepage      = 'https://github.com/enkessler/cuke_modeler'
   spec.license       = 'MIT'
 
+  spec.metadata = {
+    'bug_tracker_uri'   => 'https://github.com/enkessler/cuke_modeler/issues',
+    'changelog_uri'     => 'https://github.com/enkessler/cuke_modeler/blob/master/CHANGELOG.md',
+    'documentation_uri' => 'https://www.rubydoc.info/gems/cuke_modeler',
+    'homepage_uri'      => 'https://github.com/enkessler/cuke_modeler',
+    'source_code_uri'   => 'https://github.com/enkessler/cuke_modeler'
+  }
+
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
   spec.files = Dir.chdir(File.expand_path('', __dir__)) do
@@ -26,15 +34,16 @@ Gem::Specification.new do |spec|
   end
   spec.require_paths = ['lib']
 
-  spec.required_ruby_version = '>= 2.3', '< 3.0'
+  spec.required_ruby_version = '>= 2.3', '< 4.0'
 
-  spec.add_runtime_dependency 'cucumber-gherkin', '< 17.0'
+  spec.add_runtime_dependency 'cucumber-gherkin', '< 20.0'
 
   spec.add_development_dependency 'bundler', '< 3.0'
+  spec.add_development_dependency 'childprocess', '< 5.0'
   spec.add_development_dependency 'coveralls', '< 1.0.0'
+  spec.add_development_dependency 'ffi', '< 2.0' # This is an invisible dependency for the `childprocess` gem on Windows
   # Cucumber 4.x is the earliest version to use cucumber-gherkin
-  spec.add_development_dependency 'cucumber', '>= 4.0.0', '< 6.0.0'
-  spec.add_development_dependency 'racatt', '~> 1.0'
+  spec.add_development_dependency 'cucumber', '>= 4.0.0', '< 7.0.0'
   spec.add_development_dependency 'rainbow', '< 4.0.0'
   spec.add_development_dependency 'rake', '< 14.0.0'
   spec.add_development_dependency 'rspec', '~> 3.0'
@@ -44,4 +53,5 @@ Gem::Specification.new do |spec|
   # Coveralls gem does not support any newer version than this
   spec.add_development_dependency 'simplecov', '<= 0.16.1'
   spec.add_development_dependency 'test-unit', '< 4.0.0'
+  spec.add_development_dependency 'yard', '< 1.0'
 end

data/lib/cuke_modeler.rb

@@ -1,5 +1,4 @@
 # The top level namespace used by this gem
-
 module CukeModeler
 end
 

data/lib/cuke_modeler/adapters/gherkin_17_adapter.rb

@@ -0,0 +1,13 @@
+require_relative 'gherkin_9_adapter'
+
+
+module CukeModeler
+
+  # NOT A PART OF THE PUBLIC API
+  # An adapter that can convert the output of version 17.x of the *cucumber-gherkin* gem into input that is consumable
+  # by this gem.
+
+  class Gherkin17Adapter < Gherkin9Adapter
+
+  end
+end

data/lib/cuke_modeler/adapters/gherkin_18_adapter.rb

@@ -0,0 +1,24 @@
+require_relative 'gherkin_9_adapter'
+
+
+module CukeModeler
+
+  # NOT A PART OF THE PUBLIC API
+  # An adapter that can convert the output of version 18.x of the *cucumber-gherkin* gem into input that is consumable
+  # by this gem.
+  class Gherkin18Adapter < Gherkin9Adapter
+
+    # Adapts the AST sub-tree that is rooted at the given rule node.
+    def adapt_rule(rule_ast)
+      adapted_rule = super(rule_ast)
+
+      clear_child_elements(adapted_rule, [[:rule, :tags]])
+
+      # Tagging of Rules was added in Gherkin 18
+      adapted_rule['tags'] = adapt_tags(rule_ast[:rule])
+
+      adapted_rule
+    end
+
+  end
+end

data/lib/cuke_modeler/adapters/gherkin_19_adapter.rb

@@ -0,0 +1,61 @@
+require_relative 'gherkin_18_adapter'
+
+
+module CukeModeler
+
+  # NOT A PART OF THE PUBLIC API
+  # An adapter that can convert the output of version 19.x of the *cucumber-gherkin* gem into input that is consumable
+  # by this gem.
+  class Gherkin19Adapter < Gherkin18Adapter
+
+    # Adapts the AST sub-tree that is rooted at the given step node.
+    def adapt_step(step_ast)
+      adapted_step = super(step_ast)
+
+      clear_child_elements(adapted_step, [[:dataTable],
+                                          [:docString]])
+
+      if step_ast[:docString]
+        adapted_step['doc_string'] = adapt_doc_string(step_ast[:docString])
+      elsif step_ast[:dataTable]
+        adapted_step['table'] = adapt_step_table(step_ast[:dataTable])
+      end
+
+      adapted_step
+    end
+
+    # Adapts the AST sub-tree that is rooted at the given doc string node.
+    def adapt_doc_string(doc_string_ast)
+      adapted_doc_string = super(doc_string_ast)
+
+      adapted_doc_string['content_type'] = doc_string_ast[:mediaType]
+
+      adapted_doc_string
+    end
+
+    # Adapts the AST sub-tree that is rooted at the given example node.
+    def adapt_example(example_ast)
+      adapted_example = super(example_ast)
+
+      clear_child_elements(adapted_example, [[:tableHeader],
+                                             [:tableBody]])
+
+      adapted_example['rows'] << adapt_table_row(example_ast[:tableHeader]) if example_ast[:tableHeader]
+
+      example_ast[:tableBody].each do |row|
+        adapted_example['rows'] << adapt_table_row(row)
+      end
+
+      adapted_example
+    end
+
+
+    private
+
+
+    def test_has_examples?(ast_node)
+      ast_node[:scenario][:examples].any?
+    end
+
+  end
+end

data/lib/cuke_modeler/adapters/gherkin_9_adapter.rb

@@ -6,7 +6,6 @@ module CukeModeler
   # NOT A PART OF THE PUBLIC API
   # An adapter that can convert the output of version 9.x of the *cucumber-gherkin* gem into input that is consumable
   # by this gem.
-
   class Gherkin9Adapter
 
     # Adapts the given AST into the shape that this gem expects
@@ -329,6 +328,7 @@ module CukeModeler
 
     def clear_child_elements(ast, child_paths)
       child_paths.each do |traversal_path|
+        # Wipe the value if it's there but don't add any keys to the hash if it didn't already have them
         if ast['cuke_modeler_parsing_data'].dig(*traversal_path)
           bury(ast['cuke_modeler_parsing_data'], traversal_path, nil)
         end
@@ -347,11 +347,11 @@ module CukeModeler
     end
 
     def test_node?(ast_node)
-      ast_node[:scenario]
+      !ast_node[:scenario].nil?
     end
 
     def test_has_examples?(ast_node)
-      ast_node[:scenario][:examples]
+      !ast_node[:scenario][:examples].nil?
     end
 
     def test_uses_outline_keyword?(test_ast)

data/lib/cuke_modeler/containing.rb

@@ -5,10 +5,24 @@ module CukeModeler
 
   # NOT A PART OF THE PUBLIC API
   # A mix-in module containing methods used by models that contain other models.
-
   module Containing
 
+    include Enumerable
+
+    # Executes the given code block with this model and every model that is a child of this model. Exact
+    # order of model tree traversal is not guaranteed beyond the first model traversed, which will be the
+    # model that called this method. If no block is provided, an `Enumerator` is returned instead.
+    def each(&block)
+      if block
+        block.call(self)
+        children.each { |child| child.each(&block) }
+      else
+        to_enum(:each)
+      end
+    end
+
     # Executes the given code block with every model that is a child of this model.
+    # DEPRECATED: use `Enumerable` module methods instead
     def each_descendant(&block)
       children.each do |child_model|
         block.call(child_model)
@@ -17,6 +31,7 @@ module CukeModeler
     end
 
     # Executes the given code block with this model and every model that is a child of this model.
+    # DEPRECATED: use `Enumerable` module methods instead
     def each_model(&block)
       block.call(self)
 
@@ -135,6 +150,7 @@ module CukeModeler
       populate_keyword(rule_object, parsed_rule_data)
       populate_name(rule_object, parsed_rule_data)
       populate_description(rule_object, parsed_rule_data)
+      populate_tags(rule_object, parsed_rule_data)
       populate_children(rule_object, parsed_rule_data)
     end
 

data/lib/cuke_modeler/described.rb

@@ -2,7 +2,6 @@ module CukeModeler
 
   # NOT A PART OF THE PUBLIC API
   # A mix-in module containing methods used by models that represent an element that has a description.
-
   module Described
 
     # The description of the element

data/lib/cuke_modeler/models/background.rb

@@ -1,7 +1,6 @@
 module CukeModeler
 
   # A class modeling a feature's background.
-
   class Background < Model
 
     include Parsing

data/lib/cuke_modeler/models/cell.rb

@@ -1,7 +1,6 @@
 module CukeModeler
 
   # A class modeling a single cell of a row.
-
   class Cell < Model
 
     include Sourceable

data/lib/cuke_modeler/models/comment.rb

@@ -1,7 +1,6 @@
 module CukeModeler
 
   # A class modeling a comment in a feature file.
-
   class Comment < Model
 
     include Parsing

data/lib/cuke_modeler/models/directory.rb

@@ -1,7 +1,6 @@
 module CukeModeler
 
   # A class modeling a directory in a Cucumber suite.
-
   class Directory < Model
 
 
@@ -52,8 +51,8 @@ module CukeModeler
 
 
     def process_directory(directory_path)
-      directory_data = { 'path' => directory_path,
-                         'directories' => [],
+      directory_data = { 'path'          => directory_path,
+                         'directories'   => [],
                          'feature_files' => [] }
 
       entries = Dir.entries(directory_path)

data/lib/cuke_modeler/models/doc_string.rb

@@ -1,7 +1,6 @@
 module CukeModeler
 
   # A class modeling a step's doc string.
-
   class DocString < Model
 
     include Parsing

data/lib/cuke_modeler/models/example.rb

@@ -4,7 +4,6 @@
 module CukeModeler
 
   # A class modeling an example table of an outline.
-
   class Example < Model
 
     include Parsing

data/lib/cuke_modeler/models/feature.rb

@@ -1,7 +1,6 @@
 module CukeModeler
 
   # A class modeling a feature in a Cucumber suite.
-
   class Feature < Model
 
     include Parsed

data/lib/cuke_modeler/models/feature_file.rb

@@ -1,7 +1,6 @@
 module CukeModeler
 
   # A class modeling a feature file in a Cucumber suite.
-
   class FeatureFile < Model
 
     include Parsed

data/lib/cuke_modeler/models/model.rb

@@ -1,7 +1,6 @@
 module CukeModeler
 
   # A class modeling an element of a Cucumber suite.
-
   class Model
 
     include Nested
@@ -25,7 +24,6 @@ module CukeModeler
 
     # Returns the model objects that belong to this model.
     def children
-      # This should be overridden by a child class
       []
     end
 

data/lib/cuke_modeler/models/outline.rb

@@ -1,7 +1,6 @@
 module CukeModeler
 
   # A class modeling an individual outline in a Cucumber suite.
-
   class Outline < Model
 
     include Parsing

data/lib/cuke_modeler/models/row.rb

@@ -1,7 +1,6 @@
 module CukeModeler
 
   # A class modeling a single row of a step table or example table.
-
   class Row < Model
 
     include Sourceable
@@ -25,6 +24,11 @@ module CukeModeler
       populate_row(self, parsed_row_data)
     end
 
+    # Returns the model objects that belong to this model.
+    def children
+      @cells
+    end
+
     # Returns a string representation of this model. For a row model,
     # this will be Gherkin text that is equivalent to the row being modeled.
     def to_s

data/lib/cuke_modeler/models/rule.rb

@@ -1,13 +1,13 @@
 module CukeModeler
 
   # A class modeling a rule in a Cucumber suite.
-
   class Rule < Model
 
     include Parsing
     include Parsed
     include Named
     include Described
+    include Taggable
     include Sourceable
 
 
@@ -24,6 +24,7 @@ module CukeModeler
     # Creates a new Rule object and, if *source_text* is provided, populates the
     # object.
     def initialize(source_text = nil)
+      @tags = []
       @tests = []
 
       super(source_text)
@@ -53,17 +54,21 @@ module CukeModeler
 
     # Returns the model objects that belong to this model.
     def children
-      models = tests
+      models = tests + tags
       models << background if background
 
       models
     end
 
+    # Building strings just isn't pretty
+    # rubocop:disable Metrics/AbcSize
+
     # Returns a string representation of this model. For a rule model,
     # this will be Gherkin text that is equivalent to the rule being modeled.
     def to_s
       text = ''
 
+      text << "#{tag_output_string}\n" unless tags.empty?
       text << "#{@keyword}:#{name_output_string}"
       text << "\n#{description_output_string}" unless no_description_to_output?
       text << "\n\n#{background_output_string}" if background
@@ -71,6 +76,7 @@ module CukeModeler
 
       text
     end
+    # rubocop:enable Metrics/AbcSize
 
 
     private

data/lib/cuke_modeler/models/scenario.rb

@@ -1,7 +1,6 @@
 module CukeModeler
 
   # A class modeling an individual scenario of a Cucumber suite.
-
   class Scenario < Model
 
     include Parsing

data/lib/cuke_modeler/models/step.rb

@@ -1,7 +1,6 @@
 module CukeModeler
 
   # A class modeling a single step of a background, scenario, or outline.
-
   class Step < Model
 
     include Sourceable

data/lib/cuke_modeler/models/table.rb

@@ -1,7 +1,6 @@
 module CukeModeler
 
   # A class modeling a step's table.
-
   class Table < Model
 
     include Parsing

data/lib/cuke_modeler/models/tag.rb

@@ -1,7 +1,6 @@
 module CukeModeler
 
   # A class modeling a tag.
-
   class Tag < Model
 
     include Parsing

data/lib/cuke_modeler/named.rb

@@ -2,7 +2,6 @@ module CukeModeler
 
   # NOT A PART OF THE PUBLIC API
   # A mix-in module containing methods used by models that represent an element that has a name.
-
   module Named
 
     # The name of the element

data/lib/cuke_modeler/nested.rb

@@ -3,7 +3,6 @@ module CukeModeler
   # NOT A PART OF THE PUBLIC API
   # A mix-in module containing methods used by models that are nested inside
   # of other models.
-
   module Nested
 
     # The parent model that contains this model

data/lib/cuke_modeler/parsed.rb

@@ -2,7 +2,6 @@ module CukeModeler
 
   # NOT A PART OF THE PUBLIC API
   # A mix-in module containing methods used by models that are parsed from source text.
-
   module Parsed
 
     # The parsing data for this element that was generated by the parsing engine (i.e. the *gherkin* gem)

data/lib/cuke_modeler/parsing.rb

@@ -3,22 +3,13 @@
 require 'gherkin'
 
 
-# The *cucumber-gherkin* gem loads differently and has different grammar rules across major versions. Parsing
-# will be done with an 'adapter' appropriate to the version of the *cucumber-gherkin* gem that has been activated.
-
+# The *cucumber-gherkin* has different grammar rules across major versions. Parsing will be done with
+# an 'adapter' appropriate to the version of the *cucumber-gherkin* gem that has been activated.
 gherkin_version = Gem.loaded_specs['cucumber-gherkin'].version.version
 gherkin_major_version = gherkin_version.match(/^(\d+)\./)[1].to_i
+supported_gherkin_versions = (9..19)
 
-# Previous versions of the gem did not use the conventional entry point, so I'm leaving this here in case it
-# changes again
-# rubocop:disable Lint/EmptyWhen
-case gherkin_major_version
-  when 9, 10, 11, 12, 13, 14, 15, 16
-    # Currently nothing else to load beyond the entry point to the gem
-  else
-    raise("Unknown Gherkin version: '#{gherkin_version}'")
-end
-# rubocop:enable Lint/EmptyWhen
+raise("Unknown Gherkin version: '#{gherkin_version}'") unless supported_gherkin_versions.include?(gherkin_major_version)
 
 require "cuke_modeler/adapters/gherkin_#{gherkin_major_version}_adapter"
 
@@ -26,7 +17,6 @@ require "cuke_modeler/adapters/gherkin_#{gherkin_major_version}_adapter"
 module CukeModeler
 
   # A module providing source text parsing functionality.
-
   module Parsing
 
     class << self
@@ -71,7 +61,24 @@ module CukeModeler
       # inside of it, so I'm leaving this here in case it changes again
       # rubocop:disable Lint/DuplicateMethods
       case gherkin_major_version
-        when 13, 14, 15, 16
+        when 19
+          # TODO: make these methods private?
+          # NOT A PART OF THE PUBLIC API
+          # The method to use for parsing Gherkin text
+          def parsing_method(source_text, filename)
+            messages = Gherkin.from_source(filename,
+                                           source_text,
+                                           { include_gherkin_document: true })
+                              .to_a.map(&:to_hash)
+
+            error_message = messages.find { |message| message[:parseError] }
+            gherkin_ast_message = messages.find { |message| message[:gherkinDocument] }
+
+            raise error_message[:parseError][:message] if error_message
+
+            gherkin_ast_message[:gherkinDocument]
+          end
+        when 13, 14, 15, 16, 17, 18
           # TODO: make these methods private?
           # NOT A PART OF THE PUBLIC API
           # The method to use for parsing Gherkin text

data/lib/cuke_modeler/sourceable.rb

@@ -3,7 +3,6 @@ module CukeModeler
   # NOT A PART OF THE PUBLIC API
   # A mix-in module containing methods used by models that know from which line of
   # source code they originate.
-
   module Sourceable
 
     # The line number where the element began in the source code

data/lib/cuke_modeler/stepped.rb

@@ -2,7 +2,6 @@ module CukeModeler
 
   # NOT A PART OF THE PUBLIC API
   # A mix-in module containing methods used by models that represent an element that has steps.
-
   module Stepped
 
 

data/lib/cuke_modeler/taggable.rb

@@ -2,7 +2,6 @@ module CukeModeler
 
   # NOT A PART OF THE PUBLIC API
   # A mix-in module containing methods used by models that represent an element that can be tagged.
-
   module Taggable
 
     # The models for tags which are directly assigned to the element

data/lib/cuke_modeler/version.rb

@@ -1,4 +1,4 @@
 module CukeModeler
   # The gem version
-  VERSION = '3.5.0'.freeze
+  VERSION = '3.10.0'.freeze
 end

data/testing/cucumber/features/modeling/rule_modeling.feature

@@ -1,7 +1,8 @@
 Feature: Rule modeling
 
-Rule models Scenario portion of a feature. They expose several attributes of the rule that they represent, as well as
-containing models for any background, scenarios, or outlines that are present in that rule.
+Rule models represent a Rule portion of a feature. They expose several attributes of the rule that they
+represent, as well as containing models for any background, scenarios, outlines, and tags that are present
+in that rule.
 
 
   Background:
@@ -86,6 +87,47 @@ containing models for any background, scenarios, or outlines that are present in
     Then the model returns models for the following outlines:
       | Outline 1 |
 
+  @gherkin_min_version_18
+  Scenario: Modeling a rules's tags
+    Given the following gherkin:
+      """
+      @feature_tag
+      Feature:
+
+        @rule_tag_1
+        @rule_tag_2
+        Rule:
+      """
+    And a feature model based on that gherkin
+      """
+        @model = CukeModeler::Feature.new(<source_text>)
+      """
+    And the rule model of that feature model
+      """
+        @model = @model.rules.first
+      """
+    When the rules's tags are requested
+      """
+        @model.tags
+      """
+    Then the model returns models for the following tags:
+      | @rule_tag_1 |
+      | @rule_tag_2 |
+    When the rule's inherited tags are requested
+      """
+        @model.applied_tags
+      """
+    Then the model returns models for the following tags:
+      | @feature_tag |
+    When all of the rule's tags are requested
+      """
+        @model.all_tags
+      """
+    Then the model returns models for the following tags:
+      | @feature_tag |
+      | @rule_tag_1  |
+      | @rule_tag_2  |
+
   Scenario: Modeling a rule's source line
     Given the following gherkin:
       """

data/testing/cucumber/features/modeling/rule_output.feature

@@ -4,9 +4,12 @@ Feature: Rule output
   input for the same kind of model.
 
 
+  @gherkin_min_version_18
   Scenario: Outputting a rule model
     Given the following gherkin:
       """
+      @tag1@tag2
+      @tag3
       Rule: A rule with everything it could have
       Including a description
       and then some.
@@ -54,6 +57,7 @@ Feature: Rule output
       """
     Then the following text is provided:
       """
+      @tag1 @tag2 @tag3
       Rule: A rule with everything it could have
 
       Including a description

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cuke_modeler
 version: !ruby/object:Gem::Version
-  version: 3.5.0
+  version: 3.10.0
 platform: ruby
 authors:
 - Eric Kessler
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-12-19 00:00:00.000000000 Z
+date: 2021-05-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cucumber-gherkin
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "<"
       - !ruby/object:Gem::Version
-        version: '17.0'
+        version: '20.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "<"
       - !ruby/object:Gem::Version
-        version: '17.0'
+        version: '20.0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -38,6 +38,20 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: childprocess
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5.0'
 - !ruby/object:Gem::Dependency
   name: coveralls
   requirement: !ruby/object:Gem::Requirement
@@ -53,39 +67,39 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 1.0.0
 - !ruby/object:Gem::Dependency
-  name: cucumber
+  name: ffi
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 4.0.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: 6.0.0
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 4.0.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: 6.0.0
+        version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: racatt
+  name: cucumber
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 4.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 7.0.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 4.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 7.0.0
 - !ruby/object:Gem::Dependency
   name: rainbow
   requirement: !ruby/object:Gem::Requirement
@@ -170,13 +184,27 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: 4.0.0
-description: "This gem facilitates modeling a test suite that is written in Gherkin
-  (e.g. Cucumber, \nSpecFlow, Lettuce, etc.). It does this by providing an abstraction
-  layer on top of the \nAbstract Syntax Tree that the 'cucumber-gherkin' gem generates
-  when parsing features, \nas well as providing models for feature files and directories
-  in order to be able to \nhave a fully traversable model tree of a test suite's structure.
-  These models can then \nbe analyzed or manipulated more easily than the underlying
-  AST layer."
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: This gem facilitates modeling a test suite that is written in Gherkin
+  (e.g. Cucumber, SpecFlow, Lettuce, etc.). It does this by providing an abstraction
+  layer on top of the Abstract Syntax Tree that the 'cucumber-gherkin' gem generates
+  when parsing features, as well as providing models for feature files and directories
+  in order to be able to have a fully traversable model tree of a test suite's structure.
+  These models can then be analyzed or manipulated more easily than the underlying
+  AST layer.
 email:
 - morrow748@gmail.com
 executables: []
@@ -195,6 +223,9 @@ files:
 - lib/cuke_modeler/adapters/gherkin_14_adapter.rb
 - lib/cuke_modeler/adapters/gherkin_15_adapter.rb
 - lib/cuke_modeler/adapters/gherkin_16_adapter.rb
+- lib/cuke_modeler/adapters/gherkin_17_adapter.rb
+- lib/cuke_modeler/adapters/gherkin_18_adapter.rb
+- lib/cuke_modeler/adapters/gherkin_19_adapter.rb
 - lib/cuke_modeler/adapters/gherkin_9_adapter.rb
 - lib/cuke_modeler/containing.rb
 - lib/cuke_modeler/described.rb
@@ -259,8 +290,13 @@ files:
 homepage: https://github.com/enkessler/cuke_modeler
 licenses:
 - MIT
-metadata: {}
-post_install_message: 
+metadata:
+  bug_tracker_uri: https://github.com/enkessler/cuke_modeler/issues
+  changelog_uri: https://github.com/enkessler/cuke_modeler/blob/master/CHANGELOG.md
+  documentation_uri: https://www.rubydoc.info/gems/cuke_modeler
+  homepage_uri: https://github.com/enkessler/cuke_modeler
+  source_code_uri: https://github.com/enkessler/cuke_modeler
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -271,16 +307,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '2.3'
   - - "<"
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '4.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
-signing_key: 
+rubygems_version: 3.2.3
+signing_key:
 specification_version: 4
 summary: A gem providing functionality to model Gherkin based test suites.
 test_files: []