elparser 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c146b65d433ec89e7357565a95dcca4381c2f6e6
+  data.tar.gz: 7dadc1c9fa424b5ca8586cc523477924c93fb4bc
+SHA512:
+  metadata.gz: 30307d68b5b13a897f237588d75a1330db7d25b008ad633bdcd1efdb327f6f545ce38fb5f2e35699759b1f4a75d12765cb6f3a3fec331a6d3ed7ccfcb41e5cce
+  data.tar.gz: 1d6d2343058ee730d581b940ee7bb371e3f0d9ce8da85a1b0f577f77ccd7fb33560249fbd0b498884863f531a94d64f01b146191132ccb5794c95003792ff46f

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 SAKURAI Masashi
+
+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,131 @@
+# Elparser
+
+A parser for S-expression of emacs lisp and some utilities.
+
+## Sample code
+
+### Parsing S-exp and getting ruby objects
+
+```ruby
+require 'elparser'
+
+parser = Elparser::Parser.new
+
+ # list and literals
+obj1 = parser.parse("(1 2.3 a \"b\" () (c 'd))")
+
+p obj1.to_ruby
+ # => [1, 2.3, :a, "b", nil, [:c, [:d]]]
+
+
+ # alist and hash
+obj2 = parser.parse("( (a . 1) (b . \"xxx\") (c 3 4) (\"d\" . \"e\"))")
+
+p obj2.to_ruby
+ # => [[:a, 1], [:b, "xxx"], [:c, 3, 4], ["d", "e"]] 
+
+p obj2.to_h
+ #  => {:a=>1, :b=>"xxx", :c=>[3, 4], "d"=>"e"} 
+```
+
+### Encoding ruby objects into S-exp
+
+```ruby
+p Elparser::encode([1,1.2,-4,"xxx",:www,true,nil])
+ # => "(1 1.2 -4 \"xxx\" www t nil)"
+ 
+p Elparser::encode({:a => [1,2,3], :b => {:c => [4,5,6]}})
+ # => "((a 1 2 3) (b (c 4 5 6)))"
+```
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'elparser'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install elparser
+
+
+## API Document
+
+### Parser
+
+The class `Elparser::Parser` is parser for emacs-lisp S-expression.
+The user program creates an instance of the class and parses the S-exp
+string with `parse` method.
+
+If the `parse` method succeed in parsing the given S-exp string, it
+returns a `SExp` object which is AST of S-exp. Invoking `to_ruby`
+method of the `SExp` object, one can obtain a ruby object.
+
+The `SExp` objects are instances of `SExpXXX` classes: `SExpNumber`,
+`SExpString`, `SExpSymbol`, `SExpNil`, `SExpCons`, `SExpList`,
+`SExpListDot` and `SExpQuoted`. Each classes represent corresponding
+S-exp objects.
+
+If the given S-exp list is an alist, invoking `SExpList#to_h` method,
+a `Hash` object can be obtained.
+
+### Encoder
+
+The module method `Elparser::encode` encodes the ruby objects into
+elisp S-expressions.
+
+If an object which is not defined in serialization rules is given,
+this method raises the exception `StandardError` with some messages.
+See the next section for the encoding detail.
+
+### Object Mapping
+
+The primitive objects are translated straightforwardly.
+
+#### Decoding (S-expression -> Ruby)
+
+A quoted expression is translated to an array.
+Both `nil` and `()` are translated to `nil`.
+Cons cells and lists are translated to arrays.
+
+| type             | S-exp (input)       | Ruby (output)        |
+|------------------+---------------------+---------------------|
+| integer          | `1`                 | `1`                 |
+| float            | `1.2`               | `1.2`               |
+| float            | `1e4`               | `1e4`               |
+| float            | `.45`               | `.45`               |
+| symbol           | `abc`               | `:abc`              |
+| string           | `"abc"`             | `"abc"`             |
+| quote            | `'abc`              | `[:abc]`            |
+| null             | `nil`               | `nil`               |
+| empty list       | `()`                | `nil`               |
+| list             | `(1 2)`             | `[1,2]`             |
+| nest list        | `(a (b))`           | `[:a [:b]]`         |
+| cons cell        | `(a . b)`           | `[:a,:b]`           |
+| dot list         | `(a b . d)`         | `[:a,:b,:c]`        |
+| alist(`to_ruby`) | `((a . 1) (b . 2))` | `[[:a,1],[:b,2]]`   |
+| alist(`to_h`)    | `((a . 1) (b . 2))` | `{:a=>1,:b=>2}`     |
+| alist list       | `((a 1 2) (b . 3))` | `{:a=>[1,2],:b=>3}` |
+
+#### Encoding (Ruby -> S-expression)
+
+The Array and Hash objects are translated to lists and alist
+respectively.  Cons cells and quoted expressions can't be expressed by
+any Ruby object.  If those S-expressions are needed, one can obtain
+such S-expressions with creating instances of `SExpCons` and
+`SExpQuoted` directly and calling the `to_s` method.
+
+| type       | Ruby (input)                             | S-exp (output)               |
+|------------+------------------------------------------+------------------------------|
+| primitive  | `[1,1.2,-4,"xxx",:www,true,nil]`         | `(1 1.2 -4 "xxx" www t nil)` |
+| empty list | `[]`                                     | `nil`                        |
+| nest list  | `[1,[2,[3,4]]]`                          | `(1 (2 (3 4)))`              |
+| hash       | `{"a" => "b", "c" => "d"}`               | `(("a" . "b") ("c" . "d"))`  |
+| hash       | `{:a => [1,2,3], :b => {:c => [4,5,6]}}` | `((a 1 2 3) (b (c 4 5 6)))`  |
+

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/elparser.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'elparser/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "elparser"
+  spec.version       = Elparser::VERSION
+  spec.authors       = ["SAKURAI Masashi"]
+  spec.email         = ["m.sakurai@kiwanami.net"]
+  spec.summary       = %q{A parser for S-expression of emacs lisp}
+  spec.description   = %q{A parser for S-expression of emacs lisp}
+  spec.homepage      = "https://github.com/kiwanami/ruby-elparser"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  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.extra_rdoc_files = ['readme.html']
+
+  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "racc", "~> 1.4"
+  spec.add_development_dependency "test-unit", "~> 3.0"
+end

