Skip to main content

Sopel plugin .ip command:

16:22 <SnoopJ> !ip 8.8.8.8
16:22 <testibot> [IP/Host Lookup] Downloading GeoIP database, please wait...
16:22 <testibot> [IP/Host Lookup] Hostname: dns.google | Location: United States | ISP: AS15169 GOOGLE

Install

The recommended way to install this plugin is to use pip:

$ pip install sopel-iplookup

Note that this plugin requires Python 3.7+ and Sopel 7.1+. It won’t work on Python versions that are not supported by the version of Sopel you are using.

Configure

sopel-iplookup can be configured by invoking Sopel’s interactive wizard:

$ sopel-plugins configure iplookup
Configure Sopel GeoIP Lookup Plugin
Please consult sopel-iplookup's README to learn about its settings.

Path to existing GeoIP db files (leave empty to auto download):
MaxMind license key (optional): (hidden input)

By default, sopel-iplookup will look in a few standard locations for GeoIP database files. If it can’t find existing database files, it will download them from an automated mirror on GitHub.

You can optionally provide your own MaxMind license key, and the plugin will download directly from them instead. Alternatively, if your OS distribution already has GeoIP database files kept up-to-date by the system package manager, you can provide the path where those files are stored.

Notes

This plugin replaces a built-in Sopel plugin formerly called ip, you may need to update your bot configuration to replace ip with iplookup if you are e.g. excluding this plugin.

Changelog

1.1.0

  • plugin, config: add config field for MaxMind license key (#4, #5)
    • If no MaxMind key is provided, the plugin will download from a mirror of the .mmdb files on GitHub. With a license key, the plugin downloads directly from MaxMind.

  • plugin: slightly better logging during/after DB downloads

  • meta: add automated release workflow using PyPI Trusted Publishing (#7)

1.0.0

Initial release. Replaces ip plugin formerly shipped as part of sopel.

Metadata

Release files for sopel-iplookup 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 sopel-iplookup 1.1.0
File Size Uploaded
sopel_iplookup-1.1.0.tar.gz 6.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for sopel-iplookup 1.1.0
File Interpreter ABI Platform
sopel_iplookup-1.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 14.3 kB

Release files / sopel_iplookup-1.1.0.tar.gz

Download URL sopel_iplookup-1.1.0.tar.gz
Size 6.8 kB
Tags Source
SHA-256 checksum
How to use checksums
c3386999bb131d0d507e70151503a644a20ed658accb221c13c06b69f6865c8d
BLAKE2b-256 checksum
How to use checksums
40d4515fe802850bf219e0952817ece3ae3fa9b7b3c69b324afd611869a1a062
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.0.0 CPython/3.12.4

Release files / sopel_iplookup-1.1.0-py3-none-any.whl

Download URL sopel_iplookup-1.1.0-py3-none-any.whl
Size 7.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ade6974c15aa895e849353e8a05fded2ec054caae462c15d43ead11ea5d33c9d
BLAKE2b-256 checksum
How to use checksums
036cb5729eb97578364cecbec1e36d9d2a4f6f635de240ec137195b5ce4837a9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.0.0 CPython/3.12.4

Release history Release notifications | RSS feed

This release

1.1.0 This release

2 release files

1.0.0

2 release files

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