ka 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d30a8c7f424c03955bafdd2d3e924c99f3b19e7d
+  data.tar.gz: e72d3226c243a6ca0c098951219d410f8e76241e
+SHA512:
+  metadata.gz: 3231301d0f0dd95e7a27589159e2e255da2802c64df8b166088bfbc0c67fe645e3185ea33c291481863fa906255147cf2b7c224ff808bbf483d6ce9843930187
+  data.tar.gz: 16dc3cf917935a9fb1a364b1ebc7944c4d33f63c0898cb3d9c07cb2979b8002cee34665d3529f28393ffa7a3f1dfa3ec2b62731f4b3ccad31c1046390c3358fb

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in ka.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Dimitri Kurashvili
+
+MIT License
+
+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.md

@@ -0,0 +1,82 @@
+# KA: write georgian sofwate with ruby
+
+There are number of occasions when you deal with uncommon situations in georgian software.
+Those are:
+
+* mobile number validation,
+* numbers to readable format (1 -> 'ერთი'), 
+* date formatting (not supported by i18n)
+* and outdated, but still active, GEO character encoding.
+
+KA gem will enable you to deal with all these situations.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'ka', 
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install ka
+
+## Usage
+
+### Mobile numbers
+
+Validation and formatting of mobile numbers are self-exmplanatory:
+
+```ruby
+require 'ka'
+include KA
+...
+mobile = 'my mobile: (595) 33 55 14'
+compact_mobile(mobile) # => '595335514'
+correct_mobile?(mobile) # => true
+format_mobile(mobile, operator_pre: '[', operator_suf: ']', by: 2, separator: ' ') #=> [595]33 55 14
+```
+
+### Number spelling
+
+`to_ka` method is integrated within `Integer` class.
+Now you can convert integers into georgian words (works upto 999,999,999,999,999).
+
+This task is often, especialy when writing some accounting software.
+
+```ruby
+1.to_ka # => ერთი
+999_999_999_999_999.to_ka # => ცხრაას ოთხმოცდა ცხრამეტი ტრილიონ ცხრაას ოთხმოცდა ცხრამეტი მილიარდ ცხრაას ოთხმოცდა ცხრამეტი მილიონ ცხრაას ოთხმოცდა ცხრამეტი ათას ცხრაას ოთხმოცდა ცხრამეტი
+```
+
+### Date formats
+
+TODO:
+
+### GEO character encoding
+
+When using the `ka` gem `String` automatically receives the `to_ka`, `to_geo` and `to_lat` methods.
+
+```ruby
+'dimitri'.to_ka(:all)  # => დიმიტრი
+'დიმიტრი'.to_lat # => dimitri
+'დიმიტრი'.to_geo # => ÃÉÌÉÔÒÉ
+```
+
+The `to_ka` method receives the additional `type` parameter which indicates which characters
+to use when converting to georgian unicode. There are three possible values for this parameter:
+
+* `geo`, convert only GEO characters (default),
+* `lat`, convert only LAT characters and
+* `all`, converts both GEO and LAT characters.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/ka.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'ka/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "ka"
+  spec.version       = Ka::VERSION
+  spec.authors       = ["Dimitri Kurashvili"]
+  spec.email         = ["dimakura@gmail.com"]
+  spec.description   = %q{georgian language functionality}
+  spec.summary       = %q{common functionality for georgian language software}
+  spec.homepage      = "http://carbon.ge"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency 'bundler', '~> 1.3'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec', '~> 2'
+end

data/lib/ka.rb

@@ -0,0 +1,5 @@
+# -*- encoding : utf-8 -*-
+require 'ka/version'
+require 'ka/mobile'
+require 'ka/string'
+require 'ka/integer'

data/lib/ka/integer.rb

