Onqueue is a lightweight, multithreaded task queue runner built in Rust using Axum. It supports REST API and CLI-based task management, making it ideal for automating shell commands, deployment tasks, and lightweight job queues.

📦 Features

• ✅ Queue tasks with names and commands
• ✅ Web server using Axum with endpoints to add/list tasks
• ✅ CLI support: onqueue add, onqueue list
• ✅ Multithreaded task runner with retry support
• ✅ Persistent queue file via queue.yml
• ✅ JSON API output
• ✅ Automatic retries on failure
• ✅ Configurable apps via queue-app.yml

🧰 Usage

▶️ Running the Server

onqueue serve

Server starts on http://localhost:8080

🌐 API Endpoints

• GET / – Show welcome message
• GET /list – Return current tasks as JSON
• GET /add?name=app1&cmd=echo+Hello – Queue a new task

🖥️ CLI Usage

Add from queue-app.yml

# queue-app.yml
name: deploy
command: ansible-playbook deploy.yml

onqueue add .

List tasks

onqueue list

📂 Directory Structure

.
├── src/
├── queue.yml           # Stores all queued tasks
├── queue-app.yml       # CLI-based task configuration
├── logs/               # (planned) Directory for task execution logs
├── Cargo.toml
└── README.md

📖 Example

curl "http://localhost:8080/add?name=build&cmd=echo+Building"
curl "http://localhost:8080/list"

Output:

[
  {
    "name": "build",
    "command": "echo Building",
    "status": "completed",
    "start_time": "2025-04-07T10:00:00Z",
    "end_time": "2025-04-07T10:00:01Z",
    "retries": 0
  }
]

🛣 Roadmap

See FEATURE-TODO-LIST.md for upcoming improvements:

• Logging
• CLI formatting
• Cron-like scheduling
• Persistent task results
• PM2 integration

🧪 Development

Install dependencies:

cargo install --path .

Run in dev mode:

cargo run

⚖️ License

MIT © [Your Name or Org]