Skip to main content

Query network abuse contacts on the command-line for a given ip address on abuse-contacts.abusix.org

Project description

[![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

ahocorapy is a pure python implementation of the Aho-Corasick Algorithm.
Given a list of keywords one can check if at least one of the keywords exist in a given text in linear time.

## 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.org
--version show program's version number and exit
```

### Examples

Show version:

```
$ querycontacts --version
querycontacts 1.0.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']
```

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

querycontacts-1.0.0.tar.gz (15.9 kB view details)

Uploaded Source

Built Distribution

querycontacts-1.0.0-py3-none-any.whl (5.8 kB view details)

Uploaded Python 3

File details

Details for the file querycontacts-1.0.0.tar.gz.

File metadata

File hashes

Hashes for querycontacts-1.0.0.tar.gz
Algorithm Hash digest
SHA256 241cdeb40952ae1877dad3c4f4a09cdc491f161750d2843a8b1c5391fd2a6e3e
MD5 579e9b15c796b2f80c36257ba1f37ede
BLAKE2b-256 41ff9a53410517fe7cae5767aec4a04eddb2c0f907c66df6c8164ebdc6f04c17

See more details on using hashes here.

File details

Details for the file querycontacts-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for querycontacts-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a8c98b14cddd2c9cedd3763c9a3db20210a1ec2201cca61a2dd2895edd2445b6
MD5 0f51579f726eb264ccfa20bfc36fb2b0
BLAKE2b-256 fe0eaecedba03d7a0573717004d4f1fded5f30269b6b094e8f9c323d33b38d22

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page