@@ -0,0 +1,98 @@
+# -*- encoding : utf-8 -*-
+
+class Integer
+
+  def to_ka
+    if self < 0
+      "მინუს #{tokenize_int_ge_0(-self)}"
+    else
+      tokenize_int_ge_0(self)
+    end
+  end
+
+  private
+
+  def tokenize_int_ge_0(num)
+    case num
+    when 0 then return 'ნული'
+    when 1 then return 'ერთი'
+    when 2 then return 'ორი'
+    when 3 then return 'სამი'
+    when 4 then return 'ოთხი'
+    when 5 then return 'ხუთი'
+    when 6 then return 'ექვსი'
+    when 7 then return 'შვიდი'
+    when 8 then return 'რვა'
+    when 9 then return 'ცხრა'
+    when 10 then return 'ათი'
+    when 11 then return 'თერთმეტი'
+    when 12 then return 'თორმეტი'
+    when 13 then return 'ცამეტი'
+    when 14 then return 'თოთხმეტი'
+    when 15 then return 'თხუთმეტი'
+    when 16 then return 'თექვსმეტი'
+    when 17 then return 'ჩვიდმეტი'
+    when 18 then return 'თვრამეტი'
+    when 19 then return 'ცხრამეტი'
+    when 20 then return 'ოცი'
+    when 40 then return 'ორმოცი'
+    when 60 then return 'სამოცი'
+    when 80 then return 'ოთხმოცი'
+    when 100 then return 'ასი'
+    when 200 then return 'ორასი'
+    when 300 then return 'სამასი'
+    when 400 then return 'ოთხასი'
+    when 500 then return 'ხუთასი'
+    when 600 then return 'ექვსასი'
+    when 700 then return 'შვიდასი'
+    when 800 then return 'რვაასი'
+    when 900 then return 'ცხრაასი'
+    when 1000 then return 'ათასი'
+    when 1000000 then return 'მილიონი'
+    when 1000000000 then return 'მილიარდი'
+    when 1000000000000 then return 'ტრილიონი'
+    #else '???'
+    end
+    return "ოცდა #{tokenize_int_ge_0(num-20)}" if num > 20 and num < 40
+    return "ორმოცდა #{tokenize_int_ge_0(num-40)}" if num > 40 and num < 60
+    return "სამოცდა #{tokenize_int_ge_0(num-60)}" if num > 60 and num < 80
+    return "ოთხმოცდა #{tokenize_int_ge_0(num-80)}" if num > 80 and num < 100
+    return "ას #{tokenize_int_ge_0(num-100)}" if num > 100 and num < 200
+    return "ორას #{tokenize_int_ge_0(num-200)}" if num > 200 and num < 300
+    return "სამას #{tokenize_int_ge_0(num-300)}" if num > 300 and num < 400
+    return "ოთხას #{tokenize_int_ge_0(num-400)}" if num > 400 and num < 500
+    return "ხუთას #{tokenize_int_ge_0(num-500)}" if num > 500 and num < 600
+    return "ექვსას #{tokenize_int_ge_0(num-600)}" if num > 600 and num < 700
+    return "შვიდას #{tokenize_int_ge_0(num-700)}" if num > 700 and num < 800
+    return "რვაას #{tokenize_int_ge_0(num-800)}" if num > 800 and num < 900
+    return "ცხრაას #{tokenize_int_ge_0(num-900)}" if num > 900 and num < 1000
+    return "ათას #{tokenize_int_ge_0(num-1000)}" if num > 1000 and num < 2000
+    if num >= 2000 and num <= 999999
+      thousands = num/1000
+      rest = num - thousands * 1000
+      return "#{tokenize_int_ge_0(thousands)} ათას #{tokenize_int_ge_0(rest)}" if rest != 0
+      return "#{tokenize_int_ge_0(thousands)} ათასი" if rest == 0
+    end
+    return "მილიონ #{tokenize_int_ge_0(num-1000000)}" if num > 1000000 and num < 2000000
+    if num >= 2000000 and num <= 999999999
+      millions = num/1000000
+      rest = num - millions * 1000000
+      return "#{tokenize_int_ge_0(millions)} მილიონ #{tokenize_int_ge_0(rest)}" if rest != 0
+      return "#{tokenize_int_ge_0(millions)} მილიონი" if rest == 0
+    end
+    return "მილიარდ #{tokenize_int_ge_0(num-1000000000)}" if num > 1000000000 and num < 2000000000
+    if num >= 2000000000 and num <= 999999999999
+      billions = num/1000000000
+      rest = num - billions * 1000000000
+      return "#{tokenize_int_ge_0(billions)} მილიარდ #{tokenize_int_ge_0(rest)}" if rest != 0
+      return "#{tokenize_int_ge_0(billions)} მილიარდი"
+    end
+    if num >= 2000000000000 and num <= 999999999999999
+      billions = num/1000000000000
+      rest = num - billions * 1000000000000
+      return "#{tokenize_int_ge_0(billions)} ტრილიონ #{tokenize_int_ge_0(rest)}" if rest != 0
+      return "#{tokenize_int_ge_0(billions)} ტრილიონი"
+    end
+    return num.to_s
+  end
+end

