iode 0.0.2 → 0.0.3

data/README.md

@@ -4,17 +4,9 @@ An experimental lisp-family language hosted on Ruby.
 
 ## Installation
 
-Add this line to your application's Gemfile:
-
-    gem 'iode'
-
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install iode
+```
+gem install iode
+```
 
 ## Usage
 
@@ -28,8 +20,8 @@ what the syntax and language features may include. Ruby is perfect for that.
 Once I have good ideas put down as working examples in this project, they will
 be ported upstream to the native JIT interpreter for LLVM.
 
-Currently this project just implements the guts of a functional lisp-family of
-languages. It will change considerably from the current implementation.
+Currently this project just implements the guts of a functional language in the
+lisp-family. It will change considerably from the current implementation.
 
 ### Command Line
 
@@ -45,6 +37,58 @@ Or you can send the source code to STDIN:
 iode-rb < path/to/file.io
 ```
 
+The basic hello world looks like so.
+
+``` lisp
+;; this is a comment
+(puts "Hello World!")
+```
+
+Some built-in data types (e.g. fractions) are enriched with literals in iode.
+
+``` lisp
+(+ 1/2 2/3) ; 7/6
+```
+
+Functions are (currently) defined in terms of `lambda`.
+
+``` lisp
+((lambda (x y) (* x y)) 6 3) ; 18
+```
+
+As you'd expect, functions are first-class objects in Iode.
+
+Of course, functions can be defined recursively too.
+
+``` lisp
+;; Recursive function example.
+(def loop
+     (lambda (n)
+       (if (= n 0)
+         (quote done)
+         (progn
+           (puts n)
+           (loop (- n 1))))))
+
+(loop 20)
+```
+
+The above code will print 20 through 1 to the screen and finally return the
+Symbol `:done` to Ruby (quoted Iode Symbols are also Ruby Symbols). Note that
+I haven't yet done tail call elimination.
+
+Similarly, closures can be returned from functions.
+
+``` lisp
+;; Provides partial application of a function
+(def curry
+     (lambda (fn a)
+       (lambda (b) (fn a b))))
+
+((curry + 2) 3) ; 5
+```
+
+
 ### In Ruby Code
 
 Using Iode from inside Ruby code can be interesting, as it will interoperate
@@ -62,12 +106,8 @@ PROG
 puts result
 ```
 
-The above code creates a lambda function that simply acts like the identity
-function (i.e. it returns its input). That lambda is then immediately applied
-with the input `false`, thereby returning `false`.
-
-The `if` form evaluates false and therefore evaluates the else part of the
-`if`, returning the string "x = false".
+This returns the string "x = false" to Ruby. Hopefully you can see what the
+code does.
 
 Here's another example showing how you can pass values from Ruby into Iode.
 
@@ -85,10 +125,10 @@ prog.call(false) #=> 7
 prog.call(true)  #=> 42
 ```
 
-This works because internally, Iode lambdas as represented as Ruby Procs.
+This works because internally, iode lambdas are represented as Procs.
 
 Incidentally, that means you can even pass higher-order functions from Ruby
-to Iode.
+to iode.
 
 ``` ruby
 require "iode"
@@ -102,37 +142,6 @@ prog.call(->(x){ x * 2 }) #=> 84
 prog.call(->(x){ x + 4 }) #=> 46
 ```
 
-Of course, functions can be defined recursively too.
-
-``` lisp
-;; Recursive function example.
-(def loop
-     (lambda (n)
-       (if (= n 0)
-         (quote done)
-         (progn
-           (puts n)
-           (loop (- n 1))))))
-
-
-(loop 20)
-```
-
-The above code will print 20 through 1 to the screen and finally return the
-Symbol `:done` to Ruby (quoted Iode Symbols are also Ruby Symbols). Note that
-I haven't yet done tail call elimination.
-
-Similarly, closures can be returned from functions.
-
-``` lisp
-;; Provides partial application of a function
-(def curry
-     (lambda (fn a)
-       (lambda (b) (fn a b))))
-
-((curry + 2) 3) ; 5
-```
-
 ## Development
 
 Iode (in this Ruby incarnation) is literally a few hours old at the time I
@@ -140,7 +149,7 @@ write this. Much is still not yet developed. However, you may poke around in
 the internals and find some interesting this. A string of source code takes
 this path to being executed as code.
 
-    String(source) -> Reader(data) -> Interpreter(data) -> Core(data) -> Result
+    Input -> Reader<data> -> Interpreter<data> -> Core<data> -> Output
 
 The source string is parsed by the Reader into native lisp data (using Ruby
 data types, like Array and Symbol). The data representation is then given to
@@ -150,7 +159,7 @@ a Proc). Variables are held in the Scope class, which is able to chain Scopes
 together to create lexical closures. Core functions are registered as mixins
 in the Core module.
 
-If you want to add a native Ruby function to be applied like an Iode function,
+If you want to add a native Ruby function to be applied like an iode function,
 put it in a Module and register it into `Iode::Core`:
 
 ``` ruby
