wheneverd 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ff946dbc0ba39d3e90ecf3cbed4c9ea81c1818fcd1d206f00cf6763dfe05ebe1
-  data.tar.gz: cd42856421c97365ff63547252ea4e8ba8a5f17dc822eea8af67b45ce8861b8f
+  metadata.gz: 9469e813aa6390a8e7eb911ce672a9fdaf7ab861e435d71d2d8887d551f8b8f8
+  data.tar.gz: dcf0211fe96fe0faff489a82ab3d0f12f36c3703083a949606eed4ab8eb9fa28
 SHA512:
-  metadata.gz: a4d31fc560c96e1b10b7b42cb0c32e4aa222823e64bde6a17cacb891246d67caefb9e42b5f71ce23a26b14392c33eb819f42fc3e199a0b2f10a0f040bb5e5193
-  data.tar.gz: fc2e7a43ed41af1b7b00cb4cc8a228054071cec67ca53bb81829134ab884f8a6b5730796a699bdd6066262d3fee18ff0234f535d2fe967b5d26543d2d7b2097e
+  metadata.gz: 4a448263264d7322c6622d111f5bf2f51f916ee0dc22193388e4b8b15a4336c3d136c475102db7c772b5be35fd53fa3800fcb733ef3850d620e982baeb9fa9a9
+  data.tar.gz: 62aad81a000a60510e6b230660321ec40951ecdcaed1317517f33fa10688fa319aa2afc43f8b003704b364d0f0f68a1d12e95482dce408208269a400ebee9a87

data/.ruby-version

@@ -0,0 +1 @@
+4.0.3

data/CHANGELOG.md

@@ -5,6 +5,12 @@ On release, entries are moved into `## x.y.z` sections that match the gem versio
 
 ## Unreleased
 
+## 0.5.0
+
+- Adds top-level `service` DSL entries for long-running systemd user services.
+- `activate`, `deactivate`, `reload`, and `status` now manage standalone services alongside timers.
+- Standalone services render as `Type=simple` units with configurable `Restart=`, `RestartSec=`, and extra `[Service]` settings.
+
 ## 0.4.0
 
 - Docs: adds a copy/paste "deploy a simple schedule" example and refines README status section.

data/Gemfile.lock

@@ -1,61 +1,64 @@
 PATH
   remote: .
   specs:
-    wheneverd (0.3.0)
+    wheneverd (0.5.0)
       clamp (~> 1.3)
 
 GEM
   remote: https://rubygems.org/
   specs:
     ast (2.4.3)
-    clamp (1.3.2)
+    clamp (1.5.2)
     date (3.5.1)
     docile (1.4.1)
-    erb (6.0.1)
+    drb (2.2.3)
+    erb (6.0.4)
     io-console (0.8.2)
-    irb (1.16.0)
+    irb (1.18.0)
       pp (>= 0.6.0)
+      prism (>= 1.3.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
-    json (2.18.0)
+    json (2.19.4)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
-    minitest (6.0.1)
+    minitest (6.0.5)
+      drb (~> 2.0)
       prism (~> 1.5)
-    parallel (1.27.0)
-    parser (3.3.10.0)
+    parallel (2.1.0)
+    parser (3.3.11.1)
       ast (~> 2.4.1)
       racc
     pp (0.6.3)
       prettyprint
     prettyprint (0.2.0)
-    prism (1.7.0)
+    prism (1.9.0)
     psych (5.3.1)
       date
       stringio
     racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.3.1)
-    rdoc (7.1.0)
+    rake (13.4.2)
+    rdoc (7.2.0)
       erb
       psych (>= 4.0.0)
       tsort
     redcarpet (3.6.1)
-    regexp_parser (2.11.3)
+    regexp_parser (2.12.0)
     reline (0.6.3)
       io-console (~> 0.5)
-    rubocop (1.82.1)
+    rubocop (1.86.1)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
-      parallel (~> 1.10)
+      parallel (>= 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.48.0, < 2.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.49.0)
+    rubocop-ast (1.49.1)
       parser (>= 3.3.7.2)
       prism (~> 1.7)
     ruby-progressbar (1.13.0)
@@ -70,7 +73,7 @@ GEM
     unicode-display_width (3.2.0)
       unicode-emoji (~> 4.1)
     unicode-emoji (4.2.0)
-    yard (0.9.38)
+    yard (0.9.43)
 
 PLATFORMS
   ruby
@@ -89,31 +92,33 @@ DEPENDENCIES
 
 CHECKSUMS
   ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
-  clamp (1.3.2) sha256=4f6a99a8678d51abbf1650263a74d1ac50939edc11986271431d2e03a0d7a022
+  bundler (4.0.11) sha256=5bcec0fb78302e48d02ee46f10ee6e6942be647ba5b44a6d1ddfda9a240ce785
+  clamp (1.5.2) sha256=2fed212e5c9b60447eb5097af39d4c12c3c7e6788e8d791e9c436e0e755f4adc
   date (3.5.1) sha256=750d06384d7b9c15d562c76291407d89e368dda4d4fff957eb94962d325a0dc0
   docile (1.4.1) sha256=96159be799bfa73cdb721b840e9802126e4e03dfc26863db73647204c727f21e
