udsn 0.2.1

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
48
49
50

# 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()
    .protocol("postgres"),       // protocol
    .username(Some("username")), // username
    .password(None),             // password
    .resource(Resource::URI("localhost".to_string())), // uri or localpath
    .host("localhost")           // convenience shortcut for .resource(Resource::URI...
    .path("/tmp/db.sqlite")      // convenience shortcut for .resourde(Resource::Path...
    .port(Some(5432)),           // port
    .database(Some("db_name")),  // dbname
    .params(                     // params
        Some(vec![
            ("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.