WIP #73 fp-bindgen

Author: joepio

Cargo.lock

@@ -1,8 +1,8 @@
 [workspace]
+exclude = ["plugin-example"]
 members = [
   "server",
   "cli",
   "lib",
   "desktop",
-  "plugin-example",
 ]

Cargo.toml

@@ -7,6 +7,11 @@ name = "atomic_lib"
 readme = "README.md"
 repository = "https://github.com/joepio/atomic-data-rust"
 version = "0.31.1"
+
+[[bin]]
+name = "generate-bindings"
+path = "src/plugins/bindings.rs"
+
 # Enables benchmarks to use the features, such as Db
 [[bench]]
 all-features = true

lib/Cargo.toml

@@ -0,0 +1,13 @@
+[package]
+name = "atomic-bindings"
+version = "0.0.1"
+authors = ["Joep Meindertsma <[email protected]>"]
+edition = "2018"
+
+[dependencies]
+fp-bindgen-support = { path = "../../../../fp-bindgen-support", version = "1.0.0", features = ["async", "guest", "http"] }
+http = { version = "0.2" }
+once_cell = { version = "1.4" }
+rmp-serde = { version = "1.0" }
+serde = { version = "1.0", features = ["derive"] }
+serde_bytes = { version = "0.11" }

lib/bindings/rust-plugin/Cargo.toml

@@ -0,0 +1,13 @@
+use crate::types::*;
+
+#[fp_bindgen_support::fp_export_signature]
+pub async fn fetch_data(url: String) -> String;
+
+#[fp_bindgen_support::fp_export_signature]
+pub async fn my_async_exported_function() -> ComplexGuestToHost;
+
+#[fp_bindgen_support::fp_export_signature]
+pub fn my_complex_exported_function(a: ComplexHostToGuest) -> ComplexAlias;
+
+#[fp_bindgen_support::fp_export_signature]
+pub fn my_plain_exported_function(a: u32, b: u32) -> u32;

lib/bindings/rust-plugin/src/export.rs

@@ -0,0 +1,23 @@
+use crate::types::*;
+
+#[fp_bindgen_support::fp_import_signature]
+pub fn count_words(string: String) -> Result<u16, String>;
+
+#[fp_bindgen_support::fp_import_signature]
+/// Logs a message to the (development) console.
+pub fn log(message: String);
+
+#[fp_bindgen_support::fp_import_signature]
+pub async fn make_request(opts: RequestOptions) -> Result<Response, RequestError>;
+
+#[fp_bindgen_support::fp_import_signature]
+pub async fn my_async_imported_function() -> ComplexHostToGuest;
+
+#[fp_bindgen_support::fp_import_signature]
+/// This one passes complex data types. Things are getting interesting.
+pub fn my_complex_imported_function(a: ComplexAlias) -> ComplexHostToGuest;
+
+#[fp_bindgen_support::fp_import_signature]
+/// This is a very simple function that only uses primitives. Our bindgen should have little
+/// trouble with this.
+pub fn my_plain_imported_function(a: u32, b: u32) -> u32;

lib/bindings/rust-plugin/src/import.rs

@@ -0,0 +1,12 @@
+#[rustfmt::skip]
+mod export;
+#[rustfmt::skip]
+mod import;
+#[rustfmt::skip]
+mod types;
+
+pub use export::*;
+pub use import::*;
+pub use types::*;
+
+pub use fp_bindgen_support::*;

lib/bindings/rust-plugin/src/lib.rs

