Skip to main content
[![Build Status](https://img.shields.io/travis/abusix/querycontacts/master.svg)](https://travis-ci.org/abusix/querycontacts)
[![Test Coverage](https://img.shields.io/coveralls/github/abusix/querycontacts/master.svg)](https://coveralls.io/github/abusix/querycontacts)
[![PyPi Version](https://img.shields.io/pypi/v/querycontacts.svg)](https://pypi.python.org/pypi/querycontacts)
[![PyPi License](https://img.shields.io/pypi/l/querycontacts.svg)](https://pypi.python.org/pypi/querycontacts)
[![PyPi Versions](https://img.shields.io/pypi/pyversions/querycontacts.svg)](https://pypi.python.org/pypi/querycontacts)
[![PyPi Wheel](https://img.shields.io/pypi/wheel/querycontacts.svg)](https://pypi.python.org/pypi/querycontacts)

# querycontacts - Query Abuse Contacts

## Installation

```
pip install querycontacts
```

## Command line usage

```
usage: querycontacts [-h] [--provider PROVIDER] [--version] ip

QueryContact - Find the Abuse contact for a IP address

positional arguments:
ip query network abuse contacts for a given ip address

optional arguments:
-h, --help show this help message and exit
--provider PROVIDER change standard network abuse contacts provider.
Defaults to abuse-contacts.abusix.zone
--version show program's version number and exit
```

### Examples

Show version:

```
$ querycontacts --version
querycontacts 1.1.0
```

Show abuse contact for your IP:

```
$ IP=$(curl ipecho.net/plain)
$ querycontacts $IP
abuse@yourisp.example.com
```

Error when no abuse contact was found:

```
$ querycontacts 127.0.0.1
querycontacts: error: no contacts for 127.0.0.1
```

## Library usage
```
>>> from querycontacts import ContactFinder
>>> qf = ContactFinder()
>>> qf.find('127.0.0.2')
['root@localhost', 'abuse@localhost']

>>> qf.find('::ffff:7f00:2')
['root@localhost']
```


Metadata

Release files for querycontacts 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for querycontacts 1.1.0
File Size Uploaded
querycontacts-1.1.0.tar.gz 15.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for querycontacts 1.1.0
File Interpreter ABI Platform
querycontacts-1.1.0-py2.py3-none-any.whl Python 3, Python 2 none any Details

Total release size: 32.1 kB

Release files / querycontacts-1.1.0.tar.gz

Download URL querycontacts-1.1.0.tar.gz
Size 15.9 kB
Tags Source
SHA-256 checksum
How to use checksums
7874c09b1b9fc03b776d74db4c0e7bb0650b543e99b7252fcc2b5cc64529baf8
BLAKE2b-256 checksum
How to use checksums
1decd4e45fe858aee63d8b81495714ca63ce8bdfaf65275ca820a45f44741639
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.7

Release files / querycontacts-1.1.0-py2.py3-none-any.whl

Download URL querycontacts-1.1.0-py2.py3-none-any.whl
Size 16.2 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
d3e315b7d00a06b9a383a5c59721d21813d83bf35c237533d721d92ce11ef276
BLAKE2b-256 checksum
How to use checksums
414deb335f915d70a7c4ddc3bdcc2a98d9335896540cd1901d0eca2702b93caa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.7

Release history Release notifications | RSS feed

2.0.0

2 release files

1.1.1

2 release files

This release

1.1.0 This release

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.2.1

1 release file

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page