rake_options 0.1.0

data/spec/rake_options/template_engine_spec.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+require "rake_options/template_engine"
+
+RSpec.describe RakeOptions::TemplateEngine do
+  describe ".parse_template" do
+    context "with single variable" do
+      it "parses template with one variable" do
+        result = described_class.parse_template("--with-mysql-lib $path")
+        
+        expect(result[:template]).to eq("--with-mysql-lib $path")
+        expect(result[:variables]).to eq(["path"])
+        expect(result[:pattern]).to be_a(Regexp)
+      end
+    end
+
+    context "with multiple variables" do
+      it "parses template with multiple variables" do
+        result = described_class.parse_template("--config $file --env $environment")
+        
+        expect(result[:template]).to eq("--config $file --env $environment")
+        expect(result[:variables]).to eq(["file", "environment"])
+        expect(result[:pattern]).to be_a(Regexp)
+      end
+    end
+
+    context "with no variables" do
+      it "parses template without variables" do
+        result = described_class.parse_template("--enable-feature")
+        
+        expect(result[:template]).to eq("--enable-feature")
+        expect(result[:variables]).to eq([])
+        expect(result[:pattern]).to be_a(Regexp)
+      end
+    end
+  end
+
+  describe ".extract_values" do
+    context "with single variable template" do
+      let(:parsed_template) { described_class.parse_template("--with-mysql-lib $path") }
+
+      it "extracts value from matching input" do
+        input = ["--with-mysql-lib", "/usr/local/mysql/lib"]
+        result = described_class.extract_values(input, parsed_template)
+        
+        expect(result).to eq({ "path" => "/usr/local/mysql/lib" })
+      end
+
+      it "extracts quoted value with spaces" do
+        input = ["--with-mysql-lib", '"path with spaces"']
+        result = described_class.extract_values(input, parsed_template)
+        
+        expect(result["path"]).to include("path")
+      end
+
+      it "returns nil for non-matching input" do
+        input = ["--different-flag", "value"]
+        result = described_class.extract_values(input, parsed_template)
+        
+        expect(result).to be_nil
+      end
+    end
+
+    context "with multiple variable template" do
+      let(:parsed_template) { described_class.parse_template("--config $file --env $environment") }
+
+      it "extracts multiple values from matching input" do
+        input = ["--config", "database.yml", "--env", "production"]
+        result = described_class.extract_values(input, parsed_template)
+        
+        expect(result["file"]).to eq("database.yml")
+        expect(result["environment"]).to eq("production")
+      end
+    end
+  end
+
+  describe ".identify_variables" do
+    it "finds single variable" do
+      variables = described_class.send(:identify_variables, "--flag $var")
+      expect(variables).to eq(["var"])
+    end
+
+    it "finds multiple variables" do
+      variables = described_class.send(:identify_variables, "--flag $var1 --other $var2")
+      expect(variables).to eq(["var1", "var2"])
+    end
+
+    it "returns empty array when no variables" do
+      variables = described_class.send(:identify_variables, "--flag value")
+      expect(variables).to eq([])
+    end
+  end
+
+  describe ".build_pattern" do
+    it "creates pattern for single variable" do
+      variables = ["path"]
+      pattern = described_class.send(:build_pattern, "--with-mysql-lib $path", variables)
+      
+      expect(pattern).to be_a(Regexp)
+      expect("--with-mysql-lib /usr/local/lib").to match(pattern)
+    end
+
+    it "creates pattern for multiple variables" do
+      variables = ["file", "env"]
+      pattern = described_class.send(:build_pattern, "--config $file --env $env", variables)
+      
+      expect(pattern).to be_a(Regexp)
+      expect("--config db.yml --env prod").to match(pattern)
+    end
+  end
+end

data/spec/rake_options_spec.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+RSpec.describe RakeOptions do
+  let(:config) do
+    {
+      "with-mysql-lib" => "--with-mysql-lib $path",
+      "enable-feature" => "--enable-feature $name"
+    }
+  end
+
+  describe ".command_line_args" do
+    context "with CLI notation" do
+      it "parses CLI-style arguments" do
+        stub_const("ARGV", ["--with-mysql-lib", "/usr/local/lib"])
+        result = described_class.command_line_args(config, notation: :cli)
+        
+        expect(result["with-mysql-lib"]).to eq("/usr/local/lib")
+      end
+
+      it "supports symbol key access" do
+        stub_const("ARGV", ["--with-mysql-lib", "/usr/local/lib"])
+        result = described_class.command_line_args(config, notation: :cli)
+        
+        expect(result[:with_mysql_lib]).to eq("/usr/local/lib")
+      end
+    end
+
+    context "with bracket notation" do
+      it "parses bracket-style arguments" do
+        stub_const("ARGV", ["[with-mysql-lib=/usr/local/lib]"])
+        result = described_class.command_line_args(config, notation: :bracket)
+        
+        expect(result["with-mysql-lib"]).to eq("/usr/local/lib")
+      end
+    end
+
+    context "with default notation" do
+      it "defaults to CLI notation" do
+        stub_const("ARGV", ["--with-mysql-lib", "/usr/local/lib"])
+        result = described_class.command_line_args(config)
+        
+        expect(result["with-mysql-lib"]).to eq("/usr/local/lib")
+      end
+    end
+
+    context "with --help flag" do
+      it "triggers help display and exits" do
+        stub_const("ARGV", ["--help"])
+        
+        expect { described_class.command_line_args(config) }
+          .to output(/Available Options/).to_stdout
+          .and raise_error(SystemExit)
+      end
+    end
+
+    context "return value" do
+      it "returns HashWithIndifferentAccess" do
+        stub_const("ARGV", ["--with-mysql-lib", "/usr/local/lib"])
+        result = described_class.command_line_args(config)
+        
+        expect(result).to be_a(RakeOptions::HashWithIndifferentAccess)
+      end
+    end
+  end
+
+  describe ".initialize_readme" do
+    it "stores readme content" do
+      readme = "Custom help text"
+      described_class.initialize_readme(readme)
+      
+      expect(described_class.readme_content).to eq(readme)
+    end
+
+    it "uses stored readme in help display" do
+      readme = "My Custom Help"
+      described_class.initialize_readme(readme)
+      stub_const("ARGV", ["--help"])
+      
+      expect { described_class.command_line_args(config) }
+        .to output(/My Custom Help/).to_stdout
+        .and raise_error(SystemExit)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require "rake_options"
+
+RSpec.configure do |config|
+  # Enable flags like --only-failures and --next-failure
+  config.example_status_persistence_file_path = ".rspec_status"
+
+  # Disable RSpec exposing methods globally on `Module` and `main`
+  config.disable_monkey_patching!
+
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+end

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification
+name: rake_options
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Randy Villanueva
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-10-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: RakeOptions provides an intuitive API for parsing command line arguments
+  in rake tasks with support for multiple notation styles and automatic help documentation
+  generation.
+email:
+- randyv128@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- Rakefile
+- lib/rake_options.rb
+- lib/rake_options/argument_parser.rb
+- lib/rake_options/bracket_parser.rb
+- lib/rake_options/cli_parser.rb
+- lib/rake_options/errors.rb
+- lib/rake_options/hash_with_indifferent_access.rb
+- lib/rake_options/help_generator.rb
+- lib/rake_options/template_engine.rb
+- lib/rake_options/version.rb
+- spec/integration/rake_options_integration_spec.rb
+- spec/rake_options/argument_parser_spec.rb
+- spec/rake_options/bracket_parser_spec.rb
+- spec/rake_options/cli_parser_spec.rb
+- spec/rake_options/help_generator_spec.rb
+- spec/rake_options/template_engine_spec.rb
+- spec/rake_options_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/randyv128/rake_options
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/randyv128/rake_options
+  source_code_uri: https://github.com/randyv128/rake_options
+  changelog_uri: https://github.com/randyv128/rake_options/blob/main/CHANGELOG.md
+  allowed_push_host: https://rubygems.org
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.10
+signing_key:
+specification_version: 4
+summary: Simplify command line argument handling for rake tasks
+test_files: []