bagua 0.1.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NmI4ZTQxZTI2ODM0YTI3ZWQyN2QwMTkyYzdjYjk3NTNhYzNjOTg3NA==
+  data.tar.gz: !binary |-
+    MjExZDQzODliNzhhNDE2MTE2Nzk3MDUyODVjYWNiYzZmZmM4ZTIwOQ==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    ZmExMDczZmU0MDBhMzBmYmVjMjI3OWNkNjYzOTgxMWVkNDc0YTg3ZWFiZTYw
+    NDUzZjhlZDBkZjkwYWFjYmEzNGVkN2NiNWZiMjU1YzQzNGRjNGU1MjdlYWU4
+    Nzk1NTY5Y2Q2OWQ2ZTdjZDkwZjY5NTMwYTY4ZjBmYmIxMmVmOTk=
+  data.tar.gz: !binary |-
+    OTIzYWU4MjQ2ODQ0MDRkOTdjYjIwNDU0NjE1NGM3YzQ2ZmUwMTE1OGExZTZj
+    YTg1ODg1MDRiY2VmYmE2MDAxMzc1ODY4M2Y5ZWNiYmNkMjE5Mzc5ZTY3Y2Jk
+    YjRmZmE5OWU5N2Q5ZDEyNzQwNGNlZjBiNmU2ZmExNTI5Y2FjMWE=

data/.gitignore

@@ -0,0 +1,6 @@
+.DS_Store
+.yardoc
+Gemfile.lock
+doc
+pkg
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/.yardopts

