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.
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:
- Write the code to a file that the sandboxed ruby can access.
- Write the code to a file that can not be reached by the sandbox, for audit purposes.
- Ask the sandbox to evaluate the code using
ruby
. - Remove the sandbox-accessible code.
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.
![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# |
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 are gladly accepted. Please run the specs and ensure they pass.
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.