cronjoborganize 0.1.1__tar.gz

cronjoborganize-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moudi Alameel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cronjoborganize-0.1.1/PKG-INFO

@@ -0,0 +1,35 @@
+Metadata-Version: 2.4
+Name: cronjoborganize
+Version: 0.1.1
+Summary: A command-line utility to parse and categorize cron job expressions into structured CSV reports
+Author: Moudi Alameel
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# cronjoborganize
+
+![PyPI](https://img.shields.io/pypi/v/cronjoborganize)
+![License](https://img.shields.io/pypi/l/cronjoborganize)
+![Python](https://img.shields.io/pypi/pyversions/cronjoborganize)
+
+A Python command-line tool designed to seamlessly parse and structure cron job expressions into well-organized CSV reports. 
+
+## Features
+
+* **Parse Cron Expressions:** Accurately reads standard cron scheduling syntax.
+* **CSV Reporting:** Exports your parsed cron jobs into a structured, readable CSV format for straightforward auditing and analysis.
+* **CLI Interface:** Provides a lightweight and intuitive command-line interface.
+
+## Installation
+
+You can install `cronjoborganize` directly from PyPI using pip:
+
+```bash
+pip install cronjoborganize
+```
+
+## Usage
+
+Use the tool from the command line to parse your cron files and generate reports:

cronjoborganize-0.1.1/README.md

@@ -0,0 +1,25 @@
+# cronjoborganize
+
+![PyPI](https://img.shields.io/pypi/v/cronjoborganize)
+![License](https://img.shields.io/pypi/l/cronjoborganize)
+![Python](https://img.shields.io/pypi/pyversions/cronjoborganize)
+
+A Python command-line tool designed to seamlessly parse and structure cron job expressions into well-organized CSV reports. 
+
+## Features
+
+* **Parse Cron Expressions:** Accurately reads standard cron scheduling syntax.
+* **CSV Reporting:** Exports your parsed cron jobs into a structured, readable CSV format for straightforward auditing and analysis.
+* **CLI Interface:** Provides a lightweight and intuitive command-line interface.
+
+## Installation
+
+You can install `cronjoborganize` directly from PyPI using pip:
+
+```bash
+pip install cronjoborganize
+```
+
+## Usage
+
+Use the tool from the command line to parse your cron files and generate reports:

cronjoborganize-0.1.1/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cronjoborganize"
+version = "0.1.1"
+description = "A command-line utility to parse and categorize cron job expressions into structured CSV reports"
+authors = [
+  { name="Moudi Alameel" }
+]
+readme = "README.md"
+requires-python = ">=3.8"
+dependencies = [
+    
+]
+
+[project.scripts]
+# This creates the terminal command 'cron-organize'
+cron-organize = "cron_parser.cron_parser:main"

cronjoborganize-0.1.1/setup.cfg

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

cronjoborganize-0.1.1/src/cron_parser/cron_parser.py

@@ -0,0 +1,151 @@
+import csv
+import argparse
+import math
+import os
+import sys
+
+def get_categorical_frequency(cron_expr):
+    special = {
+        '@reboot': 'On Startup',
+        '@yearly': 'Yearly',
+        '@annually': 'Yearly',
+        '@monthly': 'Monthly',
+        '@weekly': 'Weekly',
+        '@daily': 'Daily',
+        '@midnight': 'Daily',
+        '@hourly': 'Hourly'
+    }
+    
+    if cron_expr in special:
+        return special[cron_expr]
+    
+    parts = cron_expr.split()
+    if len(parts) < 5:
+        return "Unknown"
+    
+    m, h, dom, mon, dow = parts[:5]
+
+    def get_step(val):
+        if val.startswith('*/'):
+            try: return int(val[2:])
+            except: pass
+        return None
+
+    if mon != '*':
+        step = get_step(mon)
+        if step == 3 or (',' in mon and len(mon.split(',')) == 4):
+            return 'Quarterly'
+        if step == 6 or (',' in mon and len(mon.split(',')) == 2):
+            return 'Biannually'
+        if ',' in mon:
+            return 'Multiple times a year'
+        return 'Yearly'
+
+    if dom != '*' or dow != '*':
+        dom_step = get_step(dom)
+        if dom_step:
+            if 5 <= dom_step <= 7: return 'Weekly'
+            if 13 <= dom_step <= 15: return 'Biweekly'
+            if dom_step >= 25: return 'Monthly'
+            return f'Every {dom_step} days'
+            
+        if dow != '*' and '-' in dow:
+            return 'Daily'
+            
+        if ',' in dom:
+            return 'Multiple times a month'
+        if ',' in dow:
+            return 'Multiple times a week'
+            
+        if dom != '*' and dow == '*': return 'Monthly'
+        if dow != '*' and dom == '*': return 'Weekly'
+        return 'Weekly'
+
+    if h != '*':
+        h_step = get_step(h)
+        if h_step:
+            return f'Every {h_step} hours'
+        if '-' in h or ',' in h:
+            return 'Multiple times a day'
+        return 'Daily'
+
+    if m != '*':
+        m_step = get_step(m)
+        if m_step:
+            rounded_m = math.ceil(m_step / 5.0) * 5
+            if rounded_m >= 60: return 'Hourly'
+            if rounded_m == 30: return 'Half-hourly'
+            return f'Every {rounded_m} minutes'
+        if '-' in m or ',' in m:
+            return 'Multiple times an hour'
+        return 'Hourly'
+
+    return 'Every minute'
+
+def process_cron_stream(input_stream, output_file):
+    lines = input_stream.readlines()
+        
+    data = []
+    
+    for line in lines:
+        line = line.strip()
+        if not line:
+            continue
+            
+        is_commented = line.startswith('#')
+        cleaned_line = line.lstrip('#').strip() if is_commented else line
+            
+        parts = cleaned_line.split()
+        if not parts:
+            continue
+            
+        cron_expr = ""
+        raw_command = ""
+        
+        if parts[0].startswith('@'):
+            cron_expr = parts[0]
+            raw_command = " ".join(parts[1:])
+        elif len(parts) >= 5 and any(char.isdigit() or char == '*' for char in parts[0]):
+            cron_expr = " ".join(parts[:5])
+            raw_command = " ".join(parts[5:])
+        else:
+            continue
+            
+        frequency = get_categorical_frequency(cron_expr)
+        
+        # Strip the directory path from the executable
+        executable = ""
+        if raw_command:
+            executable_path = raw_command.split()[0]
+            executable = os.path.basename(executable_path)
+
+        data.append({
+            'Executable': executable,
+            'Command/Task': raw_command,
+            'Frequency Bucket': frequency,
+            'Commented Out': 'Yes' if is_commented else 'No',
+            'Raw Cron Expression': cron_expr
+        })
+        
+    with open(output_file, 'w', newline='') as csvfile:
+        fieldnames = ['Executable', 'Command/Task', 'Frequency Bucket', 'Commented Out', 'Raw Cron Expression']
+        writer = csv.DictWriter(csvfile, fieldnames=fieldnames)
+        writer.writeheader()
+        writer.writerows(data)
+    
+    print(f"Successfully processed {len(data)} cron jobs. Output saved to {output_file}.")
+
+def main():
+    parser = argparse.ArgumentParser(description="Parse and categorize cron job expressions into structured CSV reports")
+    parser.add_argument("input_file", nargs='?', type=argparse.FileType('r'), default=sys.stdin, help="The text file containing cron jobs")
+    parser.add_argument("-o", "--output", default="cron_analysis.csv", help="The output CSV file name")
+    
+    args = parser.parse_args()
+    
+    if args.input_file == sys.stdin and sys.stdin.isatty():
+        parser.error("You must provide an input file or pipe data to the command (e.g., crontab -l | cron-organize)")
+        
+    process_cron_stream(args.input_file, args.output)
+
+if __name__ == "__main__":
+    main()

cronjoborganize-0.1.1/src/cronjoborganize.egg-info/PKG-INFO

@@ -0,0 +1,35 @@
+Metadata-Version: 2.4
+Name: cronjoborganize
+Version: 0.1.1
+Summary: A command-line utility to parse and categorize cron job expressions into structured CSV reports
+Author: Moudi Alameel
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# cronjoborganize
+
+![PyPI](https://img.shields.io/pypi/v/cronjoborganize)
+![License](https://img.shields.io/pypi/l/cronjoborganize)
+![Python](https://img.shields.io/pypi/pyversions/cronjoborganize)
+
+A Python command-line tool designed to seamlessly parse and structure cron job expressions into well-organized CSV reports. 
+
+## Features
+
+* **Parse Cron Expressions:** Accurately reads standard cron scheduling syntax.
+* **CSV Reporting:** Exports your parsed cron jobs into a structured, readable CSV format for straightforward auditing and analysis.
+* **CLI Interface:** Provides a lightweight and intuitive command-line interface.
+
+## Installation
+
+You can install `cronjoborganize` directly from PyPI using pip:
+
+```bash
+pip install cronjoborganize
+```
+
+## Usage
+
+Use the tool from the command line to parse your cron files and generate reports:

cronjoborganize-0.1.1/src/cronjoborganize.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+src/cron_parser/__init__.py
+src/cron_parser/cron_parser.py
+src/cronjoborganize.egg-info/PKG-INFO
+src/cronjoborganize.egg-info/SOURCES.txt
+src/cronjoborganize.egg-info/dependency_links.txt
+src/cronjoborganize.egg-info/entry_points.txt
+src/cronjoborganize.egg-info/top_level.txt

cronjoborganize-0.1.1/src/cronjoborganize.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cronjoborganize-0.1.1/src/cronjoborganize.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+cron-organize = cron_parser.cron_parser:main

cronjoborganize-0.1.1/src/cronjoborganize.egg-info/top_level.txt

@@ -0,0 +1 @@
+cron_parser