cql 1.2.1 → 1.3.0

data/testing/cucumber/features/dsl.feature

@@ -0,0 +1,77 @@
+Feature: DSL
+
+  The cql gem uses a DSL to specify queries on a repository object that holds the models which represent a Cucumber test suite. The DSL can query for any attribute that is available on the underlying models.
+
+    Sample usage:
+      cql_repo.query do
+        select name, source_line
+        from features
+      end
+
+  Query results are returned as a list of attribute mappings for all of the models found in the repository. The sample query above might return:
+
+    [{'name' => 'Feature 1', 'source_line' => 1},
+    {'name' => 'Feature 2', 'source_line' => 3},
+    {'name' => 'Feature 3', 'source_line' => 10}]
+
+
+  Background: A sample Cucumber suite
+    Given a directory "test_directory"
+    And a file "test_directory/test_file_1.feature":
+      """
+      Feature: A test feature
+
+        Scenario: Test 1
+          * some steps
+
+        @special_tag
+        Scenario: Test 2
+          * some other steps
+
+        Scenario Outline: Test 3
+          * some steps
+        Examples: First examples
+          | param |
+          | value |
+        Examples: Second examples
+          | param |
+          | value |
+      """
+    And a repository is made from "test_directory"
+
+  Scenario: Automatic string conversion
+
+  Although most times it is unnecessary, using full strings in a query can remove syntactical ambiguity.
+
+    When the following query is executed:
+      """
+      select name
+      from scenarios
+      """
+    Then the result is the same as the result of the following query:
+      """
+      select 'name'
+      from 'scenarios'
+      """
+
+
+# Commented out so that they aren't picked up by Relish
+#
+#  @wip
+#  Scenario: Use 'order_by' to sort the results
+#
+#  # 'and' is a keyword. Some other kind of repeater word would be needed
+#  @wip
+#  Scenario: 'And' can be used instead of repeating the previous keyword
+#    When the following query is executed:
+#      """
+#      select 'name'
+#      and    'source_line'
+#      from CukeModeler::Scenario
+#      and  CukeModeler::Outline
+#      """
+#    Then the following values are returned:
+#      | name   | source_line |
+#      | Test 1 | 3           |
+#      | Test 2 | 6           |
+#      | Test 3 | 9           |

data/testing/cucumber/features/model_querying.feature

@@ -0,0 +1,18 @@
+Feature: Models can be queried directly
+
+  Note: This feature is only available with newer versions of the 'cuke_modeler' library.
+
+  @cuke_modeler_1x
+  Scenario: Querying a model
+    Given the models provided by CukeModeler
+    Then  all of them can be queried
+      """
+        model = <model_class>.new
+
+        model.query do
+
+          select
+          from :all
+
+        end
+      """

data/testing/cucumber/features/repository.feature

@@ -0,0 +1,23 @@
+Feature: Repository
+
+  All queries are performed against a repository object. A repository is simply a collection of models that represent a Cucumber test suite. Commonly, a repository is created based on a file path that is the location of such a test suite. However, repositories can also be created using any model as their starting point.
+
+
+  Scenario: Using a file path to create a repository
+    Given a directory "path/to/test_directory"
+    Then the following code executes without error:
+      """
+      CQL::Repository.new("path/to/test_directory")
+      """
+
+  Scenario: Using a model to create a repository
+
+  Note: Non-directory models can also be used
+
+    Given a directory "path/to/test_directory"
+    Then the following code executes without error:
+      """
+      directory_model = CukeModeler::Directory.new("path/to/test_directory")
+
+      CQL::Repository.new(directory_model)
+      """

data/testing/cucumber/step_definitions/query_steps.rb

@@ -0,0 +1,7 @@
+When(/^the following query is executed:$/) do |query_text|
+  command = "@repository.query do
+               #{query_text}
+             end"
+
+  @query_results = eval(command)
+end

data/testing/cucumber/step_definitions/setup_steps.rb

