Introduction

Usage: dump_mailman.py [options] archive_url

Options:
  --begindate=DATE      Date to begin retrieving messages [default: oldest]
  --enddate=DATE        Date to finish retrieving messages [default: now]
  --create              create destination mailbox [default: False]
  --destformat=FORMAT   format of destination mailbox [default: maildir]
  -v LEVEL, --verbosity=LEVEL
                        level of verbosity [default: 20 {'INFO': 20,
                        'CRITICAL': 50, 'WARN': 30, 'WARNING': 30, 'ERROR':
                        40, 'DEBUG': 10, 'NOTSET': 0}]
  -l LOGFILE, --logfile=LOGFILE
                        file to log progress, errors to [default: console-
                        only]
  --logformat=FORMAT    format of logged messages [default: "%(asctime)s:
                        %(levelname)s %(message)s"]
  --logdatefmt=FORMAT   date format for log message timestamps
  --version             show program's version number and exit
  -h, --help            show this help message and exit

Time Formats

The --begindate and --enddate options take a time string, which can be given in any of several formats:

1. the string "now" (refers to the current time)
2. a sequences of digits, like "123456890" (indicating the time in seconds after the epoch)
3. A string like "2002-01-25T07:00:00+02:00" in datetime format
• The "+02:00" section means the time zone is 2 hours ahead of UTC.
• w3 datetime format as described in a w3 note at http://www.w3.org/TR/NOTE-datetime
4. An interval, which is a number followed by one of the characters s, m, h, D, W, M, or Y (indicating seconds, minutes, hourse, days, weeks, months, or years respectively), or a series of such pairs. In this case the string refers to the time that preceded the current time by the length of the interval. For instance, "1h78m" indicates the time that was one hour and 78 minutes ago. The calendar here is unsophisticated: a month is always 30 days, a year is always 365 days, and a day is always 86400 seconds.
5. A date format of the form YYYY/MM/DD, YYYY-MM-DD, MM/DD/YYYY, or MM/DD/YYYY, which indicates midnight on the day in question, relative to the current timezone settings. For instance, "2002/3/5", "03-05-2002", and "2002-3-05" all mean March 5th, 2002.