Skip to content
This repository has been archived by the owner on Oct 23, 2021. It is now read-only.

relrod/rublets

Repository files navigation

Rublets

Rublets is an IRC bot in ruby which uses tsion's on_irc library, with a small collection of other rubygems, to provide a safe general-purpose code-evaluation IRC bot.

How It Works

Rublets takes advantage of an SELinux feature called sandboxing. On any Linux system with SELinux, you can run the sandbox command to safely evaluate commands without risk of harming the computer. Rublets, by default, stores its sandbox data in ~/.rublets/ of whichever user it runs as.

When Rublets is asked to evaluate ruby, it does the following:

  1. Write the code to a file that the sandboxed ruby can access.
  2. Write the code to a file that can not be reached by the sandbox, for audit purposes.
  3. Ask the sandbox to evaluate the code using ruby.
  4. Remove the sandbox-accessible code.

Setting up languages

Rublets uses RVM so that it can evaluate multiple ruby versions/implementations. Setting up RVM for use with Rublets is a bit tricky.

Set up RVM as your regular user with however many rubies you want, and ensure it is in $PATH.

All other languages can be evaluated by making sure their interpreters are installed and in $PATH.

The bot has only been tested on Fedora Rawhide, but in theory, should work elsewhere.

Commands

  • ![language]> [code] - (example: !perl> print 1;) - Evaluate code
  • !version [language] - (example: !version php) - Return the version of the package that provides PHP.
  • !>> [ruby code] - (example: !>> puts "hello!") - Shortcut for Ruby evaluations
  • !languages or !langs - List all languages that Rublets knows about
  • !rubies - List all RVM rubies that Rublets can see

What it can evaluate (if given selinux permissions, and if the interpreters/compilers are installed):

Shells Bash Zsh
C-like C C++ Go Objective-C
Lisps Apricot Chicken Clojure CLISP Kawa Racket Kawa Scheme sbcl
Erlang VM Elixir Erlang
Stack-based Factor Forth
Functional Elm Haskell OCaml SML(/NJ)
Prototype-based Io JavaScript Lua
Misc Arroyo Brainfuck Clay Frink (non-foss) Golfscript (no license) J LOLCODE Maxima OOC Pascal Prolog Smalltalk SQLite 3
Scripting Befunge Perl 5 Perl 6 PHP Python Python 3 Ruby TCL
JVM-based Ceylon Clojure Groovy Java Scala
.NET C# F#

Config

Rublets uses @programble's Configru gem interally. All this means for you, the user, is that you need to copy rublets.yml.dist to rublets.yml, edit it, and be on your way.

Contributions

Contributions are gladly accepted. Please run the specs and ensure they pass.

License

The original project (duckinator/rubino) from which Rublets was forked, was ISC. However, most if not all of the original code has been greatly modified or removed. With permission from @duckinator for anything I am missing, that is still original, I am releasing this project as GPLv2+, as of the commit in which this text appears.

About

An IRC bot that uses SELinux Sandboxes to let you evaluate code in a large number languages.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published