App::Nopaste - Easy access to any pastebin

Author

       Shawn M Moore, <sartak@gmail.com>

Contributors

       •   Shawn M Moore <code@sartak.org>

       •   Karen Etheridge <ether@cpan.org>

       •   Thomas Sibley <tsibley@cpan.org>

       •   Ricardo Signes <rjbs@cpan.org>

       •   François Gannaz <francois.gannaz@silecs.info>

       •   Justin Hunter <justin.d.hunter@gmail.com>

       •   Kevin Falcone <kevin@jibsheet.com>

       •   Zoffix Znet <cpan@zoffix.com>

       •   Jesse Luehrs <doy@tozt.net>

       •   Dean Hamstead <dean@fragfest.com.au>

       •   David Golden <dagolden@cpan.org>

       •   Rafael Kitover <rkitover@cpan.org>

       •   Sergey Romanov <complefor@rambler.ru>

       •   Zakariyya Mughal <zaki.mughal@gmail.com>

       •   gregor herrmann <gregoa@debian.org>

       •   vti <viacheslav.t@gmail.com>

       •   Ævar Arnfjörð Bjarmason <avarab@gmail.com>

       •   Сергей Романов <sromanov@cpan.org>

       •   Andrew Rodland <andrew@cleverdomain.org>

       •   יובל קוג'מן (Yuval Kogman) <nothingmuch@woobling.org>

       •   Arthur Axel 'fREW' Schmidt <frioux@gmail.com>

       •   Dan Book <grinnz@gmail.com>

       •   Darian Anthony Patrick <dap@darianpatrick.com>

       •   David Bremner <bremner@unb.ca>

       •   David J. Shultz <djshultz@gmail.com>

       •   Graham Knop <haarg@haarg.org>

       •   Jason Mills <jmmills@cpan.org>

       •   John Goulah <jgoulah@gmail.com>

       •   Maximilian Gass <mxey@ghosthacking.net>

       •   Sebastian Paaske Tørholm <Eckankar+github@gmail.com>

       •   Shlomi Fish <shlomif@shlomifish.org>

       •   Tatsuhiko Miyagawa <miyagawa@bulknews.net>

Copyright And License

       This software is copyright (c) 2008 by Shawn M Moore.

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

perl v5.36.0                                       2022-08-28                                  App::Nopaste(3pm)

Description

       Pastebins (also known as nopaste sites) let you post text, usually code, for public viewing. They're used
       a lot in IRC channels to show code that would normally be too long to give directly in the channel (hence
       the name nopaste).

       Each pastebin is slightly different. When one pastebin goes down (I'm looking at you,
       <http://paste.husk.org>), then you have to find a new one. And if you usually use a script to publish
       text, then it's too much hassle.

       This module aims to smooth out the differences between pastebins, and provides redundancy: if one site
       doesn't work, it just tries a different one.

       It's also modular: you only need to put on CPAN a App::Nopaste::Service::Foo module and anyone can begin
       using it.

Interface

CLI
       See the documentation in App::Nopaste::Command.

   "nopaste"
           use App::Nopaste 'nopaste';

           my $url = nopaste(
               text => "Full text to paste (the only mandatory argument)",
               desc => "A short description of the paste",
               nick => "Your nickname",
               lang => "perl",
               chan => "#moose",
               private => 1, # default: 0

               # this is the default, but maybe you want to do something different
               error_handler => sub {
                   my ($error, $service) = @_;
                   warn "$service: $error";
               },

               warn_handler => sub {
                   my ($warning, $service) = @_;
                   warn "$service: $warning";
               },

               # you may specify the services to use - but you don't have to
               services => ["Shadowcat", "Gist"],
           );

           print $url if $url;

       The "nopaste" function will return the URL of the paste on success, or "undef" on failure.

       For each failure, the "error_handler" argument is invoked with the error message and the service that
       issued it.

       For each warning, the "warn_handler" argument is invoked with the warning message and the service that
       issued it.

Name

       App::Nopaste - Easy access to any pastebin

Support

       Bugs may be submitted through the RT bug tracker <https://rt.cpan.org/Public/Dist/Display.html?Name=App-
       Nopaste> (or bug-App-Nopaste@rt.cpan.org <mailto:bug-App-Nopaste@rt.cpan.org>).

Synopsis

           use App::Nopaste 'nopaste';

           my $url = nopaste(q{
               perl -wle 'print "Prime" if (1 x shift) !~ /^1?$|^(11+?)\1+$/' [number]
           });

           # or on the command line:
           nopaste test.pl
           => http://pastebin.com/fcba51f