wheneverd 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 48c6bdb7f18c775a63b874f0509d276f9f5a9b585193aa9f3b1795f3374f26c8
-  data.tar.gz: ef19f548714b7c70998e7e53ee560876742108199f8418e342a7c2f7117fe796
+  metadata.gz: 7ef1858fab03a38b36da00bf0093d4025762263ca868d05a78c1876d8aeb6441
+  data.tar.gz: 539fbeec1db7023059767501172d7337da50a966e0727c29879f88cd81770303
 SHA512:
-  metadata.gz: 5e19a91cc2c5ad5ecd4d040cdc450de1153a8f685ef1c8be7db022d6f4189f628d8c9effe52d2a3428734a4de088e5eb1b4fba5d7d1a655fb9e38b6110794d60
-  data.tar.gz: 027fabc2a861d96f3f79afe6930d18758aaeaec2e39490ab93a8b7b0939a5ff543de0f6ac06438ce6ac100b68a4dd8375d0dcedf104d82f90618368bd82c7621
+  metadata.gz: 2656962166f254b2d48f94d23329db78a16964eda9c164457c5586b4dabfa095077b75372b94da9f9cad38862d5548be15ba7b2567cef5d2fb2cdc3cb94d4984
+  data.tar.gz: a06b649a079b18fd3f321bc818e322d3284c98d96bfbabaf43244b4d604193b395186d31548efdf2296fe12509f47e665f1cdf96f47e2af25512b3eae53ba20d

data/CHANGELOG.md

@@ -5,10 +5,16 @@ On release, entries are moved into `## x.y.z` sections that match the gem versio
 
 ## Unreleased
 
-- Adds `wheneverd linger enable|disable|status` for managing systemd user lingering via `loginctl`.
+## 0.2.1
+
+- Removes an unused filtering metadata keyword argument from the schedule DSL.
 
 ## 0.2.0
 
+- Adds `wheneverd linger enable|disable|status` for managing systemd user lingering via `loginctl`.
+
+## 0.1.0
+
 - Provides a Clamp-based `wheneverd` CLI with `--help`, `--version`, and `--verbose` (usage errors in `ERROR: ...` format).
 - Adds core domain objects and helpers for building schedules (interval parsing, durations, triggers, entries, jobs).
 - Adds a Ruby DSL loader (`Wheneverd::DSL::Loader.load_file`) supporting `every(...)` blocks with `command(...)` jobs.

data/FEATURE_SUMMARY.md

@@ -12,19 +12,21 @@ It complements [`CHANGELOG.md`](CHANGELOG.md) by staying high-level and focusing
 
 ## Unreleased
 
+## 0.2.1
+
 - Adds `wheneverd linger enable|disable|status` for managing systemd user lingering via `loginctl`.
+- Removes an unused filtering metadata keyword argument from the schedule DSL.
 
 ## 0.2.0
 
 - The `wheneverd` CLI is implemented using Clamp (`--help`, usage errors in `ERROR: ...` format, `--verbose` for details).
 - The gem includes a small “whenever-like” domain model (interval parsing, durations, triggers, schedules).
 - The gem can load a Ruby schedule DSL file via `Wheneverd::DSL::Loader.load_file`.
-- Schedule DSL supports `every(period, at: ..., roles: ...) { command("...") }` entries (multiple `command` calls per entry).
+- Schedule DSL supports `every(period, at: ...) { command("...") }` entries (multiple `command` calls per entry).
 - Schedule DSL supports multiple calendar period symbols per `every` block (e.g. `every :tuesday, :wednesday`).
 - Supported `every` periods include interval strings/durations, calendar shortcuts (`:hour`, `:day`, `:month`, `:year`),
   day selectors (`:monday..:sunday`, `:weekday`, `:weekend`), and standard 5-field cron strings.
 - `at:` supports a string or an array of strings (for calendar schedules), like `"4:30 am"` or `"00:15"`.
-- `roles:` is accepted and stored on entries, but is not used for filtering yet.
 - The gem can render systemd `.service` and `.timer` units via `Wheneverd::Systemd::Renderer.render`.
 - Generated unit basenames include a stable ID derived from the job’s trigger + command (reordering schedule blocks won’t rename units).
 - Interval timers include both `OnActiveSec=` and `OnUnitActiveSec=` to ensure a newly started timer has a next run scheduled.

data/README.md

