sort_alphabetical 0.1.1

data/README.markdown

@@ -0,0 +1,27 @@
+Adds `sort_alphabetical` and `sort_alphabetical_by` to Enumberable(Array/Hash...),  
+which sorts UTF8 Strings alphabetical.  
+This sorting is done by placing variants on the same level as base character (A comes before Ä but ÄA comes before AB).
+
+
+Setup
+=====
+ - As Rails plugin: `script/plugin install git://github.com/grosser/sort_alphabetical.git `
+ - As gem: ` sudo gem install sort_alphabetical `
+
+Usage
+=====
+    ['b','á'].sort_alphabetical == ['á','b']
+    [['b',1],['á',2]].sort_alphabetical_by(&:first) == [['á',2],['b',1]]
+
+TODO
+====
+ - Sort non-ascii-convertables like ß(ss), œ(oe) , fi(fi), see [Ligatures](http://en.wikipedia.org/wiki/Typographical_ligature)
+ - Integrate natural sorting e.g. `['a11', 'a2'] => ['a2', 'a11']` like [NaturalSort](http://rubyforge.org/projects/naturalsort)
+
+Authors
+=======
+ - original string_to_ascii: [Marc-Andre](http://marc-andre.ca/).
+
+[Michael Grosser](http://pragmatig.wordpress.com)  
+grosser.michael@gmail.com  
+Hereby placed under public domain, do what you want, just do not hold me accountable...  

data/Rakefile

@@ -0,0 +1,20 @@
+task :default => :spec
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new {|t| t.spec_opts = ['--color']}
+
+begin
+  project_name = 'sort_alphabetical'
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = project_name
+    gem.summary = "Sort UTF8 Strings alphabetical via Enumerable extension"
+    gem.email = "grosser.michael@gmail.com"
+    gem.homepage = "http://github.com/grosser/#{project_name}"
+    gem.authors = ["Michael Grosser"]
+    gem.add_dependency "activesupport"
+  end
+
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler, or one of its dependencies, is not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.1

data/init.rb

@@ -0,0 +1 @@
+require 'sort_alphabetical'

data/lib/sort_alphabetical.rb

@@ -0,0 +1,33 @@
+require 'rubygems'
+require 'active_support'
+require 'sort_alphabetical/core_ext'
+
+module SortAlphabetical
+  extend self
+
+  def sort(set)
+    set.sort_by do |item|
+      if block_given?
+        item = yield(item).to_s
+      else
+        item = item.to_s
+      end
+      [to_ascii(item),item]#when both á and a are present, sort them a, á
+    end
+  end
+
+  def to_ascii(string)
+    split_codepoints(string).map(&:to_s).reject{|e| e.length > 1}.join
+  end
+
+  private
+
+  # returns an array of unicode codepoints, in canonical order
+  def split_codepoints(string)
+    if defined? ActiveSupport::Multibyte::Handlers #pre ActiveSupport 2.3
+      ActiveSupport::Multibyte::Handlers::UTF8Handler.normalize(string,:d).split(//u)
+    else
+      string.mb_chars.normalize(:d).split(//u)
+    end
+  end
+end

data/lib/sort_alphabetical/core_ext.rb

@@ -0,0 +1,9 @@
+module Enumerable
+  def sort_alphabetical
+    SortAlphabetical.sort(self)
+  end
+
+  def sort_alphabetical_by(&block)
+    SortAlphabetical.sort(self,&block)
+  end
+end

data/sort_alphabetical.gemspec

@@ -0,0 +1,52 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{sort_alphabetical}
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Michael Grosser"]
+  s.date = %q{2009-11-22}
+  s.email = %q{grosser.michael@gmail.com}
+  s.extra_rdoc_files = [
+    "README.markdown"
+  ]
+  s.files = [
+    "README.markdown",
+     "Rakefile",
+     "VERSION",
+     "init.rb",
+     "lib/sort_alphabetical.rb",
+     "lib/sort_alphabetical/core_ext.rb",
+     "sort_alphabetical.gemspec",
+     "spec/README.markdown",
+     "spec/sort_alphabetical_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/grosser/sort_alphabetical}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Sort UTF8 Strings alphabetical via Enumerable extension}
+  s.test_files = [
+    "spec/spec_helper.rb",
+     "spec/sort_alphabetical_spec.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activesupport>, [">= 0"])
+    else
+      s.add_dependency(%q<activesupport>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<activesupport>, [">= 0"])
+  end
+end
+

data/spec/README.markdown

@@ -0,0 +1,2 @@
+Autotest will not work here, since both activesupport 2.1.1 and 2.3 are tested for individually.
+Simply run `rake`

data/spec/sort_alphabetical_spec.rb

@@ -0,0 +1,38 @@
+require 'spec/spec_helper'
+
+describe "SortAlphabetical"do
+  it "sorts ascii correctly" do
+    %w(b c a).sort_alphabetical.should == %w(a b c)
+  end
+
+  it "sorts UTF8 chars without accents" do
+    %w(b a á ä o ó x ö í i c).sort_alphabetical.should == %w(a á ä b c i í o ó ö x)
+  end
+
+  it "sorts by merging base with accented" do
+    %w(AA AB ÄA).sort_alphabetical.should == %w(AA ÄA AB)
+  end
+
+  it "sorts words" do
+    %w(hellö hello hellá).sort_alphabetical.should == %w(hellá hello hellö)
+  end
+
+  it "obeys order for ligatures" do
+    pending
+    %w(asb aßc asd).sort_alphabetical.should == %w(asb aßc asd)
+  end
+
+  describe :to_ascii do
+    it "removes any accents" do
+      SortAlphabetical.to_ascii('á').should == 'a'
+    end
+  end
+
+  describe :sort_alphabetical_by do
+    it "sorts using given block" do
+      silence_warnings do
+        %w(za yá xä xa).sort_alphabetical_by{|x|x.chars.to_a.reverse.join}.should == %w(xa xä yá za)
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+$LOAD_PATH << 'lib'
+require 'sort_alphabetical'

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification 
+name: sort_alphabetical
+version: !ruby/object:Gem::Version 
+  version: 0.1.1
+platform: ruby
+authors: 
+- Michael Grosser
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-11-22 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: 
+email: grosser.michael@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- README.markdown
+- Rakefile
+- VERSION
+- init.rb
+- lib/sort_alphabetical.rb
+- lib/sort_alphabetical/core_ext.rb
+- sort_alphabetical.gemspec
+- spec/README.markdown
+- spec/sort_alphabetical_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/grosser/sort_alphabetical
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Sort UTF8 Strings alphabetical via Enumerable extension
+test_files: 
+- spec/spec_helper.rb
+- spec/sort_alphabetical_spec.rb