4 releases

0.1.3 Jun 3, 2024
0.1.2 Jun 3, 2024
0.1.1 Jun 3, 2024
0.1.0 Jun 2, 2024

#323 in Configuration


Used in citrus-cli

MIT license

11KB
176 lines

citrus - a simple task manager

citrus is a simple task manager to assist your projects. With citrus, you can set up tasks containing lists of jobs and commands. You can then tell citrus to execute these functions via the command line with citrus-cli. Citrus is easy to install using cargo.

Installing citrus-cli

To install citrus-cli, simply use cargo.

cargo install citrus-cli

Using citrus-cli

Using citrus-cli is easy. Simply invoke the program using the command citrus-cli.

Configuring citrus-cli

Before you can utilize citrus-cli's task management features, you must configure it by creating a citrus-config.toml file. Start by creating a file in your project root directory called citrus-config.toml. Complete the file so that it looks like this:

[config]
task_directory = "path/to/desired/directory"

Save the file and now you may use citrus-cli.

Creating a task

Create a task by setting up a YAML file. Tasks are a list of jobs that can be represented in the following format

- name: JobName
  command: "command"

You may list as many of these as you want in your file. You may name the YAML file anything you want.

To create the task simply run the following command

citrus-cli create [task name] [file path to YAML file]

TaskName can be whatever you wish to name the task. task.yaml is the file path to the YAML file you will use to set up the task

You will notice citrus-cli output a JSON file. This file is important as it contains all of the task information.

Running a task

To run a task simply use the following command

citrus-cli run [task name]

List tasks

To list existing tasks run the following command

citrus-cli list

Deleting a task

To delete existing tasks run the following command

citrus-cli delete [task name]

Updating a task

To update a task by replacing it with a new YAML configuration run the following command

citrus-cli update [task name] [file path to YAML file]

Dependencies

~2.3–3.5MB
~72K SLoC