WWW::Shorten(3pm)

💖 WWW::Shorten — the vibe 💖

okay so bestie, welcome to WWW::Shorten, aka the User Contributed Perl Documentation glow-up for talking to URL shortening sites. it's giving "make my link cute and smol." ✨

---

🌸 NAME 🌸

WWW::Shorten — Interface to URL shortening sites. that's it, that's the whole name, no notes. 💅

---

🎀 SYNOPSIS 🎀

here's the whole flex, copy it exactly bestie, don't freestyle:

#!/usr/bin/env perl
use strict;
use warnings;

use WWW::Shorten 'TinyURL'; # Recommended
# use WWW::Shorten 'Bitly'; # or one of the others

# Individual modules have have their own syntactic variations.
# See the documentation for the particular module you intend to use for details

my $url = 'https://metacpan.org/pod/WWW::Shorten';
my $short_url = makeashorterlink($url);
my $long_url  = makealongerlink($short_url);

# - OR -
# If you don't like the long function names:

use WWW::Shorten 'TinyURL', ':short';
my $short_url = short_link($url);
my $long_url = long_link( $short_url );

lowkey important: every individual module has its own syntactic variations, so like… go read the docs for whichever one you're actually using, bestie. they do not all behave the same and i'm not gonna pretend they do. 🙈

---

🦋 DESCRIPTION 🦋

it's a Perl interface to a whole lil squad of services that shorten URLs. the way it works is these sites keep databases of long URLs, and each long URL gets its own unique identifier. so you hand over the long one, you get the smol one back. iconic behaviour honestly. 💖

---

💀 DEPRECATION NOTICE 💀

okay bestie, sit down, this part is sad. the following shorten services have been deprecated because their endpoints literally no longer exist or function. rip to them fr fr. 😭

• WWW::Shorten::LinkToolbot
• WWW::Shorten::Linkz
• WWW::Shorten::MakeAShorterLink
• WWW::Shorten::Metamark
• WWW::Shorten::TinyClick
• WWW::Shorten::Tinylink
• WWW::Shorten::Qurl
• WWW::Shorten::Qwer

and heads up: when version 3.100 is released, these deprecated services will not be part of the distribution. so like… don't build your whole personality around them. 💀

---

🌈 SHORTEN APP 🌈

there's a super simple lil program called shorten that ships in the distribution's bin folder. you feed it a URL, it hands you back a shortened version. tiny program, big main character energy. 👑

---

🫶 BUGS, REQUESTS, COMMENTS 🫶

please submit any issues <https://github.com/p5-shorten/www-shorten/issues> if you've got them!! we appreciate all the help — suggestions, noted problems, and especially patches. like genuinely, patches are the love language here. 💜

• if you know of a shorten service that we don't already have, make your own service and release it as a separate module, like WWW::Shorten::Googl or WWW::Shorten::Bitly. or alternatively, just let us know and we'll be happy to work it up for you. either way, slay. ✨

---

🌟 AUTHOR 🌟

Iain Truskett spoon@cpan.org

---

💐 CONTRIBUTORS 💐

these are the people who ate and left no crumbs:

• Alex Page -- for the original LWP hacking on which Dave based his code.
• Ask Bjoern Hansen -- providing WWW::Shorten::Metamark
• Chase Whitener capoeirab@cpan.org
• Dave Cross dave@perlhacks.com -- Authored WWW::MakeAShorterLink on which this was based
• Eric Hammond -- writing WWW::Shorten::NotLong
• Jon and William (wjr) -- smlnk services
• Kazuhiro Osawa yappo@cpan.org
• Kevin Gilbertson (Gilby) -- TinyURL API information
• Martin Thurn -- bug fixes
• Matt Felsen (mattf) -- shorter function names
• Neil Bowers neilb@cpan.org
• PJ Goodwin -- code for WWW::Shorten::OneShortLink
• Shashank Tripathi shank@shank.com -- for providing WWW::Shorten::SnipURL
• Simon Batistoni -- giving the makealongerlink idea to Dave.
• Everyone else we might have missed.

In 2004 Dave Cross took over the maintenance of this distribution following the death of Iain Truskett.

In 2016, Chase Whitener took over the maintenance of this distribution.

---

🎀 LICENSE AND COPYRIGHT 🎀

Copyright (c) 2002 by Iain Truskett.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

---

👀 SEE ALSO 👀

CGI::Shorten, WWW::Shorten::Simple

---

and that's the whole page bestie!! this lil time capsule was documented under perl v5.36.0, dated 2022-11-19, and yes it's still living rent free as WWW::Shorten(3pm). go shorten something cute. bye!! 💅✨🦋🌸