Skip to main content

IP to ASN routing data query script

Project description

aslookup

Python client for IP to ASN lookup services

aslookup is a client utility for two of the public IP/AS query services operated by the following organizations:

The client implements both a simple Python module (aslookup) as well as a CLI utility (as-lookup). The lookups are currently done using DNS, which works well for a one-off lookups. It is not optimized for bulk lookups over the Whois protocol.

Currently only IPv4 addresses are looked up. The client also maintains a listing of IP networks which are unroutable internet addresses, typically special use ranges in RFCs. In this way it can both filter out addresses from queries which are a waste of time, as well as provide context to the user on the address.

Installation

The app has been tested on Python 3.

It's best to install the program into a Python virtualenv. If you will only use the command line interface, the recommended way to install it is using pipx:

pipx install aslookup

If you will use aslookup as a library, you'll instead want to install it using pip in your target Python environment:

python3 -m pip install aslookup

Usage

Python module

The Python module defaults to querying the Team Cymru data service. The desired service may be specified by passing the service parameter to get_as_data.

from aslookup import get_as_data
ip = "8.8.8.8"
get_as_data(ip, service="shadowserver")

CLI script

It is possible to provide multiple IP addresses as arguments to the script, or to send them as a list on standard input, in which cases the script loops over them and returns output on separate lines. When providing invalid IPv4 addresses as arguments, the script reports the problem on standard error and exits with an error. When providing input on stdin, the error is reported on standard output but execution is not aborted.

as-lookup 8.8.8.8 9.9.9.9

or:

as-lookup < ipaddrs.txt

Test data

A list of test values for the script is included in the file tests/test_input.txt. This can be useful to validate included IP prefix classifications and see the output format.

as-lookup < tests/test_input.txt

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

aslookup-1.6.1.tar.gz (8.1 kB view details)

Uploaded Source

Built Distribution

aslookup-1.6.1-py2.py3-none-any.whl (8.6 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file aslookup-1.6.1.tar.gz.

File metadata

  • Download URL: aslookup-1.6.1.tar.gz
  • Upload date:
  • Size: 8.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.10.12

File hashes

Hashes for aslookup-1.6.1.tar.gz
Algorithm Hash digest
SHA256 56d93fe46e962301df32aace42f6a9a62a7491d6329f102c5652081350784ac1
MD5 22c0dad15082a61949f9b9d81491808e
BLAKE2b-256 1b1f9509458ece05b8368706055f7f61f346fc6f5071de95bc7a1af99aeb7984

See more details on using hashes here.

File details

Details for the file aslookup-1.6.1-py2.py3-none-any.whl.

File metadata

  • Download URL: aslookup-1.6.1-py2.py3-none-any.whl
  • Upload date:
  • Size: 8.6 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.10.12

File hashes

Hashes for aslookup-1.6.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 140f0772eb17d4786c38969ec56a50ab81dd31bf93a2d2a9a01fefe0fe8e507e
MD5 db6fd8982a52db90d3750740f647b169
BLAKE2b-256 a7025fa423c7d06e767811a5df86324baf6d5c3f9d4c5cb76c399748072a4122

See more details on using hashes here.

Supported by

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