<p align="center" style="padding-top:20px">
<img width="100px" src="static/img/logo.svg" align="center" alt="GitHub Readme Stats" />
<h1 align="center">Taskfile Server</h1>
<p align="center">Taskfile Server is a web application, to run and manage <a href="https://taskfile.dev/">Taskfile</a> automations.</p>
</p>
<p align="center">
<a href="https://www.python.org/">
<img src="https://img.shields.io/badge/Python%20-3.10+%20-gray.svg?colorA=c9177e&colorB=FF4088&style=for-the-badge"/>
</a>
<a href="https://tailwindcss.com/">
<img src="https://img.shields.io/badge/TailwindCSS%20-V3-gray.svg?colorA=0284c7&colorB=38bdf8&style=for-the-badge"/>
</a>
<a href="https://alpinejs.dev/">
<img src="https://img.shields.io/badge/Alpine.js%20-V3-gray.svg?colorA=68a5af&colorB=77c1d2&style=for-the-badge"/>
</a>
</p>
<p align="center">
<a href="https://shiny-goggles-6xgx47v769f4974-9999.app.github.dev/taskserver">View Demo</a>
ยท
<a href="https://github.com/planet-lodder/taskserver.py/issues">Report Bug</a>
</p>
</p>
> This project is heavily inspired by [Taskfile.dev](https://taskfile.dev/), and built on top of it's functionality.
## Features
Features include:
- a web user interface
- spawning and managing tasks
- modify task vars before run
- configurable taskfiles
- show execution path (with full drill down)
Features that are not included (yet):
- Authentication and Authorization of users (eg: local only)
- Multitenancy and user based run contexts, permissions
- Security hardening and Threat Analysis report(s)
### Web User Interface (with dark mode support)
We support both light and dark mode (auto detects from browser settings):
### Spawning and managing tasks
This project would be incomplete without the ability to spawn an actual task. To achieve this, we implemented a simple REST API that can handle invocations of tasks.
> Currently this is limited to the running context of the web server, so **should not be used in a production environment**. It works great as a local-only solution to manage tasks outside of the command line.
In a future release, we do envision implementing mechanisms to allow user permissions and context, but for now this is outside of the scope of the project.
### Extending task variables
You can add custom task variables, to be attached to a specific run. This enables you to supply user input to the underlying task.
### Configurable Taskfiles
Taskfiles can be viewed and modified (to some extent), with the focus being on:
- Adding or modifying task `includes`'s (with some validations).
- Setting or overriding default `Environment Variables`.
- Defining global `Taskfile Variables`.
### Showing execution breakdown
One nice feature we have is the ability to do a task execution breakdown. We use the `--dry` run feature of taskfile's, to plan out and parse the execution, before running it.
This has two advantages:
- For oversight: Know the commands you are about to execute...
- Track task execution: See where exactly the task fails, and for what reason.
## Motivation
Taskfile works well for automating all kinds of tasks. Some features include:
- It's declared in a simple, machine-readable file format (YAML).
- Task varibales make it easy to define defaults and overrides.
- We can use `includes`, making it composable / extensible.
- Task caching and run metadata make it efficient and fast.
- Good support for debugging, dry-run of tasks (with execution plans).
As your taskfile's become larger and more complicated, it becomes harder to manage and understand.
We try to tackle this problem by giving more advanced tooling around managing these task automations from a web interface, with the ability to track execution steps in near real time.
Raw data
{
"_id": null,
"home_page": "https://github.com/planet-lodder/taskserver.py",
"name": "taskserver",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "taskfile,http,server",
"author": "Club404",
"author_email": "info@club404.io",
"download_url": "https://files.pythonhosted.org/packages/f3/91/196ad70c4643c849fdecab8424f6619ad137b3fe106f3544b293843adc00/taskserver-0.0.5.tar.gz",
"platform": null,
"description": "<p align=\"center\" style=\"padding-top:20px\">\n <img width=\"100px\" src=\"static/img/logo.svg\" align=\"center\" alt=\"GitHub Readme Stats\" />\n <h1 align=\"center\">Taskfile Server</h1>\n <p align=\"center\">Taskfile Server is a web application, to run and manage <a href=\"https://taskfile.dev/\">Taskfile</a> automations.</p>\n</p>\n <p align=\"center\"> \n <a href=\"https://www.python.org/\">\n <img src=\"https://img.shields.io/badge/Python%20-3.10+%20-gray.svg?colorA=c9177e&colorB=FF4088&style=for-the-badge\"/>\n </a>\n <a href=\"https://tailwindcss.com/\">\n <img src=\"https://img.shields.io/badge/TailwindCSS%20-V3-gray.svg?colorA=0284c7&colorB=38bdf8&style=for-the-badge\"/>\n </a>\n <a href=\"https://alpinejs.dev/\">\n <img src=\"https://img.shields.io/badge/Alpine.js%20-V3-gray.svg?colorA=68a5af&colorB=77c1d2&style=for-the-badge\"/>\n </a>\n </p>\n\n <p align=\"center\">\n <a href=\"https://shiny-goggles-6xgx47v769f4974-9999.app.github.dev/taskserver\">View Demo</a>\n \u00b7\n <a href=\"https://github.com/planet-lodder/taskserver.py/issues\">Report Bug</a>\n </p>\n</p>\n\n> This project is heavily inspired by [Taskfile.dev](https://taskfile.dev/), and built on top of it's functionality.\n\n## Features\n\nFeatures include:\n\n- a web user interface\n- spawning and managing tasks\n- modify task vars before run\n- configurable taskfiles\n- show execution path (with full drill down)\n\nFeatures that are not included (yet):\n\n- Authentication and Authorization of users (eg: local only)\n- Multitenancy and user based run contexts, permissions\n- Security hardening and Threat Analysis report(s)\n\n### Web User Interface (with dark mode support)\n\nWe support both light and dark mode (auto detects from browser settings):\n\n\n\n\n\n### Spawning and managing tasks\n\nThis project would be incomplete without the ability to spawn an actual task. To achieve this, we implemented a simple REST API that can handle invocations of tasks.\n\n\n\n> Currently this is limited to the running context of the web server, so **should not be used in a production environment**. It works great as a local-only solution to manage tasks outside of the command line.\n\nIn a future release, we do envision implementing mechanisms to allow user permissions and context, but for now this is outside of the scope of the project.\n\n### Extending task variables\n\nYou can add custom task variables, to be attached to a specific run. This enables you to supply user input to the underlying task.\n\n\n\n### Configurable Taskfiles\n\nTaskfiles can be viewed and modified (to some extent), with the focus being on:\n\n- Adding or modifying task `includes`'s (with some validations).\n- Setting or overriding default `Environment Variables`.\n- Defining global `Taskfile Variables`.\n\n\n\n### Showing execution breakdown\n\nOne nice feature we have is the ability to do a task execution breakdown. We use the `--dry` run feature of taskfile's, to plan out and parse the execution, before running it.\n\nThis has two advantages:\n\n- For oversight: Know the commands you are about to execute...\n- Track task execution: See where exactly the task fails, and for what reason.\n\n\n\n## Motivation\n\nTaskfile works well for automating all kinds of tasks. Some features include:\n\n- It's declared in a simple, machine-readable file format (YAML).\n- Task varibales make it easy to define defaults and overrides.\n- We can use `includes`, making it composable / extensible.\n- Task caching and run metadata make it efficient and fast.\n- Good support for debugging, dry-run of tasks (with execution plans).\n\nAs your taskfile's become larger and more complicated, it becomes harder to manage and understand.\n\nWe try to tackle this problem by giving more advanced tooling around managing these task automations from a web interface, with the ability to track execution steps in near real time.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Simple task server built on top of Taskfile",
"version": "0.0.5",
"project_urls": {
"Download": "https://github.com/planet-lodder/taskserver.py/archive/refs/tags/0.0.5.tar.gz",
"Homepage": "https://github.com/planet-lodder/taskserver.py"
},
"split_keywords": [
"taskfile",
"http",
"server"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f391196ad70c4643c849fdecab8424f6619ad137b3fe106f3544b293843adc00",
"md5": "e5fd84a0e98a091b26df0fa5c08cec03",
"sha256": "d76510a308b888cdc40810bfb057f52813212ee6a18889b0d63de2d69e0e1ba7"
},
"downloads": -1,
"filename": "taskserver-0.0.5.tar.gz",
"has_sig": false,
"md5_digest": "e5fd84a0e98a091b26df0fa5c08cec03",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 53354,
"upload_time": "2023-11-14T10:47:41",
"upload_time_iso_8601": "2023-11-14T10:47:41.898452Z",
"url": "https://files.pythonhosted.org/packages/f3/91/196ad70c4643c849fdecab8424f6619ad137b3fe106f3544b293843adc00/taskserver-0.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-14 10:47:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "planet-lodder",
"github_project": "taskserver.py",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "taskserver"
}
JSON
