urld 0.5.1

A URL parsing library


To use this package, run the following command in your project's root directory:

Manual usage
Put the following dependency into your project's dependences section:

urld

URL handling for D

Motivation

D's standard library has nothing for working with URLs.

Vibe.d can work with URLs. However, Vibe is big. Also, we want to work easily with query strings, which vibe.d doesn't allow.

Status

There are some convenience accessors to add.

No backwards-incompatible changes are planned.

Installation

Add "urld": "~>0.5.0" to your dub.json.

Usage

Parse a URL:

auto url = "ircs://irc.freenode.com/#d".parseURL;

Construct one from scratch, laboriously:

URL url;
with (url) {
	scheme = "soap.beep";
	host = "beep.example.net";
	port = 1772;
	path = "/serverinfo/info";
	query["token"] = "my-api-token";
}
curl.get(url);

Unicode domain names:

auto url = "http://☃.com/".parseURL;
writeln(url.toString);               // http://xn--n3h.com/
writeln(url.toHumanReadableString);  // http://☃.com/

Implicit conversion to strings for use with other libraries that expect URLs as strings:

import std.net.curl;
auto couchdbURL = "http://couch.local:8815".parseURL;
writeln(get(couchdbURL ~ "users/[email protected]"));

Autodetect ports:

assert(parseURL("http://example.org").port == 80);
assert(parseURL("http://example.org:5326").port == 5326);

URLs of maximum complexity:

auto url = parseURL("redis://admin:[email protected]:2201/path?query=value#fragment");
assert(url.scheme == "redis");
assert(url.user == "admin");
assert(url.pass == "password");
// etc

URLs of minimum complexity:

assert(parseURL("example.org").toString == "http://example.org/");

Canonicalization:

assert(parseURL("http://example.org:80").toString == "http://example.org/");
Authors:
  • dhasenan
Dependencies:
none
Versions:
2.1.1 2018-Jul-22
2.1.0 2017-Jan-14
2.0.2 2017-Jan-12
2.0.1 2017-Jan-10
2.0.0 2017-Jan-08
Show all 22 versions
Download Stats:
  • 41 downloads today

  • 262 downloads this week

  • 1122 downloads this month

  • 281019 downloads total

Score:
3.9
Short URL:
urld.dub.pm