3 releases (breaking)
0.4.0 | Oct 17, 2024 |
---|---|
0.3.0 | Sep 22, 2024 |
0.1.0 | Aug 9, 2024 |
#294 in Geospatial
198 downloads per month
Used in nadi_core
25KB
549 lines
Proc Macros for Nadi System Plugins
Note:
This crate is re-exported by the nadi_core
library so there is no
need to use this directly. It is better to use the functions exported
from nadi_core
for consitency.
Introduction
This crate contains the necessary macros for the nadi system plugin development in rust.
The plugins can be developed without using the macros, but this makes it easier, less error prone, and easier to upgrade to new versions.
Example Plugin:
Cargo.toml
:
[package]
name = "example_plugin"
version = "0.1.0"
edition = "2021"
[lib]
crate-type = ["cdylib"]
[dependencies]
anyhow = "1.0.86"
nadi_core = "0.3.0"
nadi_plugin = "0.2.0"
src/lib.rs
:
use nadi_plugin::nadi_plugin;
#[nadi_plugin]
mod example {
use nadi_core::{Network, NodeInner};
use nadi_plugin::{network_func, node_func};
/// Print the given attr of the node as string.
///
/// This is a basic node funtion, the purpose of this function is
/// to demonstrate how node functions can be written. But it might
/// be useful in some cases.
#[node_func]
fn print_attr(node: &mut NodeInner, attr: String, key: bool) {
println!(
"{}{}",
if key { &attr } else { "" },
node.attr(&attr).map(|a| a.to_string()).unwrap_or_default()
);
}
/// List all the attributes on the node
#[node_func]
fn list_attr(node: &mut NodeInner) {
let attrs: Vec<&str> = node.attrs().iter().map(|kv| kv.0.as_str()).collect();
println!("{}: {}", node.name(), attrs.join(", "));
}
/// Print the given attr of all the nodes in a network
#[network_func]
fn print_net_attr(net: &mut Network, attr: String) {
for node in net.nodes() {
let node = node.lock();
println!(
"{}: {}",
node.name(),
node.attr(&attr).map(|a| a.to_string()).unwrap_or_default()
);
}
}
}
Dependencies
~1.3–1.8MB
~36K SLoC