The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

scm-digest - Send repository commit digest emails

SYNOPSIS

scm-digest [ options ]

Options:

--conf {config}  Set configuration path (defaults to /etc/scm-digest.conf)
--update         Initialise and update local repositories
--get-email      Print digest email to standard output
--from {time}    Only include commits made after this time in digest
--to {time}      Only include commits made before this time in digest

Time format is '%Y-%m-%dT%H:%M:%S', e.g. '2000-12-25T22:00:00'.

The configuration file must be in YAML format. Options that may be specified are as follows:

db_path:          /path/to/db
repository_path:  /path/to/local/repositories
timezone:         UTC
ignore_errors:    0
headers:
  From: From Address <from@example.org>
  To:   To Address <to@example.org>
  ...
repositories:
  - name: test
    url: http://example.org/path/to/repository
    type: [git|hg]
  - name: local-test
    url: file:///path/to/repository
    type: [git|hg]
    ...

db_path, repository_path, and repositories are mandatory options.

timezone is optional, and defaults to 'UTC'. See DateTime::TimeZone::Catalog for a list of valid timezones.

ignore_errors is an optional boolean, and defaults to false. If false, errors will cause the process to abort immediately. If true, errors will instead be printed to stderr, and the process will continue onto the next repository.