cheeba 1.0.4

data/Manifest.txt

@@ -0,0 +1,94 @@
+.git/COMMIT_EDITMSG
+.git/HEAD
+.git/config
+.git/description
+.git/hooks/applypatch-msg.sample
+.git/hooks/commit-msg.sample
+.git/hooks/post-commit.sample
+.git/hooks/post-receive.sample
+.git/hooks/post-update.sample
+.git/hooks/pre-applypatch.sample
+.git/hooks/pre-commit.sample
+.git/hooks/pre-rebase.sample
+.git/hooks/prepare-commit-msg.sample
+.git/hooks/update.sample
+.git/index
+.git/info/exclude
+.git/logs/HEAD
+.git/logs/refs/heads/master
+.git/logs/refs/remotes/origin/master
+.git/objects/02/38dae53aee5cb4ea157a3f036b93868ede9593
+.git/objects/02/9cafaafb83e528381f0f2f02c6f23799bd1942
+.git/objects/07/c654f9ff6c65626369b061c595be42ccdd6cd7
+.git/objects/07/dbbace3b24b2d635d2fb637581931d573fc75c
+.git/objects/08/ce1195151ff5a51573a871947ecd913fb5aa0f
+.git/objects/0c/ad63d44505490e1a30ad075099a25020d7a7c5
+.git/objects/12/215629eba6a8f0fcd849923e98a471984521e1
+.git/objects/18/60fee2fadb59a6cbcb7f7dd0a6f6dc3b56ac79
+.git/objects/1e/1800628b80bef5a8043e4adacd6ebc6bab9aa1
+.git/objects/27/97bc2b3d72dc6d77b7bd07f1cca96f7e06b4ed
+.git/objects/28/41d3f97c8aa8c942a613e1c69ed4280d78cf0a
+.git/objects/29/f0c4074f9ecc894edd7ed507a1a92499838a6d
+.git/objects/2a/8948661c63f2bef24f330638d239c88d5d0c2e
+.git/objects/3f/7142cf3878c65e71b54d3572d82837d20f2aa7
+.git/objects/40/8c36a3103bc77e90db86dc06b1598e3baa4c2d
+.git/objects/42/eb5558727a2144e7c5e997d3e6aea5486eaf37
+.git/objects/4c/6098fe05db7126c8a3c97f463910e5cc398630
+.git/objects/51/6902dffff8d29fa2f89979b9cd81ab275e1c67
+.git/objects/5b/502f8e20a0556c22727b504108a2dc36d7cbed
+.git/objects/67/c3fb20cfae5320d83c9ebf2b85c1a3ef9b706b
+.git/objects/72/7df703ac52c4ff97aa452feee27b9990430a11
+.git/objects/74/bc14252b2148d11877025d7f445d2fa686e7e9
+.git/objects/78/9ac5e1ca6a70ec3b8a11344e6f4a03e440f309
+.git/objects/7a/46bd1887d1a793094da678ded3b53b0208b826
+.git/objects/8d/77306c0d13e98da74ddf48002674fced7e1618
+.git/objects/94/36859cb89dd0bbddab77ed0810860e979b1c05
+.git/objects/ab/454c9537f329aecaedae0586c6d61146a7f819
+.git/objects/b9/3b5dde3104bb495dc0d2970bbe617dafb2f084
+.git/objects/be/197d3b2c14a52300cc4553bf2004ef3c45a45b
+.git/objects/be/8e3e0ab878ffcb0456ae4cf66861888d933bf5
+.git/objects/c5/4c515f4bff81e08b01176b1a5743fd773a9740
+.git/objects/d4/a471f188d32adfa9dc2ff22c53b95319a162ed
+.git/objects/d7/83399b37ca769b5b5bc2b33727fc47acfa5e4c
+.git/objects/d7/a544fc5715014ef027875545ef0145e9f694fe
+.git/objects/de/eef72f84f60beab439c58d84acc42d3e5a1279
+.git/objects/e6/9de29bb2d1d6434b8b29ae775ad8c2e48c5391
+.git/objects/e9/9c40e89cb90f8067f99d7051c3bebf2b145ec7
+.git/objects/f3/89737a46e7cad94deb222e238e8f926767637e
+.git/objects/fa/4f98b2fe387e262f9c28011e53f1b8fb920401
+.git/objects/fb/72047097c38625f3598fb348b3fbe75afd6d2d
+.git/objects/ff/7aefe3472c61b77f58669ec4b8208412156930
+.git/refs/heads/master
+.git/refs/remotes/origin/master
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/cheeba
+cheeba.gemspec
+lib/cheeba.rb
+lib/cheeba/defaults.rb
+lib/cheeba/errors.rb
+lib/cheeba/indicators.rb
+lib/cheeba/reader.rb
+lib/cheeba/reader/builder.rb
+lib/cheeba/reader/format.rb
+lib/cheeba/reader/node.rb
+lib/cheeba/reader/parser.rb
+lib/cheeba/version.rb
+lib/cheeba/writer.rb
+lib/cheeba/writer/builder.rb
+test/files/arrays.cash
+test/files/blank.cash
+test/files/comments.cash
+test/files/hashes.cash
+test/files/malformed.cash
+test/files/mixed.cash
+test/files/split.cash
+test/test_cheeba.rb
+test/test_reader.rb
+test/test_reader_builder.rb
+test/test_reader_format.rb
+test/test_reader_parser.rb
+test/test_writer.rb
+test/test_writer_builder.rb