data/lib/elparser/version.rb

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

data/lib/elparser.rb

@@ -0,0 +1,305 @@
+require "elparser/version"
+require 'elparser/parser.tab.rb'
+require 'strscan'
+
+module Elparser
+  
+  class AbstractSExp
+    def atom?
+      false
+    end
+    def cons?
+      false
+    end
+    def list?
+      false
+    end
+    def ==(obj)
+      self.class == obj.class && self.to_s == obj.to_s
+    end
+    def visit
+      raise "Not implemented!"
+    end
+    def to_ruby
+      raise "Not implemented!"
+    end
+  end
+
+  class AbstractSExpAtom < AbstractSExp
+    def atom?
+      true
+    end
+  end
+
+  class SExpNil < AbstractSExpAtom
+    def list?
+      true
+    end
+    def to_s
+      "nil"
+    end
+    def visit
+      # do nothing
+    end
+    def to_ruby
+      nil
+    end
+  end
+
+  class SExpSymbol < AbstractSExpAtom
+    attr_reader :name
+    def initialize(name)
+      @name = name
+    end
+    def to_s
+      @name
+    end
+    def to_ruby
+      @name.to_sym
+    end
+  end
+
+  class SExpString < AbstractSExpAtom
+    attr_reader :str
+    def initialize(str)
+      @str = str
+    end
+    def to_s
+      @str.dump
+    end
+    def to_ruby
+      @str
+    end
+  end
+  
+  class SExpNumber < AbstractSExpAtom
+    def self.int(val)
+      SExpNumber.new(:INTEGER, val)
+    end
+    def self.float(val)
+      SExpNumber.new(:FLOAT, val)
+    end
+
+    def initialize(type, val)
+      @type = type
+      @val = val
+    end
+    def value
+      case @type
+      when :INTEGER
+        @val.to_i
+      when :FLOAT
+        @val.to_f
+      else
+        raise "Unknown type #{@type}:#{@val}"
+      end
+    end
+    def to_s
+      @val
+    end
+    def to_ruby
+      value
+    end
+  end
+
+  class AbstractSExpCons < AbstractSExp
+    def cons?
+      true
+    end
+  end
+
+  class SExpCons < AbstractSExpCons
+    attr_reader :car, :cdr
+    def initialize(car, cdr)
+      @car = car
+      @cdr = cdr
+    end
+    def visit
+      @car = yield @car
+      @cdr = yield @cdr
+    end
+    def to_s
+      if @cdr.class == SExpList then
+        "(#{@car} "+@cdr.list.map{|i| i.to_s }.join(" ")+")"
+      else
+        "(#{@car} . #{@cdr})"
+      end
+    end
+    def to_ruby
+      [@car.to_ruby, @cdr.to_ruby]
+    end
+  end
+
+  class SExpList < AbstractSExpCons
+    attr_reader :list
+    def initialize(list)
+      @list = list
+    end
+    def car
+      @list[0]
+    end
+    def cdr
+      if @list.size == 1
+        SExpNil.new
+      else
+        SExpList.new @list.slice(1..-1)
+      end
+    end
+    def list?
+      true
+    end
+    def to_s
+      "("+@list.map{|i| i.to_s }.join(" ")+")"
+    end
+    def visit(&block)
+      @list = @list.map(&block)
+    end
+    def to_ruby
+      @list.map {|i| i.to_ruby}
+    end
+    def alist?
+      @list.all? {|i| i.cons? }
+    end
+    # alist -> hash
+    def to_h
+      ret = Hash.new
+      @list.each do |i|
+        ret[i.car.to_ruby] = i.cdr.to_ruby
+      end
+      ret
+    end
+  end
+
+  # (list . last)
+  class SExpListDot < AbstractSExpCons
+    def initialize(list, last)
+      @list = list
+      @last = last
+    end
+    def car
+      @list[0]
+    end
+    def cdr
+      if @list.size == 2 then
+        SExpCons.new(@list[1], @last)
+      else
+        SExpListDot.new(@list.slice(1..-1),@last)
+      end
+    end
+    def list?
+      false
+    end
+    def to_s
+      "("+@list.map{|i| i.to_s }.join(" ") + " . #{@last.to_s})"
+    end
+    def visit(&block)
+      @list = @list.map(&block)
+      @last = block.call(@last)
+    end
+    def to_ruby
+      @list.map {|i| i.to_ruby}.push(@last.to_ruby)
+    end
+  end
+
+  class SExpQuoted < AbstractSExp
+    def initialize(sexp)
+      @sexp = sexp
+    end
+    def to_s
+      "'#{@sexp.to_s}"
+    end
+    def visit(&blcok)
+      @sexp.visit(&block)
+    end
+    def to_ruby
+      [@sexp.to_ruby]
+    end
+  end
+
+  # parser class for 
+  class Parser
+
+    # parse s-expression string and return sexp objects.
+    def parse(str)
+      s = StringScanner.new str
+      @tokens = []
+
+      until s.eos?
+        s.skip(/\s+/) ? nil :
+          s.scan(/\A[-+]?[0-9]*\.[0-9]+(e[-+]?[0-9]+)?/i) ? (@tokens << [:FLOAT, s.matched]) :
+          s.scan(/\A[-+]?(0|[1-9]\d*)/)      ? (@tokens << [:INTEGER, s.matched]) :
+          s.scan(/\A\.(?=\s)/)               ? (@tokens << ['.', '.']) :
+          s.scan(/\A[a-z\-.\/_:*+=$][a-z\-.\/_:$*+=0-9]*/i) ? (@tokens << [:SYMBOL, s.matched]) :
+          s.scan(/\A"(([^\\"]|\\.)*)"/)        ? (@tokens << [:STRING, s.matched.slice(1...-1)])  :
+          s.scan(/\A./)                      ? (a = s.matched; @tokens << [a, a]) :
+          (raise "scanner error")
+      end
+      @tokens.push [false, '$end']
+      
+      normalize do_parse
+    end
+
+    def next_token
+      @tokens.shift
+    end
+
+    # replace special symbols
+    def normalize(ast)
+      if ast.class == SExpSymbol
+        case ast.name
+        when "nil"
+          return SExpNil.new
+        else
+          return ast
+        end
+      elsif ast.cons? then
+        ast.visit do |i|
+          normalize(i)
+        end
+      end
+      return ast
+    end
+  end
+
+  
+  # translate ruby objects to s-expression string.
+  def self.encode(arg)
+    return _encode(arg).to_s
+  end
+
+  private 
+
+  def self._encode(arg)
+    return "nil" if arg.nil?
+    c = arg.class
+    if c ==  Fixnum then
+      return SExpNumber.new :INTEGER, arg.to_s
+    elsif c ==  Float then
+      return SExpNumber.new :FLOAT, arg.to_s
+    elsif c ==  String then
+      return SExpString.new arg
+    elsif c ==  Symbol then
+      return SExpSymbol.new arg.to_s
+    elsif c ==  Array then
+      return _encode_array(arg)
+    elsif c ==  Hash then
+      return _encode_hash(arg)
+    elsif c ==  TrueClass then
+      return SExpSymbol.new "t"
+    elsif c ==  FalseClass then
+      return SExpNil.new
+    end
+    raise "Can't encode object : #{arg}"
+  end
+
+  def self._encode_array(arg)
+    return SExpNil.new if arg.nil? || arg.size == 0
+    return SExpList.new arg.map{|i| _encode(i)}
+  end
+
+  def self._encode_hash(arg)
+    return SExpNil.new if arg.nil? || arg.size == 0
+    return SExpList.new arg.map{|k,v| SExpCons.new(_encode(k),_encode(v))}
+  end
+
+end

