Metadata-Version: 2.1
Name: pwnedapi
Version: 0.5.0
Summary: Library for easily interfacing with Have I Been Pwned API v2.
Home-page: https://github.com/nikoheikkila/pwnedapi
Author: Niko Heikkilä
Author-email: yo@nikoheikkila.fi
License: MIT
Description: 
        # `pwnedapi` (Have I Been Pwned)
        
        [![Build Status](https://travis-ci.org/nikoheikkila/pwnedapi.svg?branch=master)](https://travis-ci.org/nikoheikkila/pwnedapi)
        [![codecov](https://codecov.io/gh/nikoheikkila/pwnedapi/branch/master/graph/badge.svg)](https://codecov.io/gh/nikoheikkila/pwnedapi)
        
        A small utility class to leverage Troy Hunt's [_Have I Been Pwned API v2_][hibp] and the _k-Anonymity_ model. Inspired by Phil Nash's Ruby gem [_pwned_][pwned].
        
        ## Installation
        
        ```bash
        # From repository
        pipenv install pwnedapi
        
        # Locally after cloning
        python setup.py install
        ```
        
        ## Usage
        
        In its simplest form you'll only need to use two methods. Will probably add more if and when the API grows.
        
        ```python
        >>> from pwnedapi import Password
        >>> password = Password("mysupersecretpassword")
        >>>
        >>> if password.is_pwned():
        ...     print(f"Your password has been pwned {password.pwned_count} times.")
        ...
        Your password has been pwned 2 times.
        >>>
        ```
        
        You can also scan a file of passwords, and export results in any format supported by the [`tablib`][tablib] library.
        
        ```python
        >>> from pwnedapi import Scanner
        >>> scanner = Scanner()
        >>> scanner.scan("passwords.txt")
        >>> scanner.export_as("leaked.json")
        >>> open("leaked.json").read()
        '[{"Password": "dog", "Leak Count": 28348}, {"Password": "cat", "Leak Count": 26354}, {"Password": "somepass", "Leak Count": 657}]'
        ```
        
        ## Contributing
        
        Check the source code and issues from this repository, and should anything interesting pop out feel free to open a pull request. Before your changes will be merged make sure that Travis CI pipeline is green and code coverage is on acceptable level. GitHub takes care of these eventually but to save time always consider running the tests locally before pushing.
        
        [hibp]: https://haveibeenpwned.com/API/v2#SearchingPwnedPasswordsByRange
        [pwned]: https://philnash.github.io/pwned/
        [tablib]: http://docs.python-tablib.org/en/latest/
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.5.0
Description-Content-Type: text/markdown
