+++ /dev/null
-NAME
- URI::Template - Object for handling URI templates
-
-SYNOPSIS
- use URI::Template;
- my $template = URI::Template->new( 'http://example.com/{x}' );
- my $uri = $template->process( x => 'y' );
- # uri is a URI object with value 'http://example.com/y'
-
- my %result = $template->deparse( $uri );
- # %result is ( x => 'y' )
-
-DESCRIPTION
- This is an initial attempt to provide a wrapper around URI templates as
- described at
- http://www.ietf.org/internet-drafts/draft-gregorio-uritemplate-01.txt
-
-INSTALLATION
- perl Makefile.PL
- make
- make test
- make install
-
-METHODS
- new( $template )
- Creates a new URI::Template instance with the template passed in as the
- first parameter.
-
- as_string( )
- Returns the original template string. Also used when the object is
- stringified.
-
- variables( )
- Returns an array of unique variable names found in the template. NB:
- they are returned in random order.
-
- all_variables( )
- Returns an array of variable names found as they appear in template --
- in order, duplicates included.
-
- process( %vars|\@values )
- Given a list of key-value pairs or an array ref of values (for
- positional substitution), it will URI escape the values and substitute
- them in to the template. Returns a URI object.
-
- process_to_string( %vars|\@values )
- Processes input like the "process" method, but doesn't inflate the
- result to a URI object.
-
- deparse( $uri )
- Does some rudimentary deparsing of a uri based on the current template.
- Returns a hash with the extracted values.
-
-AUTHOR
- Brian Cassidy <bricas@cpan.org>
-
-COPYRIGHT AND LICENSE
- Copyright 2007 by Brian Cassidy
-
- This library is free software; you can redistribute it and/or modify it
- under the same terms as Perl itself.
-