vidibus-core_extensions 0.3.3 → 0.3.4

data/.bundle/config

@@ -0,0 +1,2 @@
+--- 
+BUNDLE_DISABLE_SHARED_GEMS: "1"

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format nested

data/Gemfile

@@ -0,0 +1,5 @@
+source "http://gemcutter.org"
+
+gem "rspec", "~> 2.0.0.beta.20"
+gem "rr"
+gem "relevance-rcov"

data/Gemfile.lock

@@ -0,0 +1,22 @@
+GEM
+  remote: http://gemcutter.org/
+  specs:
+    diff-lcs (1.1.2)
+    relevance-rcov (0.9.2.1)
+    rr (1.0.0)
+    rspec (2.0.0.beta.20)
+      rspec-core (= 2.0.0.beta.20)
+      rspec-expectations (= 2.0.0.beta.20)
+      rspec-mocks (= 2.0.0.beta.20)
+    rspec-core (2.0.0.beta.20)
+    rspec-expectations (2.0.0.beta.20)
+      diff-lcs (>= 1.1.2)
+    rspec-mocks (2.0.0.beta.20)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  relevance-rcov
+  rr
+  rspec (~> 2.0.0.beta.20)

data/README.rdoc

@@ -67,6 +67,23 @@ Returns a copy of self including all but the given keys. Example:
   { :name => "Rodrigo", :age = 21 }.except(:name)  # => { :age => 21 }
 
 
+== String
+
+=== String#latinize
+
+Returns a string without exotic chars. Examples:
+  
+  "Hola señor, ¿cómo está?".latinize # => "Hola senor, como esta?"
+  "Ähre, wem Ähre gebührt.".latinize # => "AEhre, wem AEhre gebuehrt."
+
+
+=== String#permalink
+
+Returns a string that may be used as permalink. Example:
+  
+  "Hola señor, ¿cómo está?".permalink # => "hola-senor-como-esta"
+
+
 == Copyright
 
-Copyright (c) 2010 Andre Pankratz. See LICENSE for details.
+Copyright (c) 2010 Andre Pankratz. See LICENSE for details.

data/Rakefile

@@ -1,8 +1,11 @@
-require 'rubygems'
-require 'rake'
+require "rubygems"
+require "rake"
+require "rake/rdoctask"
+require "rspec"
+require "rspec/core/rake_task"
 
 begin
-  require 'jeweler'
+  require "jeweler"
   Jeweler::Tasks.new do |gem|
     gem.name = "vidibus-core_extensions"
     gem.summary = %Q{Extends the ruby core.}
@@ -10,34 +13,22 @@ begin
     gem.email = "andre@vidibus.com"
     gem.homepage = "http://github.com/vidibus/vidibus-core_extensions"
     gem.authors = ["Andre Pankratz"]
-    gem.add_development_dependency "rspec", ">= 1.2.9"
-    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
   end
   Jeweler::GemcutterTasks.new
 rescue LoadError
   puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
 end
 
-require 'spec/rake/spectask'
-Spec::Rake::SpecTask.new(:spec) do |spec|
-  spec.libs << 'lib' << 'spec'
-  spec.spec_files = FileList['spec/**/*_spec.rb']
-end
-
-Spec::Rake::SpecTask.new(:rcov) do |t|
-  t.spec_files = FileList['spec/vidibus/**/*_spec.rb']
+Rspec::Core::RakeTask.new(:rcov) do |t|
+  t.pattern = "spec/**/*_spec.rb"
   t.rcov = true
-  t.rcov_opts = ['--exclude', '^spec,/gems/']
+  t.rcov_opts = ["--exclude", "^spec,/gems/"]
 end
 
-task :spec => :check_dependencies
-task :default => :spec
-
-require "rake/rdoctask"
 Rake::RDocTask.new do |rdoc|
   version = File.exist?("VERSION") ? File.read("VERSION") : ""
   rdoc.rdoc_dir = "rdoc"
-  rdoc.title = "vidibus-uuid #{version}"
+  rdoc.title = "vidibus-core_extensions #{version}"
   rdoc.rdoc_files.include("README*")
   rdoc.rdoc_files.include("lib/**/*.rb")
   rdoc.options << "--charset=utf-8"

data/VERSION

@@ -1 +1 @@
-0.3.3
+0.3.4

data/lib/vidibus/core_extensions/array.rb

@@ -64,4 +64,4 @@ module Vidibus
       end
     end
   end
-end
+end

data/lib/vidibus/core_extensions/hash.rb

@@ -3,60 +3,79 @@ require "uri"
 module Vidibus
   module CoreExtensions
     module Hash
