Fixed docs, version number and made server required

This commit is contained in:
vanten-s 2023-10-19 17:23:38 +02:00
parent 83b10eb3d5
commit 15238aade7
Signed by: vanten-s
GPG key ID: DE3060396884D3F2
3 changed files with 30 additions and 22 deletions

View file

@ -1,6 +1,6 @@
[package] [package]
name = "e2e-irc" name = "e2e-irc"
version = "0.1.0" version = "1.0.2"
edition = "2021" edition = "2021"
# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

View file

@ -1,25 +1,35 @@
# e2e-irc # e2e-irc
This is an IRC bouncer that supports end-to-end encryption and is horribly written. This is an IRC bouncer that supports end-to-end encryption and is horribly written.
# Setup CWD # Configuration
To use this you need to build it and in your CWD you need to add two files. One called `secret.gpg` and one called `public.gpg` that are just pgp keys. e2e-irc uses a config file in `~/.config/e2e-irc/config.toml` on linux.
You also need a .env file in your CWD like this: The configuration file is a toml file with two or three fields:
- public_key the location of the public pgp key
- secret_key the location of the secret pgp key
- passwd the password of the pgp key
# Usage
```
e2e-irc [OPTIONS] SERVER
Encrypted IRC Bouncer
Positional arguments:
server The Address Of The Server The Bouncer Connects To
Optional arguments:
-h,--help Show this help message and exit
-p,--port PORT The Port The Bouncer Binds To
--sp,--server-port SERVER_PORT
The TLS Enabled Port Of The Server
```
# Install
```bash ```bash
SERVER={address of the server you want to connect to (has to support tls)} cargo install --git https://forgejo.vanten-s.com/vanten-s/e2e-irc.git
PORT={the port you want the program to bind to and the port that the IRC client should connect to}
PASSWD={password of your pgp key} # Optional
``` ```
# Run # Run
Then you just run the binary with:
`cargo run --release`
or build the project to get a binary
```bash ```bash
cargo build --release e2e-irc [OPTIONS] SERVER
cp target/release/e2e-irc ~/.local/bin/
``` ```
and after running that once you can run the program with
```bash
e2e-irc
```
but you have to have the .env in the CWD

View file

@ -54,11 +54,9 @@ fn main() -> Result<()> {
{ {
let mut ap = ArgumentParser::new(); let mut ap = ArgumentParser::new();
ap.set_description("Encrypted IRC Bouncer"); ap.set_description("Encrypted IRC Bouncer");
ap.refer(&mut server).add_option( ap.refer(&mut server)
&["-s", "--server"], .add_argument("server", Store, "The Address Of The Server The Bouncer Connects To")
Store, .required();
"The Server The Bouncer Connects To",
);
ap.refer(&mut port) ap.refer(&mut port)
.add_option(&["-p", "--port"], Store, "The Port The Bouncer Binds To"); .add_option(&["-p", "--port"], Store, "The Port The Bouncer Binds To");
ap.refer(&mut server_port).add_option( ap.refer(&mut server_port).add_option(