urlencode 1.0.1

A CLI utility for URL-encoding or -decoding strings
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

# `urlencode`

`urlencode` is a CLI utility for URL-encoding or -decoding strings.

## Usage

You can give it a positional argument for a single string, or you can pipe input
to it from stdin.

```bash
$ urlencode 'foo bar'
foo%20bar

$ echo -e "foo bar\nbaz quux" | urlencode
foo%20bar
baz%20quux
```

You can pass `-d` or `--decode` to decode the input.

```bash
$ urlencode -d 'foo%20bar'
foo bar

$ echo -e "foo%20bar\nbaz%20quux" | urlencode -d
foo bar
baz quux
```

Run `urlencode --help` to see all options.

### Encode sets

Since different parts of a URL have different encoding requirements, there are
many encode sets to choose from. See
[this documentation page](https://docs.rs/percent-encoding/1.0.0/percent_encoding/index.html)
for an explanation of each. They can be specified with the `-e` or `--encode-set`
option:

```bash
$ echo 'https://docs.rs/percent-encoding/1.0.0/percent_encoding/index.html' | urlencode -e path
https:%2F%2Fdocs.rs%2Fpercent-encoding%2F1.0.0%2Fpercent_encoding%2Findex.html

$ echo 'https://docs.rs/percent-encoding/1.0.0/percent_encoding/index.html' | urlencode -e userinfo
https%3A%2F%2Fdocs.rs%2Fpercent-encoding%2F1.0.0%2Fpercent_encoding%2Findex.html
----
```

### Cargo

You can install with Cargo with:

```bash
cargo install urlencode
```