persian-bechasboon 0.0.0 → 0.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d39ba4730ca49a3236330e0545c5f36ea4d223de
-  data.tar.gz: 53e5c38d80cc215577fe2875f4980cd025071b90
+  metadata.gz: dfffba769b563cf415e2a90b68c877c6f078be34
+  data.tar.gz: dd9a739f574d5ae6bb153b7ffb3b2ffca0536638
 SHA512:
-  metadata.gz: 3f7969288d045cb7f6bb01e9ee0c20acd4b7a566d859967925ce7eb090dd0abd405ea35fca0593dc3d32b70360146eb93ce9a145c0c633e831efb1900732f302
-  data.tar.gz: b6da92ece6bfc8f39931e321c3bd5c559596dfac430c67a290568c9f5688c0ede736491bee1f1deeb39dbea13cc2be960e024910a21b58b7d958d6ccfa4c25d1
+  metadata.gz: 86aec7a0cf1c6a5e5b52b7a5fdd3d54fafe9d085b221d82bd4fc78417d460ed85217892c6e5c6960bb11b51842c8c958b81466eef76569b3b7cd8dbef86c24f1
+  data.tar.gz: 7eefbcc318a3a406ee5283008754d7f90d63bc01e84ffb6301ab54fe50f2969f3a6840d713375a630813e623ddb10601401c452f9d6dfa86b716e21b32470fc6

data/.gitignore

@@ -0,0 +1,35 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/README.md

@@ -0,0 +1,36 @@
+Persian Bechasboon
+==================
+
+Languages which have connecting characters are not well-supported by many programming libraries.
+Persian language is one of them. I try to use prawn as a PDF generator to create a report in pdf format.
+But because of above mentioned problem it's failed. So I found arabic-letter-connector
+which solve this problem for arabic language. I use this gem and provide Persian bechasboonn gem to add Persian
+support when using ruby's libraries like prawn.
+
+Acknowledgment
+--------------
+
+Thanks to arabic-letter-connector by (Ahmed Nasser).
+
+Installation
+------------
+
+Run:
+
+	gem install persian-bechasboon
+
+Then require it with:
+
+	require 'persian-bechasboon'
+
+Usage
+-----
+
+	require 'prawn'
+	require 'persian-bechasboon'
+	Prawn::Document.generate("persian.pdf") do
+		text_direction :rtl
+		font("/path/to/persian/font.ttf") do # For example: B Nazanin
+			text "درود دنیا".connect_persian_letters
+		end
+	end

data/lib/persian-bechasboon.rb

@@ -0,0 +1,3 @@
+require 'persian-bechasboon/version'
+require 'persian-bechasboon/core'
+require 'persian-bechasboon/string'

data/lib/persian-bechasboon/core.rb

