raph 0.0.2 → 0.0.3

data/lib/raph/parser/assignment_parser.rb

@@ -1,38 +1,38 @@
-require 'raph/parser/assignment_parser'
-
-module Raph
-  module Parser
-    # Considers option as assignment if and only if
-    # it has an assignment character (=) between
-    # option key and option value.
-    #
-    # Assumes that each option doesn't have spaces.
-    #
-    # Example of assignments:
-    #   'h=one' '-assg=two' '--config=my-file'
-    #
-    # Example of non-assignments:
-    #   '-h' '-h=' 'h=' '=' '--config='
-    #
-    class AssignmentParser < BaseParser
-      def parse(args)
-        assgs = {}
-        args.each do |a|
-          if assignment? a
-            kv = a.split('=')
-            k = to_underscored_sym(kv.first)
-            v = kv.last
-            assgs[k] = v
-          end
-        end
-        assgs
-      end
-
-      def assignment?(option)
-        option.count('=') == 1 &&
-          !option.start_with?('=') &&
-          !option.end_with?('=')
-      end
-    end
-  end
-end
+require 'raph/parser/assignment_parser'
+
+module Raph
+  module Parser
+    # Considers option as assignment if and only if
+    # it has an assignment character (=) between
+    # option key and option value.
+    #
+    # Assumes that each option doesn't have spaces.
+    #
+    # Example of assignments:
+    #   'h=one' '-assg=two' '--config=my-file'
+    #
+    # Example of non-assignments:
+    #   '-h' '-h=' 'h=' '=' '--config='
+    #
+    class AssignmentParser < BaseParser
+      def parse(args)
+        assgs = {}
+        args.each do |a|
+          if assignment? a
+            kv = a.split('=')
+            k = to_underscored_sym(kv.first)
+            v = kv.last
+            assgs[k] = v
+          end
+        end
+        assgs
+      end
+
+      def assignment?(option)
+        option.count('=') == 1 &&
+          !option.start_with?('=') &&
+          !option.end_with?('=')
+      end
+    end
+  end
+end

data/lib/raph/parser/base_parser.rb

@@ -1,50 +1,50 @@
-module Raph
-  # This module consists of argument parsers for Humans
-  module Parser
-    # Base class for all argument parsers.
-    #
-    # You can create a custom parser by subclassing
-    # `Raph::Parser::BaseParser` and overriding some methods,
-    # or by implementing all the methods by duck typing.
-    class BaseParser
-      # Parser unique id.
-      # If parser class name follows a convention NameParser
-      # then it's id will be automatically determined as it's
-      # name in snake case plus suffix 's'
-      #
-      # Example:
-      #    FlagParser.new.id                  # => :flags
-      #    FileParser.new.id                  # => :files
-      #    BaseArgumentParser.new.id          # => :base_arguments
-      def id
-        name = class_name.gsub(/parser$/i, '')
-        name << 's' # make it plural
-        to_underscored_sym(name)
-      end
-
-      # Parses arguments and returns results of parsing.
-      def parse(args)
-      end
-
-      protected
-
-      # Returns underscored symbol of string
-      # (snake case format).
-      def to_underscored_sym(str)
-        str.gsub(/^[-]+/, '').
-          gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
-          gsub(/([a-z\d])([A-Z])/,'\1_\2').
-          tr("-", "_").
-          downcase.
-          to_sym
-      end
-
-      private
-
-      # Returns name of current class.
-      def class_name
-        self.class.name.split('::').last || ''
-      end
-    end
-  end
-end
+module Raph
+  # This module consists of argument parsers for Humans
+  module Parser
+    # Base class for all argument parsers.
+    #
+    # You can create a custom parser by subclassing
+    # `Raph::Parser::BaseParser` and overriding some methods,
+    # or by implementing all the methods by duck typing.
+    class BaseParser
+      # Parser unique id.
+      # If parser class name follows a convention NameParser
+      # then it's id will be automatically determined as it's
+      # name in snake case plus suffix 's'
+      #
+      # Example:
+      #    FlagParser.new.id                  # => :flags
+      #    FileParser.new.id                  # => :files
+      #    BaseArgumentParser.new.id          # => :base_arguments
+      def id
+        name = class_name.gsub(/parser$/i, '')
+        name << 's' # make it plural
+        to_underscored_sym(name)
+      end
+
+      # Parses arguments and returns results of parsing.
+      def parse(args)
+      end
+
+      protected
+
+      # Returns underscored symbol of string
+      # (snake case format).
+      def to_underscored_sym(str)
+        str.gsub(/^[-]+/, '').
+          gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
+          gsub(/([a-z\d])([A-Z])/,'\1_\2').
+          tr("-", "_").
+          downcase.
+          to_sym
+      end
+
+      private
+
+      # Returns name of current class.
+      def class_name
+        self.class.name.split('::').last || ''
+      end
+    end
+  end
+end

data/lib/raph/parser/file_parser.rb

@@ -1,24 +1,24 @@
-require 'raph/parser/base_parser'
-
-module Raph
-  module Parser
-    # Argument is considered as file argument if and only if
-    # corresponding file exist on file system and match
-    # current argument.
-    #
-    # Example:
-    #  'test.rb' - file in current directory with name 'test.rb'
-    #  '*.rb' - all files in current directory with extension 'rb'
-    #  '**/*.xml' - all files in current directory and directories
-    #             that are in this directory with extension 'xml'
-    class FileParser < BaseParser
-      def parse(args)
-        files = []
-        args.each do |a|
-          files.concat Dir[a]
-        end
-        files.uniq
-      end
-    end
-  end
-end
+require 'raph/parser/base_parser'
+
+module Raph
+  module Parser
+    # Argument is considered as file argument if and only if
+    # corresponding file exist on file system and match
+    # current argument.
+    #
+    # Example:
+    #  'test.rb' - file in current directory with name 'test.rb'
+    #  '*.rb' - all files in current directory with extension 'rb'
+    #  '**/*.xml' - all files in current directory and directories
+    #             that are in this directory with extension 'xml'
+    class FileParser < BaseParser
+      def parse(args)
+        files = []
+        args.each do |a|
+          files.concat Dir[a]
+        end
+        files.uniq
+      end
+    end
+  end
+end

data/lib/raph/parser/flag_parser.rb

@@ -1,31 +1,31 @@
-require 'raph/parser/base_parser'
-
-module Raph
-  module Parser
-    # Considers option as flag if and only if
-    # it's name starts with one dash and follows by
-    # one word character or starts with two dashes
-    # and follows by 2 or more word chacters or dashes.
-    #
-    # Assumes that each option doesn't have spaces.
-    #
-    # Example of flags:
-    #   '-h' '-T' '--config'
-    #
-    # Example of non-flags:
-    #   'option' '---option2' '--h'
-    class FlagParser < BaseParser
-      def parse(args)
-        flags = []
-        args.each do |a|
-          flags << to_underscored_sym(a) if flag? a
-        end
-        flags
-      end
-
-      def flag?(option)
-        option =~ /^-[\w]$/ || option =~ /^--[\w][\w-]+$/
-      end
-    end
-  end
-end
+require 'raph/parser/base_parser'
+
+module Raph
+  module Parser
+    # Considers option as flag if and only if
+    # it's name starts with one dash and follows by
+    # one word character or starts with two dashes
+    # and follows by 2 or more word chacters or dashes.
+    #
+    # Assumes that each option doesn't have spaces.
+    #
+    # Example of flags:
+    #   '-h' '-T' '--config'
+    #
+    # Example of non-flags:
+    #   'option' '---option2' '--h'
+    class FlagParser < BaseParser
+      def parse(args)
+        flags = []
+        args.each do |a|
+          flags << to_underscored_sym(a) if flag? a
+        end
+        flags
+      end
+
+      def flag?(option)
+        !!(option =~ /^-[\w]$/ || option =~ /^--[\w][\w-]+$/)
+      end
+    end
+  end
+end

data/lib/raph/parser/grouped_arg_parser.rb

@@ -0,0 +1,42 @@
+require 'raph/parser/base_parser'
+require 'raph/parser/flag_parser'
+require 'raph/parser/assignment_parser'
+
+module Raph
+  module Parser
+    # Grouped arguments are arguments that follows
+    # a group - a specific argument. In other words
+    # flags and assignments represents groups and
+    # arguments followed them are grouped arguments.
+    #
+    # Next example:
+    #   '--group1', '1', '2', '--group2', 'three'
+    # has two groups (`:group1` and `:group2`) with
+    # corresponding grouped arguments (['1', '2'], ['three'])
+    class GroupedArgParser < BaseParser
+      def initialize
+        @flag_parser = FlagParser.new
+        @assignment_parser = AssignmentParser.new
+      end
+
+      def parse(args)
+        groups = {}
+        current_group = nil
+
+        args.each do |arg|
+          if group? arg
+            current_group = to_underscored_sym arg
+            groups[current_group] = []
+          else
+            groups[current_group].push(arg) if current_group
+          end
+        end
+        groups
+      end
+
+      def group?(arg)
+        @flag_parser.flag?(arg) || @assignment_parser.assignment?(arg)
+      end
+    end
+  end
+end

data/lib/raph/version.rb