@@ -0,0 +1,25 @@
+Given(/^a directory "([^"]*)"$/) do |partial_directory_path|
+  directory_path = partial_directory_path.include?('path/to') ? process_path(partial_directory_path) : "#{@default_file_directory}/#{partial_directory_path}"
+
+  FileUtils.mkpath(directory_path) unless File.exists?(directory_path)
+end
+
+And(/^a file "([^"]*)":$/) do |partial_file_path, file_text|
+  File.open("#{@default_file_directory}/#{partial_file_path}", 'w') { |file| file.write file_text }
+end
+
+And(/^a repository is made from "([^"]*)"$/) do |partial_path|
+  repo_path = "#{@default_file_directory}/#{partial_path}"
+
+  @repository = CQL::Repository.new(repo_path)
+end
+
+Given(/^the models provided by CukeModeler$/) do
+  @available_model_classes = Array.new.tap do |classes|
+    CukeModeler.constants.each do |constant|
+      if CukeModeler.const_get(constant).is_a?(Class)
+        classes << CukeModeler.const_get(constant) if CukeModeler.const_get(constant).ancestors.include?(CukeModeler::Model)
+      end
+    end
+  end
+end

data/testing/cucumber/step_definitions/verification_steps.rb

@@ -0,0 +1,78 @@
+Then(/^the following values are returned:$/) do |values|
+  expected_results = values.hashes
+  expected_results.each { |result| result['source_line'] = result['source_line'].to_i if result['source_line'] }
+  expected_results.each { |result| result['scenario_line'] = result['scenario_line'].to_i if result['scenario_line'] }
+  expected_results.each { |result| result['tags'] = eval(result['tags']) if result['tags'] }
+  expected_results.each { |result| result['scenario_tags'] = eval(result['scenario_tags']) if result['scenario_tags'] }
+
+  expected_results.each do |result|
+    result.each_pair { |key, value| result[key] = value.sub('path/to', @default_file_directory) if value =~ /path\/to/ }
+  end
+
+  expect(@query_results).to match_array(expected_results)
+end
+
+# Then(/^all of them can be queried for additional information$/) do
+#
+#   expect(@cm_models).to_not be_empty
+#
+#   @cm_models.each do |model|
+#     raise("Expected #{model} to define :query") unless model.method_defined?(:query)
+#   end
+#
+# end
+
+Then(/^the models for the following items are returned:$/) do |item_names|
+  expected_results = item_names.raw.flatten
+
+  expect(@query_results.collect { |result| result[:self].name }).to match_array(expected_results)
+end
+
+Then(/^the result is the same as the result of the following query:$/) do |query_text|
+  command = "@repository.query do
+               #{query_text}
+             end"
+
+  baseline_results = eval(command)
+
+  expect(@query_results).to eq(baseline_results)
+end
+
+Then(/^the following code executes without error:$/) do |code_text|
+  code_text = process_path(code_text)
+
+  expect { eval(code_text) }.to_not raise_error
+end
+
+Then(/^all of them can be queried$/) do |code_text|
+  @available_model_classes.each do |clazz|
+    code_text.gsub!('<model_class>', clazz.to_s)
+
+    expect(clazz.new).to respond_to(:query)
+
+    # Make sure that the example code is valid
+    expect { eval(code_text) }.to_not raise_error
+  end
+end
+
+Then(/^all models are queried from$/) do
+  # Just making sure that multiple model results are returned
+  expect(@query_results.count).to be > 1
+
+  @query_results.each do |result|
+    class_name = result[:model].class.name.split('::').last
+
+    expect(CukeModeler.const_defined?(class_name)).to be true
+  end
+end
+
+And(/^equivalent results are returned for the following query:$/) do |query_text|
+  command = "@repository.query do
+               #{query_text}
+             end"
+
+  alternate_results = eval(command)
+
+  # Only checking the values of the results because they will have different :model/:self keys
+  expect(alternate_results.collect { |result| result.values }).to eq(@query_results.collect { |result| result.values })
+end

data/testing/cucumber/support/env.rb

@@ -0,0 +1,24 @@
+unless RUBY_VERSION.to_s < '1.9.0'
+  require 'simplecov'
+  SimpleCov.command_name('cql-cucumber')
+end
+
+
+require 'cql'
+require 'cql/model_dsl'
+
+
+Before do
+  @default_file_directory = "#{File.dirname(__FILE__)}/../temp_files"
+
+  FileUtils.mkdir(@default_file_directory)
+end
+
+After do
+  FileUtils.remove_dir(@default_file_directory, true)
+end
+
+
+def process_path(path)
+  path.sub('path/to', @default_file_directory)
+end

data/testing/cucumber/support/transforms.rb

@@ -0,0 +1,3 @@
+Transform /^(-?\d+)$/ do |number|
+  number.to_i
+end

data/testing/fixtures/features/combined/a/f1_4_scenarios_5_so.feature

