Skip to main content

Check whether your password has been pwnd

Project description

Has my password been compromised? And how often?

Latest release

little-pwny queries the have-i-been-pwned password database for breaches that contain a given passphrase and returns the number of breaches found. It does not reveal the plain passphrase to the HIBP server (nor to anyone/anything else, see below).

little-pwny works with plain Python 3.x and requires no additional packages.

Usage

$ pwny p@ssw0rd
51763

$ pwny aiPh1eehec8AhY2y
0

Use:

$ pwny --help

to learn more about all options supported.

Please note, that the Python package is called little-pwny while the executable script is called pwny.

At no time the raw password is transferred to https://haveibeenpwned.com (or elsewhere). Instead we use the generously offered haveibeenpwned.com-API to deploy k-anonymity. I.e. we send the first five chars of the SHA1 hash of any given password. This way you can check new passwords without revealing them to the server (or any other party).

Install

You need at least some Python3 interpreter installed on your System.

with pip

Simply:

$ pip3 install --user little-pwny

Leave out –user if you are root and want to install little-pwny system-wide.

If pip is not installed on your system, chances are, your Python3 comes with pip included:

$ python3 -m pip install --user little-pwny

(again you can leave –user out in case you are root).

If that fails as well, you might use your systems package manager to install pip3. On Ubuntu for instance this will do:

$ sudo apt install python3-pip
$ sudo pip3 install little-pwny

From Source

Clone the source:

$ git clone https://codeberg.org/ulif/little-pwny
$ cd little-pwny

Create and activate a virtualenv:

$ virtualenv venv
$ source ./venv/bin/activate.sh

Then, from this directory, install the package:

[venv] $ pip install -e .

Running Tests

We use tox and py.test for testing. So,:

$ pip install tox
$ tox

should run all tests.

Changes

0.3 (2022-02-25)

0.2 (2019-12-12)

  • Officially also support Python 3.5 and 3.7

  • Add support for commandline option –version.

  • Add support for commandline option –help.

0.1 (2019-10-31)

  • Initial release.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

little-pwny-0.3.tar.gz (41.9 kB view hashes)

Uploaded Source

Built Distribution

little_pwny-0.3-py2.py3-none-any.whl (16.6 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page