lasp 0.11.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 239d33a36efb77e46301fa1f4f5eab3355d95371
-  data.tar.gz: 2b63d5918420dd74b0e4e73e9b799eed3ab33113
+  metadata.gz: f37487e5e7f6bd7fb1ef31fef1dfa3bcfb4c9f55
+  data.tar.gz: b0bbd30928d655e45bcc809af6a34bfb389e0fcd
 SHA512:
-  metadata.gz: 74d78665c4fa130cb7a583c4cce512bdce06db31086f4ad889a0ef0015d60b3a84892e530236f7f21937f4663e5e6e1c5f6383f5d9af6baa6871974524074d97
-  data.tar.gz: 1a7daa286ff20db4c8b3008525c1b10edff6c61a4848f5bb2c04b97ad58cef832bfb72961765c422a761cdae26371c297e1a47d6fc1d307e2e2c943add69e1ea
+  metadata.gz: 8d05c4d229e16ece6639a639b1555a5f76159b2ca29fe11890b181dcf4332f08164e26b0e1ac6f1da01af61a63e3c568efdd48b4eb11a996200d7679b53a7dd1
+  data.tar.gz: 60734cb7b52b5c3a1ef00e3a80dbb201c31c496b8580e1675131154580a6e0d1cf9edf160feaa5c15e933e8fb1eb279c3e209d5880cd11db8dad032baa7d1811

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Läsp changelog
 
+## v0.12.0 - 2016-03-18
+
+### Added
+
+- Allow access to Ruby constants, namespaces separated by `/`.
+
+
 ## v0.11.0 - 2016-03-05
 
 ### Added

data/README.md

@@ -4,14 +4,14 @@ A Lisp implementation in Ruby.
 
 ## Features
 