@@ -0,0 +1,134 @@
+module PersianBechasboon
+
+  @@charinfos = nil
+
+  class CharacterInfo
+
+    attr_accessor :common , :formatted
+
+    def initialize(common, isolated, final, initial, medial, connects)
+      @common = common
+      @formatted = {
+        :isolated => isolated,
+        :final    => final,
+        :initial  => initial,
+        :medial   => medial,
+      }
+      @connects = connects
+    end
+
+    def connects?
+      @connects
+    end
+
+  end
+
+  # Determine the form of the current character (:isolated, :initial, :medial,
+  # or :final), given the previous character and the next one. In Persian, all
+  # characters can connect with a previous character, but not all letters can
+  # connect with the next character (this is determined by
+  # CharacterInfo#connects?).
+  def self.determine_form(previous_char, next_char)
+    charinfos = self.charinfos
+    if charinfos[previous_char] && charinfos[next_char]
+      charinfos[previous_char].connects? ? :medial : :initial # If the current character does not connect, 
+      # its medial form will map to its final form,
+      # and its initial form will map to its isolated form.
+    elsif charinfos[previous_char] # The next character is not an persian character.
+      charinfos[previous_char].connects? ? :final : :isolated 
+    elsif charinfos[next_char] # The previous character is not an persian character.
+      :initial # If the current character does not connect, its initial form will map to its isolated form.
+    else # Neither of the surrounding characters are persian characters.
+      :isolated
+    end
+  end
+
+  def self.transform(str)
+    res = ""
+    charinfos = self.charinfos
+    previous_char = nil
+    current_char = nil
+    next_char = nil
+    consume_character = lambda do |char|
+      previous_char = current_char
+      current_char = next_char
+      next_char = char
+      return unless current_char
+      if charinfos.keys.include?(current_char)
+        form = determine_form(previous_char, next_char)
+        res += charinfos[current_char].formatted[form]
+      else
+        res += current_char
+      end
+    end
+    str.each_char { |char| consume_character.call(char) }
+    consume_character.call(nil)
+    res.gsub!(/\d+/) {|m| m.reverse}
+    return res
+  end
+
+  private
+
+  def self.charinfos
+    return @@charinfos unless @@charinfos.nil?
+    @@charinfos = {}
+    add("0627", "fe8d", "fe8e", "fe8d", "fe8e", false) # Alef
+    add("0628", "fe8f", "fe90", "fe91", "fe92", true)  # Ba2
+    add("067e", "fb56", "fb57", "fb58", "fb59", true)  # pe
+    add("062a", "fe95", "fe96", "fe97", "fe98", true)  # Ta2
+    add("062b", "fe99", "fe9a", "fe9b", "fe9c", true)  # Tha2
+    add("062c", "fe9d", "fe9e", "fe9f", "fea0", true)  # Jeem
+    add("fb7a", "0868", "fb7b", "fb7c", "fb7d", true)  # che
+    add("062d", "fea1", "fea2", "fea3", "fea4", true)  # 7a2
+    add("062e", "fea5", "fea6", "fea7", "fea8", true)  # 7'a2
+    add("062f", "fea9", "feaa", "fea9", "feaa", false) # Dal
+    add("0630", "feab", "feac", "feab", "feac", false) # Thal
+    add("0631", "fead", "feae", "fead", "feae", false) # Ra2
+    add("0632", "feaf", "feb0", "feaf", "feb0", false) # Zain
+    add("0633", "feb1", "feb2", "feb3", "feb4", true)  # Seen
+    add("0634", "feb5", "feb6", "feb7", "feb8", true)  # Sheen
+    add("0635", "feb9", "feba", "febb", "febc", true)  # 9ad
+    add("0636", "febd", "febe", "febf", "fec0", true)  # 9'ad
+    add("0637", "fec1", "fec2", "fec3", "fec4", true)  # 6a2
+    add("0638", "fec5", "fec6", "fec7", "fec8", true)  # 6'a2
+    add("0639", "fec9", "feca", "fecb", "fecc", true)  # 3ain
+    add("063a", "fecd", "fece", "fecf", "fed0", true)  # 3'ain
+    add("0641", "fed1", "fed2", "fed3", "fed4", true)  # Fa2
+    add("0642", "fed5", "fed6", "fed7", "fed8", true)  # Qaf
+    add("0643", "fed9", "feda", "fedb", "fedc", true)  # Kaf
+    add("06a9", "fb8e", "fb8f", "fb90", "fb91", true)  # Ke
+    add("06af", "fb92", "fb93", "fb94", "fb95", true)  # Gaf
+    add("0644", "fedd", "fede", "fedf", "fee0", true)  # Lam
+    add("0645", "fee1", "fee2", "fee3", "fee4", true)  # Meem
+    add("0646", "fee5", "fee6", "fee7", "fee8", true)  # Noon
+    add("0647", "fee9", "feea", "feeb", "feec", true)  # Ha2
+    add("0648", "feed", "feee", "feed", "feee", false) # Waw
+    add("064a", "fef1", "fef2", "fef3", "fef4", true)  # Ya2
+    add("0621", "fe80", "fe80", "fe80", "fe80", false) # Hamza
+    add("0622", "fe81", "fe82", "fe81", "fe82", false) # Alef Madda
+    add("0623", "fe83", "fe84", "fe83", "fe84", false) # Alef Hamza Above
+    add("0624", "fe85", "fe86", "fe85", "fe86", false) # Waw Hamza
+    add("0625", "fe87", "fe88", "fe87", "fe88", false) # Alef Hamza Below
+    add("0626", "fe89", "fe8a", "fe8b", "fe8c", true)  # Ya2 Hamza
+    add("06cc", "fbfc", "fbfd", "fbfe", "fbff", true)  # Ye
+    add("0629", "fe93", "fe94", "fe93", "fe94", false) # Ta2 Marbu6a
+    add("0640", "0640", "0640", "0640", "0640", true)  # Tatweel
+    add("0649", "feef", "fef0", "feef", "fef0", false) # Alef Layyina
+    #add("068e", "fb86", "fb87", "fb86", "fb87", false) # zhe
+    add("0698", "fb8a", "fb8b", "fb8a", "fb8b", false) # zhe
+    @@charinfos
+  end
+
+  def self.add(common, isolated, final, initial, medial, connects)
+    charinfo = CharacterInfo.new(
+      [common.hex].pack("U"),
+      [isolated.hex].pack("U"),
+      [final.hex].pack("U"),
+      [initial.hex].pack("U"),
+      [medial.hex].pack("U"),
+      connects
+    )
+    @@charinfos[charinfo.common] = charinfo
+  end
+
+end

