prax 0.1.1

a web penetration proxy hosted in neovim
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

use clap::Parser;
use std::{net::SocketAddr, path::PathBuf, str::FromStr};

/// an attack proxy designed with neovim in mind
#[derive(Parser)]
#[clap(version, author = "eulegang", long_about = None)]
pub struct Cli {
    /// attack endpoint
    #[clap(short, long, default_value = "127.0.0.1:8091")]
    pub listen: SocketAddr,

    /// configure script
    #[clap(short = 'f', long = "file")]
    pub configure: Option<PathBuf>,

    /// watch configure script
    #[clap(short, long, requires = "configure")]
    #[cfg(target_os = "linux")]
    pub watch: bool,

    /// log file
    #[clap(short = 'L', long)]
    pub log: Option<PathBuf>,

    /// trace all requests
    #[clap(short, long)]
    pub trace: bool,

    /// options to connect neovim
    #[clap(short, long)]
    pub nvim: Option<NvimConnInfo>,

    #[clap(flatten)]
    pub tls: CertOpts,
}

#[derive(Clone)]
pub enum NvimConnInfo {
    Stdin,
    Unix(PathBuf),
}

#[derive(Parser)]
pub struct CertOpts {
    /// private key for a tls session
    #[clap(short, long, requires = "cert")]
    pub key: Option<PathBuf>,

    /// certificate for a tls session
    #[clap(short, long, requires = "key")]
    pub cert: Option<PathBuf>,
}

impl FromStr for NvimConnInfo {
    type Err = <PathBuf as FromStr>::Err;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        if s == "-" {
            Ok(NvimConnInfo::Stdin)
        } else {
            Ok(NvimConnInfo::Unix(PathBuf::from_str(s)?))
        }
    }
}

impl NvimConnInfo {
    /// whether this connection method should kill the proxy
    pub fn singleton(&self) -> bool {
        matches!(self, NvimConnInfo::Stdin)
    }
}