@@ -2,15 +2,17 @@
 
 Wheneverd is to systemd timers what the [`whenever` gem](https://github.com/javan/whenever) is to cron.
 
-Tagline / repo: `git@github.com:bigcurl/wheneverd.git`
-
 ## Status
 
-Working end-to-end: schedule DSL loading, systemd unit rendering, and safe unit write/list/delete are implemented, along with a CLI for `init`, `show`, `write`, `delete`, `activate`, `deactivate`, `reload`, and `current`.
+Pre-1.0, but working end-to-end for user systemd timers:
 
-Known limitations: `roles:` is accepted but not used for filtering yet.
+- Loads a Ruby schedule DSL file (default: `config/schedule.rb`).
+- Renders systemd `.service`/`.timer` units (interval, calendar, and 5-field cron schedules).
+- Writes, lists, and deletes generated unit files (default: `~/.config/systemd/user`).
+- Enables/starts/stops/disables/restarts timers via `systemctl --user`.
+- Manages lingering via `loginctl` (so timers can run while logged out).
 
-See `FEATURE_SUMMARY.md` for high-level user-visible behavior, and `CHANGELOG.md` for release notes.
+See `FEATURE_SUMMARY.md` for user-visible behavior, and `CHANGELOG.md` for release notes.
 
 ## Installation
 
@@ -38,7 +40,7 @@ wheneverd activate
 wheneverd deactivate
 wheneverd reload
 wheneverd current
-wheneverd linger status
+wheneverd linger
 ```
 
 ### Minimal `config/schedule.rb` example
@@ -120,7 +122,7 @@ Note: schedule files are executed as Ruby. Do not run untrusted schedule code.
 The core shape is:
 
 ```ruby
-every(period, at: nil, roles: nil) do
+every(period, at: nil) do
   command "echo hello"
 end
 ```
@@ -185,10 +187,6 @@ Cron translation supports standard 5-field crontab strings (`minute hour day-of-
 
 Unsupported cron patterns raise an error at render time (e.g. non-5-field strings, `@daily`, `L`, `W`, `#`, `?`).
 
-### `roles:`
-
-`roles:` is accepted and stored on entries, but is ignored in v1 (no role-based filtering yet).
-
 ## CLI
 
 Defaults:
@@ -204,17 +202,19 @@ Notes:
 - Identifiers are sanitized for use in unit file names (non-alphanumeric characters become `-`).
 - Unit basenames include a stable ID derived from the job’s trigger + command (reordering schedule blocks won’t rename units).
 - `wheneverd write` / `wheneverd reload` prune previously generated units for the identifier by default (use `--no-prune` to keep old units around).
+- `--unit-dir` controls where unit files are written/read/deleted; `activate`/`deactivate` use systemd’s unit search path.
 
 Commands:
 
 - `wheneverd init [--schedule PATH] [--force]` writes a template schedule file.
 - `wheneverd show [--schedule PATH] [--identifier NAME]` prints rendered units to stdout.
-- `wheneverd write [--dry-run] [--unit-dir PATH] [--[no-]prune]` writes units to disk (or prints paths in `--dry-run` mode).
-- `wheneverd delete [--dry-run] [--unit-dir PATH]` deletes previously generated units for the identifier.
+- `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 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).
 
 ## Development
 

data/lib/wheneverd/dsl/context.rb

@@ -25,16 +25,15 @@ module Wheneverd
       #
       # @param periods [Array<String, Symbol, Wheneverd::Duration, Array<Symbol>>]
       # @param at [String, Array<String>, nil]
-      # @param roles [Object] stored but currently not used for filtering
       # @return [Wheneverd::Entry]
-      def every(*periods, at: nil, roles: nil, &block)
+      def every(*periods, at: nil, &block)
         raise InvalidPeriodError.new("every() requires a block", path: path) unless block
 
         raise InvalidPeriodError.new("every() requires a period", path: path) if periods.empty?
 
         period = periods.length == 1 ? periods.first : periods
         trigger = @period_parser.trigger_for(period, at: at)
-        entry = Wheneverd::Entry.new(trigger: trigger, roles: roles)
+        entry = Wheneverd::Entry.new(trigger: trigger)
 
         schedule.add_entry(entry)
 

data/lib/wheneverd/entry.rb

@@ -6,17 +6,15 @@ module Wheneverd
   # An entry ties together a trigger (when to run) and one or more jobs (what to run).
   class Entry
     # @return [Wheneverd::Trigger::Interval, Wheneverd::Trigger::Calendar, Wheneverd::Trigger::Boot]
-    attr_reader :trigger, :jobs, :roles
+    attr_reader :trigger, :jobs
 
     # @param trigger [Object] a trigger object describing when to run
     # @param jobs [Array<Object>] job objects (usually {Wheneverd::Job::Command})
-    # @param roles [Object] stored but currently not used for filtering
-    def initialize(trigger:, jobs: [], roles: nil)
+    def initialize(trigger:, jobs: [])
       raise ArgumentError, "trigger is required" if trigger.nil?
 
       @trigger = trigger
       @jobs = jobs.dup
-      @roles = roles
     end
 
     # Append a job to the entry.

data/lib/wheneverd/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: wheneverd
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - bigcurl