Russel! A compiler for a subset of Rust written in Haskell

Hugo Sales ddef14663b Cleanup 3 years ago
examples 7a373fbe82 println! 4 years ago
input 4423315b5c Add parser and IR support for operations like '++' and '+=' 4 years ago
spec 024a9fba56 Refactor and restructure 4 years ago
src 9851e97bcf Change register mappings 4 years ago
.gitignore e95f72b8f9 Further refactoring in preparation for starting work on MIPS target 4 years ago
COPYING.md 3ce06321ca Finish it 4 years ago
Makefile 13e17e1c83 Add .info to Makefile's clean routine 4 years ago
README.md ebbf1514f4 Update readme's instructions 4 years ago
mc.sh c412c5f730 Enhance script 4 years ago

README.md

Russel! - A functional compiler for a small subset of Rust

______                              _   _
| ___ \                            | | | |
| |_/ /  _   _   ___   ___    ___  | | | |
|    /  | | | | / __| / __|  / _ \ | | | |
| |\ \  | |_| | \__ \ \__ \ |  __/ | | |_|
\_| \_|  \__,_| |___/ |___/  \___| |_| (_)

The name was choosen after the compsci Steve RUSsel, who contributed to Lisp and Spacewar!.

Usage

  1. Install https://hackage.haskell.org/package/ optparse-applicative -0.13.2.0/docs/Options-Applicative.html via cabal
  2. Run make to compile the program
  3. ./compiler some_input_file.rs and it will generate an out.asm (check the help menu for more)
  4. Run make clean to cleanup when you’re done

Supported Syntax

  • Function declaration and builtin functions (println, read_line)

    fn main () {
      read_line();
      println(42);
    }
    
    fn _auxiliary () {
    
    }
    
  • Control Flow (If), Loops (While) and arithmetic and boolean expressions

    fn main () {
      let i = 0;
      while (i <= 1337)
      {
        if (i % 2 == 0) {
          println(1337);
        } else if (i == 42) {
          println(42);
        } else {
          println(31337);
        }
      }
    }
    
  • Let attributions of Integers (of size 8, 16, 32, 64, 128) and Booleans as well as variables

    fn main () {
      let x = -1337;
      let y: u64 = 42;
      let z = true;
      let a = z;
    
      let xyz = if x == 42 {
                    1337;
                }
                else if y == false {
                    31337;
                }
                else {
                  42;
                };
    }
    

Here’s a bit of crazy code that Russel! can handle pretty well :)

fn main ()
{
  let x = -1337;
  if x == 5 {
      let _foo: i32 = 5;
  }
  else if (x == 6)
  {
      let _foo: u128 = 6;
  }
  else {
      let _foo = 0;
  }
}
fn _spaceship () {
  let x: u64 = 1337;
          ;;               ;;
         ;;                 ;;
        ;;                   ;;
       ;;                     ;;
      ;;                       ;;
     ;;;         ;;;;;         ;;;
    ;;;       ;;;     ;;;       ;;;
   ;;;       ;   ;;;;;   ;       ;;;
  ; ;       ;  ;;;   ;;;  ;       ; ;
  ; ;;;;;;;;   ; ;;;;; ;   ;;;;;;;; ;
  ; ;;;;;;;;   ; ;;;;; ;   ;;;;;;;; ;
  ; ;       ;   ;;   ;;   ;       ; ;
   ;;;       ;   ;;;;;   ;       ;;;
    ;;;       ;;;     ;;;       ;;;
     ;;;         ;;;;;         ;;;
      ;;                       ;;
       ;;                     ;;
        ;;                   ;;
         ;;                 ;;
          ;;               ;;
  let _foo = if x == 5 {
                  42;
            }
            else if x == 6 {
                 -1337;
            }
            else {
                31337;
            };;;;;;;
}

Authors

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

Additional permission under GNU GPL version 3 section 7

If you modify this program, or any covered work, by linking or combining it with the OpenSSL project's OpenSSL library (or a modified version of that library), containing parts covered by the terms of the OpenSSL or SSLeay licenses, the Free Software Foundation grants you additional permission to convey the resulting work. Corresponding Source for a non-source form of such a combination shall include the source code for the parts of OpenSSL used as well as that of the covered work.