text-hyphen 1.0.0

data/ChangeLog

@@ -0,0 +1,4 @@
+== Text::Hyphen 1.0.0
+* Initial version based on TeX::Hyphen 0.4.0 (some changes have been backported
+  to TeX::Hyphen 0.5.0). 
+* Incorporated many hyphenation pattern files from CTAN.

data/Changelog

@@ -0,0 +1,4 @@
+== Text::Hyphen 1.0.0
+* Initial version based on TeX::Hyphen 0.4.0 (some changes have been backported
+  to TeX::Hyphen 0.5.0). 
+* Incorporated many hyphenation pattern files from CTAN.

data/INSTALL

@@ -0,0 +1,6 @@
+Installing this package is as simple as:
+
+% ruby install.rb
+
+Alternatively, you can use the RubyGem version of TeX::Hyphen available as
+text-hyphen-1.0.0.gem from the usual sources.

data/LICENCE

@@ -0,0 +1,47 @@
+Text::Hyphen is copyright (c) 2004 Austin Ziegler
+
+Licensing for Text::Hyphen is unfortunately complex because of the various
+copyrights and licences of the source hyphenation files. Some of these files
+are available only under the TeX licence and others are available only under
+the GNU GPL while others are public domain. Each language file has these
+licences embedded within the file. Please consult each file's licence to
+ensure that it is compatible with your application.
+
+The copyright on the Text::Hyphen application/library and the Ruby
+translations of hyphenation files belongs to Austin Ziegler. All other
+copyrights on original versions still stand; Text::Hyphen is a derivative
+work of these and other projects.
+
+Application and Compilation Licences
+------------------------------------
+Text::Hyphen, the application/library is licensed under the same terms as
+Ruby. Note that this specifically refers to the contents of bin/hyphen,
+lib/text/hyphen.rb, and lib/text/hyphen/language.rb.
+
+Individual language hyphenation files are NOT licensed under these terms, but
+under the following MIT-style licence and the original hyphenation pattern
+licenses. The copyright for the original TeX hyphenation files is held by the
+original authors; any mistakes in conversion of these files to Ruby is
+attributable to the contributors to the Text::Hyphen package only.
+
+The compilation package Text::Hyphen is licensed under the same terms as Ruby.
+
+Blanket Language Hyphenation File Licence
+-----------------------------------------
+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

@@ -0,0 +1,56 @@
+Text::Hyphen README
+===================
+
+Text::Hyphen will properly hyphenate various words according to the rules of
+the language the word is written in. The algorithm is based on that of the TeX
+typesetting system by Donald E. Knuth. This is originally based on the Perl
+implementation of TeX::Hyphen[1] and the Ruby port TeX::Hyphen[2]. The
+language hyphenation pattern files are based on the sources available from
+CTAN[3] as of 2004.12.19 and have been translated by Austin Ziegler.
+
+This release is 1.0, the initial release of Text::Hyphen, representing a
+significant improvement over its predecessor, TeX::Hyphen.
+
+    require 'text/hyphen'
+    hh = Text::Hyphen.new(:language => 'en_us', :left => 2, :right => 2)
+      # Defaults to the above
+    hh = TeX::Hyphen.new
+    
+    word = "representation"
+    points = hyp.hyphenate(word)  #=> [3, 5, 8, 10]
+    puts hyp.visualize(word)      #=> rep-re-sen-ta-tion
+
+Text::Hyphen is truly multilingual in nature[4]. As an example, consider the
+difference between the following:
+
+    require 'text/hyphen'
+      # Using left and right minimum values of 0 ensures that you will see all
+      # possible hyphenation points, not just those that meet the minimum
+      # width requirements.
+    en = Text::Hyphen.new(:left => 0, :right => 0)
+    fr = Text::Hyphen.new(:language = "fr", :left => 0, :right => 0)
+
+    puts en.visualise("organiser")      #=> or-gan-iser
+    puts fr.visualise("organiser")      #=> or-ga-ni-ser
+
+As you can see, the hyphenation is distinct between the two hyphenators.
+Additional improvements over TeX::Hyphen include thread safety (except for
+debug control) and support for UTF-8.
+
+It is very important to read the LICENCE file and each language file desired,
+as some languages may be held under a more strict licence than that granted by
+LICENCE.
+
+Copyright
+=========
+# Copyright 2004 Austin Ziegler <text-hyphen@halostatue.ca>
+# See the LICENCE file for more information.
+
+[1] <http://search.cpan.org/author/JANPAZ/TeX-Hyphen-0.140/lib/TeX/Hyphen.pm>
+    Maintained by Jan Pazdziora.
+[2] Available at <http://rubyforge.org/projects/text-format>.
+[3] <http://www.ctan.org>
+[4] There are some bugs and design decisions in the original Perl
+    implementation of TeX::Hyphen that make it unsuitable for most
+    multilingual implementations that carried over to the Ruby port of
+    TeX::Hyphen.

