conversions were done using https://github.com/pennae/nix-doc-munge using (probably) rev f34e145 running nix-doc-munge nixos/**/*.nix nix-doc-munge --import nixos/**/*.nix the tool ensures that only changes that could affect the generated manual *but don't* are committed, other changes require manual review and are discarded.
73 lines
2.5 KiB
Nix
73 lines
2.5 KiB
Nix
{ config, lib, pkgs, ... }:
|
|
|
|
with lib;
|
|
|
|
let
|
|
cfg = config.services.offlineimap;
|
|
in {
|
|
|
|
options.services.offlineimap = {
|
|
enable = mkEnableOption (lib.mdDoc "OfflineIMAP, a software to dispose your mailbox(es) as a local Maildir(s)");
|
|
|
|
install = mkOption {
|
|
type = types.bool;
|
|
default = false;
|
|
description = lib.mdDoc ''
|
|
Whether to install a user service for Offlineimap. Once
|
|
the service is started, emails will be fetched automatically.
|
|
|
|
The service must be manually started for each user with
|
|
"systemctl --user start offlineimap" or globally through
|
|
{var}`services.offlineimap.enable`.
|
|
'';
|
|
};
|
|
|
|
package = mkOption {
|
|
type = types.package;
|
|
default = pkgs.offlineimap;
|
|
defaultText = literalExpression "pkgs.offlineimap";
|
|
description = lib.mdDoc "Offlineimap derivation to use.";
|
|
};
|
|
|
|
path = mkOption {
|
|
type = types.listOf types.path;
|
|
default = [];
|
|
example = literalExpression "[ pkgs.pass pkgs.bash pkgs.notmuch ]";
|
|
description = lib.mdDoc "List of derivations to put in Offlineimap's path.";
|
|
};
|
|
|
|
onCalendar = mkOption {
|
|
type = types.str;
|
|
default = "*:0/3"; # every 3 minutes
|
|
description = lib.mdDoc "How often is offlineimap started. Default is '*:0/3' meaning every 3 minutes. See systemd.time(7) for more information about the format.";
|
|
};
|
|
|
|
timeoutStartSec = mkOption {
|
|
type = types.str;
|
|
default = "120sec"; # Kill if still alive after 2 minutes
|
|
description = lib.mdDoc "How long waiting for offlineimap before killing it. Default is '120sec' meaning every 2 minutes. See systemd.time(7) for more information about the format.";
|
|
};
|
|
};
|
|
config = mkIf (cfg.enable || cfg.install) {
|
|
systemd.user.services.offlineimap = {
|
|
description = "Offlineimap: a software to dispose your mailbox(es) as a local Maildir(s)";
|
|
serviceConfig = {
|
|
Type = "oneshot";
|
|
ExecStart = "${cfg.package}/bin/offlineimap -u syslog -o -1";
|
|
TimeoutStartSec = cfg.timeoutStartSec;
|
|
};
|
|
path = cfg.path;
|
|
};
|
|
environment.systemPackages = [ cfg.package ];
|
|
systemd.user.timers.offlineimap = {
|
|
description = "offlineimap timer";
|
|
timerConfig = {
|
|
Unit = "offlineimap.service";
|
|
OnCalendar = cfg.onCalendar;
|
|
# start immediately after computer is started:
|
|
Persistent = "true";
|
|
};
|
|
} // optionalAttrs cfg.enable { wantedBy = [ "default.target" ]; };
|
|
};
|
|
}
|