[![Documentation Status](https://readthedocs.org/projects/pypdns/badge/?version=latest)](https://pypdns.readthedocs.io/en/latest/?badge=latest)
Client API for PDNS
===================
Client API to query any Passive DNS implementation following the Passive DNS - Common Output Format.
* https://datatracker.ietf.org/doc/draft-dulaunoy-dnsop-passive-dns-cof/
## Installation
```bash
pip install pypdns
```
## Usage
### Command line
You can use the `pdns` command to trigger a request.
```bash
usage: pdns [-h] --username USERNAME --password PASSWORD --query QUERY [--rrtype RRTYPE]
Triggers a request againse CIRCL Passive DNS.
options:
-h, --help show this help message and exit
--username USERNAME The username of you account.
--password PASSWORD The password of you account.
--query QUERY The query, can be an IP. domain, hostname, TLD.
--rrtype RRTYPE Filter the request based on the RR Type.
```
### Library
See [API Reference](https://pypdns.readthedocs.io/en/latest/api_reference.html)
Example
=======
~~~~
import pypdns
import json
x = pypdns.PyPDNS(basic_auth=('username','yourpassword'))
for record in x.iter_query(q='circl.lu', filter_rrtype='A'):
print(json.dumps(record.record, indent=2))
~~~~
Passive DNS Services
====================
* (default) [CIRCL Passive DNS](http://www.circl.lu/services/passive-dns/)
Raw data
{
"_id": null,
"home_page": "https://github.com/CIRCL/PyPDNS",
"name": "pypdns",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<4.0",
"maintainer_email": "",
"keywords": "",
"author": "Rapha\u00ebl Vinot",
"author_email": "raphael.vinot@circl.lu",
"download_url": "https://files.pythonhosted.org/packages/b1/6f/f4c7f79713b0924e221c68245d6d0ed7d5dc538eccd5083147d6250a16ad/pypdns-2.2.2.tar.gz",
"platform": null,
"description": "[![Documentation Status](https://readthedocs.org/projects/pypdns/badge/?version=latest)](https://pypdns.readthedocs.io/en/latest/?badge=latest)\n\nClient API for PDNS\n===================\n\nClient API to query any Passive DNS implementation following the Passive DNS - Common Output Format.\n\n* https://datatracker.ietf.org/doc/draft-dulaunoy-dnsop-passive-dns-cof/\n\n## Installation\n\n```bash\npip install pypdns\n```\n\n## Usage\n\n### Command line\n\nYou can use the `pdns` command to trigger a request.\n\n```bash\nusage: pdns [-h] --username USERNAME --password PASSWORD --query QUERY [--rrtype RRTYPE]\n\nTriggers a request againse CIRCL Passive DNS.\n\noptions:\n -h, --help show this help message and exit\n --username USERNAME The username of you account.\n --password PASSWORD The password of you account.\n --query QUERY The query, can be an IP. domain, hostname, TLD.\n --rrtype RRTYPE Filter the request based on the RR Type.\n```\n\n### Library\n\nSee [API Reference](https://pypdns.readthedocs.io/en/latest/api_reference.html)\n\n\nExample\n=======\n\n~~~~\nimport pypdns\nimport json\nx = pypdns.PyPDNS(basic_auth=('username','yourpassword'))\n\nfor record in x.iter_query(q='circl.lu', filter_rrtype='A'):\n print(json.dumps(record.record, indent=2))\n~~~~\n\nPassive DNS Services\n====================\n\n* (default) [CIRCL Passive DNS](http://www.circl.lu/services/passive-dns/)\n\n\n",
"bugtrack_url": null,
"license": "GPL-3.0+",
"summary": "Python API for PDNS.",
"version": "2.2.2",
"project_urls": {
"Bug Tracker": "https://github.com/CIRCL/PyPDNS/issues",
"Documentation": "https://github.com/CIRCL/PyPDNS",
"Homepage": "https://github.com/CIRCL/PyPDNS",
"Repository": "https://github.com/CIRCL/PyPDNS"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c23a5969b7a1b39667a7cd674c77870bc058d3845a9427a174dede12eb0f6ca5",
"md5": "0747634ec40f2b5d06da5ddcfa045cc4",
"sha256": "214fd04a07b3a6e2ac6a2efea629dde4d84b3c44f9c808ebfda9f78b0a3b0069"
},
"downloads": -1,
"filename": "pypdns-2.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0747634ec40f2b5d06da5ddcfa045cc4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<4.0",
"size": 8763,
"upload_time": "2024-02-13T10:08:24",
"upload_time_iso_8601": "2024-02-13T10:08:24.935650Z",
"url": "https://files.pythonhosted.org/packages/c2/3a/5969b7a1b39667a7cd674c77870bc058d3845a9427a174dede12eb0f6ca5/pypdns-2.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b16ff4c7f79713b0924e221c68245d6d0ed7d5dc538eccd5083147d6250a16ad",
"md5": "9f8d1f343b3de6cdfad0f70f4b347d96",
"sha256": "b978fa3fcd4923768f7093da4f102fa4c5a8e57d6a4d6a1ae01554cc5977f82b"
},
"downloads": -1,
"filename": "pypdns-2.2.2.tar.gz",
"has_sig": false,
"md5_digest": "9f8d1f343b3de6cdfad0f70f4b347d96",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<4.0",
"size": 8080,
"upload_time": "2024-02-13T10:08:36",
"upload_time_iso_8601": "2024-02-13T10:08:36.455993Z",
"url": "https://files.pythonhosted.org/packages/b1/6f/f4c7f79713b0924e221c68245d6d0ed7d5dc538eccd5083147d6250a16ad/pypdns-2.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-13 10:08:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "CIRCL",
"github_project": "PyPDNS",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pypdns"
}