extlib_lite 0.0.1

data/.gitignore

@@ -0,0 +1,3 @@
+*~
+rerun.txt
+

data/MIT-LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2010 David Wilkie
+
+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:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

data/README.markdown

@@ -0,0 +1,23 @@
+# extlib_lite
+
+extlib_lite is a super lightweight alternative to [activesupport](http://github.com/rails/rails/tree/master/activesupport) or [extlib](http://github.com/datamapper/extlib). It contains some of the usual friends such as pluralize, singularize, classify, and constantize without the overhead of its big brothers. I take no credit for extlib_lite, I simply extracted the code that I needed from [activesupport](http://github.com/rails/rails/tree/master/activesupport) and [extlib](http://github.com/datamapper/extlib).
+## Supported Functions
+Currently extlib_lite supports the following functions
+### String
+* pluralize
+* singularize
+* classify
+* constantize
+* underscore
+* from_query
+
+### Hash
+* to_query
+
+## Installation
+
+    gem install extlib_lite
+    require 'extlib_lite'
+
+Copyright (c) 2010 David Wilkie, released under the MIT license
+

data/Rakefile

@@ -0,0 +1,39 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the ExtlibLite plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'spec'
+  t.libs << 'features'
+  t.pattern = 'spec/**/*_spec.rb'
+  t.verbose = true
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "extlib_lite"
+    gemspec.summary = "Lightweight alternative to activesupport and extlib"
+    gemspec.email = "dwilkie@gmail.com"
+    gemspec.homepage = "http://github.com/dwilkie/extlib_lite"
+    gemspec.authors = ["David Wilkie"]
+    gemspec.add_runtime_dependency "addressable", ">=2.1.1"
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: gem install jeweler"
+end
+
+desc 'Generate documentation for the ExtlibLite plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'ExtlibLite'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/extlib_lite.gemspec

@@ -0,0 +1,50 @@
+# 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{extlib_lite}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["David Wilkie"]
+  s.date = %q{2010-07-08}
+  s.email = %q{dwilkie@gmail.com}
+  s.extra_rdoc_files = [
+    "README.markdown"
+  ]
+  s.files = [
+    ".gitignore",
+     "MIT-LICENSE",
+     "README.markdown",
+     "Rakefile",
+     "VERSION",
+     "extlib_lite.gemspec",
+     "lib/extlib_lite.rb",
+     "lib/extlib_lite/core_extensions.rb",
+     "lib/extlib_lite/core_extensions/hash.rb",
+     "lib/extlib_lite/core_extensions/string.rb",
+     "lib/extlib_lite/inflections.rb",
+     "todo"
+  ]
+  s.homepage = %q{http://github.com/dwilkie/extlib_lite}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Lightweight alternative to activesupport and extlib}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<addressable>, [">= 2.1.1"])
+    else
+      s.add_dependency(%q<addressable>, [">= 2.1.1"])
+    end
+  else
+    s.add_dependency(%q<addressable>, [">= 2.1.1"])
+  end
+end
+

data/lib/extlib_lite/core_extensions/hash.rb

@@ -0,0 +1,47 @@
+module CoreExtensions
+  module Hash
+    ##
+    # Convert to a query string
+    #
+    # {
+    #   :text_message => {
+    #     :to => 61447100308,
+    #     :from => 61447100547,
+    #     :msg => "Edin knif lie km"
+    #     :date => "2010-05-13 23:59:58"
+    #   }
+    # }.to_query #=> "text_message%5Bto%5D=61447100308&text_message%5Bfrom%5D=61447100547&text_message%5Bmsg%5D=Edin%20knif%20lie%20km&text_message%5Bdate%5D=2010-05-13%2023%3A59%3A58"
+    #
+    # @return [String] Hash converted to a query string
+    #
+    # @api public
+    def to_query
+      uri = Addressable::URI.new
+      uri.query_values = self.stringify
+      uri.query.gsub("[", "%5B").gsub("]", "%5D")
+    end
+
+    def stringify
+      Marshal.load(Marshal.dump(self)).stringify!
+    end
+
+    # Destructively convert all keys and values to strings
+    def stringify!
+      keys.each do |key|
+        new_key = key.to_s
+        self[new_key] = delete(key)
+        if self[new_key].is_a?(Hash)
+          self[new_key].stringify!
+        else
+          self[new_key] = delete(new_key).to_s
+        end
+      end
+      self
+    end
+  end
+end
+
+class Hash
+  include CoreExtensions::Hash
+end
+

data/lib/extlib_lite/core_extensions/string.rb

@@ -0,0 +1,60 @@
+module CoreExtensions
+  module String
+
+    ##
+    # Convert to hash from a query string.
+    #
+    # "text_message%5Bto%5D=61447100308&text_message%5Bfrom%5D=61447100547&text_message%5Bmsg%5D=Edin%20knif%20lie%20km&text_message%5Bdate%5D=2010-05-13%2023%3A59%3A58".from_query #=> {
+    #   "text_message"=>{
+    #     "to"=>"61447100308",
+    #     "from"=>"61447100547",
+    #     "msg"=>"Edin knif lie km",
+    #     "date"=>"2010-05-13 23:59:58"
+    #   }
+    # }
+    #
+    # @return [Hash] Query string converted to hash.
+    #
+    # @api public
+    def from_query
+      uri = Addressable::URI.new
+      uri.query = self
+      uri.query_values
+    end
+
+    ##
+    # Convert a constant name to a path, assuming a conventional structure.
+    #
+    #   "FooBar::Baz".to_const_path # => "foo_bar/baz"
+    #
+    # @return [String] Path to the file containing the constant named by receiver
+    #   (constantized string), assuming a conventional structure.
+    #
+    # @api public
+    def to_const_path
+      snake_case.gsub(/::/, "/")
+    end
+
+    ##
+    # Convert to snake case.
+    #
+    #   "FooBar".snake_case           #=> "foo_bar"
+    #   "HeadlineCNNNews".snake_case  #=> "headline_cnn_news"
+    #   "CNN".snake_case              #=> "cnn"
+    #
+    # @return [String] Receiver converted to snake case.
+    #
+    # @api public
+    def snake_case
+      return downcase if match(/\A[A-Z]+\z/)
+      gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2').
+      gsub(/([a-z])([A-Z])/, '\1_\2').
+      downcase
+    end
+  end
+end
+
+class String
+  include CoreExtensions::String
+end
+

data/lib/extlib_lite/core_extensions.rb

@@ -0,0 +1,6 @@
+require 'addressable/uri'
+# Load each available extension
+Dir["#{File.dirname(__FILE__)}/core_extensions/*.rb"].sort.each do |path|
+  require "extlib_lite/core_extensions/#{File.basename(path)}"
+end
+

data/lib/extlib_lite/inflections.rb

@@ -0,0 +1,395 @@
+module Extlib
+
+  # = English Nouns Number Inflection.
+  #
+  # This module provides english singular <-> plural noun inflections.
+  module Inflection
+
+    class << self
+      # Take an underscored name and make it into a camelized name
+      #
+      # @example
+      #   "egg_and_hams".classify #=> "EggAndHam"
+      #   "enlarged_testes".classify #=> "EnlargedTestis"
+      #   "post".classify #=> "Post"
+      #
+      def classify(name)
+        words = name.to_s.sub(/.*\./, '').split('_')
+        words[-1] = singularize(words[-1])
+        words.collect { |word| word.capitalize }.join
+      end
+
+      # The reverse of +camelize+. Makes an underscored form from the expression in the string.
+      #
+      # Changes '::' to '/' to convert namespaces to paths.
+      #
+      # @example
+      #   "ActiveRecord".underscore #=> "active_record"
+      #   "ActiveRecord::Errors".underscore #=> active_record/errors
+      #
+      def underscore(camel_cased_word)
+        camel_cased_word.to_const_path
+      end
+
+      # Constantize tries to find a declared constant with the name specified
+      # in the string. It raises a NameError when the name is not in CamelCase
+      # or is not initialized.
+      #
+      # @example
+      #   "Module".constantize #=> Module
+      #   "Class".constantize #=> Class
+      def constantize(camel_cased_word)
+        unless /\A(?:::)?([A-Z]\w*(?:::[A-Z]\w*)*)\z/ =~ camel_cased_word
+          raise NameError, "#{camel_cased_word.inspect} is not a valid constant name!"
+        end
+
+        Object.module_eval("::#{$1}", __FILE__, __LINE__)
+      end
+    end
+
+    @singular_of = {}
+    @plural_of = {}
+
+    @singular_rules = []
+    @plural_rules = []
+
+    class << self
+      # Defines a general inflection exception case.
+      #
+      # ==== Parameters
+      # singular<String>::
+      #   singular form of the word
+      # plural<String>::
+      #   plural form of the word
+      #
+      # ==== Examples
+      #
+      # Here we define erratum/errata exception case:
+      #
+      # English::Inflect.word "erratum", "errata"
+      #
+      # In case singular and plural forms are the same omit
+      # second argument on call:
+      #
+      # English::Inflect.word 'information'
+      def word(singular, plural=nil)
+        plural = singular unless plural
+        singular_word(singular, plural)
+        plural_word(singular, plural)
+      end
+
+      def clear(type = :all)
+        if type == :singular || type == :all
+          @singular_of = {}
+          @singular_rules = []
+          @singularization_rules, @singularization_regex = nil, nil
+        end
+        if type == :plural || type == :all
+          @singular_of = {}
+          @singular_rules = []
+          @singularization_rules, @singularization_regex = nil, nil
+        end
+      end
+
+
+      # Define a singularization exception.
+      #
+      # ==== Parameters
+      # singular<String>::
+      #   singular form of the word
+      # plural<String>::
+      #   plural form of the word
+      def singular_word(singular, plural)
+        @singular_of[plural] = singular
+        @singular_of[plural.capitalize] = singular.capitalize
+      end
+
+      # Define a pluralization exception.
+      #
+      # ==== Parameters
+      # singular<String>::
+      #   singular form of the word
+      # plural<String>::
+      #   plural form of the word
+      def plural_word(singular, plural)
+        @plural_of[singular] = plural
+        @plural_of[singular.capitalize] = plural.capitalize
+      end
+
+      # Define a general rule.
+      #
+      # ==== Parameters
+      # singular<String>::
+      #   ending of the word in singular form
+      # plural<String>::
+      #   ending of the word in plural form
+      # whole_word<Boolean>::
+      #   for capitalization, since words can be
+      #   capitalized (Man => Men)      #
+      # ==== Examples
+      # Once the following rule is defined:
+      # English::Inflect.rule 'y', 'ies'
+      #
+      # You can see the following results:
+      # irb> "fly".plural
+      # => flies
+      # irb> "cry".plural
+      # => cries
+      # Define a general rule.
+
+      def rule(singular, plural, whole_word = false)
+        singular_rule(singular, plural)
+        plural_rule(singular, plural)
+        word(singular, plural) if whole_word
+      end
+
+      # Define a singularization rule.
+      #
+      # ==== Parameters
+      # singular<String>::
+      #   ending of the word in singular form
+      # plural<String>::
+      #   ending of the word in plural form
+      #
+      # ==== Examples
+      # Once the following rule is defined:
+      # English::Inflect.singular_rule 'o', 'oes'
+      #
+      # You can see the following results:
+      # irb> "heroes".singular
+      # => hero
+      def singular_rule(singular, plural)
+        @singular_rules << [singular, plural]
+      end
+
+      # Define a plurualization rule.
+      #
+      # ==== Parameters
+      # singular<String>::
+      #   ending of the word in singular form
+      # plural<String>::
+      #   ending of the word in plural form
+      #
+      # ==== Examples
+      # Once the following rule is defined:
+      # English::Inflect.singular_rule 'fe', 'ves'
+      #
+      # You can see the following results:
+      # irb> "wife".plural
+      # => wives
+      def plural_rule(singular, plural)
+        @plural_rules << [singular, plural]
+      end
+
+      # Read prepared singularization rules.
+      def singularization_rules
+        if defined?(@singularization_regex) && @singularization_regex
+          return [@singularization_regex, @singularization_hash]
+        end
+        # No sorting needed: Regexen match on longest string
+        @singularization_regex = Regexp.new("(" + @singular_rules.map {|s,p| p}.join("|") + ")$", "i")
+        @singularization_hash  = Hash[*@singular_rules.flatten].invert
+        [@singularization_regex, @singularization_hash]
+      end
+
+      # Read prepared pluralization rules.
+      def pluralization_rules
+        if defined?(@pluralization_regex) && @pluralization_regex
+          return [@pluralization_regex, @pluralization_hash]
+        end
+        @pluralization_regex = Regexp.new("(" + @plural_rules.map {|s,p| s}.join("|") + ")$", "i")
+        @pluralization_hash  = Hash[*@plural_rules.flatten]
+        [@pluralization_regex, @pluralization_hash]
+      end
+
+      attr_reader :singular_of, :plural_of
+
+      # Convert an English word from plural to singular.
+      #
+      #   "boys".singular      #=> boy
+      #   "tomatoes".singular  #=> tomato
+      #
+      # ==== Parameters
+      # word<String>:: word to singularize
+      #
+      # ==== Returns
+      # <String>:: singularized form of word
+      #
+      # ==== Notes
+      # Aliased as singularize (a Railism)
+      def singular(word)
+        if result = singular_of[word]
+          return result.dup
+        end
+        result = word.dup
+        regex, hash = singularization_rules
+        result.sub!(regex) {|m| hash[m]}
+        singular_of[word] = result
+        return result
+      end
+
+      # Alias for #singular (a Railism).
+      #
+      alias_method(:singularize, :singular)
+
+      # Convert an English word from singular to plural.
+      #
+      #   "boy".plural     #=> boys
+      #   "tomato".plural  #=> tomatoes
+      #
+      # ==== Parameters
+      # word<String>:: word to pluralize
+      #
+      # ==== Returns
+      # <String>:: pluralized form of word
+      #
+      # ==== Notes
+      # Aliased as pluralize (a Railism)
+      def plural(word)
+        # special exceptions
+        return "" if word == ""
+        if result = plural_of[word]
+          return result.dup
+        end
+        result = word.dup
+        regex, hash = pluralization_rules
+        result.sub!(regex) {|m| hash[m]}
+        plural_of[word] = result
+        return result
+      end
+
+      # Alias for #plural (a Railism).
+      alias_method(:pluralize, :plural)
+    end
+
+    # One argument means singular and plural are the same.
+
+    word 'equipment'
+    word 'fish'
+    word 'grass'
+    word 'hovercraft'
+    word 'information'
+    word 'milk'
+    word 'money'
+    word 'moose'
+    word 'plurals'
+    word 'postgres'
+    word 'rain'
+    word 'rice'
+    word 'series'
+    word 'sheep'
+    word 'species'
+    word 'status'
+
+    # Two arguments defines a singular and plural exception.
+    word 'alias'      , 'aliases'
+    word 'analysis'   , 'analyses'
+    word 'axis'       , 'axes'
+    word 'basis'      , 'bases'
+    word 'buffalo'    , 'buffaloes'
+    word 'cactus'     , 'cacti'
+    word 'crisis'     , 'crises'
+    word 'criterion'  , 'criteria'
+    word 'cross'      , 'crosses'
+    word 'datum'      , 'data'
+    word 'diagnosis'  , 'diagnoses'
+    word 'drive'      , 'drives'
+    word 'erratum'    , 'errata'
+    word 'goose'      , 'geese'
+    word 'index'      , 'indices'
+    word 'life'       , 'lives'
+    word 'louse'      , 'lice'
+    word 'matrix'     , 'matrices'
+    word 'medium'     , 'media'
+    word 'mouse'      , 'mice'
+    word 'movie'      , 'movies'
+    word 'octopus'    , 'octopi'
+    word 'ox'         , 'oxen'
+    word 'phenomenon' , 'phenomena'
+    word 'plus'       , 'plusses'
+    word 'potato'     , 'potatoes'
+    word 'quiz'       , 'quizzes'
+    word 'status'     , 'status'
+    word 'status'     , 'statuses'
+    word 'Swiss'      , 'Swiss'
+    word 'testis'     , 'testes'
+    word 'thesaurus'  , 'thesauri'
+    word 'thesis'     , 'theses'
+    word 'thief'      , 'thieves'
+    word 'tomato'     , 'tomatoes'
+    word 'torpedo'    , 'torpedoes'
+    word 'vertex'     , 'vertices'
+    word 'wife'       , 'wives'
+
+    # One-way singularization exception (convert plural to singular).
+
+    # General rules.
+    rule 'person' , 'people',   true
+    rule 'shoe'   , 'shoes',    true
+    rule 'hive'   , 'hives',    true
+    rule 'man'    , 'men',      true
+    rule 'child'  , 'children', true
+    rule 'news'   , 'news',     true
+    rule 'rf'     , 'rves'
+    rule 'af'     , 'aves'
+    rule 'ero'    , 'eroes'
+    rule 'man'    , 'men'
+    rule 'ch'     , 'ches'
+    rule 'sh'     , 'shes'
+    rule 'ss'     , 'sses'
+    rule 'ta'     , 'tum'
+    rule 'ia'     , 'ium'
+    rule 'ra'     , 'rum'
+    rule 'ay'     , 'ays'
+    rule 'ey'     , 'eys'
+    rule 'oy'     , 'oys'
+    rule 'uy'     , 'uys'
+    rule 'y'      , 'ies'
+    rule 'x'      , 'xes'
+    rule 'lf'     , 'lves'
+    rule 'ffe'    , 'ffes'
+    rule 'afe'    , 'aves'
+    rule 'ouse'   , 'ouses'
+    # more cases of words ending in -oses not being singularized properly
+    # than cases of words ending in -osis
+#    rule 'osis'   , 'oses'
+    rule 'ox'     , 'oxes'
+    rule 'us'     , 'uses'
+    rule ''       , 's'
+
+    # One-way singular rules.
+
+    singular_rule 'of' , 'ofs' # proof
+    singular_rule 'o'  , 'oes' # hero, heroes
+    singular_rule 'f'  , 'ves'
+
+    # One-way plural rules.
+
+    #plural_rule 'fe' , 'ves' # safe, wife
+    plural_rule 's'   , 'ses'
+    plural_rule 'ive' , 'ives' # don't want to snag wife
+    plural_rule 'fe'  , 'ves'  # don't want to snag perspectives
+
+  end
+end
+
+class String
+  def singular
+    Extlib::Inflection.singular(self)
+  end
+  alias_method(:singularize, :singular)
+  def plural
+    Extlib::Inflection.plural(self)
+  end
+  alias_method(:pluralize, :plural)
+  def classify
+    Extlib::Inflection.classify(self)
+  end
+  def constantize
+    Extlib::Inflection.constantize(self)
+  end
+  def underscore
+    Extlib::Inflection.underscore(self)
+  end
+end
+

data/lib/extlib_lite.rb

@@ -0,0 +1,3 @@
+require 'extlib_lite/core_extensions'
+require 'extlib_lite/inflections'
+

data/todo

@@ -0,0 +1,2 @@
+Add some tests
+

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification 
+name: extlib_lite
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- David Wilkie
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-07-08 00:00:00 +07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: addressable
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 1
+        - 1
+        version: 2.1.1
+  type: :runtime
+  version_requirements: *id001
+description: 
+email: dwilkie@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- .gitignore
+- MIT-LICENSE
+- README.markdown
+- Rakefile
+- VERSION
+- extlib_lite.gemspec
+- lib/extlib_lite.rb
+- lib/extlib_lite/core_extensions.rb
+- lib/extlib_lite/core_extensions/hash.rb
+- lib/extlib_lite/core_extensions/string.rb
+- lib/extlib_lite/inflections.rb
+- todo
+has_rdoc: true
+homepage: http://github.com/dwilkie/extlib_lite
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Lightweight alternative to activesupport and extlib
+test_files: []
+