data/lib/persian-bechasboon/string.rb

@@ -0,0 +1,5 @@
+class String
+  def connect_persian_letters
+    PersianBechasboon.transform(self)
+  end
+end

data/lib/persian-bechasboon/version.rb

@@ -0,0 +1,3 @@
+module PersianBechasboon
+  VERSION = "0.0.1"
+end

data/persian-bechasboon.gemspec

@@ -0,0 +1,16 @@
+$:.unshift(File.join(File.dirname(__FILE__), 'lib'))
+require 'persian-bechasboon/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'persian-bechasboon'
+  s.version     = PersianBechasboon::VERSION
+  s.date        = '2015-05-06'
+  s.summary     = 'Persian Characters Connector (Bechasboon)'
+  s.description = 'A tool to replace generic disconnected Persian letters with their connected counterparts, for the Ruby programming language.'
+  s.authors     = ["Hazhir Derakhshi"]
+  s.email       = 'hajear@gmail.com'
+  s.homepage    = 'https://github.com/volfgox/persian-bechasboon'
+
+  s.files       = `git ls-files`.split("\n")
+  s.require_paths = ['lib']
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: persian-bechasboon
 version: !ruby/object:Gem::Version
-  version: 0.0.0
+  version: 0.0.1
 platform: ruby
 authors:
 - Hazhir Derakhshi
@@ -10,18 +10,22 @@ bindir: bin
 cert_chain: []
 date: 2015-05-06 00:00:00.000000000 Z
 dependencies: []
-description: Generated persian pdf files by other gems have a big problem. Characters
-  in the words are separated. using this gem help you to connect characters before
-  place them in the pdf file.
+description: A tool to replace generic disconnected Persian letters with their connected
+  counterparts, for the Ruby programming language.
 email: hajear@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".gitignore"
+- README.md
 - lib/persian-bechasboon.rb
+- lib/persian-bechasboon/core.rb
+- lib/persian-bechasboon/string.rb
+- lib/persian-bechasboon/version.rb
+- persian-bechasboon.gemspec
 homepage: https://github.com/volfgox/persian-bechasboon
-licenses:
-- MIT
+licenses: []
 metadata: {}
 post_install_message: 
 rdoc_options: []
@@ -42,7 +46,6 @@ rubyforge_project:
 rubygems_version: 2.4.6
 signing_key: 
 specification_version: 4
-summary: The problem of separated persian characters in generated pdf is solved by
-  using this gem.
+summary: Persian Characters Connector (Bechasboon)
 test_files: []
 has_rdoc: