dargslan-cron-parser 1.0.0__tar.gz

dargslan_cron_parser-1.0.0/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: dargslan-cron-parser
+Version: 1.0.0
+Summary: Crontab expression parser — next run calculation, natural language explanation, and schedule validation.
+Author-email: Dargslan <info@dargslan.com>
+License: MIT
+Project-URL: Homepage, https://dargslan.com
+Project-URL: Documentation, https://dargslan.com/blog
+Project-URL: Repository, https://github.com/Dargslan
+Project-URL: Free Cheat Sheets, https://dargslan.com/cheat-sheets
+Project-URL: Linux & DevOps Books, https://dargslan.com/books
+Keywords: linux,cron,crontab,scheduler,parser,sysadmin,devops
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# dargslan-cron-parser
+
+Crontab expression parser — next run calculation, natural language explanation, and schedule validation.
+
+## Installation
+
+```bash
+pip install dargslan-cron-parser
+```
+
+## Usage
+
+```bash
+dargslan-cron explain "*/5 * * * *"    # Natural language
+dargslan-cron next "0 2 * * *"         # Next 5 runs
+dargslan-cron validate "0 25 * * *"    # Validate
+dargslan-cron parse "0 */6 * * 1-5"    # Parse fields
+dargslan-cron json "0 0 1 * *"         # JSON output
+```
+
+## Features
+
+- Natural language explanation of cron expressions
+- Next N run calculations
+- Expression validation with error messages
+- Support for @yearly, @monthly, @daily, etc.
+- Field expansion and range support
+- Zero dependencies — pure Python
+
+## Part of dargslan-toolkit
+
+Install all 54 Linux sysadmin tools: `pip install dargslan-toolkit`
+
+## Links
+
+- [Free Linux Cheat Sheets](https://dargslan.com/cheat-sheets)
+- [Linux & DevOps Books](https://dargslan.com/books)
+
+## License
+
+MIT

dargslan_cron_parser-1.0.0/README.md

@@ -0,0 +1,41 @@
+# dargslan-cron-parser
+
+Crontab expression parser — next run calculation, natural language explanation, and schedule validation.
+
+## Installation
+
+```bash
+pip install dargslan-cron-parser
+```
+
+## Usage
+
+```bash
+dargslan-cron explain "*/5 * * * *"    # Natural language
+dargslan-cron next "0 2 * * *"         # Next 5 runs
+dargslan-cron validate "0 25 * * *"    # Validate
+dargslan-cron parse "0 */6 * * 1-5"    # Parse fields
+dargslan-cron json "0 0 1 * *"         # JSON output
+```
+
+## Features
+
+- Natural language explanation of cron expressions
+- Next N run calculations
+- Expression validation with error messages
+- Support for @yearly, @monthly, @daily, etc.
+- Field expansion and range support
+- Zero dependencies — pure Python
+
+## Part of dargslan-toolkit
+
+Install all 54 Linux sysadmin tools: `pip install dargslan-toolkit`
+
+## Links
+
+- [Free Linux Cheat Sheets](https://dargslan.com/cheat-sheets)
+- [Linux & DevOps Books](https://dargslan.com/books)
+
+## License
+
+MIT

dargslan_cron_parser-1.0.0/dargslan_cron_parser/__init__.py

@@ -0,0 +1,162 @@
+"""dargslan-cron-parser — Crontab expression parser and scheduler."""
+
+__version__ = "1.0.0"
+
+import re
+import json
+from datetime import datetime, timedelta
+from calendar import monthrange
+
+FIELD_NAMES = ["minute", "hour", "day_of_month", "month", "day_of_week"]
+FIELD_RANGES = [(0, 59), (0, 23), (1, 31), (1, 12), (0, 7)]
+MONTH_NAMES = {
+    "jan": 1, "feb": 2, "mar": 3, "apr": 4, "may": 5, "jun": 6,
+    "jul": 7, "aug": 8, "sep": 9, "oct": 10, "nov": 11, "dec": 12
+}
+DOW_NAMES = {
+    "sun": 0, "mon": 1, "tue": 2, "wed": 3, "thu": 4, "fri": 5, "sat": 6
+}
+SPECIAL_EXPRESSIONS = {
+    "@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 * * * *",
+}
+
+
+def expand_field(field, min_val, max_val):
+    if max_val == 7 and field == "7":
+        field = "0"
+    values = set()
+    for part in field.split(","):
+        step = 1
+        if "/" in part:
+            part, step_str = part.split("/", 1)
+            step = int(step_str)
+        if part == "*":
+            values.update(range(min_val, max_val + 1, step))
+        elif "-" in part:
+            start, end = part.split("-", 1)
+            start, end = int(start), int(end)
+            values.update(range(start, end + 1, step))
+        else:
+            part_lower = part.lower()
+            if part_lower in MONTH_NAMES:
+                values.add(MONTH_NAMES[part_lower])
+            elif part_lower in DOW_NAMES:
+                values.add(DOW_NAMES[part_lower])
+            else:
+                values.add(int(part))
+    return sorted(v for v in values if min_val <= v <= max_val)
+
+
+def parse_expression(expr):
+    expr = expr.strip()
+    if expr.startswith("@"):
+        expr = SPECIAL_EXPRESSIONS.get(expr.lower(), expr)
+    parts = expr.split()
+    if len(parts) != 5:
+        return None
+    fields = {}
+    for i, (part, name) in enumerate(zip(parts, FIELD_NAMES)):
+        fields[name] = expand_field(part, FIELD_RANGES[i][0], FIELD_RANGES[i][1])
+    return fields
+
+
+def explain(expr):
+    expr_orig = expr.strip()
+    if expr_orig.startswith("@"):
+        mapped = SPECIAL_EXPRESSIONS.get(expr_orig.lower())
+        if mapped:
+            labels = {
+                "@yearly": "Once a year at midnight on January 1st",
+                "@annually": "Once a year at midnight on January 1st",
+                "@monthly": "Once a month at midnight on the 1st",
+                "@weekly": "Once a week at midnight on Sunday",
+                "@daily": "Once a day at midnight",
+                "@midnight": "Once a day at midnight",
+                "@hourly": "Once an hour at the beginning of the hour",
+            }
+            return labels.get(expr_orig.lower(), f"Equivalent to: {mapped}")
+    fields = parse_expression(expr)
+    if not fields:
+        return "Invalid cron expression"
+    parts = []
+    mins = fields["minute"]
+    hrs = fields["hour"]
+    doms = fields["day_of_month"]
+    mons = fields["month"]
+    dows = fields["day_of_week"]
+    dow_names_rev = {0: "Sunday", 1: "Monday", 2: "Tuesday", 3: "Wednesday", 4: "Thursday", 5: "Friday", 6: "Saturday"}
+    month_names_rev = {1: "January", 2: "February", 3: "March", 4: "April", 5: "May", 6: "June", 7: "July", 8: "August", 9: "September", 10: "October", 11: "November", 12: "December"}
+    if len(mins) == 1:
+        parts.append(f"At minute {mins[0]}")
+    elif len(mins) == 60:
+        parts.append("Every minute")
+    else:
+        parts.append(f"At minutes {', '.join(str(m) for m in mins)}")
+    if len(hrs) == 1:
+        parts.append(f"past hour {hrs[0]}")
+    elif len(hrs) < 24:
+        parts.append(f"past hours {', '.join(str(h) for h in hrs)}")
+    if len(doms) < 31:
+        parts.append(f"on day(s) {', '.join(str(d) for d in doms)}")
+    if len(mons) < 12:
+        parts.append(f"in {', '.join(month_names_rev.get(m, str(m)) for m in mons)}")
+    if len(dows) < 7:
+        parts.append(f"on {', '.join(dow_names_rev.get(d, str(d)) for d in dows)}")
+    return " ".join(parts)
+
+
+def next_run(expr, after=None, count=5):
+    fields = parse_expression(expr)
+    if not fields:
+        return []
+    if after is None:
+        after = datetime.now()
+    current = after.replace(second=0, microsecond=0) + timedelta(minutes=1)
+    results = []
+    max_iter = 525600
+    for _ in range(max_iter):
+        if (current.minute in fields["minute"] and
+            current.hour in fields["hour"] and
+            current.day in fields["day_of_month"] and
+            current.month in fields["month"] and
+            (current.weekday() + 1) % 7 in fields["day_of_week"]):
+            results.append(current.isoformat())
+            if len(results) >= count:
+                break
+        current += timedelta(minutes=1)
+    return results
+
+
+def validate(expr):
+    issues = []
+    expr = expr.strip()
+    if expr.startswith("@"):
+        if expr.lower() not in SPECIAL_EXPRESSIONS:
+            issues.append(f"Unknown special expression: {expr}")
+        return issues
+    parts = expr.split()
+    if len(parts) != 5:
+        issues.append(f"Expected 5 fields, got {len(parts)}")
+        return issues
+    for i, (part, name) in enumerate(zip(parts, FIELD_NAMES)):
+        try:
+            vals = expand_field(part, FIELD_RANGES[i][0], FIELD_RANGES[i][1])
+            if not vals:
+                issues.append(f"Field '{name}' ({part}) expands to empty set")
+        except (ValueError, IndexError):
+            issues.append(f"Invalid field '{name}': {part}")
+    return issues
+
+
+def generate_report(expr):
+    return {
+        "expression": expr,
+        "explanation": explain(expr),
+        "validation": validate(expr),
+        "is_valid": len(validate(expr)) == 0,
+        "next_runs": next_run(expr),
+        "parsed_fields": parse_expression(expr),
+    }

dargslan_cron_parser-1.0.0/dargslan_cron_parser/cli.py

@@ -0,0 +1,86 @@
+"""CLI for dargslan-cron-parser."""
+
+import sys
+import json
+from . import explain, next_run, validate, parse_expression, generate_report, __version__
+
+
+def main():
+    args = sys.argv[1:]
+    if not args or args[0] in ("-h", "--help"):
+        print(f"dargslan-cron-parser v{__version__}")
+        print(f"Crontab expression parser and scheduler")
+        print(f"\nUsage: dargslan-cron <command> <expression>")
+        print(f"\nCommands:")
+        print(f"  explain \"*/5 * * * *\"    Natural language explanation")
+        print(f"  next \"0 2 * * *\"         Next 5 scheduled runs")
+        print(f"  validate \"0 25 * * *\"    Validate expression")
+        print(f"  parse \"0 */6 * * 1-5\"    Parse into field values")
+        print(f"  report \"0 0 1 * *\"       Full analysis report")
+        print(f"  json \"* * * * *\"         Full report as JSON")
+        print(f"  version                   Show version")
+        print(f"\nhttps://dargslan.com — Linux & DevOps Books")
+        return
+
+    cmd = args[0]
+    if cmd == "version":
+        print(f"dargslan-cron-parser v{__version__}")
+        return
+
+    if len(args) < 2:
+        print("Error: Please provide a cron expression.")
+        print("Example: dargslan-cron explain \"*/5 * * * *\"")
+        sys.exit(1)
+
+    expr = args[1]
+    if cmd == "explain":
+        print(explain(expr))
+    elif cmd == "next":
+        count = 5
+        if "-n" in args:
+            idx = args.index("-n")
+            if idx + 1 < len(args):
+                count = int(args[idx + 1])
+        runs = next_run(expr, count=count)
+        print(f"Next {len(runs)} runs for: {expr}")
+        print(f"  {explain(expr)}")
+        for r in runs:
+            print(f"  {r}")
+    elif cmd == "validate":
+        issues = validate(expr)
+        if not issues:
+            print(f"Valid: {expr}")
+            print(f"  {explain(expr)}")
+        else:
+            print(f"Invalid: {expr}")
+            for i in issues:
+                print(f"  [ERROR] {i}")
+    elif cmd == "parse":
+        fields = parse_expression(expr)
+        if fields:
+            for name, vals in fields.items():
+                print(f"  {name}: {vals}")
+        else:
+            print("Invalid expression")
+    elif cmd == "report":
+        r = generate_report(expr)
+        print(f"Cron Expression: {r['expression']}")
+        print(f"Explanation: {r['explanation']}")
+        print(f"Valid: {r['is_valid']}")
+        if r['validation']:
+            print(f"Issues:")
+            for i in r['validation']:
+                print(f"  {i}")
+        print(f"\nNext runs:")
+        for run in r['next_runs']:
+            print(f"  {run}")
+        print(f"\nMore Linux tools: https://dargslan.com/cheat-sheets")
+    elif cmd == "json":
+        print(json.dumps(generate_report(expr), indent=2))
+    else:
+        print(f"Unknown command: {cmd}. Use --help for usage.")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

dargslan_cron_parser-1.0.0/dargslan_cron_parser.egg-info/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: dargslan-cron-parser
+Version: 1.0.0
+Summary: Crontab expression parser — next run calculation, natural language explanation, and schedule validation.
+Author-email: Dargslan <info@dargslan.com>
+License: MIT
+Project-URL: Homepage, https://dargslan.com
+Project-URL: Documentation, https://dargslan.com/blog
+Project-URL: Repository, https://github.com/Dargslan
+Project-URL: Free Cheat Sheets, https://dargslan.com/cheat-sheets
+Project-URL: Linux & DevOps Books, https://dargslan.com/books
+Keywords: linux,cron,crontab,scheduler,parser,sysadmin,devops
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# dargslan-cron-parser
+
+Crontab expression parser — next run calculation, natural language explanation, and schedule validation.
+
+## Installation
+
+```bash
+pip install dargslan-cron-parser
+```
+
+## Usage
+
+```bash
+dargslan-cron explain "*/5 * * * *"    # Natural language
+dargslan-cron next "0 2 * * *"         # Next 5 runs
+dargslan-cron validate "0 25 * * *"    # Validate
+dargslan-cron parse "0 */6 * * 1-5"    # Parse fields
+dargslan-cron json "0 0 1 * *"         # JSON output
+```
+
+## Features
+
+- Natural language explanation of cron expressions
+- Next N run calculations
+- Expression validation with error messages
+- Support for @yearly, @monthly, @daily, etc.
+- Field expansion and range support
+- Zero dependencies — pure Python
+
+## Part of dargslan-toolkit
+
+Install all 54 Linux sysadmin tools: `pip install dargslan-toolkit`
+
+## Links
+
+- [Free Linux Cheat Sheets](https://dargslan.com/cheat-sheets)
+- [Linux & DevOps Books](https://dargslan.com/books)
+
+## License
+
+MIT

dargslan_cron_parser-1.0.0/dargslan_cron_parser.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+dargslan_cron_parser/__init__.py
+dargslan_cron_parser/cli.py
+dargslan_cron_parser.egg-info/PKG-INFO
+dargslan_cron_parser.egg-info/SOURCES.txt
+dargslan_cron_parser.egg-info/dependency_links.txt
+dargslan_cron_parser.egg-info/entry_points.txt
+dargslan_cron_parser.egg-info/top_level.txt

dargslan_cron_parser-1.0.0/dargslan_cron_parser.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dargslan_cron_parser-1.0.0/dargslan_cron_parser.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dargslan-cron = dargslan_cron_parser.cli:main

dargslan_cron_parser-1.0.0/dargslan_cron_parser.egg-info/top_level.txt

@@ -0,0 +1 @@
+dargslan_cron_parser

dargslan_cron_parser-1.0.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "dargslan-cron-parser"
+version = "1.0.0"
+description = "Crontab expression parser — next run calculation, natural language explanation, and schedule validation."
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.7"
+authors = [{name = "Dargslan", email = "info@dargslan.com"}]
+keywords = ["linux", "cron", "crontab", "scheduler", "parser", "sysadmin", "devops"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Topic :: System :: Systems Administration",
+]
+
+[project.urls]
+Homepage = "https://dargslan.com"
+Documentation = "https://dargslan.com/blog"
+Repository = "https://github.com/Dargslan"
+"Free Cheat Sheets" = "https://dargslan.com/cheat-sheets"
+"Linux & DevOps Books" = "https://dargslan.com/books"
+
+[project.scripts]
+dargslan-cron = "dargslan_cron_parser.cli:main"

dargslan_cron_parser-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+