[![pypi-total-downloads](https://img.shields.io/pypi/dm/requests-doh?label=DOWNLOADS&style=for-the-badge)](https://pypi.org/project/requests-doh)
[![python-ver](https://img.shields.io/pypi/pyversions/requests-doh?style=for-the-badge)](https://pypi.org/project/requests-doh)
[![pypi-release-ver](https://img.shields.io/pypi/v/requests-doh?style=for-the-badge)](https://pypi.org/project/requests-doh)
# requests-doh
DNS over HTTPS resolver for python [requests](https://github.com/psf/requests) using [dnspython](https://github.com/rthalley/dnspython) module
## Key features
- Resolve hosts using [public DNS servers](https://adguard-dns.io/kb/general/dns-providers)
or custom DNS servers over HTTPS
- DNS caching, making faster to resolve hosts
- Easy to use
## Installation
You must have Python 3.8.x or up with Pip installed.
### PyPI (stable version)
```shell
# For Linux / Mac OS
python3 -m pip install requests-doh
# For Windows
py -3 -m pip install requests-doh
```
### Git (Development version)
```shell
git clone https://github.com/mansuf/requests-doh.git
cd requests-doh
python setup.py install
```
For more information about installation, see [Installation](https://requests-doh.mansuf.link/en/stable/installation.html)
## Usage
```python
# for convenience
from requests_doh import DNSOverHTTPSSession
# By default, DoH provider will set to `cloudflare`
session = DNSOverHTTPSSession(provider='google')
r = session.get('https://google.com')
print(r.content)
```
For more information about usage, see [API usage](https://requests-doh.mansuf.link/en/stable/api_usage.html)
## Links
- [PyPI](https://pypi.org/project/requests-doh/)
- [Docs](https://requests-doh.mansuf.link/)
## License
See [LICENSE](https://github.com/mansuf/requests-doh/blob/main/LICENSE)
Raw data
{
"_id": null,
"home_page": "https://github.com/mansuf/requests-doh",
"name": "requests-doh",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "requests,doh,dns,https,dns-over-https",
"author": "Rahman Yusuf",
"author_email": "danipart4@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/3b/c2/54730cb1587d7e8cdcccf8c91d2144585f0e48c0c5717a20db5a566b41e2/requests-doh-0.3.2.tar.gz",
"platform": null,
"description": "[![pypi-total-downloads](https://img.shields.io/pypi/dm/requests-doh?label=DOWNLOADS&style=for-the-badge)](https://pypi.org/project/requests-doh)\n[![python-ver](https://img.shields.io/pypi/pyversions/requests-doh?style=for-the-badge)](https://pypi.org/project/requests-doh)\n[![pypi-release-ver](https://img.shields.io/pypi/v/requests-doh?style=for-the-badge)](https://pypi.org/project/requests-doh)\n\n# requests-doh\n\nDNS over HTTPS resolver for python [requests](https://github.com/psf/requests) using [dnspython](https://github.com/rthalley/dnspython) module\n\n## Key features\n\n- Resolve hosts using [public DNS servers](https://adguard-dns.io/kb/general/dns-providers)\nor custom DNS servers over HTTPS\n- DNS caching, making faster to resolve hosts\n- Easy to use\n\n## Installation\n\nYou must have Python 3.8.x or up with Pip installed.\n\n### PyPI (stable version)\n\n```shell\n# For Linux / Mac OS\npython3 -m pip install requests-doh\n\n# For Windows\npy -3 -m pip install requests-doh\n```\n\n### Git (Development version)\n\n```shell\ngit clone https://github.com/mansuf/requests-doh.git\ncd requests-doh\npython setup.py install\n```\n\nFor more information about installation, see [Installation](https://requests-doh.mansuf.link/en/stable/installation.html)\n\n## Usage\n\n```python\n# for convenience\nfrom requests_doh import DNSOverHTTPSSession\n\n# By default, DoH provider will set to `cloudflare`\nsession = DNSOverHTTPSSession(provider='google')\nr = session.get('https://google.com')\nprint(r.content)\n```\n\nFor more information about usage, see [API usage](https://requests-doh.mansuf.link/en/stable/api_usage.html)\n\n## Links\n\n- [PyPI](https://pypi.org/project/requests-doh/)\n- [Docs](https://requests-doh.mansuf.link/)\n\n## License\n\nSee [LICENSE](https://github.com/mansuf/requests-doh/blob/main/LICENSE)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "DNS over HTTPS resolver for python requests",
"version": "0.3.2",
"project_urls": {
"Homepage": "https://github.com/mansuf/requests-doh"
},
"split_keywords": [
"requests",
"doh",
"dns",
"https",
"dns-over-https"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c9ca1e54d7ae7665a59fd182a6e18f2969c56aa9addbc9e339414f944c78b402",
"md5": "752c421e4142f2d09c7c3bf7d6c6f25b",
"sha256": "a1d7ab1cb1407fe6d6225327d9ee883c96ed552b8bca71bfe41c54f75032e529"
},
"downloads": -1,
"filename": "requests_doh-0.3.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "752c421e4142f2d09c7c3bf7d6c6f25b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 13874,
"upload_time": "2024-01-23T07:23:48",
"upload_time_iso_8601": "2024-01-23T07:23:48.460816Z",
"url": "https://files.pythonhosted.org/packages/c9/ca/1e54d7ae7665a59fd182a6e18f2969c56aa9addbc9e339414f944c78b402/requests_doh-0.3.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3bc254730cb1587d7e8cdcccf8c91d2144585f0e48c0c5717a20db5a566b41e2",
"md5": "ad2b1da4ffaf40e85169105b17878b24",
"sha256": "a84359ac063abff3fa12b5ad764271b9f8a33899b29dd46b146f16e1c401598e"
},
"downloads": -1,
"filename": "requests-doh-0.3.2.tar.gz",
"has_sig": false,
"md5_digest": "ad2b1da4ffaf40e85169105b17878b24",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 13128,
"upload_time": "2024-01-23T07:23:49",
"upload_time_iso_8601": "2024-01-23T07:23:49.626952Z",
"url": "https://files.pythonhosted.org/packages/3b/c2/54730cb1587d7e8cdcccf8c91d2144585f0e48c0c5717a20db5a566b41e2/requests-doh-0.3.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-23 07:23:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mansuf",
"github_project": "requests-doh",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "requests-doh"
}