geodesy 0.15.0

A platform for experiments with geodetic transformations and data flow
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
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

use super::*;

/// Interface between the high level [Op::op()](crate::op::Op) and the low level
/// functionality in the [InnerOp](crate::inner_op::InnerOp)s
///
/// `RawParameters` is the vehicle used by the `Op`erator factory in `Op::op(...)`,
/// to ferry args around from the invocator into the constructor of the individual
/// `InnerOp`s.
///
/// The `InnerOp`constructor typically interprets the contents of
/// `RawParameters`, and converts it into a more runtime friendly instance of
/// `ParsedParameters`.
#[derive(Debug, Default, Clone)]
pub struct RawParameters {
    pub invoked_as: String,
    pub instantiated_as: String,
    pub globals: BTreeMap<String, String>,
    pub recursion_level: usize,
}

impl RawParameters {
    pub fn new(invocation: &str, globals: &BTreeMap<String, String>) -> RawParameters {
        // This, and RawParameters::expand() should be the only places, where the syntax
        // cleanup functions from the Tokenize trait, is needed
        let invocation = invocation.remove_comments().normalize();

        let globals = globals.clone();
        let recursion_level = 0;

        // The intricacies of pipeline instantiation is handled directly by Op::op(),
        // which calls pipeline's constructor to do the hard work. So from here, we just
        // hand over the invocation and globals for them to use
        if invocation.is_pipeline() {
            let definition = invocation.clone();
            return RawParameters {
                invoked_as: invocation,
                instantiated_as: definition,
                globals,
                recursion_level,
            };
        }

        // The FIRST step of a pipeline may start with one of the modifiers
        // (inv, omit_inv, omit_fwd), but we cannot rotate that to the end
        // of the invocation, because that would be moving it to the end of
        // the LAST step of the pipeline

        // But if we're here, we're not handling a pipeline, so we can safely rotate
        // modifiers to the end.
        let invocation = invocation.handle_prefix_modifiers();

        // Not a pipeline? Then it is either a macro, a built-in or
        // a user defined op, and we can just carry on
        let definition = invocation.clone();
        RawParameters {
            invoked_as: invocation,
            instantiated_as: definition,
            globals: globals.clone(),
            recursion_level: 0,
        }
    }
}

// ----- T E S T S ---------------------------------------------------------------------

// RawParameters gets its test coverage from the tests in `op/mod.rs`