@@ -0,0 +1,134 @@
+use serde::{Deserialize, Serialize};
+use std::{collections::BTreeMap, collections::HashMap};
+
+pub type Body = serde_bytes::ByteBuf;
+
+pub type ComplexAlias = ComplexGuestToHost;
+
+#[derive(Clone, Debug, Deserialize, PartialEq, Serialize)]
+pub struct ComplexGuestToHost {
+    pub simple: Simple,
+    pub map: BTreeMap<String, Simple>,
+}
+
+/// Multi-line doc comment with complex characters
+/// & " , \ ! '
+#[derive(Clone, Debug, Deserialize, PartialEq, Serialize)]
+#[serde(rename_all = "camelCase")]
+pub struct ComplexHostToGuest {
+    #[serde(flatten)]
+    pub simple: Simple,
+    pub list: Vec<f64>,
+    pub points: Vec<Point<f64>>,
+    pub recursive: Vec<Point<Point<f64>>>,
+    #[serde(default, skip_serializing_if = "Option::is_none")]
+    pub complex_nested: Option<BTreeMap<String, Vec<FloatingPoint>>>,
+
+    /// Raw identifiers are supported too.
+    pub r#type: String,
+    pub value: Value,
+}
+
+#[derive(Clone, Debug, Deserialize, PartialEq, Serialize)]
+pub struct ExplicitedlyImportedType {
+    pub you_will_see_this: bool,
+}
+
+pub type FloatingPoint = Point<f64>;
+
+#[derive(Clone, Debug, Deserialize, PartialEq, Serialize)]
+pub struct GroupImportedType1 {
+    pub you_will_see_this: bool,
+}
+
+#[derive(Clone, Debug, Deserialize, PartialEq, Serialize)]
+pub struct GroupImportedType2 {
+    pub you_will_see_this: bool,
+}
+
+/// Similar to the `RequestOptions` struct, but using types from the `http` crate.
+#[derive(Clone, Debug, Deserialize, PartialEq, Serialize)]
+#[serde(rename_all = "camelCase")]
+pub struct HttpRequestOptions {
+    #[serde(deserialize_with = "fp_bindgen_support::http::deserialize_uri", serialize_with = "fp_bindgen_support::http::serialize_uri")]
+    pub url: http::Uri,
+    #[serde(deserialize_with = "fp_bindgen_support::http::deserialize_http_method", serialize_with = "fp_bindgen_support::http::serialize_http_method")]
+    pub method: http::Method,
+    pub headers: HashMap<String, String>,
+    #[serde(default, skip_serializing_if = "Option::is_none")]
+    pub body: Option<serde_bytes::ByteBuf>,
+}
+
+#[derive(Clone, Debug, Deserialize, PartialEq, Serialize)]
+#[serde(rename_all = "PascalCase")]
+pub struct Point<T> {
+    pub value: T,
+}
+
+/// Represents an error with the request.
+#[derive(Clone, Debug, Deserialize, PartialEq, Serialize)]
+#[serde(tag = "type", rename_all = "snake_case")]
+pub enum RequestError {
+    /// Used when we know we don't have an active network connection.
+    Offline,
+    NoRoute,
+    ConnectionRefused,
+    Timeout,
+    #[serde(rename_all = "snake_case")]
+    ServerError {
+        /// HTTP status code.
+        status_code: u16,
+
+        /// Response body.
+        response: Body,
+    },
+    /// Misc.
+    #[serde(rename = "other/misc")]
+    Other { reason: String },
+}
+
+#[derive(Clone, Debug, Deserialize, PartialEq, Serialize)]
+#[serde(rename_all = "SCREAMING_SNAKE_CASE")]
+pub enum RequestMethod {
+    Delete,
+    Get,
+    Options,
+    Post,
+    Put,
+}
+
+#[derive(Clone, Debug, Deserialize, PartialEq, Serialize)]
+#[serde(rename_all = "camelCase")]
+pub struct RequestOptions {
+    pub url: String,
+    pub method: RequestMethod,
+    pub headers: HashMap<String, String>,
+    #[serde(default, skip_serializing_if = "Option::is_none")]
+    pub body: Option<serde_bytes::ByteBuf>,
+}
+
+/// A response to a request.
+#[derive(Clone, Debug, Deserialize, PartialEq, Serialize)]
+#[serde(rename_all = "camelCase")]
+pub struct Response {
+    /// Response headers, by name.
+    pub headers: HashMap<String, String>,
+
+    /// Response body.
+    pub body: Body,
+}
+
+#[derive(Clone, Debug, Deserialize, PartialEq, Serialize)]
+pub struct Simple {
+    pub foo: i32,
+    pub bar: String,
+}
+
+/// Tagged dynamic value.
+#[derive(Clone, Debug, Deserialize, PartialEq, Serialize)]
+pub enum Value {
+    Integer(i64),
+    Float(f64),
+    List(Vec<Value>),
+    Map(BTreeMap<String, Value>),
+}