# rust-urlparse

[![Build Status](https://travis-ci.org/yykamei/rust-urlparse.svg?branch=master)](https://travis-ci.org/yykamei/rust-urlparse)

This is a URL parsing library written in Rust.

The goal of this project is to provide a simple parsing URL library
like [urllib.parse](https://docs.python.org/3/library/urllib.parse.html) in Python3.x.

## Examples

### Source code

``` rust
extern crate urlparse;
use urlparse::urlparse;
use urlparse::GetQuery;  // Trait

fn main() {
    let url = urlparse("http://www.example.com/foo?bar=123&col=println%21%28%22TEST%21%22%29&col=sub");
    let query = url.get_parsed_query().unwrap();
    println!("{:?}", url);
    println!("{:?}", query.get_first_from_str("col"));
}
```

### Output

```
Url { scheme: "http", netloc: "www.example.com", path: "/foo", query: Some("bar=123&col=println%21%28%22TEST%21%22%29&col=sub"), fragment: None, username: None, password: None, hostname: Some("www.example.com"), port: None }
Some("println!(\"TEST!\")")
```

## License

MIT

## Installation

If you're using Cargo, just add urlparse to your Cargo.toml:

    [dependencies.urlparse]
    version = "0.7.2"

## Documentation

The documentation is hosted [online][urlparse-doc].

[urlparse-doc]: https://yykamei.github.io/rust-urlparse