Metadata-Version: 2.4
Name: cronjoborganize
Version: 0.1.3
Summary: A command-line utility to parse and categorize cron job expressions into structured CSV reports
Author: Moudi Alameel
Project-URL: Homepage, https://github.com/moudialameel/cronjoborganize
Project-URL: Bug Tracker, https://github.com/moudialameel/cronjoborganize/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
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 using pip:

```bash
pip install cronjoborganize
```
## Usage

Once installed, the package provides a global command-line utility: `cron-organize`.

### 1. Analyze Live System Cron Jobs 
You can pipe your current crontab directly into the tool without needing to save it to a file first:
```bash
crontab -l | cron-organize
```

### 2. Analyze a Specific File
If you have a saved text file containing cron expressions, pass it as an argument:
```bash
cron-organize path/to/cron_jobs.txt
```

### 3. Customizing the Output
By default, the tool generates a file named `cron_analysis.csv` in your current directory. You can specify a custom output filename using the `-o` or `--output` flag:
```bash
crontab -l | cron-organize -o my_server.csv
```

### Help 
To see all available options at any time, run:
```bash
cron-organize --help
```