data/lib/ka/mobile.rb

@@ -0,0 +1,41 @@
+# -*- encoding : utf-8 -*-
+module KA
+
+  # Compacts mobile number, throwing out all non-digit characters.
+  def compact_mobile(mob)
+    mob.scan(/[0-9]/).join('') if mob
+  end
+
+  # Correct mobiles are those which are 9 digits after compaction and start with the digit '5'.
+  def correct_mobile?(mob)
+    compacted = compact_mobile(mob)
+    (not not (compacted =~ /^[0-9]{9}$/)) and (compacted[0] == '5')
+  end
+
+  # Formats mobile number.
+  #
+  # The default implementation is format mobile as `(XXX)XXX-XXX`, where `X` denotes a digit.
+  #
+  # You can specify the different format using formatting options:
+  #
+  # ```
+  # mob = format_mobile('595335514', operator_pre: '[', operator_suf: ']', by: 2, separator: ' ')
+  # # => [595]33 55 14
+  # ```
+  def format_mobile(mob, h = {})
+    operator_pre = h[:operator_pre] || h['operator_pre'] || '('
+    operator_suf = h[:operator_suf] || h['operator_suf'] || ')'
+    by = h[:by] || h['by'] || 3
+    separator = h[:separator] || h['separator'] || '-'
+    mob = compact_mobile(mob)
+    operator = mob[0..2]
+    digits = mob[3..8].scan(/.{1,#{by}}/)
+    [operator_pre, operator, operator_suf, digits.join(separator)].join('')
+    #"(#{operator})#{mob[3..5]}-#{mob[6..8]}"
+  end
+
+  module_function :compact_mobile
+  module_function :correct_mobile?
+  module_function :format_mobile
+
+end

data/lib/ka/string.rb

@@ -0,0 +1,53 @@
+# -*- encoding : utf-8 -*-
+class String
+
+  # # Generates next numeric value from this string.
+  # def next_number
+  #   index = self.index(/[0-9]*$/)
+  #   if index
+  #     pref = self[0, index]
+  #     suff = self[index, self.length].to_i + 1
+  #     lnth = self.length - pref.length
+  #     %Q{#{pref}#{("%0#{lnth}d" % suff)}}
+  #   else
+  #     "#{self}1"
+  #   end
+  # end
+
+  # Translation between legacy character sets.
+
+  GEO = 'ÀÁÂÃÄÅÆÈÉÊËÌÍÏÐÑÒÓÔÖ×ØÙÚÛÜÝÞßàáãä'
+  KA  = 'აბგდევზთიკლმნოპჟრსტუფქღყშჩცძწჭხჯჰ'
+  LAT = 'abgdevzTiklmnopJrstufqRySCcZwWxjh'
+
+  def translate(from, to)
+    txt = ""
+    self.split('').each do |c|
+      indx = from.index(c)
+      txt << (indx ? to[indx] : c)
+    end
+    txt
+  end
+
+  # Translates this string into true georgian unicode symbols.
+  # Use `type` paramter to specify which type of conversion to use.
+  # Possible values for this parameters are `geo` (default), `lat` and `all`.
+  def to_ka(type = 'geo')
+    case type.to_s
+    when 'all' then self.translate("#{GEO}#{LAT}", "#{KA}#{KA}")
+    when 'lat' then self.translate(LAT, KA)
+    else self.translate(GEO, KA)
+    end
+  end
+
+  # Translates georgian into GEO encoding.
+  def to_geo
+    self.translate(KA, GEO)
+  end
+
+  # Translates georgian into LAT encoding.
+  def to_lat
+    self.translate("#{GEO}#{KA}", "#{LAT}#{LAT}")
+  end
+
+end

data/lib/ka/version.rb

@@ -0,0 +1,4 @@
+# -*- encoding : utf-8 -*-
+module Ka
+  VERSION = "0.1.0"
+end

data/spec/integer_spec.rb

@@ -0,0 +1,15 @@
+# -*- encoding : utf-8 -*-
+require 'spec_helper'
+
+describe 'integer into text' do
+  specify { 1.to_ka.should == 'ერთი' }
+  specify { 2.to_ka.should == 'ორი' }
+  specify { 20.to_ka.should == 'ოცი' }
+  specify { 25.to_ka.should == 'ოცდა ხუთი' }
+  specify { 1234.to_ka.should == 'ათას ორას ოცდა თოთხმეტი' }
+  specify { 1000_000.to_ka.should == 'მილიონი' }
+  specify { 1000_000_000.to_ka.should == 'მილიარდი' }
+  specify { 1000_000_000_000.to_ka.should == 'ტრილიონი' }
+  specify { 999.to_ka.should == 'ცხრაას ოთხმოცდა ცხრამეტი' }
+  specify { 999_999_999_999_999.to_ka.should == 'ცხრაას ოთხმოცდა ცხრამეტი ტრილიონ ცხრაას ოთხმოცდა ცხრამეტი მილიარდ ცხრაას ოთხმოცდა ცხრამეტი მილიონ ცხრაას ოთხმოცდა ცხრამეტი ათას ცხრაას ოთხმოცდა ცხრამეტი' }
+end

data/spec/mobile_spec.rb

@@ -0,0 +1,28 @@
+# -*- encoding : utf-8 -*-
+require 'spec_helper'
+include KA
+
+describe "mobile correctness" do
+  specify { correct_mobile?('595335514').should == true }
+  specify { correct_mobile?('(595)33-55-14').should == true }
+  specify { correct_mobile?('(595)335-514').should == true }
+  specify { correct_mobile?('mob: (595)335-514').should == true }
+  specify { correct_mobile?('mob: (895)335-514').should == false }
+  specify { correct_mobile?('mob: (595)335-51').should == false }
+  specify { correct_mobile?('mob: (595)335-5144').should == false }
+end
+
+describe "compacting mobile" do
+  specify { compact_mobile('595335514').should == '595335514' }
+  specify { compact_mobile('(595)335514').should == '595335514' }
+  specify { compact_mobile('(595)335-514').should == '595335514' }
+  specify { compact_mobile('mob: (595)335514').should == '595335514' }
+end
+
+describe "format mobile" do
+  specify { format_mobile('595335514').should == '(595)335-514' }
+  specify { format_mobile('(595)335514').should == '(595)335-514' }
+  specify { format_mobile('mob: (595)335514').should == '(595)335-514' }
+  specify { format_mobile('595335514', by: 1, operator_pre: '[', operator_suf: ']').should == '[595]3-3-5-5-1-4' }
+  specify { format_mobile('595335514', by: 2, separator: ' ').should == '(595)33 55 14' }
+end

data/spec/spec_helper.rb

@@ -0,0 +1,7 @@
+# -*- encoding : utf-8 -*-
+require 'rspec'
+require 'ka'
+
+RSpec.configure do |config|
+  config.include(RSpec::Matchers)
+end

data/spec/string_spec.rb

@@ -0,0 +1,8 @@
+# -*- encoding : utf-8 -*-
+require 'spec_helper'
+
+describe 'conversion' do
+  specify { 'dimitri'.to_ka(:all).should == 'დიმიტრი' }
+  specify { 'დიმიტრი'.to_lat.should == 'dimitri' }
+  specify { 'დიმიტრი'.to_geo.should == 'ÃÉÌÉÔÒÉ' }
+end

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification
+name: ka
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Dimitri Kurashvili
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-05-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2'
+description: georgian language functionality
+email:
+- dimakura@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- ka.gemspec
+- lib/ka.rb
+- lib/ka/integer.rb
+- lib/ka/mobile.rb
+- lib/ka/string.rb
+- lib/ka/version.rb
+- spec/integer_spec.rb
+- spec/mobile_spec.rb
+- spec/spec_helper.rb
+- spec/string_spec.rb
+homepage: http://carbon.ge
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: common functionality for georgian language software
+test_files:
+- spec/integer_spec.rb
+- spec/mobile_spec.rb
+- spec/spec_helper.rb
+- spec/string_spec.rb