Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

CPAN Release 0.07

  • Loading branch information...
commit ac4810d233d278c7401df954b0b731d20331e3f5 1 parent 7f77191
@mithun authored
Showing with 32 additions and 2 deletions.
  1. +8 −0 Changes
  2. +3 −0  INSTALL
  3. +19 −0 README
  4. +2 −2 readme.mkdn
View
8 Changes
@@ -3,39 +3,47 @@ Mithun Ayachit
0.07
+====
- Fix issue where '%' was not being encoded unless encode_reserved was
requested [RT #78314]
- Introduce option to NOT encode an already encoded string/URL
0.061
+=====
- POD updates
- Added a benchmark script
0.06
+====
- Fixed synopsis
0.05
+====
- Store character maps in object
- Update repo format
0.04
+====
- Allow strings to be '0' (literally). See RT #70628
- Added option in constructor to set reserved encoding
0.03
+====
- Minimum perl 5.8.1
0.02
+====
- Corrected POD
0.01
+====
- Initial release
View
3  INSTALL
@@ -3,17 +3,20 @@ Mithun Ayachit
Distribution page
+=================
The latest and all previous releases for URI-Encode can be downloaded
from https://metacpan.org/release/URI-Encode
Install using cpanm
+===================
URI-Encode can be installed with cpanm using the following command
cpanm .
Install using Module::Build
+===========================
URI-Encode can be installed with Module::Build using the following
commands
View
19 README
@@ -1,8 +1,10 @@
NAME
+====
URI::Encode - Simple percent Encoding/Decoding
SYNOPSIS
+========
# OOP Interface
use URI::Encode;
@@ -16,6 +18,7 @@ SYNOPSIS
my $decoded = uri_decode($encoded);
DESCRIPTION
+===========
This modules provides simple URI (Percent) encoding/decoding
@@ -34,8 +37,10 @@ URI::Escape::XS
See this script for a comparison on encoding results and performance.
METHODS
+=======
new()
+-----
Creates a new object, no arguments are required
@@ -60,6 +65,7 @@ again. Defaults to true.
print $encoder->encode('http://perl.com/foo%20bar'); # prints http://perl.com/foo%20bar
encode($url, $including\_reserved)
+----------------------------------
This method encodes the URL provided. The method does not encode any
"Reserved Characters" unless $including_reserved is true or set in the
@@ -70,6 +76,7 @@ percent encoding.
$uri->encode("http://perl.com/foo bar", 1); # http%3A%2F%2Fperl.com%2Ffoo%20bar
decode($url)
+------------
This method decodes a 'percent' encoded URL. If you had encoded the URL
using this module (or any other method), chances are that the URL was
@@ -79,17 +86,22 @@ format and convert back if required.
$uri->decode("http%3A%2F%2Fperl.com%2Ffoo%20bar"); # "http://perl.com/foo bar"
EXPORTED FUNCTIONS
+==================
The following functions are exported upon request. This provides a
non-OOP interface
uri\_encode($url, \\%options)
+-----------------------------
uri\_decode($url)
+-----------------
CHARACTER CLASSES
+=================
Reserved Characters
+-------------------
The following characters are considered as reserved (RFC 3986). They
will be encoded only if requested.
@@ -97,6 +109,7 @@ will be encoded only if requested.
! * ' ( ) ; : @ & = + $ , / ? # [ ]
Unreserved Characters
+---------------------
The following characters are considered as Unreserved. They will not be
encoded
@@ -107,16 +120,19 @@ encoded
- _ . ~
DEPENDENCIES
+============
Encode
ACKNOWLEDGEMENTS
+================
Gisle Aas for URI::Escape
David Nicol for Tie::UrlEncoder
SEE ALSO
+========
RFC 3986
@@ -129,16 +145,19 @@ URI::Escape::JavaScript
Tie::UrlEncoder
BUGS AND LIMITATIONS
+====================
Please report any bugs or feature requests to
bug-uri-encode@rt.cpan.org, or through the web interface at
http://rt.cpan.org/Public/Dist/Display.html?Name=URI-Encode
AUTHOR
+======
Mithun Ayachit mithun@cpan.org
LICENSE AND COPYRIGHT
+=====================
Copyright (c) 2012, Mithun Ayachit. All rights reserved.
View
4 readme.mkdn
@@ -46,14 +46,14 @@ Creates a new object, no arguments are required
The following options can be passed to the constructor
-- `encode_reserved`
+- encode\_reserved
my \$encoder = URI::Encode-\>new({encode\_reserved =\> 0});
If true, ["Reserved Characters"](#Reserved%20Characters) are also
encoded. Defaults to false.
-- `double_encode`
+- double\_encode
my \$encoder = URI::Encode-\>new({double\_encode =\> 1});
Please sign in to comment.
Something went wrong with that request. Please try again.