rubymisc 0.0.3.3 → 0.0.4

data/.gitignore

@@ -4,3 +4,4 @@ Gemfile.lock
 pkg/*
 .DS_Store
 coverage
+doc

data/.irbrc

@@ -0,0 +1,16 @@
+require 'pp'
+require 'irb/completion'
+
+IRB.conf[:AUTO_INDENT] = true
+
+##
+#  @example
+#    time { 1_000_000.times { 'word'.upcase } }
+#
+def time(&block)
+  require 'benchmark'
+  result = nil
+  timing = Benchmark.measure { result = block.() }
+  puts "It took: #{timing}"
+  result
+end

data/README

@@ -8,38 +8,47 @@
 
 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.1 Rbm::Regex
+
+    e1: puts Rbm::Regex.man
+    e2: Rbm::Regex.email
+    e3: Rbm::Regex.url
+    e4: Rbm::Regex.zip
+    e5: Rbm::Regex.ipv4
+    e6: Rbm::Regex.mac_address
+    e7: Rbm::Regex.hexcode
+    e8: Rbm::Regex.usd
 
   2.2 Object
 
     #in?
-      e8: 100.in?([1, 2, 3, 4, 5, 100]) # => true
+      e9: 100.in? [1, 2, 3, 4, 5, 100]  # => true
 
     #not functor
-      e9: 100.not.instance_of?(Fixnum)  # => false
+      e10: 100.not.instance_of? Fixnum  # => false
+
+    #and_try functor
+      e11: nil.and_try.size             # => nil
 
     #errors_with_message
-      e10: begin; raise 'Timeout socket'; rescue errors_with_message(/socket/); p 'socket E'; end
+      e12: begin
+             raise 'Timeout socket'
+           rescue errors_with_message /socket/
+             p 'socket E'
+           end
 
     #ASSERT
-      e11: ASSERT { fail SecurityError.new('Fail message!') }
+      e13: ASSERT { fail SecurityError.new('Fail message!') }
 
   2.3 Integer
 
     #percent_of
-      e12: 50.percent_of(100)           # => 50.0
+      e14: 50.percent_of(100)           # => 50.0
 
   2.4 String
 
     #^, #xor
-      e13: 'rubymisc'.xor 'test'        # => "\u0006\u0010\u0011\r\u0019\f\u0000\u0017"
+      e15: 'rubymisc'.xor 'test'        # => "\u0006\u0010\u0011\r\u0019\f\u0000\u0017"
 
   2.5 ActiveRecord::Base
 

data/lib/rubymisc.rb

@@ -1,19 +1,23 @@
 # encoding: utf-8
 
+# This module encapsulates the entry point functionality to
+# the extension modules.
+#--
+# Copyright (c) 2011 Ivan Povalyukhin.
+# Licensed under the same terms as Ruby. No warranty is provided.
 module Rubymisc
+  class << self
+    def rbm_ext_load(ext_prefix = '') #:nodoc:
+      ->(ext_file) { require ext_prefix + ext_file }
+    end
+    private :rbm_ext_load
+  end
 end
 
-require 'rubymisc/ext/object'
-require 'rubymisc/ext/integer'
-require 'rubymisc/ext/float'
-require 'rubymisc/ext/string'
-require 'rubymisc/ext/active_record'
+Dir[File.expand_path('../rubymisc/ext/*.rb', __FILE__)].each &Rubymisc.send(:rbm_ext_load)
+%w{ self version regex exceptional }.each &Rubymisc.send(:rbm_ext_load, 'rubymisc/')
 
-require 'rubymisc/regex'
-require 'rubymisc/exceptional'
-require 'rubymisc/version'
-
-__END__
-###
-# Copyright (C) 2011 Ivan Povalyukhin.
-###
+module Rbm
+  include Rubymisc
+  extend Rubymisc
+end

data/lib/rubymisc/ext/object.rb

@@ -7,15 +7,28 @@ module Rubymisc
     end
 
     def not
-      not_functor = lambda { |op, *a, &b| !self.__send__(op, *a, &b) }
+      _not_functor = ->(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)
+      _not_functor.singleton_class.module_eval <<-CODE
+        def method_missing(method, *args, &block)
+          call method, *args, &block
         end
       CODE
 
-      not_functor
+      _not_functor
+    end
+
+    def and_try
+      _and_try_functor = BasicObject.new
+      (class << _and_try_functor; self; end).module_eval do
+        attr_accessor :delegate_to
+
+        def method_missing(method, *args, &block)
+          delegate_to ? delegate_to.__send__(method, *args, &block) : delegate_to
+        end
+      end
+      _and_try_functor.delegate_to = self
+      _and_try_functor
     end
   end
 end

data/lib/rubymisc/regex/manual.rb

@@ -2,8 +2,8 @@
 
 module Rubymisc
   module Regex
-    class Manual
-      def self.man
+    module Manual
+      def man
         <<-EOS
 Ruby character representations
 ------------------------------
@@ -32,8 +32,77 @@ Ruby character classses and class-like constructs
   \\D              Nondigit.
   \\s              Whitespace character, [\\f\\n\\r\\t\\v].
   \\S              Nonwhitespace character, [^\\f\\n\\r\\t\\v].
+  \\h              Hexadecimal digit.
+  \\H              Negated form of \\h.
+
+Ruby anchors and other zero-width tests
+---------------------------------------
+  Sequence        Meaning
+  ^               Start of string, or the point after any newline.
+  \\A              Beginning of string, in all match modes.
+  $               End of string, or the point before any newline.
+  \\Z              End of string, but before any final line terminator, in all match modes.
+  \\z              End of string, in all match modes.
+  \\b              Boundary between a \\w character and a \W character.
+  \\B              Not-word-boundary.
+  \\G              End of the previous match.
+  (?=...)         Positive lookahead.
+  (?!...)         Negative lookahead.
+
+Ruby comments and mode modifiers
+--------------------------------
+  Mode character  Meaning
+  m               Dot(.) matches any character, including a line terminator.
+                  Note that this is different from most regex implementations.
+  x               Ignore whitespace, and allow embedded comment starting with #.
+  i               Case-insensitive match.
+  n               Turn off wide-character processing.
+  o               Evaluate \#{...} substitutions only once. Default is to evaluate each time the regex is evaluated.
+  (?imns-imns)    Turn match flags on or off for the rest of pattern.
+  (?imns-imns:    Turn match flags on or off for the rest of the subexpression.
+  ...)
+  (?#...)         Treat substring as a comment.
+  #...            Treat rest of line as a comment in /x mode.
+  (?<=...)        Positive lookbehind.
+  (?<!...)        Negative lookbehind.
+
+Ruby grouping, capturing, conditional and control
+-------------------------------------------------
+  Sequence        Meaning
+  (...)           Grouping. Submatches fill \\1, \\2, ... and $1, $2, ...
+  (?<name>...)    Named captured. Grouped match will fill \\k<name>.
+  \\n              In a regular expression, match what was matched by the nth earlier submatch.
+  $n              In a replacement string, contains the nth earlier submatch.
+  \\k<name>        In a replacement string, contains the named submatch name.
+  (?:...)         Grouping-only parentheses, no capturing.
+  (?>...)         Atomic grouping.
+  ...|...         Alternation; match one or the other.
+  *               Match 0 or more times.
+  +               Match 1 or more times.
+  ?               Match 1 or 0 times.
+  {n}             Match exactly n times.
+  {n,}            Match at least n times.
+  {,n}            Match at most n times.
+  {x,y}           Match at least x times, but no more than y times.
+  *?              Match 0 or more times, but as few times as possible.
+  +?              Match 1 or more times, but as few times as possible.
+  ??              Match 0 or 1 times, but as few times as possible.
+  {n,}?           Match at least n times, but as few times as possible.
+  {x,y}?          Match at least x times, no more than y times, and as few times as possible.
+
+Ruby replacement sequences
+--------------------------
+  Sequence        Meaning
+  $1, $2, ...     Captured submatches.
+  ${name}         Matched text of a named capture group.
+  $'              Text before match.
+  $&              Text of match.
+  $`              Text after match.
+  $+              Last parenthesized match.
+  $~              Match data. Encapsulates the results of a successful pattern match.
         EOS
       end
+      module_function :man
     end
   end
 end

data/lib/rubymisc/self.rb

@@ -0,0 +1,24 @@
+# encoding: utf-8
+
+# This module encapsulates top level class methods.
+module Rubymisc
+  class << self
+    def log_at_exit_error(log_to)
+      at_exit { dump_error_to_file(log_to) }
+    end
+
+    def dump_error_to_file(file)
+      if $!
+        File.open(file, 'a:utf-8:utf-8') do |log|
+          error = { timestamp: Time.now,
+                    message:   $!.message,
+                    backtrace: $!.backtrace,
+                    gems:      Gem.loaded_specs.inject({}) { |m, (n, s)| m.merge(n => s.version.to_s) } }
+          require 'yaml'
+          YAML.dump(error, log)
+        end
+      end
+    end
+    private :dump_error_to_file
+  end
+end

data/lib/rubymisc/version.rb

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

data/rubymisc.gemspec

@@ -26,7 +26,7 @@ Gem::Specification.new do |s|
   s.extra_rdoc_files = ['README']
   s.license = 'MIT'
 
-  { rspec:     '~> 2.8.0.rc1',
+  { rspec:     '~> 2.8.0',
     rake:      '~> 0.9.2.2',
     bundler:   '~> 1.0.21',
     simplecov: '~> 0.5.4' }.each { |lib, v| s.add_development_dependency lib.to_s, v }

data/spec/rubymisc/exceptional_spec.rb

@@ -2,7 +2,7 @@
 
 require 'spec_helper'
 
-describe Rubymisc::Exceptional do
+describe Rbm::Exceptional do
   describe '#ASSERT' do
     specify 'catches failing block and swallows the exception' do
       failing_proc = -> { fail SecurityError.new('Fail message!') }

data/spec/rubymisc/ext/float_spec.rb

@@ -2,7 +2,7 @@
 
 require 'spec_helper'
 
-describe Rubymisc::Float do
+describe Rbm::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

data/spec/rubymisc/ext/integer_spec.rb

@@ -2,7 +2,7 @@
 
 require 'spec_helper'
 
-describe Rubymisc::Integer do
+describe Rbm::Integer do
   describe '#percent_of' do
     specify '50 is 50.0 percent of 100' do
       50.percent_of(100).should be_kind_of Float

data/spec/rubymisc/ext/object_spec.rb

@@ -2,7 +2,7 @@
 
 require 'spec_helper'
 
-describe Rubymisc::Object do
+describe Rbm::Object do
   let(:collection) { [1, 2, 3, 4, 5, 100] }
 
   describe '#in?' do
@@ -35,4 +35,20 @@ describe Rubymisc::Object do
       collection.not.include?(1).should be false
     end
   end
+
+  describe '#and_try Functor' do
+    specify 'returns nil if nil is a receiver' do
+      nil.should respond_to :and_try
+      expect { nil.and_try.size.should be nil }.not_to raise_error
+    end
+
+    specify 'returns false if false is a receiver' do
+      false.should respond_to :and_try
+      expect { false.and_try.size }
+    end
+
+    specify 'returns 11 for "test string".and_try.size' do
+      'test string'.and_try.size.should be 11
+    end
+  end
 end

data/spec/rubymisc/ext/string_spec.rb

@@ -2,7 +2,7 @@
 
 require 'spec_helper'
 
-describe Rubymisc::String do
+describe Rbm::String do
   let(:test_string) { 'rubymisc' }
 
   describe '#^' do

data/spec/rubymisc/regex/manual_spec.rb

@@ -2,9 +2,9 @@
 
 require 'spec_helper'
 
-describe 'Rubymisc::Regex::Manual' do
+describe Rbm::Regex::Manual do
   specify '.man' do
-    Rubymisc::Regex.man.should be_start_with <<-EOS
+    Rbm::Regex.man.should be_start_with <<-EOS
 Ruby character representations
 ------------------------------
   Sequence        Meaning
@@ -21,6 +21,6 @@ Ruby character representations
   \\cchar          Named control character.
     EOS
 
-    puts "\n" + Rubymisc::Regex.man
+    puts "\n" + Rbm::Regex.man
   end
 end

data/spec/rubymisc/regex_spec.rb

@@ -2,66 +2,66 @@
 
 require 'spec_helper'
 
-describe Rubymisc::Regex do
+describe Rbm::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'
+      Rbm::Regex.email.should match 'ipoval@ya.ru'
+      Rbm::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/'
+      Rbm::Regex.url.should match 'http://google.com'
+      Rbm::Regex.url.should match 'http://www.google.com'
+      Rbm::Regex.url.should match 'https://google.com'
+      Rbm::Regex.url.should match 'https://www.google.com'
+      Rbm::Regex.url.should match 'http://google.com/'
+      Rbm::Regex.url.should match 'http://www.google.com/'
+      Rbm::Regex.url.should match 'https://google.com/'
+      Rbm::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'
+      Rbm::Regex.zip.should match '90028'
+      Rbm::Regex.zip.should match '90028-0000'
+      Rbm::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'
+      Rbm::Regex.ipv4.should match '127.0.0.1'
+      Rbm::Regex.ipv4.should match '224.22.5.110'
+      Rbm::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'
+      Rbm::Regex.mac_address.should match '01:23:45:67:89:ab'
+      Rbm::Regex.mac_address.should_not match '01:23:45'
+      Rbm::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 '#000AAA'
-      Rubymisc::Regex.hexcode.should_not match 'fff'
-      Rubymisc::Regex.hexcode.should_not match '#ggg'
+      Rbm::Regex.hexcode.should match '#aaa'
+      Rbm::Regex.hexcode.should match '#000AAA'
+      Rbm::Regex.hexcode.should_not match 'fff'
+      Rbm::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'
+      Rbm::Regex.usd.should match '$20'
+      Rbm::Regex.usd.should match '$15,000.01'
+      Rbm::Regex.usd.should_not match '$1.001'
+      Rbm::Regex.usd.should_not match '$.99'
     end
   end
 end

data/spec/rubymisc/version_spec.rb

@@ -2,6 +2,6 @@
 
 require 'spec_helper'
 
-describe Rubymisc::VERSION do
+describe Rbm::VERSION do
   it { should =~ /\A\d+\.\d+\.\d+(\.\d+)?\z/ }
 end

data/spec/rubymisc_spec.rb

@@ -2,5 +2,24 @@
 
 require 'spec_helper'
 
-describe Rubymisc do
+describe Rbm do
+  describe '.log_at_exit_error' do
+    let(:crash_log) { 'rubymisc.crash.log' }
+
+    around(:each) { FileUtils.rm crash_log, force: true, verbose: true }
+
+    it { should respond_to :log_at_exit_error }
+
+    specify 'fail SystemExit, raised by exit to initiate the termination of the script' do
+      File.exist?(crash_log).should be_false
+
+      begin
+        fail SystemExit
+      rescue Exception
+        Rbm.send(:dump_error_to_file, crash_log)
+      end
+
+      File.exist?(crash_log).should be_true
+    end
+  end
 end

data/spec/spec_helper.rb

@@ -2,11 +2,13 @@
 
 $:.unshift File.expand_path('../lib', __FILE__)
 
-# Use simplecov test coverage
-require 'simplecov'
+require 'simplecov' # use simplecov test coverage
 SimpleCov.start
 
+require 'yaml'
+require 'fileutils'
 require 'rubymisc'
+
 Dir['./spec/support/**/*.rb'].each { |f| require f }
 
 RSpec.configure do |conf|

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rubymisc
 version: !ruby/object:Gem::Version
-  version: 0.0.3.3
+  version: 0.0.4
   prerelease: 
 platform: ruby
 authors:
@@ -9,22 +9,22 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-12-16 00:00:00.000000000 Z
+date: 2012-01-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &2152009360 !ruby/object:Gem::Requirement
+  requirement: &2152648740 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 2.8.0.rc1
+        version: 2.8.0
   type: :development
   prerelease: false
-  version_requirements: *2152009360
+  version_requirements: *2152648740
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &2152006660 !ruby/object:Gem::Requirement
+  requirement: &2152648280 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,10 +32,10 @@ dependencies:
         version: 0.9.2.2
   type: :development
   prerelease: false
-  version_requirements: *2152006660
+  version_requirements: *2152648280
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &2152004700 !ruby/object:Gem::Requirement
+  requirement: &2152647820 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -43,10 +43,10 @@ dependencies:
         version: 1.0.21
   type: :development
   prerelease: false
-  version_requirements: *2152004700
+  version_requirements: *2152647820
 - !ruby/object:Gem::Dependency
   name: simplecov
-  requirement: &2152003480 !ruby/object:Gem::Requirement
+  requirement: &2152647360 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -54,7 +54,7 @@ dependencies:
         version: 0.5.4
   type: :development
   prerelease: false
-  version_requirements: *2152003480
+  version_requirements: *2152647360
 description: Miscellaneous and humble tool-set of useful Ruby.
 email:
 - ipoval@ya.ru
@@ -64,6 +64,7 @@ extra_rdoc_files:
 - README
 files:
 - .gitignore
+- .irbrc
 - .rvmrc
 - .travis.yml
 - Gemfile
@@ -79,6 +80,7 @@ files:
 - lib/rubymisc/ext/string.rb
 - lib/rubymisc/regex.rb
 - lib/rubymisc/regex/manual.rb
+- lib/rubymisc/self.rb
 - lib/rubymisc/version.rb
 - rubymisc.gemspec
 - spec/rubymisc/exceptional_spec.rb