mirror of
https://github.com/fluencelabs/marine-rs-sdk
synced 2025-03-14 22:10:49 +00:00
127 lines
3.8 KiB
Rust
127 lines
3.8 KiB
Rust
/*
|
|
* Copyright 2020 Fluence Labs Limited
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
//! Rust backend SDK for applications on the Fluence network. This crate defines the procedure macro
|
|
//! `#[marine]` that could be applied to a function, structure or extern block.
|
|
//!
|
|
//! Structures with `#[marine]` (hereinafter they'll be called records) could be used then in function
|
|
//! arguments and values. All fields of a record should be public and have one of the
|
|
//! following primitive Rust types
|
|
//! (`bool, u8, u16, u32, u64, i8, i16, i32, i64, f32, f64, String, Vec<u8>`).
|
|
//! ```rust
|
|
//! use marine_rs_sdk::marine;
|
|
//!
|
|
//! #[marine]
|
|
//! struct T {
|
|
//! pub field_1: i32,
|
|
//! pub field_2: Vec<u8>,
|
|
//! }
|
|
//! ```
|
|
//!
|
|
//! Functions with `#[marine]` will be exported from this module:
|
|
//!
|
|
//! ```rust
|
|
//! use marine_rs_sdk::marine;
|
|
//!
|
|
//! #[marine]
|
|
//! pub fn get(url: String) {
|
|
//! // ...
|
|
//! }
|
|
//! ```
|
|
//! At now, such functions could have arguments with primitive Rust types and record and only one
|
|
//! return argument with such type could be used.
|
|
//!
|
|
//! Finally, to import other wasm modules to your project use similar code:
|
|
//! ```rust
|
|
//! use marine_rs_sdk::marine;
|
|
//!
|
|
//! #[marine]
|
|
//! #[link(wasm_import_module = "wasm_curl.wasm")]
|
|
//! extern "C" {
|
|
//! #[link_name = "get"]
|
|
//! pub fn curl_get(url: String) -> String;
|
|
//! }
|
|
//! ```
|
|
#![doc(html_root_url = "https://docs.rs/sdk/0.8.1")] // x-release-please-version
|
|
#![deny(
|
|
dead_code,
|
|
nonstandard_style,
|
|
unused_imports,
|
|
unused_mut,
|
|
unused_variables,
|
|
unused_unsafe,
|
|
unreachable_patterns
|
|
)]
|
|
#![warn(rust_2018_idioms)]
|
|
|
|
mod call_parameters;
|
|
mod mounted_binary;
|
|
|
|
#[allow(unused_extern_crates)]
|
|
// sdk is used inside CallParameters and MountedBinaryResult glue code
|
|
extern crate self as marine_rs_sdk;
|
|
|
|
pub use marine_macro::marine;
|
|
pub use marine_macro::fce;
|
|
|
|
pub use call_parameters::CallParameters;
|
|
pub use call_parameters::SecurityTetraplet;
|
|
pub use call_parameters::get_call_parameters;
|
|
|
|
#[cfg(feature = "logger")]
|
|
pub use marine_rs_sdk_main::WasmLoggerBuilder;
|
|
#[cfg(feature = "logger")]
|
|
pub use marine_rs_sdk_main::TargetMap;
|
|
|
|
pub use mounted_binary::MountedBinaryResult;
|
|
pub use mounted_binary::MountedBinaryStringResult;
|
|
pub use mounted_binary::SUCCESS_CODE as BINARY_SUCCESS_CODE;
|
|
|
|
pub use marine_rs_sdk_main::module_manifest;
|
|
|
|
/// These API functions are intended for internal usage in generated code.
|
|
/// Normally, you shouldn't use them.
|
|
#[doc(hidden)]
|
|
pub mod internal {
|
|
pub use marine_rs_sdk_main::get_result_ptr;
|
|
pub use marine_rs_sdk_main::get_result_size;
|
|
pub use marine_rs_sdk_main::set_result_ptr;
|
|
pub use marine_rs_sdk_main::set_result_size;
|
|
pub use marine_rs_sdk_main::add_object_to_release;
|
|
pub use marine_timestamp_macro::build_timestamp;
|
|
}
|
|
|
|
#[cfg(not(feature = "no-explicit-ctors-call"))]
|
|
#[cfg(target_arch = "wasm32")]
|
|
extern "C" {
|
|
// For internal use. Not an API function.
|
|
fn __wasm_call_ctors();
|
|
}
|
|
|
|
// Adds an explicit __wasm_call_ctors call to tell LLVM not to
|
|
// wrap every export in __wasm_call_ctors/__wasm_call_dtors calls.
|
|
// The most referenced issue about it is https://github.com/WebAssembly/WASI/issues/471
|
|
// For internal use. Not an API function.
|
|
#[cfg(not(feature = "no-explicit-ctors-call"))]
|
|
#[cfg(target_arch = "wasm32")]
|
|
#[doc(hidden)]
|
|
#[no_mangle]
|
|
pub fn _initialize() {
|
|
unsafe {
|
|
__wasm_call_ctors();
|
|
}
|
|
}
|