| Name | kanban-python JSON |
| Version |
0.5.1
JSON |
| download |
| home_page | None |
| Summary | Terminal Kanban App written in Python |
| upload_time | 2024-11-04 16:41:11 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | The MIT License (MIT) Copyright (c) 2023 Zaloog Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
|
<!-- These are examples of badges you might want to add to your README:
please update the URLs accordingly
[](https://cirrus-ci.com/github/<USER>/kanban-python)
[](https://kanban-python.readthedocs.io/en/stable/)
[](https://anaconda.org/conda-forge/kanban-python)
[](https://twitter.com/kanban-python)
[](https://pepy.tech/project/kanban-python)
[](https://coveralls.io/github/Zaloog/kanban-python?branch=main)
-->
[](https://pyscaffold.org/)
[](https://github.com/astral-sh/ruff)
[](https://pypi.org/project/kanban-python/)
[](https://pypi.python.org/pypi/kanban-tui)
[](https://opensource.org/licenses/MIT)
[](https://pepy.tech/project/kanban-python)
[](https://coveralls.io/github/Zaloog/kanban-python?branch=main)
# kanban-python
> A Terminal Kanban Application written in Python to boost your productivity :rocket:
## Introduction
Welcome to **kanban-python**, your Terminal Kanban-Board Manager.
The [clikan] Kanban App inspired me to write
my own Terminal Kanban Application since I preferred a more simple and guided workflow.
**kanban-python** also comes with more features, like custom column creation,
automatic scanning and customizable config file to support you being productive.
This package was initially developed with [pyscaffold], which provides awesome project templates
and takes over much of the boilerplate for python packaging.
It was a great help for developing my first package and I can highly recommend it.
With version `0.5.X` the repository structure was changed to use [uv].
## Features
<details><summary>Colorful and Interactive</summary>
- kanban-python uses [rich] under the hood to process user input
and display nice looking kanban-boards to the terminal.
- Each task has a unique `ID` per board and also has an optional `Tag` and `Due Date` associated with it,
which are displayed alongside its `Title`
</details>
<details><summary>Following the XDG basedir convention</summary>
- kanban-python utilizes [platformdirs] `user_config_dir` to save the config file and `user_data_dir` for
the board specific task files. After creating your first board, you can use `kanban configure` to show the current settings table.
The config path in the table caption and the path for the task files can be found in the kanban_boards section.
</details>
<details><summary>Scanning of Files for automatic Task Creation</summary>
- kanban-python can scan files of defined types for specific patterns at start of line.
Check [Automatic Task Creation](#automatic-task-creation) for more Infos.
</details>
<details><summary>Customizable Configfile</summary>
- A `pykanban.ini` file gets created on first initialization in a `kanban-python` folder in your `user_config_dir`-Directory.
This can be edited manually or within the kanban-python application. It tracks the location for all your created boards. \
* `Active_Board`: current board that is shown when using `kanban`-command
* `Done_Limit`: If the amount of tasks exceed this number in the <span style="color:green">Done</span> column,
the first task of that column gets its status updated to <span style="color:gold">Archived</span> and is moved into that column. (default: `10`)
* `Column_Min_Width`: Sets the minimum width of columns. (default: `40`)
* `Show_Footer`: Shows the table footer with package name and version. (default: `True`)
* `Files`: Space seperated filetypes to search for patterns to create tasks. (default: `.py .md`)
* `Patterns`: Comma seperated patterns to search for start of line to create tasks. <br />(default: `# TODO,#TODO,# BUG`)
</details>
<details><summary>Task Storage File for each Board</summary>
- Each created board comes with its own name and `pykanban.json` file,
which stores all tasks for that board. The files are stored in board specific folders under `$USER_DATA_DIR/kanban-python/kanban_boards/<BOARDNAME>`.
When changing Boards you also get an overview over tasks in visible columns for each board and the most urgent or overdue task on that board.
</details>
<details><summary>Customizable Columns</summary>
- kanban-python comes with 5 pre-defined colored columns: [Ready, Doing, Done, Archived, Deleted]
More column can be added manually in the `pykanban.ini`, the visibility can be configured in the settings
with `kanban configure`.
</details>
<details><summary>Time Tracking of Task duration in Doing</summary>
- For each task it is tracked, how long it was in the
<span style="color:yellow">Doing</span> column, based on the moments when you update the task status.
The initial Task structure on creation looks as follows:
</details>
<details><summary>Report Creation for completed Tasks</summary>
- When you use [kanban report](#create-report) a github-like contribution map is displayed for the current year,
Also a markdown file is created with all tasks comleted based on the moment, when the tasks were moved to Done Column.
</details>
## Installation
You can install kanban-python with:
```bash
python -m pip install kanban-python
```
or using [pipx] / [uv] / [rye]:
```bash
pipx install kanban-python # using pipx
uv tool install kanban-python # using uv
rye install kanban-python # using rye
```
I recommend using pipx, rye or uv to install CLI Tools into an isolated environment.
## Usage
After Installation of kanban-python, there are 5 commands available:
### Create new Boards
```bash
kanban init
```
Is used to create a new kanban board i.e. it asks for a name and then creates a `pykanban.json` file with a Welcome Task.
On first use of any command, the `pykanban.ini` configfile and the `kanban-python` folder will be created automatically.
You can create local boards in the current working directory by using the name `local` or the flags `-l` or `--local` when
using `kanban init`. kanban-python checks for local boards and updates the config file accordingly.
Local boards can only be accessed when using `kanban` in the same folder.
### Interact with Tasks/Boards
```bash
kanban
```
This is your main command to interact with your boards and tasks. It also gives the option to show the current settings and adjust them.
Adjusting the settings can also be done directly by using the command `kanban configure`:
Use `Ctrl-C` or `Ctrl-D` to exit the application at any time. :warning: If you exit in the middle of creating/updating a task,
or changing settings, your progress wont be saved.
### Automatic Task Creation
```bash
kanban scan
```
After executing this command, kanban-python scans your current directory recursively for the defined filetypes and searches for lines
that start with the pattern provided.
After confirmation to add the found tasks to table they will be added to the board. The alphanumeric Part of the Pattern will be used as tag.
The filepath were the task was found will be added as description of the task.
You can also define a different path to scan with the `-p` or `--path` argument.
### Create Report
```bash
kanban report
```
Goes over all your Boards and creates a single markdown file by checking the `Completion Dates` of your tasks.
Also shows a nice github-like contribution table for the current year.
You can define a different output path of the `pykanban.md` report file with the `-p` or `--path` argument.
### Change Settings
```bash
kanban configure
```
To create a new custom Column, you have to edit the `pykanban.ini` manually and add a new column name + visibility status
under the `settings.columns.visible` section. The other options are all customizable now via the new settings menu.
## Feedback and Issues
Feel free to reach out and share your feedback, or open an Issue, if something doesnt work as expected.
Also check the [Changelog](https://github.com/Zaloog/kanban-python/blob/main/CHANGELOG.md) for new updates.
:warning:
With release v0.3.0 kanban-python switched to the [XDG] Basedir Spec. So some file migrations and config edits might be
needed to continue working with your already created boards if you update from `v0.2.X` to `v0.3.X`
[XDG]: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html
[platformdirs]: https://platformdirs.readthedocs.io/en/latest/
[clikan]: https://github.com/kitplummer/clikan
[pyscaffold]: https://pyscaffold.org/
[rich]: https://github.com/Textualize/rich
[pipx]: https://github.com/pypa/pipx
[uv]: https://docs.astral.sh/uv/
[rye]: https://rye.astral.sh
Raw data
{
"_id": null,
"home_page": null,
"name": "kanban-python",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "Zaloog <gramslars@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/86/44/6569faec809bf47e45aa4b387e09f3216125fdf66caee97bc978185cff6a/kanban_python-0.5.1.tar.gz",
"platform": null,
"description": "<!-- These are examples of badges you might want to add to your README:\n please update the URLs accordingly\n\n[](https://cirrus-ci.com/github/<USER>/kanban-python)\n[](https://kanban-python.readthedocs.io/en/stable/)\n[](https://anaconda.org/conda-forge/kanban-python)\n[](https://twitter.com/kanban-python)\n[](https://pepy.tech/project/kanban-python)\n[](https://coveralls.io/github/Zaloog/kanban-python?branch=main)\n-->\n\n[](https://pyscaffold.org/)\n[](https://github.com/astral-sh/ruff)\n[](https://pypi.org/project/kanban-python/)\n[](https://pypi.python.org/pypi/kanban-tui)\n[](https://opensource.org/licenses/MIT)\n[](https://pepy.tech/project/kanban-python)\n[](https://coveralls.io/github/Zaloog/kanban-python?branch=main)\n# kanban-python\n\n> A Terminal Kanban Application written in Python to boost your productivity :rocket:\n\n## Introduction\nWelcome to **kanban-python**, your Terminal Kanban-Board Manager.\n\n\nThe [clikan] Kanban App inspired me to write\nmy own Terminal Kanban Application since I preferred a more simple and guided workflow.\n\n**kanban-python** also comes with more features, like custom column creation,\nautomatic scanning and customizable config file to support you being productive.\n\nThis package was initially developed with [pyscaffold], which provides awesome project templates\nand takes over much of the boilerplate for python packaging.\nIt was a great help for developing my first package and I can highly recommend it.\nWith version `0.5.X` the repository structure was changed to use [uv].\n\n## Features\n<details><summary>Colorful and Interactive</summary>\n\n- kanban-python uses [rich] under the hood to process user input\nand display nice looking kanban-boards to the terminal.\n- Each task has a unique `ID` per board and also has an optional `Tag` and `Due Date` associated with it,\nwhich are displayed alongside its `Title`\n\n</details>\n\n\n<details><summary>Following the XDG basedir convention</summary>\n\n- kanban-python utilizes [platformdirs] `user_config_dir` to save the config file and `user_data_dir` for\nthe board specific task files. After creating your first board, you can use `kanban configure` to show the current settings table.\nThe config path in the table caption and the path for the task files can be found in the kanban_boards section.\n\n</details>\n\n\n<details><summary>Scanning of Files for automatic Task Creation</summary>\n\n- kanban-python can scan files of defined types for specific patterns at start of line.\nCheck [Automatic Task Creation](#automatic-task-creation) for more Infos.\n\n</details>\n\n\n<details><summary>Customizable Configfile</summary>\n\n- A `pykanban.ini` file gets created on first initialization in a `kanban-python` folder in your `user_config_dir`-Directory.\nThis can be edited manually or within the kanban-python application. It tracks the location for all your created boards. \\\n\n * `Active_Board`: current board that is shown when using `kanban`-command\n * `Done_Limit`: If the amount of tasks exceed this number in the <span style=\"color:green\">Done</span> column,\n the first task of that column gets its status updated to <span style=\"color:gold\">Archived</span> and is moved into that column. (default: `10`)\n * `Column_Min_Width`: Sets the minimum width of columns. (default: `40`)\n * `Show_Footer`: Shows the table footer with package name and version. (default: `True`)\n * `Files`: Space seperated filetypes to search for patterns to create tasks. (default: `.py .md`)\n * `Patterns`: Comma seperated patterns to search for start of line to create tasks. <br />(default: `# TODO,#TODO,# BUG`)\n\n</details>\n\n\n<details><summary>Task Storage File for each Board</summary>\n\n- Each created board comes with its own name and `pykanban.json` file,\nwhich stores all tasks for that board. The files are stored in board specific folders under `$USER_DATA_DIR/kanban-python/kanban_boards/<BOARDNAME>`.\nWhen changing Boards you also get an overview over tasks in visible columns for each board and the most urgent or overdue task on that board.\n\n\n</details>\n\n\n<details><summary>Customizable Columns</summary>\n\n- kanban-python comes with 5 pre-defined colored columns: [Ready, Doing, Done, Archived, Deleted]\nMore column can be added manually in the `pykanban.ini`, the visibility can be configured in the settings\nwith `kanban configure`.\n\n</details>\n\n\n<details><summary>Time Tracking of Task duration in Doing</summary>\n\n- For each task it is tracked, how long it was in the\n <span style=\"color:yellow\">Doing</span> column, based on the moments when you update the task status.\n The initial Task structure on creation looks as follows:\n\n\n</details>\n\n\n<details><summary>Report Creation for completed Tasks</summary>\n\n- When you use [kanban report](#create-report) a github-like contribution map is displayed for the current year,\nAlso a markdown file is created with all tasks comleted based on the moment, when the tasks were moved to Done Column.\n\n\n</details>\n\n## Installation\nYou can install kanban-python with:\n```bash\npython -m pip install kanban-python\n```\n\nor using [pipx] / [uv] / [rye]:\n```bash\npipx install kanban-python # using pipx\nuv tool install kanban-python # using uv\nrye install kanban-python # using rye\n```\nI recommend using pipx, rye or uv to install CLI Tools into an isolated environment.\n\n## Usage\nAfter Installation of kanban-python, there are 5 commands available:\n\n### Create new Boards\n ```bash\n kanban init\n ```\nIs used to create a new kanban board i.e. it asks for a name and then creates a `pykanban.json` file with a Welcome Task.\nOn first use of any command, the `pykanban.ini` configfile and the `kanban-python` folder will be created automatically.\n\n\nYou can create local boards in the current working directory by using the name `local` or the flags `-l` or `--local` when\nusing `kanban init`. kanban-python checks for local boards and updates the config file accordingly.\nLocal boards can only be accessed when using `kanban` in the same folder.\n\n### Interact with Tasks/Boards\n ```bash\n kanban\n ```\nThis is your main command to interact with your boards and tasks. It also gives the option to show the current settings and adjust them.\nAdjusting the settings can also be done directly by using the command `kanban configure`:\n\n\nUse `Ctrl-C` or `Ctrl-D` to exit the application at any time. :warning: If you exit in the middle of creating/updating a task,\nor changing settings, your progress wont be saved.\n\n### Automatic Task Creation\n ```bash\n kanban scan\n ```\nAfter executing this command, kanban-python scans your current directory recursively for the defined filetypes and searches for lines\nthat start with the pattern provided.\n\n\nAfter confirmation to add the found tasks to table they will be added to the board. The alphanumeric Part of the Pattern will be used as tag.\nThe filepath were the task was found will be added as description of the task.\n\n\nYou can also define a different path to scan with the `-p` or `--path` argument.\n\n### Create Report\n ```bash\n kanban report\n ```\nGoes over all your Boards and creates a single markdown file by checking the `Completion Dates` of your tasks.\nAlso shows a nice github-like contribution table for the current year.\n\n\nYou can define a different output path of the `pykanban.md` report file with the `-p` or `--path` argument.\n\n### Change Settings\n ```bash\n kanban configure\n ```\n\n\nTo create a new custom Column, you have to edit the `pykanban.ini` manually and add a new column name + visibility status\nunder the `settings.columns.visible` section. The other options are all customizable now via the new settings menu.\n\n\n## Feedback and Issues\nFeel free to reach out and share your feedback, or open an Issue, if something doesnt work as expected.\nAlso check the [Changelog](https://github.com/Zaloog/kanban-python/blob/main/CHANGELOG.md) for new updates.\n\n:warning:\nWith release v0.3.0 kanban-python switched to the [XDG] Basedir Spec. So some file migrations and config edits might be\nneeded to continue working with your already created boards if you update from `v0.2.X` to `v0.3.X`\n\n\n\n[XDG]: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html\n[platformdirs]: https://platformdirs.readthedocs.io/en/latest/\n[clikan]: https://github.com/kitplummer/clikan\n[pyscaffold]: https://pyscaffold.org/\n[rich]: https://github.com/Textualize/rich\n[pipx]: https://github.com/pypa/pipx\n[uv]: https://docs.astral.sh/uv/\n[rye]: https://rye.astral.sh\n",
"bugtrack_url": null,
"license": "The MIT License (MIT) Copyright (c) 2023 Zaloog Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.",
"summary": "Terminal Kanban App written in Python",
"version": "0.5.1",
"project_urls": {
"Changelog": "https://github.com/Zaloog/kanban-python/blob/main/CHANGELOG.md",
"Repository": "https://github.com/Zaloog/kanban-python"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "1e839af14710f74fa3de08ed35b02bca2590890879d16e6e8224e409a67113ea",
"md5": "cdfc6cbce1d298f852b197a398f903f2",
"sha256": "ec97a80fabaef03d93237774c6ce83562736f896c3fe070667f8a340557b8a20"
},
"downloads": -1,
"filename": "kanban_python-0.5.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cdfc6cbce1d298f852b197a398f903f2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 22581,
"upload_time": "2024-11-04T16:41:10",
"upload_time_iso_8601": "2024-11-04T16:41:10.807208Z",
"url": "https://files.pythonhosted.org/packages/1e/83/9af14710f74fa3de08ed35b02bca2590890879d16e6e8224e409a67113ea/kanban_python-0.5.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "86446569faec809bf47e45aa4b387e09f3216125fdf66caee97bc978185cff6a",
"md5": "956ce41ceddbb2ad3462f33c3d2f63af",
"sha256": "f69596b42f9c196139aea0c96753851245d87864f95a13625f44abe06c54749f"
},
"downloads": -1,
"filename": "kanban_python-0.5.1.tar.gz",
"has_sig": false,
"md5_digest": "956ce41ceddbb2ad3462f33c3d2f63af",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 386714,
"upload_time": "2024-11-04T16:41:11",
"upload_time_iso_8601": "2024-11-04T16:41:11.900176Z",
"url": "https://files.pythonhosted.org/packages/86/44/6569faec809bf47e45aa4b387e09f3216125fdf66caee97bc978185cff6a/kanban_python-0.5.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-04 16:41:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Zaloog",
"github_project": "kanban-python",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "kanban-python"
}
