dbcrossbarlib 0.5.3

Library for copying data between databases (pre-release)
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

//! Support for URLs with passwords that can be printed and debugged safely.

use std::{borrow::Cow, fmt};

use crate::common::*;

/// A URL which can be safely printed or logged using `Display` or `Debug`
/// without revealing the password.
#[derive(Clone)]
pub(crate) struct UrlWithHiddenPassword(Url);

impl UrlWithHiddenPassword {
    /// Create a new URL with a hidden password.
    pub(crate) fn new(url: Url) -> Self {
        UrlWithHiddenPassword(url)
    }

    // Get our actual URL, including the password.
    pub(crate) fn with_password(&self) -> &Url {
        &self.0
    }

    // Get a mutable copy of our underlying URL.
    pub(crate) fn as_url_mut(&mut self) -> &mut Url {
        &mut self.0
    }

    /// Get our underlying URL with any password removed.
    fn without_password(&self) -> Cow<'_, Url> {
        if self.0.password().is_some() {
            let mut url = self.0.clone();
            url.set_password(Some("XXXXXX")).expect(
                "should always be able to set password for `UrlWithHiddenPassword`",
            );
            Cow::Owned(url)
        } else {
            Cow::Borrowed(&self.0)
        }
    }
}

impl fmt::Debug for UrlWithHiddenPassword {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        fmt::Debug::fmt(&self.without_password(), f)
    }
}

impl fmt::Display for UrlWithHiddenPassword {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        fmt::Display::fmt(&self.without_password(), f)
    }
}