ruby_ext 4.0.0 → 4.0.1

data/Rakefile

@@ -7,7 +7,6 @@ project \
   name: "ruby_ext",
   gem: true,
   summary: "Ruby Extensions",
-  version: '4.0.0',
 
   author: "Alexey Petrushin",
   homepage: "http://github.com/alexeypetrushin/ruby_ext"

data/lib/rake_ext.rb

@@ -96,7 +96,44 @@ end
 #
 # Docs
 #
-desc "Generate documentation"
-task :docs do
-  %x(cd docs && rocco -o site *.rb)
+namespace :docs do
+  desc "Generate documentation"
+  task :generate do
+    %x(cd docs && rocco -o site *.rb)
+  end
+
+  desc "Publish documentation"
+  task :publish do
+    require 'open3'
+    require 'vfs'
+
+    executor = Class.new do
+      def run cmd, expectation = nil
+        stdin, stdout, stderr = Open3.popen3 cmd
+        stderr = stderr.read
+        stdout = stdout.read
+
+        if expectation and (stdout + stderr) !~ expectation
+          puts stdout
+          puts stderr
+          raise "can't execute '#{cmd}'!"
+        end
+        stdout
+      end
+    end.new
+
+    out = executor.run "git status", /nothing to commit .working directory clean/
+
+    '.'.to_dir.tmp do |tmp|
+      tmp.delete
+      "docs/site".to_dir.copy_to tmp['site']
+
+      executor.run "git checkout gh-pages", /Switched to branch 'gh-pages'/
+      tmp['site'].copy_to '.'.to_dir
+      executor.run "git add ."
+      executor.run "git commit -a -m 'upd docs'", /upd docs/
+      executor.run "git push", /gh-pages -> gh-pages/
+      executor.run "git checkout master", /Switched to branch 'master'/
+    end
+  end
 end

data/lib/rspec_ext.rb

@@ -1,142 +1,13 @@
-#
-# Code Coverage
-#
-# require 'simplecov'
-# SimpleCov.start do
-#   add_filter "/spec/"
-# end
-# SimpleCov.at_exit do
-#   SimpleCov.result.format!
-#   Kernel.exec 'open ./coverage/index.html'
-# end
-#
-# CLASS_LOADER_GENERATE_TMP_FILES = true
+# Uncomment to enable code coverage tool.
+# require 'rspec_ext/code_coverage'
 
 require 'rspec'
-require 'fileutils'
 
-RSpec.configure do |c|
-  c.filter_run focus: true
-  c.run_all_when_everything_filtered = true
-end
+require 'rspec_ext/rspec'
+require 'rspec_ext/misc'
 
-def rspec &block
-  RSpec::Core::ExampleGroup.class_eval &block if block
-  return RSpec::Core::ExampleGroup
-end
-
-rspec do
-  def self.define_matcher *args, &block
-    RSpec::Matchers.define *args do |expected|
-      match do |actual|
-        block.call actual, expected if block
-      end
-    end
-  end
-end
-
-rspec do
-  def self.before_all &block
-    before :all, &block
-  end
-
-  def self.after_all &block
-    after :all, &block
-  end
-
-  def self.with_load_path *paths
-    before_all{paths.each{|path| $LOAD_PATH << path}}
-    after_all{paths.each{|path| $LOAD_PATH.delete path}}
-  end
-
-  def with_load_path *paths, &b
-    begin
-      paths.each{|path| $LOAD_PATH << path}
-      b.call
-    ensure
-      paths.each{|path| $LOAD_PATH.delete path}
-    end
-  end
-
-  def self.with_tmp_spec_dir *args
-    options = args.last.is_a?(Hash) ? args.pop : {}
-    dir = args.first || self.spec_dir
-
-    options[:before] ||= :all
-    tmp_dir = "/tmp/#{dir.split('/').last}"
-
-    before options do
-      FileUtils.rm_r tmp_dir if File.exist? tmp_dir
-      FileUtils.cp_r dir, tmp_dir
-      @spec_dir = tmp_dir
-    end
-
-    after options do
-      FileUtils.rm_r tmp_dir if File.exist? tmp_dir
-      @spec_dir = nil
-    end
-
-    tmp_dir
-  end
-
-  def self.with_spec_dir dir
-    before_all{@spec_dir = dir}
-    after_all{@spec_dir = nil}
-  end
-
-  def self.spec_dir
-    self.calculate_default_spec_dir || raise(":spec_dir not defined!")
-  end
-
-  def spec_dir
-    @spec_dir || self.class.spec_dir
-  end
-
-  def self.calculate_default_spec_dir
-    spec_file_name = caller.find{|line| line =~ /_spec\.rb\:/}
-    return nil unless spec_file_name
-    spec_dir = spec_file_name.sub(/\.rb\:.*/, '')
-    raise "spec dir not exist (#{spec_dir})!" unless File.exist? spec_dir
-    spec_dir
-  end
-
-  def remove_constants *args
-    args = args.first if args.size == 1 and args.first.is_a?(Array)
-    args.each{|c| Object.send :remove_const, c if Object.const_defined? c}
-  end
-end
-
-
-class String
-  unless method_defined? :dirname
-    def dirname
-      File.expand_path(File.dirname(self))
-    end
-  end
-
-  def to_xhtml css = nil
-    require 'rspec_ext/nokogiri'
-
-    node = Nokogiri::HTML(self)
-    unless css
-      node
-    else
-      nodes = node.css(css)
-      raise "Elements for '#{css}' CSS query not found!" if nodes.size < 1
-      raise "Found more than one elment for '#{css}' CSS query!" if nodes.size > 1
-      nodes.first
-    end
-  end
-end
-
-# Stubbing every instances of class.
-class Class
-  def instance_stub! &block
-    new_method = method :new
-    stub! :new do |*args|
-      instance = new_method.call *args
-      block.call instance
-      instance
-    end
-  end
+# FactoryGirl replacement.
+autoload :Factory, 'rspec_ext/factory'
+def factory name = nil
+  name ? factory.build(name) : $factory ||= Factory.new
 end

data/lib/rspec_ext/code_coverage.rb

@@ -0,0 +1,9 @@
+# Code Coverage.
+require 'simplecov'
+SimpleCov.start do
+  add_filter "/spec/"
+end
+SimpleCov.at_exit do
+  SimpleCov.result.format!
+  Kernel.exec 'open ./coverage/index.html'
+end

data/lib/rspec_ext/factory.rb

@@ -0,0 +1,64 @@
+# FactoryGirl replacement (because original FactoryGirl is bloated, and
+# even more - it depends on activesupport, and this makes it too
+# unconvinient to use in non-Rails environments).
+
+class Factory
+  class Builder
+    attr_reader :name, :klass, :parent, :initializer
+
+    def initialize name, options = {}, &initializer
+      @initializer = initializer
+      @klass, @parent = options[:class], options[:parent]
+      unless klass or parent or initializer
+        raise "there are nor class nor initializer nor parent provided for :#{name}!"
+      end
+    end
+
+    def build attributes = {}, &block
+      if parent
+        o = factory.build parent
+        initializer.call o if initializer
+      elsif klass
+        real_class = self.klass.is_a?(String) ? self.klass.constantize : self.klass
+        o = real_class.new
+        initializer.call o if initializer
+      elsif initializer
+        o = initializer.call
+      end
+
+      attributes.each{|name, value| o.send :"#{name}=", value}
+      block.call o if block
+
+      o
+    end
+  end
+
+  attr_reader :registry, :counters
+
+  def initialize
+    @registry, @counters = {}, Hash.new(0)
+  end
+
+  def define name, options = {}, &initializer
+    raise "definition of :#{name} already exist!" if registry.include? name
+    registry[name] = Builder.new(name, options, &initializer)
+  end
+
+  def build name, attributes = {}, &block
+    builder = registry[name] || raise("no definition for :#{name}!")
+    builder.build attributes, &block
+  end
+  alias_method :[], :build
+
+  def create name, attributes = {}, &block
+    o = build name, attributes, &block
+    o.respond_to?(:save!) ? o.save! : o.save
+    o
+  end
+
+  def next name = :general
+    v = counters[name]
+    counters[name] += 1
+    v
+  end
+end

data/lib/rspec_ext/misc.rb

@@ -0,0 +1,22 @@
+String.class_eval do
+  unless method_defined? :dirname
+    def dirname
+      File.expand_path(File.dirname(self))
+    end
+  end
+
+  # Convert string to HTML node.
+  def to_xhtml css = nil
+    require 'rspec_ext/nokogiri'
+
+    node = Nokogiri::HTML(self)
+    unless css
+      node
+    else
+      nodes = node.css(css)
+      raise "Elements for '#{css}' CSS query not found!" if nodes.size < 1
+      raise "Found more than one elment for '#{css}' CSS query!" if nodes.size > 1
+      nodes.first
+    end
+  end
+end

data/lib/rspec_ext/rspec.rb

@@ -0,0 +1,106 @@
+# Adding filtering specs with focus.
+RSpec.configure do |c|
+  c.filter_run focus: true
+  c.run_all_when_everything_filtered = true
+end
+
+# Shortcut for extending RSpec.
+def rspec &block
+  RSpec::Core::ExampleGroup.class_eval &block if block
+  return RSpec::Core::ExampleGroup
+end
+
+# Shortcut for defining matchers.
+rspec do
+  def self.define_matcher *args, &block
+    RSpec::Matchers.define *args do |expected|
+      match do |actual|
+        block.call actual, expected if block
+      end
+    end
+  end
+end
+
+rspec do
+  def remove_constants *args
+    args = args.first if args.size == 1 and args.first.is_a?(Array)
+    args.each{|c| Object.send :remove_const, c if Object.const_defined? c}
+  end
+
+  # Before and after all shortcuts.
+  def self.before_all █ before :all, &block end
+  def self.after_all █ after :all, &block end
+
+  # Helpers for working with $LOAD_PATH.
+  def self.with_load_path *paths
+    before_all{paths.each{|path| $LOAD_PATH << path}}
+    after_all{paths.each{|path| $LOAD_PATH.delete path}}
+  end
+  def with_load_path *paths, &b
+    begin
+      paths.each{|path| $LOAD_PATH << path}
+      b.call
+    ensure
+      paths.each{|path| $LOAD_PATH.delete path}
+    end
+  end
+
+  # Helpers for working with spec directories and temp directories.
+
+  def self.with_tmp_spec_dir *args
+    options = args.last.is_a?(Hash) ? args.pop : {}
+    dir = args.first || self.spec_dir
+
+    options[:before] ||= :all
+    tmp_dir = "/tmp/#{dir.split('/').last}"
+
+    before options do
+      require 'fileutils'
+
+      FileUtils.rm_r tmp_dir if File.exist? tmp_dir
+      FileUtils.cp_r dir, tmp_dir
+      @spec_dir = tmp_dir
+    end
+
+    after options do
+      FileUtils.rm_r tmp_dir if File.exist? tmp_dir
+      @spec_dir = nil
+    end
+
+    tmp_dir
+  end
+
+  def self.with_spec_dir dir
+    before_all{@spec_dir = dir}
+    after_all{@spec_dir = nil}
+  end
+
+  def self.spec_dir
+    self.calculate_default_spec_dir || raise(":spec_dir not defined!")
+  end
+
+  def spec_dir
+    @spec_dir || self.class.spec_dir
+  end
+
+  protected
+    def self.calculate_default_spec_dir
+      spec_file_name = caller.find{|line| line =~ /_spec\.rb\:/}
+      return nil unless spec_file_name
+      spec_dir = spec_file_name.sub(/\.rb\:.*/, '')
+      raise "spec dir not exist (#{spec_dir})!" unless File.exist? spec_dir
+      spec_dir
+    end
+end
+
+# Stubbing every instances of class.
+class Class
+  def after_instantiate &block
+    new_method = method :new
+    stub! :new do |*args|
+      instance = new_method.call *args
+      block.call instance
+      instance
+    end
+  end
+end

data/lib/ruby_ext/core/array.rb

@@ -1,4 +1,6 @@
 Array.class_eval do
+  alias_method :add, :push
+
   def sfilter *filters
     filters = filters.first if filters.size == 1 and filters.first.is_a?(Array)
     filters.collect!{|o| o.is_a?(Regexp) ? o : /#{Regexp.escape o}/}

data/lib/ruby_ext/core/hash.rb

@@ -38,8 +38,6 @@ Hash.class_eval do
 
   alias_method :blank?, :empty?
 
-  alias_method :to_h, :to_hash
-
   # OpenObject.
 
   def to_openobject deep = false
@@ -53,4 +51,25 @@ Hash.class_eval do
     other == self if other.is_a? OpenObject
     eql_without_oo other
   end
+
+  class << self
+    def symbolize obj
+      convert_keys obj, :to_sym
+    end
+
+    def stringify obj
+      convert_keys obj, :to_s
+    end
+
+    protected
+      def convert_keys obj, method
+        if obj.is_a? Hash
+          {}.tap{|h| obj.each{|k, v| h[k.send(method)] = convert_keys v, method}}
+        elsif obj.is_a? Array
+          obj.collect{|v| convert_keys v, method}
+        else
+          obj
+        end
+      end
+  end
 end

data/lib/ruby_ext/core/open_object.rb

@@ -93,7 +93,6 @@ class OpenObject < Hash
       h
     end
   end
-  alias_method :to_h, :to_hash
 
   def to_json *args
     to_hash.to_json *args

data/readme.md

@@ -1,8 +1,6 @@
-Collection of various utility classes and standard library extensions for Ruby language.
-
 ## must - assertion tool, kind of RSpec assertions in runtime code
 
-Expectations are generated dynamically, so it will be also available and have the same form 
+Expectations are generated dynamically, so it will be also available and have the same form
 for any of Your custom methods.
 
 It also doesn't pollute core Ruby classes very much, there are only 2 methods `must`, `must_not` added to

data/spec/core/hash_spec.rb

@@ -0,0 +1,21 @@
+require "spec_helper"
+
+describe 'Hash' do
+  it 'should symbolize hashes in arbitrary objects' do
+    as_string = {
+      'a'   => 'a',
+      'b'   => {
+        'a' => [{'a' => 'a'}]
+      }
+    }
+    as_symbol = {
+      a: 'a',
+      b: {
+        a: [{a: 'a'}]
+      }
+    }
+
+    Hash.symbolize(as_string).should == as_symbol
+    Hash.stringify(as_symbol).should == as_string
+  end
+end

data/spec/more/must_spec.rb

@@ -41,8 +41,8 @@ describe 'Assert' do
     [].must.be_empty.should == []
   end
 
-  it "have", focus: true do
+  it "have" do
     [1, 2, 3].must_not.have_any{|v| v == 4}
-    -> {[1, 2, 3].must_not.have_any{|v| v == 2}}.should raise_error(/[1, 2, 3] must not have any/)
+    -> {[1, 2, 3].must_not.have_any{|v| v == 2}}.should raise_error(/must not have any/m)
   end
 end

data/spec/rspec_ext/factory_spec.rb

@@ -0,0 +1,50 @@
+require 'spec_helper'
+
+describe "factory" do
+  before do
+    factory.registry.clear
+    factory.counters.clear
+  end
+  after{remove_constants :User}
+
+  it "basic" do
+    factory.define :user, class: 'OpenObject' do |u|
+      u.name = 'an_user'
+    end
+
+    factory.build(:user, password: 'abc'){|u| u.roles = %w(user)}.should ==
+      {name: 'an_user', password: 'abc', roles: %w(user)}.to_openobject
+  end
+
+  it "parent" do
+    factory.define :user, class: 'OpenObject' do |u|
+      u.name = 'an_user'
+    end
+
+    factory.define :manager, parent: :user do |u|
+      u.name = 'a_manager'
+    end
+
+    factory.build(:manager, password: 'abc'){|u| u.roles = %w(manager)}.should ==
+      {name: 'a_manager', password: 'abc', roles: %w(manager)}.to_openobject
+  end
+
+  it "create" do
+    stub = self.stub
+    factory.define :user, class: stub
+    factory.define :manager, parent: :user
+
+    stub.should_receive(:new).once.and_return stub
+    stub.should_receive(:save!).once
+    factory.create :manager
+  end
+
+  it "input validations" do
+    -> {factory.define :user}.should raise_error(/provided for :user/)
+  end
+
+  it "counters" do
+    factory.next(:id).should == 0
+    factory.next(:id).should == 1
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_ext
 version: !ruby/object:Gem::Version
-  version: 4.0.0
+  version: 4.0.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-11-01 00:00:00.000000000Z
+date: 2011-11-19 00:00:00.000000000Z
 dependencies: []
 description: 
 email: 
@@ -21,7 +21,11 @@ files:
 - readme.md
 - lib/rake_ext/project.rb
 - lib/rake_ext.rb
+- lib/rspec_ext/code_coverage.rb
+- lib/rspec_ext/factory.rb
+- lib/rspec_ext/misc.rb
 - lib/rspec_ext/nokogiri.rb
+- lib/rspec_ext/rspec.rb
 - lib/rspec_ext.rb
 - lib/ruby_ext/core/array.rb
 - lib/ruby_ext/core/basic_object.rb
@@ -54,6 +58,7 @@ files:
 - spec/core/array_spec.rb
 - spec/core/deep_clone_spec.rb
 - spec/core/enumerable.rb
+- spec/core/hash_spec.rb
 - spec/core/module_spec.rb
 - spec/core/multiple_inheritance_spec.rb
 - spec/core/object_spec.rb
@@ -63,6 +68,7 @@ files:
 - spec/more/must_spec.rb
 - spec/more/observable_spec.rb
 - spec/more/open_constructor_spec.rb
+- spec/rspec_ext/factory_spec.rb
 - spec/spec_helper.rb
 homepage: http://github.com/alexeypetrushin/ruby_ext
 licenses: []