| 1 | package Net::Blossom; | ||
| 2 | |||
| 3 | 1 | ▶ | use strictures 2; |
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||
| 4 | |||
| 5 | 0 | ▶ | use Net::Blossom::Client; |
|
Subroutine
BEGIN: called CC=1 SCAR=2.6
| |||
| 6 | use Net::Blossom::ServerList; | ||
| 7 | use Net::Blossom::URI; | ||
| 8 | |||
| 9 | our $VERSION = '0.001001'; | ||
| 10 | |||
| 11 | sub client { | ||
| 12 | my $class = shift; | ||
| 13 | return Net::Blossom::Client->new(@_); | ||
| 14 | } | ||
| 15 | |||
| 16 | 1; | ||
| 17 | |||
| 18 | =pod | ||
| 19 | |||
| 20 | =head1 NAME | ||
| 21 | |||
| 22 | Net::Blossom - Perl client and protocol support for Blossom | ||
| 23 | |||
| 24 | =head1 SYNOPSIS | ||
| 25 | |||
| 26 | use Net::Blossom; | ||
| 27 | |||
| 28 | my $client = Net::Blossom->client( | ||
| 29 | server => 'https://cdn.example.com', | ||
| 30 | ); | ||
| 31 | |||
| 32 | my $response = $client->get_blob($sha256); | ||
| 33 | |||
| 34 | =head1 DESCRIPTION | ||
| 35 | |||
| 36 | C<Net::Blossom> is the main entry point for the Perl implementation of the | ||
| 37 | Blossom protocol. The distribution provides value objects for Blossom protocol | ||
| 38 | data, BUD-11 authorization token creation, Blossom URI handling, server-list | ||
| 39 | handling, and an HTTP client. Server-side support is provided separately by | ||
| 40 | L<Net::Blossom::Server>. | ||
| 41 | |||
| 42 | This module intentionally keeps a small surface. Most callers should use | ||
| 43 | C<client> or construct C<Net::Blossom::Client> directly. | ||
| 44 | |||
| 45 | =head1 METHODS | ||
| 46 | |||
| 47 | =head2 client | ||
| 48 | |||
| 49 | my $client = Net::Blossom->client(%args); | ||
| 50 | |||
| 51 | Constructs and returns a C<Net::Blossom::Client>. Arguments are passed directly | ||
| 52 | to C<Net::Blossom::Client-E<gt>new>. | ||
| 53 | |||
| 54 | =head1 SEE ALSO | ||
| 55 | |||
| 56 | L<Net::Blossom::Client>, L<Net::Blossom::AuthToken>, | ||
| 57 | L<Net::Blossom::BlobDescriptor>, L<Net::Blossom::ServerList>, | ||
| 58 | L<Net::Blossom::URI>, L<Net::Blossom::Server> | ||
| 59 | |||
| 60 | =cut | ||