gherkin_system 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f34062309b4b10e565f452e4057b7d92c061685cfd678be14ece67bf45e2cda5
-  data.tar.gz: c37ba7f15a150aaa4915cbdef0bedc7daba986253c5a9884eaad19fa90aed550
+  metadata.gz: fe2f737790d08aa61ad7a5ae85b770725144c2c1fd9f0beed703742097e06efb
+  data.tar.gz: 0ae13e39a441aaec9dd0aa3d23eef69799881fa45f423da1327f428095a1dd1c
 SHA512:
-  metadata.gz: 703ebc78c70e5d9dc9c660a49277222e7969d0f5e42924f320f80967583f733cc15676565a6ab6d1d58634b639bb4571f4870d8bfe7f3582954be9c9a6a01e73
-  data.tar.gz: dfb3f04e649d77afd862551b3fa4147addaa43ad3bc2cb9eb3cdc3498e39f916855c9c8a09da3bf01fe86d5d5c62db234ded563e1b69afd5f1ac4e8b00bf04af
+  metadata.gz: 482ec736ed840dc67fde03134e8c05bccf5d120b27c1585712c62d81f222d21f5f6f452d215e91363af2d31b028e2da17dee4212c9071629e8d95cbb8d7a11cf
+  data.tar.gz: d5db2a103d97563f0a65e06f76e4be9312ea38822440c34e6b3b226dbaf09b2e709d2739563cd862aad77f3842fc99030ca436792186356d4998639cc9ae5261

data/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-10-04
+
+### Added
+
+- `rails g gherkin` runs the install generator, matching `rails g gherkin:install`
+- README and application skill document how to wait for navigation before URL assertions in step definitions
+
+## [0.3.0] - 2026-10-04
+
+### Changed
+
+- Generator commands use `gherkin:install`, `gherkin:feature NAME`, and `gherkin:steps NAME`, matching the existing `rails gherkin` commands
+- README and application skill use the shorter generator namespace
+- Existing `gherkin_system:` generator commands remain available for compatibility
+
 ## [0.2.0] - 2026-10-04
 
 ### Changed

data/README.md

@@ -15,9 +15,9 @@ gem "gherkin_system"
 
 ```sh
 bundle install
-bin/rails g gherkin_system:install
-bin/rails g gherkin_system:feature checkout
-bin/rails g gherkin_system:steps checkout
+bin/rails g gherkin:install
+bin/rails g gherkin:feature checkout
+bin/rails g gherkin:steps checkout
 ```
 
 `install` creates `test/system/gherkin_test.rb`, `features/`, and `test/support/gherkin/`. `feature` and `steps` add a `.feature` file and a steps module; wire the module into the loader with `require_relative` and `config.include_steps`.
@@ -98,6 +98,25 @@ end
 
 `Given`, `When`, `Then`, `And`, and `But` share one registry. Blocks run with `instance_exec` on the system test, so instance variables set in one step are visible in the next.
 
