Debian Codegraph @

README

raw
1 NAME
2 WWW::Shorten - Interface to URL shortening sites.
3
4 SYNOPSIS
5 #!/usr/bin/env perl
6 use strict;
7 use warnings;
8
9 use WWW::Shorten 'TinyURL'; # Recommended
10 # use WWW::Shorten 'Bitly'; # or one of the others
11
12 # Individual modules have have their own syntactic variations.
13 # See the documentation for the particular module you intend to use for details
14
15 my $url = 'https://metacpan.org/pod/WWW::Shorten';
16 my $short_url = makeashorterlink($url);
17 my $long_url = makealongerlink($short_url);
18
19 # - OR -
20 # If you don't like the long function names:
21
22 use WWW::Shorten 'TinyURL', ':short';
23 my $short_url = short_link($url);
24 my $long_url = long_link( $short_url );
25
26 DESCRIPTION
27 A Perl interface to various services that shorten URLs. These sites
28 maintain databases of long URLs, each of which has a unique identifier.
29
30 DEPRECATION NOTICE
31 The following shorten services have been deprecated as the endpoints no
32 longer exist or function:
33
34 * WWW::Shorten::LinkToolbot
35
36 * WWW::Shorten::Linkz
37
38 * WWW::Shorten::MakeAShorterLink
39
40 * WWW::Shorten::Metamark
41
42 * WWW::Shorten::TinyClick
43
44 * WWW::Shorten::Tinylink
45
46 * WWW::Shorten::Qurl
47
48 * WWW::Shorten::Qwer
49
50 When version 3.100 is released, these deprecated services will not be
51 part of the distribution.
52
53 SHORTEN APP
54 A very simple program called shorten is supplied in the distribution's
55 bin folder. This program takes a URL and gives you a shortened version
56 of it.
57
58 BUGS, REQUESTS, COMMENTS
59 Please submit any issues
60 <https://github.com/p5-shorten/www-shorten/issues> you might have. We
61 appreciate all help, suggestions, noted problems, and especially
62 patches.
63
64 * If you know of a shorten service that we don't already have, make your
65 own service and release it as a separate module, like
66 WWW::Shorten::Googl or WWW::Shorten::Bitly. Alternatively, you can let
67 us know and we'll be happy to work it up for you.
68
69 AUTHOR
70 Iain Truskett "[email protected]"
71
72 CONTRIBUTORS
73 * Alex Page -- for the original LWP hacking on which Dave based his
74 code.
75
76 * Ask Bjoern Hansen -- providing WWW::Shorten::Metamark
77
78 * Chase Whitener "[email protected]"
79
80 * Dave Cross [email protected] -- Authored WWW::MakeAShorterLink on
81 which this was based
82
83 * Eric Hammond -- writing WWW::Shorten::NotLong
84
85 * Jon and William (wjr) -- smlnk services
86
87 * Kazuhiro Osawa "[email protected]"
88
89 * Kevin Gilbertson (Gilby) -- TinyURL API information
90
91 * Martin Thurn -- bug fixes
92
93 * Matt Felsen (mattf) -- shorter function names
94
95 * Neil Bowers "[email protected]"
96
97 * PJ Goodwin -- code for WWW::Shorten::OneShortLink
98
99 * Shashank Tripathi "[email protected]" -- for providing
100 WWW::Shorten::SnipURL
101
102 * Simon Batistoni -- giving the `makealongerlink` idea to Dave.
103
104 * Everyone else we might have missed.
105
106 In 2004 Dave Cross took over the maintenance of this distribution
107 following the death of Iain Truskett.
108
109 In 2016, Chase Whitener took over the maintenance of this distribution.
110
111 LICENSE AND COPYRIGHT
112 Copyright (c) 2002 by Iain Truskett.
113
114 This library is free software; you can redistribute it and/or modify it
115 under the same terms as Perl itself.
116
117 SEE ALSO
118 CGI::Shorten, WWW::Shorten::Simple
119