philiprehberger-cron_parser 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eeb369c781ff5bf8c316b443bf97ee4786ed74e11842f7f5de81a9071418bdb2
-  data.tar.gz: ee7c9d64bae3aee0f9a7b617197e32c6af9816d09ad372c80031d748082f9ab2
+  metadata.gz: d11c034aa656522a0e2ca5e145ca68f974b1b0eb9aeafad15797ee5a53d859f1
+  data.tar.gz: 874e7abb865fa66511d7a407e7e0cc4ea0dfd8e8a637ff75225cffc9db5f0206
 SHA512:
-  metadata.gz: c95125f661ce1799d954dc8766c494b784db4fcc7ccd1ad37ca638b4cd3a6a807560fa9640868d2a9eb91e89e8323604868a3f27fecf797324571f7d6d341b48
-  data.tar.gz: c1464aa92d9df184418b6e211864f2ea30c7444822c955c5772482e2c7e24d10c5dc395de909c4baf7e17436cee4aba87c20a7ff72fd3241ab3c5049a3781ba2
+  metadata.gz: c8053224dd61f4defd352fbdf106351f995de7b16b6f10b610a40e99c47f577c0b27d241587aa74cd4299da2d7a4601c6879844eb63d68ce47dfcaa383ce5847
+  data.tar.gz: f830772d6a686fec8dcf8f857a68b4be1f162bf70f0ebde4146f7228b44f5aadc18dbe567ce8570fcd4d5c5fa3125ab2ef56313978cec0320caa5b7796d458b5

data/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-04-09
+
+### Added
+- Named cron aliases (`@hourly`, `@daily`, `@midnight`, `@weekly`, `@monthly`, `@yearly`, `@annually`) with case-insensitive matching
+- `valid?` and `validate` now accept alias expressions
+
 ## [0.2.0] - 2026-04-03
 
 ### Added

data/README.md

@@ -69,6 +69,20 @@ Philiprehberger::CronParser.new('0 0 * * MON,WED,FRI') # specific days
 Philiprehberger::CronParser.new('0 0 * * 1,WED,5')     # mixed numeric and named
 ```
 
+### Named Aliases
+
+Standard crontab aliases are supported (case-insensitive):
+
+```ruby
+Philiprehberger::CronParser.new('@hourly')    # => 0 * * * *
+Philiprehberger::CronParser.new('@daily')     # => 0 0 * * *
+Philiprehberger::CronParser.new('@midnight')  # alias for @daily
+Philiprehberger::CronParser.new('@weekly')    # => 0 0 * * 0
+Philiprehberger::CronParser.new('@monthly')   # => 0 0 1 * *
+Philiprehberger::CronParser.new('@yearly')    # => 0 0 1 1 *
+Philiprehberger::CronParser.new('@annually')  # alias for @yearly
+```
+
 ### Validation
 
 ```ruby

data/lib/philiprehberger/cron_parser/expression.rb

@@ -30,13 +30,27 @@ module Philiprehberger
         weekday: 'day of week'
       }.freeze
 
-      # @return [String] the original expression
+      ALIASES = {
+        '@yearly' => '0 0 1 1 *',
+        '@annually' => '0 0 1 1 *',
+        '@monthly' => '0 0 1 * *',
+        '@weekly' => '0 0 * * 0',
+        '@daily' => '0 0 * * *',
+        '@midnight' => '0 0 * * *',
+        '@hourly' => '0 * * * *'
+      }.freeze
+
+      # @return [String] the original (post-alias expansion) expression
       attr_reader :expression
 
-      # @param expr [String] a 5-field cron expression
+      # @param expr [String] a 5-field cron expression or named alias (e.g. "@daily")
       # @raise [Error] if the expression is invalid
       def initialize(expr)
-        @expression = expr.strip
+        stripped = expr.strip
+        stripped = ALIASES[stripped.downcase] if stripped.start_with?('@')
+        raise Error, "Unknown cron alias: #{expr.strip}" if stripped.nil?
+
+        @expression = stripped
         parts = @expression.split(/\s+/)
         raise Error, "Expected 5 fields, got #{parts.size}: #{@expression}" unless parts.size == 5
 

data/lib/philiprehberger/cron_parser/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module CronParser
-    VERSION = '0.2.0'
+    VERSION = '0.3.0'
   end
 end

data/lib/philiprehberger/cron_parser.rb

@@ -37,6 +37,12 @@ module Philiprehberger
     def self.validate(expr)
       errors = []
       stripped = expr.strip
+      if stripped.start_with?('@')
+        alias_expanded = Expression::ALIASES[stripped.downcase]
+        return { valid: false, errors: ["Unknown cron alias: #{stripped}"] } if alias_expanded.nil?
+
+        stripped = alias_expanded
+      end
       parts = stripped.split(/\s+/)
 
       unless parts.size == 5

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-cron_parser
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-03 00:00:00.000000000 Z
+date: 2026-04-09 00:00:00.000000000 Z
 dependencies: []
 description: Parse standard 5-field cron expressions and calculate next/previous occurrences,
   match times against patterns, and generate human-readable descriptions.