turkish_support 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: cfd15f4f58e479f52c15d1a7b2e780534929305f
-  data.tar.gz: 6f88ae7c91ec474ab49864d1d8de5bc60549b9ab
+  metadata.gz: e462ea6658063408935a25bab7ac3ec2b4b2ec30
+  data.tar.gz: 3067e7df0ac8d20abe546c1ef2c2b11341f7bd83
 SHA512:
-  metadata.gz: 047dfa3fc477b0aea9c1429d64d5623a886189e2e900bf51622a367a9dcc7249a967838c12082f64a93f81c69c454eae69c812a51097d58ea5ca9f0cac0dff71
-  data.tar.gz: ba18883f0898f891a4aa80ad13ecf7c764755fa2603a3e38efa46d91721d5ed086015394a93a5889e3e472bcc172c67ddc635b643b7d0560b8019a05082aaff8
+  metadata.gz: ce620744b8b42db62a4dbb7b8d4cb0694145d18d3fc632a431f06479f2e8b9c85c7ef738627f0ebb211c701723caf0a581f6f2e2c0d9ee237b56bb014c53a200
+  data.tar.gz: 052a5c8edc082be0282c6412413cae98fddcf075f998ffffb346ed7d0efce472988b12ac44735a2b4f6139ca6bee310a3411400ef8dd16447858841f03ff4f67

data/README.md

