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
114
115
116
117
118
119
120

// Copyright 2018 Parity Technologies (UK) Ltd.
//
// Permission is hereby granted, free of charge, to any person obtaining a
// copy of this software and associated documentation files (the "Software"),
// to deal in the Software without restriction, including without limitation
// the rights to use, copy, modify, merge, publish, distribute, sublicense,
// and/or sell copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
// DEALINGS IN THE SOFTWARE.

#![allow(deprecated)]

use crate::upgrade::{InboundUpgrade, OutboundUpgrade, UpgradeInfo};

/// Upgrade that can be disabled at runtime.
///
/// Wraps around an `Option<T>` and makes it available or not depending on whether it contains or
/// not an upgrade.
#[derive(Debug, Clone)]
#[deprecated(
    note = "Will be removed without replacement because it is not used within rust-libp2p."
)]
pub struct OptionalUpgrade<T>(Option<T>);

impl<T> OptionalUpgrade<T> {
    /// Creates an enabled `OptionalUpgrade`.
    pub fn some(inner: T) -> Self {
        OptionalUpgrade(Some(inner))
    }

    /// Creates a disabled `OptionalUpgrade`.
    pub fn none() -> Self {
        OptionalUpgrade(None)
    }
}

impl<T> UpgradeInfo for OptionalUpgrade<T>
where
    T: UpgradeInfo,
{
    type Info = T::Info;
    type InfoIter = Iter<<T::InfoIter as IntoIterator>::IntoIter>;

    fn protocol_info(&self) -> Self::InfoIter {
        Iter(self.0.as_ref().map(|p| p.protocol_info().into_iter()))
    }
}

impl<C, T> InboundUpgrade<C> for OptionalUpgrade<T>
where
    T: InboundUpgrade<C>,
{
    type Output = T::Output;
    type Error = T::Error;
    type Future = T::Future;

    fn upgrade_inbound(self, sock: C, info: Self::Info) -> Self::Future {
        if let Some(inner) = self.0 {
            inner.upgrade_inbound(sock, info)
        } else {
            panic!("Bad API usage; a protocol has been negotiated while this struct contains None")
        }
    }
}

impl<C, T> OutboundUpgrade<C> for OptionalUpgrade<T>
where
    T: OutboundUpgrade<C>,
{
    type Output = T::Output;
    type Error = T::Error;
    type Future = T::Future;

    fn upgrade_outbound(self, sock: C, info: Self::Info) -> Self::Future {
        if let Some(inner) = self.0 {
            inner.upgrade_outbound(sock, info)
        } else {
            panic!("Bad API usage; a protocol has been negotiated while this struct contains None")
        }
    }
}

/// Iterator that flattens an `Option<T>` where `T` is an iterator.
#[derive(Debug, Clone)]
pub struct Iter<T>(Option<T>);

impl<T> Iterator for Iter<T>
where
    T: Iterator,
{
    type Item = T::Item;

    fn next(&mut self) -> Option<Self::Item> {
        if let Some(iter) = self.0.as_mut() {
            iter.next()
        } else {
            None
        }
    }

    fn size_hint(&self) -> (usize, Option<usize>) {
        if let Some(iter) = self.0.as_ref() {
            iter.size_hint()
        } else {
            (0, Some(0))
        }
    }
}

impl<T> ExactSizeIterator for Iter<T> where T: ExactSizeIterator {}