[](https://pypi.org/project/requests-doh)
[](https://pypi.org/project/requests-doh)
[](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": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "requests, doh, dns, https, dns-over-https",
"author": "Rahman Yusuf",
"author_email": "danipart4@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/a3/8d/d9b24a0c0975c9330bcc152af2b5c9a34fa5af0307c10366fdc27e75f24e/requests_doh-1.0.0.tar.gz",
"platform": null,
"description": "[](https://pypi.org/project/requests-doh)\n[](https://pypi.org/project/requests-doh)\n[](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": "1.0.0",
"project_urls": {
"Homepage": "https://github.com/mansuf/requests-doh"
},
"split_keywords": [
"requests",
" doh",
" dns",
" https",
" dns-over-https"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d5f179f00f86e53510b75a14dc500286f351550cc8207c81e7de1f38072fbcac",
"md5": "eff63eebcc513dde3eddf0a01fe55a09",
"sha256": "eea6583b792b7d3dfde74fd28eedc2b95d6ea896368119eede31f0d6ff2c838c"
},
"downloads": -1,
"filename": "requests_doh-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "eff63eebcc513dde3eddf0a01fe55a09",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 13879,
"upload_time": "2024-09-07T13:42:54",
"upload_time_iso_8601": "2024-09-07T13:42:54.189761Z",
"url": "https://files.pythonhosted.org/packages/d5/f1/79f00f86e53510b75a14dc500286f351550cc8207c81e7de1f38072fbcac/requests_doh-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a38dd9b24a0c0975c9330bcc152af2b5c9a34fa5af0307c10366fdc27e75f24e",
"md5": "90c8243ae47da7066b98f28d07f0678d",
"sha256": "6ce8bc96245030a198ef20d2100b4dcb3b120a05a58df703f8be121a79f8f2fb"
},
"downloads": -1,
"filename": "requests_doh-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "90c8243ae47da7066b98f28d07f0678d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 13126,
"upload_time": "2024-09-07T13:42:55",
"upload_time_iso_8601": "2024-09-07T13:42:55.394444Z",
"url": "https://files.pythonhosted.org/packages/a3/8d/d9b24a0c0975c9330bcc152af2b5c9a34fa5af0307c10366fdc27e75f24e/requests_doh-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-07 13:42:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mansuf",
"github_project": "requests-doh",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "requests",
"specs": [
[
"==",
"2.32.3"
]
]
},
{
"name": "dnspython",
"specs": [
[
"==",
"2.6.1"
]
]
}
],
"lcname": "requests-doh"
}
JSON
