rust-url
========

Rust implementation of the [URL Standard](http://url.spec.whatwg.org/).

See [Rust bug #10707](https://github.com/mozilla/rust/issues/10707).

This depends on [rust-encoding](https://github.com/lifthrasiir/rust-encoding).


API
---

```rust
pub struct URL {
    scheme: ~str,
    scheme_data: SchemeData,
    query: Option<~str>,  // See form_urlencoded::parse_str() to get name/value pairs.
    fragment: Option<~str>,
}

pub enum SchemeData {
    RelativeSchemeData(SchemeRelativeURL),
    OtherSchemeData(~str)
}

pub struct SchemeRelativeURL {
    userinfo: Option<UserInfo>,
    host: Host,
    port: ~str,
    path: ~[~str],
}

pub struct UserInfo {
    username: ~str,
    password: Option<~str>,
}

pub enum Host {
    Domain(~[~str]),  // Can only be empty in the file scheme
    IPv6(IPv6Address)
}

pub struct IPv6Address {
    pieces: [u16, ..8]
}


pub type ParseResult<T> = Result<T, &'static str>;

impl URL {
    pub fn parse(input: &str, base_url: Option<&URL>) -> ParseResult<URL>
    pub fn serialize(&self) -> ~str
    pub fn serialize_no_fragment(&self) -> ~str
}

impl Host {
    pub fn parse(input: &str) -> ParseResult<Host>
    pub fn serialize(&self) -> ~str
}

impl IPv6Address {
    pub fn parse(input: &str) -> ParseResult<IPv6Address>
    pub fn serialize(&self) -> ~str
}


/// application/x-www-form-urlencoded
pub mod form_urlencoded {
    pub fn parse_str(input: &str) -> ~[(~str, ~str)]
    pub fn parse_bytes(input: &[u8], encoding_override: Option<encoding::EncodingRef>,
                       use_charset: bool, isindex: bool) -> Option<~[(~str, ~str)]>
    pub fn serialize(pairs: ~[(~str, ~str)],
                     encoding_override: Option<encoding::EncodingRef>) -> ~str
}
```


To do
-----

Not necessarily in the given order:

* Add proper documentation
* Add `data:` URL parsing.
* Port rust-http and Servo.
* Add [IDNA support](http://url.spec.whatwg.org/#idna).
  Non-ASCII domains are a parse error for now.
  [Punycode](http://tools.ietf.org/html/rfc3492) is done,
  [Nameprep](http://tools.ietf.org/html/rfc3491) is the other big part.
* Add lots of tests.
  Contribute them to [web-platform-tests](https://github.com/w3c/web-platform-tests/tree/master/url).
* Report know/suspected spec bugs and test suite bugs.
* Refactor to reduce code duplication.
* Consider switching the spec from a state machine to functional style, like this code.