gantz_core 0.4.1

The core types and traits for gantz, an environment for creative systems.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

//! A node that applies a function to a list of arguments.

use crate::node;
use gantz_ca::CaHash;
use gantz_nodetag::NodeTag;
use serde::{Deserialize, Serialize};

/// A node that applies a function to arguments.
///
/// In other words, this node "calls" the function received on the first input
/// with the arguments received on the second input.
///
/// The node is stateless and evaluates immediately when a function is received.
#[derive(Clone, Debug, Default, Eq, Hash, PartialEq, Deserialize, Serialize, CaHash, NodeTag)]
#[cahash("gantz.apply")]
pub struct Apply;

impl node::Node for Apply {
    /// Two inputs:
    ///
    /// 1. A function value. Receiving this triggers evaluation.
    /// 2. A list of arguments. Assumed `'()` if unconnected.
    fn n_inputs(&self, _ctx: node::MetaCtx) -> usize {
        2
    }

    /// The result of function application.
    fn n_outputs(&self, _ctx: node::MetaCtx) -> usize {
        1
    }

    fn expr(&self, ctx: node::ExprCtx<'_, '_>) -> node::ExprResult {
        let inputs = ctx.inputs();

        // Get function and arguments from inputs
        let function = inputs.get(0).and_then(|opt| opt.as_ref());
        let arguments = inputs.get(1).and_then(|opt| opt.as_ref());
        let args = arguments.map_or("'()", |s| &s[..]);
        let expr = function
            .map(|f| format!("(apply {f} {args})"))
            .unwrap_or_else(|| "'()".to_string());
        node::parse_expr(&expr)
    }
}