-  erb (6.0.1) sha256=28ecdd99c5472aebd5674d6061e3c6b0a45c049578b071e5a52c2a7f13c197e5
+  drb (2.2.3) sha256=0b00d6fdb50995fe4a45dea13663493c841112e4068656854646f418fda13373
+  erb (6.0.4) sha256=38e3803694be357fe2bfe312487c74beaf9fb4e5beb3e22498952fe1645b95d9
   io-console (0.8.2) sha256=d6e3ae7a7cc7574f4b8893b4fca2162e57a825b223a177b7afa236c5ef9814cc
-  irb (1.16.0) sha256=2abe56c9ac947cdcb2f150572904ba798c1e93c890c256f8429981a7675b0806
-  json (2.18.0) sha256=b10506aee4183f5cf49e0efc48073d7b75843ce3782c68dbeb763351c08fd505
+  irb (1.18.0) sha256=de9454a0703a54704b9811a5ef31a60c86949fbf4013fcf244fabc7c775248e3
+  json (2.19.4) sha256=670a7d333fb3b18ca5b29cb255eb7bef099e40d88c02c80bd42a3f30fe5239ac
   language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
   lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
-  minitest (6.0.1) sha256=7854c74f48e2e975969062833adc4013f249a4b212f5e7b9d5c040bf838d54bb
-  parallel (1.27.0) sha256=4ac151e1806b755fb4e2dc2332cbf0e54f2e24ba821ff2d3dcf86bf6dc4ae130
-  parser (3.3.10.0) sha256=ce3587fa5cc55a88c4ba5b2b37621b3329aadf5728f9eafa36bbd121462aabd6
+  minitest (6.0.5) sha256=f007d7246bf4feea549502842cd7c6aba8851cdc9c90ba06de9c476c0d01155c
+  parallel (2.1.0) sha256=b35258865c2e31134c5ecb708beaaf6772adf9d5efae28e93e99260877b09356
+  parser (3.3.11.1) sha256=d17ace7aabe3e72c3cc94043714be27cc6f852f104d81aa284c2281aecc65d54
   pp (0.6.3) sha256=2951d514450b93ccfeb1df7d021cae0da16e0a7f95ee1e2273719669d0ab9df6
   prettyprint (0.2.0) sha256=2bc9e15581a94742064a3cc8b0fb9d45aae3d03a1baa6ef80922627a0766f193
-  prism (1.7.0) sha256=10062f734bf7985c8424c44fac382ac04a58124ea3d220ec3ba9fe4f2da65103
+  prism (1.9.0) sha256=7b530c6a9f92c24300014919c9dcbc055bf4cdf51ec30aed099b06cd6674ef85
   psych (5.3.1) sha256=eb7a57cef10c9d70173ff74e739d843ac3b2c019a003de48447b2963d81b1974
   racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f
   rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
-  rake (13.3.1) sha256=8c9e89d09f66a26a01264e7e3480ec0607f0c497a861ef16063604b1b08eb19c
-  rdoc (7.1.0) sha256=494899df0706c178596ca6e1d50f1b7eb285a9b2aae715be5abd742734f17363
+  rake (13.4.2) sha256=cb825b2bd5f1f8e91ca37bddb4b9aaf345551b4731da62949be002fa89283701
+  rdoc (7.2.0) sha256=8650f76cd4009c3b54955eb5d7e3a075c60a57276766ebf36f9085e8c9f23192
   redcarpet (3.6.1) sha256=d444910e6aa55480c6bcdc0cdb057626e8a32c054c29e793fa642ba2f155f445
-  regexp_parser (2.11.3) sha256=ca13f381a173b7a93450e53459075c9b76a10433caadcb2f1180f2c741fc55a4
+  regexp_parser (2.12.0) sha256=35a916a1d63190ab5c9009457136ae5f3c0c7512d60291d0d1378ba18ce08ebb
   reline (0.6.3) sha256=1198b04973565b36ec0f11542ab3f5cfeeec34823f4e54cebde90968092b1835
-  rubocop (1.82.1) sha256=09f1a6a654a960eda767aebea33e47603080f8e9c9a3f019bf9b94c9cab5e273
-  rubocop-ast (1.49.0) sha256=49c3676d3123a0923d333e20c6c2dbaaae2d2287b475273fddee0c61da9f71fd
+  rubocop (1.86.1) sha256=44415f3f01d01a21e01132248d2fd0867572475b566ca188a0a42133a08d4531
+  rubocop-ast (1.49.1) sha256=4412f3ee70f6fe4546cc489548e0f6fcf76cafcfa80fa03af67098ffed755035
   ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
   simplecov (0.22.0) sha256=fe2622c7834ff23b98066bb0a854284b2729a569ac659f82621fc22ef36213a5
   simplecov-html (0.13.2) sha256=bd0b8e54e7c2d7685927e8d6286466359b6f16b18cb0df47b508e8d73c777246
@@ -122,8 +127,8 @@ CHECKSUMS
   tsort (0.2.0) sha256=9650a793f6859a43b6641671278f79cfead60ac714148aabe4e3f0060480089f
   unicode-display_width (3.2.0) sha256=0cdd96b5681a5949cdbc2c55e7b420facae74c4aaf9a9815eee1087cb1853c42
   unicode-emoji (4.2.0) sha256=519e69150f75652e40bf736106cfbc8f0f73aa3fb6a65afe62fefa7f80b0f80f
-  wheneverd (0.3.0)
-  yard (0.9.38) sha256=721fb82afb10532aa49860655f6cc2eaa7130889df291b052e1e6b268283010f
+  wheneverd (0.5.0)
+  yard (0.9.43) sha256=cf8733a8f0485df2a162927e9b5f182215a61f6d22de096b8f402c726a1c5821
 
 BUNDLED WITH
-  4.0.3
+  4.0.11

data/README.md

@@ -167,7 +167,7 @@ Schedules are defined in a Ruby file (default: `config/schedule.rb`) and evaluat
 
 Note: schedule files are executed as Ruby. Do not run untrusted schedule code.
 
-The core shape is:
+The core timer shape is:
 
 ```ruby
 every(period, at: nil) do
@@ -175,6 +175,20 @@ every(period, at: nil) do
 end
 ```
 
+Long-running services can be managed from the same schedule with top-level
+`service` entries:
+
+```ruby
+service "worker",
+        shell: "bundle exec bin/worker",
+        restart: "always",
+        restart_sec: "5s",
+        service: {
+          "WorkingDirectory" => "/srv/apps/myapp/current",
+          "Environment" => "RAILS_ENV=production"
+        }
+```
+
 For calendar schedules, you can also pass multiple period symbols (or an array) to run the same jobs on multiple days:
 
 ```ruby
@@ -270,14 +284,14 @@ Commands:
 
 - `wheneverd init [--schedule PATH] [--force]` writes a template schedule file.
 - `wheneverd show [--schedule PATH] [--identifier NAME]` prints rendered units to stdout.
-- `wheneverd status [--identifier NAME] [--unit-dir PATH]` prints `systemctl --user list-timers` and `systemctl --user status` for installed timers.
+- `wheneverd status [--identifier NAME] [--unit-dir PATH]` prints `systemctl --user list-timers` and `systemctl --user status` for installed timers/services.
 - `wheneverd diff [--schedule PATH] [--identifier NAME] [--unit-dir PATH]` diffs rendered units vs unit files on disk.
 - `wheneverd validate [--schedule PATH] [--identifier NAME] [--verify]` validates rendered `OnCalendar=` values via `systemd-analyze calendar` (and with `--verify`, runs `systemd-analyze --user verify` on temporary unit files).
 - `wheneverd write [--schedule PATH] [--identifier NAME] [--unit-dir PATH] [--dry-run] [--[no-]prune]` writes units to disk (or prints paths in `--dry-run` mode).
 - `wheneverd delete [--identifier NAME] [--unit-dir PATH] [--dry-run]` deletes previously generated units for the identifier.
-- `wheneverd activate [--schedule PATH] [--identifier NAME]` runs `systemctl --user daemon-reload` and enables/starts the timers.
-- `wheneverd deactivate [--schedule PATH] [--identifier NAME]` stops and disables the timers.
-- `wheneverd reload [--schedule PATH] [--identifier NAME] [--unit-dir PATH] [--[no-]prune]` writes units, reloads systemd, and restarts timers.
+- `wheneverd activate [--schedule PATH] [--identifier NAME]` runs `systemctl --user daemon-reload` and enables/starts the timers/services.
+- `wheneverd deactivate [--schedule PATH] [--identifier NAME]` stops and disables the timers/services.
+- `wheneverd reload [--schedule PATH] [--identifier NAME] [--unit-dir PATH] [--[no-]prune]` writes units, reloads systemd, and restarts timers/services.
 - `wheneverd current [--identifier NAME] [--unit-dir PATH]` prints the currently installed unit file contents from disk.
 - `wheneverd linger [--user NAME] [enable|disable|status]` manages lingering via `loginctl` (`status` is the default).
 

data/lib/wheneverd/cli/activate.rb

@@ -1,16 +1,16 @@
 # frozen_string_literal: true
 
 module Wheneverd
-  # Implements `wheneverd activate` (enable + start timers via `systemctl --user`).
+  # Implements `wheneverd activate` (enable + start timers/services via `systemctl --user`).
   class CLI::Activate < CLI
     def execute
-      timer_units = timer_unit_basenames
-      return 0 if timer_units.empty?
+      units = activatable_unit_basenames
+      return 0 if units.empty?
 
       Wheneverd::Systemd::Systemctl.run("daemon-reload")
-      Wheneverd::Systemd::Systemctl.run("enable", "--now", *timer_units)
+      Wheneverd::Systemd::Systemctl.run("enable", "--now", *units)
 
-      timer_units.each { |unit| puts unit }
+      units.each { |unit| puts unit }
       0
     rescue StandardError => e
       handle_error(e)

data/lib/wheneverd/cli/deactivate.rb

@@ -1,16 +1,16 @@
 # frozen_string_literal: true
 
 module Wheneverd
-  # Implements `wheneverd deactivate` (stop + disable timers via `systemctl --user`).
+  # Implements `wheneverd deactivate` (stop + disable timers/services via `systemctl --user`).
   class CLI::Deactivate < CLI
     def execute
-      timer_units = timer_unit_basenames
-      return 0 if timer_units.empty?
+      units = activatable_unit_basenames
+      return 0 if units.empty?
 
-      Wheneverd::Systemd::Systemctl.run("stop", *timer_units)
-      Wheneverd::Systemd::Systemctl.run("disable", *timer_units)
+      Wheneverd::Systemd::Systemctl.run("stop", *units)
+      Wheneverd::Systemd::Systemctl.run("disable", *units)
 
-      timer_units.each { |unit| puts unit }
+      units.each { |unit| puts unit }
       0
     rescue StandardError => e
       handle_error(e)

data/lib/wheneverd/cli/reload.rb

@@ -1,17 +1,17 @@
 # frozen_string_literal: true
 
 module Wheneverd
-  # Implements `wheneverd reload` (write units, reload daemon, restart timers).
+  # Implements `wheneverd reload` (write units, reload daemon, restart timers/services).
   class CLI::Reload < CLI
     option "--[no-]prune", :flag,
            "Prune previously generated units for the identifier (default: enabled)",
            default: true
 
     def execute
-      paths, timer_units = write_units_and_timer_basenames
-      return 0 if timer_units.empty?
+      paths, units = write_units_and_activatable_basenames
+      return 0 if units.empty?
 
-      reload_systemd(timer_units)
+      reload_systemd(units)
 
       paths.each { |path| puts path }
       0
@@ -21,7 +21,7 @@ module Wheneverd
 
     private
 
-    def write_units_and_timer_basenames
+    def write_units_and_activatable_basenames
       units = render_units
       paths = Wheneverd::Systemd::UnitWriter.write(
         units,
@@ -29,12 +29,12 @@ module Wheneverd
         prune: prune?,
         identifier: identifier_value
       )
-      [paths, timer_unit_basenames(units)]
+      [paths, activatable_unit_basenames(units)]
     end
 
-    def reload_systemd(timer_units)
+    def reload_systemd(units)
       Wheneverd::Systemd::Systemctl.run("daemon-reload")
-      Wheneverd::Systemd::Systemctl.run("restart", *timer_units)
+      Wheneverd::Systemd::Systemctl.run("restart", *units)
     end
   end
 end

data/lib/wheneverd/cli/status.rb

@@ -1,14 +1,15 @@
 # frozen_string_literal: true
 
 module Wheneverd
-  # Implements `wheneverd status` (show installed timer status via `systemctl --user`).
+  # Implements `wheneverd status` (show installed timer/service status via `systemctl --user`).
   class CLI::Status < CLI
     def execute
-      timer_units = installed_timer_unit_basenames
-      return 0 if timer_units.empty?
+      timer_units, service_units = installed_unit_basenames
+      units = timer_units + service_units
+      return 0 if units.empty?
 
       print_list_timers(timer_units)
-      print_status(timer_units)
+      print_status(units)
       0
     rescue StandardError => e
       handle_error(e)
@@ -17,12 +18,18 @@ module Wheneverd
     private
 
     # @return [Array<String>]
-    def installed_timer_unit_basenames
+    def installed_unit_basenames
       paths = Wheneverd::Systemd::UnitLister.list(identifier: identifier_value, unit_dir: unit_dir)
-      paths.map { |path| File.basename(path) }.grep(/\.timer\z/).uniq
+      basenames = paths.map { |path| File.basename(path) }
+      timers = basenames.grep(/\.timer\z/).uniq
+      timer_managed_services = timers.map { |timer| timer.sub(/\.timer\z/, ".service") }
+      services = basenames.grep(/\.service\z/).uniq - timer_managed_services
+      [timers, services]
     end
 
     def print_list_timers(timer_units)
+      return if timer_units.empty?
+
       stdout, = Wheneverd::Systemd::Systemctl.run("list-timers", "--all", *timer_units)
       print stdout
     end

data/lib/wheneverd/cli.rb

@@ -51,12 +51,14 @@ module Wheneverd
     end
 
     # @param units [Array<Wheneverd::Systemd::Unit>]
-    # @return [Array<String>] timer unit basenames
-    def timer_unit_basenames(units = render_units)
-      units.select { |unit| unit.kind == :timer }.map(&:path_basename).uniq
+    # @return [Array<String>] timer and standalone service unit basenames
+    def activatable_unit_basenames(units = render_units)
+      units.select { |unit| %i[timer service].include?(unit.activation) }
+           .map(&:path_basename)
+           .uniq
     end
 
-    private :render_units, :timer_unit_basenames
+    private :render_units, :activatable_unit_basenames
   end
 end
 
@@ -81,14 +83,14 @@ module Wheneverd
     subcommand "help", "Show help", Wheneverd::CLI::Help
     subcommand "init", "Create a schedule template", Wheneverd::CLI::Init
     subcommand "show", "Render units to stdout", Wheneverd::CLI::Show
-    subcommand "status", "Show systemctl list-timers + status for this identifier", Wheneverd::CLI::Status
+    subcommand "status", "Show systemctl status for this identifier", Wheneverd::CLI::Status
     subcommand "diff", "Diff rendered units vs files on disk", Wheneverd::CLI::Diff
     subcommand "validate", "Validate schedule via systemd-analyze", Wheneverd::CLI::Validate
     subcommand "write", "Write units to disk", Wheneverd::CLI::Write
     subcommand "delete", "Delete units from disk", Wheneverd::CLI::Delete
-    subcommand "activate", "Enable and start timers via systemctl --user", Wheneverd::CLI::Activate
-    subcommand "deactivate", "Stop and disable timers via systemctl --user", Wheneverd::CLI::Deactivate
-    subcommand "reload", "Write units, reload daemon, restart timers", Wheneverd::CLI::Reload
+    subcommand "activate", "Enable and start timers/services via systemctl --user", Wheneverd::CLI::Activate
+    subcommand "deactivate", "Stop and disable timers/services via systemctl --user", Wheneverd::CLI::Deactivate
+    subcommand "reload", "Write units, reload daemon, restart timers/services", Wheneverd::CLI::Reload
     subcommand "current", "Show installed units from disk", Wheneverd::CLI::Current
     subcommand "linger", "Manage systemd user lingering via loginctl", Wheneverd::CLI::Linger
   end

data/lib/wheneverd/dsl/context.rb

@@ -75,6 +75,37 @@ module Wheneverd
         command([shell_executable, "-lc", script_stripped])
       end
 
+      # Add a long-running systemd user service to the schedule.
+      #
+      # @example Shell service
+      #   service "worker", shell: "bundle exec bin/worker"
+      #
+      # @example Argv service
+      #   service "worker", command: ["bundle", "exec", "bin/worker"]
+      #
+      # @param name [String] stable service name within the schedule
+      # @param command [String, Array<String>, nil]
+      # @param shell [String, nil] shell script to run via /bin/bash -lc
+      # @param restart [String]
+      # @param restart_sec [String]
+      # @param service [Hash, Array<String>] extra [Service] lines
+      # @return [Wheneverd::Service]
+      def service(name, command: nil, shell: nil, restart: "always", restart_sec: "5s",
+                  service: {})
+        command_value = normalize_service_command(command: command, shell: shell)
+        service_obj = Wheneverd::Service.new(
+          name: name,
+          command: command_value,
+          restart: restart,
+          restart_sec: restart_sec,
+          service: service
+        )
+        schedule.add_service(service_obj)
+        service_obj
+      rescue Wheneverd::InvalidCommandError => e
+        raise LoadError.new(e.message, path: path)
+      end
+
       private
 
       def ensure_in_every_block!(name)
@@ -102,6 +133,21 @@ module Wheneverd
         stripped
       end
 
+      def normalize_service_command(command:, shell:)
+        if command && shell
+          raise LoadError.new("service() accepts command: or shell:, not both", path: path)
+        end
+
+        return command if command
+
+        if shell
+          script = normalize_shell_script(shell)
+          return ["/bin/bash", "-lc", script]
+        end
+
+        raise LoadError.new("service() requires command: or shell:", path: path)
+      end
+
       def with_current_entry(entry)
         previous_entry = @current_entry
         @current_entry = entry

data/lib/wheneverd/schedule.rb

@@ -8,9 +8,14 @@ module Wheneverd
     # @return [Array<Entry>]
     attr_reader :entries
 
+    # @return [Array<Wheneverd::Service>]
+    attr_reader :services
+
     # @param entries [Array<Entry>]
-    def initialize(entries: [])
+    # @param services [Array<Wheneverd::Service>]
+    def initialize(entries: [], services: [])
       @entries = entries.dup
+      @services = services.dup
     end
 
     # Append an entry to the schedule.
@@ -21,5 +26,14 @@ module Wheneverd
       entries << entry
       self
     end
+
+    # Append a long-running service to the schedule.
+    #
+    # @param service [Wheneverd::Service]
+    # @return [Schedule] self
+    def add_service(service)
+      services << service
+      self
+    end
   end
 end

data/lib/wheneverd/service.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+module Wheneverd
+  # A long-running systemd user service managed alongside scheduled timers.
+  class Service
+    SAFE_SETTING_NAME = /\A[A-Za-z][A-Za-z0-9]*\z/.freeze
+
+    # @return [String]
+    attr_reader :name
+
+    # @return [Wheneverd::Job::Command]
+    attr_reader :command
+
+    # @return [String]
+    attr_reader :restart
+
+    # @return [String]
+    attr_reader :restart_sec
+
+    # @return [Array<String>]
+    attr_reader :service_lines
+
+    # @param name [String] stable service name within the schedule
+    # @param command [String, Array<String>] command to run as ExecStart
+    # @param restart [String] systemd Restart= value
+    # @param restart_sec [String] systemd RestartSec= value
+    # @param service [Hash, Array<String>] extra [Service] lines
+    def initialize(name:, command:, restart: "always", restart_sec: "5s", service: {})
+      @name = normalize_name(name)
+      @command = Wheneverd::Job::Command.new(command: command)
+      @restart = normalize_required_value(restart, "restart")
+      @restart_sec = normalize_required_value(restart_sec, "restart_sec")
+      @service_lines = normalize_service_lines(service)
+    end
+
+    # Stable signature used for unit naming.
+    #
+    # @return [String]
+    def signature
+      [
+        "service:#{name}",
+        command.signature,
+        "restart:#{restart}",
+        "restart_sec:#{restart_sec}",
+        *service_lines
+      ].join("\n")
+    end
+
+    private
+
+    def normalize_name(value)
+      str = value.to_s.strip
+      raise InvalidCommandError, "Service name must not be empty" if str.empty?
+
+      str
+    end
+
+    def normalize_required_value(value, field)
+      str = value.to_s.strip
+      raise InvalidCommandError, "Service #{field} must not be empty" if str.empty?
+
+      str
+    end
+
+    def normalize_service_lines(value)
+      case value
+      when Hash
+        value.map { |key, setting| normalize_service_setting(key, setting) }
+      when Array
+        value.map { |line| normalize_service_line(line) }
+      else
+        raise InvalidCommandError, "Service extra settings must be a Hash or Array"
+      end
+    end
+
+    def normalize_service_setting(key, value)
+      setting_name = key.to_s.strip
+      unless SAFE_SETTING_NAME.match?(setting_name)
+        raise InvalidCommandError, "Invalid service setting name: #{setting_name.inspect}"
+      end
+
+      "#{setting_name}=#{normalize_service_setting_value(value)}"
+    end
+
+    def normalize_service_setting_value(value)
+      str = value.to_s.strip
+      raise InvalidCommandError, "Service setting values must not be empty" if str.empty?
+      if str.match?(/[\0\r\n]/)
+        raise InvalidCommandError, "Service setting values must not include NUL or newlines"
+      end
+
+      str
+    end
+
+    def normalize_service_line(line)
+      str = line.to_s.strip
+      raise InvalidCommandError, "Service lines must not be empty" if str.empty?
+      if str.match?(/[\0\r\n]/) || !str.include?("=")
+        raise InvalidCommandError, "Service lines must be single KEY=VALUE lines"
+      end
+
+      str
+    end
+  end
+end

data/lib/wheneverd/systemd/renderer.rb

@@ -10,7 +10,7 @@ module Wheneverd
     #   @return [Symbol] `:service` or `:timer`
     # @!attribute [r] contents
     #   @return [String] unit file contents
-    Unit = Struct.new(:path_basename, :kind, :contents, keyword_init: true)
+    Unit = Struct.new(:path_basename, :kind, :contents, :activation, keyword_init: true)
 
     # Renders a {Wheneverd::Schedule} into systemd units.
     #
@@ -52,7 +52,7 @@ module Wheneverd
         stable_ids = Wheneverd::Systemd::UnitNamer.stable_ids_for(schedule)
         stable_id_index = 0
 
-        schedule.entries.flat_map do |entry|
+        units = schedule.entries.flat_map do |entry|
           entry.jobs.flat_map do |job|
             stable_id = stable_ids.fetch(stable_id_index)
             stable_id_index += 1
@@ -60,9 +60,20 @@ module Wheneverd
             render_job(base, entry.trigger, job)
           end
         end
+        units.concat(render_services(schedule.services, id))
+        units
       end
       private_class_method :render_schedule
 
+      def self.render_services(services, id)
+        services.map do |service|
+          stable_id = Wheneverd::Systemd::UnitNamer.stable_id_for(service.signature)
+          base = "wheneverd-#{id}-#{stable_id}"
+          build_standalone_service_unit("#{base}.service", service)
+        end
+      end
+      private_class_method :render_services
+
       def self.render_job(base, trigger, job)
         service = build_service_unit("#{base}.service", job)
         timer = build_timer_unit("#{base}.timer", trigger)
@@ -74,17 +85,29 @@ module Wheneverd
         Unit.new(
           path_basename: path_basename,
           kind: :service,
-          contents: UnitContentBuilder.service_contents(path_basename, job.command)
+          contents: UnitContentBuilder.service_contents(path_basename, job.command),
+          activation: :timer_managed
         )
       end
       private_class_method :build_service_unit
 
+      def self.build_standalone_service_unit(path_basename, service)
+        Unit.new(
+          path_basename: path_basename,
+          kind: :service,
+          contents: UnitContentBuilder.standalone_service_contents(path_basename, service),
+          activation: :service
+        )
+      end
+      private_class_method :build_standalone_service_unit
+
       def self.build_timer_unit(path_basename, trigger)
         timer_lines = UnitContentBuilder.timer_lines_for(trigger)
         Unit.new(
           path_basename: path_basename,
           kind: :timer,
-          contents: UnitContentBuilder.timer_contents(path_basename, timer_lines)
+          contents: UnitContentBuilder.timer_contents(path_basename, timer_lines),
+          activation: :timer
         )
       end
       private_class_method :build_timer_unit

data/lib/wheneverd/systemd/unit_content_builder.rb

@@ -22,6 +22,29 @@ module Wheneverd
         )
       end
 
+      # Build a long-running service unit file.
+      #
+      # @param path_basename [String] unit file name for description
+      # @param service [Wheneverd::Service]
+      # @return [String] complete unit file contents
+      def self.standalone_service_contents(path_basename, service)
+        build_unit(
+          description: "wheneverd service #{path_basename}",
+          sections: [
+            "[Service]",
+            "Type=simple",
+            "ExecStart=#{service.command.command}",
+            "Restart=#{service.restart}",
+            "RestartSec=#{service.restart_sec}",
+            *service.service_lines,
+            "",
+            "[Install]",
+            "WantedBy=default.target",
+            ""
+          ]
+        )
+      end
+
       # Build timer unit file contents.
       #
       # @param path_basename [String] unit file name for description

data/lib/wheneverd/systemd/unit_namer.rb

@@ -55,7 +55,6 @@ module Wheneverd
       def self.stable_id_for(signature)
         Digest::SHA256.hexdigest(signature).slice(0, 12)
       end
-      private_class_method :stable_id_for
     end
   end
 end

data/lib/wheneverd/version.rb

@@ -2,5 +2,5 @@
 
 module Wheneverd
   # Gem version.
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

data/lib/wheneverd.rb

@@ -19,6 +19,7 @@ require_relative "wheneverd/duration"
 require_relative "wheneverd/interval"
 require_relative "wheneverd/core_ext/numeric_duration"
 require_relative "wheneverd/job/command"
+require_relative "wheneverd/service"
 require_relative "wheneverd/trigger/base"
 require_relative "wheneverd/trigger/interval"
 require_relative "wheneverd/trigger/calendar"

data/test/cli_activate_test.rb

@@ -37,6 +37,33 @@ class CLIActivateSuccessTest < Minitest::Test
                                         includes: expected_timer_basenames)
     end
   end
+
+  def test_runs_enable_now_for_standalone_services
+    with_service_project_dir do
+      status, out, err, calls = run_activate_with_capture3_stub
+      assert_cli_success(status, err)
+      service = expected_standalone_service_basenames.fetch(0)
+      assert_includes out, service
+      assert_systemctl_call_starts_with(calls, 1, SYSTEMCTL_USER_PREFIX + ["enable", "--now"],
+                                        includes: service)
+    end
+  end
+
+  private
+
+  def with_service_project_dir
+    with_project_dir do
+      FileUtils.mkdir_p("config")
+      File.write("config/schedule.rb", <<~RUBY)
+        service "worker", shell: "bin/worker"
+      RUBY
+      yield
+    end
+  end
+
+  def expected_standalone_service_basenames
+    expected_units.select { |unit| unit.activation == :service }.map(&:path_basename)
+  end
 end
 
 class CLIActivateScheduleMissingTest < Minitest::Test

data/test/cli_reload_test.rb

@@ -41,6 +41,29 @@ class CLIReloadSuccessTest < Minitest::Test
                                         includes: expected_timer_basenames)
     end
   end
+
+  def test_restarts_standalone_services
+    with_service_project_dir do |project_dir|
+      unit_dir = File.join(project_dir, "tmp_units")
+      status, _out, err, calls = run_reload_with_capture3_stub(unit_dir: unit_dir)
+      assert_cli_success(status, err)
+      service = expected_units.find { |unit| unit.activation == :service }.path_basename
+      assert_systemctl_call_starts_with(calls, 1, SYSTEMCTL_USER_PREFIX + ["restart"],
+                                        includes: service)
+    end
+  end
+
+  private
+
+  def with_service_project_dir
+    with_project_dir do |project_dir|
+      FileUtils.mkdir_p("config")
+      File.write("config/schedule.rb", <<~RUBY)
+        service "worker", shell: "bin/worker"
+      RUBY
+      yield project_dir
+    end
+  end
 end
 
 class CLIReloadScheduleMissingTest < Minitest::Test

data/test/cli_status_test.rb

@@ -6,11 +6,11 @@ require_relative "support/cli_test_helpers"
 class CLIStatusTest < Minitest::Test
   include CLITestHelpers
 
-  def test_runs_list_timers_and_status_for_each_installed_timer
+  def test_runs_list_timers_and_status_for_each_installed_unit
     with_installed_units do |unit_dir|
       status, _out, err, calls = run_status(unit_dir)
       assert_cli_success(status, err)
-      assert_status_calls(calls, expected_timer_units)
+      assert_status_calls(calls, expected_timer_units, expected_service_units)
     end
   end
 
@@ -39,6 +39,9 @@ class CLIStatusTest < Minitest::Test
 
   def with_installed_units
     with_inited_project_dir do |project_dir|
+      File.open(File.join(project_dir, "config", "schedule.rb"), "a") do |file|
+        file.puts 'service "worker", shell: "bin/worker"'
+      end
       unit_dir = File.join(project_dir, "tmp_units")
       assert_equal 0, run_cli(["write", "--identifier", "demo", "--unit-dir", unit_dir]).first
       yield unit_dir
@@ -53,9 +56,16 @@ class CLIStatusTest < Minitest::Test
     expected_timer_basenames(identifier: "demo").sort
   end
 
-  def assert_status_calls(calls, expected_timers)
+  def expected_service_units
+    expected_units(identifier: "demo")
+      .select { |unit| unit.activation == :service }
+      .map(&:path_basename)
+      .sort
+  end
+
+  def assert_status_calls(calls, expected_timers, expected_services)
     assert_list_timers_call(calls, expected_timers)
-    assert_status_unit_calls(calls, expected_timers)
+    assert_status_unit_calls(calls, (expected_timers + expected_services).sort)
   end
 
   def assert_list_timers_call(calls, expected_timers)

data/test/dsl_context_shell_test.rb

@@ -15,6 +15,37 @@ class DSLContextShellTest < Minitest::Test
     assert_includes error.message, "shell() script must be a String"
   end
 
+  def test_service_accepts_shell_command
+    ctx = Wheneverd::DSL::Context.new(path: "/tmp/config/schedule.rb")
+    ctx.service("live-poller", shell: "bundle exec bin/live")
+
+    service = ctx.schedule.services.fetch(0)
+    assert_equal "live-poller", service.name
+    assert_equal ["/bin/bash", "-lc", "bundle exec bin/live"], service.command.argv
+  end
+
+  def test_service_requires_command_or_shell
+    ctx = Wheneverd::DSL::Context.new(path: "/tmp/config/schedule.rb")
+    error = assert_raises(Wheneverd::DSL::LoadError) { ctx.service("live-poller") }
+    assert_includes error.message, "service() requires command: or shell:"
+  end
+
+  def test_service_rejects_command_and_shell_together
+    ctx = Wheneverd::DSL::Context.new(path: "/tmp/config/schedule.rb")
+    error = assert_raises(Wheneverd::DSL::LoadError) do
+      ctx.service("live-poller", command: "bin/live", shell: "bin/live")
+    end
+    assert_includes error.message, "service() accepts command: or shell:, not both"
+  end
+
+  def test_service_wraps_validation_errors_as_load_errors
+    ctx = Wheneverd::DSL::Context.new(path: "/tmp/config/schedule.rb")
+    error = assert_raises(Wheneverd::DSL::LoadError) do
+      ctx.service("live-poller", command: "bin/live", service: { "Bad-Key" => "1" })
+    end
+    assert_includes error.message, "Invalid service setting name"
+  end
+
   def test_shell_rejects_empty_script
     ctx = Wheneverd::DSL::Context.new(path: "/tmp/config/schedule.rb")
     error = assert_raises(Wheneverd::DSL::LoadError) { ctx.every("1m") { shell("   ") } }

data/test/systemd_renderer_test.rb

@@ -37,11 +37,84 @@ module SystemdRendererTestHelpers
     )
   end
 
+  def render_schedule(schedule, identifier: "demo")
+    Wheneverd::Systemd::Renderer.render(schedule, identifier: identifier)
+  end
+
   def marker
     "# Generated by wheneverd (wheneverd) #{Wheneverd::VERSION}; do not edit."
   end
 end
 
+class SystemdRendererServiceTest < Minitest::Test
+  include SystemdRendererTestHelpers
+
+  def test_standalone_service_contains_restart_and_extra_service_settings
+    service = Wheneverd::Service.new(
+      name: "live-poller",
+      command: ["/bin/bash", "-lc", "bundle exec bin/live"],
+      restart: "always",
+      restart_sec: "5s",
+      service: { "Nice" => "10", "CPUQuota" => "80%" }
+    )
+    units = render_schedule(Wheneverd::Schedule.new(services: [service]))
+    unit = units.fetch(0)
+
+    assert_equal :service, unit.kind
+    assert_equal :service, unit.activation
+    assert_includes unit.contents, marker
+    assert_includes unit.contents, "Description=wheneverd service #{unit.path_basename}"
+    assert_includes unit.contents, "Type=simple"
+    assert_includes unit.contents, 'ExecStart=/bin/bash -lc "bundle exec bin/live"'
+    assert_includes unit.contents, "Restart=always"
+    assert_includes unit.contents, "RestartSec=5s"
+    assert_includes unit.contents, "Nice=10"
+    assert_includes unit.contents, "CPUQuota=80%"
+    assert_includes unit.contents, "WantedBy=default.target"
+  end
+
+  def test_standalone_service_accepts_array_service_lines
+    service = Wheneverd::Service.new(
+      name: "live-poller",
+      command: "bin/live",
+      service: ["Environment=RAILS_ENV=production"]
+    )
+    unit = render_schedule(Wheneverd::Schedule.new(services: [service])).fetch(0)
+
+    assert_includes unit.contents, "Environment=RAILS_ENV=production"
+  end
+
+  def test_standalone_service_rejects_invalid_service_lines
+    assert_raises(Wheneverd::InvalidCommandError) do
+      Wheneverd::Service.new(name: "live-poller", command: "bin/live", service: ["NoEquals"])
+    end
+  end
+
+  def test_standalone_service_rejects_invalid_service_settings_collection
+    assert_raises(Wheneverd::InvalidCommandError) do
+      Wheneverd::Service.new(name: "live-poller", command: "bin/live", service: "Nice=10")
+    end
+  end
+
+  def test_standalone_service_rejects_newlines_in_setting_values
+    assert_raises(Wheneverd::InvalidCommandError) do
+      Wheneverd::Service.new(name: "live-poller", command: "bin/live",
+                             service: { "Environment" => "A=1\nB=2" })
+    end
+  end
+
+  def test_standalone_service_naming_is_stable
+    service = Wheneverd::Service.new(name: "worker", command: "bin/worker")
+    schedule = Wheneverd::Schedule.new(services: [service])
+
+    units1 = render_schedule(schedule)
+    units2 = render_schedule(schedule)
+
+    assert_equal units1.map(&:path_basename), units2.map(&:path_basename)
+    assert_match(/\Awheneverd-demo-[0-9a-f]{12}\.service\z/, units1.fetch(0).path_basename)
+  end
+end
+
 class SystemdRendererIntervalTest < Minitest::Test
   include SystemdRendererTestHelpers
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: wheneverd
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - bigcurl
@@ -32,6 +32,7 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".rubocop.yml"
+- ".ruby-version"
 - ".yardopts"
 - AGENTS.md
 - CHANGELOG.md
@@ -78,6 +79,7 @@ files:
 - lib/wheneverd/interval.rb
 - lib/wheneverd/job/command.rb
 - lib/wheneverd/schedule.rb
+- lib/wheneverd/service.rb
 - lib/wheneverd/systemd/analyze.rb
 - lib/wheneverd/systemd/calendar_spec.rb
 - lib/wheneverd/systemd/cron_parser.rb
@@ -154,7 +156,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.4
+rubygems_version: 4.0.11
 specification_version: 4
 summary: Wheneverd is to systemd timers what whenever is to cron.
 test_files: []