data/Rakefile

@@ -0,0 +1,116 @@
+#! /usr/bin/env rake
+$LOAD_PATH.unshift('lib')
+
+require 'rubygems'
+require 'rake/gempackagetask'
+require 'text/hyphen'
+require 'archive/tar/minitar'
+require 'zlib'
+
+DISTDIR = "text-hyphen-#{Text::Hyphen::VERSION}"
+TARDIST = "../#{DISTDIR}.tar.gz"
+
+DATE_RE = %r<(\d{4})[./-]?(\d{2})[./-]?(\d{2})(?:[\sT]?(\d{2})[:.]?(\d{2})[:.]?(\d{2})?)?>
+
+if ENV['RELEASE_DATE']
+  year, month, day, hour, minute, second = DATE_RE.match(ENV['RELEASE_DATE']).captures
+  year ||= 0
+  month ||= 0
+  day ||= 0
+  hour ||= 0
+  minute ||= 0
+  second ||= 0
+  ReleaseDate = Time.mktime(year, month, day, hour, minute, second)
+else
+  ReleaseDate = nil
+end
+
+task :test do |t|
+  require 'test/unit/testsuite'
+  require 'test/unit/ui/console/testrunner'
+
+  runner = Test::Unit::UI::Console::TestRunner
+
+  $LOAD_PATH.unshift('tests')
+  $stderr.puts "Checking for test cases:" if t.verbose
+  Dir['tests/tc_*.rb'].each do |testcase|
+    $stderr.puts "\t#{testcase}" if t.verbose
+    load testcase
+  end
+
+  suite = Test::Unit::TestSuite.new("Text::Hyphen")
+
+  ObjectSpace.each_object(Class) do |testcase|
+    suite << testcase.suite if testcase < Test::Unit::TestCase
+  end
+
+  runner.run(suite)
+end
+
+spec = eval(File.read("text-hyphen.gemspec"))
+spec.version = Text::Hyphen::VERSION
+desc "Build the RubyGem for Text::Hyphen"
+task :gem => [ :test ]
+Rake::GemPackageTask.new(spec) do |g|
+  g.need_tar    = false
+  g.need_zip    = false
+  g.package_dir = ".."
+end
+
+desc "Build a Text::Hyphen .tar.gz distribution."
+task :tar => [ TARDIST ]
+file TARDIST => [ :test ] do |t|
+  current = File.basename(Dir.pwd)
+  Dir.chdir("..") do
+    begin
+      files = Dir["#{current}/**/*"].select { |dd| dd !~ %r{(?:/CVS/?|~$)} }
+      files.map! do |dd|
+        ddnew = dd.gsub(/^#{current}/, DISTDIR)
+        mtime = ReleaseDate || File.stat(dd).mtime
+        if File.directory?(dd)
+          { :name => ddnew, :mode => 0755, :dir => true, :mtime => mtime }
+        else
+          if dd =~ %r{bin/}
+            mode = 0755
+          else
+            mode = 0644
+          end
+          data = File.read(dd)
+          { :name => ddnew, :mode => mode, :data => data, :size => data.size,
+            :mtime => mtime }
+        end
+      end
+
+      ff = File.open(t.name.gsub(%r{^\.\./}o, ''), "wb")
+      gz = Zlib::GzipWriter.new(ff)
+      tw = Archive::Tar::Minitar::Writer.new(gz)
+
+      files.each do |entry|
+        if entry[:dir]
+          tw.mkdir(entry[:name], entry)
+        else
+          tw.add_file_simple(entry[:name], entry) { |os| os.write(entry[:data]) }
+        end
+      end
+    ensure
+      tw.close if tw
+      gz.close if gz
+    end
+  end
+end
+task TARDIST => [ :test ]
+
+def sign(file)
+  system %("C:/Program Files/Windows Privacy Tools/GnuPG/gpg.exe" -ba #{file}).gsub(%r{/}) { "\\" }
+  raise "Error signing with GPG." unless File.exists?("#{file}.asc")
+end
+
+task :signtar => [ :tar ] do
+  sign TARDIST
+end
+task :signgem => [ :gem ] do
+  sign "../#{DISTDIR}.gem"
+end
+
+desc "Build everything."
+task :default => [ :signtar, :signgem ]

data/bin/hyphen

@@ -0,0 +1,107 @@
+#!/usr/bin/env ruby
+# Text::Hyphen
+#   Copyright 2003 - 2004, Martin DeMello and Austin Ziegler
+#
+# Licensed under the same terms as Ruby.
+#
+# $Id: hyphen,v 1.2 2004/12/20 22:43:03 austin Exp $
+#++
+
+require 'optparse'
+require 'ostruct'
+
+begin
+  require 'text/hyphen'
+rescue LoadError
+  require 'rubygems'
+  require 'text/hyphen'
+end
+
+options = OpenStruct.new
+options.action = :visualise
+ARGV.options do |opt|
+  opt.banner = "Usage: #{File.basename($0)} [options] [mode] word+"
+  opt.separator ""
+  opt.separator "Modes"
+  opt.on('-V', '--visualise', 'Visualises the hyphenation of the word.', 'Default action.') { |mode|
+    options.action = :visualise
+  }
+  opt.on('-P', '--points', 'Shows the letters on which a word will', 'be hyphenated.') { |mode|
+    options.action = :hyphenate
+  }
+  opt.on('-H', '--hyphenate-to SIZE', Numeric, 'Hyphenates the word so that the first', 'point is at least SIZE letters.') { |size|
+    options.action = :hyphenate_to
+    options.size = size.to_i
+  }
+  opt.on("-S", "--stats", 'Shows the hyphenation statistics for the', 'current language pattern dictionary.') { |mode|
+    options.action = :stats
+  }
+
+  opt.separator ""
+  opt.separator "Options"
+  opt.on('-L', '--left SIZE', Integer, 'Sets the minimum number of letters on', 'the left side of the word.') { |left|
+    options.left = left.to_i
+  }
+  opt.on('-R', '--right SIZE', Integer, 'Sets the minimum number of letters on', 'the right side of the word.') { |right|
+    options.right = right.to_i
+  }
+  opt.on('-l', '--language LANGUAGE', 'Loads the specified language resource.') { |lang|
+    options.language = lang
+  }
+
+  opt.separator ""
+  opt.on_tail('-h', '--help', 'Shows this help') {
+    $stderr.puts opt
+    exit 0
+  }
+  opt.on_tail('-v', '--version', 'Display the program and library version.') {
+    $stderr.puts "#{File.basename($0)}: Text::Hyphen version #{Text::Hyphen::VERSION}"
+    exit 0
+  }
+  opt.parse!
+end
+
+if ARGV.empty? and options.action != :stats
+  $stderr.puts ARGV.options
+  exit 0
+end
+
+hyphenator = Text::Hyphen.new do |h|
+  h.left      = options.left  if options.left
+  h.right     = options.right if options.right
+  h.language  = options.language if options.language
+end
+
+case options.action
+when :visualise
+  size = 80
+  ARGV.each do |word|
+    vis = hyphenator.visualise(word)
+    if (size - vis.size - 1) < 0
+      puts
+      size = 80
+    end
+    size -= (vis.size + 1)
+    print "#{vis} "
+  end
+when :hyphenate
+  ARGV.each do |word|
+    hyp = hyphenator.hyphenate(word)
+    print "#{word}: "
+    hyp.each { |pt| print "#{word[pt, 1]} " }
+    puts
+  end
+when :hyphenate_to
+  size = 80
+  ARGV.each do |word|
+    vis = hyphenator.visualise_to(word, options.size)
+    if (size - vis.size - 1) < 0
+      puts
+      size = 80
+    end
+    size -= (vis.size + 1)
+    print "#{vis} "
+  end
+when :stats
+  puts hyphenator.stats
+end

data/lib/text/hyphen.rb

@@ -0,0 +1,289 @@
+module Text; end
+
+  # = Introduction
+  # Text::Hyphen -- hyphenate words using modified versions of TeX
+  # hyphenation patterns.
+  #
+  # == Usage
+  #   require 'text/hyphen'
+  #   hh = Text::Hyphen.new(:language => 'en_us', :left => 2, :right => 2)
+  #     # Defaults to the above
+  #   hh = TeX::Hyphen.new
+  #
+  #   word = "representation"
+  #   points = hyp.hyphenate(word)    #=> [3, 5, 8, 10]
+  #   puts hyp.visualize(word)        #=> rep-re-sen-ta-tion
+  #   
+  #   en = Text::Hyphen.new(:left => 0, :right => 0)
+  #   fr = Text::Hyphen.new(:language = "fr", :left => 0, :right => 0)
+  #   puts en.visualise("organiser")  #=> or-gan-iser
+  #   puts fr.visualise("organiser")  #=> or-ga-ni-ser
+  #
+  # == Description
+  # Creates a new Hyphen object and loads the language patterns into
+  # memory. The hyphenator can then be asked for the hyphenation of
+  # a word. If no language is specified, then the language en_us (EN_US)
+  # is used by default.
+  #
+  # Copyright::   Copyright (c) 2004 Austin Ziegler
+  # Version::     1.0.0
+  # Based On::    <tt>TeX::Hyphen</tt> 0.4 Copyright (c) 2003 - 2004
+  #               Martin DeMello and Austin Ziegler, in turn based on
+  #               Perl's <tt>TeX::Hyphen</tt>
+  #               [http://search.cpan.org/author/JANPAZ/TeX-Hyphen-0.140/lib/TeX/Hyphen.pm]
+  #               Copyright (c) 1997 - 2002 Jan Pazdziora
+  #
+  # == Licence
+  # Licensing for Text::Hyphen is unfortunately complex because of the
+  # various copyrights and licences of the source hyphenation files. Some of
+  # these files are available only under the TeX licence and others are
+  # available only under the GNU GPL while others are public domain. Each
+  # language file has these licences embedded within the file. Please
+  # consult each file's licence to ensure that it is compatible with your
+  # application.
+  #
+  # The copyright on the Text::Hyphen application/library and the Ruby
+  # translations of hyphenation files belongs to Austin Ziegler. All other
+  # copyrights on original versions still stand; Text::Hyphen is a derivative
+  # work of these and other projects.
+  #
+  # === Application and Compilation Licences
+  # Text::Hyphen, the application/library is licensed under the same terms
+  # as Ruby. Note that this specifically refers to the contents of
+  # bin/hyphen, lib/text/hyphen.rb, and lib/text/hyphen/language.rb.
+  #
+  # Individual language hyphenation files are NOT licensed under these
+  # terms, but under the following MIT-style licence and the original
+  # hyphenation pattern licenses. The copyright for the original TeX
+  # hyphenation files is held by the original authors; any mistakes in
+  # conversion of these files to Ruby is attributable to the contributors to
+  # the Text::Hyphen package only.
+  #
+  # The compilation package Text::Hyphen is licensed under the same terms as
+  # Ruby.
+  #
+  # === Blanket Language Hyphenation File Licence
+  # 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.
+class Text::Hyphen
+  DEBUG   = false
+  VERSION = '1.0.0'
+
+  DEFAULT_MIN_LEFT  = 2
+  DEFAULT_MIN_RIGHT = 2
+
+    # No fewer than this number of letters will show up to the left of the
+    # hyphen. This overrides the default specified in the language.
+  attr_accessor :left
+    # No fewer than this number of letters will show up to the right of the
+    # hyphen. This overrides the default specified in the language.
+  attr_accessor :right
+    # The name of the language to be used in hyphenating words. This will be
+    # a two or three character ISO 639 code, with the two character form
+    # being the canonical resource name. This will load the language
+    # hyphenation definitions from text/hyphen/language/&lt;code&gt; as
+    # a Ruby class. The resource 'text/hyphen/language/en_us' defines the
+    # language class Text::Hyphen::Language::EN_US. It also defines the
+    # secondary forms Text::Hyphen::Language::EN and
+    # Text::Hyphen::Language::ENG_US.
+    #
+    # Minimal transformations will be performed on the language code
+    # provided, such that any dashes are converted to underscores (e.g.,
+    # 'en-us' becomes 'en_us') and all characters are regularised. Resource
+    # names will be downcased and class names will be upcased (e.g., 'Pt'
+    # for the Portuguese language becomes 'pt' and 'PT', respectively).
+    #
+    # The language may also be specified as an instance of
+    # Text::Hyphen::Language.
+  attr_accessor :language
+  def language=(lang) #:nodoc:
+    require 'text/hyphen/language' unless defined?(Text::Hyphen::Language)
+    if lang.kind_of?(Text::Hyphen::Language)
+      @iso_language = lang.to_s.split(%r{::}o)[-1].downcase
+      @language     = lang
+    else
+      @iso_language = lang.downcase
+      load_language
+    end
+    @iso_language
+  end
+    # Returns the language's ISO 639 ID, e.g., "en_us" or "pt".
+  attr_reader   :iso_language
+
+    # The following initializations are equivalent:
+    #
+    #   hyp = TeX::Hyphenate.new(:language => "EU")
+    #   hyp = TeX::Hyphenate.new { |h| h.language = "EU" }
+  def initialize(options = {}) # :yields self:
+    @iso_language = options[:language]
+    @left         = options[:left]
+    @right        = options[:right]
+
+    @cache        = {}
+    @vcache       = {}
+
+    @hyphen       = {}
+    @begin_hyphen = {}
+    @end_hyphen   = {}
+    @both_hyphen  = {}
+    @exception    = {}
+
+    @first_load = true
+    yield self if block_given?
+    @first_load = false
+
+    load_language
+
+    @left       ||= DEFAULT_MIN_LEFT
+    @right      ||= DEFAULT_MIN_RIGHT
+  end
+
+    # Returns a list of places where the word can be divided, as
+    #
+    #   hyp.hyphenate('representation')
+    #
+    # returns [3, 5, 8, 10]. If the word has been hyphenated previously, it
+    # will be returned from a per-instance cache.
+  def hyphenate(word)
+    word = word.downcase
+    $stderr.puts "Hyphenating #{word}" if DEBUG
+    return @cache[word] if @cache.has_key?(word)
+    res = @language.exceptions[word]
+    return @cache[word] = make_result_list(res) if res
+
+    result = [0] * (word.split(//).size + 1)
+    rightstop = word.split(//).size - @right
+
+    updater = Proc.new do |hash, str, pos|
+      if hash.has_key?(str)
+        $stderr.print "#{pos}: #{str}: #{hash[str]}" if DEBUG
+        hash[str].split(//).each_with_index do |cc, ii|
+          cc = cc.to_i
+          result[ii + pos] = cc if cc > result[ii + pos]
+        end
+        $stderr.print ": #{result}\n" if DEBUG
+      end
+    end
+
+      # Walk the word
+    (0..rightstop).each do |pos|
+      restlength = word.length - pos
+      (1..restlength).each do |length|
+        substr = word[pos, length]
+        updater[@language.hyphen, substr, pos]
+        updater[@language.start, substr, pos] if pos.zero?
+        updater[@language.stop, substr, pos] if (length == restlength)
+      end
+    end
+
+    updater[@language.both, word, 0] if @language.both[word]
+
+    (0..@left).each { |i| result[i] = 0 }
+    ((-1 - @right)..(-1)).each { |i| result[i] = 0 }
+    @cache[word] = make_result_list(result)
+  end
+
+    # Returns a visualization of the hyphenation points, so:
+    #
+    #   hyp.visualize('representation')
+    #
+    # returns <tt>rep-re-sen-ta-tion</tt>, at least for English patterns. If
+    # the word has been visualised previously, it will be returned from
+    # a per-instance cache.
+  def visualise(word)
+    return @vcache[word] if @vcache.has_key?(word)
+    w = word.dup
+    hyphenate(w).each_with_index do |pos, n| 
+      w[pos.to_i + n, 0] = '-' if pos != 0
+    end
+    @vcache[word] = w
+  end
+
+  alias visualize visualise
+
+  def clear_cache!
+    @cache.clear
+    @vcache.clear
+  end
+
+    # This function will hyphenate a word so that the first point is at most
+    # +size+ characters.
+  def hyphenate_to(word, size)
+    point = hyphenate(word).delete_if { |e| e >= size }.max
+    if point.nil?
+      [nil, word]
+    else
+      [word[0 ... point] + "-", word[point .. -1]]
+    end
+  end
+
+    # Returns statistics
+  def stats
+    _b = @language.both.size
+    _s = @language.start.size
+    _e = @language.stop.size
+    _h = @language.hyphen.size
+    _x = @language.exceptions.size
+    _T = _b + _s + _e + _h + _x
+
+    s = <<-EOS
+
+The language '%s' contains %d total hyphenation patterns.
+    % 6d patterns are word start patterns.
+    % 6d patterns are word stop patterns.
+    % 6d patterns are word start/stop patterns.
+    % 6d patterns are normal patterns.
+    % 6d patterns are exceptions.
+
+EOS
+    s % [ @iso_language, _T, _s, _e, _b, _h, _x ]
+  end
+
+private
+  def updateresult(hash, str, pos) #:nodoc:
+    if hash.has_key?(str)
+      STDERR.print "#{pos}: #{str}: #{hash[str]}" if DEBUG
+      hash[str].split('').each_with_index do |c, i| 
+        c = c.to_i
+        @result[i + pos] = c if c > @result[i + pos]
+      end
+      STDERR.puts ": #{@result}" if DEBUG
+    end
+  end
+
+  def make_result_list(res) #:nodoc:
+    r = []
+    res.each_with_index { |c, i| r <<  i * (c.to_i % 2) }
+    r.reject { |i| i.to_i == 0 }
+  end
+
+  def load_language
+    return if @first_load
+
+    @iso_language ||= "en_us"
+
+    require "text/hyphen/language/#{@iso_language}"
+
+    @language   = Text::Hyphen::Language.const_get(@iso_language.upcase)
+    @left     ||= @language.left
+    @right    ||= @language.right
+
+    @iso_language
+  end
+end