rubymisc 0.0.1

data/.gitignore

@@ -0,0 +1,6 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.DS_Store
+coverage

data/.rvmrc

@@ -0,0 +1 @@
+rvm use 1.9.3@rubymisc 2>/dev/null

data/Gemfile

@@ -0,0 +1,2 @@
+source :rubygems
+gemspec

data/README

@@ -0,0 +1,43 @@
+1 What is Rubymisc (Ruby miscellaneous | /ˈru:bi ˌmisəˈleiniəs/)
+  Miscellaneous and humble tool-set of useful Ruby
+
+  1.1 Installation
+    gem install rubymisc
+
+2 Usage
+
+  2.1 Regular expressions
+    e1: Rubymisc::Regex.email
+    e2: Rubymisc::Regex.url
+    e3: Rubymisc::Regex.zip
+    e4: Rubymisc::Regex.ipv4
+    e5: Rubymisc::Regex.mac_address
+    e6: Rubymisc::Regex.hexcode
+    e7: Rubymisc::Regex.usd
+
+  2.2 Object
+
+    #in?
+      e8: 100.in?([1, 2, 3, 4, 5, 100]) # => true
+
+    #not functor
+      e9: 100.not.instance_of?(Fixnum)  # => false
+
+    #errors_with_message
+      e10: begin; raise 'Timeout socket'; rescue errors_with_message(/socket/); p 'socket E'; end
+
+  2.3 Integer
+
+    #percent_of
+      e11: 50.percent_of(100)           # => 50.0
+
+  2.4 ActiveRecord::Base
+    .validates_url
+    .validates_email
+    .validates_image_url
+
+3 Development
+
+  - `gem install bundler`
+  - `bundle install`
+  - `bundle exec rake spec`

data/Rakefile

@@ -0,0 +1,13 @@
+# encoding: utf-8
+
+require 'rake'
+require 'bundler'
+
+Bundler::GemHelper.install_tasks
+
+Dir['lib/tasks/**/*.rake'].
+  concat(Dir['tasks/**/*.rake']).
+  concat(Dir['{test,spec}/*.rake']).each { |rake| load(rake) }
+
+task :default => :spec
+task :test => :spec # for http://test.rubygems.org/

data/lib/rubymisc/exceptional.rb

@@ -0,0 +1,44 @@
+# encoding: utf-8
+
+module Rubymisc
+  module Exceptional
+    def ASSERT(&block)
+      begin
+        yield
+      rescue StandardError => e
+        STDERR.puts e.inspect
+        STDERR.puts e.backtrace
+        raise RuntimeError, "#{e.message}", caller
+      end
+    end
+
+    ##
+    # @example
+    #   begin; raise 'Timeout socket'; rescue errors_with_message(/socket/); p 'socket E'; end
+    #
+    def errors_with_message(pattern)
+      m = Module.new
+      (class << m; self; end).instance_eval do
+        define_method(:===) do |e|
+          pattern === e.message
+        end
+      end
+      m
+    end
+
+    ##
+    # @example
+    #   rescue => e; raise NestedException.new('Error B', e); end
+    #   rescue; raise NestedException, 'Error B'; end
+    #
+    class NestedException < StandardError
+      attr_reader :original
+      def initialize(msg, original = $!)
+        super(msg)
+        @original = original
+      end
+    end
+  end
+end
+
+::Object.module_eval 'include Rubymisc::Exceptional'

data/lib/rubymisc/ext/active_record.rb

@@ -0,0 +1,28 @@
+# encoding: utf-8
+
+if defined?('ActiveRecord')
+  module Rubymisc
+    module ArValidates
+      def validates_url(attribute = :url)
+        validates_presence_of attribute
+        validates_length_of attribute, :minimum => 12
+        validates_format_of attribute, :with => Regex.url, :message => %/isn't a valid URL./
+      end
+
+      def validates_email(attribute = :email)
+        validates_presence_of attribute
+        validates_length_of attribute, :minimum => 5
+        validates_format_of attribute, :with => Regex.email, :message => %/isn't a valid email./
+      end
+
+      def validates_image_url(attribute = :image_url)
+        validates attribute, allow_blank: true, format: {
+          with: %r{\.(gif|jpg|png)$}i,
+          message: 'must be a URL for GIF, JPG or PNG image.'
+        }
+      end
+    end
+
+    ActiveRecord::Base.extend ArValidates
+  end
+end

