home-manager/modules/services/taskwarrior-sync.nix

{ config, lib, pkgs, ... }:

with lib;

let

  cfg = config.services.taskwarrior-sync;

in {
  meta.maintainers = with maintainers; [ minijackson pacien ];

  options.services.taskwarrior-sync = {
    enable = mkEnableOption "Taskwarrior periodic sync";

    package =
      mkPackageOption pkgs "taskwarrior" { example = "pkgs.taskwarrior3"; };

    frequency = mkOption {
      type = types.str;
      default = "*:0/5";
      description = ''
        How often to run `taskwarrior sync`. This
        value is passed to the systemd timer configuration as the
        `OnCalendar` option. See
        {manpage}`systemd.time(7)`
        for more information about the format.
      '';
    };
  };

  config = mkIf cfg.enable {
    assertions = [
      (lib.hm.assertions.assertPlatform "services.taskwarrior-sync" pkgs
        lib.platforms.linux)
    ];

    systemd.user.services.taskwarrior-sync = {
      Unit = { Description = "Taskwarrior sync"; };
      Service = {
        CPUSchedulingPolicy = "idle";
        IOSchedulingClass = "idle";
        ExecStart = "${cfg.package}/bin/task synchronize";
      };
    };

    systemd.user.timers.taskwarrior-sync = {
      Unit = { Description = "Taskwarrior periodic sync"; };
      Timer = {
        Unit = "taskwarrior-sync.service";
        OnCalendar = cfg.frequency;
      };
      Install = { WantedBy = [ "timers.target" ]; };
    };
  };
}