hibpwned


Namehibpwned JSON
Version 1.3.9 PyPI version JSON
download
home_pageNone
SummaryA human friendly Python API wrapper for haveibeenpwned.com
upload_time2024-09-01 21:40:30
maintainerNone
docs_urlNone
authorNone
requires_python>=3.11
licenseNone
keywords hibp haveibeenpwned api wrapper
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            [![build](https://github.com/plasticuproject/hibpwned/actions/workflows/tests.yml/badge.svg)](https://github.com/plasticuproject/hibpwned/actions/workflows/tests.yml)
[![Python 3.11](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/release/python-311/)
[![License: LGPL v3](https://img.shields.io/badge/License-LGPL%20v3-blue.svg)](https://www.gnu.org/licenses/lgpl-3.0)
[![PyPI version](https://badge.fury.io/py/hibpwned.svg)](https://badge.fury.io/py/hibpwned)
[![Downloads](https://pepy.tech/badge/hibpwned)](https://pepy.tech/project/hibpwned)
[![Coverage Status](https://coveralls.io/repos/github/plasticuproject/hibpwned/badge.svg?branch=master)](https://coveralls.io/github/plasticuproject/hibpwned?branch=master)
[![CodeQL](https://github.com/plasticuproject/hibpwned/actions/workflows/codeql.yml/badge.svg)](https://github.com/plasticuproject/hibpwned/actions/workflows/codeql.yml)
[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=plasticuproject_hibpwned&metric=alert_status)](https://sonarcloud.io/dashboard?id=plasticuproject_hibpwned)
[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=plasticuproject_hibpwned&metric=security_rating)](https://sonarcloud.io/dashboard?id=plasticuproject_hibpwned)
# hibpwned
A friendly, low-level, fully functional, Python API wrapper for haveibeenpwned.com <br/>
All data sourced from https://haveibeenpwned.com <br/>
Visit https://haveibeenpwned.com/API/v3 to read the Acceptable Use Policy <br/>
for rules regarding acceptable usage of this API. <br/>


## Installation
```
pip install hibpwned
```
Making calls to the HIBP API requires a key. You can purchase an HIBP-API-Key at <br/>
https://haveibeenpwned.com/API/Key


## Usage
This module contains the class Pwned with functions: <br/>

search_all_breaches <br/>
all_breaches <br/>
single_breach <br/>
data_classes <br/>
search_pastes <br/>
search_password <br/>
search_hashes <br/>

All functions return a list of JSON objects containing relevent data, with the exception <br/>
of search_password and search_hashes, which returns an integer and a string object, <br/>
respectively. <br/>

See module DocStrings for function descriptions and parameters <br/>


## Examples
```python
import hibpwned

my_app = hibpwned.Pwned("test@example.com", "My_App", "My_API_Key")

my_breaches = my_app.search_all_breaches()
breaches = my_app.all_breaches()
adobe = my_app.single_breach("adobe")
data = my_app.data_classes()
my_pastes = my_app.search_pastes()
password = my_app.search_password("BadPassword")
my_hashes = my_app.search_hashes("21BD1")
```


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "hibpwned",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": null,
    "keywords": "hibp, haveibeenpwned, api, wrapper",
    "author": null,
    "author_email": "plasticuproject <plasticuproject@pm.me>",
    "download_url": "https://files.pythonhosted.org/packages/79/1d/b94ec77b1cfd6e4e0ad4a532afe9cd58b049e691efabca382bbab9b017cf/hibpwned-1.3.9.tar.gz",
    "platform": null,
    "description": "[![build](https://github.com/plasticuproject/hibpwned/actions/workflows/tests.yml/badge.svg)](https://github.com/plasticuproject/hibpwned/actions/workflows/tests.yml)\n[![Python 3.11](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/release/python-311/)\n[![License: LGPL v3](https://img.shields.io/badge/License-LGPL%20v3-blue.svg)](https://www.gnu.org/licenses/lgpl-3.0)\n[![PyPI version](https://badge.fury.io/py/hibpwned.svg)](https://badge.fury.io/py/hibpwned)\n[![Downloads](https://pepy.tech/badge/hibpwned)](https://pepy.tech/project/hibpwned)\n[![Coverage Status](https://coveralls.io/repos/github/plasticuproject/hibpwned/badge.svg?branch=master)](https://coveralls.io/github/plasticuproject/hibpwned?branch=master)\n[![CodeQL](https://github.com/plasticuproject/hibpwned/actions/workflows/codeql.yml/badge.svg)](https://github.com/plasticuproject/hibpwned/actions/workflows/codeql.yml)\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=plasticuproject_hibpwned&metric=alert_status)](https://sonarcloud.io/dashboard?id=plasticuproject_hibpwned)\n[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=plasticuproject_hibpwned&metric=security_rating)](https://sonarcloud.io/dashboard?id=plasticuproject_hibpwned)\n# hibpwned\nA friendly, low-level, fully functional, Python API wrapper for haveibeenpwned.com <br/>\nAll data sourced from https://haveibeenpwned.com <br/>\nVisit https://haveibeenpwned.com/API/v3 to read the Acceptable Use Policy <br/>\nfor rules regarding acceptable usage of this API. <br/>\n\n\n## Installation\n```\npip install hibpwned\n```\nMaking calls to the HIBP API requires a key. You can purchase an HIBP-API-Key at <br/>\nhttps://haveibeenpwned.com/API/Key\n\n\n## Usage\nThis module contains the class Pwned with functions: <br/>\n\nsearch_all_breaches <br/>\nall_breaches <br/>\nsingle_breach <br/>\ndata_classes <br/>\nsearch_pastes <br/>\nsearch_password <br/>\nsearch_hashes <br/>\n\nAll functions return a list of JSON objects containing relevent data, with the exception <br/>\nof search_password and search_hashes, which returns an integer and a string object, <br/>\nrespectively. <br/>\n\nSee module DocStrings for function descriptions and parameters <br/>\n\n\n## Examples\n```python\nimport hibpwned\n\nmy_app = hibpwned.Pwned(\"test@example.com\", \"My_App\", \"My_API_Key\")\n\nmy_breaches = my_app.search_all_breaches()\nbreaches = my_app.all_breaches()\nadobe = my_app.single_breach(\"adobe\")\ndata = my_app.data_classes()\nmy_pastes = my_app.search_pastes()\npassword = my_app.search_password(\"BadPassword\")\nmy_hashes = my_app.search_hashes(\"21BD1\")\n```\n\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A human friendly Python API wrapper for haveibeenpwned.com",
    "version": "1.3.9",
    "project_urls": {
        "Homepage": "https://github.com/plasticuproject/hibpwned"
    },
    "split_keywords": [
        "hibp",
        " haveibeenpwned",
        " api",
        " wrapper"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "0cd71cd561379d6b65c384b3631bb89a6a6fc8e7fdfaa5530af8a8d19e0fdd8c",
                "md5": "ba7c33d59cd5f87113f1cc79ab77bc7c",
                "sha256": "3dee5d1f8a701ae1d8e986a23ec0bdf0c19e196a844079a1adbd1dc714893fe2"
            },
            "downloads": -1,
            "filename": "hibpwned-1.3.9-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "ba7c33d59cd5f87113f1cc79ab77bc7c",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 11796,
            "upload_time": "2024-09-01T21:40:29",
            "upload_time_iso_8601": "2024-09-01T21:40:29.541695Z",
            "url": "https://files.pythonhosted.org/packages/0c/d7/1cd561379d6b65c384b3631bb89a6a6fc8e7fdfaa5530af8a8d19e0fdd8c/hibpwned-1.3.9-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "791db94ec77b1cfd6e4e0ad4a532afe9cd58b049e691efabca382bbab9b017cf",
                "md5": "d4c8a938753b4465371b0e3bf3777861",
                "sha256": "60b18d77ee81e47c84e013cd68184b3b420e71dc7a9df371bd7723ae6e8e72a6"
            },
            "downloads": -1,
            "filename": "hibpwned-1.3.9.tar.gz",
            "has_sig": false,
            "md5_digest": "d4c8a938753b4465371b0e3bf3777861",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 11625,
            "upload_time": "2024-09-01T21:40:30",
            "upload_time_iso_8601": "2024-09-01T21:40:30.912391Z",
            "url": "https://files.pythonhosted.org/packages/79/1d/b94ec77b1cfd6e4e0ad4a532afe9cd58b049e691efabca382bbab9b017cf/hibpwned-1.3.9.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-09-01 21:40:30",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "plasticuproject",
    "github_project": "hibpwned",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "lcname": "hibpwned"
}
        
Elapsed time: 0.54565s