udsn 0.1.0

a [more] robust connection string URI parser/generator
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

# uDSN

A quick little DSN parser that can give you a nice looking URI connection string on the other side:

```rust
use udsn::{DSN, Resource};

let dsn = DSN::new(
    "postgres".to_string(),     // protocol
    None,                       // username
    None,                       // password
    Resource::URI("localhost"), // uri or localpath
    Some(5432),                 // port
    Some("db_name"),            // dbname
    Some(vec![                  // params
        ("sslmode",         Some("verify")),
        ("connect_timeout", Some("10"))
    ]),
);

dsn.to_string() == "postgresql://localhost/db?sslmode=verify-full&connect_timeout=10";

/* OR, parse and modify an existing */

let dsn = DSN::parse("postgresql://localhost/db?sslmode=verify-full&connect_timeout=10");

dsn.username = Some("user");
dsn.password = Some("pass");

dsn.to_string() == "postgresql://user:pass@localhost/db?sslmode=verify-full&connect_timeout=10";

/* as a bonus you can also use the percent encoder/decoder */

use udsn::{percent_encode, percent_decode};

percent_encode("/...") == "%2f...";
percent_decode("%2f...") == "/...";

```

# Motivation

The motiviation for writing this module is that other DSN modules had various bugs, dependencies, or other weirdness.
The most common being that odd characters would show up when using parameters (or no parameters) and upon looking
at the tests, they tested the one use case they needed the module for. Or, they provided no documentation/examples.

So, here we are.