guild 0.1.1

Guild is a Command Line Interface build with Rust that posts code snippets to a Discord channel using Webhooks.
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

# guild

Guild is a Command Line Utility that allows you to post code snippets from a file to a Discord channel.

# How does it work?

By utilizing [Serenity](https:://www.github.com/serenity-rs/serenity) to access the Discord API, guild communicates with your Discord server using Webhooks. This allows guild to post a message to Discord on its own without having to type anything into Discord itself.

# Download

## Install Rust

In order to download guild, you need to have Rust downloaded on your computer if you don't already. To install Rust, use one of the following commands based on your computer's Operating System:

#### Unix 
```bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
```
#### Windows
Download the following executable and follow the setup instructions: [rustup-init.exe](https://static.rust-lang.org/rustup/dist/i686-pc-windows-gnu/rustup-init.exe)

If the downloads go well, you will see the following message: 
```
Rust is installed now. Great!
```

## Install guild

Once Rust is installed on your machine, you must install guild through Cargo: 
```bash
cargo install guild
```

# Usage

1. Create a [Discord Webhook](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks) in the desired server
2. Copy the Discord Webhook URL and execute the following command in your terminal
    ```bash
    guild set <webhook url>
    ```
3. Post your desired code snippet to the Discord server: 
    ```bash
    guild post <file path> <starting line> <ending line>
    ```
    - If you would like the code snippet to have syntax highlighting, add the following flag at the end of your command:
        ```bash
        guild post <file path> <starting line> <ending line> -H
        ```
        or 
        ```bash
        guild post <file path> <starting line> <ending line> --highlight
        ```
    - Example:
        ```bash
        guild post main.c 1 5 -H
        ```