Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/goruby/goruby
GoRuby, an implementation of Ruby written in Go
https://github.com/goruby/goruby
go golang interpreter language programming-language ruby
Last synced: 25 days ago
JSON representation
GoRuby, an implementation of Ruby written in Go
- Host: GitHub
- URL: https://github.com/goruby/goruby
- Owner: goruby
- License: mit
- Created: 2014-08-19T15:51:28.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-07-14T23:26:00.000Z (5 months ago)
- Last Synced: 2024-08-10T11:02:42.130Z (5 months ago)
- Topics: go, golang, interpreter, language, programming-language, ruby
- Language: Go
- Size: 2.19 MB
- Stars: 599
- Watchers: 21
- Forks: 31
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
goruby
======
GoRuby, an implementation of Ruby written in Go
[](https://travis-ci.org/goruby/goruby)
[](http://godoc.org/github.com/goruby/goruby)
[](https://codeclimate.com/github/goruby/goruby/test_coverage)
[](https://codeclimate.com/github/goruby/goruby/maintainability)
[](https://goreportcard.com/report/github.com/goruby/goruby)
## Contribution
If anyone wants to help to get the project to the real implementation please ping me or fork it and send a pull request.
## Community
- [#goruby Channel on Gophers Slack](https://gophers.slack.com/messages/goruby/) (invites to Gophers Slack are available [here](http://blog.gopheracademy.com/gophers-slack-community/#how-can-i-be-invited-to-join:2facdc921b2310f18cb851c36fa92369))
## License
This project is released under the terms of the MIT License, as found in the
LICENSE file.
## REPL
There is a basic REPL within `cmd/girb`. It supports multiline expressions and all syntax elements the language supports yet.
To run it ad hoc run `go run cmd/girb/main.go` and exit the REPL with CTRL-D.
## Command
To run the command as one off run `go run main.go`.
## Supported features
### `goruby` Command
- [x] parse program files
- [ ] program file arguments
- [ ] Flags
- [ ] `-0[octal]` specify record separator (\0, if no argument)
- [ ] `-a` autosplit mode with -n or -p (splits $_ into $F)
- [ ] `-c` check syntax only
- [ ] `-Cdirectory` cd to directory before executing your script
- [ ] `-d` set debugging flags (set $DEBUG to true)
- [x] `-e 'command'` one line of script. Several -e's allowed. Omit [programfile]
- [ ] `-Eex[:in]` specify the default external and internal character encodings
- [ ] `-Fpattern` split() pattern for autosplit (-a)
- [ ] `-i[extension]` edit ARGV files in place (make backup if extension supplied)
- [ ] `-Idirectory` specify $LOAD_PATH directory (may be used more than once)
- [ ] `-l` enable line ending processing
- [ ] `-n` assume 'while gets(); ... end' loop around your script
- [ ] `-p` assume loop like -n but print line also like sed
- [ ] `-rlibrary` require the library before executing your script
- [ ] `-s` enable some switch parsing for switches after script name
- [ ] `-S` look for the script using PATH environment variable
- [ ] `-T[level=1]` turn on tainting checks
- [ ] `-v` print version number, then turn on verbose mode
- [ ] `-w` turn warnings on for your script
- [ ] `-W[level=2]` set warning level; 0=silence, 1=medium, 2=verbose
- [ ] `-x[directory]` strip off text before #!ruby line and perhaps cd to directory
- [ ] `-h` show this message, --help for more info
### `girb` Command
- [ ] parse program files
- [ ] program file arguments
- [ ] Flags
- [ ] `-f` Suppress read of ~/.irbrc
- [ ] `-m` Bc mode (load mathn, fraction or matrix are available)
- [ ] `-d` Set $DEBUG to true (same as `ruby -d')
- [ ] `-r load-module` Same as `ruby -r'
- [ ] `-I path` Specify $LOAD_PATH directory
- [ ] `-U` Same as `ruby -U`
- [ ] `-E enc` Same as `ruby -E`
- [ ] `-w` Same as `ruby -w`
- [ ] `-W[level=2]` Same as `ruby -W`
- [ ] `--context-mode n` Set n[0-3] to method to create Binding Object,
when new workspace was created
- [ ] `--echo` Show result(default)
- [x] `--noecho` Don't show result
- [ ] `--inspect` Use `inspect' for output (default except for bc mode)
- [ ] `--noinspect` Don't use inspect for output
- [ ] `--readline` Use Readline extension module
- [ ] `--noreadline` Don't use Readline extension module
- [ ] `--prompt prompt-mode`/`--prompt-mode prompt-mode`
Switch prompt mode. Pre-defined prompt modes are
`default', `simple', `xmp' and `inf-ruby'
- [ ] `--inf-ruby-mode` Use prompt appropriate for inf-ruby-mode on emacs.
Suppresses --readline.
- [ ] `--sample-book-mode`/`--simple-prompt`
Simple prompt mode
- [x] `--noprompt` No prompt mode
- [ ] `--single-irb` Share self with sub-irb.
- [ ] `--tracer` Display trace for each execution of commands.
- [ ] `--back-trace-limit n`
Display backtrace top n and tail n. The default
value is 16.
- [ ] `--irb_debug n` Set internal debug level to n (not for popular use)
- [ ] `--verbose` Show details
- [ ] `--noverbose` Don't show details
- [ ] `-v`, `--version` Print the version of irb
- [ ] `-h`, `--help` Print help
- [ ] `--` Separate options of irb from the list of command-line args
### Supported language feature
- [ ] everything is an object
- [x] allow method calls on everything
- [x] operators are method calls
- [ ] full UTF8 support
- [ ] Unicode identifier
- [ ] Unicode symbols
- [x] functions
- [x] with parens
- [x] without parens
- [x] return keyword
- [x] default values for parameters
- [ ] keyword arguments
- [x] block arguments
- [ ] hash as last argument without braces
- [x] function calls
- [x] with parens
- [x] without parens
- [x] with block arguments
- [ ] conditionals
- [x] if
- [x] if/else
- [ ] if/elif/else
- [x] tenary `? : `
- [x] unless
- [x] unless/else
- [ ] case
- [x] `||`
- [x] `&&`
- [ ] control flow
- [ ] for loop
- [x] while loop
- [ ] until loop
- [ ] break
- [ ] next
- [ ] redo
- [ ] flip flop
- [ ] numbers
- [ ] integers
- [x] integer arithmetics
- [x] integers `1234`
- [x] integers with underscores `1_234`
- [ ] decimal numbers `0d170`, `0D170`
- [ ] octal numbers `0252`, `0o252`, `0O252`
- [ ] hexadecimal numbers `0xaa`, `0xAa`, `0xAA`, `0Xaa`, `0XAa`, `0XaA`
- [ ] binary numbers `0b10101010`, `0B10101010`
- [ ] floats
- [ ] float arithmetics
- [ ] `12.34`
- [ ] `1234e-2`
- [ ] `1.234E1`
- [ ] floats with underscores `2.2_22`
- [x] booleans
- [ ] strings
- [x] double quoted
- [x] single quoted
- [x] character literals (`?\n`, `?a`,...)
- [ ] `%q{}`
- [ ] `%Q{}`
- [ ] heredoc
- [ ] without indentation (`<` notation
- [ ] literal with `key:` notation
- [x] indexing `hash[:foo]`
- [x] every Ruby Object can be a hash key
- [ ] symbols
- [x] `:symbol`
- [x] `:"symbol"`
- [ ] `:"symbol"` with interpolation
- [x] `:'symbol'`
- [ ] `%s{symbol}`
- [ ] singleton symbols
- [ ] regexp
- [ ] `/regex/`
- [ ] `%r{regex}`
- [ ] ranges
- [ ] `..` inclusive
- [ ] `...` exclusive
- [ ] procs `->`
- [ ] variables
- [x] variable assignments
- [x] globals
- [ ] operators
- [x] `+`
- [x] `-`
- [x] `/`
- [x] `*`
- [x] `!`
- [x] `<`
- [x] `>`
- [ ] `**` (pow)
- [x] `%` (modulus)
- [ ] `&` (AND)
- [ ] `^` (XOR)
- [ ] `>>` (right shift)
- [ ] `<<` (left shift, append)
- [x] `==` (equal)
- [x] `!=` (not equal)
- [ ] `===` (case equality)
- [ ] `=~` (pattern match)
- [ ] `!~` (does not match)
- [x] `<=>` (comparison or spaceship operator)
- [x] `<=` (less or equal)
- [x] `>=` (greater or equal)
- [ ] assignment operators
- [x] `+=`
- [x] `-=`
- [x] `/=`
- [x] `*=`
- [x] `%=`
- [ ] `**=`
- [ ] `&=`
- [ ] `|=`
- [ ] `^=`
- [ ] `<<=`
- [ ] `>>=`
- [ ] `||=`
- [ ] `&&=`
- [x] function blocks (procs)
- [ ] error handling
- [x] begin/rescue
- [ ] ensure
- [ ] retry
- [x] constants
- [x] scope operator `::`
- [ ] classes
- [x] class objects
- [x] class Class
- [x] instance variables
- [ ] class variables
- [x] class methods
- [x] instance methods
- [x] method overrides
- [ ] private
- [ ] protected
- [ ] public
- [x] inheritance
- [x] constructors
- [x] new
- [x] `self`
- [ ] singleton classes (also known as the metaclass or eigenclass) `class << self`
- [ ] assigment methods
- [x] self defined classes
- [x] self defined classes with inheritance
- [x] modules
- [x] object main
- [x] comments '#'