| Name | dnstester-qboxxbyh JSON |
| Version |
0.2.1
JSON |
| download |
| home_page | None |
| Summary | This is a tester for a DNS proxy filter. Used to locally test DNS proxy filters that use a certain format of configuration file. See disciption at GitHub page. |
| upload_time | 2025-07-22 01:16:48 |
| maintainer | None |
| docs_url | None |
| author | Alexander Yuryatin |
| requires_python | >=3.8 |
| license | None |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# The Python package dnstester-qboxxbyh
This is a tester for a DNS proxy filter. It can be used locally or remotely to test DNS proxy filters that rely on a specific configuration file format below:
```ini
[server]
listen_address = 127.0.0.1
listen_port = 5300
[upstream]
dns1 = 1.1.1.1
dns2 = 8.8.8.8
dns3 = 8.8.4.4
[blacklist]
yandex.ru = notfind
ya.ru = refuse
tutu.ru = 178.248.234.61
```
# Installation
This package is available on PyPI and can be installed with ```pip install dnstester-qboxxbyh ``` or updated with ```pip install --upgrade dnstester-qboxxbyh ```
# How to use
If the DNS proxy filter being tested is a Python script (e.g., mydnsfilter.py):
```python
from dnstester_qboxxbyh import dnsProxyTester
tester = dnsProxyTester(sample_size_input = 200)
tester.run(app_binary = "python3 mydnsfilter.py", sample_size_input = 200,
ignoreUnexpected = False, ignoreTrailing = False,
raiseOnTruncation = False, ignoreErrors = False,
timeOut = None) # None for timeOut means for ever
```
Or, if the DNS proxy filter being tested is a binary (which may also require its own parameters, such as a configuration file):
```python
from dnstester_qboxxbyh import dnsProxyTester
tester = dnsProxyTester(sample_size_input = 200)
tester.run(app_binary =
"~/dns-proxy-filter-p2B9agE1/dns_proxy_filter_p2B9agE1 ~/.config/p2B9agE1/dns-proxy-p2B9agE1.conf",
sample_size_input = 200, ignoreUnexpected = False, ignoreTrailing = False, cores = 16,
raiseOnTruncation = False, ignoreErrors = False,
timeOut = None) # None for timeOut means for ever
```
# How it works
The software downloads and uses a collection of 4,170,262 verified domains from https://tranco-list.eu/download/VQ92N/full. It makes a random sample without replacement from this pool of domains and randomly splits it into four subsamples. Using three of those subsamples (one for domains not to be found, one for domains to be refused service, and one for domains with randomly pre-specified IPv4 and IPv6 addresses), the software creates a test configuration file and locally launches the tested DNS proxy filter.
# The test results
The results are displayed and are dynamically updated in the terminal:
# Constraints
This version doesn't yet support:
* Pre-specifying both IPv4 and IPv6 for the same domain in the configuration file
* Testing the handling of non-standard multi-query DNS requests by a DNS proxy filter
Raw data
{
"_id": null,
"home_page": null,
"name": "dnstester-qboxxbyh",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": "Alexander Yuryatin",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/8f/59/5607eb663c0940cc1c1b5938ba9ff98e85c939b04a3dbaf4866adb033325/dnstester_qboxxbyh-0.2.1.tar.gz",
"platform": null,
"description": "# The Python package dnstester-qboxxbyh\nThis is a tester for a DNS proxy filter. It can be used locally or remotely to test DNS proxy filters that rely on a specific configuration file format below:\n```ini\n [server]\n listen_address = 127.0.0.1\n listen_port = 5300\n \n [upstream]\n dns1 = 1.1.1.1\n dns2 = 8.8.8.8\n dns3 = 8.8.4.4\n \n [blacklist]\n yandex.ru = notfind\n ya.ru = refuse\n tutu.ru = 178.248.234.61\n```\n\n# Installation\n\nThis package is available on PyPI and can be installed with ```pip install dnstester-qboxxbyh ``` or updated with ```pip install --upgrade dnstester-qboxxbyh ```\n\n# How to use\n\nIf the DNS proxy filter being tested is a Python script (e.g., mydnsfilter.py): \n```python\nfrom dnstester_qboxxbyh import dnsProxyTester\ntester = dnsProxyTester(sample_size_input = 200)\ntester.run(app_binary = \"python3 mydnsfilter.py\", sample_size_input = 200,\n ignoreUnexpected = False, ignoreTrailing = False,\n raiseOnTruncation = False, ignoreErrors = False,\n timeOut = None) # None for timeOut means for ever\n```\n\nOr, if the DNS proxy filter being tested is a binary (which may also require its own parameters, such as a configuration file):\n\n```python\nfrom dnstester_qboxxbyh import dnsProxyTester\ntester = dnsProxyTester(sample_size_input = 200)\ntester.run(app_binary =\n \"~/dns-proxy-filter-p2B9agE1/dns_proxy_filter_p2B9agE1 ~/.config/p2B9agE1/dns-proxy-p2B9agE1.conf\",\n sample_size_input = 200, ignoreUnexpected = False, ignoreTrailing = False, cores = 16,\n raiseOnTruncation = False, ignoreErrors = False,\n timeOut = None) # None for timeOut means for ever\n```\n\n# How it works\n\nThe software downloads and uses a collection of 4,170,262 verified domains from https://tranco-list.eu/download/VQ92N/full. It makes a random sample without replacement from this pool of domains and randomly splits it into four subsamples. Using three of those subsamples (one for domains not to be found, one for domains to be refused service, and one for domains with randomly pre-specified IPv4 and IPv6 addresses), the software creates a test configuration file and locally launches the tested DNS proxy filter.\n\n# The test results\n\nThe results are displayed and are dynamically updated in the terminal:\n\n\n\n# Constraints\n\nThis version doesn't yet support:\n* Pre-specifying both IPv4 and IPv6 for the same domain in the configuration file\n* Testing the handling of non-standard multi-query DNS requests by a DNS proxy filter\n",
"bugtrack_url": null,
"license": null,
"summary": "This is a tester for a DNS proxy filter. Used to locally test DNS proxy filters that use a certain format of configuration file. See disciption at GitHub page.",
"version": "0.2.1",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "8e2861cf6c3ea48820a4930d242e42d7b53b49b8adb15ffcdefa0f6183925115",
"md5": "b17552a76e3a4117dc8957adb3cbf983",
"sha256": "2cc3181d1a0edcf9143587ed39434bbbd54614d1fd5c2a1157d9b286d6294022"
},
"downloads": -1,
"filename": "dnstester_qboxxbyh-0.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b17552a76e3a4117dc8957adb3cbf983",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 8555,
"upload_time": "2025-07-22T01:16:47",
"upload_time_iso_8601": "2025-07-22T01:16:47.579730Z",
"url": "https://files.pythonhosted.org/packages/8e/28/61cf6c3ea48820a4930d242e42d7b53b49b8adb15ffcdefa0f6183925115/dnstester_qboxxbyh-0.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "8f595607eb663c0940cc1c1b5938ba9ff98e85c939b04a3dbaf4866adb033325",
"md5": "37b2872a15a24d0c0626740925be9c2f",
"sha256": "d4761dc5912d7230fac53690091527216745e5ac50852145a8545aa634ebfda5"
},
"downloads": -1,
"filename": "dnstester_qboxxbyh-0.2.1.tar.gz",
"has_sig": false,
"md5_digest": "37b2872a15a24d0c0626740925be9c2f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 8887,
"upload_time": "2025-07-22T01:16:48",
"upload_time_iso_8601": "2025-07-22T01:16:48.826552Z",
"url": "https://files.pythonhosted.org/packages/8f/59/5607eb663c0940cc1c1b5938ba9ff98e85c939b04a3dbaf4866adb033325/dnstester_qboxxbyh-0.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-22 01:16:48",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "dnstester-qboxxbyh"
}