+## Wait for navigation
+
+After a step triggers navigation, assert visible page content or use a Capybara waiting assertion. Do not compare `current_path` directly. A direct comparison does not wait for navigation.
+
+```ruby
+When("I open an order") do
+  click_on "Order details"
+  assert_current_path(/\/orders\/\d+/, url: true)
+end
+
+When("I stay on the orders page") do
+  click_on "Refresh orders"
+  assert_selector "h1", text: "Orders"
+  refute_current_path(/\/orders\/\d+\/details/)
+end
+```
+
+For a negative URL check, first assert content that only the destination page shows. This prevents a check from passing before the browser navigates.
+
 ## Hooks
 
 ```ruby

data/lib/generators/gherkin/feature/feature_generator.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module Gherkin
+  module Generators
+    # Creates a Gherkin feature under features.
+    class FeatureGenerator < Rails::Generators::NamedBase
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Creates a Gherkin feature file under features"
+
+      def create_feature
+        template "feature.feature.tt", File.join("features", "#{file_path}.feature")
+      end
+    end
+  end
+end

data/lib/generators/gherkin/gherkin_generator.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "generators/gherkin/install/install_generator"
+
+module Gherkin
+  module Generators
+    # Runs the install generator for the bare gherkin command.
+    class GherkinGenerator < InstallGenerator
+      source_root InstallGenerator.source_root
+    end
+  end
+end

data/lib/generators/gherkin/install/install_generator.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module Gherkin
+  module Generators
+    # Scaffolds the loader, feature directory, and steps support directory.
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Creates a Gherkin loader, features, and test/support/gherkin"
+
+      def create_loader
+        template "gherkin_test.rb", "test/system/gherkin_test.rb"
+      end
+
+      def create_features_directory
+        empty_directory "features"
+        create_file "features/.keep", ""
+      end
+
+      def create_steps_directory
+        empty_directory "test/support/gherkin"
+        create_file "test/support/gherkin/.keep", ""
+      end
+    end
+  end
+end

data/lib/generators/gherkin/steps/steps_generator.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module Gherkin
+  module Generators
+    # Creates a step definition module under test/support/gherkin.
+    class StepsGenerator < Rails::Generators::NamedBase
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Creates a Gherkin steps module under test/support/gherkin"
+
+      def create_steps
+        template "steps.rb.tt", File.join("test/support/gherkin", "#{file_path}_steps.rb")
+      end
+
+      def remind_loader_wiring
+        say "Remember to require and include #{steps_module_name} in test/system/gherkin_test.rb", :green
+      end
+
+      private
+
+      def steps_module_name
+        "#{class_name}Steps"
+      end
+    end
+  end
+end

data/lib/generators/gherkin_system/feature/feature_generator.rb

@@ -1,18 +1,12 @@
 # frozen_string_literal: true
 
-require "rails/generators"
+require "generators/gherkin/feature/feature_generator"
 
 module GherkinSystem
   module Generators
-    # Creates a Gherkin feature under features.
-    class FeatureGenerator < Rails::Generators::NamedBase
-      source_root File.expand_path("templates", __dir__)
-
-      desc "Creates a Gherkin feature file under features"
-
-      def create_feature
-        template "feature.feature.tt", File.join("features", "#{file_path}.feature")
-      end
+    # Keeps the original generator command available.
+    class FeatureGenerator < Gherkin::Generators::FeatureGenerator
+      source_root Gherkin::Generators::FeatureGenerator.source_root
     end
   end
 end

data/lib/generators/gherkin_system/install/install_generator.rb

@@ -1,28 +1,12 @@
 # frozen_string_literal: true
 
-require "rails/generators"
+require "generators/gherkin/install/install_generator"
 
 module GherkinSystem
   module Generators
-    # Scaffolds the loader, feature directory, and steps support directory.
-    class InstallGenerator < Rails::Generators::Base
-      source_root File.expand_path("templates", __dir__)
-
-      desc "Creates gherkin_system loader, features, and test/support/gherkin"
-
-      def create_loader
-        template "gherkin_test.rb", "test/system/gherkin_test.rb"
-      end
-
-      def create_features_directory
-        empty_directory "features"
-        create_file "features/.keep", ""
-      end
-
-      def create_steps_directory
-        empty_directory "test/support/gherkin"
-        create_file "test/support/gherkin/.keep", ""
-      end
+    # Keeps the original generator command available.
+    class InstallGenerator < Gherkin::Generators::InstallGenerator
+      source_root Gherkin::Generators::InstallGenerator.source_root
     end
   end
 end

data/lib/generators/gherkin_system/steps/steps_generator.rb

@@ -1,28 +1,12 @@
 # frozen_string_literal: true
 
-require "rails/generators"
+require "generators/gherkin/steps/steps_generator"
 
 module GherkinSystem
   module Generators
-    # Creates a step definition module under test/support/gherkin.
-    class StepsGenerator < Rails::Generators::NamedBase
-      source_root File.expand_path("templates", __dir__)
-
-      desc "Creates a gherkin_system steps module under test/support/gherkin"
-
-      def create_steps
-        template "steps.rb.tt", File.join("test/support/gherkin", "#{file_path}_steps.rb")
-      end
-
-      def remind_loader_wiring
-        say "Remember to require and include #{steps_module_name} in test/system/gherkin_test.rb", :green
-      end
-
-      private
-
-      def steps_module_name
-        "#{class_name}Steps"
-      end
+    # Keeps the original generator command available.
+    class StepsGenerator < Gherkin::Generators::StepsGenerator
+      source_root Gherkin::Generators::StepsGenerator.source_root
     end
   end
 end

data/lib/gherkin_system/version.rb

@@ -2,5 +2,5 @@
 
 module GherkinSystem
   # Gem version.
-  VERSION = "0.2.0"
+  VERSION = "0.4.0"
 end

data/skills/gherkin-system/SKILL.md

@@ -14,7 +14,7 @@ Do not add cucumber-rails, a Cucumber World, or a second test runner. Do not use
 
 ## Add a scenario
 
-1. Scaffold with `bin/rails g gherkin_system:feature NAME` and `bin/rails g gherkin_system:steps NAME` (or write the files by hand under `features/**/*.feature` and `test/support/gherkin/*_steps.rb`).
+1. Scaffold with `bin/rails g gherkin:feature NAME` and `bin/rails g gherkin:steps NAME` (or write the files by hand under `features/**/*.feature` and `test/support/gherkin/*_steps.rb`).
 2. Require the steps file from `test/system/gherkin_test.rb` before `GherkinSystem.load!`.
 3. Run `bin/rails gherkin:check`.
 4. Run the scenario with `bin/rails gherkin path/to/file.feature:LINE`.
@@ -22,7 +22,7 @@ Do not add cucumber-rails, a Cucumber World, or a second test runner. Do not use
 Create the loader once if it is missing:
 
 ```sh
-bin/rails g gherkin_system:install
+bin/rails g gherkin:install
 ```
 
 Then require step modules and register them before `load!`:
@@ -87,6 +87,25 @@ end
 - Prefer Cucumber Expressions (`{string}`, `{int}`). Use a regex only to match an existing definition.
 - Data tables arrive as an object with `#hashes` (string keys) and `#raw`. Doc strings arrive as the content string.
 
+## Wait for navigation
+
+After a step triggers navigation, assert visible page content or use a Capybara waiting assertion. Do not compare `current_path` directly. A direct comparison does not wait for navigation.
+
+```ruby
+When("I open an order") do
+  click_on "Order details"
+  assert_current_path(/\/orders\/\d+/, url: true)
+end
+
+When("I stay on the orders page") do
+  click_on "Refresh orders"
+  assert_selector "h1", text: "Orders"
+  refute_current_path(/\/orders\/\d+\/details/)
+end
+```
+
+For a negative URL check, first assert content that only the destination page shows. This prevents a check from passing before the browser navigates.
+
 ## Hooks
 
 ```ruby

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gherkin_system
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - David Paluy
@@ -98,12 +98,16 @@ files:
 - LICENSE
 - LICENSE.txt
 - README.md
+- lib/generators/gherkin/feature/feature_generator.rb
+- lib/generators/gherkin/feature/templates/feature.feature.tt
+- lib/generators/gherkin/gherkin_generator.rb
+- lib/generators/gherkin/install/install_generator.rb
+- lib/generators/gherkin/install/templates/gherkin_test.rb
+- lib/generators/gherkin/steps/steps_generator.rb
+- lib/generators/gherkin/steps/templates/steps.rb.tt
 - lib/generators/gherkin_system/feature/feature_generator.rb
-- lib/generators/gherkin_system/feature/templates/feature.feature.tt
 - lib/generators/gherkin_system/install/install_generator.rb
-- lib/generators/gherkin_system/install/templates/gherkin_test.rb
 - lib/generators/gherkin_system/steps/steps_generator.rb
-- lib/generators/gherkin_system/steps/templates/steps.rb.tt
 - lib/gherkin_system.rb
 - lib/gherkin_system/checker.rb
 - lib/gherkin_system/cli.rb