NAME

WebService::HIBP::Paste - An instance of a paste from the Have I Been Pwned webservice at haveibeenpwned.com

VERSION

Version 0.06

SYNOPSIS

Check the security of your accounts/email addresses and passwords

    use WebService::HIBP();
    use v5.10;

    my $hibp = WebService::HIBP->new();
    foreach my $paste ($hibp->pastes()) {
       say $paste->source();
    }

DESCRIPTION

Each paste contains a number of attributes describing it. In the future, these attributes may expand without the API being versioned.

SUBROUTINES/METHODS

new

A creation method that should only be called by WebService::HIBP.

source

The paste service the record was retrieved from. Current values are: Pastebin, Pastie, Slexy, Ghostbin, QuickLeak, JustPaste, AdHocUrl, OptOut

id

The ID of the paste as it was given at the source service. Combined with the "Source" attribute, this can be used to resolve the URL of the paste.

title

The title of the paste as observed on the source site. This may be null and if so will be omitted from the response.

date

The date and time (precision to the second) that the paste was posted. This is taken directly from the paste site when this information is available but may be null if no date is published.

email_count

The number of emails that were found when processing the paste. Emails are extracted by using the regular expression \b+(?!^.{256})[a-zA-Z0-9\.\-_\+]+@[a-zA-Z0-9\.\-_]+\.[a-zA-Z]+\b

DIAGNOSTICS

None.

CONFIGURATION AND ENVIRONMENT

WebService::HIBP::Paste requires no configuration files or environment variables.

DEPENDENCIES

WebService::HIBP::Paste requires no non-core modules

INCOMPATIBILITIES

None reported

BUGS AND LIMITATIONS

Please report any bugs or feature requests to bug-webservice-hibp at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WebService-HIBP. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

AUTHOR

David Dick, <ddick at cpan.org>

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc WebService::HIBP::Paste

You can also look for information at:

• RT: CPAN's request tracker (report bugs here)

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=WebService-HIBP

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/WebService-HIBP

• CPAN Ratings

  http://cpanratings.perl.org/d/WebService-HIBP

• Search CPAN

  http://search.cpan.org/dist/WebService-HIBP/

ACKNOWLEDGEMENTS

Thanks to Troy Hunt for providing the service at https://haveibeenpwned.com

POD was extracted from the API help at https://haveibeenpwned.com/API/v2

LICENSE AND COPYRIGHT

Copyright 2018 David Dick.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

cpanm WebService::HIBP

perl -MCPAN -e shell
install WebService::HIBP