@@ -0,0 +1,59 @@
+Feature: f1_4_scenarios_5_so
+  (4 scenarios, 5 scenario outlines)
+
+  Scenario: A cat in a hat
+    Given A cat in a hat
+    And walked across the road
+    Then he was on the other side
+
+  Scenario: The lonely giant
+    Given he was very big
+    And he was an orphan
+    And no one wanted to play with him
+    And he couldn't fit into normal sized building
+    Then he was all alone
+
+  Scenario: The king of kings
+    Given king "George"
+    And king "Bruce"
+    Then George is the king of kings
+
+  Scenario: A deer
+    * A deer
+    * A female deer
+    * Ray, a drop of golden sun
+
+  Scenario Outline: f1_so1
+    Given blah <e>
+
+  Examples:
+    | e |
+    | r |
+
+  Scenario Outline: f1_so2
+    Given blah <e>
+
+  Examples:
+    | e |
+    | r |
+
+  Scenario Outline: f1_so3
+    Given blah <e>
+
+  Examples:
+    | e |
+    | r |
+
+  Scenario Outline: f1_so4
+    Given blah <e>
+
+  Examples:
+    | e |
+    | r |
+
+  Scenario Outline: f1_so5
+    Given blah <e>
+
+  Examples:
+    | e |
+    | r |

data/testing/fixtures/features/combined/a/f2_7_scenarios_2_so.feature

@@ -0,0 +1,43 @@
+Feature: f2_7_scenarios_2_so
+
+  Scenario: f2_scen1
+    Given Something
+    Then something else
+
+  Scenario: f2_scen2
+    Given Something
+    Then something else
+
+  Scenario: f2_scen3
+    Given Something
+    Then something else
+
+  Scenario: f2_scen4
+    Given Something
+    Then something else
+
+  Scenario: f2_scen5
+    Given Something
+    Then something else
+
+  Scenario: f2_scen6
+    Given Something
+    Then something else
+
+  Scenario: f2_scen7
+    Given Something
+    Then something else
+
+  Scenario Outline: f2_so1
+    Given blah <e>
+
+  Examples:
+    | e |
+    | r |
+
+  Scenario Outline: f2_so2
+    Given blah <e>
+
+  Examples:
+    | e |
+    | r |

data/testing/fixtures/features/combined/a/f3_2_scenarios_3_so.feature

@@ -0,0 +1,30 @@
+Feature: f3_2_scenarios_3_so
+
+  Scenario: f3_scen1
+    Given Something
+    Then something else
+
+  Scenario: f3_scen2
+    Given Something
+    Then something else
+
+  Scenario Outline: f3_so1
+    Given blah <e>
+
+  Examples:
+    | e |
+    | r |
+
+  Scenario Outline: f3_so2
+    Given blah <e>
+
+  Examples:
+    | e |
+    | r |
+
+  Scenario Outline: f3_so3
+    Given blah <e>
+
+  Examples:
+    | e |
+    | r |

data/testing/fixtures/features/combined/b/f1_1_tag.feature

@@ -0,0 +1,6 @@
+@one
+Feature: f1_1_tag
+
+  Scenario: f1_scen1
+    Given Something
+    Then something else

data/testing/fixtures/features/combined/b/f2_2_tags.feature

@@ -0,0 +1,6 @@
+@one @two
+Feature: f2_2_tags
+
+  Scenario: f2_scen1
+    Given Something
+    Then something else

data/testing/fixtures/features/combined/b/f3_3_tags.feature

@@ -0,0 +1,6 @@
+@one @two @three
+Feature: f3_3_tags
+
+  Scenario: f3_scen1
+    Given Something
+    Then something else

data/testing/fixtures/features/examples/basic/test_with_scenarios.feature

@@ -0,0 +1,15 @@
+Feature: Test Feature
+
+  Scenario Outline: An Outline
+    Given something happend
+    Then I expect something else
+  Examples:
+    | var_a | var_b |
+    | 1     | a     |
+    | 2     | b     |
+    | 3     | c     |
+    | 4     | d     |
+
+  Scenario: A Scenario
+    Given something happend
+    Then I expect something else

data/testing/fixtures/features/examples/filters/tag_count/simple.feature

@@ -0,0 +1,21 @@
+Feature: Simple
+
+  Scenario Outline:
+    Given Something
+      | a | a |
+      | s | a |
+      | s | s |
+    Then something else
+  @one
+    Examples: 1 tag
+      | param |
+
+  Scenario Outline:
+    Given Something
+      | a | a |
+      | s | a |
+      | s | s |
+    Then something else
+  @one @two
+    Examples: 2 tags
+      | param |