-- Comprehensive [documentation](DOCUMENTATION.md)
+- Comprehensive [documentation](#documentation)
 - Interactive REPL with auto-closing of missing trailing parentheses
 - Closures
 - let-bindings
 - Fully functional macro system
 - Interoperability with Ruby
 - Very concise [core library](lib/lasp/corelib.rb) written in Ruby
-- [Standard library](lib/lasp/stdlib.lisp) written in Läsp itself
+- [Standard library](lib/lasp/stdlib.lasp) written in Läsp itself
 
 ## Installation
 
@@ -40,38 +40,13 @@ lasp
 lasp path/to/program.lasp
 ```
 
-## The language
+## Documentation
 
-Please reference the [documentation](DOCUMENTATION.md) for specific definitions
-and examples of all available functions.
+- [Language](docs/language.md) - explains the core types and syntax of the language.
+- [Reference](docs/reference.md) - a list of every available function with description and usage examples.
+- [Examples](docs/examples.md) - various small examples of using the language.
+- [Zuul](https://github.com/alcesleo/zuul) - a small text-based game written in Läsp.
 
-### Examples
-
-More advanced examples can be found in [EXAMPLES.md](EXAMPLES.md), you can also
-look at the [standard library](lib/lasp/stdlib.lasp) which is implemented in
-Läsp itself.
-
-```lisp
-(+ 1 2 3) ;; => 6
-
-(def x 5)
-x ;; => 6
-
-(sum (list 5 10 15)) ;; => 30
-
-(def inc (fn (x) (+ x 1)))
-(inc 5) ;; => 6
-```
-
-
-### Comments
-
-Comments start with a `;` and end at the end of a line
-
-```lisp
-; This is a comment
-(+ 1 2) ; This is also a comment
-```
 
 ## Developing
 

data/{EXAMPLES.md → docs/examples.md}

@@ -248,10 +248,11 @@ x ;; => (1 2 3)
 ## Interoperability
 
 ```clojure
-; The . function allows for Ruby interoperability.
-(. "01011101" :to_i 2) ;; => 93
+; Prepend a dot to the method name and pass the object as the first argument to
+; call a Ruby method.
+(.to_i "01011101" 2) ;; => 93
 
-(def parse_binary (fn (bin) (. bin :to_i 2)))
+(def parse_binary (fn (bin) (.to_i bin 2)))
 (parse_binary "01011101") ;; => 93
 ```
 

data/docs/language.md

@@ -0,0 +1,136 @@
+# Language
+
+This page describes the syntax and core types of the language.
+
+## Comments
+
+Comments start with a `;` and end at the end of a line
+
+```lisp
+; This is a comment
+(+ 1 2) ; This is also a comment
+```
+
+
+## Data types
+
+The core types are backed by their corresponding Ruby classes. This can be seen
+by doing `(.class 5)`.
+
+### integer
+
+A whole number.
+
+```clojure
+1
+-42
+0
+```
+
+### decimal
+
+A decimal number.
+
+```clojure
+3.56
+-0.5
+```
+
+### boolean
+
+The value `true` or `false`.
+
+```clojure
+true
+false
+```
+
+### nil
+
+The "null" or "no value" type.
+
+```clojure
+nil
+```
+
+### text
+
+Text of any length. There is a shorthand syntax that can be used when the
+string does not contain any whitespace - this makes the syntax in `dict`s
+nicer, for example.
+
+It supports these escape characters:
+
+- `\n` - a newline
+- `\t` - a tab
+- `\\` - a literal `\`
+- `\"` - a literal `"`
+
+```clojure
+"some text" ; => "some text"
+
+; Shorthand version
+:text ; => "text"
+
+; Using escape characters
+;
+; Note that they will still look escaped when returned in the REPL,
+; however, if you print them you will get the literal text.
+"text with \" and \\ in it" ; => "text with \" and \\ in it"
+
+(println "text with \" and \\ in it")
+; text with " and \ in it
+```
+
+### list
+
+A heterogeneous (allows mixed types) list of values, can be created with the
+[list](reference.md#list) function. This type is also used to call a
+function. There is no difference between a list of data and a "list of code",
+a.k.a. **form**.
+
+```clojure
+(list 1 2 :three) ; => (1 2 "three")
+
+; The first item in the list will be called with the rest of the list as arguments:
+(println "Hello, " "world!")
+```
+
+### dict
+
+A dictionary (a.k.a. hash-map) of keys that map to values, can be created with
+the [dict](reference.md#dict) function.
+
+```clojure
+; Here we use the shorthand text syntax as keys
+(dict :one 1 :two 2) ; => {"one" 1, "two" 2}
+```
+
+### symbol
+
+Used to name other things (see [def](reference.md#def)), but can be obtained in itself by
+quoting (see [quote](reference.md#quote)).
+
+Symbols should be lowercase, with words separated by dashes.
+
+```clojure
+; A symbol will resolve to what it has been defined as
+symbol
+
+; To obtain a symbol by itself, you have to quote it
+'symbol
+
+'a-long-symbol-name
+```
+
+## Ruby interoperability
+
+You can access Ruby classes and modules, to access nested ones use `/`. To call
+Ruby methods, simply prepend a dot to the method name, and pass the object as
+the first parameter.
+
+```clojure
+(.ceil Math/PI) ; => 4
+
+(.to_i "010101" 2) ; => 21
+```

data/{DOCUMENTATION.md → docs/reference.md}

@@ -1,18 +1,7 @@
-# Documentation
-
-## Data types
-
-| Data type | Example literals       | Description                                                                                                 |
-| :---      | :---                   | :---                                                                                                        |
-| integer   | `1`, `-42`, `0`        | A whole number of any size                                                                                  |
-| decimal   | `3.56`, `-0.5`         | A decimal number of any size                                                                                |
-| boolean   | `true`, `false`        | The value `true` or `false`                                                                                 |
-| nil       | `nil`                  | The "null" or "no value" type                                                                               |
-| text      | `"some text"`, `:text` | Text of any length. When containing no whitespace, it can be written with a leading colon (handy in dicts)  |
-| list      | `(list 1 2 3.5)`       | A heterogeneous (allows mixed types) list of values, can be created with the [list](#list) function         |
-| dict      | `(dict :one 1 :two 2)` | A dictionary (a.k.a. hash-map) of keys that map to values, can be created with the [dict](#dict) function   |
-| symbol    | `symbol`, `'symbol`    | Used to name other things (see [def](#def)), but can be obtained in itself by quoting (see [quote](#quote)) |
+# Reference
 
+This is a reference of all the functions you can call by default in any Läsp
+program.
 
 ## Special forms
 

data/lib/lasp/interpreter.rb

@@ -35,7 +35,11 @@ module Lasp
     end
 
     def resolve_symbol(symbol, env)
-      env.fetch(symbol)
+      if symbol.to_s.match(/^[A-Z]/)
+        Object.const_get(symbol.to_s.gsub("/", "::"))
+      else
+        env.fetch(symbol)
+      end
     rescue KeyError
       raise NameError, "#{symbol} is not present in this context"
     end

data/lib/lasp/version.rb

@@ -1,3 +1,3 @@
 module Lasp
-  VERSION = "0.11.0"
+  VERSION = "0.12.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lasp
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Jimmy Börjesson
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-03-05 00:00:00.000000000 Z
+date: 2016-03-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -63,13 +63,14 @@ files:
 - ".gitignore"
 - ".travis.yml"
 - CHANGELOG.md
-- DOCUMENTATION.md
-- EXAMPLES.md
 - Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
 - bin/lasp
+- docs/examples.md
+- docs/language.md
+- docs/reference.md
 - lasp.gemspec
 - lib/lasp.rb
 - lib/lasp/corelib.rb