dependencies setuptools unittest2 python 2.6

hanzo warc tools:

warcvalid.py
    returns 0 if the arguments are all valid arc/warc files
    non zero on error 

warcdump.py - writes human readable summary of warcfiles:
    usage: python warcdump.py foo.warc foo.warc.gz
    autodetects input format when filenames are passed
    i.e recordgzip vs plaintext, warc vs arc

    assumes uncompressed warc on stdin if no args

warcfilter.py 
    python warcfilter.py pattern file file file
        searches all headers for regex pattern
    use -i to invert search
    use -U to constrain to url
    use -T to constrain to record type
    use -C to constrain to content-type

    autodetects and stdin like warcdump

    prints out a warc format by default.

warc2warc.py:
    python warc2warc <input files>

    autodetects compression on file
    args, assumes uncompressed stdin if none

    use -Z to write compressed output

    i.e warc2warc -Z input > input.gz

    should ignore buggy records in input

arc2warc.py
    creates a crappy warc file from arc files on input
    a handful of headers are preserved
    use -Z to write compressed output
    i.e arc2warc -Z input.arc > input.warc.gz

warcindex.py
    spits out an index like this:

WARC filename offset warc-type warc-subject-uri warc-record-id content-type content-length

warccrap/mywarc.warc 1196018 request /images/slides/hanzomarkmwwwoh.pdf urn:uuid:fd1255a8-d07c-11df-b125-12313b0a18c6 application/http;msgtype=request 193 warccrap/mywarc.warc 1196631 response http://www.hanzoarchives.com/images/slides/hanzomarkm__wwwoh.pdf urn:uuid:fd2614f8-d07c-11df-b125-12313b0a18c6 application/http;msgtype=response 3279474 not great, but a start

notes:

arc2warc uses the conversion rules from the earlier arc2warc.c
as a starter for converting the headers

I haven't profiled the code yet (and don't plan to until it falls over)

warcvalid barely skirts some of the iso standard:
    missing things: strict whitespace, required headers check...
mime quoted printable header encoding
treating headers as utf8

things left to do (in no order): lots more testing. supporting pre 1.0 warc files add more documentation support more commandline options for output and filenames s3 urls

-- tef thomas.figg@hanzoarchives.com