Merge pull request #201 from ethereum/evmc-rust

Add basic Rust bindings

.bumpversion.cfg

@@ -24,3 +24,9 @@ serialize = {major}
 search = EVMC_ABI_VERSION = {current_version}
 replace = EVMC_ABI_VERSION = {new_version}
 
+[bumpversion:file:bindings/rust/evmc-sys/Cargo.toml]
+search = version = \"{current_version}\"
+
+[bumpversion:file:bindings/rust/evmc-vm/Cargo.toml]
+search = version = \"{current_version}\"
+

.gitignore

@@ -1,3 +1,5 @@
 /build
 /cmake-build-*
 /.idea
+Cargo.lock
+/target

Cargo.toml

@@ -0,0 +1,5 @@
+[workspace]
+members = [
+    "bindings/rust/evmc-sys",
+    "bindings/rust/evmc-vm",
+]

bindings/rust/evmc-sys/.gitignore

@@ -0,0 +1,3 @@
+/target
+**/*.rs.bk
+/Cargo.lock

bindings/rust/evmc-sys/Cargo.toml

@@ -0,0 +1,12 @@
+[package]
+name = "evmc-sys"
+version = "6.2.0-dev"
+authors = ["Alex Beregszaszi <[email protected]>"]
+license = "Apache-2.0"
+repository = "https://github.com/ethereum/evmc"
+description = "Bindings to EVMC (low-level)"
+categories = ["external-ffi-bindings"]
+edition = "2018"
+
+[build-dependencies]
+bindgen = "0.48.0"

bindings/rust/evmc-sys/build.rs

@@ -0,0 +1,25 @@
+extern crate bindgen;
+
+use std::env;
+use std::path::PathBuf;
+
+fn gen_bindings() {
+    let bindings = bindgen::Builder::default()
+        .header("evmc.h")
+        // See https://github.com/rust-lang-nursery/rust-bindgen/issues/947
+        .trust_clang_mangling(false)
+        .generate_comments(true)
+        // https://github.com/rust-lang-nursery/rust-bindgen/issues/947#issuecomment-327100002
+        .layout_tests(false)
+        .generate()
+        .expect("Unable to generate bindings");
+
+    let out_path = PathBuf::from(env::var("OUT_DIR").unwrap());
+    bindings
+        .write_to_file(out_path.join("bindings.rs"))
+        .expect("Couldn't write bindings!");
+}
+
+fn main() {
+    gen_bindings();
+}

bindings/rust/evmc-sys/evmc.h

@@ -0,0 +1 @@
+../../../include/evmc/evmc.h

bindings/rust/evmc-sys/src/lib.rs

@@ -0,0 +1,5 @@
+#![allow(non_upper_case_globals)]
+#![allow(non_camel_case_types)]
+#![allow(non_snake_case)]
+
+include!(concat!(env!("OUT_DIR"), "/bindings.rs"));

bindings/rust/evmc-vm/.gitignore

@@ -0,0 +1,3 @@
+/target
+**/*.rs.bk
+/Cargo.lock

bindings/rust/evmc-vm/Cargo.toml

@@ -0,0 +1,11 @@
+[package]
+name = "evmc-vm"
+version = "6.2.0-dev"
+authors = ["Alex Beregszaszi <[email protected]>"]
+license = "Apache-2.0"
+repository = "https://github.com/ethereum/evmc"
+description = "Bindings to EVMC (VM specific)"
+edition = "2018"
+
+[dependencies]
+evmc-sys = { path = "../evmc-sys" }

bindings/rust/evmc-vm/src/lib.rs

@@ -0,0 +1,7 @@
+pub extern crate evmc_sys;
+pub use evmc_sys as ffi;
+
+// TODO: Add helpers for host interface
+// TODO: Add convenient helpers for evmc_result
+// TODO: Add convenient helpers for evmc_execute
+// TODO: Add a derive macro here for creating evmc_create

circle.yml

@@ -160,6 +160,29 @@ jobs:
       - image: circleci/golang:1.11
     steps: *bindings-go-steps
 
+  bindings-rust:
+    docker:
+      - image: rust:1
+    steps:
+      - checkout
+      - run:
+          name: Update environment
+          command: |
+            apt update
+            apt -y install libclang-dev clang
+            rustup component add rustfmt
+            rustup update
+      - run:
+          name: Check formatting
+          command: |
+            rustfmt --version
+            cargo fmt --all -- --check
+      - run:
+          name: Build
+          command: cargo build
+      - run:
+          name: Test
+          command: cargo test
 
 workflows:
   version: 2
@@ -173,6 +196,7 @@ workflows:
       - bindings-go-1.11
       - bindings-go-1.10
       - bindings-go-1.9
+      - bindings-rust
       - test-docs
       - upload-docs:
           requires: