X-Git-Url: https://gitweb.michael.orlitzky.com/?a=blobdiff_plain;f=doc%2FREADME;h=54e77e299a9ec609a00c3ff8cb501ed7b7d15c47;hb=c965f2fea1788a7faba2c67a4f05c27d5c34373b;hp=07e52b3065531876747228e9d50c967a50b0dc8d;hpb=c15dd1fe414f6c26f692d327362021dcf26081c0;p=djbdns-logparse.git diff --git a/doc/README b/doc/README index 07e52b3..54e77e2 100644 --- a/doc/README +++ b/doc/README @@ -1,4 +1,4 @@ -djbdns-logparse: convert tinydns and dnscache logs to human-readable form +djbdns-logparse: make tinydns and dnscache logs human-readable == What is it? == @@ -21,6 +21,17 @@ read. The line above gets turned into, and surely you agree that this is preferable. +== Usage == + +Either, + + $ djbdns-logparse < logfile + +or + + $ djbdns-logparse log1 [log2 [log3 ...]] + + == Requirements == There are only two: @@ -44,3 +55,18 @@ with heavy assistance from Rob Mayoff's documentation: * https://www.dqd.com/~mayoff/notes/djbdns/tinydns-log.html * https://www.dqd.com/~mayoff/notes/djbdns/dnscache-log.html + + +== Tests == + +The (doctest) test suite can be run with either setuptools, + + $ python setup.py test + +or using tox, + + $ tox + +Or, you can just run them manually: + + $ python -m doctest -v djbdns/*.py