Add executable, example, and README.

Author: progval

Cargo.toml

@@ -3,4 +3,12 @@ name = "pythonvm"
 version = "0.1.0"
 authors = ["Valentin Lorentz <progval+git@progval.net>"]
 
+[lib]
+name = "pythonvm"
+path = "src/lib.rs"
+
+[[bin]]
+name = "pythonvm"
+path = "src/bin.rs"
+
 [dependencies]

README.md

@@ -0,0 +1,16 @@
+# pythonvm-rust
+
+A Python virtual machine, written in Rust.
+
+## Features
+
+* prints strings to stdout
+* useable as a library
+* a fine-grained sandbox
+
+## Try it
+
+1. Install git, [Rust](https://www.rust-lang.org/downloads.html) and [Cargo](https://crates.io/install)
+2. `git clone https://github.com/ProgVal/pythonvm-rust.git`
+3. `cd pythonvm-rust`
+4. `cargo run examples/helloworld.pyc`

examples/helloworld.pyc

@@ -0,0 +1,29 @@
+extern crate pythonvm;
+
+use std::env::args;
+use std::fs::File;
+
+fn parse_args() -> (String, Option<String>) {
+    let mut args = args();
+    let executable = args.next().unwrap();
+    let filename = args.next();
+    let extra = args.next();
+    match (filename, extra) {
+        (Some(filename), None) => (executable, Some(filename)),
+        _ => (executable, None),
+    }
+}
+
+
+pub fn main() {
+    let filename = match parse_args() {
+        (_, Some(filename)) => filename,
+        (executable, None) => {
+            println!("Syntax: {} filename.pyc", executable);
+            return
+        }
+    };
+    let mut file = File::open(filename).unwrap();
+    let env_proxy = pythonvm::RealEnvProxy::new();
+    let (_processor, _result) = pythonvm::run_module(&mut file, env_proxy).unwrap();
+}

src/bin.rs

@@ -8,6 +8,8 @@ use std::fmt;
 use std::io;
 use processor::Processor;
 
+pub use sandbox::{RealEnvProxy, MockEnvProxy};
+
 #[derive(Debug)]
 pub enum InterpreterError {
     Io(io::Error),