add Url::parse_with_params()

[kybishop]

Allows us to build a Url from user-supplied params without the boilerplate of constructing then modifying the Url.

This is in hopes of improving the ergenomics of the reqwest library: seanmonstar/reqwest#45 (comment)

---

This change is 

[SimonSapin]

Looks good! Just a few small things: please add assert_eq!(url.as_str(), …) to the doc-test, remove .iter() in the doc-test and add & to pass a borrowed array (to demonstrate IntoIterator vs Iterator), and if you want this on crates.io increment the version number in Cargo.toml to 1.3.0.

[emilio]

Does it need to be 1.3.0? It's not a breaking change, only adds an API.

[SimonSapin]

Yes, exactly. A breaking change would be 2.0.0.

[kybishop]

Hurray for semver 😃

@SimonSapin changes made and commits squashed!

[KiChjang]

I think @emilio means whether it can be 1.2.6 instead.

[kybishop]

@KiChjang @emilio. Hey all. Apologies if rust-url isn't following true semver, but if it is: "MINOR version when you add functionality in a backwards-compatible manner" - semver.org. Patch version is typically reserved for bug fixes.

Happy to match the version to whatever you guys would like

[SimonSapin]

Yeah, 1.2.6 vs 1.3.0 is the same as far as Cargo is concerned. IMO we’d be just fine with just two components in the version number. But since semver is the convention in the rust ecosystem let’s do that.

I was thinking of assert_eq! in the doc-test itself to show an example of what the resulting URL looks like, but let’s call this good enough.

@bors-servo r+

[bors-servo]

📌 Commit 092934c has been approved by SimonSapin

[bors-servo]

⚡ Test exempted - status