activityforge 0.1.0-pre-alpha.2

ActivityForge federated git forges over ActivityPub
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

use activitystreams_vocabulary::{impl_default, impl_display};
use base64::Encoding;
use serde::{Deserialize, Serialize};
use zeroize::{Zeroize, ZeroizeOnDrop};

use crate::{Error, Result};

/// Represents user credentials for authentication.
#[derive(Clone, Debug, Eq, PartialEq, Deserialize, Serialize, Zeroize, ZeroizeOnDrop)]
pub struct Credentials {
    username: String,
    password: String,
}

impl Credentials {
    /// Create a new [Credentials].
    pub const fn new() -> Self {
        Self {
            username: String::new(),
            password: String::new(),
        }
    }

    /// Creates a new [Credentials] from the provided parameters.
    pub fn create<U, P>(username: U, password: P) -> Self
    where
        U: Into<String>,
        P: Into<String>,
    {
        Self {
            username: username.into(),
            password: password.into(),
        }
    }

    /// Gets the username.
    pub fn username(&self) -> &str {
        self.username.as_str()
    }

    /// Gets the password.
    pub fn password(&self) -> &str {
        self.password.as_str()
    }

    /// Attempts to parse [Credentials] encoded in a basic-auth header.
    pub fn from_basic_auth(header: &str) -> Result<Self> {
        header
            .strip_prefix("Basic ")
            .ok_or(Error::http("creds: invalid basic-auth header"))
            .and_then(|c| {
                base64::Base64::decode_vec(c).map_err(|err| {
                    Error::http(format!("creds: error decoding basic-auth header: {err}"))
                })
            })
            .and_then(|c| {
                String::from_utf8(c)
                    .map_err(|err| Error::http(format!("creds: invalid UTF-8 encoding: {err}")))
            })
            .and_then(|c| {
                c.split_once(":")
                    .ok_or(Error::http("creds: missing delimiter"))
                    .map(|(u, p)| Self {
                        username: u.into(),
                        password: p.into(),
                    })
            })
    }

    /// Converts the [Credentials to a basic-auth header value.
    pub fn to_basic_auth(&self) -> String {
        let b64 = base64::Base64::encode_string(
            format!("{}:{}", self.username, self.password).as_bytes(),
        );
        format!("Basic {b64}")
    }
}

impl_default!(Credentials);
impl_display!(Credentials, json);