def get_args(args=None, config_file_contents=None):
global arg
# Config file in /etc or the program directory
parser = configargparse.ArgumentParser(
auto_env_var_prefix="autoblockchainify_",
formatter_class=argparse.ArgumentDefaultsHelpFormatter,
description=
"autoblockchainify — Turn any directory into a GIT Blockchain.",
default_config_files=[
'/etc/autoblockchainify.conf',
os.path.join(os.getenv('HOME'), 'autoblockchainify.conf')
])
# General
parser.add_argument('--config-file',
'-c',
is_config_file=True,
help="config file path")
parser.add_argument('--debug-level',
default='INFO',
help="""amount of debug output: WARN, INFO, or DEBUG.
Debug levels for specific loggers can also be
specified using 'name=level'. Valid logger names:
`config`, `daemon`, `commit` (incl. requesting
timestamps), `gnupg`, `mail` (interfacing with PGP
Timestamping Server). Example: `DEBUG,gnupg=INFO`
sets the default debug level to DEBUG, except for
`gnupg`.""")
parser.add_argument('--version',
action='version',
version=autoblockchainify.version.VERSION)
# Identity
# Default is applied in daemon.py:finish_setup()
parser.add_argument('--identity',
help="""'Full Name <email@address>' for tagging
GIT commits.
Default (will only be applied to new repositories):
'Autoblockchainify <autoblockchainify@localhost>'.
An explicit value (non-default) will always update
the current GIT config.""")
# Stamping
parser.add_argument('--commit-interval',
default='10m',
help="how often to commit, if there have been changes")
parser.add_argument('--commit-offset',
help="""when to commit within that interval; e.g. after
7m19.3s. Default: Random choice in the interval,
avoiding the first/last 5%.""")
parser.add_argument('--force-after-intervals',
type=int,
default=6,
help="""After how many intervals to force a commit (and
request a timestamp by email, if configured).""")
parser.add_argument('--repository',
default='.',
help="""path to the GIT repository (default '.')""")
parser.add_argument('--zeitgitter-servers',
default='diversity gitta',
help="""any number of space-separated
Zeitgitter servers of the form
`[<branch>=]<server>`. The server name will
be passed with `--server` to `git timestamp`,
the (optional) branch name with `--branch`.""")
parser.add_argument('--zeitgitter-sleep',
default='0s',
help="""Delay between cross-timestamping for the
different timestampers""")
# Pushing
parser.add_argument('--push-repository',
default='',
help="""Space-separated list of repositores to push to;
setting this enables automatic push""")
parser.add_argument('--push-branch',
default='*',
help="""Space-separated list of branches to push.
`*` means all, as `--all` is eaten by ConfigArgParse"""
)
# PGP Digital Timestamper interface
parser.add_argument('--stamper-own-address',
'--mail-address',
'--email-address',
help="""our email address; enables
cross-timestamping from the PGP timestamper""")
parser.add_argument(
'--stamper-keyid',
'--external-pgp-timestamper-keyid',
default="70B61F81",
help="PGP key ID to obtain email cross-timestamps from")
parser.add_argument('--stamper-to',
'--external-pgp-timestamper-to',
default="*****@*****.**",
help="""destination email address
to obtain email cross-timestamps from""")
parser.add_argument('--stamper-from',
'--external-pgp-timestamper-from',
default="*****@*****.**",
help="""email address used by PGP timestamper
in its replies""")
parser.add_argument('--stamper-smtp-server',
'--smtp-server',
help="""SMTP server to use for
sending mail to PGP Timestamper""")
parser.add_argument('--stamper-imap-server',
'--imap-server',
help="""IMAP server to use for
receiving mail from PGP Timestamper""")
parser.add_argument('--stamper-username',
'--mail-username',
help="""username to use for IMAP and SMTP
(default from `--stamper-own-address`)""")
parser.add_argument('--stamper-password',
'--mail-password',
help="password to use for IMAP and SMTP")
parser.add_argument('--no-dovecot-bug-workaround',
action='store_true',
help="""Some Dovecot mail server seem unable to match
the last char of an email address in an IMAP
SEARCH, so this cuts off the last char from
`stamper-from`. Should not impact other mail
servers.""")
arg = parser.parse_args(args=args,
config_file_contents=config_file_contents)
for level in str(arg.debug_level).split(','):
if '=' in level:
(logger, lvl) = level.split('=', 1)
else:
logger = None # Root logger
lvl = level
try:
lvl = int(lvl)
lvl = signale.WARNING - lvl * (signale.WARNING - signale.INFO)
except ValueError:
pass
signale.set_threshold(logger, lvl)
if arg.stamper_username is None:
arg.stamper_username = arg.stamper_own_address
if arg.force_after_intervals < 2:
sys.exit("--force-after-intervals must be >= 2")
arg.commit_interval = deltat.parse_time(arg.commit_interval)
if arg.stamper_own_address is None:
if arg.commit_interval < datetime.timedelta(minutes=1):
sys.exit("--commit-interval may not be shorter than 1m")
else:
if arg.commit_interval * arg.force_after_intervals < datetime.timedelta(
minutes=10):
sys.exit("--commit-interval times --force-after-intervals may "
"not be shorter than 10m when using the (mail-based) "
"PGP Digital Timestamping Service")
if arg.commit_offset is None:
# Avoid the seconds around the full interval, to avoid clustering
# with other system activity.
arg.commit_offset = arg.commit_interval * random.uniform(0.05, 0.95)
logging.info("Chose --commit-offset %s" % arg.commit_offset)
else:
arg.commit_offset = deltat.parse_time(arg.commit_offset)
if arg.commit_offset < datetime.timedelta(seconds=0):
sys.exit("--commit-offset must be positive")
if arg.commit_offset >= arg.commit_interval:
sys.exit("--commit-offset must be less than --commit-interval")
arg.zeitgitter_sleep = deltat.parse_time(arg.zeitgitter_sleep)
# Work around ConfigArgParse list bugs by implementing lists ourselves
arg.zeitgitter_servers = arg.zeitgitter_servers.split()
arg.push_repository = arg.push_repository.split()
# and working around the problem that values cannot start with `-`.
if arg.push_branch == '*':
arg.push_branch = ['--all']
else:
arg.push_branch = arg.push_branch.split()
if not arg.no_dovecot_bug_workaround:
arg.stamper_from = arg.stamper_from[:-1] # See help text
logging.success("Settings applied: %s" % str(arg), level=signale.DEBUG)
return arg
def float_test():
parse_time("1..3s")
def space_test():
parse_time(" 1.0s ")
def order_test():
parse_time("1s 3m 5d")
def check_delta(s, td):
assert parse_time(s) == td