data/readme.html

@@ -0,0 +1,226 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+  <meta http-equiv="Content-Style-Type" content="text/css" />
+  <meta name="generator" content="pandoc" />
+  <title></title>
+  <style type="text/css">code{white-space: pre;}</style>
+  <style type="text/css">
+table.sourceCode, tr.sourceCode, td.lineNumbers, td.sourceCode {
+  margin: 0; padding: 0; vertical-align: baseline; border: none; }
+table.sourceCode { width: 100%; line-height: 100%; }
+td.lineNumbers { text-align: right; padding-right: 4px; padding-left: 4px; color: #aaaaaa; border-right: 1px solid #aaaaaa; }
+td.sourceCode { padding-left: 5px; }
+code > span.kw { color: #007020; font-weight: bold; }
+code > span.dt { color: #902000; }
+code > span.dv { color: #40a070; }
+code > span.bn { color: #40a070; }
+code > span.fl { color: #40a070; }
+code > span.ch { color: #4070a0; }
+code > span.st { color: #4070a0; }
+code > span.co { color: #60a0b0; font-style: italic; }
+code > span.ot { color: #007020; }
+code > span.al { color: #ff0000; font-weight: bold; }
+code > span.fu { color: #06287e; }
+code > span.er { color: #ff0000; font-weight: bold; }
+  </style>
+  <link href="data:text/css,body%20%7B%0A%20%20font%2Dfamily%3A%20Helvetica%2C%20arial%2C%20sans%2Dserif%3B%0A%20%20font%2Dsize%3A%2014px%3B%0A%20%20margin%3A%200%20auto%3B%0A%20%20max%2Dwidth%3A%20790px%3B%0A%20%20line%2Dheight%3A%201%2E6%3B%0A%20%20padding%2Dtop%3A%2010px%3B%0A%20%20padding%2Dbottom%3A%2010px%3B%0A%20%20background%2Dcolor%3A%20white%3B%0A%20%20padding%3A%2030px%3B%20%7D%0A%0Abody%20%3E%20%2A%3Afirst%2Dchild%20%7B%0A%20%20margin%2Dtop%3A%200%20%21important%3B%20%7D%0Abody%20%3E%20%2A%3Alast%2Dchild%20%7B%0A%20%20margin%2Dbottom%3A%200%20%21important%3B%20%7D%0A%0Aa%20%7B%0A%20%20color%3A%20%234183C4%3B%20%7D%0Aa%2Eabsent%20%7B%0A%20%20color%3A%20%23cc0000%3B%20%7D%0Aa%2Eanchor%20%7B%0A%20%20display%3A%20block%3B%0A%20%20padding%2Dleft%3A%2030px%3B%0A%20%20margin%2Dleft%3A%20%2D30px%3B%0A%20%20cursor%3A%20pointer%3B%0A%20%20position%3A%20absolute%3B%0A%20%20top%3A%200%3B%0A%20%20left%3A%200%3B%0A%20%20bottom%3A%200%3B%20%7D%0A%0Ah1%20a%2C%20h2%20a%2C%20h3%20a%2C%20h4%20a%2C%20h5%20a%2C%20h6%20a%20%7B%0A%20%20color%3A%20black%20%21important%3B%0A%20%20text%2Ddecoration%3A%20none%20%21important%3B%0A%7D%0A%0Ah1%2C%20h2%2C%20h3%2C%20h4%2C%20h5%2C%20h6%20%7B%0A%20%20margin%3A%2020px%200%2010px%3B%0A%20%20padding%3A%200%3B%0A%20%20font%2Dweight%3A%20bold%3B%0A%20%20%2Dwebkit%2Dfont%2Dsmoothing%3A%20antialiased%3B%0A%20%20cursor%3A%20text%3B%0A%20%20position%3A%20relative%3B%20%7D%0A%0Ah1%3Ahover%20a%2Eanchor%2C%20h2%3Ahover%20a%2Eanchor%2C%20h3%3Ahover%20a%2Eanchor%2C%20h4%3Ahover%20a%2Eanchor%2C%20h5%3Ahover%20a%2Eanchor%2C%20h6%3Ahover%20a%2Eanchor%20%7B%0A%20%20background%3A%20url%28data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8%2F9hAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAA09pVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw%2FeHBhY2tldCBiZWdpbj0i77u%2FIiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8%2BIDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuMy1jMDExIDY2LjE0NTY2MSwgMjAxMi8wMi8wNi0xNDo1NjoyNyAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIENTNiAoMTMuMCAyMDEyMDMwNS5tLjQxNSAyMDEyLzAzLzA1OjIxOjAwOjAwKSAgKE1hY2ludG9zaCkiIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6OUM2NjlDQjI4ODBGMTFFMTg1ODlEODNERDJBRjUwQTQiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6OUM2NjlDQjM4ODBGMTFFMTg1ODlEODNERDJBRjUwQTQiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0ieG1wLmlpZDo5QzY2OUNCMDg4MEYxMUUxODU4OUQ4M0REMkFGNTBBNCIgc3RSZWY6ZG9jdW1lbnRJRD0ieG1wLmRpZDo5QzY2OUNCMTg4MEYxMUUxODU4OUQ4M0REMkFGNTBBNCIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI%2FPsQhXeAAAABfSURBVHjaYvz%2F%2Fz8DJYCRUgMYQAbAMBQIAvEqkBQWXI6sHqwHiwG70TTBxGaiWwjCTGgOUgJiF1J8wMRAIUA34B4Q76HUBelAfJYSA0CuMIEaRP8wGIkGMA54bgQIMACAmkXJi0hKJQAAAABJRU5ErkJggg%3D%3D%29%20no%2Drepeat%2010px%20center%3B%0A%20%20text%2Ddecoration%3A%20none%3B%20%7D%0A%0Ah1%20tt%2C%20h1%20code%20%7B%0A%20%20font%2Dsize%3A%20inherit%3B%20%7D%0A%0Ah2%20tt%2C%20h2%20code%20%7B%0A%20%20font%2Dsize%3A%20inherit%3B%20%7D%0A%0Ah3%20tt%2C%20h3%20code%20%7B%0A%20%20font%2Dsize%3A%20inherit%3B%20%7D%0A%0Ah4%20tt%2C%20h4%20code%20%7B%0A%20%20font%2Dsize%3A%20inherit%3B%20%7D%0A%0Ah5%20tt%2C%20h5%20code%20%7B%0A%20%20font%2Dsize%3A%20inherit%3B%20%7D%0A%0Ah6%20tt%2C%20h6%20code%20%7B%0A%20%20font%2Dsize%3A%20inherit%3B%20%7D%0A%0Ah1%20%7B%0A%20%20font%2Dsize%3A%2028px%3B%0A%20%20color%3A%20black%3B%20%7D%0A%0Ah2%20%7B%0A%20%20font%2Dsize%3A%2024px%3B%0A%20%20border%2Dbottom%3A%201px%20solid%20%23cccccc%3B%0A%20%20color%3A%20black%3B%20%7D%0A%0Ah3%20%7B%0A%20%20font%2Dsize%3A%2018px%3B%20%7D%0A%0Ah4%20%7B%0A%20%20font%2Dsize%3A%2016px%3B%20%7D%0A%0Ah5%20%7B%0A%20%20font%2Dsize%3A%2014px%3B%20%7D%0A%0Ah6%20%7B%0A%20%20color%3A%20%23777777%3B%0A%20%20font%2Dsize%3A%2014px%3B%20%7D%0A%0Ap%2C%20blockquote%2C%20ul%2C%20ol%2C%20dl%2C%20li%2C%20table%2C%20pre%20%7B%0A%20%20margin%3A%2015px%200%3B%20%7D%0A%0Ahr%20%7B%0A%20%20background%3A%20transparent%20url%28data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAAAYAAAAECAYAAACtBE5DAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAyJpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw%2FeHBhY2tldCBiZWdpbj0i77u%2FIiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8%2BIDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuMC1jMDYwIDYxLjEzNDc3NywgMjAxMC8wMi8xMi0xNzozMjowMCAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RSZWY9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZVJlZiMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIENTNSBNYWNpbnRvc2giIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6OENDRjNBN0E2NTZBMTFFMEI3QjRBODM4NzJDMjlGNDgiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6OENDRjNBN0I2NTZBMTFFMEI3QjRBODM4NzJDMjlGNDgiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0ieG1wLmlpZDo4Q0NGM0E3ODY1NkExMUUwQjdCNEE4Mzg3MkMyOUY0OCIgc3RSZWY6ZG9jdW1lbnRJRD0ieG1wLmRpZDo4Q0NGM0E3OTY1NkExMUUwQjdCNEE4Mzg3MkMyOUY0OCIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI%2FPqqezsUAAAAfSURBVHjaYmRABcYwBiM2QSA4y4hNEKYDQxAEAAIMAHNGAzhkPOlYAAAAAElFTkSuQmCC%29%20repeat%2Dx%200%200%3B%0A%20%20border%3A%200%20none%3B%0A%20%20color%3A%20%23cccccc%3B%0A%20%20height%3A%204px%3B%0A%20%20padding%3A%200%3B%20%7D%0A%0Abody%20%3E%20h2%3Afirst%2Dchild%20%7B%0A%20%20margin%2Dtop%3A%200%3B%0A%20%20padding%2Dtop%3A%200%3B%20%7D%0Abody%20%3E%20h1%3Afirst%2Dchild%20%7B%0A%20%20margin%2Dtop%3A%200%3B%0A%20%20padding%2Dtop%3A%200%3B%20%7D%0A%20%20body%20%3E%20h1%3Afirst%2Dchild%20%2B%20h2%20%7B%0A%20%20%20%20margin%2Dtop%3A%200%3B%0A%20%20%20%20padding%2Dtop%3A%200%3B%20%7D%0Abody%20%3E%20h3%3Afirst%2Dchild%2C%20body%20%3E%20h4%3Afirst%2Dchild%2C%20body%20%3E%20h5%3Afirst%2Dchild%2C%20body%20%3E%20h6%3Afirst%2Dchild%20%7B%0A%20%20margin%2Dtop%3A%200%3B%0A%20%20padding%2Dtop%3A%200%3B%20%7D%0A%0Aa%3Afirst%2Dchild%20h1%2C%20a%3Afirst%2Dchild%20h2%2C%20a%3Afirst%2Dchild%20h3%2C%20a%3Afirst%2Dchild%20h4%2C%20a%3Afirst%2Dchild%20h5%2C%20a%3Afirst%2Dchild%20h6%20%7B%0A%20%20margin%2Dtop%3A%200%3B%0A%20%20padding%2Dtop%3A%200%3B%20%7D%0A%0Ah1%20p%2C%20h2%20p%2C%20h3%20p%2C%20h4%20p%2C%20h5%20p%2C%20h6%20p%20%7B%0A%20%20margin%2Dtop%3A%200%3B%20%7D%0A%0Ali%20p%2Efirst%20%7B%0A%20%20display%3A%20inline%2Dblock%3B%20%7D%0A%0Aul%2C%20ol%20%7B%0A%20%20padding%2Dleft%3A%2030px%3B%20%7D%0A%0Aul%20%3Afirst%2Dchild%2C%20ol%20%3Afirst%2Dchild%20%7B%0A%20%20margin%2Dtop%3A%200%3B%20%7D%0A%0Aul%20%3Alast%2Dchild%2C%20ol%20%3Alast%2Dchild%20%7B%0A%20%20margin%2Dbottom%3A%200%3B%20%7D%0A%0Adl%20%7B%0A%20%20padding%3A%200%3B%20%7D%0A%20%20dl%20dt%20%7B%0A%20%20%20%20font%2Dsize%3A%2014px%3B%0A%20%20%20%20font%2Dweight%3A%20bold%3B%0A%20%20%20%20font%2Dstyle%3A%20italic%3B%0A%20%20%20%20padding%3A%200%3B%0A%20%20%20%20margin%3A%2015px%200%205px%3B%20%7D%0A%20%20%20%20dl%20dt%3Afirst%2Dchild%20%7B%0A%20%20%20%20%20%20padding%3A%200%3B%20%7D%0A%20%20%20%20dl%20dt%20%3E%20%3Afirst%2Dchild%20%7B%0A%20%20%20%20%20%20margin%2Dtop%3A%200%3B%20%7D%0A%20%20%20%20dl%20dt%20%3E%20%3Alast%2Dchild%20%7B%0A%20%20%20%20%20%20margin%2Dbottom%3A%200%3B%20%7D%0A%20%20dl%20dd%20%7B%0A%20%20%20%20margin%3A%200%200%2015px%3B%0A%20%20%20%20padding%3A%200%2015px%3B%20%7D%0A%20%20%20%20dl%20dd%20%3E%20%3Afirst%2Dchild%20%7B%0A%20%20%20%20%20%20margin%2Dtop%3A%200%3B%20%7D%0A%20%20%20%20dl%20dd%20%3E%20%3Alast%2Dchild%20%7B%0A%20%20%20%20%20%20margin%2Dbottom%3A%200%3B%20%7D%0A%0Ablockquote%20%7B%0A%20%20border%2Dleft%3A%204px%20solid%20%23dddddd%3B%0A%20%20padding%3A%200%2015px%3B%0A%20%20color%3A%20%23777777%3B%20%7D%0A%20%20blockquote%20%3E%20%3Afirst%2Dchild%20%7B%0A%20%20%20%20margin%2Dtop%3A%200%3B%20%7D%0A%20%20blockquote%20%3E%20%3Alast%2Dchild%20%7B%0A%20%20%20%20margin%2Dbottom%3A%200%3B%20%7D%0A%0Atable%20%7B%0A%20%20padding%3A%200%3B%20%7D%0A%20%20table%20tr%20%7B%0A%20%20%20%20border%2Dtop%3A%201px%20solid%20%23cccccc%3B%0A%20%20%20%20background%2Dcolor%3A%20white%3B%0A%20%20%20%20margin%3A%200%3B%0A%20%20%20%20padding%3A%200%3B%20%7D%0A%20%20%20%20table%20tr%3Anth%2Dchild%282n%29%20%7B%0A%20%20%20%20%20%20background%2Dcolor%3A%20%23f8f8f8%3B%20%7D%0A%20%20%20%20table%20tr%20th%20%7B%0A%20%20%20%20%20%20font%2Dweight%3A%20bold%3B%0A%20%20%20%20%20%20border%3A%201px%20solid%20%23cccccc%3B%0A%20%20%20%20%20%20text%2Dalign%3A%20left%3B%0A%20%20%20%20%20%20margin%3A%200%3B%0A%20%20%20%20%20%20padding%3A%206px%2013px%3B%20%7D%0A%20%20%20%20table%20tr%20td%20%7B%0A%20%20%20%20%20%20border%3A%201px%20solid%20%23cccccc%3B%0A%20%20%20%20%20%20text%2Dalign%3A%20left%3B%0A%20%20%20%20%20%20margin%3A%200%3B%0A%20%20%20%20%20%20padding%3A%206px%2013px%3B%20%7D%0A%20%20%20%20table%20tr%20th%20%3Afirst%2Dchild%2C%20table%20tr%20td%20%3Afirst%2Dchild%20%7B%0A%20%20%20%20%20%20margin%2Dtop%3A%200%3B%20%7D%0A%20%20%20%20table%20tr%20th%20%3Alast%2Dchild%2C%20table%20tr%20td%20%3Alast%2Dchild%20%7B%0A%20%20%20%20%20%20margin%2Dbottom%3A%200%3B%20%7D%0A%0Aimg%20%7B%0A%20%20max%2Dwidth%3A%20100%25%3B%20%7D%0A%0Aspan%2Eframe%20%7B%0A%20%20display%3A%20block%3B%0A%20%20overflow%3A%20hidden%3B%20%7D%0A%20%20span%2Eframe%20%3E%20span%20%7B%0A%20%20%20%20border%3A%201px%20solid%20%23dddddd%3B%0A%20%20%20%20display%3A%20block%3B%0A%20%20%20%20float%3A%20left%3B%0A%20%20%20%20overflow%3A%20hidden%3B%0A%20%20%20%20margin%3A%2013px%200%200%3B%0A%20%20%20%20padding%3A%207px%3B%0A%20%20%20%20width%3A%20auto%3B%20%7D%0A%20%20span%2Eframe%20span%20img%20%7B%0A%20%20%20%20display%3A%20block%3B%0A%20%20%20%20float%3A%20left%3B%20%7D%0A%20%20span%2Eframe%20span%20span%20%7B%0A%20%20%20%20clear%3A%20both%3B%0A%20%20%20%20color%3A%20%23333333%3B%0A%20%20%20%20display%3A%20block%3B%0A%20%20%20%20padding%3A%205px%200%200%3B%20%7D%0Aspan%2Ealign%2Dcenter%20%7B%0A%20%20display%3A%20block%3B%0A%20%20overflow%3A%20hidden%3B%0A%20%20clear%3A%20both%3B%20%7D%0A%20%20span%2Ealign%2Dcenter%20%3E%20span%20%7B%0A%20%20%20%20display%3A%20block%3B%0A%20%20%20%20overflow%3A%20hidden%3B%0A%20%20%20%20margin%3A%2013px%20auto%200%3B%0A%20%20%20%20text%2Dalign%3A%20center%3B%20%7D%0A%20%20span%2Ealign%2Dcenter%20span%20img%20%7B%0A%20%20%20%20margin%3A%200%20auto%3B%0A%20%20%20%20text%2Dalign%3A%20center%3B%20%7D%0Aspan%2Ealign%2Dright%20%7B%0A%20%20display%3A%20block%3B%0A%20%20overflow%3A%20hidden%3B%0A%20%20clear%3A%20both%3B%20%7D%0A%20%20span%2Ealign%2Dright%20%3E%20span%20%7B%0A%20%20%20%20display%3A%20block%3B%0A%20%20%20%20overflow%3A%20hidden%3B%0A%20%20%20%20margin%3A%2013px%200%200%3B%0A%20%20%20%20text%2Dalign%3A%20right%3B%20%7D%0A%20%20span%2Ealign%2Dright%20span%20img%20%7B%0A%20%20%20%20margin%3A%200%3B%0A%20%20%20%20text%2Dalign%3A%20right%3B%20%7D%0Aspan%2Efloat%2Dleft%20%7B%0A%20%20display%3A%20block%3B%0A%20%20margin%2Dright%3A%2013px%3B%0A%20%20overflow%3A%20hidden%3B%0A%20%20float%3A%20left%3B%20%7D%0A%20%20span%2Efloat%2Dleft%20span%20%7B%0A%20%20%20%20margin%3A%2013px%200%200%3B%20%7D%0Aspan%2Efloat%2Dright%20%7B%0A%20%20display%3A%20block%3B%0A%20%20margin%2Dleft%3A%2013px%3B%0A%20%20overflow%3A%20hidden%3B%0A%20%20float%3A%20right%3B%20%7D%0A%20%20span%2Efloat%2Dright%20%3E%20span%20%7B%0A%20%20%20%20display%3A%20block%3B%0A%20%20%20%20overflow%3A%20hidden%3B%0A%20%20%20%20margin%3A%2013px%20auto%200%3B%0A%20%20%20%20text%2Dalign%3A%20right%3B%20%7D%0A%0Acode%2C%20tt%20%7B%0A%20%20margin%3A%200%202px%3B%0A%20%20padding%3A%200%205px%3B%0A%20%20white%2Dspace%3A%20nowrap%3B%0A%20%20border%3A%201px%20solid%20%23eaeaea%3B%0A%20%20background%2Dcolor%3A%20%23f8f8f8%3B%0A%20%20border%2Dradius%3A%203px%3B%20%7D%0A%0Apre%20code%20%7B%0A%20%20margin%3A%200%3B%0A%20%20padding%3A%200%3B%0A%20%20white%2Dspace%3A%20pre%3B%0A%20%20border%3A%20none%3B%0A%20%20background%3A%20transparent%3B%20%7D%0A%0A%2Ehighlight%20pre%20%7B%0A%20%20background%2Dcolor%3A%20%23f8f8f8%3B%0A%20%20border%3A%201px%20solid%20%23cccccc%3B%0A%20%20font%2Dsize%3A%2013px%3B%0A%20%20line%2Dheight%3A%2019px%3B%0A%20%20overflow%3A%20auto%3B%0A%20%20padding%3A%206px%2010px%3B%0A%20%20border%2Dradius%3A%203px%3B%20%7D%0A%0Apre%20%7B%0A%20%20background%2Dcolor%3A%20%23f8f8f8%3B%0A%20%20border%3A%201px%20solid%20%23cccccc%3B%0A%20%20font%2Dsize%3A%2013px%3B%0A%20%20line%2Dheight%3A%2019px%3B%0A%20%20overflow%3A%20auto%3B%0A%20%20padding%3A%206px%2010px%3B%0A%20%20border%2Dradius%3A%203px%3B%20%7D%0A%20%20pre%20code%2C%20pre%20tt%20%7B%0A%20%20%20%20background%2Dcolor%3A%20transparent%3B%0A%20%20%20%20border%3A%20none%3B%20%7D%0A%0A%2Efigure%20%7B%0A%20%20%20display%3A%20block%3B%0A%20%20%20text%2Dalign%3A%20center%3B%0A%20%20%20margin%3A%2010px%200%2010px%200%3B%0A%20%20%20padding%3A%2010px%2010px%200px%2010px%3B%0A%20%20%20border%3A%202px%20solid%20%23eaeaea%3B%0A%20%20%20background%2Dcolor%3A%20%23f8f8f8%3B%0A%20%20%20border%2Dradius%3A%203px%3B%0A%7D%0A%0A%2Efigure%20img%20%7B%0A%20%20%20max%2Dwidth%3A%20700px%3B%0A%20%20%20background%2Dcolor%3A%20white%3B%0A%7D%0A%0A%2Ecaption%20%7B%0A%20%20%20font%2Dsize%3A%2016px%3B%0A%20%20%20font%2Dweight%3A%20bold%3B%0A%20%20%20%2Dwebkit%2Dfont%2Dsmoothing%3A%20antialiased%3B%0A%7D%0A" rel="stylesheet" type="text/css" />
+</head>
+<body>
+<div id="TOC">
+<ul>
+<li><a href="#elparser">Elparser</a><ul>
+<li><a href="#sample-code">Sample code</a><ul>
+<li><a href="#parsing-s-exp-and-getting-ruby-objects">Parsing S-exp and getting ruby objects</a></li>
+<li><a href="#encoding-ruby-objects-into-s-exp">Encoding ruby objects into S-exp</a></li>
+</ul></li>
+<li><a href="#installation">Installation</a></li>
+<li><a href="#api-document">API Document</a><ul>
+<li><a href="#parser">Parser</a></li>
+<li><a href="#encoder">Encoder</a></li>
+<li><a href="#object-mapping">Object Mapping</a></li>
+</ul></li>
+</ul></li>
+</ul>
+</div>
+<h1 id="elparser"><a href="#elparser">Elparser</a></h1>
+<p>A parser for S-expression of emacs lisp and some utilities.</p>
+<h2 id="sample-code"><a href="#sample-code">Sample code</a></h2>
+<h3 id="parsing-s-exp-and-getting-ruby-objects"><a href="#parsing-s-exp-and-getting-ruby-objects">Parsing S-exp and getting ruby objects</a></h3>
+<pre class="sourceCode ruby"><code class="sourceCode ruby">require <span class="st">'elparser'</span>
+
+parser = <span class="dt">Elparser</span>::<span class="dt">Parser</span>.new
+
+ <span class="co"># list and literals</span>
+obj1 = parser.parse(<span class="st">&quot;(1 2.3 a \&quot;b\&quot; () (c 'd))&quot;</span>)
+
+p obj1.to_ruby
+ <span class="co"># =&gt; [1, 2.3, :a, &quot;b&quot;, nil, [:c, [:d]]]</span>
+
+
+ <span class="co"># alist and hash</span>
+obj2 = parser.parse(<span class="st">&quot;( (a . 1) (b . \&quot;xxx\&quot;) (c 3 4) (\&quot;d\&quot; . \&quot;e\&quot;))&quot;</span>)
+
+p obj2.to_ruby
+ <span class="co"># =&gt; [[:a, 1], [:b, &quot;xxx&quot;], [:c, 3, 4], [&quot;d&quot;, &quot;e&quot;]] </span>
+
+p obj2.to_h
+ <span class="co">#  =&gt; {:a=&gt;1, :b=&gt;&quot;xxx&quot;, :c=&gt;[3, 4], &quot;d&quot;=&gt;&quot;e&quot;} </span></code></pre>
+<h3 id="encoding-ruby-objects-into-s-exp"><a href="#encoding-ruby-objects-into-s-exp">Encoding ruby objects into S-exp</a></h3>
+<pre class="sourceCode ruby"><code class="sourceCode ruby">p <span class="dt">Elparser</span>::encode([<span class="dv">1</span>,<span class="fl">1.2</span>,-<span class="dv">4</span>,<span class="st">&quot;xxx&quot;</span>,<span class="st">:www</span>,<span class="dv">true</span>,<span class="dv">nil</span>])
+ <span class="co"># =&gt; &quot;(1 1.2 -4 \&quot;xxx\&quot; www t nil)&quot;</span>
+ 
+p <span class="dt">Elparser</span>::encode({<span class="st">:a</span> =&gt; [<span class="dv">1</span>,<span class="dv">2</span>,<span class="dv">3</span>], <span class="st">:b</span> =&gt; {<span class="st">:c</span> =&gt; [<span class="dv">4</span>,<span class="dv">5</span>,<span class="dv">6</span>]}})
+ <span class="co"># =&gt; &quot;((a 1 2 3) (b (c 4 5 6)))&quot;</span></code></pre>
+<h2 id="installation"><a href="#installation">Installation</a></h2>
+<p>Add this line to your application's Gemfile:</p>
+<pre class="sourceCode ruby"><code class="sourceCode ruby">gem <span class="st">'elparser'</span></code></pre>
+<p>And then execute:</p>
+<pre><code>$ bundle</code></pre>
+<p>Or install it yourself as:</p>
+<pre><code>$ gem install elparser</code></pre>
+<h2 id="api-document"><a href="#api-document">API Document</a></h2>
+<h3 id="parser"><a href="#parser">Parser</a></h3>
+<p>The class <code>Elparser::Parser</code> is parser for emacs-lisp S-expression. The user program creates an instance of the class and parses the S-exp string with <code>parse</code> method.</p>
+<p>If the <code>parse</code> method succeed in parsing the given S-exp string, it returns a <code>SExp</code> object which is AST of S-exp. Invoking <code>to_ruby</code> method of the <code>SExp</code> object, one can obtain a ruby object.</p>
+<p>The <code>SExp</code> objects are instances of <code>SExpXXX</code> classes: <code>SExpNumber</code>, <code>SExpString</code>, <code>SExpSymbol</code>, <code>SExpNil</code>, <code>SExpCons</code>, <code>SExpList</code>, <code>SExpListDot</code> and <code>SExpQuoted</code>. Each classes represent corresponding S-exp objects.</p>
+<p>If the given S-exp list is an alist, invoking <code>SExpList#to_h</code> method, a <code>Hash</code> object can be obtained.</p>
+<h3 id="encoder"><a href="#encoder">Encoder</a></h3>
+<p>The module method <code>Elparser::encode</code> encodes the ruby objects into elisp S-expressions.</p>
+<p>If an object which is not defined in serialization rules is given, this method raises the exception <code>StandardError</code> with some messages. See the next section for the encoding detail.</p>
+<h3 id="object-mapping"><a href="#object-mapping">Object Mapping</a></h3>
+<p>The primitive objects are translated straightforwardly.</p>
+<h4 id="decoding-s-expression---ruby"><a href="#decoding-s-expression---ruby">Decoding (S-expression -&gt; Ruby)</a></h4>
+<p>A quoted expression is translated to an array. Both <code>nil</code> and <code>()</code> are translated to <code>nil</code>. Cons cells and lists are translated to arrays.</p>
+<table>
+<thead>
+<tr class="header">
+<th align="left">type</th>
+<th align="left">S-exp (input)</th>
+<th align="left">Ruby (output)</th>
+</tr>
+</thead>
+<tbody>
+<tr class="odd">
+<td align="left">integer</td>
+<td align="left"><code>1</code></td>
+<td align="left"><code>1</code></td>
+</tr>
+<tr class="even">
+<td align="left">float</td>
+<td align="left"><code>1.2</code></td>
+<td align="left"><code>1.2</code></td>
+</tr>
+<tr class="odd">
+<td align="left">float</td>
+<td align="left"><code>1e4</code></td>
+<td align="left"><code>1e4</code></td>
+</tr>
+<tr class="even">
+<td align="left">float</td>
+<td align="left"><code>.45</code></td>
+<td align="left"><code>.45</code></td>
+</tr>
+<tr class="odd">
+<td align="left">symbol</td>
+<td align="left"><code>abc</code></td>
+<td align="left"><code>:abc</code></td>
+</tr>
+<tr class="even">
+<td align="left">string</td>
+<td align="left"><code>&quot;abc&quot;</code></td>
+<td align="left"><code>&quot;abc&quot;</code></td>
+</tr>
+<tr class="odd">
+<td align="left">quote</td>
+<td align="left"><code>'abc</code></td>
+<td align="left"><code>[:abc]</code></td>
+</tr>
+<tr class="even">
+<td align="left">null</td>
+<td align="left"><code>nil</code></td>
+<td align="left"><code>nil</code></td>
+</tr>
+<tr class="odd">
+<td align="left">empty list</td>
+<td align="left"><code>()</code></td>
+<td align="left"><code>nil</code></td>
+</tr>
+<tr class="even">
+<td align="left">list</td>
+<td align="left"><code>(1 2)</code></td>
+<td align="left"><code>[1,2]</code></td>
+</tr>
+<tr class="odd">
+<td align="left">nest list</td>
+<td align="left"><code>(a (b))</code></td>
+<td align="left"><code>[:a [:b]]</code></td>
+</tr>
+<tr class="even">
+<td align="left">cons cell</td>
+<td align="left"><code>(a . b)</code></td>
+<td align="left"><code>[:a,:b]</code></td>
+</tr>
+<tr class="odd">
+<td align="left">dot list</td>
+<td align="left"><code>(a b . d)</code></td>
+<td align="left"><code>[:a,:b,:c]</code></td>
+</tr>
+<tr class="even">
+<td align="left">alist(<code>to_ruby</code>)</td>
+<td align="left"><code>((a . 1) (b . 2))</code></td>
+<td align="left"><code>[[:a,1],[:b,2]]</code></td>
+</tr>
+<tr class="odd">
+<td align="left">alist(<code>to_h</code>)</td>
+<td align="left"><code>((a . 1) (b . 2))</code></td>
+<td align="left"><code>{:a=&gt;1,:b=&gt;2}</code></td>
+</tr>
+<tr class="even">
+<td align="left">alist list</td>
+<td align="left"><code>((a 1 2) (b . 3))</code></td>
+<td align="left"><code>{:a=&gt;[1,2],:b=&gt;3}</code></td>
+</tr>
+</tbody>
+</table>
+<h4 id="encoding-ruby---s-expression"><a href="#encoding-ruby---s-expression">Encoding (Ruby -&gt; S-expression)</a></h4>
+<p>The Array and Hash objects are translated to lists and alist respectively. Cons cells and quoted expressions can't be expressed by any Ruby object. If those S-expressions are needed, one can obtain such S-expressions with creating instances of <code>SExpCons</code> and <code>SExpQuoted</code> directly and calling the <code>to_s</code> method.</p>
+<table>
+<thead>
+<tr class="header">
+<th align="left">type</th>
+<th align="left">Ruby (input)</th>
+<th align="left">S-exp (output)</th>
+</tr>
+</thead>
+<tbody>
+<tr class="odd">
+<td align="left">primitive</td>
+<td align="left"><code>[1,1.2,-4,&quot;xxx&quot;,:www,true,nil]</code></td>
+<td align="left"><code>(1 1.2 -4 &quot;xxx&quot; www t nil)</code></td>
+</tr>
+<tr class="even">
+<td align="left">empty list</td>
+<td align="left"><code>[]</code></td>
+<td align="left"><code>nil</code></td>
+</tr>
+<tr class="odd">
+<td align="left">nest list</td>
+<td align="left"><code>[1,[2,[3,4]]]</code></td>
+<td align="left"><code>(1 (2 (3 4)))</code></td>
+</tr>
+<tr class="even">
+<td align="left">hash</td>
+<td align="left"><code>{&quot;a&quot; =&gt; &quot;b&quot;, &quot;c&quot; =&gt; &quot;d&quot;}</code></td>
+<td align="left"><code>((&quot;a&quot; . &quot;b&quot;) (&quot;c&quot; . &quot;d&quot;))</code></td>
+</tr>
+<tr class="odd">
+<td align="left">hash</td>
+<td align="left"><code>{:a =&gt; [1,2,3], :b =&gt; {:c =&gt; [4,5,6]}}</code></td>
+<td align="left"><code>((a 1 2 3) (b (c 4 5 6)))</code></td>
+</tr>
+</tbody>
+</table>
+</body>
+</html>

metadata

@@ -0,0 +1,110 @@
+--- !ruby/object:Gem::Specification
+name: elparser
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- SAKURAI Masashi
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-02-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: racc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: test-unit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: A parser for S-expression of emacs lisp
+email:
+- m.sakurai@kiwanami.net
+executables: []
+extensions: []
+extra_rdoc_files:
+- readme.html
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- elparser.gemspec
+- lib/elparser.rb
+- lib/elparser/version.rb
+- readme.html
+homepage: https://github.com/kiwanami/ruby-elparser
+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.4.3
+signing_key: 
+specification_version: 4
+summary: A parser for S-expression of emacs lisp
+test_files: []