stescobedo/BinaryCoffee.SchedulingTaskv1.0.4

☕ ScheduleYourTask

Crontab is a task scheduling tool on Unix and Linux operating systems that allows for programming the execution of commands at specific times, either repeatedly or at a one-time occurrence.

The basic syntax of a Crontab command consists of five fields separated by spaces that define the time of execution:

• Minute (0-59)
• Hour (0-23)
• Day of the Month (1-31)
• Month (1-12)
• Day of the Week (0-6, where 0 is Sunday)

For example:

0 12 * * *

This command will execute a task every day at 12:00 PM.

⏰ Common Usage Patterns

• Repeating tasks: Execute tasks at regular intervals (e.g., every minute, hour, day, week, or month).
• Specific days and times: Run tasks at precise schedules (e.g., weekdays at 9:00 AM).
• Complex schedules: Combine fields for advanced timing (e.g., every weekday at 9:00 AM and 5:00 PM).

Crontab simplifies system administration and automates routine tasks, making workflows more efficient.

☕ BinaryCoffee.ScheduleYourTask

BinaryCoffee.ScheduleYourTask is a .NET package that brings the power of Crontab scheduling to the .NET platform. It enables developers to interact with crontab configurations programmatically.

Features ✨

• Retrieve existing crontab entries.
• Add or remove tasks with unique identifiers.
• Enable or disable tasks dynamically.
• Export or import crontab configurations.
• Track changes and maintain backups of crontab files.

🚀 How to Use the Package

1. Include the package in your project: Install from NuGet: BinaryCoffee.ScheduleYourTask

2. Declare the namespace:

   using SchedulingTasks;

3. Access the functionality: Use methods like Crontab.GetCrontab() to interact with crontab entries programmatically.

Example Usage 💻

Retrieve Existing Tasks

using SchedulingTasks; // Retrieve existing tasks var tasks = Crontab.GetCrontab(); Console.WriteLine("Current Crontab Entries:"); Console.WriteLine(tasks);

Add a New Task

using SchedulingTasks; // Add a new task to run a script daily at 2 AM string task = "0 2 * * * /path/to/your/script.sh"; Crontab.AddTask(task); Console.WriteLine("Task added successfully.");

Remove a Task

using SchedulingTasks; // Remove a task using its unique identifier string taskIdentifier = "your-unique-identifier"; Crontab.RemoveTask(taskIdentifier); Console.WriteLine("Task removed successfully.");

Enable or Disable a Task

using SchedulingTasks; // Enable a task string taskIdentifier = "your-unique-identifier"; Crontab.EnableDisableTask(taskIdentifier, true); Console.WriteLine("Task enabled successfully."); // Disable a task Crontab.EnableDisableTask(taskIdentifier, false); Console.WriteLine("Task disabled successfully.");

Export Tasks to a File

using SchedulingTasks; // Export crontab configuration to a file string filePath = "/path/to/exported_crontab.txt"; Crontab.ExportTasks(filePath); Console.WriteLine($"Crontab exported to {filePath}.");

Import Tasks from a File

using SchedulingTasks; // Import tasks from a file string filePath = "/path/to/imported_crontab.txt"; Crontab.ImportTasks(filePath); Console.WriteLine("Crontab imported successfully.");

Track Changes and Create Backups

using SchedulingTasks; // Track changes to crontab Crontab.TrackCrontabChanges(); Console.WriteLine("Crontab changes tracked and backup created.");

📖 Documentation

Methods Available

• Crontab.GetCrontab(): Retrieves the current crontab configuration.

• Crontab.AddTask(string task): Adds a new task to the crontab.

• Crontab.RemoveTask(string taskIdentifier): Removes a task by its unique identifier.

• Crontab.EnableDisableTask(string taskIdentifier, bool enable): Enables or disables a task by toggling comments.

• Crontab.ExportTasks(string filePath): Exports the crontab configuration to a file.

• Crontab.ImportTasks(string filePath): Imports tasks from a crontab file.

• Crontab.TrackCrontabChanges(): Tracks changes to crontab by creating timestamped backups.

📌 Stickers for Enrichment

• ⏰ Scheduling made simple.
• 💻 .NET Integration for Crontab.
• 🚀 Automate your workflows effortlessly.
• 📂 Manage your tasks programmatically.

🛠️ Contributing

Feel free to contribute by submitting issues or pull requests to the GitHub Repository.

---

Made with ☕ by BinaryCoffee.