typogrowth 0.9.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: 8b9cc2df68d09b41d6e66c2f23267d983b3de918
+  data.tar.gz: e941117481606671b6f2761e587d2f52d7ed7561
+!binary "U0hBNTEy":
+  metadata.gz: 3a46dceca2914e0efb637b78f54d850e8426f860127aeb6d50da8f79b5c0a45a6c4ffd358632ad9578050513aa92b35cc2bee2429ad34b1b9540d6f86f39b9b3
+  data.tar.gz: 23d646481747e78b23e29ae2360854aeb3b3849a773f535d5426dae39f94c85ce81cb392a024cae8f9bbd9d90f7ca40e16d2ce0af765687e1349f2df65a85cd0

data/.document

@@ -0,0 +1,11 @@
+# .document is used by rdoc and yard to know how to generate documentation 
+# for example, it can be used to control how rdoc gets built when you do `gem install foo`
+
+README.rdoc
+lib/**/*.rb
+bin/*
+
+# Files below this - are treated as 'extra files', and aren't parsed for ruby code
+- 
+features/**/*.feature
+LICENSE

data/.gitignore

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

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.0

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Alexei Matyushkin
+
+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,61 @@
+# Typogrowth
+
+[![Build Status](https://travis-ci.org/mudasobwa/typogrowth.png)](https://travis-ci.org/mudasobwa/typogrowth)
+[![Gemnasium](https://gemnasium.com/mudasobwa/typogrowth.png?travis)](https://gemnasium.com/mudasobwa/typogrowth)
+
+Typogrowth is the simple gem, providing easy way to make string
+typographically correct. It introduce the class method:
+
+```ruby
+    Typogrowth.parse string, lang = nil
+```
+
+as well as it monkeypatches `String` class with `typo` method.
+If language is omitted, it uses `I18n.locale`. Also `:default`
+may be specified as language setting (which is english, in fact.)
+
+To modify the succession of quotation signs (as well as all the 
+others options,) feel free to change `config/typogrowth.yaml`. 
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'typogrowth'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install typogrowth
+
+## Usage
+
+```ruby
+    s = 'And God said "Baz heard "Bar" once" , and there was light.'
+    puts s.typo
+    # ⇒ And God said “Baz heard ‘Bar’ once,” and there was light.
+    puts Typogrowth.parse(s)
+    # ⇒ And God said “Baz heard ‘Bar’ once,” and there was light.
+
+    s = 'И Бог сказал: "Я - слышу "Бум" и "Бам" где-то там" , и стало светло.'
+    puts s.typo('ru')  # Explicit locale specification may be omitted
+                       #       while running under ru_RU.UTF-8 locale
+    # ⇒ И Бог сказал: «Я — слышу „Бум“ и „Бам“ где-то там», и стало светло.
+
+    s = 'And God said "Oslo coordinates are: 59°57′N 10°45′E" and there was light.'
+    s.typo!
+    # ⇒ And God said “Oslo coordinates are: 59°57′N 10°45′E” and there was light.
+    puts s 
+    # ⇒ And God said “Oslo coordinates are: 59°57′N 10°45′E” and there was light.
+```
+
+## 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,19 @@
+require 'bundler/setup'
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:examples) do |examples|
+  examples.rspec_opts = '-Ispec'
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.rspec_opts = '-Ispec'
+  spec.rcov = true
+end
+
+require 'cucumber/rake/task'
+Cucumber::Rake::Task.new(:features)
+
+task :default => :features
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/bin/typo

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+
+lib = File.expand_path(File.dirname(__FILE__) + '/../lib')
+$LOAD_PATH.unshift(lib) if File.directory?(lib) && !$LOAD_PATH.include?(lib)
+
+require 'optparse'
+require_relative '../lib/typogrowth'
+
+options = {}
+OptionParser.new do |opts|
+  opts.banner = "Usage: #{$0} FILE|STRING"
+
+  # Bowl result?
+  opts.on("-o", "--out FILE",
+          "Output file name for result") do |outfile|
+    options[:outfile] = outfile
+  end
+
+  # No argument, shows at tail.  This will print an options summary.
+  opts.on_tail("-h", "--help", "Show this message") do
+    puts opts
+    exit
+  end
+end.parse!
+
+raise "Run `#{$0} --help` for execution examples. Exiting…" if ARGV.size.zero?
+
+file_or_string = ARGV.first
+file_or_string = File.read(file_or_string) if File.exist?(file_or_string)
+
+@result = Typogrowth::parse file_or_string
+
+options[:outfile].nil? ?
+  puts(@result) :
+  File.write(options[:outfile], @result)

data/features/step_definitions/typogrowth_steps.rb

@@ -0,0 +1,40 @@
+# encoding: utf-8
+
+Given(/^the input string is "(.*?)"$/) do |str|
+  @content = str
+end
+
+When(/^input string is processed with Typogrowl’s typography parser$/) do
+  @content.gsub! /\\+"/, '"'
+  @typo = Typogrowth.parse @content
+end
+
+When(/^input string is processed with Typogrowl’s typography parser with lang "(.*?)"$/) do |lang|
+  @content.gsub! /\\+"/, '"'
+  @typo = Typogrowth.parse @content, lang
+end
+
+When(/^input string is modified inplace with typo!$/) do
+  @typoed = @content.dup
+  @typoed.typo!
+end
+
+Then(/^neither single nor double quotes are left in the string$/) do
+  @typo.scan(/"|'/).count.should == 0
+end
+
+Then(/^the typoed result should equal to "(.*?)"$/) do |str|
+  @typo.should == str
+end
+
+Then(/^the call to string’s typo should equal to "(.*?)"$/) do |str|
+  @content.typo.should == str
+end
+
+Then(/^the call to string’s typo with lang "(.*?)" should equal to "(.*?)"$/) do |lang, str|
+  @content.typo('ru').should == str
+end
+
+Then(/^typoed result should equal to "(.*?)"$/) do |str|
+  @typoed.should == str
+end

data/features/support/env.rb

@@ -0,0 +1,5 @@
+require 'bundler/setup'
+
+require 'typogrowth'
+
+require 'rspec/expectations'

data/features/typogrowth.feature

@@ -0,0 +1,54 @@
+Feature: Text is to be typographed (spacing and pubctuation are to be sanitized)
+
+  # Known bug: see last example in first scenario outline
+  Scenario Outline: Quotes and punctuation in English
+    Given the input string is <input>
+    When input string is processed with Typogrowl’s typography parser
+    Then the typoed result should equal to <output>
+    And the call to string’s typo should equal to <output>
+    And neither single nor double quotes are left in the string
+
+    Examples:
+        | input                          | output                             |
+        | "And God said \"∇×(∇×F) = ∇(∇·F) − ∇2F\" and there was light." | "And God said “∇×(∇×F) = ∇(∇·F) − ∇2F” and there was light." |
+        | "And God said \"I--heard \"Booh \"Bah\" Booh\" and \"Bam\" in heaven\" and there was light." | "And God said “I—heard ‘Booh “Bah” Booh’ and ‘Bam’ in heaven” and there was light." |
+        | "And God said \"I - heard \"Booh Bah Booh\" and \"Bam\" in heaven\" and there was light." | "And God said “I—heard ‘Booh Bah Booh’ and ‘Bam’ in heaven” and there was light." |
+        | "And God said \"Oslo coordinates are: 59°57′N 10°45′E\" and there was light." | "And God said “Oslo coordinates are: 59°57′N 10°45′E” and there was light." |
+        | "And God said \"That's a 6.3\" man, he sees sunsets at 10°20'30\" E.\" and there was light." | "And God said “That’s a 6.3″ man, he sees sunsets at 10°20′30″ E.” and there was light." |
+        | "And God said \"Foo\" , and there was light." | "And God said “Foo,” and there was light." |
+        | "And God said \"Baz heard 'Foos' Bar' once\" , and there was light." | "And God said “Baz heard ‘Foos’ Bar’ once,” and there was light." |
+        | "And God, loving ellipsis, said.... And..." | "And God, loving ellipsis, said… And…" |
+
+  Scenario Outline: Quotes and punctuation in Russian
+    Given the input string is <input>
+    When input string is processed with Typogrowl’s typography parser with lang "ru"
+    Then the typoed result should equal to <output>
+    And the call to string’s typo with lang "ru" should equal to <output>
+    And neither single nor double quotes are left in the string
+
+    Examples:
+        | input                          | output                             |
+        | "И Бог сказал: \"Я - слышу \"Бум\" и \"Бам\" где-то там\" , и стало светло." | "И Бог сказал: «Я — слышу „Бум“ и „Бам“ где-то там», и стало светло." |
+        | "И Бог сказал: \"Я - слышу \"Бум \"и\" Бам\" где-то там\" , и стало светло." | "И Бог сказал: «Я — слышу „Бум «и» Бам“ где-то там», и стало светло." |
+        | "Строка со ссылкой: http://wikipedia.org (ссылка)." | "Строка со ссылкой: http://wikipedia.org (ссылка)." | 
+ 
+  Scenario Outline: Spacing before/after punctuation
+    Given the input string is <input>
+    When input string is processed with Typogrowl’s typography parser
+    Then the typoed result should equal to <output>
+    And the call to string’s typo should equal to <output>
+
+    Examples:
+        | input                                  | output                                |
+        | "It’s raining.Pity."                   | "It’s raining. Pity."                 |
+        | "It’s raining . Pity."                 | "It’s raining. Pity."                 |
+        | "It’s raining   .Pity."                | "It’s raining. Pity."                 |
+        | "Link http://wikipedia.org here."      | "Link http://wikipedia.org here."     |
+        | "Here is http://wikipedia.org. See?."  | "Here is http://wikipedia.org. See?." |
+        | "Here is exclamation ellipsis!.."      | "Here is exclamation ellipsis!.."     |
+        | "Here is exclamation ellipsis! . ."    | "Here is exclamation ellipsis!.."     |
+
+  Scenario: Inplace string modification
+    Given the input string is "Foo 'Bar' Baz"
+    When input string is modified inplace with typo!
+    Then typoed result should equal to "Foo “Bar” Baz"

data/lib/config/typogrowth.yaml

@@ -0,0 +1,132 @@
+:quotes :
+  :punctuation :
+    :re : '(?<quote>''|"|\))\s*(?<punct>[.,!?]+)'
+    :default :
+      - '\k<punct>\k<quote>'
+    :ru :
+      - '\k<quote>\k<punct>'
+
+  # That's a 6.3" man, he sees sunsets at 10°20'30" E.
+  #             ⇑
+  :inch :
+    :pattern : '"'
+    :re : '(?:\p{Space}[\.,\p{Digit}]+)(")(?=\p{Space}|\Z)'
+    :default :
+      - '″'
+  # That's a 6.3" man, he sees sunsets at 10°20'30" E.
+  #                                               ⇑
+  :seconds :
+    :pattern : '"'
+    :re : '(?:\p{Space}[°''’′\p{Digit}]+)(")(?=\p{Space}|\p{Alpha}|\Z)'
+    :default :
+      - '″'
+
+  # That's a 6.3" man, he sees sunsets at 10°20'30" E.
+  #                                            ⇑
+  :minutes :
+    :pattern : ''''
+    :re : '(\p{Space}[°\p{Digit}]+)('')(?=\p{Space}|\p{Alnum}|\Z)'
+    :default :
+      - '′'
+
+  # That's a 6.3" man, he sees sunsets at 10°20'30" E.
+  #     ⇑
+  :apostrophe_pre :
+    :pattern : ''''
+    :re : '(?<=\p{Alpha})('')(?=\p{Alpha})'
+    :default : 
+      - '♻'
+  # And God said 'Foos' game is over'.
+  #                  ⇑
+  :apostrophe_squeez :
+    :pattern : ''''
+    :re : '(?<=s)('')(?=\s)'
+    :default : 
+      - '♻'
+  # And God said "∇×(∇×F) = ∇(∇·F) − ∇2F" and there was light.
+  #              ⇑
+  :left :
+    :original : '''"'
+    :re : '(?<=\p{Space}|\A)(?<m>"|'')(?=\p{Graph}|\Z)'
+    :compliant : 'right'
+    # Nested quotation marks are chosen if it’s an even occurence
+    :default :
+      - '“'
+      - '‘'
+#      - '〈'
+    :ru :
+      - '«'
+      - '„'
+    :us :
+      - '‘'
+      - '“'
+  # And God said "∇×(∇×F) = ∇(∇·F) − ∇2F" and there was light.
+  #                                     ⇑
+  :right :
+    :slave : true
+    :original : '''"'
+    :re : '(?<=\p{L}|\p{M}|\p{P})(?<m>"|'')(?=\p{Space}|\p{P}|\Z)'
+    :compliant : 'left'
+    # Nested quotation marks are chosen if it’s an odd occurence
+    :default :
+      - '”'
+      - '’'
+#      - '〉'
+    :ru :
+      - '»'
+      - '“'
+    :us :
+      - '’'
+      - '”'
+
+  # That's a 6.3" man, he sees sunsets at 10°20'30" E.
+  #     ⇑
+  :apostrophe_post :
+    :pattern : '♻'
+    :re : '♻'
+    :default :
+      - '’'
+
+  :alone_single :
+    :re : '('')'
+    :alert: true
+    :default :
+      - '’'
+
+  :alone_double :
+    :re : '(")'
+    :alert: true
+    :default :
+      - '”'
+
+:others :
+  :ellipsis :
+    :re : '\.{3,}'
+    :default :
+      - '…'
+  :mdash :
+    :re : '\s*(?<dash> - |--)\s*'
+    :default :
+      - '—'
+    :ru :
+      - ' — '
+    :us :
+      - ' – '
+
+:punctuation :
+  :opening_orphan :
+    :re : '([(¿¡§#№]|\p{Sc})(?:\s)*'
+    :default :
+      - '\1'
+  :closing_orphan :
+    :re : '(?:\s)*([.,:;!?)])'
+    :default :
+      - '\1'
+  :closing_clamped :
+    :re : '([.,:;!?)])(?=\p{Lu})'
+    :default :
+      - '\1 '
+  :fixup :
+    :re : '([!?.]+)(?:\s*)(\.+)'
+    :default :
+      - '\1\2'

data/lib/typogrowth/string.rb

@@ -0,0 +1,17 @@
+# encoding: utf-8
+
+require 'i18n'
+require_relative '../typogrowth'
+
+class String
+  # Typographyes the string and returns a result
+  # See Typogrowth::Parser#parse
+  def typo lang = nil
+    Typogrowth::Parser.parse(self, lang ? lang : I18n.locale)
+  end
+  # Typographyes the string inplace
+  # See Typogrowth::Parser#parse!
+  def typo! lang = nil
+    Typogrowth::Parser.parse!(self, lang ? lang : I18n.locale)
+  end
+end

data/lib/typogrowth/version.rb

@@ -0,0 +1,3 @@
+module Typogrowth
+  VERSION = "0.9.0"
+end

data/lib/typogrowth.rb

@@ -0,0 +1,145 @@
+# encoding: utf-8
+
+require 'yaml'
+
+require 'uri'
+require 'base64'
+require_relative 'typogrowth/version'
+require_relative 'typogrowth/string'
+require_relative 'utils/hash_recursive_merge'
+
+# 
+# = String typographing with language support. 
+# 
+# Parses and corrects the typography in strings. It supports 
+# different language rules and user rules customization.
+# 
+# The package also monkeypatches `String` class with both
+# `typo` and `typo!` methods.
+# 
+# Category::    Ruby
+# Author::      Alexei Matyushkin <am@mudasobwa.ru>
+# Copyright::   2013 The Authors
+# License::     MIT License
+# Link::        http://rocket-science.ru/
+# Source::      http://github.com/mudasobwa/typogrowth
+#
+module Typogrowth
+  # Internal exception class just to make the exception distinction possible
+  class MalformedRulesFile < Exception ; end
+  
+  # Parses and corrects the typography in strings. It supports 
+  # different language rules and easy user rules customization.
+  class Parser
+    attr_reader :yaml
+    
+    #
+    # Recursively merges the initial settings with custom.
+    # 
+    # To supply your own rules to processing:
+    # 
+    # - create a +hash+ of additional rules in the same form as in the 
+    # standard `typogrowth.yaml` file shipped with a project
+    # - merge the hash with the standard one using this function
+    # 
+    # For instance, to add french rules one is to merge in the following yaml:
+    # 
+    #     :quotes :
+    #       :punctuation :
+    #         :fr : "\\k<quote>\\k<punct>"
+    #     …
+    #
+    def self.merge custom
+      instance.yaml.rmerge!(custom)
+    end
+    
+    #
+    # Inplace version of string typographying.
+    # 
+    # Retrieves the string and changes all the typewriters quotes (doubles
+    # and sigles), to inches, minutes, seconds, proper quotation signs.
+    # 
+    # While the input strings are e.g. 
+    #     
+    #     And God said "Baz heard "Bar" once" , and there was light.
+    #     That's a 6.3" man, he sees sunsets at 10°20'30" E.
+    #     
+    # It will produce:
+    # 
+    #     And God said “Baz heard ‘Bar’ once,” and there was light.
+    #     That’s a 6.3″ man, he sees sunsets at 10°20′30″ E.
+    #     
+    # The utility also handles dashes as well.
+    # 
+    # @param str [String] the string to be typographyed inplace
+    # @param lang the language to use rules for
+    #
+    def self.parse str, lang = :default
+      lang = lang.to_sym
+      str.split(/\R{2,}/).map { |para|
+        para.gsub(URI.regexp) { |m| "⚓#{Base64.encode64 m}⚓" }
+        instance.yaml.each { |k, values|
+          values.each { |k, v|
+            if !!v[:re]
+              v[lang] = v[:default] if (!v[lang] || v[lang].size.zero?)
+              raise MalformedRulesFile.new "Malformed rules file (no subst for #{v})" \
+                if !v[lang] || v[lang].size.zero?
+              substituted = !!v[:pattern] ?
+                  para.gsub!(/#{v[:re]}/) { |m| m.gsub(/#{v[:pattern]}/, v[lang].first) } :
+                  para.gsub!(/#{v[:re]}/, v[lang].first)
+              # logger.warn "Unsafe substitutions were made to source:\n# ⇒ #{para}"\
+              #  if v[:alert] && substituted
+              if v[lang].size > 1
+                para.gsub!(/#{v[lang].first}/) { |m|
+                  prev = $`
+                  obsoletes = prev.count(v[lang].join)
+                  compliants = values[v[:compliant].to_sym][lang] || 
+                               values[v[:compliant].to_sym][:default]
+                  obsoletes -= prev.count(compliants.join) \
+                    if !!v[:compliant]
+                  !!v[:slave] ?
+                    obsoletes -= prev.count(v[:original]) + 1 :
+                    obsoletes += prev.count(v[:original])
+                  
+                  v[lang][obsoletes % v[lang].size]
+                }
+              end
+            end
+          }
+        }
+        para
+      }.join(%Q(
+
+))
+      .gsub(/⚓(.*)⚓/m) { |m| Base64.decode64 m }
+    end
+
+    # Out-of-place version of `String` typographing. See #parse!
+    def self.parse! str, lang = :default
+      str.replace self.parse(str, lang)
+    end
+  private
+    DEFAULT_SET = 'typogrowth'
+    
+    def initialize file
+      @yaml = YAML.load_file "#{File.dirname(__FILE__)}/config/#{file}.yaml"
+      @yaml.delete(:placeholder)
+    end
+
+    @@instance = Parser.new(DEFAULT_SET)
+    
+    def self.instance 
+      @@instance
+    end
+        
+    private_class_method :new  
+  end
+
+  def self.parse str, lang = :default
+    Parser.parse str, lang
+  end
+  def self.parse! str, lang = :default
+    Parser.parse! str, lang
+  end
+end
+

data/lib/utils/hash_recursive_merge.rb

@@ -0,0 +1,73 @@
+# 
+# = Hash Recursive Merge
+# 
+# Merges a Ruby Hash recursively, Also known as deep merge.
+# Recursive version of Hash#merge and Hash#merge!.
+# 
+# Category::    Ruby
+# Package::     Hash
+# Author::      Simone Carletti <weppos@weppos.net>
+# Copyright::   2007-2008 The Authors
+# License::     MIT License
+# Link::        http://www.simonecarletti.com/
+# Source::      http://gist.github.com/gists/6391/
+#
+module HashRecursiveMerge
+ 
+  #
+  # Recursive version of Hash#merge!
+  # 
+  # Adds the contents of +other_hash+ to +hsh+, 
+  # merging entries in +hsh+ with duplicate keys with those from +other_hash+.
+  # 
+  # Compared with Hash#merge!, this method supports nested hashes.
+  # When both +hsh+ and +other_hash+ contains an entry with the same key,
+  # it merges and returns the values from both arrays.
+  # 
+  #    h1 = {"a" => 100, "b" => 200, "c" => {"c1" => 12, "c2" => 14}}
+  #    h2 = {"b" => 254, "c" => 300, "c" => {"c1" => 16, "c3" => 94}}
+  #    h1.rmerge!(h2)   #=> {"a" => 100, "b" => 254, "c" => {"c1" => 16, "c2" => 14, "c3" => 94}}
+  #    
+  # Simply using Hash#merge! would return
+  # 
+  #    h1.merge!(h2)    #=> {"a" => 100, "b" = >254, "c" => {"c1" => 16, "c3" => 94}}
+  # 
+  def rmerge!(other_hash)
+    merge!(other_hash) do |key, oldval, newval| 
+        oldval.class == self.class ? oldval.rmerge!(newval) : newval
+    end
+  end
+ 
+  #
+  # Recursive version of Hash#merge
+  # 
+  # Compared with Hash#merge!, this method supports nested hashes.
+  # When both +hsh+ and +other_hash+ contains an entry with the same key,
+  # it merges and returns the values from both arrays.
+  # 
+  # Compared with Hash#merge, this method provides a different approch
+  # for merging nasted hashes.
+  # If the value of a given key is an Hash and both +other_hash+ abd +hsh
+  # includes the same key, the value is merged instead replaced with
+  # +other_hash+ value.
+  # 
+  #    h1 = {"a" => 100, "b" => 200, "c" => {"c1" => 12, "c2" => 14}}
+  #    h2 = {"b" => 254, "c" => 300, "c" => {"c1" => 16, "c3" => 94}}
+  #    h1.rmerge(h2)    #=> {"a" => 100, "b" => 254, "c" => {"c1" => 16, "c2" => 14, "c3" => 94}}
+  #    
+  # Simply using Hash#merge would return
+  # 
+  #    h1.merge(h2)     #=> {"a" => 100, "b" = >254, "c" => {"c1" => 16, "c3" => 94}}
+  # 
+  def rmerge(other_hash)
+    r = {}
+    merge(other_hash)  do |key, oldval, newval| 
+      r[key] = oldval.class == self.class ? oldval.rmerge(newval) : newval
+    end
+  end
+ 
+end
+ 
+class Hash
+  include HashRecursiveMerge
+end

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+require 'bundler/setup'
+
+require 'typogrowth'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  
+end

data/spec/test.input

@@ -0,0 +1,24 @@
+And God said "∇×(∇×F) = ∇(∇·F) − ∇2F" and there was light.
+And God said “∇×(∇×F) = ∇(∇·F) − ∇2F” and there was light.
+And God said "I--heard "Booh "Bah" Booh" and "Bam" in heaven" and there was light.
+And God said “I—heard ‘Booh “Bah” Booh’ and ‘Bam’ in heaven” and there was light.
+And God said "I - heard "Booh Bah Booh" and "Bam" in heaven" and there was light.
+And God said “I—heard ‘Booh Bah Booh’ and ‘Bam’ in heaven” and there was light.
+And God said "Oslo coordinates are: 59°57′N 10°45′E" and there was light.
+And God said “Oslo coordinates are: 59°57′N 10°45′E” and there was light.
+And God said "That's a 6.3" man, he sees sunsets at 10°20'30" E." and there was light.
+And God said “That’s a 6.3″ man, he sees sunsets at 10°20′30″ E.” and there was light.
+And God said "Foo" , and there was light.
+And God said “Foo,” and there was light.
+And God said "Baz heard 'Foos' Bar' once" , and there was light.
+And God said “Baz heard ‘Foos’ Bar’ once,” and there was light.
+And God, loving ellipsis, said.... And...
+And God, loving ellipsis, said… And…
+
+An easier way to solve the problem requires understanding that regular expressions can be written as finite state machines, and vice versa.
+
+Let's start by building the state machine which matches multiples of 3. We know that a number is a multiple of 3, if and only if the sums of the digits are a multiple of 3 (divisibility by three proof).
+
+The state machine is going to process the input and keep track of the sum of the digits. We only need the sum modulo 3, so we'll have a pretty simple state machine with 3 states: state A (starting state), state B (we are off by 1), state C (we are off by 2).
+
+When we are in state A, if we get a "0", "3", "6" or "9", we remain on state A. If we get a "1", "4" or "7" we move to state B. If we get a "2", "5" or "8" we move to state C.

data/spec/typogrowth_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+describe Typogrowth do
+  it "fails" do
+    fail "hey buddy, you should probably rename this file and start specing for real"
+  end
+end

data/typogrowth.gemspec

@@ -0,0 +1,38 @@
+$:.push File.expand_path("../lib", __FILE__)
+require 'typogrowth/version'
+
+Gem::Specification.new do |s|
+  s.name = 'typogrowth'
+  s.version = Typogrowth::VERSION
+  s.platform = Gem::Platform::RUBY
+  s.date = '2013-10-06'
+  s.authors = ['Alexei Matyushkin']
+  s.email = 'am@mudasobwa.ru'
+  s.homepage = 'http://github.com/mudasobwa/typogrowth'
+  s.license = 'LICENSE'
+  s.summary = %Q{Simple library to produce typographyed texts}
+  s.description = %Q{Gem provides string monkeypatches to typograph strings}
+  s.extra_rdoc_files = [
+    'LICENSE',
+    'README.md',
+  ]
+
+  s.required_rubygems_version = Gem::Requirement.new('>= 1.3.7')
+  s.rubygems_version = '1.3.7'
+  s.specification_version = 3
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ['lib']
+
+  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'yard'
+  s.add_development_dependency 'cucumber'
+  s.add_development_dependency 'yard-cucumber'
+  
+  s.add_dependency 'psych'
+  s.add_dependency 'i18n'
+end
+

metadata

@@ -0,0 +1,165 @@
+--- !ruby/object:Gem::Specification
+name: typogrowth
+version: !ruby/object:Gem::Version
+  version: 0.9.0
+platform: ruby
+authors:
+- Alexei Matyushkin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  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: 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: yard
+  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: cucumber
+  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: yard-cucumber
+  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: psych
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: i18n
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Gem provides string monkeypatches to typograph strings
+email: am@mudasobwa.ru
+executables:
+- typo
+extensions: []
+extra_rdoc_files:
+- LICENSE
+- README.md
+files:
+- .document
+- .gitignore
+- .travis.yml
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/typo
+- features/step_definitions/typogrowth_steps.rb
+- features/support/env.rb
+- features/typogrowth.feature
+- lib/config/typogrowth.yaml
+- lib/typogrowth.rb
+- lib/typogrowth/string.rb
+- lib/typogrowth/version.rb
+- lib/utils/hash_recursive_merge.rb
+- spec/spec_helper.rb
+- spec/test.input
+- spec/typogrowth_spec.rb
+- typogrowth.gemspec
+homepage: http://github.com/mudasobwa/typogrowth
+licenses:
+- LICENSE
+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: 1.3.7
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.2
+signing_key: 
+specification_version: 3
+summary: Simple library to produce typographyed texts
+test_files: []
+has_rdoc: