Skip to main content

A DNS lookup plugin for Sopel IRC bots

Project description

sopel-dns

A DNS lookup plugin for Sopel IRC bots

Requirements

  • Sopel 7.1+
  • dnspython 2.x
  • Python 3.6+

Usage

Basic usage performs an 'A' record lookup:

<user> .dns domain.tld
<bot>  user: 10.10.0.1

To look up IPv6 addresses instead, specify the 'AAAA' record type:

<user> .dns domain.tld AAAA
<bot>  user: fd12:3456:789a:1::1

Other supported record types output their results in a similar fashion. Some types, such as MX and TXT, split the output across multiple lines to make it easier to read, at the cost of possible "spam" if there are many records attached to the queried domain.

Rate limiting

Normal users are rate-limited to one .dns command every 2 minutes, both to control channel flood and to prevent hammering whatever DNS server Sopel's host system uses to resolve the submitted queries.

Supported DNS record types

  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • PTR
  • TXT

If a record type you want isn't listed here, feel free to request it in an issue. Even better: a pull request enabling that record type, including a demo of the resulting output.

Version 0.4.0

Now requires Sopel 7.1, but also works on (upcoming) Sopel 8.0.

Version 0.3.1

Tightened dnspython requirement vs. Sopel's own. This plugin now requires Python 3.6+ (because that's what dnspython 2.x supports).

Version 0.3.0

Added [dns] output prefix. This also meant changing most of the plugin's output from replies to normal "say", which is fine. The flood of HLs from looking up stuff like MX or TXT records could get annoying.

Rate limit has been reduced from 5 minutes to 2 minutes.

Version 0.2.1

Fixed error when a DNS query has no answer (no results).

Version 0.2.0

Added support for choosing DNS record type to look up. Currently understands A, AAAA, CNAME, MX, NS, PTR (for IP addresses only), and TXT.

Version 0.1.0

Initial release with support for querying a domain's A records.

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

sopel-dns-0.4.0.tar.gz (4.4 kB view hashes)

Uploaded Source

Built Distribution

sopel_dns-0.4.0-py3-none-any.whl (4.3 kB view hashes)

Uploaded Python 3

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