data/lib/rubymisc/ext/float.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+
+module Rubymisc
+  module Float
+    def percent_of(number)
+      self * 100 / number
+    end
+  end
+end
+
+::Float.module_eval 'include Rubymisc::Float'

data/lib/rubymisc/ext/integer.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+
+module Rubymisc
+  module Integer
+    def percent_of(number)
+      self.to_f * 100 / number
+    end
+  end
+end
+
+::Integer.module_eval 'include Rubymisc::Integer'

data/lib/rubymisc/ext/object.rb

@@ -0,0 +1,23 @@
+# encoding: utf-8
+
+module Rubymisc
+  module Object
+    def in?(collection)
+      collection.respond_to?(:include?) ? collection.include?(self) : false
+    end
+
+    def not
+      not_functor = lambda { |op, *a, &b| !self.__send__(op, *a, &b) }
+
+      not_functor.singleton_class.module_eval <<-CODE
+        def method_missing(method, *arguments, &block)
+          call(method, *arguments, &block)
+        end
+      CODE
+
+      not_functor
+    end
+  end
+end
+
+::Object.module_eval 'include Rubymisc::Object'

data/lib/rubymisc/regex/manual.rb

@@ -0,0 +1,39 @@
+# encoding: utf-8
+
+module Rubymisc
+  module Regex
+    class Manual
+      def self.man
+        <<-EOS
+Ruby character representations
+------------------------------
+  Sequence        Meaning
+  \\a              Alert (bell), \\x07.
+  \\b              Backspace, \\x08, supported only in character class.
+  \\e              ESC character, \\x1B.
+  \\n              Newline, \\x0A.
+  \\r              Carriage return, \\x0D.
+  \\f              Form feed, \\x0C.
+  \\t              Horizontal tab \\x09.
+  \\v              Vertical tab, \\x0B.
+  \\0octal         Character specified by a two-digit octal code.
+  \\xhex           Character specified by a two-digit hexadecimal code.
+  \\cchar          Named control character.
+
+Ruby character classses and class-like constructs
+-------------------------------------------------
+  Class           Meaning
+  [...]           A single character listed, or contained within a listed range.
+  [^...]          A single character not listed, and not contained within a listed range.
+  .               Any character, except a line terminator (unless single-line mode, s).
+  \\w              Word character.
+  \\W              Nonword character.
+  \\d              Digit.
+  \\D              Nondigit.
+  \\s              Whitespace character, [\\f\\n\\r\\t\\v].
+  \\S              Nonwhitespace character, [^\\f\\n\\r\\t\\v].
+        EOS
+      end
+    end
+  end
+end

data/lib/rubymisc/regex.rb

@@ -0,0 +1,47 @@
+# encoding: utf-8
+
+module Rubymisc
+  module Regex
+    autoload :Manual, File.expand_path('../regex/manual', __FILE__)
+
+    class << self
+      def email
+        email_name_regex  = '[\w\.%\+\-]+'.freeze
+        domain_head_regex = '(?:[A-Z0-9\-]+\.)+'.freeze
+        domain_tld_regex  = '(?:[A-Z]{2}|com|org|net|edu|gov|mil|biz|info|mobi|name|aero|jobs|museum)'.freeze
+        /\A#{email_name_regex}@#{domain_head_regex}#{domain_tld_regex}\z/i
+      end
+
+      def url
+        /\A((https?):(([A-Za-z0-9$_.+!*(),;\/?:@&~=-])|%[A-Za-z0-9]{2}){2,}(#([a-zA-Z0-9][a-zA-Z0-9$_.+!*(),;\/?:@&~=%-]*))?([A-Za-z0-9$_+!*();\/?:~-]))\z/
+      end
+
+      def zip
+        /\A\d{5}(?:-\d{4})?\z/
+      end
+
+      def ipv4
+        ip_octet = '(\d|[01]?\d\d|2[0-4]\d|25[0-5])'.freeze
+        /\A#{ip_octet}\.#{ip_octet}\.#{ip_octet}\.#{ip_octet}\z/
+      end
+
+      def mac_address
+        /\A(\h{2}:){5}\h{2}\z/
+      end
+
+      def hexcode
+        /\A#(\h{3})\1?\z/
+      end
+
+      def usd
+        /\A\$(\d{1,3}(\,\d{3})*|\d+)(\.\d{2})?\z/
+      end
+    end
+
+    code = <<-CODE
+      def man; Manual.man; end
+    CODE
+
+    singleton_class.module_eval code
+  end
+end

data/lib/rubymisc/version.rb

@@ -0,0 +1,5 @@
+# encoding: utf-8
+
+module Rubymisc
+  VERSION = '0.0.1'
+end

data/lib/rubymisc.rb

@@ -0,0 +1,12 @@
+# encoding: utf-8
+
+module Rubymisc
+  autoload :Object,      'rubymisc/ext/object'
+  autoload :Integer,     'rubymisc/ext/integer'
+  autoload :Float,       'rubymisc/ext/float'
+
+  autoload :Regex,       'rubymisc/regex'
+  autoload :Exceptional, 'rubymisc/exceptional'
+end
+
+require 'rubymisc/version'

data/rubymisc.gemspec

@@ -0,0 +1,30 @@
+# encoding: utf-8
+
+$:.push File.expand_path('../lib', __FILE__)
+require 'rubymisc/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'rubymisc'
+  s.version     = Rubymisc::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ['Ivan Povalyukhin']
+  s.email       = ['ipoval@ya.ru']
+  s.homepage    = 'https://github.com/ipoval/rubymisc'
+  s.summary     = %q{Ruby miscellaneous.}
+  s.description = %q{Miscellaneous and humble tool-set of useful Ruby.}
+
+  s.rubyforge_project = 'rubymisc'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ['lib']
+
+  s.required_ruby_version = '>= 1.9.3'
+  s.required_rubygems_version = '>= 1.3.5'
+
+  { rspec:     '~> 2.8.0.rc1',
+    rake:      '~> 0.9.2',
+    bundler:   '~> 1.0.21',
+    simplecov: '~> 0.5.4' }.each { |lib, v| s.add_development_dependency lib, v }
+end

data/spec/rubymisc/exceptional_spec.rb

@@ -0,0 +1,50 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Rubymisc::Exceptional do
+  describe '#ASSERT' do
+    specify 'catches failing block and raises RuntimeError' do
+      failing_proc = -> { fail 'Fail message!' }
+      expect { ASSERT &failing_proc }.to raise_error RuntimeError
+    end
+
+    specify 'ok block does not raise error' do
+      success_proc = -> { true }
+      expect { ASSERT &success_proc }.to_not raise_error
+    end
+  end
+
+  describe '#errors_with_message' do
+    specify 'rescue an exception if message match' do
+      e_socket = -> {
+        begin; fail 'Timeout socket'; rescue errors_with_message(/socket/); end
+      }
+      expect(&e_socket).to_not raise_exception
+    end
+
+    specify 'do not rescue an exception if no message match' do
+      e_none_socket = -> {
+        begin; fail 'Timeout without correct token'; rescue errors_with_message(/socket/); end
+      }
+      expect(&e_none_socket).to raise_exception(RuntimeError, 'Timeout without correct token')
+    end
+  end
+
+  describe NestedException do
+    specify 'wraps $! exception' do
+      begin
+        fail 'OriginalException'
+      rescue => e_original
+        begin
+          raise NestedException, e_original.message + '::NestingException'
+        rescue => e_nesting
+          e_nesting.should respond_to :original
+          e_nesting.original.should be e_original
+          e_nesting.message.should          == 'OriginalException::NestingException'
+          e_nesting.original.message.should == 'OriginalException'
+        end
+      end
+    end
+  end
+end

data/spec/rubymisc/ext/float_spec.rb

@@ -0,0 +1,17 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Rubymisc::Float do
+  describe '#percent_of' do
+    specify '50.0 is 50.0 percent of 100' do
+      (50.0).percent_of(100).should be_kind_of Float
+      (50.0).percent_of(100).should == 50.0
+    end
+
+    specify '0.0 is 0.0 percent of 100' do
+      (0.0).percent_of(100).should be_kind_of Float
+      (0.0).percent_of(100).should == 0.0
+    end
+  end
+end

data/spec/rubymisc/ext/integer_spec.rb

@@ -0,0 +1,17 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Rubymisc::Integer do
+  describe '#percent_of' do
+    specify '50 is 50.0 percent of 100' do
+      50.percent_of(100).should be_kind_of Float
+      50.percent_of(100).should == 50.0
+    end
+
+    specify '0 is 0.0 percent of 100' do
+      0.percent_of(100).should be_kind_of Float
+      0.percent_of(100).should == 0.0
+    end
+  end
+end

data/spec/rubymisc/ext/object_spec.rb

@@ -0,0 +1,38 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Rubymisc::Object do
+  let(:collection) { [1, 2, 3, 4, 5, 100] }
+
+  describe '#in?' do
+    context 'given collection includes element' do
+      specify 'returns true' do
+        100.in?(collection).should be_true
+      end
+    end
+
+    context 'given collection does not include element' do
+      specify 'returns false' do
+        101.in?(collection).should be_false
+      end
+    end
+  end
+
+  describe '#not Functor' do
+    specify 'String#empty? returns false for blank string with #not Functor' do
+      ''.empty?.should be true
+      ''.not.empty?.should be false
+    end
+
+    specify 'Object#instance_of? returns false when class matches with #not Functor' do
+      100.instance_of?(Fixnum).should be true
+      100.not.instance_of?(Fixnum).should be false
+    end
+
+    specify 'Enumerable#include? returns false for collection having an element with #not Functor' do
+      collection.include?(1).should be true
+      collection.not.include?(1).should be false
+    end
+  end
+end

data/spec/rubymisc/regex/manual_spec.rb

@@ -0,0 +1,26 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe 'Rubymisc::Regex::Manual' do
+  specify '.man' do
+    Rubymisc::Regex.man.should be_start_with <<-EOS
+Ruby character representations
+------------------------------
+  Sequence        Meaning
+  \\a              Alert (bell), \\x07.
+  \\b              Backspace, \\x08, supported only in character class.
+  \\e              ESC character, \\x1B.
+  \\n              Newline, \\x0A.
+  \\r              Carriage return, \\x0D.
+  \\f              Form feed, \\x0C.
+  \\t              Horizontal tab \\x09.
+  \\v              Vertical tab, \\x0B.
+  \\0octal         Character specified by a two-digit octal code.
+  \\xhex           Character specified by a two-digit hexadecimal code.
+  \\cchar          Named control character.
+    EOS
+
+    puts "\n" + Rubymisc::Regex.man
+  end
+end

data/spec/rubymisc/regex_spec.rb

@@ -0,0 +1,67 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Rubymisc::Regex do
+  describe '.email' do
+    specify 'valid email regexp' do
+      Rubymisc::Regex.email.should match 'ipoval@ya.ru'
+      Rubymisc::Regex.email.should match 'ivan-poval@yandex.ru'
+    end
+  end
+
+  describe '.url' do
+    specify 'valid url regexp' do
+      Rubymisc::Regex.url.should match 'http://google.com'
+      Rubymisc::Regex.url.should match 'http://www.google.com'
+      Rubymisc::Regex.url.should match 'https://google.com'
+      Rubymisc::Regex.url.should match 'https://www.google.com'
+      Rubymisc::Regex.url.should match 'http://google.com/'
+      Rubymisc::Regex.url.should match 'http://www.google.com/'
+      Rubymisc::Regex.url.should match 'https://google.com/'
+      Rubymisc::Regex.url.should match 'https://www.google.com/'
+    end
+  end
+
+  describe '.zip' do
+    specify 'valid zip regexp' do
+      Rubymisc::Regex.zip.should match '90028'
+      Rubymisc::Regex.zip.should match '90028-0000'
+      Rubymisc::Regex.zip.should_not match '9002'
+    end
+  end
+
+  describe '.ipv4' do
+    specify 'valid dotted quad IP address' do
+      Rubymisc::Regex.ipv4.should match '127.0.0.1'
+      Rubymisc::Regex.ipv4.should match '224.22.5.110'
+      Rubymisc::Regex.ipv4.should_not match '127.1'
+    end
+  end
+
+  describe '.mac_address' do
+    specify 'valid mac address' do
+      Rubymisc::Regex.mac_address.should match '01:23:45:67:89:ab'
+      Rubymisc::Regex.mac_address.should_not match '01:23:45'
+      Rubymisc::Regex.mac_address.should_not match '0123456789ab'
+    end
+  end
+
+  describe '.hexcode' do
+    specify 'valid html hex code' do
+      Rubymisc::Regex.hexcode.should match '#aaa'
+      Rubymisc::Regex.hexcode.should match '#000000'
+      Rubymisc::Regex.hexcode.should_not match 'fff'
+      Rubymisc::Regex.hexcode.should_not match '#ggg'
+    end
+  end
+
+  describe '.usd' do
+    specify '.usd' do
+      Rubymisc::Regex.usd.should match '$20'
+      Rubymisc::Regex.usd.should match '$15,000.01'
+      Rubymisc::Regex.usd.should_not match '$1.001'
+      Rubymisc::Regex.usd.should_not match '$.99'
+    end
+  end
+end

data/spec/rubymisc/version_spec.rb

@@ -0,0 +1,7 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Rubymisc::VERSION do
+  it { should =~ /\A\d+\.\d+\.\d+\z/ }
+end

data/spec/rubymisc_spec.rb

@@ -0,0 +1,6 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Rubymisc do
+end

data/spec/spec.rake

@@ -0,0 +1,17 @@
+# encoding: utf-8
+
+require 'rspec/core/rake_task'
+
+desc 'Run complete application spec suite'
+RSpec::Core::RakeTask.new(:spec)
+
+spec_tasks = Dir['spec/*/'].map { |d| File.basename(d) }
+
+spec_tasks.each do |folder|
+  RSpec::Core::RakeTask.new("spec:#{folder}") do |t|
+    t.pattern = "./spec/#{folder}/**/*_spec.rb"
+    t.rspec_opts = %w(--color)
+  end
+end
+
+# task 'spec' => spec_tasks.map { |f| "spec:#{f}" }

data/spec/spec_helper.rb

@@ -0,0 +1,23 @@
+# encoding: utf-8
+
+$:.unshift File.expand_path('../lib', __FILE__)
+
+# Use simplecov test coverage
+require 'simplecov'
+SimpleCov.start
+
+require 'rubymisc'
+Dir['./spec/support/**/*.rb'].each { |f| require f }
+
+RSpec.configure do |conf|
+  conf.color_enabled = true
+  conf.treat_symbols_as_metadata_keys_with_true_values = true
+
+  conf.expect_with :rspec, :stdlib
+  conf.mock_with :rspec
+
+  conf.fail_fast = true
+  conf.filter_run :focus  => true
+  conf.filter_run_excluding :broken => true
+  conf.run_all_when_everything_filtered = true
+end

metadata

@@ -0,0 +1,124 @@
+--- !ruby/object:Gem::Specification
+name: rubymisc
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Ivan Povalyukhin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-12-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: :rspec
+  requirement: &2152338320 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.8.0.rc1
+  type: :development
+  prerelease: false
+  version_requirements: *2152338320
+- !ruby/object:Gem::Dependency
+  name: :rake
+  requirement: &2152337660 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+  type: :development
+  prerelease: false
+  version_requirements: *2152337660
+- !ruby/object:Gem::Dependency
+  name: :bundler
+  requirement: &2152337020 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.21
+  type: :development
+  prerelease: false
+  version_requirements: *2152337020
+- !ruby/object:Gem::Dependency
+  name: :simplecov
+  requirement: &2152332880 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.5.4
+  type: :development
+  prerelease: false
+  version_requirements: *2152332880
+description: Miscellaneous and humble tool-set of useful Ruby.
+email:
+- ipoval@ya.ru
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rvmrc
+- Gemfile
+- README
+- Rakefile
+- lib/rubymisc.rb
+- lib/rubymisc/exceptional.rb
+- lib/rubymisc/ext/active_record.rb
+- lib/rubymisc/ext/float.rb
+- lib/rubymisc/ext/integer.rb
+- lib/rubymisc/ext/object.rb
+- lib/rubymisc/regex.rb
+- lib/rubymisc/regex/manual.rb
+- lib/rubymisc/version.rb
+- rubymisc.gemspec
+- spec/rubymisc/exceptional_spec.rb
+- spec/rubymisc/ext/float_spec.rb
+- spec/rubymisc/ext/integer_spec.rb
+- spec/rubymisc/ext/object_spec.rb
+- spec/rubymisc/regex/manual_spec.rb
+- spec/rubymisc/regex_spec.rb
+- spec/rubymisc/version_spec.rb
+- spec/rubymisc_spec.rb
+- spec/spec.rake
+- spec/spec_helper.rb
+homepage: https://github.com/ipoval/rubymisc
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.3.5
+requirements: []
+rubyforge_project: rubymisc
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Ruby miscellaneous.
+test_files:
+- spec/rubymisc/exceptional_spec.rb
+- spec/rubymisc/ext/float_spec.rb
+- spec/rubymisc/ext/integer_spec.rb
+- spec/rubymisc/ext/object_spec.rb
+- spec/rubymisc/regex/manual_spec.rb
+- spec/rubymisc/regex_spec.rb
+- spec/rubymisc/version_spec.rb
+- spec/rubymisc_spec.rb
+- spec/spec.rake
+- spec/spec_helper.rb