Pydnsbl

https://pypi.org/project/pydnsbl/
Admin
Pydnsbl is an async DNSBL lists checker based on asyncio/aiodns that checks if an IP address or...
Tokens:2,461
Snippets:28
Trust Score:10
Update:3 months ago
Show doc for...
Tokens:
Raw
### DNSBLResult Properties Example

Source: https://pypi.org/project/pydnsbl

Demonstrates how to access the properties of a DNSBLResult object returned by check methods.

```APIDOC
## DNSBLResult Properties Example

### Description
This example shows how to access the various properties of the `DNSBLResult` object.

### Code Example
```python
>>> result = domain_checker.check('belonging708-info.xyz')
>>> result.addr
'belonging708-info.xyz'
>>> result.blacklisted
True
>>> result.detected_by
{'multi.surbl.org': ['unknown'], 'dbl.spamhaus.org': ['spam']}
>>> result.categories
{'unknown', 'spam'}
>>> result.providers
[<Provider: uribl.spameatingmonkey.net>, <Provider: multi.surbl.org>, <Provider: rhsbl.sorbs.net >, <Provider: dbl.spamhaus.org>]
>>> result.failed_providers
[]
```
```

--------------------------------

### Check Domain with pydnsbl

Source: https://pypi.org/project/pydnsbl

Instantiate DNSBLDomainChecker and check a domain name. Use this to determine if a domain is listed on any DNSBLs.

```python
import pydnsbl
domain_checker = pydnsbl.DNSBLDomainChecker()
domain_checker.check('google.com')
<DNSBLResult: google.com  (0/4)>
domain_checker.check('belonging708-info.xyz')
<DNSBLResult: belonging708-info.xyz [BLACKLISTED] (2/4)>
```

--------------------------------

### Access DNSBLResult Properties

Source: https://pypi.org/project/pydnsbl

Demonstrates how to access the properties of a DNSBLResult object after checking an IP or domain. This allows detailed inspection of the check results.

```python
result = domain_checker.check('belonging708-info.xyz')
result.addr
'belonging708-info.xyz'
result.blacklisted
True
result.detected_by
{'multi.surbl.org': ['unknown'], 'dbl.spamhaus.org': ['spam']}
result.categories
{'unknown', 'spam'}
result.providers
[<Provider: uribl.spameatingmonkey.net>, <Provider: multi.surbl.org>, <Provider: rhsbl.sorbs.net >, <Provider: dbl.spamhaus.org>]
result.failed_providers
[]
```

--------------------------------

### Check IP Address with pydnsbl

Source: https://pypi.org/project/pydnsbl

Instantiate DNSBLIpChecker and check an IP address. Use this to determine if an IP is listed on any DNSBLs.

```python
import pydnsbl
ip_checker = pydnsbl.DNSBLIpChecker()
ip_checker.check('8.8.8.8')
<DNSBLResult: 8.8.8.8  (0/52)>
ip_checker.check('68.128.212.240')
<DNSBLResult: 68.128.212.240 [BLACKLISTED] (6/52)>
```

--------------------------------

### Check IP Address

Source: https://pypi.org/project/pydnsbl

Instantiate DNSBLIpChecker and use the check method to see if an IP address is listed in any DNSBL lists. The result object provides details about the check.

```APIDOC
## Check IP Address

### Description
Checks if an IP address is listed in DNS blacklists.

### Method Signature
`DNSBLIpChecker().check(ip_address: str)`

### Parameters
- **ip_address** (str) - The IP address to check.

### Request Example
```python
>>> import pydnsbl
>>> ip_checker = pydnsbl.DNSBLIpChecker()
>>> ip_checker.check('8.8.8.8')
<DNSBLResult: 8.8.8.8  (0/52)>
>>> ip_checker.check('68.128.212.240')
<DNSBLResult: 68.128.212.240 [BLACKLISTED] (6/52)>
```

### Response
Returns a `DNSBLResult` object containing the check results.

#### DNSBLResult Properties
- `addr` (str): The IP address that was checked.
- `blacklisted` (bool): True if the IP address was detected by at least one provider.
- `detected_by` (dict): A dictionary where keys are provider hosts that detected the IP and values are their category verdicts.
- `categories` (set): A set of combined categories from all providers for this IP address.
- `providers` (list): A list of providers that performed the check.
- `failed_providers` (list): A list of providers that were unable to check this IP properly.
```

--------------------------------

### Extend DNSBL Providers

Source: https://pypi.org/project/pydnsbl

Add custom providers to the default list for DNSBL checking. Ensure you import the necessary classes from pydnsbl.

```python
from pydnsbl import DNSBLIpChecker, providers
from pydnsbl.providers import BASE_PROVIDERS, Provider
providers = BASE_PROVIDERS + [Provider('yourprovider1.com'), ...]
checker = DNSBLIpChecker(providers=providers)
```

--------------------------------

### Check Domain

Source: https://pypi.org/project/pydnsbl

Instantiate DNSBLDomainChecker and use the check method to see if a domain is listed in any DNSBL lists. The result object provides details about the check.

```APIDOC
## Check Domain

### Description
Checks if a domain is listed in DNS blacklists.

### Method Signature
`DNSBLDomainChecker().check(domain: str)`

### Parameters
- **domain** (str) - The domain to check.

### Request Example
```python
>>> import pydnsbl
>>> domain_checker = pydnsbl.DNSBLDomainChecker()
>>> domain_checker.check('google.com')
<DNSBLResult: google.com  (0/4)>
>>> domain_checker.check('belonging708-info.xyz')
<DNSBLResult: belonging708-info.xyz [BLACKLISTED] (2/4)>
```

### Response
Returns a `DNSBLResult` object containing the check results.

#### DNSBLResult Properties
- `addr` (str): The domain that was checked.
- `blacklisted` (bool): True if the domain was detected by at least one provider.
- `detected_by` (dict): A dictionary where keys are provider hosts that detected the domain and values are their category verdicts.
- `categories` (set): A set of combined categories from all providers for this domain.
- `providers` (list): A list of providers that performed the check.
- `failed_providers` (list): A list of providers that were unable to check this domain properly.
```
Tokens:
Raw