rye

Rye language

For comprehensive documentation, tutorials, and examples, visit ryelang.org

What is Rye?

Rye is a high-level, dynamic programming language inspired by Rebol, Factor, Linux shells, and Go. It features a Go-based interpreter and interactive console, making it an excellent scripting companion for Go programs. Rye can also be embedded into Go applications as a scripting or configuration language.

Key characteristics:

• Homoiconic: Code is data, data is code
• Function-oriented: No keywords, everything is a function call
• Expression-based: Everything returns a value
• First-class functions: Functions and code blocks are values
• Multiple dialects: Specialized interpreters for different tasks
• Safety-focused: Explicit state changes, pure/impure function separation, validation dialect

Status: Alpha - Core language design is stable, focus is on improving runtime, documentation, and usability.

Quick Examples

…

For more examples and interactive demos, visit ryelang.org/meet_rye/

Building Rye from Source

Prerequisites

1. Install Go 1.21.5 or later:
   bash复制

   # Example for Linux
   wget https://go.dev/dl/go1.21.5.linux-amd64.tar.gz
   rm -rf /usr/local/go && tar -C /usr/local -xzf go1.21.5.linux-amd64.tar.gz
   export PATH=$PATH:/usr/local/go/bin
   go version

Clone and Build

1. Clone the repository:

   bash复制

   git clone https://github.com/refaktor/rye.git
   cd rye

2. Build options:

   • Minimal build (fewer modules, smaller binary):

     bash复制

     go build -tags "b_tiny" -o bin/rye

   • Standard build (most modules included):

     bash复制

     go build -o bin/rye
     # or simply
     ./build

   • Custom build (select specific modules):

     bash复制

     go build -tags "b_tiny,b_sqlite,b_http,b_json" -o bin/rye

3. Run Rye:

   bash复制

   # Run the REPL
   bin/rye
   
   # Run a script
   bin/rye script.rye

Building WASM Version

Rye can run in browsers and other WASM environments:

GOOS=js GOARCH=wasm go build -tags "b_tiny" -o wasm/rye.wasm main_wasm.go
# or use the helper script
./buildwasm
# Then visit http://localhost:8085/ryeshell/

Running Tests

cd info
../bin/rye . test

# Generate function reference
../bin/rye . doc

Getting Rye (Pre-built)

If you prefer not to build from source, you have several options:

Binaries

Pre-compiled binaries for Linux, macOS, Windows, and WASM are available under Releases.

Package Managers

• Homebrew (macOS/Linux):

  bash复制

  brew install ryelang

• ArchLinux User Repository (Arch Linux):

  bash复制

  yay -S ryelang

Thanks to @kseistrup for Arch package and @stefanb for Homebrew.

Docker Images

• Binary image (includes Rye and Emacs-nox):

  bash复制

  docker run -ti ghcr.io/refaktor/rye

• Development image (build from repository):

  bash复制

  docker build -t refaktor/rye -f .docker/Dockerfile .
  docker run -ti refaktor/rye

Resources

• ryelang.org - Official documentation, tutorials, and examples
• Blog - Latest updates and development news
• Examples folder - Code examples and demos
• Asciinema demos - Interactive terminal demos

Extensions and Related Projects

• Rye-fyne - GUI toolkit binding
• Rye-gio - Gioui toolkit binding (WIP)
• Rye-ebitengine - 2D game engine binding (WIP)
• ryegen - Binding generation toolkit (WIP)

Editor Support

• VS Code: Search for "ryelang" in the Extension marketplace repository
• Emacs: syntax highlighting
• NeoVIM: syntax highlighting
• Helix: soon

Community and Contact

• GitHub Discussions
• Reddit
• Issues
• Discord - #Homoiconic - a discord for languages like Lisp, Rebol, Red, Rye (very new, few users, welcome!)
• Rosetta Code
• Email: janko.itm+rye[at]gmail.com

Thanks!

A big thanks to all contributors!