<p align="center">
<img height=300 src="https://raw.githubusercontent.com/Xample33/cvehunter/development/images/cvehunter_logo.png" alt='cvehunter_logo'></a>
</p>
<h1 align="center"> CVEHunter - Async python wrapper for CVE/CPE data</h1>
<p align="center">
<a href="https://github.com/astral-sh/ruff"> <img alt="Ruff" src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json"> </a>
<a href="https://pypi.org/project/cvehunter"> <img alt="PyPI - Version" src="https://badgen.net/pypi/v/cvehunter"> </a>
<a href="https://pypi.org/project/cvehunter"> <img alt="PyPI - Python Version" src="https://badgen.net/pypi/python/cvehunter"> </a>
<a href="https://pypi.org/project/cvehunter"> <img alt="PyPI - Downloads" src="https://badgen.net/pypi/dm/cvehunter"> </a>
<img src="https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2FXample33%2Fcvehunter&count_bg=%2379C83D&title_bg=%23555555&icon=&icon_color=%23E7E7E7&title=hits&edge_flat=false">
</p>
CVEHunter is a Python asynchronous library designed to simplify the retrieval of CVE (Common Vulnerabilities and Exposures) and CPE (Common Platform Enumeration) information using the NVD API. It streamlines the process of searching for and accessing valuable security data for vulnerability assessment and management.
## Installation
```
pip3 install cvehunter
```
## Example
Code:
```python
import asyncio
from cvehunter import CveHunter
async def test() -> None:
ch = CveHunter()
cve = await ch.search_by_cve("CVE-2023-41991")
print(cve.cve_id)
print(cve.cwe_id)
print(cve.description)
print(cve.cvss_v3)
print(cve.references)
asyncio.run(test())
```
Output:
```
CVE-2023-41991
CWE-295
A certificate validation issue was addressed. This issue is fixed in macOS Ventura 13.6, iOS 16.7 and iPadOS 16.7. A malicious app [...]
{'score': 5.5, 'vector': 'CVSS:3.1/AV:L/AC:L/PR:N/UI:R/S:U/C:N/I:H/A:N', 'severity': 'MEDIUM', 'version': 3.1, 'exploitability': 1.8, 'impact': 3.6}
['http://seclists.org/fulldisclosure/2023/Oct/5', 'https://support.apple.com/en-us/HT213927', 'https://support.apple.com/en-us/HT213931']
```
## Documentation
The documentation is hosted on readthedocs, check it <a href="https://cvehunter-Docs.readthedocs.io/"> here </a>
## TODO
- [ ] Change history
- [ ] Better filters
## Contributing
Contributions are welcome! If you'd like to contribute to CVEHunter, please follow the guidelines outlined in the Contributing Guide.
## License
This project is licensed under the MIT License.
Raw data
{
"_id": null,
"home_page": "https://github.com/Xample33/cvehunter",
"name": "cvehunter",
"maintainer": "Xample33",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "",
"keywords": "cve nist nvd cpe cwe cvss vulnerability api",
"author": "Xample33",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/94/f7/d9acbed9276fe37107ac245e55b19cdebd0d6a2c48c59755baaca364b7c4/cvehunter-1.0.6.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <img height=300 src=\"https://raw.githubusercontent.com/Xample33/cvehunter/development/images/cvehunter_logo.png\" alt='cvehunter_logo'></a>\n</p>\n\n<h1 align=\"center\"> CVEHunter - Async python wrapper for CVE/CPE data</h1>\n\n<p align=\"center\"> \n <a href=\"https://github.com/astral-sh/ruff\"> <img alt=\"Ruff\" src=\"https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json\"> </a>\n <a href=\"https://pypi.org/project/cvehunter\"> <img alt=\"PyPI - Version\" src=\"https://badgen.net/pypi/v/cvehunter\"> </a>\n <a href=\"https://pypi.org/project/cvehunter\"> <img alt=\"PyPI - Python Version\" src=\"https://badgen.net/pypi/python/cvehunter\"> </a>\n <a href=\"https://pypi.org/project/cvehunter\"> <img alt=\"PyPI - Downloads\" src=\"https://badgen.net/pypi/dm/cvehunter\"> </a>\n <img src=\"https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2FXample33%2Fcvehunter&count_bg=%2379C83D&title_bg=%23555555&icon=&icon_color=%23E7E7E7&title=hits&edge_flat=false\">\n</p>\n\nCVEHunter is a Python asynchronous library designed to simplify the retrieval of CVE (Common Vulnerabilities and Exposures) and CPE (Common Platform Enumeration) information using the NVD API. It streamlines the process of searching for and accessing valuable security data for vulnerability assessment and management.\n\n## Installation\n\n```\npip3 install cvehunter\n```\n\n## Example\nCode:\n```python\nimport asyncio\nfrom cvehunter import CveHunter\n\nasync def test() -> None:\n ch = CveHunter()\n \n cve = await ch.search_by_cve(\"CVE-2023-41991\")\n \n print(cve.cve_id)\n print(cve.cwe_id)\n print(cve.description)\n print(cve.cvss_v3)\n print(cve.references)\n \nasyncio.run(test())\n```\n\nOutput:\n```\nCVE-2023-41991\nCWE-295\nA certificate validation issue was addressed. This issue is fixed in macOS Ventura 13.6, iOS 16.7 and iPadOS 16.7. A malicious app [...]\n{'score': 5.5, 'vector': 'CVSS:3.1/AV:L/AC:L/PR:N/UI:R/S:U/C:N/I:H/A:N', 'severity': 'MEDIUM', 'version': 3.1, 'exploitability': 1.8, 'impact': 3.6}\n['http://seclists.org/fulldisclosure/2023/Oct/5', 'https://support.apple.com/en-us/HT213927', 'https://support.apple.com/en-us/HT213931']\n```\n\n## Documentation\nThe documentation is hosted on readthedocs, check it <a href=\"https://cvehunter-Docs.readthedocs.io/\"> here </a>\n\n\n## TODO\n- [ ] Change history\n- [ ] Better filters\n\n\n## Contributing\nContributions are welcome! If you'd like to contribute to CVEHunter, please follow the guidelines outlined in the Contributing Guide.\n\n\n## License\nThis project is licensed under the MIT License.\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Asynchronous python wrapper for the NVD API",
"version": "1.0.6",
"project_urls": {
"Homepage": "https://github.com/Xample33/cvehunter"
},
"split_keywords": [
"cve",
"nist",
"nvd",
"cpe",
"cwe",
"cvss",
"vulnerability",
"api"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "40d6a8c598f52d8893717d2adfd6021ee2ab6a49864038d4d1623432b761f119",
"md5": "e9452c8a1f8657cac1a47789219cf330",
"sha256": "4b6891309b826a15c310ca2fc0c495c5945a90e831b54fde6456490908437a7c"
},
"downloads": -1,
"filename": "cvehunter-1.0.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e9452c8a1f8657cac1a47789219cf330",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 7983,
"upload_time": "2023-10-13T16:40:06",
"upload_time_iso_8601": "2023-10-13T16:40:06.404648Z",
"url": "https://files.pythonhosted.org/packages/40/d6/a8c598f52d8893717d2adfd6021ee2ab6a49864038d4d1623432b761f119/cvehunter-1.0.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "94f7d9acbed9276fe37107ac245e55b19cdebd0d6a2c48c59755baaca364b7c4",
"md5": "81b2853acfdec7f4d66b41199ff9912b",
"sha256": "9c7e65925e6802f335466fd9bae5593905c5d88c5663bd9e99c4e8a566182646"
},
"downloads": -1,
"filename": "cvehunter-1.0.6.tar.gz",
"has_sig": false,
"md5_digest": "81b2853acfdec7f4d66b41199ff9912b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 9103,
"upload_time": "2023-10-13T16:40:08",
"upload_time_iso_8601": "2023-10-13T16:40:08.669060Z",
"url": "https://files.pythonhosted.org/packages/94/f7/d9acbed9276fe37107ac245e55b19cdebd0d6a2c48c59755baaca364b7c4/cvehunter-1.0.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-13 16:40:08",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Xample33",
"github_project": "cvehunter",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "cvehunter"
}
JSON
