tagen 1.1.7 → 2.0.0

data/.gitignore

@@ -1,3 +1,6 @@
+/tags
+
 /*.gem
+/Gemfile
+/spec/tmp/*
 /.yardoc
-/tags

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - rbx-19mode
+script: bundle exec rspec spec

data/CHANGELOG

@@ -0,0 +1,6 @@
+*tagen 2.0.0 (Aug 28, 2012)*
+	* based on 'active_support'
+	* support 'rubinius' version
+
+	* remove 'PyFormat', 'Array#extract_extend_options[!]'
+	* change 'Time::Detal' to 'Numberic#time_humanize'

data/Gemfile

@@ -1,10 +1,9 @@
 source :rubygems
 
-gem "activesupport", "~>3.1.0"
-gem "i18n"
 gem "pd"
+gem "activesupport", "~>3.2.8"
 
-group :development do
+group :development, :test do
 	gem "rspec"
   gem "watchr"
 end

data/Gemfile.lock

@@ -1,30 +1,28 @@
 GEM
   remote: http://rubygems.org/
   specs:
-    activesupport (3.1.3)
+    activesupport (3.2.8)
+      i18n (~> 0.6)
       multi_json (~> 1.0)
-    awesome_print (1.0.2)
     diff-lcs (1.1.3)
     i18n (0.6.0)
-    multi_json (1.0.3)
-    pd (1.0.3)
-    rspec (2.7.0)
-      rspec-core (~> 2.7.0)
-      rspec-expectations (~> 2.7.0)
-      rspec-mocks (~> 2.7.0)
-    rspec-core (2.7.1)
-    rspec-expectations (2.7.0)
-      diff-lcs (~> 1.1.2)
-    rspec-mocks (2.7.0)
+    multi_json (1.3.6)
+    pd (1.1.0)
+    rspec (2.11.0)
+      rspec-core (~> 2.11.0)
+      rspec-expectations (~> 2.11.0)
+      rspec-mocks (~> 2.11.0)
+    rspec-core (2.11.1)
+    rspec-expectations (2.11.2)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.11.2)
     watchr (0.7)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  activesupport (~> 3.1.0)
-  awesome_print
-  i18n
+  activesupport (~> 3.2.8)
   pd
   rspec
   watchr

data/README.md

@@ -1,57 +1,31 @@
-Tagen, a core and extra extension to Ruby library.
-==========================================
+# Tagen, a core and extra extension for Ruby [![Build Status](https://secure.travis-ci.org/GutenYe/tagen.png)](http://travis-ci.org/GutenYe/tagen)
 
-| Homepage:      |  https://github.com/GutenYe/tagen       |
+|                |                                         |
 |----------------|-----------------------------------------|
+| Homepage:      | https://github.com/GutenYe/tagen        |
 | Author:	       | Guten                                   |
 | License:       | MIT LICENSE                             |
-| Documentation: | http://rubydoc.info/gems/tagen/frames   |
+| Documentation: | https://github.com/GutenYe/tagen/wiki   |
 | Issue Tracker: | https://github.com/GutenYe/tagen/issues |
+| Versions:      | Ruby 1.9.3, Rubinius                    |
 
-Overview
---------
-
-extensions defined in "active_support" will not appear in here, so you can use it with "active_support". 
-
-Ruby has an 'Open Class' feature, so we can extend any class by ourself.
-
-This library provides some usefull Ruby core extension.  some comes from ActiveSupport. ActiveSupport is mainly target to Rails, but tagen is target to generic ruby development, and tagen is smaller. It is a colletion of most common core,extra extensions.
-
-This library comes with a string format lib named {PyFormat}.
+It based on "active_support", but it focus on generic ruby programming.
 
 Usage
 -----
 
-use core extension
-
-	require "tagen/core"
-
-then we have Time.time method, for a list of core extensions, see {file:docs/CoreExtensions.md docs/CoreExtensions}.
-
-use extra extension
+Cherry-picking a Definition
 
-	require "tagen/pathname" # it also require "pathname"
+	require "tagen/core/array/delete_values"
 
-this will add #path method to Pathname, see API doc.
+	a = [1,2,3]
+	a.delete_values(1, 3)  -> [1, 3]
+	a                      -> [2]
 
-An Introduction to PyFormat
----------------------------
+Load All Core Extensions
 
 	require "tagen/core"
-	"I like %{fruit} and %{sport}".format('apple', 'football') 
-	"I like %{fruit} and %{sport}".format(fruit: 'apple', sport: 'football') 
 
-	"it costs %{howmatch:.2f} dollars".format(1.123) #=> "it costs 1.12 dollars"
-	
-more see API doc
-
-
-Documentation
--------------
-
-* {file:docs/CoreExtensions.md CoreExtensions} A list of core extensions.
-* {file:docs/ExtraExtensions.md ExtraExtensions} A list of extra extensions.
-* {file:docs/Architecture.md Architecture} Source code architecture.
 
 Install
 ----------
@@ -70,12 +44,19 @@ Contributors
 
 * [contributors](https://github.com/GutenYe/tagen/contributors)
 
+Resources
+---------
+
+* [activesupport](https://github.com/rails/rails/tree/master/activesupport): Utility classes and Ruby extensions from Rails
+* [hashie](https://github.com/intridea/hashie): is a simple collection of useful Hash extensions.
+* [facets](https://github.com/rubyworks/facets): is the premiere collection of general purpose method extensions and standard additions for the Ruby programming language.
+
 Copyright
 ---------
 
 (the MIT License)
 
-Copyright (c) 2011 Guten
+Copyright (c) 2011-2012 Guten
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

data/Rakefile

@@ -1,4 +1,5 @@
-sudo = Process.pid==0 ? "" : "sudo"
+require "rbconfig"
+sudo = Process.pid != 0 && RbConfig::CONFIG["host_os"] !~ /mswin|mingw/ ? "sudo" : ""
 
 desc "build a gem file"
 task :release do

data/benchmark/a.rb

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+dir = File.expand_path("../..", __FILE__)
+$:.unshift File.join(dir, "lib")
+ENV["BUNDLE_GEMFILE"] = File.join(dir, "Gemfile")
+
+require "bundler/setup"
+require "benchmark"
+
+Benchmark.bm do |b|
+  b.report %[require "tagen/core"] do
+    require "tagen/core"
+  end
+end

data/lib/tagen/core.rb

@@ -1,26 +1,21 @@
 require "pd"
 
-# from core
-%w(
-	core/kernel
-	core/object
-	core/module
+require "tagen/core/object"
+require "tagen/core/kernel"
+require "tagen/core/module"
+require "tagen/core/class"
 
-	core/enumerable
-	core/enumerator
-	core/numeric
-	core/string
-	core/array
-	core/hash
-	core/extend_hash
-	core/re
+require "tagen/core/numeric"
+require "tagen/core/integer"
+require "tagen/core/string"
+require "tagen/core/enumerable"
+require "tagen/core/enumerator"
+require "tagen/core/array"
+require "tagen/core/hash"
+require "tagen/core/time"
+require "tagen/core/exception"
+require "tagen/core/io"
+require "tagen/core/process"
+require "tagen/core/re"
 
-	core/time
-	core/io
-	core/process
-
-	core/open_option
-).each {|n| require_relative n }
-
-# from active_support
-require "active_support/core_ext"
+require "active_support/concern"

data/lib/tagen/core/array.rb

@@ -1,109 +1,5 @@
-require_relative "array/extract_options"
-=begin
-Additional method list
-----------------------
-
-* `#append` _alias from push_
-
-=end
-class Array  
-	alias append push
-
-	alias original_delete delete
-
-	# support delete more than one values.
-	#
-	# 	original: delete(v)
-	# 	currrent: delete(*v)
-	#
-	# @return [Array]
-	def delete *values, &blk
-		indexs = values.each.with_object [] do |v,m|
-			m << original_delete(v, &blk)
-		end
-		values.length==1 ? indexs[0] : indexs
-	end
-
-	alias original_delete_at delete_at
-
-	# support delate_at more than one index.
-	#
-	# 	original: delete_at(i)
-	# 	current: delte_at(*i)
-	#
-	# @return [Array] 
-	def delete_at *indexs, &blk
-		values = indexs.each.with_object [] do |i,m|
-			m << original_delete_at(i, &blk)
-		end
-		indexs.length==1 ? values[0] : values
-	end
-
-
-	# first n values, not works at Range, Range don't have #replace method
-	# @note modify IN PLACE
-	#
-	# @example
-	#   a = %w(1 2 3)
-	#   a.first!(2)  #=> [1, 2]
-	#   a            #=> [3]
-	#   @return Array
-	def first! n=1
-		i = 0 
-		j = i + n
-		k = -1
-
-		ret = self[i...j]
-		self.replace self[j..k]
-		ret
-	end
-
-	# last n values
-	# @see first!
-	def last! n=1
-		i = -1 
-		j = -1 - n + 1
-		k = 0
-
-		ret = self[j..i]
-		self.replace self[k...j]
-		ret
-	end
-
-	# same as find, but delete the finded value 
-	def find! &blk
-		idx = self.find_index(&blk)
-		if idx
-			self.delete_at(idx)
-		else
-			nil
-		end
-	end
-
-	# same as find_all, but delete all finded values
-	def find_all! &blk
-		ret, rest = [], []
-		self.each do |k|
-			if blk.call(k)
-				ret << k
-			else
-				rest << k
-			end
-		end
-		self.replace rest
-		ret
-	end
-
-  # confict with gem
-  #alias original_grep grep
-
-  # confict with awesome_print.
-  # add grep(arr rb/tage)
-  #def grep(pat_s, &blk)
-    #pats = Array===pat_s ? pat_s : [pat_s]
-    #pats.each.with_object([]) { |k, memo|
-      #memo.push *self.original_grep(k)
-    #}
-  #end
-
-end # class Array
+require "tagen/core/array/append"
+require "tagen/core/array/delete_values"
+require "tagen/core/array/extract_options"
+require "active_support/core_ext/array/wrap"
+require "active_support/core_ext/array/uniq_by"

data/lib/tagen/core/array/append.rb

@@ -0,0 +1,3 @@
+class Array  
+	alias append push
+end

data/lib/tagen/core/array/delete_values.rb

@@ -0,0 +1,43 @@
+class Array
+  # Deletes items from self.
+  #
+  # @example
+  #
+  #  a = [1, 2, 3]
+  #  a.delete_values(1, 3)     -> [1, 3]
+  #  a                         -> [2]
+	#
+	# @return [Array]
+  # @see Array#delete
+	def delete_values(*values, &blk)
+		values.each.with_object([]) {|v,m|
+			m << delete(v, &blk)
+    }
+	end
+
+  # Deletes the element at the specified indexes.
+  #
+  # @example
+  #
+  #  a = [1, 2, 3]
+  #  a.delete_values_at(0, 2)  -> [1, 3]
+  #  a                         -> [2]
+  #
+	# @return [Array] 
+  # @see Array#delete_at
+	def delete_values_at(*indexs, &blk)
+    offset = 0
+
+    # convert to positve index
+    indexs.map { |i| i < 0 ? length + i : i }
+
+		indexs.each.with_object([]) {|i,m|
+      if i > length
+        m << nil
+      else
+        m << delete_at(i-offset, &blk)
+        offset += 1
+      end
+    }
+	end
+end

data/lib/tagen/core/array/extract_options.rb

@@ -1,104 +1,45 @@
-class Array
- 
-	# extend options are symbols and hash, symbol as a boolean option.
-	#
-	#   :a #=> { a: true }
-	#   :_a #=> { a: false}
-	#
-	# @example
-	#   def foo(*args)
-	#     paths, o = args.extract_extend_options
-	#   end
-	#
-	#   foo(1, :a, :_b, :c => 2) 
-	#     #=> paths is [1]
-	#     #=> o is {a: true, b: false, c: 2}
-	#
-	# @param [Symbol, Hash] *defaults
-	# @return [Array<Object>, Hash] \[args, options]
-	def extract_extend_options *defaults
-		args, o = _parse_o(defaults)
-		args1, o1 = _parse_o(self)
-		[args+args1, o.merge(o1)]
-	end
+require "active_support/core_ext/array/extract_options"
 
-	# modify args IN PLACE.
-	# @ see extract_extend_options
-	#
+class Array
+  # Extracts options from a set of arguments. 
+  #
 	# @example
-	#   def foo(*args)
-	#     options = args.extract_extend_options!
-	#   end
-	#
-	#   foo(1, :a, :_b, c: 2)
-	#     #=> args is [1]
-	#     #=> o is {a: true, b: false, c:2}
-	#   
-	# @param [Symbol, Hash] *defaults
-	# @return [Hash] options
-	def extract_extend_options! *defaults
-		args, o = extract_extend_options *defaults
-		self.replace args
-		o
-	end
-
-	# @param [Array,Hash] args
-	def _parse_o args
-		args = args.dup
-		# name:1
-		o1 = Hash === args.last ? args.pop : {}
-		# :force :_force
-		rst = args.select{|v| Symbol===v}
-		args.delete_if{|v| Symbol===v}
-		o2={}
-		rst.each do |k|
-			v = true
-			if k=~/^_/
-				k = k[1..-1].to_sym
-				v = false
-			end
-			o2[k] = v
+  #
+  #   dirs, o = ["foo", "bar", {a: 1}].extract_options(b: 2)  
+  #     -> ["foo", "bar"], {a: 1, b: 2}
+  #
+  #   (dir,), o = ["foo", {a: 1}].extract_options 
+  #     -> "foo", {a: 1}
+  #
+	# @return [Array<Array,Hash>] 
+	# @see extract_options!
+	def extract_options(default={})
+    if last.is_a?(Hash) && last.extractable_options?
+			[self[0...-1], default.merge(self[-1])]
+		else
+			[self, default]
 		end
-		[args, o1.merge(o2)]
 	end
-	private :_parse_o
 
-	# Extracts options from a set of arguments. Removes and returns the last
-	# element in the array if it's a hash, otherwise returns a blank hash.
-	# you can also pass a default option.
-	#
-	# @example
-	#   def options(*args)
-	#     o = args.extract_options!(:a=>1)
-	#   end
-	#
-	#   options(1, 2)           # => {:a=>1}
-	#   options(1, 2, :a => :b) # => {:a=>:b}
+  # Extracts options from a set of arguments. Removes and returns the last
+  # element in the array if it's a hash, otherwise returns a blank hash.
+  #
+  # @example
+  #
+  #   def options(*args)
+  #     args.extract_options!(a: 1)
+  #   end
+  #
+  #   options(1, 2)            -> {a: 1}
+  #   options(1, 2, a: 2)      -> {a: 2}
 	#
 	# @param [Hash] default default options
 	# @return [Hash]
-	def extract_options! default={}
-		if self.last.is_a?(Hash) && self.last.instance_of?(Hash)
-			self.pop.merge default
-		else
-			default
-		end
+	def extract_options!(default={})
+    if last.is_a?(Hash) && last.extractable_options?
+      default.merge pop
+    else
+      default
+    end
 	end
-
-	# extract options
-	# @see extract_options!
-	# @example
-	#   def mkdir(*args)
-	#     paths, o = args.extract_options
-	#   end
-	#
-	# @return [Array<Array,Hash>] 
-	def extract_options default={}
-		if self.last.is_a?(Hash) && self.last.instance_of?(Hash)
-			[self[0...-1], self[-1].merge(default)]
-		else
-			[self, default]
-		end
-	end
-
 end