data/README.txt

@@ -0,0 +1,35 @@
+= Cheeba
+
+* http://github.com/awesome/cheeba/tree/master
+* http://wiki.github.com/awesome/cheeba
+* http://awesomelicense.com
+* http://seattlerb.org
+* http://awesome.lighthouseapp.com/projects/23787-cheeba/
+
+== DESCRIPTION:
+
+Simple data serialization serialization for only the Ruby Programming Language.
+
+== FEATURES/PROBLEMS:
+
+* FIX (list of features or problems)
+
+== SYNOPSIS:
+
+*  FIX (code sample of usage)
+  
+== REQUIREMENTS:
+
+* FIX (list of requirements)
+
+== INSTALL:
+
+sudo gem install cheeba
+
+== LICENSE:
+
+(The Awesome License)
+
+Copyright (c) 2008 So Awesome Man
+
+Awesome License (Open Source) goes here!

data/Rakefile

@@ -0,0 +1,13 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+$:.unshift File.join(File.dirname(__FILE__), 'lib')
+require 'cheeba'
+
+require './lib/cheeba.rb'
+Hoe.new('cheeba', Cheeba::VERSION) do |p|
+  p.developer('So Awesome Man', 'callme@1800AWESO.ME')
+end
+
+# vim: syntax=Ruby

data/bin/cheeba

@@ -0,0 +1,68 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require 'optparse'
+require 'pp'
+
+$:.unshift File.join(File.dirname(__FILE__), '..', 'lib')
+require 'cheeba'
+
+module CheebaOpt
+  DESC = Cheeba::Defaults.descriptions
+  def self.command
+    hsh = {}
+    hsh[:opt] = {}
+    ops = nil
+    OptionParser.new do |opts|
+      opts.banner = "Cheeba #{Cheeba::VERSION}"
+      opts.on("-r", "--read FILENAME", String, String, ".cash file to Ruby Hash or Array") do |x|
+        hsh[:cmd] = 1
+        hsh[:arg] = [x]
+      end
+
+      opts.on("-w", "--write FILENAME,FILENAME", Array, "Hash or Array => .cash file") do |x|
+        hsh[:cmd] = 2
+        hsh[:arg] = x
+      end
+
+      opts.on("-d", "--dotfile [HOME]", String, "Create .cheeba dotfile") do |x|
+        x.nil? ? (y = Cheeba.dotfile) : (y = Cheeba.dotfile(x)) 
+        z = "#{File.dirname(y).chomp("/")}/.cheeba"
+        puts "existed: #{z}, moved to: #{y}" if File.basename(y) != ".cheeba"
+        puts "created: #{z}"
+        return
+      end
+
+      opts.on("-v", "--version", "Display verison number") do
+        STDOUT.write("Cheeba #{Cheeba::VERSION}\n\r") 
+        return
+      end
+
+      opts.on("-h", "--help", "Show this message") do
+        puts opts
+        return
+      end
+
+      Cheeba::Defaults.constants.sort.each do |x|
+        next if x == "DOTFILE"
+        opts.on("--[no-]#{x.downcase}", DESC[x.downcase]) do |y|
+          hsh[:opt]["#{x.downcase}".to_sym] = y 
+          puts "use options with --read or --write" && return if hsh[:cmd].nil?
+        end
+      end
+      ops = opts
+    end.parse!
+    puts ops unless hsh.has_key?(:cmd)
+    return unless hsh.has_key?(:cmd)
+    self.run(hsh[:cmd], hsh[:arg], hsh[:opt])
+  end
+  
+  def self.run(cmd, arg, opt)
+    x = Cheeba.read(arg[0], opt)
+    case cmd
+    when 1: pp x 
+    when 2: Cheeba.write(arg[0], arg[1], opt) 
+    end
+  end
+end
+
+CheebaOpt.command

data/cheeba.gemspec

@@ -0,0 +1,37 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{cheeba}
+  s.version = "1.0.4"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["So Awesome Man"]
+  s.date = %q{2009-04-20}
+  s.default_executable = %q{cheeba}
+  s.description = %q{Simple data serialization serialization for only the Ruby Programming Language.}
+  s.email = ["callme@1800AWESO.ME"]
+  s.executables = ["cheeba"]
+  s.extra_rdoc_files = ["History.txt", "Manifest.txt", "README.txt"]
+  s.files = ["History.txt", "Manifest.txt", "README.txt", "Rakefile", "bin/cheeba", "cheeba.gemspec", "lib/cheeba.rb", "lib/cheeba/defaults.rb", "lib/cheeba/errors.rb", "lib/cheeba/indicators.rb", "lib/cheeba/reader.rb", "lib/cheeba/reader/builder.rb", "lib/cheeba/reader/format.rb", "lib/cheeba/reader/node.rb", "lib/cheeba/reader/parser.rb", "lib/cheeba/version.rb", "lib/cheeba/writer.rb", "lib/cheeba/writer/builder.rb", "test/files/arrays.cash", "test/files/blank.cash", "test/files/comments.cash", "test/files/hashes.cash", "test/files/malformed.cash", "test/files/mixed.cash", "test/files/split.cash", "test/test_cheeba.rb", "test/test_reader.rb", "test/test_reader_builder.rb", "test/test_reader_format.rb", "test/test_reader_parser.rb", "test/test_writer.rb", "test/test_writer_builder.rb"]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/awesome/cheeba}
+  s.rdoc_options = ["--main", "README.txt"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{cheeba}
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{Simple data serialization serialization for only the Ruby Programming Language.}
+  s.test_files = ["test/test_cheeba.rb", "test/test_reader.rb", "test/test_reader_builder.rb", "test/test_reader_format.rb", "test/test_reader_parser.rb", "test/test_writer.rb", "test/test_writer_builder.rb"]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<hoe>, [">= 1.8.2"])
+    else
+      s.add_dependency(%q<hoe>, [">= 1.8.2"])
+    end
+  else
+    s.add_dependency(%q<hoe>, [">= 1.8.2"])
+  end
+end

data/lib/cheeba/defaults.rb

@@ -0,0 +1,78 @@
+module Cheeba
+  module Defaults
+    INT             = true
+    INT_KEYS        = false
+    INT_VALS        = false
+    SYMBOLIZE       = false
+    SYMBOLIZE_KEYS  = false
+    SYMBOLIZE_VALS  = false
+    SYM_STR         = false
+    SYM_STR_KEYS    = false
+    SYM_STR_VALS    = false
+    AUTO_SYM        = true
+    AUTO_SYM_KEYS   = false
+    AUTO_SYM_VALS   = false
+    AUTO_TRUE       = true
+    AUTO_TRUE_KEYS  = false
+    AUTO_TRUE_VALS  = false
+    STRIP           = true
+    STRIP_KEYS      = false
+    STRIP_VALS      = false
+    LIST            = false
+    DOT             = true
+    DOTFILE         = "#{ENV['HOME']}/.cheeba"
+    YAML            = false
+    DOCS            = false
+    
+    def self.descriptions
+      { "auto_sym"       => "conv keys & vals: \":both\" => :both",
+        "auto_sym_keys"  => "conv keys: \":key\" => :key",
+        "auto_sym_vals"  => "conv vals: \":val\" => :val",
+        "auto_true"      => "conv keys & vals: \"true\" => true",
+        "auto_true_keys" => "conv keys: \"true\" => true",
+        "auto_true_vals" => "conv vals: \"true\" => true",
+        "docs"           => "doc separator first level hash nodes",
+        "dot"            => "use dotfile if it exists",
+        "int"            => "conv keys & vals: \"1\" => 1",
+        "int_keys"       => "conv keys: \"1\" => 1",
+        "int_vals"       => "conv vals: \"1\" => 1",
+        "list"           => "return hash of addresses & comments",
+        "strip"          => "strip keys & vals: \" both \" => \"both\"",
+        "strip_keys"     => "strip keys: \" key \" => \"key\"",
+        "strip_vals"     => "strip vals: \" val \" => \"val\"",
+        "sym_str"        => "conv str (no int) k & v: \"b\" => :b",
+        "sym_str_keys"   => "conv string keys(no int): \"key\" => :key",
+        "sym_str_vals"   => "conv string vals(no int): \"val\" => :val",
+        "symbolize"      => "force conv keys & vals: \"both\" => :both",
+        "symbolize_keys" => "force conv keys: \"key\" => :key",
+        "symbolize_vals" => "force conv vals: \"val\" => :val",
+        "yaml"           => "write files with YAML type array syntax"}
+    end
+    
+    def self.options
+      { :int            => INT,
+        :int_keys       => INT_KEYS,
+        :int_vals       => INT_VALS,
+        :symbolize      => SYMBOLIZE, 
+        :symbolize_keys => SYMBOLIZE_KEYS, 
+        :symbolize_vals => SYMBOLIZE_VALS, 
+        :sym_str        => SYM_STR,
+        :sym_str_keys   => SYM_STR_KEYS,
+        :sym_str_vals   => SYM_STR_VALS, 
+        :auto_sym       => AUTO_SYM,
+        :auto_sym_keys  => AUTO_SYM_KEYS,
+        :auto_sym_vals  => AUTO_SYM_VALS,
+        :auto_true      => AUTO_TRUE,
+        :auto_true_keys => AUTO_TRUE_KEYS,
+        :auto_true_vals => AUTO_TRUE_VALS,
+        :strip          => STRIP,
+        :strip_keys     => STRIP_KEYS,
+        :strip_vals     => STRIP_VALS,
+        :list           => LIST,
+        :dot            => DOT,
+        :dotfile        => DOTFILE,
+        :yaml           => YAML,
+        :docs           => DOCS}
+    end
+  end
+end

data/lib/cheeba/errors.rb

@@ -0,0 +1,10 @@
+module Cheeba
+  module Errors
+    class EmptyFilenameError < StandardError; end
+    class EmptyInputError < StandardError; end
+    class InvalidInputError < StandardError; end
+    class InvalidFilenameError < StandardError; end
+  end
+end
+
+

