X-Git-Url: http://erislabs.net/gitweb/?p=liburi-template-perl.git;a=blobdiff_plain;f=README;h=fd4982a302771176105acde964b85549c3114aa4;hp=eb4da93e24feb49ef3a407cc13891d73b8e83f06;hb=0bf9e38bd59ec2d30d98cdd5b1ff6659bc776761;hpb=7c69490596e221b9d4be4d94de939429258ff7b3 diff --git a/README b/README index eb4da93..fd4982a 100644 --- a/README +++ b/README @@ -13,22 +13,13 @@ SYNOPSIS 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-00.txt + http://www.ietf.org/internet-drafts/draft-gregorio-uritemplate-01.txt INSTALLATION - To install this module via Module::Build: - - perl Build.PL - ./Build # or `perl Build` - ./Build test # or `perl Build test` - ./Build install # or `perl Build install` - - To install this module via ExtUtils::MakeMaker: - - perl Makefile.PL - make - make test - make install + perl Makefile.PL + make + make test + make install METHODS new( $template ) @@ -40,23 +31,28 @@ METHODS stringified. variables( ) - Returns an array of variable names found in the template. NB: they are - returned in random order. + 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 ) - Given a list of key-value pairs, it will URI escape the values and - substitute them in to the template. Returns a URI object. + 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 ) - Processes key-values pairs like the "process" method, but doesn't - inflate the result to 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 + Brian Cassidy COPYRIGHT AND LICENSE Copyright 2007 by Brian Cassidy