@@ -167,7 +176,7 @@ Iode::Core.register MyFunctions
 Iode.run('(example 7 5)') #=> 12
 ```
 
-Once I have namespacing done, you'll be able to write actual Iode code in
+Once I have namespacing done, you'll be able to write actual iode code in
 separate files and have them loaded under a namespace.
 
 ## Copyright & Licensing

data/lib/iode/core/lists.rb

@@ -19,6 +19,10 @@ require "iode/core"
 module Iode
   module Core
     module Lists
+      def list(*args)
+        args
+      end
+
       def car(list)
         v, *_ = list
         v

data/lib/iode/core.rb

@@ -22,6 +22,8 @@ module Iode
   # The actual functions are mixed in by other modules.
   module Core
     class << self
+      include Core
+
       # Register a new library of functions into the global definitions.
       #
       # @param [Module] base

data/lib/iode/reader.rb

@@ -29,9 +29,12 @@ module Iode
     rule("(")
     rule(")")
 
+    # fractions as literals
+    rule(:rational => /[0-9]+\/[0-9]+/).as{|n| Rational(n)}
+
     # scalars
     {
-      float:  /[0-9]*\.[0-9]+/,
+      float:  /[0-9]+\.[0-9]+/,
       int:    /[0-9]+/,
       string: /"(\\.|[^"])*"/,
       regexp: /\/(\\.|[^\/])*\//
@@ -57,6 +60,7 @@ module Iode
     rule(:atom) do |r|
       r[:int]
       r[:float]
+      r[:rational]
       r[:string]
       r[:symbol]
     end

data/lib/iode/version.rb

@@ -15,5 +15,5 @@
 # limitations under the License.
 
 module Iode
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

metadata

@@ -1,62 +1,68 @@
 --- !ruby/object:Gem::Specification
 name: iode
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
+  prerelease: 
 platform: ruby
 authors:
 - Chris Corbyn
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-03-17 00:00:00.000000000 Z
+date: 2014-03-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: whittle
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 0.0.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 0.0.8
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.5'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.5'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
-    - - ">="
+    - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-description: |2
-    Iode is a work in progress real language on LLVM.
-    This Ruby Gem exists solely so the author can experiment with new language
-    features before committing those ideas to the real language. It is not
-    intended for general use, nor is it intended to be fast or concise.
+description: ! "  Iode is a work in progress real language on LLVM.\n  This Ruby Gem
+  exists solely so the author can experiment with new language\n  features before
+  committing those ideas to the real language. It is not\n  intended for general use,
+  nor is it intended to be fast or concise.\n"
 email:
 - chris@w3style.co.uk
 executables:
@@ -64,7 +70,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
+- .gitignore
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -84,25 +90,26 @@ files:
 homepage: https://github.com/d11wtq/iode-rb
 licenses:
 - MIT
-metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
-  - - ">="
+  - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
-  - - ">="
+  - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.0
+rubygems_version: 1.8.23
 signing_key: 
-specification_version: 4
+specification_version: 3
 summary: An experimental lisp-family language hosted on Ruby
 test_files: []

checksums.yaml

@@ -1,7 +0,0 @@
----
-SHA1:
-  metadata.gz: ef8311e9162a113a3aff4d5741524ac2bd6eafcb
-  data.tar.gz: 56634c23acfedee8d05d6bc38a78392dc9df0865
-SHA512:
-  metadata.gz: 295055612ba622c3f84503f957e996a9996f32201bf934c571c63a17c93144dad7fe7fa206abfe469c5f4dc0e34262c12f1b19a9e69c24dabe9a9c401a25f837
-  data.tar.gz: fc8b1824b95dbf0583917390f64b4df9614f320e4d0c972d6c8e8d81f84518a9be58d5b2e570feaaf13d5178efddbbb6edee38f0368e03a9cda27be6a6455db9