-
-      # Returns URL-encoded string of uri params.
-      # 
-      # Examples:
-      #  
-      #  { :some => :value, :another => "speciál" }.to_uri  # => "some=value&another=speci%C3%A1l"
-      #  { :some => { :nested => :thing } }.to_uri          # => "some=[nested=thing]"
-      #
-      def to_uri
-        list = self.to_a.map do |arg|
-          value = arg[1]
-          if value.is_a?(Hash)
-            value = "[#{value.to_uri}]"
+      module ClassMethods
+        
+        # Returns new hash with given arguments.
+        # If an array is provided, it will be flattened once. Multi-level arrays are not supported.
+        # This method is basically a helper to support different return values of Hash#select:
+        # Ruby 1.8.7 returns an array, Ruby 1.9.2 returns a hash.
+        # 
+        def build(args = nil)
+          if args.is_a?(::Array)
+            args = args.flatten_once
+            ::Hash[*args]
+          elsif args.is_a?(::Hash)
+            args
           else
-            value = URI.escape(value.to_s)
+            ::Hash.new
           end
-          "#{URI.escape(arg[0].to_s)}=#{value}"
         end
-        list.join("&")
       end
       
-      # Returns a copy of self including only the given keys.
-      #
-      # Example:
-      #
-      #   { :name => "Rodrigo", :age => 21 }.only(:name)  # => { :name => "Rodrigo" }
-      #
-      # Inspired by: 
-      # http://www.koders.com/ruby/fid80243BF76758F830B298E0E681B082B3408AB185.aspx?s=%22Rodrigo+Kochenburger%22#L9
-      # and
-      # http://snippets.dzone.com/posts/show/302
-      #
-      def only(*keys)
-        keys.flatten!
-        args = self.select { |k,v| keys.include?(k) }
-        args = args.flatten_once if args.is_a?(Array) # prior to ruby 1.9.1, Hash#select returns an array
-        self.class[*args]
-      end
+      module InstanceMethods
+
+        # Returns URL-encoded string of uri params.
+        # 
+        # Examples:
+        #  
+        #  { :some => :value, :another => "speciál" }.to_uri  # => "some=value&another=speci%C3%A1l"
+        #  { :some => { :nested => :thing } }.to_uri          # => "some=[nested=thing]"
+        #
+        def to_uri
+          list = self.to_a.map do |arg|
+            value = arg[1]
+            if value.is_a?(::Hash)
+              value = "[#{value.to_uri}]"
+            else
+              value = URI.escape(value.to_s)
+            end
+            "#{URI.escape(arg[0].to_s)}=#{value}"
+          end
+          list.join("&")
+        end
+      
+        # Returns a copy of self including only the given keys.
+        #
+        # Example:
+        #
+        #   { :name => "Rodrigo", :age => 21 }.only(:name)  # => { :name => "Rodrigo" }
+        #
+        # Inspired by: 
+        # http://www.koders.com/ruby/fid80243BF76758F830B298E0E681B082B3408AB185.aspx?s=%22Rodrigo+Kochenburger%22#L9
+        # and
+        # http://snippets.dzone.com/posts/show/302
+        #
+        def only(*keys)
+          keys.flatten!
+          args = self.select { |k,v| keys.include?(k) }
+          ::Hash.build(args)
+        end
 
-      # Returns a copy of self including all but the given keys.
-      #
-      # Example:
-      #
-      #   { :name => "Rodrigo", :age = 21 }.except(:name)  # => { :age => 21 }
-      #
-      # Inspired by: 
-      # http://www.koders.com/ruby/fid80243BF76758F830B298E0E681B082B3408AB185.aspx?s=%22Rodrigo+Kochenburger%22#L9
-      #
-      def except(*keys)
-        keys.flatten!
-        args = self.select { |k,v| !keys.include?(k) }
-        args = args.flatten_once if args.is_a?(Array) # prior to ruby 1.9.1, Hash#select returns an array
-        self.class[*args]
+        # Returns a copy of self including all but the given keys.
+        #
+        # Example:
+        #
+        #   { :name => "Rodrigo", :age = 21 }.except(:name)  # => { :age => 21 }
+        #
+        # Inspired by: 
+        # http://www.koders.com/ruby/fid80243BF76758F830B298E0E681B082B3408AB185.aspx?s=%22Rodrigo+Kochenburger%22#L9
+        #
+        def except(*keys)
+          keys.flatten!
+          args = self.select { |k,v| !keys.include?(k) }
+          ::Hash.build(args)
+        end
       end
     end
   end
-end
+end

data/lib/vidibus/core_extensions/object.rb

