Ruspea

A Lisp dialect written in Ruby (and on itself) meant to be used as a standard Ruby gem.

So if anyone asks:

What is this Ruspea thing on the Gemfile?

You can go:

Nah. Just a gem.

Then you can sneak in code like this in your project

(def %fib
  (fn [n]
    (cond
      ((= n 0) n)
      ((= n 1) n)
      (true
        (+
          (%fib (- n 1))
          (%fib (- n 2)))))))

And execute it from Ruby like:

Ruspea::Code.new.load("my/awesome/ruspea/script.rsp")

You can also bypass the file loading:

require "ruspea-lang"

code = <<~c
(def plus1
  (fn [num] (+ num 1)))
(plus1 10)
c

eleven = Ruspea::Code.new.run(code).last
puts eleven # => 11

Yes.

YES! After install it as a gem (gem install ruspea_lang), just go ahead and:

➜ ruspea
loading repl: repl.rsp
repl loaded.

#user=> (def lol 1)
1
#user=> lol
1
#user=> (puts "hello world")
hello world
nil
#user=> ^CSee you soon.

Ruspea has Ruby interoperabillity built-in so you can "just use" Ruby:

(def puts
  (fn [str]
    (.
      (:: Kernel) puts str)))

In fact, the very minimal standard library is built on top of this interop capability. It is also the best source to look for usage/syntax/etc right now: lib/language/standard.rsp

100%!

This is the actual question, isn't it? Sadly this is way out of the scope of this README.

You will need to convince yourself here. 😬

Nope. And it will probably never be.

This was just an exercise:

• Ruby is really fun.
• Lisp too.
• I am really (I mean REALLY) enjoying Clojure.
• And I really wanted to learn how to implemente a programming language.
• Lists are a great way to organize thoughts.

If you put all this together you have this project.

Actually, I would prefer to avoid the term shortcomings.

The current social norm forces impossible standards on everyone and everything!

I want to list the things I know are not perfect about this pretty little thing called Ruspea and I don't want to hurt it's feelings.

Let's call those rough edges... features. Those are enhancements that are not here... just yet 😬.

• No performance! Seriously. There is no optmization whatsoever to see here.
• No TCO. Goes hand to hand with the previous one.
• No standard library.
• No multi-arity functions. They are in the Runtime though. Just too lazy to build the syntax reader for it right now.
• No examples. Besides the "standard library" ones (lib/language)

Add this line to your application's Gemfile:

gem "ruspea_lang"

And then execute:

$ bundle

Or install it yourself:

$ gem install ruspea_lang

Yes, we do:

Pushing gem to https://rubygems.org...
There was a problem saving your gem: Name 'ruspea' is too close to typo-protected gem: rspec

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Bug reports and pull requests are welcome on GitHub at https://github.com/mistersourcerer/ruspea.

The gem is available as open source under the terms of the MIT License.