envoy-sdk 0.1.0

Rust SDK for WebAssembly-based Envoy extensions
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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

// Copyright 2020 Tetrate
//
// 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.

use super::{ContextOps, DrainStatus, ExtensionFactory, Ops};
use crate::abi::proxy_wasm::traits::{ChildContext, Context, RootContext};
use crate::extension::error::ErrorSink;
use crate::extension::{ConfigStatus, InstanceId};
use crate::host::ByteString;

pub(crate) struct ExtensionFactoryContext<'a, F>
where
    F: ExtensionFactory,
{
    factory: F,
    context_ops: &'a dyn ContextOps,
    factory_ops: &'a dyn Ops,
    error_sink: &'a dyn ErrorSink,
    child_context_factory: fn(&mut F, InstanceId) -> ChildContext,
}

impl<'a, F> RootContext for ExtensionFactoryContext<'a, F>
where
    F: ExtensionFactory,
{
    fn on_configure(&mut self, configuration_size: usize) -> bool {
        let config = if configuration_size == 0 {
            Ok(ByteString::default())
        } else {
            self.context_ops.configuration(0, configuration_size)
        };
        match config.and_then(|config| {
            self.factory
                .on_configure(config, self.factory_ops.as_configure_ops())
        }) {
            Ok(status) => status.as_bool(),
            Err(err) => {
                self.error_sink
                    .observe("failed to configure extension", &err);
                ConfigStatus::Rejected.as_bool()
            }
        }
    }

    fn on_create_child_context(&mut self, context_id: u32) -> Option<ChildContext> {
        let new_child_context = self.child_context_factory;
        Some(new_child_context(
            &mut self.factory,
            InstanceId::from(context_id),
        ))
    }
}

impl<'a, F> Context for ExtensionFactoryContext<'a, F>
where
    F: ExtensionFactory,
{
    fn on_done(&mut self) -> bool {
        match self.factory.on_drain() {
            Ok(status) => status.as_bool(),
            Err(err) => {
                self.error_sink
                    .observe("failed to initiate draining of the extension", &err);
                DrainStatus::Ongoing.as_bool()
            }
        }
    }
}

impl<'a, F> ExtensionFactoryContext<'a, F>
where
    F: ExtensionFactory,
{
    pub fn new(
        factory: F,
        context_ops: &'a dyn ContextOps,
        factory_ops: &'a dyn Ops,
        error_sink: &'a dyn ErrorSink,
        child_context_factory: fn(&mut F, InstanceId) -> ChildContext,
    ) -> Self {
        ExtensionFactoryContext {
            factory,
            context_ops,
            factory_ops,
            error_sink,
            child_context_factory,
        }
    }

    /// Creates a new factory context bound to the actual Envoy ABI.
    pub fn with_default_ops(
        factory: F,
        child_context_factory: fn(&mut F, InstanceId) -> ChildContext,
    ) -> Self {
        Self::new(
            factory,
            ContextOps::default(),
            Ops::default(),
            ErrorSink::default(),
            child_context_factory,
        )
    }
}