@@ -3,22 +3,9 @@
 [![Gem Version](https://badge.fury.io/rb/turkish_support.svg)](http://badge.fury.io/rb/turkish_support)
 [![Build Status](https://travis-ci.org/sbagdat/turkish_support.svg?branch=master)](https://travis-ci.org/sbagdat/turkish_support)
 
-Turkish character support for some standard Ruby methods. This gem provide support for these methods:
-* `String#upcase`
-* `String#upcase!`
-* `String#downcase`
-* `String#downcase!`
-* `String#capitalize`
-* `String#capitalize!`
-* `String#swapcase`
-* `String#swapcase!`
-* `String#casecmp`
-* `Array#sort`
-* `Array#sort!`
-
-Also gives you some new methods like:
-* `String#titleize`
-* `String#titleize!`
+Turkish character support for some core ruby methods. This gem provide support for these methods: `String#upcase`,
+`String#downcase`, `String#capitalize`, `String#swapcase`, `String#casecmp`, `String#match`, `Array#sort`, `Array#sort!`,
+and their destructive versions like `String#capitalize!`. It also gives you some bonus methods like `String#titleize`.
 
 ## Requirements
 
@@ -46,46 +33,129 @@ Or install it yourself as:
 
 After the installation of the gem, you should follow these steps.
 
-* You need require it.
+### Using with ruby
 
-__Note:__ If you are using a framework like Rails, you don't need to require, because it is already required by the framework.
+* Require the gem:
 
 ```ruby
   require TurkishSupport
 ```
 
-* Add `using TurkishSupport` line to the top of the scope, __not inside of any class or module__.
+* Add `using TurkishSupport` line to where you want to activate it.
 
 ```ruby
-  using   TurkishSupport
+  using TurkishSupport
+```
+
+Example usage on the terminal:
+
+```ruby
+$ require 'turkish_support'     #=> true
+$ using TurkishSupport          #=> main
+$ 'içel'.upcase                 #=> "İÇEL"
+```
+
+Example usage inside a class:
+
+```ruby
+require 'turkish_support'
+
+class Test
+  using TurkishSupport
+  def up_me(str)
+    str.upcase
+  end
+end
+
+Test.new.up_me('içel')  #=> "İÇEL"
+```
+
+### Using with rails
+
+__Note:__ You don't need to require, because it is already required by the rails.
+
+* In rails you must add `using TurkishSupport` line to the top of the scope, __not inside of any class or module__.
+
+```ruby
+  using TurkishSupport
+
+  class SampleModel
+    ...
+  end
 ```
 
 ## Examples
 
-Within the file which you added `using TurkishSupport` line to the top of the scope; you can use core methods like below:
+Within the file that you added `using TurkishSupport` line; you can use the core methods like below:
+
+__String#upcase__ and __String#upcase!__
 
 ```ruby
   str = 'Bağcılar'
-  str.upcase  #=> "BAĞCILAR"
-  str         #=> "Bağcılar"
 
-  str = "İSMAİL"
-  str.downcase!   #=> "ismail"
-  str             #=> "ismail"
+  str.upcase    #=> "BAĞCILAR"
+  str           #=> "Bağcılar"
 
-  "merhaba".capitalize  #=> "Merhaba"
+  str.upcase!   #=> "BAĞCILAR"
+  str           #=> "BAĞCILAR"
+```
+
+__String#downcase__ and __String#downcase!__
 
-  ["iki", "üç", "dört", "ılık", "iğne", "iyne"].sort #=> ["dört", "ılık", "iğne", "iki", "iyne", "üç"]
+```ruby
+  str = 'İSMAİL'
+  str.downcase    #=> "ismail"
 ```
 
-__Note:__ If you also want to use original set of the core methods in the same scope, you can use `send` method like this:
+__String#capitalize__ and __String#capitalize!__
+
+```ruby
+  str = 'türkÇE desteĞİ'
+  str.capitalize    #=> "Türkçe desteği"
+```
+
+__String#swapcase__ and __String#swapcase!__
+```ruby
+  'TuğÇE'.swapcase    #=> "tUĞçe"
+```
+
+__String#casecmp__
+```ruby
+  'sıtKI'.casecmp('SITkı')     #=> 0
+```
+
+__String#match__
+
+```ruby
+  'Aşağı'.match(/\w+/)                         #=> #<MatchData "Aşağı">
+  'Aşağı Ayrancı'.match(/^\w+\s\w+$/)          #=> #<MatchData "Aşağı Ayrancı">
+  'aüvvağğ öövvaağ'.match(/^[a-z]+\s[a-z]+$/)  #=> #<MatchData "aüvvağğ öövvaağ">
+  'BAĞCIlar'.match(/[A-Z]+/)                   #=> #<MatchData "BAĞCI">
+  'Aşağı Ayrancı'.match(/\W+/)                 #=> #<MatchData "">
+```
+
+__Array#sort__ and __Array#sort!__
+
+```ruby
+  %w(iki üç dört ılık iğne iyne).sort
+  #=> ["dört", "ılık", "iğne", "iki", "iyne", "üç"]
+```
+
+__String#titleize__ and __String#titleize!__
+
+These methods are not core methods of ruby, but they are accepted as useful in most situation.
+
+```ruby
+  'türkÇE desteĞİ'.titleize    #=> "Türkçe Desteği"
+```
+
+__Important Note:__ If you also want to use original set of the core methods in the same scope, you can use `send` method like this:
 
 ```ruby
   str = 'Bağcılar'
   str.send(:upcase)  #=> "BAğCıLAR"
 ```
 
-
 ## Contributing
 
 1. Fork it ( http://github.com/sbagdat/turkish_support/fork )

data/lib/turkish_support.rb

@@ -1,6 +1,6 @@
-require "turkish_support/constants"
 require "turkish_support/version"
 
+require "turkish_support/constants"
 require "turkish_support/string/helpers"
 require "turkish_support/string/upcase"
 require "turkish_support/string/downcase"
@@ -8,9 +8,8 @@ require "turkish_support/string/capitalize"
 require "turkish_support/string/titleize"
 require "turkish_support/string/casecmp"
 require "turkish_support/string/swapcase"
-
+require "turkish_support/string/match"
 require "turkish_support/array/sort"
-
 require "turkish_support/destructives"
 
 module TurkishSupport

data/lib/turkish_support/constants.rb

@@ -8,4 +8,11 @@ module TurkishSupport
 
   DESTRUCTIVE_STRING_METHODS  = %i(capitalize downcase swapcase titleize upcase)
   DESTRUCTIVE_ARRAY_METHODS   = %i(sort)
+
+  MATCH_TRANSFORMATIONS = {
+    '\w' => "[#{'\w'}#{UNSUPPORTED_DOWNCASE_CHARS}#{UNSUPPORTED_UPCASE_CHARS}]",
+    '\W' => "[#{'^\w\d_'}#{UNSUPPORTED_DOWNCASE_CHARS}#{UNSUPPORTED_UPCASE_CHARS}]",
+    'a-z' => DOWNCASED_ALPHABET,
+    'A-Z' => UPCASED_ALPHABET
+  }
 end

data/lib/turkish_support/string/capitalize.rb

@@ -1,7 +1,7 @@
 module TurkishSupport
   refine String do
     def capitalize
-      [chr.change_chars_for_upcase.send(:upcase), self[1..-1]].join
+      [chr.change_chars_for_upcase.send(:upcase), self[1..-1].downcase].join
     end
   end
 end

data/lib/turkish_support/string/helpers.rb

@@ -21,6 +21,11 @@ module TurkishSupport
       unsupported_upcase? or unsupported_downcase?
     end
 
+    def transform_regex
+      MATCH_TRANSFORMATIONS.each { |k, v| self.gsub!(k, v) }
+      self
+    end
+
     alias_method :words, :split
   end
 end

data/lib/turkish_support/string/match.rb

@@ -0,0 +1,11 @@
+module TurkishSupport
+  refine String do
+    def match(pattern)
+      if pattern.kind_of? Regexp
+        pattern = pattern.inspect[1...-1]
+        pattern = Regexp.new(pattern.transform_regex)
+      end
+      send(:match, pattern)
+    end
+  end
+end

data/lib/turkish_support/version.rb

@@ -1,3 +1,3 @@
 module TurkishSupport
-  VERSION = "0.1.2"
+  VERSION = "0.2.0"
 end

data/spec/turkish_support_spec.rb

@@ -77,6 +77,11 @@ module TurkishSupport
           expect(capitalized_words).to eq(%w[Çamur Ihlamur İnsan Ördek Şahika Ümraniye])
         end
 
+        it "capitalizes the first character of a string and downcase others" do
+          capitalized_words = turkish_words.map{ |w| w.capitalize }
+          expect('türkÇE desteĞİ'.capitalize).to eq('Türkçe desteği')
+        end
+
         it "capitalizes the first character of an English string" do
           english_word = "spy"
           capitalized_string = english_word.capitalize
@@ -98,6 +103,11 @@ module TurkishSupport
         result = downcased_turkish_alphabet.casecmp(upcased_turkish_alphabet)
         expect(result).to be_zero
       end
+
+      it "compares Turkish characters correctly" do
+        result = downcased_turkish_alphabet.casecmp(upcased_turkish_alphabet)
+        expect('sıtkı'.casecmp('SıTKI')).to eq(0)
+      end
     end
 
     describe "#titleize" do
@@ -148,6 +158,25 @@ module TurkishSupport
         end
       end
     end
+
+    describe "#match" do
+      it "matches Turkish characters when regex include '\\w'" do
+        expect('Aşağı'.match(/\w+/).to_s).to eq('Aşağı')
+        expect('Aşağı Ayrancı'.match(/^\w+\s\w+$/).to_s).to eq('Aşağı Ayrancı')
+      end
+
+      it "matches Turkish characters when regex include smallcase range" do
+        expect('aüvvağğ öövvaağ'.match(/^[a-z]+\s[a-z]+$/).to_s).to eq('aüvvağğ öövvaağ')
+      end
+
+      it "matches Turkish characters when regex include uppercase range" do
+        expect('BAĞCIlar'.match(/[A-Z]+/).to_s).to eq('BAĞCI')
+      end
+
+      it "doesn't match Turkish characters when regex include '\\w'" do
+        expect('Aşağı Ayrancı'.match(/\W+/).to_s).to eq(' ')
+      end
+    end
   end
 
   describe Array do

data/turkish_support.gemspec

@@ -8,8 +8,8 @@ Gem::Specification.new do |spec|
   spec.version       = TurkishSupport::VERSION
   spec.authors       = ["Sıtkı Bağdat"]
   spec.email         = ["sbagdat@gmail.com"]
-  spec.summary       = %q{Turkish character support for some standard Ruby methods.}
-  spec.description   = %q{Turkish character support for some standard Ruby methods like #upcase, #downcase, etc. Also provide some new useful methods like #titleize.}
+  spec.summary       = %q{Turkish character support for some core ruby methods.}
+  spec.description   = %q{Turkish character support for some core ruby methods like String#upcase, String#downcase, String#match, Array#sort, and etc...}
   spec.homepage      = "https://github.com/sbagdat/turkish_support"
   spec.license       = "MIT"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: turkish_support
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Sıtkı Bağdat
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-04-06 00:00:00.000000000 Z
+date: 2014-04-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -52,8 +52,8 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: 'Turkish character support for some standard Ruby methods like #upcase,
-  #downcase, etc. Also provide some new useful methods like #titleize.'
+description: Turkish character support for some core ruby methods like String#upcase,
+  String#downcase, String#match, Array#sort, and etc...
 email:
 - sbagdat@gmail.com
 executables: []
@@ -76,6 +76,7 @@ files:
 - lib/turkish_support/string/destructives.rb
 - lib/turkish_support/string/downcase.rb
 - lib/turkish_support/string/helpers.rb
+- lib/turkish_support/string/match.rb
 - lib/turkish_support/string/swapcase.rb
 - lib/turkish_support/string/titleize.rb
 - lib/turkish_support/string/upcase.rb
@@ -106,7 +107,7 @@ rubyforge_project:
 rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
-summary: Turkish character support for some standard Ruby methods.
+summary: Turkish character support for some core ruby methods.
 test_files:
 - spec/spec_helper.rb
 - spec/turkish_support_spec.rb