X-Git-Url: http://erislabs.net/gitweb/?p=liburi-template-perl.git;a=blobdiff_plain;f=README;h=6de3191e449f035e4c2ce2036140713735b968d0;hp=b07c19f8f74521c0fac69f3f546414bb3b5a5732;hb=409df7817b5227c763dd2fab0d583b6d1a9656e4;hpb=90a266f52eaecdd5e15d16fe4fa3b98cb184c67c diff --git a/README b/README index b07c19f..6de3191 100644 --- a/README +++ b/README @@ -1,5 +1,5 @@ NAME - URI::Template - Object for handling URI templates + URI::Template - Object for handling URI templates (RFC 6570) SYNOPSIS use URI::Template; @@ -7,64 +7,49 @@ SYNOPSIS 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 + This module provides a wrapper around URI templates as described in RFC + 6570: http://tools.ietf.org/html/rfc6570 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 ) 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. + template + This method returns the original template string. - variables( ) - Returns an array of variable names found in the template. NB: they are - returned in random order. + 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. + expansions + This method returns an list of expansions found in the template. + Currently, these are just coderefs. In the future, they will be more + interesting. - process( %vars|\@values ) + process( \%vars ) 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 ) + process_to_string( \%vars ) 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. +AUTHORS + * Brian Cassidy -AUTHOR - * Brian Cassidy + * Ricardo SIGNES COPYRIGHT AND LICENSE - Copyright 2007 by Brian Cassidy + Copyright 2007-2012 by Brian Cassidy This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.