Goby is an object-oriented interpreter language deeply inspired by Ruby as well as its core implementation by 100% pure Go. Moreover, it has standard libraries to provide several features such as the Plugin system. Note that we do not intend to reproduce whole of the honorable works of Ruby syntax/implementation/libraries.
One of our goal is to provide web developers a sort of small and handy environment that mainly focusing on creating API servers or microservices. For this, Goby includes the following native features:
- Robust thread/channel mechanism powered by Go's goroutine
- Builtin high-performance HTTP server
- Builtin database library (currently only support PostgreSQL adapter)
- JSON support
- Plugin system that can load existing Go packages dynamically (Only for Linux and MacOS right now)
- Accessing Go objects from Goby directly
Note: Goby had formerly been known as "Rooby", which was renamed in May 2017.
Table of contents
- Demo and sample Goby app
- Structure
- Aspects
- Features
- Current roadmap
- Installation
- Usage
- Sample codes
- Documentation
- Joining to Goby
- Maintainers
- Support us
- References
Demo screen and sample Goby app
Click to see the demo below (powered by asciinema and GIPHY).
New! Check-out our sample app built with Goby. Source code is also available here.
Structure
Aspects
Goby has several aspects: language specification, design of compiler and vm, implementation (just one for now), library, and the whole of them. See more
We are optimizing and expanding Goby all the time. Toward the first release, we've been focusing on implementing Goby first.
Major Features
- Plugin system
- Allows using Go libraries (packages) dynamically
- Allows calling Go's methods from Goby directly (only on Linux for now)
- Builtin multi-threaded server and DB library
- REPL (run
goby -i)
Here's a complete list of all the features.
Current roadmap
See wiki: Current roadmap
Installation
Confirmed Goby runs on Mac OS and Linux for now. Try Goby on Windows and let us know the result.
A. Via Homebrew (binary installation for Mac OS)
Note: Please check the latest release before installing Goby via Homebrew
brew tap goby-lang/goby
brew install goby
In the case, $GOBY_ROOT is automatically configured.
B. From Source
Try this if you'd like to contribute Goby! Skip 1 if you already have Golang in your environment.
- Prepare Golang environment
- Install Golang >= 1.12
- Make sure
$GOPATHin your shell's config file( like .bashrc) is correct - Add your
$GOPATH/binto$PATH - Add
export GO111MODULE=onto your shell profile
- Run
go get github.com/goby-lang/goby - Set the Goby project's exact root path
$GOBY_ROOTmanually, which should be:
$GOPATH/src/github.com/goby-lang/goby
C. Installation on a Linux system
In order to install Go, Goby and PostgreSQL on a Linux system, see the wiki page.
Verifying Goby installation
- Run
goby -vto see the version. - Run
goby -ito launch igb REPL. - Type
require "uri"in igb.
FYI: You can just run brew test goby to check Homebrew installation.
If you have any issue installing Goby, please let us know via GitHub issues
Using Docker
Goby has official docker image as well. You can try the Plugin System using docker.
Syntax highlighting
The Goby syntax is currently a subset of the Ruby one, with an exception (get_block), therefore, it's possible to attain syntax highlighting on any platform/editor by simply switching it to Ruby for the currently opened file.
Sublime Text 3
Sublime Text 3 users can use the Only Goby package, by typing the following in a terminal:
git clone git@github.com:saveriomiroddi/only-goby-for-sublime-text "$HOME/.config/sublime-text-3/Packages/only-goby-for-sublime-text"
this will automatically apply the Goby syntax highlighting to the .gb files.
Vim
Vim users can use the vim-goby-syntax-highlighting definition, by typing the following in a terminal:
mkdir -p "$HOME/.vim/syntax"
wget -O "$HOME/.vim/syntax/goby.vim" https://raw.githubusercontent.com/saveriomiroddi/vim-goby-syntax-highlighting/master/goby.vim
echo 'au BufNewFile,BufRead *.gb setf goby' >> "$HOME/.vim/filetype.vim"
this will automatically apply the Goby syntax highlighting to the .gb files.
SpaceVim
SpaceVim users can load the lang#goby layer by adding following configuration:
name = "lang#goby"
Sample codes
- Built a stack data structure using Goby
- Running a "Hello World" app with built in server library
- Sending request using http library
- Running load test on blocking server (This shows
Goby's simple server is very performant and can handle requests concurrently) - One thousand threads
More sample Goby codes can be found in sample directory.
Joining to Goby
Join us on Slack!
See the guideline.
Maintainers
- @st0012
- @hachi8833
- @saveriomiroddi
- @ear7h
Designer
Support Us
Donations
Support us with a monthly donation and help us continue our activities. [Become a backer]
Sponsors
Powered by
- JetBrains Goland IDE
Supporting Goby by sending your first PR! See contribution guideline
Or support us on opencollective
References
The followings are the essential resources to create Goby; I highly recommend you to check them first if you'd be interested in building your own languages: