pdk-classy 1.8.0

PDK Classy
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

// Copyright (c) 2026, Salesforce, Inc.,
// All rights reserved.
// For full license text, see the LICENSE.txt file

use std::{
    future::{ready, Future, Ready},
    ops::Deref,
};

use super::FromContext;
use crate::BoxError;

mod mode {
    pub enum Once {}

    pub enum Repeat {}
}

#[doc(hidden)]
pub struct Exclusive<'c, C> {
    context: &'c C,
}

impl<'c, C> Exclusive<'c, C> {
    pub(crate) fn new(context: &'c C) -> Self {
        Self { context }
    }

    pub fn get(&self) -> &'c C {
        self.context
    }
}

impl<C> Deref for Exclusive<'_, C> {
    type Target = C;

    fn deref(&self) -> &Self::Target {
        self.get()
    }
}

/// Extract data from the given context. The extraction will only be possible once.
pub trait FromContextOnce<C, M = mode::Once>: Sized {
    type Error: Into<BoxError>;

    type Future<'c>: Future<Output = Result<Self, Self::Error>> + 'c
    where
        C: 'c;

    fn from_context_once(context: Exclusive<C>) -> Self::Future<'_>;
}

impl<C, T> FromContextOnce<C, mode::Repeat> for T
where
    for<'c> T: FromContext<C> + 'c,
{
    type Error = T::Error;

    type Future<'c>
        = Ready<Result<Self, Self::Error>>
    where
        C: 'c,
        Self: 'c;

    fn from_context_once(context: Exclusive<C>) -> Self::Future<'_> {
        ready(T::from_context(&context))
    }
}