NAME

URI::Based - Define a base URI and then generate variations on it

VERSION

Version 1.03

SYNOPSIS

  use URI::Based;
  my $uri = URI::Based->new( 'http://angel.net/~nic' );
  say $uri->with( '/path/to/add', param1 => 'some value' );
  say $uri->with( '/a/different/path', param2 => 'other value', param3 => 'yet another' );

  # prints:
  # http://angel.net/~nic/path/to/add?param1=some+value
  # http://angel.net/~nic/a/different/path?param2=other+value&param3=yet+another

METHODS

This class inherits all the methods of URI::WithBase and URI, and adds

new()

Automatically sets the base and the the URI to the same initial value

with()

Sets the URI to the base plus the path and query given, and returns the URI. The first argument is the path, the rest are parameter => value pairs, given in any format acceptable to URI::query_form().

SEE ALSO

URI::WithBase

AUTHOR

Nic Wolff, <nic@angel.net>

BUGS

Please report any bugs or feature requests through the web interface at https://github.com/nicwolff/URI-Based/issues. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc URI::Based

You can also look for information at:

• This module on GitHub

  https://github.com/nicwolff/URI-Based

• GitHub request tracker (report bugs here)

  https://github.com/nicwolff/URI-Based/issues

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/URI-Based

• Search CPAN

  http://search.cpan.org/dist/URI-Based/

LICENSE AND COPYRIGHT

Copyright 2012 Nic Wolff.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.