@@ -1,3 +1,3 @@
-module Raph
-  VERSION = '0.0.2'
-end
+module Raph
+  VERSION = '0.0.3'
+end

data/raph.gemspec

@@ -1,29 +1,29 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'raph/version'
-
-Gem::Specification.new do |spec|
-  spec.name          = 'raph'
-  spec.version       = Raph::VERSION
-  spec.authors       = ['Vitalii Elenhaupt']
-  spec.email         = ['velenhaupt@gmail.com']
-  spec.summary       = 'Ruby Argument Parsing for Humans.'
-  spec.description   = <<-DESC
-    Lightweight argument parsing with flexible structure.
-    Add your parser in few minutes.
-  DESC
-  spec.homepage      = 'https://github.com/veelenga/raph'
-  spec.license       = 'MIT'
-
-  spec.files         = `git ls-files`.split($RS)
-  spec.executables   = spec.files.grep(/^bin\//) { |f| File.basename(f) }
-  spec.test_files    = spec.files.grep(/^spec\//)
-  spec.require_paths = ['lib']
-
-  spec.required_ruby_version = '>= 1.9.3'
-
-  spec.add_development_dependency 'bundler', '~> 1.7'
-  spec.add_development_dependency 'rake', '~> 10.0'
-  spec.add_development_dependency 'rspec', '~> 3.0'
-end
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'raph/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'raph'
+  spec.version       = Raph::VERSION
+  spec.authors       = ['Vitalii Elenhaupt']
+  spec.email         = ['velenhaupt@gmail.com']
+  spec.summary       = 'Ruby Argument Parsing for Humans.'
+  spec.description   = <<-DESC
+    Lightweight argument parsing with flexible structure.
+    Add your parser in few minutes.
+  DESC
+  spec.homepage      = 'https://github.com/veelenga/raph'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split($RS)
+  spec.executables   = spec.files.grep(/^bin\//) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(/^spec\//)
+  spec.require_paths = ['lib']
+
+  spec.required_ruby_version = '>= 1.9.3'
+
+  spec.add_development_dependency 'bundler', '~> 1.7'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+end

data/spec/raph/parser/assinment_parser_spec.rb

@@ -1,45 +1,45 @@
-require 'spec_helper'
-
-module Raph
-  module Parser
-    describe AssignmentParser do
-      describe '#id' do
-        it 'has correct form' do
-          expect(subject.id).to eq :assignments
-        end
-      end
-
-      describe '#parse' do
-        it 'returns assignments only' do
-          parsed = subject.parse(['-h', '-on=20', '--two=my-file'])
-          expect(parsed).to include(:on => '20', :two => 'my-file')
-        end
-
-        it 'has no to return assignments here' do
-          expect(subject.parse(['-h', 'file', '=', '123'])).to be_empty
-          expect(subject.parse([])).to be_empty
-        end
-      end
-
-      describe '#assignment?' do
-        def ass?(option)
-          subject.assignment? option
-        end
-
-        it 'is an assignment' do
-          expect(ass? 'h=one').to be true
-          expect(ass? '-ass=two').to be true
-          expect(ass? '--ass=two').to be true
-        end
-
-        it 'is not as assignment' do
-          expect(ass? '-h').to be false
-          expect(ass? '-h=').to be false
-          expect(ass? 'h=').to be false
-          expect(ass? '=').to be false
-          expect(ass? '-h=one=two').to be false
-        end
-      end
-    end
-  end
-end
+require 'spec_helper'
+
+module Raph
+  module Parser
+    describe AssignmentParser do
+      describe '#id' do
+        it 'has correct form' do
+          expect(subject.id).to eq :assignments
+        end
+      end
+
+      describe '#parse' do
+        it 'returns assignments only' do
+          parsed = subject.parse(['-h', '-on=20', '--two=my-file'])
+          expect(parsed).to include(:on => '20', :two => 'my-file')
+        end
+
+        it 'has no to return assignments here' do
+          expect(subject.parse(['-h', 'file', '=', '123'])).to be_empty
+          expect(subject.parse([])).to be_empty
+        end
+      end
+
+      describe '#assignment?' do
+        def ass?(option)
+          subject.assignment? option
+        end
+
+        it 'is an assignment' do
+          expect(ass? 'h=one').to be true
+          expect(ass? '-ass=two').to be true
+          expect(ass? '--ass=two').to be true
+        end
+
+        it 'is not as assignment' do
+          expect(ass? '-h').to be false
+          expect(ass? '-h=').to be false
+          expect(ass? 'h=').to be false
+          expect(ass? '=').to be false
+          expect(ass? '-h=one=two').to be false
+        end
+      end
+    end
+  end
+end