Asyncio and aiohttp based library and CLI to connect to haveibeenpwned.
Project description
haveibeenpwned-asyncio
v0.0.1
Library to query and check haveibeenpwned with the aiohttp library.
NB: I have added async to sync methods if you are not writing async code. Every query function has an corresponding synchronous call -> example query_account_sync()
Install
pip install haveibeenpwned-asyncio
# or
poetry add haveibeenpwned-asyncio
Usage
See example.py for more uses
Ex:
import os
from haveibeenpwned_asyncio import haveIbeenPwnedPasswords, haveIbeenPwnedAccount
import asyncio
if __name__ == "__main__":
# Validation Class, inherits from Indentity Class
loop = asyncio.get_event_loop()
passwords = ['test@1234', 'test$1234']
accounts = ['admin@gmail.com', 'test@test.com']
print(
loop.run_until_complete(haveIbeenPwnedPasswords(
passwords=passwords, semaphore_max=10
).query_passwords()
)
)
test_acc = haveIbeenPwnedAccount(
accounts=accounts,
semaphore_max=10,
api_key=os.getenv("HAVEIBEENPWNED_API_KEY", None)
)
print(loop.run_until_complete(test_acc.query_accounts()))
print(test_acc.query_accounts_sync())
API Key
Some of the endpoints (breachedAccount) require authentication in the v3 of the API. This is to prevent script kiddies and abuse of the api, see blog post: https://www.troyhunt.com/authentication-and-the-have-i-been-pwned-api/
To get an API key follow: https://haveibeenpwned.com/API/Key
Usage:
# Could use env variables
haveIbeenPwnedAccount(
accounts=accounts,
semaphore_max=10,
api_key=os.getenv("HAVEIBEENPWNED_API_KEY", None))
# or
haveIbeenPwnedAccount(
accounts=accounts,
semaphore_max=10,
api_key='xxxxxxxxx')
TODO:
- Add API key to github actions for pytest to pass on breachedAccount
Donations
Please feel free to buy me a cup of coffee as I pay a monthly $3 to test the library against haveibeenpwned's monthly billed API key
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for haveibeenpwned-asyncio-0.0.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1cd5ca7d24cded77493ddba55bc6718ea8f5affaff078351e494f7c943f5fce6 |
|
MD5 | e7724ee9173cff3c76ab73f93c71cb93 |
|
BLAKE2b-256 | 970151bc183d516e06cd6c08f51771d920a4d4b2900f164168668a0239e02203 |
Hashes for haveibeenpwned_asyncio-0.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f579db2f877d86b531d585cd20fadb1845c55ec8fc4ae6b3fdfebcf6d523fc66 |
|
MD5 | 926064c187e7d28c1e2c2e49e287c100 |
|
BLAKE2b-256 | 233ee56f302a3eddaef84eff97c2c390e3af13cac4313749b3324eb9fea79793 |