dgw / sopel-dns

DNS lookup plugin for Sopel IRC bots

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

sopel-dns

A DNS lookup plugin for Sopel IRC bots

Installing

Releases are hosted on PyPI, so after installing Sopel, all you need is pip:

$ pip install sopel-dns

Requirements

  • Python 3.8+
  • Sopel 8.0+
  • dnspython 2.x

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.

About

DNS lookup plugin for Sopel IRC bots

License:Other


Languages

Language:Python 100.0%