data/lib/cheeba/indicators.rb

@@ -0,0 +1,25 @@
+module Cheeba
+  module Indicators
+    DOC_START   = '---'
+    DOC_TERM    = '...'
+    HASH        = ':'
+    SYMBOL      = ':'
+    ARRAY       = '-'
+    COMMENT     = '#'
+    LINE_END    = "\n"    
+    SPACE       = "\s"
+    INDENT      = 2
+    
+    def self.options
+      { :doc_start  => DOC_START,
+        :doc_term   => DOC_TERM,
+        :hash       => HASH,
+        :symbol     => SYMBOL,
+        :array      => ARRAY,
+        :comment    => COMMENT,
+        :line_end   => LINE_END,
+        :space      => SPACE,
+        :indent     => INDENT }
+    end
+  end
+end

data/lib/cheeba/reader/builder.rb

@@ -0,0 +1,265 @@
+module Cheeba
+  module Reader
+    module Builder
+      #
+      # Abbreviations:
+      # adr = address
+      # phs = parsed hash
+      # hsh = hash
+      # lst = list
+      # met = meta
+      # cur = current
+      # spc = spaces
+      # idt = indent
+      # idx = index
+      #
+      # dcs = doc_start
+      # dct = doc_term
+      # hpr = hsh_pair
+      # hky = hsh_key
+      # arr = array
+      # com = comment
+      # mal = malformed
+      # msg = message
+      # bla = blank
+      #
+      class RootNodeError < StandardError; end
+
+      ##
+      # adds parsed_hash of line to hash
+      #
+      def self.build(hsh, phs)
+        add = false
+        upd = nil  
+        msg = phs[:msg]
+        self.doc_new(hsh) if hsh.empty? && msg != "doc"
+        val = phs[:val]
+        lst = hsh[:lst]
+
+        unless [:com, :mal, :bla].include?(msg) 
+          cur = self.cur(hsh)
+          key = phs[:key]
+          spc = phs[:spc]
+          idt = phs[:opt][:indent]
+          adr = hsh[:adr]
+          idx = self.index(spc, idt) 
+          upd = self.update(adr, idx)
+          las = self.adr_obj(hsh, hsh[:adr])
+          add = true
+        end
+        
+        case msg
+        when :dcs: self.doc_start(hsh)
+        when :dct: self.doc_term(hsh)
+        when :hpr: self.hsh_pair(las, key, val)
+        when :hky: self.hsh_key(las, adr, key)
+        when :bla: self.blank(lst)
+        when :arr
+          raise RootNodeError if cur.is_a?(Hash) && !cur.empty? && spc == 0
+          if las.is_a?(Hash) && las.empty?
+            self.adr_obj_to_array(hsh, hsh[:adr])
+            las = self.adr_obj(hsh, hsh[:adr])
+          end
+          self.arr_parse(las, adr, val, upd) 
+        when :com: self.comment(lst, val)
+        when :mal: self.malformed(lst, val)
+        end
+        
+        self.add_to_list(lst, adr) if add
+      end
+
+      ##
+      # sub-parses array message, and logic from update-method
+      #
+      def self.arr_parse(las, adr, val, upd) 
+        case upd
+        when "eq": self.array_val(las, val)
+        when "lt": self.array_val(las, val)
+        when "gt": self.array_new(las, adr, val)
+        else; raise "error"
+        end
+      end
+      
+      ##
+      # current hash, returns array of "doc"
+      #
+      def self.cur(hsh)
+        hsh[hsh.length - 2]
+      end
+
+      ## 
+      # address array to string usable in eval on root node
+      # 
+      def self.to_adr(adr)
+        m = adr.map {|x|
+          case
+          when x.is_a?(Symbol): "[:#{x}]"
+          when x.is_a?(String): "['#{x}']"
+          when x.is_a?(Fixnum): "[#{x}]"
+          end
+        }
+        m.to_s
+      end
+
+      ## 
+      # returns the actual object at an address in tree
+      # 
+      def self.adr_obj(hsh, adr)
+        m = self.to_adr(adr)
+        eval("hsh#{m.to_s}")
+      end
+
+      ##
+      # converts an object in tree to empty array
+      #
+      def self.adr_obj_to_array(hsh, adr)
+        m = self.to_adr(adr)
+        eval("hsh#{m.to_s} = []")
+      end
+
+      ##
+      # calculates index based on spaces divided by indent unit
+      #
+      def self.index(spc, idt)
+        ((spc % idt) != 0) ? 0 : spc / idt
+      end
+
+      # if indentation less than before, jump up tree, remove extra indices
+      #
+      def self.update(adr, idx)
+        ret =  nil
+        len = (adr.length - 1)
+        if idx < len
+          # remove indices after current index
+          adr.replace(adr[0..idx])
+          ret = "lt" 
+        elsif idx == len
+          ret = "eq"
+        elsif idx > len
+          ret = "gt"
+        end
+        ret
+      end
+      
+      ##
+      # create keypair for new doc 
+      #
+      def self.doc_new(hsh)
+        hsh[:lst] ||= {}
+        hsh[:adr] ||= []
+        len = hsh.length - 1
+        hsh[len] = {}
+        hsh[:adr].clear
+        hsh[:adr] << len
+      end
+
+      ##
+      # new array in tree, provides logic for last modified object
+      #   
+      def self.array_new(las, adr, val)
+        case
+        when las.is_a?(Array) && las.empty?
+          x = [val]
+          las = x 
+          adr << las.rindex(x)
+        when las.is_a?(Array) && las.last.is_a?(String) && las.last.empty?
+          x = [val]
+          las[-1] = [val]
+          adr << las.rindex(x)
+        when las.is_a?(Array) 
+          x = [val]
+          las << x 
+          adr << las.rindex(x)
+        end
+      end
+
+      ##
+      # start document 
+      #
+      def self.doc_start(hsh)
+        self.doc_new(hsh)
+        self.add_to_list(hsh[:lst], "#DOC_START")
+      end
+
+      ##
+      # document terminate
+      #
+      def self.doc_term(hsh)
+        self.add_to_list(hsh[:lst], "#DOC_TERM")
+      end
+
+      ##
+      # add val to array in tree
+      #
+      def self.array_val(las, val)
+        case
+        # when x is a hash, it's already addressed
+        when las.is_a?(Array)
+          las << val
+        else
+          raise las.inspect
+        end
+      end
+
+      ##
+      # add hashkey to tree
+      #
+      def self.hsh_key(las, adr, key)
+        case
+        when las.is_a?(Hash)
+          las[key] = {}
+        when las.is_a?(Array)
+          x = {key => {}}
+          las << x
+          adr << las.rindex(x)
+        end
+        adr << key          
+      end
+
+      ##
+      # add hashpair to tree
+      #
+      def self.hsh_pair(las, key, val)
+        case
+        when las.is_a?(Array)
+          x = {key => val}
+          las << x
+        when las.is_a?(Hash)
+          las[key] = val
+        end
+      end
+      
+      ##
+      # list stores hsh addresses of lines, comments, etc.
+      #
+      def self.add_to_list(lst, adr)
+        case adr.class.to_s
+        when "String": x = adr 
+        when "Array":  x = adr.join(",")
+        end
+        lst[lst.length + 1] = x
+      end
+
+      ##
+      # add blank to list
+      #
+      def self.blank(lst)
+        self.add_to_list(lst, "#BLANK")
+      end
+      
+      ##
+      # add comment to list
+      #
+      def self.comment(lst, val)
+        lst[lst.length + 1] = "#COMMENT: #{val}"
+      end
+
+      ##
+      # add malformed to list
+      #
+      def self.malformed(lst, val)
+        lst[lst.length + 1] = "#MALFORMED: #{val}"
+      end
+    end
+  end
+end