@@ -15,4 +15,4 @@ module Vidibus
       end
     end
   end
-end
+end

data/lib/vidibus/core_extensions/string.rb

@@ -0,0 +1,66 @@
+module Vidibus
+  module CoreExtensions
+    module String
+      
+      # Map of latin chars and their representations as unicode chars.
+      LATIN_MAP = {
+        "A"  => %w[À Á Â Ã Å Ą Ā],
+        "a"  => %w["à á â ã å ą ả ã ạ ă ắ ằ ẳ ẵ ặ â ấ ầ ẩ ẫ ậ ā],
+        "AE" => %w[Ä Æ Ǽ],
+        "ae" => %w[ä æ ǽ],
+        "C"  => %w[Ç Č Ć Ĉ],
+        "c"  => %w[ç č ć ĉ],
+        "D"  => %w[Ð],
+        "d"  => %w[đ],
+        "E"  => %w[È É Ê Ẽ Ę Ė Ē Ë],
+        "e"  => %w[è é ę ë ė ẻ ẽ ẹ ê ế ề ể ễ ệ ē],
+        "G"  => %w[Ģ],
+        "g"  => %w[ģ],
+        "I"  => %w[Ì Í Î Ï Ĩ Į Ī],
+        "i"  => %w[ì í î ï ĩ į ỉ ị ī],
+        "K"  => %w[Ķ],
+        "k"  => %w[ķ],
+        "L"  => %w[Ļ],
+        "l"  => %w[ļ],
+        "N"  => %w[Ñ Ń Ņ],
+        "n"  => %w[ñ ń ņ],
+        "O"  => %w[Ò Ó Ô Õ Ø],
+        "o"  => %w[ò ó õ ỏ õ ọ ô ố ồ ổ ỗ ộ ơ ớ ờ ở ỡ ợ ø],
+        "OE" => %w[Ö Œ],
+        "oe" => %w[ö œ],
+        "R"  => %w[Ŗ],
+        "r"  => %w[ŗ],
+        "S"  => %w[Š],
+        "s"  => %w[š],
+        "ss" => %w[ß],
+        "U"  => %w[Ù Ú Ũ Ű Ů Ũ Ų Ū Û],
+        "u"  => %w[ų ū û ú ù ű ů ủ ũ ụ ư ứ ừ ử ữ ự],
+        "UE" => %w[Ü],
+        "ue" => %w[ü],
+        "x"  => %w[×],
+        "Y"  => %w[Ý Ÿ Ŷ],
+        "y"  => %w[ý ÿ ŷ ỳ ỷ ỹ ỵ],
+        "Z"  => %w[Ž],
+        "z"  => %w[ž]
+      }.freeze
+
+      # Replaces non-latin chars, leaves some special ones.
+      def latinize
+        c = clone
+        for char, map in LATIN_MAP
+          c.gsub!(/(#{map.join('|')})/, char)
+        end
+        c.gsub(/[^a-z0-9\.\,\|\?\!\:;"'=\+\-_]+/i, " ").
+          gsub(/ {2,}/, " ")
+      end
+      
+      # Returns a string that may be used as permalink
+      def permalink
+        latinize.
+          downcase.
+          gsub(/[^a-z0-9]+/, "-").
+          gsub(/^-/, "").gsub(/-$/, "")
+      end
+    end
+  end
+end

data/lib/vidibus/core_extensions.rb

@@ -1,7 +1,10 @@
 require "core_extensions/object"
 require "core_extensions/hash"
 require "core_extensions/array"
+require "core_extensions/string"
 
 Object.send :include, Vidibus::CoreExtensions::Object
-Hash.send :include, Vidibus::CoreExtensions::Hash
-Array.send :include, Vidibus::CoreExtensions::Array
+Hash.send :extend, Vidibus::CoreExtensions::Hash::ClassMethods
+Hash.send :include, Vidibus::CoreExtensions::Hash::InstanceMethods
+Array.send :include, Vidibus::CoreExtensions::Array
+String.send :include, Vidibus::CoreExtensions::String

data/lib/vidibus-core_extensions.rb

@@ -1,2 +1,2 @@
 $:.unshift(File.join(File.dirname(__FILE__), "..", "lib", "vidibus"))
-require "core_extensions"
+require "core_extensions"

data/spec/spec_helper.rb

@@ -1,5 +1,11 @@
 $LOAD_PATH.unshift(File.dirname(__FILE__))
 $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), "..", "lib"))
+
+require "rubygems"
+require "rspec"
+require "rr"
 require "vidibus-core_extensions"
-require "spec"
-require "spec/autorun"
+
+RSpec.configure do |config|  
+  config.mock_with :rr
+end

data/spec/vidibus/core_extensions/array_spec.rb

@@ -56,4 +56,4 @@ describe "Vidibus::CoreExtensions::Array" do
       [2,'b',1,'a'].merge([5,3,6,7,1,2,4]).should eql([2,4,'b',5,3,6,7,1,'a'])
     end
   end
-end
+end

data/spec/vidibus/core_extensions/hash_spec.rb

@@ -4,7 +4,8 @@ describe "Vidibus::CoreExtensions::Hash" do
   describe "#to_uri" do
     it "should join params with '&'" do
       hash = { :some => "value", :another => "thing" }
-      hash.to_uri.should eql("some=value&another=thing")
+      parts = hash.to_uri.split("&")
+      parts.sort.should eql(['another=thing', 'some=value'])
     end
     
     it "should return items as urlencoded string" do
@@ -51,4 +52,26 @@ describe "Vidibus::CoreExtensions::Hash" do
       hash.except(:name).should eql({ :girlfriends => ["Anna", "Maria"] })
     end
   end
-end
+  
+  describe ".build" do
+    it "should return a hash" do
+      Hash.build.should eql(Hash.new)
+    end
+    
+    it "should accept a hash" do
+      Hash.build({ :do => :it }).should eql({ :do => :it })
+    end
+    
+    it "should accept an array" do
+      Hash.build([:do, :it]).should eql({ :do => :it })
+    end
+    
+    it "should accept an array and flatten it once" do
+      Hash.build([:do, [:it]]).should eql({ :do => :it })
+    end
+    
+    it "should not accept a multi-level array" do
+      expect { Hash.build([:do, [:it, [:now]]]) }.to raise_error(ArgumentError, "odd number of arguments for Hash")
+    end
+  end
+end

data/spec/vidibus/core_extensions/object_spec.rb

@@ -3,7 +3,7 @@ require "spec_helper"
 describe "Vidibus::CoreExtensions::Object" do
   describe "#try!" do
     let(:dog) do
-      Struct.new("Dog", :out)
+      Struct.new("Dog", :out) unless defined?(Struct::Dog)
       Struct::Dog.new(true)
     end
     
@@ -15,4 +15,4 @@ describe "Vidibus::CoreExtensions::Object" do
       dog.try!(:food).should be_nil
     end
   end
-end
+end

data/spec/vidibus/core_extensions/string_spec.rb

@@ -0,0 +1,65 @@
+require "spec_helper"
+
+describe "Vidibus::CoreExtensions::String" do
+  describe "::LATIN_MAP" do
+    it "should contain a Hash map" do
+      String::LATIN_MAP.should be_a(Hash)
+    end
+  end
+  
+  describe "#latinize" do
+    it "should convert diacritics" do
+      "ÀÁÂÃÄÅ Ç Ð ÈÉÊË ÌÍÎÏ Ñ ÒÓÔÕÖØ ÙÚÛÜ Ý àáâãäå ç èéêë ìíîï ñ òóôõöø ùúûü ý".latinize.should 
+        eql("AAAAAEA C D EEEE IIII N OOOOOEO UUUUE Y aaaaaea c eeee iiii n oooooeo uuuue y")
+    end
+    
+    it "should convert ligatures" do
+      "Æ".latinize.should eql("AE")
+      "ÆǼ æǽ Œ œ".latinize.should eql("AEAE aeae OE oe")
+    end
+    
+    it "should keep some regular chars" do
+      ".,|?!:;\"'=+-_".latinize.should eql(".,|?!:;\"'=+-_")
+    end
+    
+    it "should replace exotic chars by whitespace" do
+      "~÷≥≤˛`ˀð".latinize.should eql(" ")
+    end
+    
+    it "should normalize white space" do
+      "Hola señor, ¿cómo está?".latinize.should eql("Hola senor, como esta?")
+    end
+  end
+  
+  describe "#permalink" do
+    it "should call #latinize" do
+      string = "hey"
+      mock(string).latinize { string }
+      string.permalink.should eql(string)
+    end
+    
+    it "should return lower chars only" do
+      "HeLlo".permalink.should eql("hello")
+    end
+    
+    it "should turn whitespace into dashes" do
+      "hey joe".permalink.should eql("hey-joe")
+    end
+    
+    it "should turn special chars into dashes" do
+      "hi~there".permalink.should eql("hi-there")
+    end
+    
+    it "should not begin with dashes" do
+      ">duh".permalink.should eql("duh")
+    end
+    
+    it "should not end with dashes" do
+      "hi!".permalink.should eql("hi")
+    end
+    
+    it "should convert multiple adjacent special chars into a single dash" do
+      "Hola señor, ¿cómo está?".permalink.should eql("hola-senor-como-esta")
+    end
+  end
+end

data/vidibus-core_extensions.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{vidibus-core_extensions}
-  s.version = "0.3.3"
+  s.version = "0.3.4"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Andre Pankratz"]
-  s.date = %q{2010-08-17}
+  s.date = %q{2010-09-02}
   s.description = %q{Provides some extensions to the ruby core.}
   s.email = %q{andre@vidibus.com}
   s.extra_rdoc_files = [
@@ -17,8 +17,12 @@ Gem::Specification.new do |s|
      "README.rdoc"
   ]
   s.files = [
-    ".document",
+    ".bundle/config",
+     ".document",
      ".gitignore",
+     ".rspec",
+     "Gemfile",
+     "Gemfile.lock",
      "LICENSE",
      "README.rdoc",
      "Rakefile",
@@ -28,11 +32,12 @@ Gem::Specification.new do |s|
      "lib/vidibus/core_extensions/array.rb",
      "lib/vidibus/core_extensions/hash.rb",
      "lib/vidibus/core_extensions/object.rb",
-     "spec/spec.opts",
+     "lib/vidibus/core_extensions/string.rb",
      "spec/spec_helper.rb",
      "spec/vidibus/core_extensions/array_spec.rb",
      "spec/vidibus/core_extensions/hash_spec.rb",
      "spec/vidibus/core_extensions/object_spec.rb",
+     "spec/vidibus/core_extensions/string_spec.rb",
      "vidibus-core_extensions.gemspec"
   ]
   s.homepage = %q{http://github.com/vidibus/vidibus-core_extensions}
@@ -44,7 +49,8 @@ Gem::Specification.new do |s|
     "spec/spec_helper.rb",
      "spec/vidibus/core_extensions/array_spec.rb",
      "spec/vidibus/core_extensions/hash_spec.rb",
-     "spec/vidibus/core_extensions/object_spec.rb"
+     "spec/vidibus/core_extensions/object_spec.rb",
+     "spec/vidibus/core_extensions/string_spec.rb"
   ]
 
   if s.respond_to? :specification_version then
@@ -52,12 +58,9 @@ Gem::Specification.new do |s|
     s.specification_version = 3
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
     else
-      s.add_dependency(%q<rspec>, [">= 1.2.9"])
     end
   else
-    s.add_dependency(%q<rspec>, [">= 1.2.9"])
   end
 end
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: vidibus-core_extensions
 version: !ruby/object:Gem::Version 
-  hash: 21
+  hash: 27
   prerelease: false
   segments: 
   - 0
   - 3
-  - 3
-  version: 0.3.3
+  - 4
+  version: 0.3.4
 platform: ruby
 authors: 
 - Andre Pankratz
@@ -15,25 +15,10 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-08-17 00:00:00 +02:00
+date: 2010-09-02 00:00:00 +02:00
 default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: rspec
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 13
-        segments: 
-        - 1
-        - 2
-        - 9
-        version: 1.2.9
-  type: :development
-  version_requirements: *id001
+dependencies: []
+
 description: Provides some extensions to the ruby core.
 email: andre@vidibus.com
 executables: []
@@ -44,8 +29,12 @@ extra_rdoc_files:
 - LICENSE
 - README.rdoc
 files: 
+- .bundle/config
 - .document
 - .gitignore
+- .rspec
+- Gemfile
+- Gemfile.lock
 - LICENSE
 - README.rdoc
 - Rakefile
@@ -55,11 +44,12 @@ files:
 - lib/vidibus/core_extensions/array.rb
 - lib/vidibus/core_extensions/hash.rb
 - lib/vidibus/core_extensions/object.rb
-- spec/spec.opts
+- lib/vidibus/core_extensions/string.rb
 - spec/spec_helper.rb
 - spec/vidibus/core_extensions/array_spec.rb
 - spec/vidibus/core_extensions/hash_spec.rb
 - spec/vidibus/core_extensions/object_spec.rb
+- spec/vidibus/core_extensions/string_spec.rb
 - vidibus-core_extensions.gemspec
 has_rdoc: true
 homepage: http://github.com/vidibus/vidibus-core_extensions
@@ -100,3 +90,4 @@ test_files:
 - spec/vidibus/core_extensions/array_spec.rb
 - spec/vidibus/core_extensions/hash_spec.rb
 - spec/vidibus/core_extensions/object_spec.rb
+- spec/vidibus/core_extensions/string_spec.rb

data/spec/spec.opts

@@ -1,2 +0,0 @@
---color
---format nested