rpl.rb/README.md
2022-11-10 10:53:55 +01:00

74 lines
2.4 KiB
Markdown

# rpl.rb
Reverse-Polish-Lisp inspired language in ruby
# Install
`gem install rpl`
# Usage
* `rpl --help`
* run RPL: `rpl`
* by default rpl persists its state in $XDG_DATA_HOME/rpl.rb/env.rpl which is created if needed (if $XDG_DATA_HOME isn't set ~/.local/share/ is used)
# Development
To run REPL locally: `rake run`
To run the test suite: `rake test`
To build gem: `rake gem`
# known bugs
-
# TODO-list
* Language:
* pseudo filesystem: subdir/namespace for variables
. 'a dir' crdir 'a dir' cd vars
* SDL-based graphic environment/API
# Not yet implemented
```sh
$ grep "# @dictionary.add_word" ./lib/rpl/words/*.rb
./lib/rpl/words/logarithm.rb: # @dictionary.add_word!( ['ln'],
./lib/rpl/words/logarithm.rb: # @dictionary.add_word!( ['lnp1'],
./lib/rpl/words/logarithm.rb: # @dictionary.add_word!( ['exp'],
./lib/rpl/words/logarithm.rb: # @dictionary.add_word!( ['expm'],
./lib/rpl/words/logarithm.rb: # @dictionary.add_word!( ['log10'],
./lib/rpl/words/logarithm.rb: # @dictionary.add_word!( ['alog10'],
./lib/rpl/words/logarithm.rb: # @dictionary.add_word!( ['log2'],
./lib/rpl/words/logarithm.rb: # @dictionary.add_word!( ['alog2'],
./lib/rpl/words/logarithm.rb: # @dictionary.add_word!( ['sinh'],
./lib/rpl/words/logarithm.rb: # @dictionary.add_word!( ['asinh'],
./lib/rpl/words/logarithm.rb: # @dictionary.add_word!( ['cosh'],
./lib/rpl/words/logarithm.rb: # @dictionary.add_word!( ['acosh'],
./lib/rpl/words/logarithm.rb: # @dictionary.add_word!( ['tanh'],
./lib/rpl/words/logarithm.rb: # @dictionary.add_word!( ['atanh'],
./lib/rpl/words/mode.rb: # @dictionary.add_word!( ['std'],
./lib/rpl/words/mode.rb: # @dictionary.add_word!( ['fix'],
./lib/rpl/words/mode.rb: # @dictionary.add_word!( ['sci'],
./lib/rpl/words/mode.rb: # @dictionary.add_word!( ['round'],
./lib/rpl/words/operations-complexes.rb: # @dictionary.add_word!( ['p→r', 'p->r'],
./lib/rpl/words/operations-complexes.rb: # @dictionary.add_word!( ['r→p', 'r->p'],
```
# No implementation planned
* use IFT, IFTE instead of
. if
. then
. else
. end
* use LOOP, TIMES instead of
. start
. for
. next
. step
. do
. until
. while
. repeat
* use LSTO instead of
. ->, →
# inspirations and references
* https://en.wikipedia.org/wiki/RPL_(programming_language)
* https://github.com/louisrubet/rpn/