@@ -0,0 +1 @@
+lib/**/*.rb - LICENSE --title Bagua

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Scott Bai
+
+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,69 @@
+# Bagua
+
+**Bagua** is a gem that encodes text as strings of [_trigrams_](http://en.wikipedia.org/wiki/Bagua) or [_hexagrams_](http://en.wikipedia.org/wiki/List_of_hexagrams_of_the_I_Ching).
+
+Trigrams and hexagrams are symbols used in Taoist cosmology, e.g. in the [I Ching](http://en.wikipedia.org/wiki/I_Ching). A trigram consists of three parallel horizontal lines, each of which can be either broken or unbroken. Because each line can be in one of 2 states, and there are 3 lines in total, there are a total of 2^3 = 8 possible combinations, as shown below.
+
+☰ ☱ ☲ ☳ ☴ ☵ ☶ ☷
+
+Each trigram above can be interpreted as a 3-bit binary sequence, where ☰ is 000 and ☷ is 111. Similarly, a hexagram can be interpreted as a 6-bit binary sequence, as it consists of six lines, or two trigrams put together. Consequently, as [noted by Leibniz](http://en.wikipedia.org/wiki/Gottfried_Wilhelm_Leibniz#Sinophile), sequences of trigrams or hexagrams can be used to represent arbitrary binary data.
+
+Because a plain text string is just a representation of an array of numbers, it follows that any string can be encoded as a sequence of trigrams or hexagrams. These trigrams and hexagrams themselves are also just plain text (Unicode) characters.
+
+## Usage
+
+```ruby
+require 'bagua'
+```
+
+### Encoding
+
+
+```ruby
+# trigrams
+Bagua::Tri.encode("abcde") # => "☳☰☲☶☱☱☴☳☳☱☰☶☲☴"
+```
+
+Historically, hexagrams have been listed in several different sequences. **Bagua** can encode hexagrams using either the default binary sequence ([Fu Xi](http://en.wikipedia.org/wiki/Fu_Xi)'s sequence) or the [King Wen sequence](http://en.wikipedia.org/wiki/King_Wen_sequence).
+
+```ruby
+# hexagrams in binary sequence
+Bagua::Hex.encode("abcde", :binary) # => "䷘䷕䷹䷟䷐䷙䷤"
+```
+
+
+```ruby
+# same as above but shorter
+Bagua::Hex.encode("abcde") # => "䷘䷕䷹䷟䷐䷙䷤"
+```
+
+
+```ruby
+# King Wen sequence
+Bagua::Hex.encode("abcde", :wen) # => "䷘䷖䷉䷣䷙䷆䷔"
+```
+
+
+### Decoding
+
+```ruby
+# trigrams
+Bagua::Tri.decode("☳☰☲☶☱☱☴☳☳☱☰☶☲☴") # => "abcde"
+```
+
+```ruby
+# hexagrams in binary sequence
+Bagua::Hex.decode("䷘䷕䷹䷟䷐䷙䷤", :binary) # => "abcde"
+```
+
+
+```ruby
+# same as above but shorter
+Bagua::Hex.decode("䷘䷕䷹䷟䷐䷙䷤") # => "abcde"
+```
+
+
+```ruby
+# King Wen sequence
+Bagua::Hex.decode("䷘䷖䷉䷣䷙䷆䷔", :wen) # => "abcde"
+```

data/Rakefile

@@ -0,0 +1,14 @@
+#! /usr/bin/env ruby
+# encoding: utf-8
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+task :default => :test
+task :test => :spec
+
+desc "Run RSpec specs"
+RSpec::Core::RakeTask.new(:spec) do |task|
+  task.rspec_opts = '--color --format progress'
+  task.fail_on_error = false
+end

data/bagua.gemspec

@@ -0,0 +1,26 @@
+# encoding: utf-8
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'bagua/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'bagua'
+  spec.version       = Bagua::VERSION
+  spec.authors       = ['Scott Bai']
+  spec.email         = ['hyperplanedrifter@gmail.com']
+  spec.description   = 'Encodes plain text as sequences of trigrams or hexagrams.'
+  spec.summary       = 'Trigram/hexagram encoder'
+  spec.homepage      = 'http://github.com/sbai/bagua'
+  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', '~> 10.0.3'
+  spec.add_development_dependency 'yard', '~> 0.8.3'
+  spec.add_development_dependency 'redcarpet', '~> 2.2.2'
+  spec.add_development_dependency 'rspec', '~> 2.13.0'
+end

data/lib/bagua.rb

@@ -0,0 +1,61 @@
+# encoding: utf-8
+require_relative 'bagua/version'
+require_relative 'bagua/hex'
+require_relative 'bagua/tri'
+
+# Provides encoding and decoding functions for trigrams and hexagrams.
+module Bagua
+  # Converts an array of bytes (integers representable in 8 bits) to an array
+  # of ntets (integers representable in n bits).
+  def self.bytes_to_ntets(bytes, n)
+    countn = 0
+    current = 0
+    ntets = []
+    bytes.each do |byte|
+      7.downto(0) do |b|
+        bit = (byte >> b) & 1
+        current = (current << 1) | bit
+        countn = (countn + 1) % n
+        if (countn == 0)
+          ntets.push(current)
+          current = 0
+        end
+      end
+    end
+
+    # handle leftover bits when n doesn't divide evenly into bytes.length*8
+    if (countn > 0)
+      current = current << (n - countn)
+      ntets.push(current)
+    end
+
+    return ntets
+  end
+
+  # Converts an array of ntets (integers representable in n bits) to an array
+  # of bytes (integers representable in 8 bits).
+  def self.ntets_to_bytes(ntets, n)
+    count8 = 0
+    current = 0
+    bytes = []
+    ntets.each do |ntet|
+      (n - 1).downto(0) do |b|
+        bit = (ntet >> b) & 1
+        current = (current << 1) | bit
+        count8 = (count8 + 1) % 8
+        if (count8 == 0)
+          bytes.push(current)
+          current = 0
+        end
+      end
+    end
+
+    # handle leftover bits when 8 doesn't divide evenly into ntets.length*n
+    if (count8 > 0)
+      current = current << (8 - count8)
+      bytes.push(current)
+    end
+
+    return bytes
+  end
+end

data/lib/bagua/hex.rb

@@ -0,0 +1,139 @@
+module Bagua
+  # Provides encoding and decoding functions for hexagrams.
+  class Hex
+    # Encodes a string into a string of hexagrams representing the byte values
+    # of each character in the string.
+    def self.encode(str, sequence = :binary)
+      return from_bytes(str.unpack('C*'), sequence)
+    end
+
+    # Decodes a string of hexagrams into a UTF-8 string.
+    # @note Chomps trailing null characters, as they are the result of zero
+    #   padding added when the number of bits being encoded in the hexagrams
+    #   is not an even multiple of 6.
+    def self.decode(grams, sequence = :binary)
+      return to_bytes(grams, sequence).pack('C*').chomp("\000").force_encoding('utf-8')
+    end
+
+    # Returns the hexagram representation of the input bytes.
+    def self.from_bytes(bytes, sequence = :binary)
+      sextets = Bagua::bytes_to_ntets(bytes, 6)
+
+      if (sequence == :wen)
+        return sextets.map { |sextet| gram(sextet) }.join("")
+      elsif (sequence == :binary)
+        return sextets.map { |sextet| gram_bin(sextet) }.join("")
+      else
+        raise "invalid sequence type"
+      end
+    end
+
+    # Returns the byte representation of a string of hexagrams.
+    def self.to_bytes(grams, sequence = :binary)
+      ucodes = grams.unpack('U*')
+
+      sextets = ucodes.map { |ucode| ucode - HEX_BASE }
+
+      if (sequence == :wen)
+      elsif (sequence == :binary)
+        wen_to_bin = BIN_TO_WEN.invert()
+        sextets.map! { |sextet| wen_to_bin[sextet]}
+      else
+        raise "invalid sequence type"
+      end
+      
+      bytes = Bagua::ntets_to_bytes(sextets, 6)
+      return bytes
+    end
+
+    private
+
+    # Decimal representation of the Unicode code point of the first hexagram
+    # character. The code point for any hexagram can by obtained by adding an
+    # offset between 0 and 63 to HEX_BASE.
+    HEX_BASE = 19904
+
+    # Binary sequence mapping for hexagram characters. This is needed because
+    # the hexagram characters are ordered by King Wen's sequence in Unicode.
+    BIN_TO_WEN = {
+      0 => 0,
+      1 => 42,
+      2 => 13,
+      3 => 33,
+      4 => 8,
+      5 => 4,
+      6 => 25,
+      7 => 10,
+      8 => 9,
+      9 => 57,
+      10 => 37,
+      11 => 53,
+      12 => 60,
+      13 => 59,
+      14 => 40,
+      15 => 18,
+      16 => 12,
+      17 => 48,
+      18 => 29,
+      19 => 54,
+      20 => 36,
+      21 => 62,
+      22 => 21,
+      23 => 35,
+      24 => 24,
+      25 => 16,
+      26 => 20,
+      27 => 50,
+      28 => 41,
+      29 => 2,
+      30 => 26,
+      31 => 23,
+      32 => 43,
+      33 => 27,
+      34 => 49,
+      35 => 31,
+      36 => 56,
+      37 => 47,
+      38 => 17,
+      39 => 45,
+      40 => 5,
+      41 => 46,
+      42 => 63,
+      43 => 39,
+      44 => 58,
+      45 => 28,
+      46 => 3,
+      47 => 6,
+      48 => 32,
+      49 => 30,
+      50 => 55,
+      51 => 61,
+      52 => 52,
+      53 => 38,
+      54 => 51,
+      55 => 14,
+      56 => 11,
+      57 => 44,
+      58 => 34,
+      59 => 15,
+      60 => 19,
+      61 => 7,
+      62 => 22,
+      63 => 1
+    }
+
+    # Returns the hexagram in King Wen's sequence that corresponds to the
+    # number num.
+    # @note If num >= 64, only the lowest six bits are used.
+    def self.gram(num)
+      return [HEX_BASE + (num & 63)].pack('U')
+    end
+
+    # Returns the hexagram in binary sequence that corresponds to the number
+    # num.
+    # @note If num >= 64, only the lowest six bits are used.
+    def self.gram_bin(num)
+      return gram(BIN_TO_WEN[num & 63])
+    end
+  end
+end

data/lib/bagua/tri.rb

@@ -0,0 +1,49 @@
+module Bagua
+  # Provides encoding and decoding functions for trigrams.
+  class Tri
+    # Encodes a string into a string of trigrams representing the byte values
+    # of each character in the string.
+    def self.encode(str)
+      return from_bytes(str.unpack('C*'))
+    end
+
+    # Decodes a string of trigrams into a UTF-8 string.
+    # @note Chomps trailing null characters, as they are the result of zero
+    #   padding added when the number of bits being encoded in the trigrams
+    #   is not an even multiple of 3.
+    # @todo Add an option to choose the encoding.
+    def self.decode(grams)
+      return to_bytes(grams).pack('C*').chomp("\000").force_encoding('utf-8')
+    end
+
+    # Returns the trigram representation of the input bytes.
+    def self.from_bytes(bytes)
+      trios = Bagua::bytes_to_ntets(bytes, 3)
+      grams = trios.map { |trio| gram(trio) }
+      return grams.join("")
+    end
+
+    # Returns the byte representation of a string of trigrams.
+    def self.to_bytes(grams)
+      ucodes = grams.unpack('U*')
+      trios = ucodes.map { |ucode| ucode - TRI_BASE }
+      bytes = Bagua::ntets_to_bytes(trios, 3)
+      return bytes
+    end
+
+    private
+
+    # Decimal representation of the Unicode code point of the first trigram
+    # character. The code point for any trigram can by obtained by adding an
+    # offset between 0 and 7 to TRI_BASE.
+    TRI_BASE = 9776
+
+    # Returns the trigram representation of num.
+    # If num >= 8, only the lowest three bits are used.
+    # @note The trigrams are arranged in binary order, as they are arranged in
+    #   Unicode.
+    def self.gram(num)
+      return [TRI_BASE + (num & 7)].pack('U')
+    end
+  end
+end

data/lib/bagua/version.rb

@@ -0,0 +1,3 @@
+module Bagua
+  VERSION = "0.1.0" # Version number of this module.
+end

data/spec/bagua/hex/from_bytes.csv

@@ -0,0 +1,6 @@
+0,䷀䷀
+1,䷀䷐
+255,䷿䷰
+0,0,䷀䷀䷀
+255,255,䷿䷿䷼
+255,255,255,䷿䷿䷿䷿

data/spec/bagua/hex/from_bytes_bin.csv

@@ -0,0 +1,6 @@
+0,䷀䷀
+1,䷀䷌
+255,䷁䷠
+0,0,䷀䷀䷀
+255,255,䷁䷁䷓
+255,255,255,䷁䷁䷁䷁

data/spec/bagua/hex/from_bytes_spec.rb

@@ -0,0 +1,28 @@
+# encoding: utf-8
+
+require 'bagua'
+
+module Bagua
+  describe "Hex" do
+    describe "::from_bytes" do
+      before(:all) do
+        require 'csv'
+        options = { :converters => [ :numeric ] }
+        @examples_wen = CSV.open('spec/bagua/hex/from_bytes.csv', 'r', options)
+        @examples_bin = CSV.open('spec/bagua/hex/from_bytes_bin.csv', 'r', options)
+      end
+
+      it "works for all King Wen sequence examples" do
+        @examples_wen.each do |row|
+          Hex.from_bytes(row[0..-2],:wen).should == row[-1]
+        end
+      end
+
+      it "works for all binary sequence examples" do
+        @examples_bin.each do |row|
+          Hex.from_bytes(row[0..-2],:binary).should == row[-1]
+        end
+      end
+    end
+  end
+end

data/spec/bagua/hex/gram.csv

@@ -0,0 +1,64 @@
+0,䷀
+1,䷁
+2,䷂
+3,䷃
+4,䷄
+5,䷅
+6,䷆
+7,䷇
+8,䷈
+9,䷉
+10,䷊
+11,䷋
+12,䷌
+13,䷍
+14,䷎
+15,䷏
+16,䷐
+17,䷑
+18,䷒
+19,䷓
+20,䷔
+21,䷕
+22,䷖
+23,䷗
+24,䷘
+25,䷙
+26,䷚
+27,䷛
+28,䷜
+29,䷝
+30,䷞
+31,䷟
+32,䷠
+33,䷡
+34,䷢
+35,䷣
+36,䷤
+37,䷥
+38,䷦
+39,䷧
+40,䷨
+41,䷩
+42,䷪
+43,䷫
+44,䷬
+45,䷭
+46,䷮
+47,䷯
+48,䷰
+49,䷱
+50,䷲
+51,䷳
+52,䷴
+53,䷵
+54,䷶
+55,䷷
+56,䷸
+57,䷹
+58,䷺
+59,䷻
+60,䷼
+61,䷽
+62,䷾
+63,䷿

data/spec/bagua/hex/gram_bin.csv

@@ -0,0 +1,64 @@
+0,䷀
+1,䷪
+2,䷍
+3,䷡
+4,䷈
+5,䷄
+6,䷙
+7,䷊
+8,䷉
+9,䷹
+10,䷥
+11,䷵
+12,䷼
+13,䷻
+14,䷨
+15,䷒
+16,䷌
+17,䷰
+18,䷝
+19,䷶
+20,䷤
+21,䷾
+22,䷕
+23,䷣
+24,䷘
+25,䷐
+26,䷔
+27,䷲
+28,䷩
+29,䷂
+30,䷚
+31,䷗
+32,䷫
+33,䷛
+34,䷱
+35,䷟
+36,䷸
+37,䷯
+38,䷑
+39,䷭
+40,䷅
+41,䷮
+42,䷿
+43,䷧
+44,䷺
+45,䷜
+46,䷃
+47,䷆
+48,䷠
+49,䷞
+50,䷷
+51,䷽
+52,䷴
+53,䷦
+54,䷳
+55,䷎
+56,䷋
+57,䷬
+58,䷢
+59,䷏
+60,䷓
+61,䷇
+62,䷖
+63,䷁

data/spec/bagua/hex/gram_spec.rb

@@ -0,0 +1,35 @@
+# encoding: utf-8
+
+require 'bagua'
+
+module Bagua
+  describe "Hex" do
+    describe "::gram" do
+      before(:all) do
+        require 'csv'
+        options = { :converters => [ :numeric ] }
+        @examples = CSV.open('spec/bagua/hex/gram.csv', 'r', options)
+      end
+
+      it "works for all example valid inputs" do
+        @examples.each do |row|
+          Hex.gram(row[0]).should == row[1]
+        end
+      end
+    end
+
+    describe "::gram_bin" do
+      before(:all) do
+        require 'csv'
+        options = { :converters => [ :numeric ] }
+        @examples = CSV.open('spec/bagua/hex/gram_bin.csv', 'r', options)
+      end
+
+      it "works for all example valid inputs" do
+        @examples.each do |row|
+          Hex.gram_bin(row[0]).should == row[1]
+        end
+      end
+    end
+  end
+end

data/spec/bagua/hex/hex_spec.rb

@@ -0,0 +1,31 @@
+# encoding: utf-8
+
+require 'bagua'
+
+module Bagua
+  describe "Hex" do
+    before(:all) do
+      require 'csv'
+      options = { :converters => [ :numeric ] }
+      @examples = CSV.open('spec/bagua/lorem.csv', 'r', options)
+    end
+
+    it "decode(encode(str)) should equal str" do
+      @examples.each do |row|
+        Hex.decode(Hex.encode(row[0])).should == row[0]
+      end
+    end
+
+    it "decode(encode(str,:wen),:wen) should equal str" do
+      @examples.each do |row|
+        Hex.decode(Hex.encode(row[0],:wen),:wen).should == row[0]
+      end
+    end
+
+    it "decode(encode(str,:binary),:binary) should equal str" do
+      @examples.each do |row|
+        Hex.decode(Hex.encode(row[0],:binary),:binary).should == row[0]
+      end
+    end
+  end
+end

data/spec/bagua/lorem.csv

@@ -0,0 +1,4 @@
+"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean tristique massa odio, in rhoncus ipsum consectetur id. Donec accumsan mauris at quam cursus sagittis. Nunc ornare urna vitae dui interdum, a dictum diam venenatis. Sed varius porttitor ante vitae sodales. Etiam eu suscipit leo. Pellentesque eget placerat turpis. Duis bibendum nunc turpis. Nam bibendum mi nec risus viverra, ut gravida lacus mollis. Pellentesque sed ornare enim, non iaculis elit. Morbi laoreet facilisis sodales. Pellentesque ac elit elit. Aliquam accumsan condimentum rhoncus. Donec tristique orci eu enim ornare, sed ullamcorper mi sollicitudin. Suspendisse potenti. Maecenas id ornare nisi. Sed sed fringilla turpis."
+"開無就掲昭質違併更作度済円県新気。集別評内結提家権携理来部果残取厘諭害綺国。殺成報荏山書勝浴夜誉組困。車希併昇辞小置紀保判整高代購富。氏電話将到手稿設力牟相留証劇応質。馬検遊展院治新二準果一子。向俳処体障演高令公政降申過年根供信新元阪。外認予闘生来時安創供止例趣瞬書。現写拡号所兵変草薬載回仕品多四目視無食乾。"
+"Эю окюррырэт зэнтынтиаэ мыа, эи эжт адмодум квюаырэндум. Эа зймюл дэбетиз про, хаж долорюм долорэм йн. Ипзум антеопам но прё, пэр эа граэкы промпта модыратиюз. Экз ыюм клита лэгыры, но эжт чтэт ёнанй орнатюс."
+"計お職文へづ文社ハモ聞1短ヌレ透重ア光最ス内指フヱヘ誌広白ツテフ越8人ユケ昨免髪事フクべっ国洗も投最評済包ま。資き禁測長きーたは田組ハホキウ護掲ヘサメ載方ニミ下界ワトネヘ夜場すうでラ百球ンめわ者歳ぜへぎク名1次業スぼちょ状長やべつ躍済チト首阪のル読道事ンぜむ之細き理督積ざるく。31想将抗タエ特決セチ均妙だ堂対経ゆ覚早ヲネキ点属ぶ作信くごゆ特45干悟栽ろぜっ。"

data/spec/bagua/tri/from_bytes.csv

@@ -0,0 +1,14 @@
+0,☰☰☰
+1,☰☰☲
+7,☰☱☶
+8,☰☲☰
+16,☰☴☰
+32,☱☰☰
+64,☲☰☰
+128,☴☰☰
+255,☷☷☶
+255,0,☷☷☶☰☰☰
+255,1,☷☷☶☰☰☴
+255,255,☷☷☷☷☷☴
+0,0,0,0,0,0,☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰
+255,255,255,255,255,255,☷☷☷☷☷☷☷☷☷☷☷☷☷☷☷☷

data/spec/bagua/tri/from_bytes_spec.rb

@@ -0,0 +1,21 @@
+# encoding: utf-8
+
+require 'bagua'
+
+module Bagua
+  describe "Tri" do
+    describe "::from_bytes" do
+      before(:all) do
+        require 'csv'
+        options = { :converters => [ :numeric ] }
+        @examples = CSV.open('spec/bagua/tri/from_bytes.csv', 'r', options)
+      end
+
+      it "works for all example valid inputs" do
+        @examples.each do |row|
+          Tri.from_bytes(row[0..-2]).should == row[-1]
+        end
+      end
+    end
+  end
+end

data/spec/bagua/tri/gram.csv

@@ -0,0 +1,24 @@
+0,☰
+1,☱
+2,☲
+3,☳
+4,☴
+5,☵
+6,☶
+7,☷
+8,☰
+9,☱
+10,☲
+11,☳
+12,☴
+13,☵
+14,☶
+15,☷
+1024,☰
+1025,☱
+1026,☲
+1027,☳
+1028,☴
+1029,☵
+1030,☶
+1031,☷

data/spec/bagua/tri/gram_spec.rb

@@ -0,0 +1,21 @@
+# encoding: utf-8
+
+require 'bagua'
+
+module Bagua
+  describe "Tri" do
+    describe "::gram" do
+      before(:all) do
+        require 'csv'
+        options = { :converters => [ :numeric ] }
+        @examples = CSV.open('spec/bagua/tri/gram.csv', 'r', options)
+      end
+
+      it "works for all example valid inputs" do
+        @examples.each do |row|
+          Tri.gram(row[0]).should == row[1]
+        end
+      end
+    end
+  end
+end

data/spec/bagua/tri/tri_spec.rb

@@ -0,0 +1,19 @@
+# encoding: utf-8
+
+require 'bagua'
+
+module Bagua
+  describe "Tri" do
+    before(:all) do
+      require 'csv'
+      options = { :converters => [ :numeric ] }
+      @examples = CSV.open('spec/bagua/lorem.csv', 'r', options)
+    end
+
+    it "decode(encode(str)) should equal str" do
+      @examples.each do |row|
+        Tri.decode(Tri.encode(row[0])).should == row[0]
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,22 @@
+# encoding: utf-8
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end

metadata

@@ -0,0 +1,155 @@
+--- !ruby/object:Gem::Specification
+name: bagua
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Scott Bai
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-08-25 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: 10.0.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 10.0.3
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.3
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.2.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.2.2
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.13.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.13.0
+description: Encodes plain text as sequences of trigrams or hexagrams.
+email:
+- hyperplanedrifter@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .yardopts
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bagua.gemspec
+- lib/bagua.rb
+- lib/bagua/hex.rb
+- lib/bagua/tri.rb
+- lib/bagua/version.rb
+- spec/bagua/hex/from_bytes.csv
+- spec/bagua/hex/from_bytes_bin.csv
+- spec/bagua/hex/from_bytes_spec.rb
+- spec/bagua/hex/gram.csv
+- spec/bagua/hex/gram_bin.csv
+- spec/bagua/hex/gram_spec.rb
+- spec/bagua/hex/hex_spec.rb
+- spec/bagua/lorem.csv
+- spec/bagua/tri/from_bytes.csv
+- spec/bagua/tri/from_bytes_spec.rb
+- spec/bagua/tri/gram.csv
+- spec/bagua/tri/gram_spec.rb
+- spec/bagua/tri/tri_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/sbai/bagua
+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.7
+signing_key: 
+specification_version: 4
+summary: Trigram/hexagram encoder
+test_files:
+- spec/bagua/hex/from_bytes.csv
+- spec/bagua/hex/from_bytes_bin.csv
+- spec/bagua/hex/from_bytes_spec.rb
+- spec/bagua/hex/gram.csv
+- spec/bagua/hex/gram_bin.csv
+- spec/bagua/hex/gram_spec.rb
+- spec/bagua/hex/hex_spec.rb
+- spec/bagua/lorem.csv
+- spec/bagua/tri/from_bytes.csv
+- spec/bagua/tri/from_bytes_spec.rb
+- spec/bagua/tri/gram.csv
+- spec/bagua/tri/gram_spec.rb
+- spec/bagua/tri/tri_spec.rb
+- spec/spec_helper.rb
+has_rdoc: