rcore-ext 0.1.1

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+## v0.1.0
+
+* initial release

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in rcore-ext.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,28 @@
+PATH
+  remote: .
+  specs:
+    rcore-ext (0.1.0)
+      base32
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    base32 (0.2.0)
+    diff-lcs (1.2.1)
+    rake (10.0.3)
+    rspec (2.13.0)
+      rspec-core (~> 2.13.0)
+      rspec-expectations (~> 2.13.0)
+      rspec-mocks (~> 2.13.0)
+    rspec-core (2.13.1)
+    rspec-expectations (2.13.0)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.13.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  rake
+  rcore-ext!
+  rspec

data/README.md

@@ -0,0 +1,75 @@
+# Ruby Core Extensions
+
+The `rcore_ext` gem extends several core classes
+
+
+## Installation
+
+To install `rcore-ext`, run `gem install rcore-ext` or
+
+add the following to your `Gemfile`:
+
+    gem 'rcore-ext'
+
+Then bundle install:
+
+    bundle install
+
+## Usage
+
+Examples:
+
+### Numeric methods
+
+```ruby
+"1".is_integer?             #=> true
+"1.0".is_integer?           #=> false
+"not_numeric".is_integer?   #=> false
+```
+
+```ruby
+"1".is_numeric?             #=> true
+"1.0".is_numeric?           #=> true
+"not_numeric".is_numeric?   #=> false
+```
+
+```ruby
+"1".is_float?             #=> false
+"1.0".is_float?           #=> true
+"not_numeric".is_float?   #=> false
+```
+
+```ruby
+"1".to_numeric                #=> 1
+"1".to_numeric.class          #=> Fixnum
+"1.0".to_numeric              #=> 1.0
+"1.0".to_numeric.class        #=> Float
+("1" * 10).to_numeric         #=> 1111111111
+("1" * 10).to_numeric.class   #=> Bignum
+"not_numeric".to_numeric      #=> nil 
+```
+
+### Decode/encode methods
+
+```ruby
+"hello world!".decode_string(:hex)  #=> 68656c6c6f20776f726c6421
+"hi".decode_string(:bin)            #=> 0110100001101001
+
+"NBSWY3DPEB3W64TMMQQQ====".decode_string(:base32)   #=> hello world!
+"aGVsbG8gd29ybGQh\n".decode_string(:base64)         #=> hello world!  
+
+"aGVsbG8gd29ybGQh".decode_string(:base64, strict: true) #=> hello world!
+```
+
+```ruby
+"68656c6c6f20776f726c6421".decode_string(:hex)  #=> hello world!
+"0110100001101001".decode_string(:bin)          #=> hi
+
+"hello world!".decode_string(:base32)   #=> NBSWY3DPEB3W64TMMQQQ====
+"hello world!".decode_string(:base64)   #=> aGVsbG8gd29ybGQh\n  
+
+"hello world!".decode_string(:base64, strict: true) #=> aGVsbG8gd29ybGQh  
+```
+
+
+## Feel free for pull requests!

data/lib/rcore_ext.rb

@@ -0,0 +1,3 @@
+require 'rcore_ext/version'
+require 'rcore_ext/string/numeric'
+require 'rcore_ext/string/format'

data/lib/rcore_ext/string/format.rb

@@ -0,0 +1,104 @@
+require 'base64'
+require 'base32'
+
+class String
+  @@common_formats = {bin: 'B*', hex: 'H*'}
+  
+  # Decode string with various formats.
+  # Supported formats: :bin, :hex, :base32, :base64
+  #
+  # You can also pass options for Base64 to use
+  # * :strict
+  # * :url_safe
+  #
+  #   "hello world!".decode_string(:hex)  #=> 68656c6c6f20776f726c6421
+  #   "hi".decode_string(:bin)            #=> 0110100001101001
+  #
+  #   "NBSWY3DPEB3W64TMMQQQ====".decode_string(:base32)   #=> hello world!
+  #   "aGVsbG8gd29ybGQh\n".decode_string(:base64)         #=> hello world!  
+  #
+  #   "aGVsbG8gd29ybGQh".decode_string(:base64, strict: true) #=> hello world!
+  def decode_string(format, options={})
+    raise ArgumentError, "Format can't be empty" if format.nil? 
+    format = format.to_sym    
+    @options = options || {}
+
+    case format
+    when :base32
+      base32_decode
+    when :base64
+      base64_decode
+    else
+      raise ArgumentError, "Unsupported format: #{format}" unless @@common_formats.has_key?(format)
+      common_decode(format)
+    end
+  end
+
+  # Encode string with various formats.
+  # Supported formats: :bin, :hex, :base32, :base64
+  #
+  # You can also pass options for Base64 to use
+  # * :strict
+  # * :url_safe
+  #
+  #   "68656c6c6f20776f726c6421".decode_string(:hex)  #=> hello world!
+  #   "0110100001101001".decode_string(:bin)          #=> hi
+  #
+  #   "hello world!".decode_string(:base32)   #=> NBSWY3DPEB3W64TMMQQQ====
+  #   "hello world!".decode_string(:base64)   #=> aGVsbG8gd29ybGQh\n  
+  #
+  #   "hello world!".decode_string(:base64, strict: true) #=> aGVsbG8gd29ybGQh
+  def encode_string(format, options={})
+    raise ArgumentError, "Format can't be empty" if format.nil?
+    format = format.to_sym
+    @options = options || {}
+
+    case format
+    when :base32
+      base32_encode
+    when :base64
+      base64_encode
+    else
+      raise ArgumentError, "Unsupported format: #{format}" unless @@common_formats.has_key?(format)
+      common_encode(format)
+    end
+  end
+
+  private
+    def common_encode(format)
+      [self].pack(@@common_formats[format])
+    end
+
+    def common_decode(format)
+      self.unpack(@@common_formats[format]).first
+    end
+
+    def base32_encode
+      Base32.encode(self)
+    end
+
+    def base32_decode
+      Base32.decode(self)
+    end
+
+    def base64_encode
+      if @options[:strict]
+        Base64.strict_encode64(self)
+      elsif @options[:url_safe]
+        Base64.urlsafe_encode64(self)
+      else
+        Base64.encode64(self)
+      end
+    end
+
+    def base64_decode
+      if @options[:strict]
+        Base64.strict_decode64(self)
+      elsif @options[:url_safe]
+        Base64.urlsafe_decode64(self)
+      else
+        Base64.decode64(self)
+      end
+    end
+
+end

data/lib/rcore_ext/string/numeric.rb

@@ -0,0 +1,43 @@
+class String
+  # Checks a string on an Integer value
+  # 
+  #   "1".is_integer?             #=> true
+  #   "1.0".is_integer?           #=> false
+  #   "not_numeric".is_integer?   #=> false
+  def is_integer?
+    true if Integer(self) rescue false
+  end
+
+  # Checks a string on a Numeric value
+  # 
+  #   "1".is_numeric?             #=> true
+  #   "1.0".is_numeric?           #=> true
+  #   "not_numeric".is_numeric?   #=> false
+  def is_numeric?
+    true if Float(self) rescue false
+  end
+
+  # Checks a string on a Float value
+  # 
+  #   "1".is_float?             #=> false
+  #   "1.0".is_float?           #=> true
+  #   "not_numeric".is_float?   #=> false
+  def is_float?
+    return is_numeric? unless is_integer?
+    false
+  end
+
+  # Converts a string to a Numeric values (Float, Fixnum or Bignum).
+  # 
+  #   "1".to_numeric                #=> 1
+  #   "1".to_numeric.class          #=> Fixnum
+  #   "1.0".to_numeric              #=> 1.0
+  #   "1.0".to_numeric.class        #=> Float
+  #   ("1" * 10).to_numeric         #=> 1111111111
+  #   ("1" * 10).to_numeric.class   #=> Bignum
+  #   "not_numeric".to_numeric      #=> nil 
+  def to_numeric
+    return Integer(self)  if is_integer?
+    return Float(self)    if is_float?
+  end
+end

data/lib/rcore_ext/version.rb

@@ -0,0 +1,3 @@
+module RCoreExt
+  VERSION = '0.1.1'
+end

data/rcore-ext.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+$: << File.expand_path("../lib", __FILE__)
+
+require "rcore_ext/version"
+
+Gem::Specification.new do |s|
+  s.authors     = ["Bakhtiyor Homidov"]
+  s.email       = ["bakhtiyor.h@gmail.com"]
+  s.homepage    = "https://github.com/hbakhtiyor/rcore-ext"
+  s.description = %q{Ruby Core Extensions in a gem}
+  s.summary     = %q{Ruby Core Extension}
+  
+  s.rubyforge_project = "rcore-ext"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {spec}/*`.split("\n")
+  s.require_paths = ["lib"]
+  s.name          = "rcore-ext"
+  s.version       = RCoreExt::VERSION
+
+  s.add_development_dependency "rspec"
+  s.add_development_dependency "rake"
+
+  s.add_runtime_dependency "base32"
+end

data/spec/rcore_ext/string/format_spec.rb

@@ -0,0 +1,137 @@
+require 'spec_helper'
+require 'rcore_ext/string/format'
+
+describe "String formats" do
+  let(:plain_text)  { "plain text" }
+  let(:url_safe)    { "https://github.com/hbakhtiyor/rcore-ext" }
+
+  describe "respond to encode/decode methods" do
+    it "should respond to encode method" do
+      "".should respond_to :encode_string
+    end
+
+    it "should respond to decode method" do
+      "".should respond_to :decode_string
+    end
+  end
+
+  describe "raise exceptions" do
+    describe "in encode method" do
+      it "should raise exception with empty format" do
+        expect { "".encode_string }.to raise_error ArgumentError
+      end
+
+      it "should raise exception with unsupported format" do
+        expect { "".encode_string(:unsupported_format) }.to raise_error ArgumentError
+      end
+    end
+
+    describe "in decode method" do
+      it "should raise exception with empty format" do
+        expect { "".decode_string }.to raise_error ArgumentError
+      end
+
+      it "should raise exception with unsupported format" do
+        expect { "".decode_string(:unsupported_format) }.to raise_error ArgumentError
+      end
+    end   
+  end
+
+  describe "bin format" do
+    let(:bin_string) { "01110000011011000110000101101001011011100010000001110100011001010111100001110100" }
+
+    describe "decoding functionality" do
+      it "should only contain [01] characters" do
+        plain_text.decode_string(:bin).should =~ /^[01]+$/
+      end
+
+      it "should decode correctly" do
+        plain_text.decode_string(:bin).should == bin_string
+      end
+    end
+
+    describe "encoding functionality" do
+      it "should encode correctly" do
+        bin_string.encode_string(:bin).should == plain_text
+      end
+    end     
+  end
+
+  describe "hex format" do
+    let(:hex_string) { "706c61696e2074657874" }
+
+    describe "decoding functionality" do
+      it "should only contain [0-9a-f] characters" do
+        plain_text.decode_string(:hex).should =~ /^[0-9a-f]+$/i
+      end
+
+      it "should decode correctly" do
+        plain_text.decode_string(:hex).should == hex_string
+      end     
+    end
+
+    describe "encoding functionality" do
+      it "should encode correctly" do
+        hex_string.encode_string(:hex).should == plain_text
+      end     
+    end
+  end
+
+  describe "base32 format" do
+    let(:base32_string) { "OBWGC2LOEB2GK6DU" }
+
+    describe "decoding functionality" do
+      it "should decode correctly" do
+        base32_string.decode_string(:base32).should == plain_text
+      end       
+    end
+
+    describe "encoding functionality" do
+      it "should only contain [2-7a-z=] characters" do
+        plain_text.encode_string(:base32).should =~ /^[2-7a-z=]+$/i
+      end
+
+      it "should encode correctly" do
+        plain_text.encode_string(:base32).should == base32_string
+      end       
+    end   
+  end
+
+  describe "base64 format" do
+    let(:base64_string)         { "cGxhaW4gdGV4dA==\n" }
+    let(:base64_strict_string)  { "cGxhaW4gdGV4dA==" }
+    let(:base64_urlsafe_string) { "aHR0cHM6Ly9naXRodWIuY29tL2hiYWtodGl5b3IvcmNvcmUtZXh0" }
+
+    describe "decoding functionality" do
+      it "should decode correctly" do
+        base64_string.decode_string(:base64).should == plain_text
+      end
+
+      it "should decode with strict option" do
+        base64_strict_string.decode_string(:base64, strict: true).should == plain_text
+      end
+
+      it "should decode with url_safe option" do
+        base64_urlsafe_string.decode_string(:base64, url_safe: true).should == url_safe
+      end         
+    end
+
+    describe "encoding functionality" do
+      it "should only contain [0-9a-z=+/] characters" do
+        plain_text.encode_string(:base64).should =~ /^[0-9a-z=\/\+]+$/i
+      end
+
+      it "should encode correctly" do
+        plain_text.encode_string(:base64).should == base64_string
+      end
+
+      it "should decode with strict option" do
+        plain_text.encode_string(:base64, strict: true).should == base64_strict_string
+      end
+
+      it "should decode with url_safe option" do
+        url_safe.encode_string(:base64, url_safe: true).should == base64_urlsafe_string
+      end                       
+    end   
+  end
+end

data/spec/rcore_ext/string/numeric_spec.rb

@@ -0,0 +1,96 @@
+require 'spec_helper'
+require 'rcore_ext/string/numeric'
+
+describe "String numeric" do
+ 
+  let(:fix_num)      { {act: "1",              exp: 1} }
+  let(:float)        { {act: "1.0",            exp: 1.0} }
+  let(:not_numeric)  { {act: "1not_numeric1",  exp: nil} }
+  let(:big_num)      { {act: "1" * 10,         exp: 1111111111} }
+
+  describe "respond to numeric methods" do
+    it "should respond to is_integer? method" do
+      "".should respond_to :is_integer?
+    end
+
+    it "should respond to is_float? method" do
+      "".should respond_to :is_float?
+    end
+
+    it "should respond to is_numeric? method" do
+      "".should respond_to :is_numeric?
+    end
+
+    it "should respond to to_numeric method" do
+      "".should respond_to :to_numeric
+    end
+  end
+
+  describe "is_integer? method functionality" do
+    it "should be an integer value" do
+      fix_num[:act].is_integer?.should be_true
+    end
+
+    it "a big number should be an integer value" do
+      big_num[:act].is_integer?.should be_true
+    end
+
+    it "should not be an integer value" do
+      not_numeric[:act].is_integer?.should be_false
+    end
+
+    it "a float value should not be an integer value" do
+      float[:act].is_integer?.should be_false
+    end
+  end
+
+  describe "is_numeric? method functionality" do
+    it "should be a numeric value" do
+      fix_num[:act].is_numeric?.should be_true
+    end
+
+    it "a big number should be a numeric value" do
+      big_num[:act].is_numeric?.should be_true
+    end
+
+    it "should not be a numeric value" do
+      not_numeric[:act].is_numeric?.should be_false
+    end
+
+    it "a float value should be a numeric value" do
+      float[:act].is_numeric?.should be_true
+    end
+  end
+
+  describe "is_float? method functionality" do
+    it "an integer value should not be a float value" do
+      fix_num[:act].is_float?.should be_false
+    end
+
+    it "should not be a float value" do
+      not_numeric[:act].is_float?.should be_false
+    end
+
+    it "should be a float value" do
+      float[:act].is_float?.should be_true
+    end
+  end
+
+  describe "to_numeric method functionality" do
+    it "should be converted to an integer value" do
+      fix_num[:act].to_numeric.should == fix_num[:exp] 
+    end
+
+    it "should be converted to a float value" do
+      float[:act].to_numeric.should == float[:exp] 
+    end
+
+    it "should be converted to a big number value" do
+      big_num[:act].to_numeric.should == big_num[:exp]
+    end
+
+    it "should not be converted to numeric value" do
+      not_numeric[:act].to_numeric.should == not_numeric[:exp]
+    end
+  end
+end 

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification
+name: rcore-ext
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+  prerelease: 
+platform: ruby
+authors:
+- Bakhtiyor Homidov
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-03-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: base32
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby Core Extensions in a gem
+email:
+- bakhtiyor.h@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- README.md
+- lib/rcore_ext.rb
+- lib/rcore_ext/string/format.rb
+- lib/rcore_ext/string/numeric.rb
+- lib/rcore_ext/version.rb
+- rcore-ext.gemspec
+- spec/rcore_ext/string/format_spec.rb
+- spec/rcore_ext/string/numeric_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/hbakhtiyor/rcore-ext
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: rcore-ext
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Ruby Core Extension
+test_files: []