NAME
Test::URI - Check Uniform Resource Identifiers
SYNOPSIS
use
Test::URI;
uri_scheme_ok(
$uri
,
'http'
);
uri_host_ok(
$uri
,
'www.example.com'
);
uri_port_ok(
$uri
,
'8080'
);
uri_path_ok(
$uri
,
'/index.html'
);
uri_fragment_ok(
$uri
,
'name'
);
DESCRIPTION
Check various parts of Uniform Resource Locators
FUNCTIONS
- uri_scheme_ok( STRING|URI, SCHEME )
-
Ok is the STRING is a valid URI, in any format that URI accepts, and the URI uses the same SCHEME (i.e. protocol: http, ftp, ...). SCHEME is not case sensitive.
STRING can be an URI object.
- uri_host_ok( STRING|URI, HOST )
-
Ok is the STRING is a valid URI, in any format that URI accepts, and the URI uses the same HOST. HOST is not case sensitive.
Not Ok is the URI scheme does not have a host portion.
STRING can be an URI object.
- uri_port_ok( STRING|URI, PORT )
-
Ok is the STRING is a valid URI, in any format that URI accepts, and the URI uses the same PORT.
Not Ok is the URI scheme does not have a port portion.
STRING can be an URI object.
- uri_canonical_ok
-
UNIMPLEMENTED. I'm not sure why I thought this should be a test. If anyone else knows, I'll implement it.
- uri_path_ok( STRING|URI, PATH )
-
Ok is the STRING is a valid URI, in any format that URI accepts, and the URI has the path PATH. Remember that paths start with a /, even if it doesn't look like there is anything after the host parts.
STRING can be an URI object.
- uri_fragment_ok( STRING|URI, FRAGMENT )
-
Ok is the STRING is a valid URI, in any format that URI accepts, and the URI has the fragment FRAGMENT.
STRING can be an URI object.
TO DO
add methods: uri_canonical_ok, uri_query_string_ok
add convenience methods such as uri_is_web, uri_is_ftp
SOURCE AVAILABILITY
This source is in GitHub
AUTHOR
brian d foy, <briandfoy@pobox.com>
COPYRIGHT AND LICENSE
Copyright © 2004-2025, brian d foy <briandfoy@pobox.com>. All rights reserved.
This program is free software; you can redistribute it and/or modify it under the terms of the Artistic License 2.0.