djbdns/dnscache.py: de-indent a block that doesn't need to be guarded.

djbdns/*.py: add module docstrings.

djbdns/io.py: handle nonexistent Popen stdin/stdout.

Type annotations say that this is possible, so... just quit if it
happens?

djbdns/*.py: capitalize global variables.

djbdns/{dnscache,tinydns}.py: explicit imports from djbdns.common.

djbdns/*.py: don't clobber id() and type() built-ins.

djbdns/{dnscache,tinydns}.py: don't clobber the global compile().

djbdns/common.py: assume IPv6 if an address isn't IPv4.

In other words, probably crash if convert_ip() is fed garbage. That's
OK. We could check the length of the hex string and raise a ValueError
if it isn't 8 or 32, but we might be solving problems that don't exist.

djbdns/io.py: use Popen's context manager to clean up.

bin/djbdns-logparse: avoid clobbering exit() with sys.exit().

djbdns/dnscache.py: improve two comments.

doc/man1/djbdns-logparse.1: document dnscache transformations.

doc/man1/djbdns-logparse.1: add tinydns-by-filename example.

djbdns/io.py: handle BrokenPipeError in parse_logfile().

This avoids a (harmless) crash when the output of djbdns-logparse is
piped to a process (such as head/tail) that closes the pipe before
djbdns-logparse is done writing to it.

bin/djbdns-logparse: handle SIGINT (again).

I removed the KeyboardInterrupt handler from the original program and
have now put it back as an async handler for SIGINT. This is helpful
when the user accidentally starts the program with no arguments and it
just sits there until he hits Ctrl-C (which would previously have
shown a stack trace).

doc/man1/djbdns-logparse.1: finish the tinydns transformation docs.

setup.py,doc/*: shorten the programs description by a few characters.

doc/man1/djbdns-logparse.1: utilize some fancy groff_man macros.

doc/man1/djbdns-logparse.1: start a man page.

djbdns/dnscache.py: add docstring for decode_type().

doc/README: mention usage and tests.

*/*: reorganize for easy testing using setuptools or tox.

Now running either,

  $ python setup.py test

or

  $ tox

will execute the test suite. (The former is deprecated, but is easier
for now, and most importantly doesn't require tox.)

setup.py: add keywords.

*/*: refactor into a driver program and a library.

Now there are a few separate modules in a "djbdns" package, and the
djbdns-logparse executable that makes use of them contains only what
the main() function used to.

bin/djbdns-logparse.py: add a dosctring for decode_serial().

bin/djbdns-logparse.py: improve existing decode_* docs.

bin/djbdns-logparse.py: add a docstring for decode_ttl().

bin/djbdns-logparse.py: make all docstrings raw to avoid surprises.

bin/djbdns-logparse.py: add a few more type hints where forgotten.

bin/djbdns-logparse.py: add docstring for decode_ip().

bin/djbdns-logparse.py: use a variable to simplify a string template.

bin/djbdns-logparse.py: remove unused time imports.

bin/djbdns-logparse.py: localize subprocess imports.

bin/djbdns-logparse.py: more docs for convert_ip().

bin/djbdns-logparse.py: add docstring for decode_client().

bin/djbdns-logparse.py: use f-strings for all string interpolation.

bin/djbdns-logparse.py: fix python3 integer division for txt records.

bin/djbdns-logparse.py: refactor handle_* types again.

Instead of using True/False to signal success after possibly using
print() to actually write the result, we not just return either the
processed string, or None.

bin/djbdns-logparse.py: add docstring for handle_dnscache_log().

bin/djbdns-logparse.py: more doctests for handle_tinydns_log().

bin/djbdns-logparse.py: move regex handling down a level.

It was a bit awkward to match a line against a regex, and then to have
to immediately pass that match object into a function that knows what
to do with it (to avoid duplicating work). Now the handle_tinydns_log()
and handle_dnscache_log() functions create the match object themselves,
and signal success or failure by returning a boolean.

bin/djbdns-logparse.py: add a docstring for main().

bin/djbdns-logparse.py: rework some of the tinydns logic.

bin/djbdns-logparse.py: add doctest for parse_logfile().

bin/djbdns-logparse.py: add comment about open file descriptors.

bin/djbdns-logparse.py: add docs for parse_logfile().

bin/djbdns-logparse.py: drop unused _cvt_ip()/_cvt_port() functions.

bin/djbdns-logparse.py: use f-strings for regex patterns; add comments.

bin/djbdns-logparse.py: add docs/examples for handle_tinydns_log().

bin/djbdns-logparse.py: fiddle with the convert_ip() comments.

bin/djbdns-logparse.py: add some newer type mappings.

I've added srv, naptr, dnskey, tlsa, https, and caa type mappings
based on what my own logs contain. Only SRV is actually supported by
tinydns. There are probably others in use today that will show up
eventually.

bin/djbdns-logparse.py: add .py extension and doctests for convert_ip().

Without the rename, "python -m doctest" isn't smart enough to figure
out that this thing is a python file.

doc/README: siphon the description and history from bin/djbdns-logparse.

bin/djbdns-logparse: only import sys.stdin within main().

bin/djbdns-logparse: remove unused warn() function.

bin/djbdns-logparse: fix line splitting in tinydns output.

bin/djbdns-logparse: use argparse for arg parse.

Initial commit, just starting to organize everything.