todol 0.3.1__tar.gz

todol-0.3.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wattox
+
+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.

todol-0.3.1/PKG-INFO

@@ -0,0 +1,188 @@
+Metadata-Version: 2.4
+Name: todol
+Version: 0.3.1
+Summary: A python TUI todo app
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: prompt_toolkit>=3.0.52
+Requires-Dist: platformdirs>=4.5.1
+Requires-Dist: rich>=14.2.0
+Requires-Dist: requests>=2.32.5
+Dynamic: license-file
+
+# Todol - Python TUI ToDo app
+
+## Installation
+
+```
+pip install todol
+```
+
+`todol` is a terminal application. I recommend installing it with `pipx`.
+
+More Info
+
+- Check out the project page on PyPi: [https://pypi.org/project/todol/](https://pypi.org/project/todol/)
+- and on Github: [https://github.com/WattoX00/todol](https://github.com/WattoX00/todol)
+
+![Demo](assets/demo.png)
+
+## Running
+
+### Run from anywhere in your terminal
+
+```
+todol
+```
+
+### Additional flags
+
+View all flags (for more options):
+
+```
+todol-help
+```
+
+Check the current version:
+
+```
+todol-version
+```
+
+See where todo files are saved:
+
+```
+todol-path
+```
+
+Update todol with a single command
+
+This runs `pipx upgrade todol` under the hood.
+
+```
+todol-upgrade
+```
+
+## COMMAND GUIDE
+
+```
+ Command     Alias      Action          Usage 
+
+ add         a       Add new task       add [task]
+ done        d       Mark task done     done [id]
+ list        l       Show todo list     list
+ remove      rm      Remove task        rm [id]
+ edit        e       Edit task          edit [id]
+ clear       c       Clear done tasks   clear
+ help        h       Show help          help
+ reload    reset     Reload the app     reload
+ exit        0       Exit app           exit
+```
+### Pro Tips: 
+- You can use Tab for autocomplete.
+- Navigate the terminal efficiently: arrow keys, backspace, and delete all work.
+- You can execute multiple commands at once:
+    - all - apply the command to all items
+
+    - id-id – apply the command to a range of IDs
+
+    - id1 id2 id3 – apply the command to specific IDs
+
+### examples:
+
+```
+done all       # marks all tasks as done
+remove 4-7     # removes tasks with IDs 4 through 7
+rm 3 5 8       # removes tasks 3, 5, and 8
+```
+
+## FAQ
+
+### Where are the saved todo files stored?
+
+#### You can simply check it by running `todol-path`
+
+`todol` stores its data using `platformdirs.user_data_dir`, which means files are written to the standard user data directory for each operating system.
+
+#### Default locations
+
+- **Linux**
+`~/.local/share/todol/todoFiles/`
+
+- **macOS**
+`~/Library/Application Support/todol/todoFiles/`
+
+- **Windows**
+`%APPDATA%\todol\todoFiles\`
+
+## Hotkeys are available!
+
+### Cursor navigation
+
+| Key      | Action                           |
+| -------- | -------------------------------- |
+| `Ctrl‑a` | Move cursor to beginning of line |
+| `Ctrl‑e` | Move cursor to end of line       |
+| `Ctrl‑f` | Move cursor forward (right)      |
+| `Ctrl‑b` | Move cursor backward (left)      |
+| `Alt‑f`  | Move forward one word            |
+| `Alt‑b`  | Move backward one word           |
+| `Home`   | Go to start of line              |
+| `End`    | Go to end of line                |
+
+### Editing
+
+| Key                    | Action                         |
+| ---------------------- | ------------------------------ |
+| `Ctrl‑d`               | Delete character under cursor  |
+| `Ctrl‑h` / `Backspace` | Delete character before cursor |
+| `Alt‑d`                | Delete word forward            |
+| `Ctrl‑k`               | Kill (cut) text to end of line |
+| `Ctrl‑y`               | Yank (paste) killed text       |
+| `Ctrl‑t`               | Transpose characters           |
+
+### History
+
+| Key      | Action                |
+| -------- | --------------------- |
+| `Ctrl‑p` | Previous history item |
+| `Ctrl‑n` | Next history item     |
+
+### Searching
+
+| Key      | Action                                                                 |
+| -------- | ---------------------------------------------------------------------- |
+| `Ctrl‑r` | Reverse search history                                                 |
+| `Ctrl‑s` | Forward search history *(may be intercepted by terminal flow control)* |
+
+### Completion & Accept
+
+| Key          | Action                   |
+| ------------ | ------------------------ |
+| `Tab`        | Trigger completion       |
+| `Ctrl‑Space` | Start/advance completion |
+| `Enter`      | Accept input             |
+
+### Misc
+
+| Key        | Action                               |
+| ---------- | ------------------------------------ |
+| `Ctrl‑c`   | Cancel / raise KeyboardInterrupt     |
+| `Ctrl‑z`   | Suspend (depends on shell)           |
+| `Escape`   | Escape/Meta prefix for `Alt‑` combos |
+| Arrow keys | Move cursor up/down/left/right       |
+
+For the full official key binding documentation, check the prompt_toolkit docs: [prompt_toolkit GITHUB](https://github.com/prompt-toolkit/python-prompt-toolkit)
+
+## Support
+
+If you find this project helpful and would like to support its development, you can make a donation via the following method:
+
+- [PayPal](https://www.paypal.com/paypalme/wattox)
+
+Your contribution helps in maintaining and improving the app. Thank you for your support!
+
+## License
+
+This project is licensed under the [MIT License](LICENSE) - see the [LICENSE](LICENSE) file for details.

todol-0.3.1/README.md

@@ -0,0 +1,175 @@
+# Todol - Python TUI ToDo app
+
+## Installation
+
+```
+pip install todol
+```
+
+`todol` is a terminal application. I recommend installing it with `pipx`.
+
+More Info
+
+- Check out the project page on PyPi: [https://pypi.org/project/todol/](https://pypi.org/project/todol/)
+- and on Github: [https://github.com/WattoX00/todol](https://github.com/WattoX00/todol)
+
+![Demo](assets/demo.png)
+
+## Running
+
+### Run from anywhere in your terminal
+
+```
+todol
+```
+
+### Additional flags
+
+View all flags (for more options):
+
+```
+todol-help
+```
+
+Check the current version:
+
+```
+todol-version
+```
+
+See where todo files are saved:
+
+```
+todol-path
+```
+
+Update todol with a single command
+
+This runs `pipx upgrade todol` under the hood.
+
+```
+todol-upgrade
+```
+
+## COMMAND GUIDE
+
+```
+ Command     Alias      Action          Usage 
+
+ add         a       Add new task       add [task]
+ done        d       Mark task done     done [id]
+ list        l       Show todo list     list
+ remove      rm      Remove task        rm [id]
+ edit        e       Edit task          edit [id]
+ clear       c       Clear done tasks   clear
+ help        h       Show help          help
+ reload    reset     Reload the app     reload
+ exit        0       Exit app           exit
+```
+### Pro Tips: 
+- You can use Tab for autocomplete.
+- Navigate the terminal efficiently: arrow keys, backspace, and delete all work.
+- You can execute multiple commands at once:
+    - all - apply the command to all items
+
+    - id-id – apply the command to a range of IDs
+
+    - id1 id2 id3 – apply the command to specific IDs
+
+### examples:
+
+```
+done all       # marks all tasks as done
+remove 4-7     # removes tasks with IDs 4 through 7
+rm 3 5 8       # removes tasks 3, 5, and 8
+```
+
+## FAQ
+
+### Where are the saved todo files stored?
+
+#### You can simply check it by running `todol-path`
+
+`todol` stores its data using `platformdirs.user_data_dir`, which means files are written to the standard user data directory for each operating system.
+
+#### Default locations
+
+- **Linux**
+`~/.local/share/todol/todoFiles/`
+
+- **macOS**
+`~/Library/Application Support/todol/todoFiles/`
+
+- **Windows**
+`%APPDATA%\todol\todoFiles\`
+
+## Hotkeys are available!
+
+### Cursor navigation
+
+| Key      | Action                           |
+| -------- | -------------------------------- |
+| `Ctrl‑a` | Move cursor to beginning of line |
+| `Ctrl‑e` | Move cursor to end of line       |
+| `Ctrl‑f` | Move cursor forward (right)      |
+| `Ctrl‑b` | Move cursor backward (left)      |
+| `Alt‑f`  | Move forward one word            |
+| `Alt‑b`  | Move backward one word           |
+| `Home`   | Go to start of line              |
+| `End`    | Go to end of line                |
+
+### Editing
+
+| Key                    | Action                         |
+| ---------------------- | ------------------------------ |
+| `Ctrl‑d`               | Delete character under cursor  |
+| `Ctrl‑h` / `Backspace` | Delete character before cursor |
+| `Alt‑d`                | Delete word forward            |
+| `Ctrl‑k`               | Kill (cut) text to end of line |
+| `Ctrl‑y`               | Yank (paste) killed text       |
+| `Ctrl‑t`               | Transpose characters           |
+
+### History
+
+| Key      | Action                |
+| -------- | --------------------- |
+| `Ctrl‑p` | Previous history item |
+| `Ctrl‑n` | Next history item     |
+
+### Searching
+
+| Key      | Action                                                                 |
+| -------- | ---------------------------------------------------------------------- |
+| `Ctrl‑r` | Reverse search history                                                 |
+| `Ctrl‑s` | Forward search history *(may be intercepted by terminal flow control)* |
+
+### Completion & Accept
+
+| Key          | Action                   |
+| ------------ | ------------------------ |
+| `Tab`        | Trigger completion       |
+| `Ctrl‑Space` | Start/advance completion |
+| `Enter`      | Accept input             |
+
+### Misc
+
+| Key        | Action                               |
+| ---------- | ------------------------------------ |
+| `Ctrl‑c`   | Cancel / raise KeyboardInterrupt     |
+| `Ctrl‑z`   | Suspend (depends on shell)           |
+| `Escape`   | Escape/Meta prefix for `Alt‑` combos |
+| Arrow keys | Move cursor up/down/left/right       |
+
+For the full official key binding documentation, check the prompt_toolkit docs: [prompt_toolkit GITHUB](https://github.com/prompt-toolkit/python-prompt-toolkit)
+
+## Support
+
+If you find this project helpful and would like to support its development, you can make a donation via the following method:
+
+- [PayPal](https://www.paypal.com/paypalme/wattox)
+
+Your contribution helps in maintaining and improving the app. Thank you for your support!
+
+## License
+
+This project is licensed under the [MIT License](LICENSE) - see the [LICENSE](LICENSE) file for details.

todol-0.3.1/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "todol"
+version = "0.3.1"
+description = "A python TUI todo app"
+readme = "README.md"
+license-files = ["LICENSE"]
+requires-python = ">=3.9"
+
+dependencies = [
+    "prompt_toolkit>=3.0.52",
+    "platformdirs>=4.5.1",
+    "rich>=14.2.0",
+    "requests>=2.32.5"
+]
+
+[project.scripts]
+todol = "todol.main:main"
+todol-help = "todol.flags.todol_help:main"
+todol-path = "todol.flags.todol_path:main"
+todol-version = "todol.flags.todol_version:main"
+todol-upgrade = "todol.flags.todol_upgrade:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["todol*"]

todol-0.3.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

todol-0.3.1/todol/flags/todol_help.py

@@ -0,0 +1,9 @@
+def main():
+    print("todol - A simple terminal todo list app")
+    print("Type 'h' inside the app to see available commands.")
+    print("\nAdditional flags:")
+    print("  todol-help      Show this help message")
+    print("  todol-version   Show current version")
+    print("  todol-path      Show where todo files are stored")
+    print("  todol-upgrade   Update todol (runs 'pipx upgrade todol')")
+    print("\nDocumentation: https://github.com/wattox00/todol")

todol-0.3.1/todol/flags/todol_path.py

@@ -0,0 +1,11 @@
+from platformdirs import user_data_dir
+from pathlib import Path
+
+def main():
+    DATA_DIR = Path(user_data_dir('todol', 'todol'))
+    TODO_DIR = DATA_DIR / 'todoFiles'
+
+    if TODO_DIR.exists():
+        print(f"Todol files:\n{TODO_DIR}")
+    else:
+        print("No data directory found. Run the app first: todol")

todol-0.3.1/todol/flags/todol_upgrade.py

@@ -0,0 +1,37 @@
+import sys
+import requests
+import subprocess
+from importlib.metadata import version, PackageNotFoundError
+
+PACKAGE_NAME = "todol"
+
+def main():
+    try:
+        installed_version = version(PACKAGE_NAME)
+    except PackageNotFoundError:
+        installed_version = "not installed"
+
+    try:
+        resp = requests.get(f"https://pypi.org/pypi/{PACKAGE_NAME}/json", timeout=3)
+        resp.raise_for_status()
+        latest_version = resp.json()["info"]["version"]
+    except Exception:
+        latest_version = "unknown"
+
+    if installed_version == latest_version:
+        print(f"{PACKAGE_NAME} {installed_version} Your packages are up to date")
+    else:
+        print(f"{PACKAGE_NAME} {installed_version} (newer version available: {latest_version})")
+
+        update_question = input("Do you want to update it now? [Y/n]: ").strip().lower()
+        if update_question in ("", "y", "yes"):
+            try:
+                print("Running: pipx upgrade todol")
+                subprocess.run(["pipx", "upgrade", PACKAGE_NAME], check=True)
+                print("Update completed!")
+            except FileNotFoundError:
+                print("pipx not found. Please install it first: https://pipx.pypa.io/latest/installation/")
+            except subprocess.CalledProcessError:
+                print("Update failed. Try running the command manually: pipx upgrade todol")
+
+    sys.exit(0)

todol-0.3.1/todol/flags/todol_version.py

@@ -0,0 +1,25 @@
+import sys
+import requests
+from importlib.metadata import version, PackageNotFoundError
+
+PACKAGE_NAME = "todol"
+
+def main():
+    try:
+        installed_version = version(PACKAGE_NAME)
+    except PackageNotFoundError:
+        installed_version = "not installed"
+
+    try:
+        resp = requests.get(f"https://pypi.org/pypi/{PACKAGE_NAME}/json", timeout=3)
+        resp.raise_for_status()
+        latest_version = resp.json()["info"]["version"]
+    except Exception:
+        latest_version = "unknown"
+
+    if installed_version == latest_version:
+        print(f"{PACKAGE_NAME} {installed_version} LTS")
+    else:
+        print(f"{PACKAGE_NAME} {installed_version} newer version available: {latest_version}")
+    
+    sys.exit(0)

todol-0.3.1/todol/functions.py

@@ -0,0 +1,432 @@
+import json
+
+from prompt_toolkit.completion import Completer, Completion
+from prompt_toolkit.history import FileHistory
+from prompt_toolkit.formatted_text import HTML
+from prompt_toolkit import PromptSession
+from prompt_toolkit.shortcuts import clear
+
+from prompt_toolkit.key_binding import KeyBindings
+from prompt_toolkit.filters import Condition
+from prompt_toolkit.application.current import get_app
+
+from rich.console import Console
+from rich.table import Table
+from rich.text import Text
+from rich import print
+
+from platformdirs import user_data_dir
+from pathlib import Path
+
+# app start
+
+DATA_DIR = Path(user_data_dir('todol', 'todol'))
+TODO_DIR = DATA_DIR / 'todoFiles'
+TODO_JSON = TODO_DIR / 'main.json'
+HISTORY_FILE = TODO_DIR / 'history'
+
+TODO_DIR.mkdir(parents = True, exist_ok = True)
+
+if not TODO_JSON.exists():
+    TODO_JSON.write_text('{"tasks": {}}')
+
+HISTORY_FILE.touch()
+HISTORY_FILE.write_text('')
+
+class Functions():
+
+    # greeting
+    # reload view
+
+    def greetingAppStart():
+
+        clear()
+
+        print(r"""
+████████  ██████   █████     ██████   ██      
+   ██    ██    ██  ██   ██  ██    ██  ██      
+   ██    ██    ██  ██   ██  ██    ██  ██      
+   ██    ██    ██  ██   ██  ██    ██  ██      
+   ██     ██████   █████     ██████   ███████
+        """)
+
+        print('[bold yellow]Type h or help to see the available commands and what they do![/bold yellow]\n')
+        
+        Functions.openJson()
+
+    # open Json (write on start)
+
+    def openJson():
+        console = Console()
+        data = Functions.load_todos()
+        tasks = data.get("tasks", {})
+
+        pending = []
+        completed = []
+
+        for task_id, task in tasks.items():
+            if task.get("completed"):
+                completed.append((task_id, task))
+            else:
+                pending.append((task_id, task))
+
+        table = Table(
+            show_header=True,
+            header_style="bold magenta",
+            title="Todo List",
+            caption=f"Pending: {len(pending)} | Completed: {len(completed)}"
+        )
+
+        table.add_column("ID", style="cyan", width=3, no_wrap=True)
+        table.add_column("Task", style="bold white", min_width=20)
+        table.add_column("Description", style="dim", overflow="fold")
+        table.add_column("Time", style="yellow", width=10)
+        table.add_column("Status", justify="center", width=10)
+
+        def render_row(task_id, task, completed=False):
+            status = Text("DONE", style="bold green") if completed else Text("TODO", style="bold red")
+            name = Text(task["name"])
+
+            if completed:
+                name.stylize("strike dim")
+
+            return [
+                task_id,
+                name,
+                task.get("desc", ""),
+                task.get("time", "-"),
+                status
+            ]
+
+        for task_id, task in pending:
+            table.add_row(*render_row(task_id, task))
+
+        if completed:
+            table.add_section()
+            for task_id, task in completed:
+                table.add_row(*render_row(task_id, task, completed=True))
+
+        console.print((table))
+
+    # add task to json
+
+    def addTaskJson(task):
+        data: dict = Functions.load_todos()
+
+        if data['tasks']:
+            new_id: str = str(max(map(int, data['tasks'].keys())) + 1)
+        else:
+            new_id: str = '1'
+
+        data['tasks'][new_id] = task
+
+        Functions.save_todos(data)
+        print(f'\n[bold yellow]Task {new_id} Added![/bold yellow]\n')
+
+    def addTask(full_cmd):
+        title: str = " ".join(full_cmd)
+        description: str = Prompts.session.prompt(HTML('\n<ansiblue>[todol ~] description : </ansiblue>\n'+ Prompts.line_prefix(1))).strip()
+        time: str = Prompts.session.prompt('\n[todol ~] time : ').strip()
+        return {'name': title, 'desc': description, 'time': time, 'completed': False}
+
+    # remove task from json
+
+    def removeTaskJson(index):
+        
+        data: dict = Functions.load_todos()
+        
+        try:
+            if index[0] == "all":
+                data['tasks'].clear()
+
+                print(f'\n[bold yellow]All Tasks been removed![/bold yellow]\n')
+            else:
+                for arg in index:
+
+                    if "-" in arg:
+                        min_i, max_i = arg.split("-")
+
+                        for task in range(int(min_i), int(max_i) + 1):
+                            task = str(task)
+                            if task in data['tasks']:
+                                del data['tasks'][task]
+
+                        print(f'\n[bold yellow]Tasks {index[0]} been removed![/bold yellow]\n')
+
+                    else:
+                        del data['tasks'][str(arg)]
+
+                        print(f'\n[bold yellow]Task(s) {index} been removed![/bold yellow]\n')
+            Functions.save_todos(data)
+
+        except ValueError:
+            print('Invalid input. Please enter a valid number.')
+        except KeyError:
+            print('Invalid input. Please enter a valid number.')
+
+    # edit task
+
+    def editTask(editIndex):
+        
+        data: dict = Functions.load_todos()    
+        
+        try:
+            title: str = data['tasks'][editIndex]['name']
+            desc: str = data['tasks'][editIndex]['desc']
+            time: str = data['tasks'][editIndex]['time']
+
+            editTittle = Prompts.session.prompt('[todol ~] title (edit) : ', default=title)
+            
+            editDesc = Prompts.session.prompt(HTML('\n<ansiblue>[todol ~] description (edit) : </ansiblue>\n'+Prompts.line_prefix(1)), default=desc)
+            
+            editTime = Prompts.session.prompt('\n[todol ~] time (edit) : ', default=time)   
+
+            data['tasks'][editIndex] = {'name': editTittle, 'desc': editDesc, 'time': editTime, 'completed': False}
+
+            Functions.save_todos(data)
+
+            print(f'\n[bold yellow]Task {editIndex} Edited![/bold yellow]\n')
+
+        except ValueError:
+            print('Invalid input. Please enter a valid number.')
+        except KeyError:
+            print('Invalid input. Please enter a valid number.')
+
+    # mark task as done in json
+
+    def doneTaskJson(doneIndex):
+        
+        data: dict = Functions.load_todos()
+
+        try:
+            if doneIndex[0] == "all":
+                for key in data['tasks']:
+                    data['tasks'][key]['completed'] = True
+
+            else:
+                for arg in doneIndex:
+                
+                    if "-" in arg:
+                        min_i, max_i = arg.split("-")
+
+                        for task in range(int(min_i), int(max_i) + 1):
+                            task = str(task)
+                            if task in data['tasks']:
+                                data['tasks'][task]['completed'] = True
+
+                    else:
+                        data['tasks'][str(arg)]['completed'] = True
+
+            Functions.save_todos(data)
+
+            print(f'\n[bold yellow]Task(s) {doneIndex} marked Done![/bold yellow]\n')
+
+        except ValueError:
+            print('Invalid input. Please enter a valid number.')
+        except KeyError:
+            print('Invalid input. Please enter a valid number.')
+
+    # remove tasks that are completed
+
+    def clearTaskJson():
+
+        data: dict = Functions.load_todos()
+        
+        for count in list(data['tasks']):
+            if data['tasks'][count]['completed']:
+                del data['tasks'][count]
+
+        Functions.save_todos(data)
+
+        print('\n[bold yellow]TODO list CLEARED![/bold yellow]\n')
+
+    # print help commands
+
+    def helpText():
+        console = Console()
+
+        table = Table(show_header=True, header_style="bold")
+
+        table.add_column("Command", style="cyan", width=10)
+        table.add_column("Alias", style="green", width=6)
+        table.add_column("Action", style="bold")
+        table.add_column("Usage", style="dim")
+
+        table.add_row("add", "a", "Add new task", "add [task]")
+        table.add_row("done", "d", "Mark task done", "done [id]")
+        table.add_row("list", "l", "Show todo list", "list")
+        table.add_row("remove", "rm", "Remove task", "rm [id]")
+        table.add_row("edit", "e", "Edit task", "edit [id]")
+        table.add_row("clear", "c", "Clear done tasks", "clear")
+        table.add_row("help", "h", "Show help", "help")
+        table.add_row("reload", "reset", "Reload the app", "reload")
+        table.add_row("exit", "0", "Exit app", "exit")
+
+        console.print(table)
+        print(
+            "\nBatch Operations:\n"
+            "You can apply commands to multiple tasks at once:\n"
+            "  - Use 'all' to target all tasks\n"
+            "  - Specify a range with 'start-end', e.g., 2-5\n"
+            "  - List multiple IDs separated by spaces, e.g., 1 3 7\n"
+            "Examples:\n"
+            "  done all       # mark all tasks done\n"
+            "  rm 2-4         # remove tasks 2, 3, 4\n"
+            "  done 1 5 7     # mark tasks 1, 5, and 7 done"
+        )
+
+    # load json file
+
+    def load_todos():
+        with open(TODO_JSON, 'r') as f:
+            return json.load(f)
+
+    # save to the json file
+
+    def save_todos(data):
+        with open(TODO_JSON, 'w') as f:
+            json.dump(data, f, indent=4)
+
+class Commands():
+    def cmd_add(args):
+        data = Functions.addTask(args)
+        Functions.addTaskJson(data)
+
+    def cmd_done(args):
+        Functions.doneTaskJson(args)
+
+    def cmd_remove(args):
+        Functions.removeTaskJson(args)
+
+    def cmd_edit(args):
+        Functions.editTask(args[0])
+
+    def cmd_help(args):
+        Functions.helpText()
+
+    def cmd_list(args):
+        Functions.openJson()
+
+    def cmd_clear(args):
+        Functions.clearTaskJson()
+
+    def cmd_reload(args):
+        Functions.greetingAppStart()
+
+    def cmd_exit(args):
+        raise SystemExit
+
+    def aliases(func, *names):
+        return {name: func for name in names}
+
+    COMMANDS = {
+        **aliases(cmd_add, "add", "a"),
+        **aliases(cmd_done, "done", "d"),
+        **aliases(cmd_remove, "remove", "rm"),
+        **aliases(cmd_edit, "edit", "e"),
+        **aliases(cmd_help, "help", "h"),
+        **aliases(cmd_list, "list", "ll", "ls", "l"),
+        **aliases(cmd_clear, "clear", "clean", "c"),
+        **aliases(cmd_reload, "reload", "reset"),
+        **aliases(cmd_exit, "exit", "0", "q"),
+    }
+
+class ShellCompleter(Completer):
+    def get_completions(self, document, complete_event):
+        if not complete_event.completion_requested:
+            return
+
+        text = document.text_before_cursor
+        words = text.split()
+
+        if not words:
+            for cmd in Commands.COMMANDS:
+                yield Completion(cmd, start_position=0)
+            return
+
+        if len(words) == 1 and not text.endswith(" "):
+            current = words[0]
+            for cmd in Commands.COMMANDS:
+                if cmd.startswith(current):
+                    yield Completion(cmd, start_position=-len(current))
+            return
+
+        cmd = words[0]
+        args = Commands.COMMANDS.get(cmd, [])
+
+        if args:
+            current = words[-1] if not text.endswith(" ") else ""
+            for arg in args:
+                if arg.startswith(current):
+                    yield Completion(arg, start_position=-len(current))
+
+
+class Prompts:
+    kb = KeyBindings()
+
+    @staticmethod
+    def line_prefix(n: int) -> str:
+        return f"{n:>3} | "
+
+    @staticmethod
+    def prompt_continuation(width, line_number, is_soft_wrap):
+        return Prompts.line_prefix(line_number + 1)
+
+    @staticmethod
+    def editing_bottom_toolbar():
+            text = (
+                "[MULTILINE MODE]  "
+                "Switch mode: Ctrl+D  |  "
+                "Save: Esc+Enter  |  "
+                "New line: Enter  |  "
+                "Move: ↑/↓  |  "
+                "Clear line: Ctrl+U"
+            )
+            app = get_app()
+            width = app.output.get_size().columns
+            padded = text.ljust(width)
+            return HTML(f"<style fg='ansiblack' bg='ansiwhite'>{padded}</style>")
+
+    @staticmethod
+    def normal_bottom_toolbar():
+            text = (
+                "[NORMAL MODE]  "
+                "Switch mode: Ctrl+D  |  "
+                "Execute: Enter"
+            )
+            app = get_app()
+            width = app.output.get_size().columns
+            padded = text.ljust(width)
+            return HTML(f"<style fg='ansiblack' bg='ansiwhite'>{padded}</style>")
+    @Condition
+    def desc_mode():
+        return getattr(Prompts.session, "_desc_mode", False)
+
+    @staticmethod
+    def dynamic_multiline():
+        return Prompts._desc_mode()
+
+    def dynamic_prompt_continuation(width, line_number, is_soft_wrap):
+        if Prompts.desc_mode():
+            return Prompts.prompt_continuation(width, line_number, is_soft_wrap)
+        return ""
+
+    def dynamic_toolbar():
+        if Prompts.desc_mode():
+            return Prompts.editing_bottom_toolbar()
+        return Prompts.normal_bottom_toolbar()
+
+    @kb.add("c-d")
+    def toggle_desc_mode(event):
+        Prompts.session._desc_mode = not getattr(Prompts.session, "_desc_mode", False)
+        event.app.invalidate()
+
+    session = PromptSession(
+        completer=ShellCompleter(),
+        complete_while_typing=False,
+        history=FileHistory(HISTORY_FILE),
+        multiline=desc_mode,
+        prompt_continuation=dynamic_prompt_continuation,
+        bottom_toolbar=dynamic_toolbar,
+        key_bindings=kb,
+    )

todol-0.3.1/todol/main.py

@@ -0,0 +1,34 @@
+from .functions import Functions, Commands, Prompts
+
+def main():
+    Functions.greetingAppStart()
+
+    # main loop
+
+    while True:
+        try:
+            raw = Prompts.session.prompt('[todol ~]$ ').strip()
+
+        except KeyboardInterrupt:
+            break
+
+        if not raw:
+            continue
+
+        parts = raw.split()
+        command, *args = parts
+
+        func = Commands.COMMANDS.get(command)
+        
+        if not func:
+            print(f'{command}: command not found')
+            continue
+
+        try:
+            func(args)
+        except IndexError:
+            print('Missing argument')
+        except SystemExit:
+            break
+        except KeyboardInterrupt:
+            break

todol-0.3.1/todol.egg-info/PKG-INFO

@@ -0,0 +1,188 @@
+Metadata-Version: 2.4
+Name: todol
+Version: 0.3.1
+Summary: A python TUI todo app
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: prompt_toolkit>=3.0.52
+Requires-Dist: platformdirs>=4.5.1
+Requires-Dist: rich>=14.2.0
+Requires-Dist: requests>=2.32.5
+Dynamic: license-file
+
+# Todol - Python TUI ToDo app
+
+## Installation
+
+```
+pip install todol
+```
+
+`todol` is a terminal application. I recommend installing it with `pipx`.
+
+More Info
+
+- Check out the project page on PyPi: [https://pypi.org/project/todol/](https://pypi.org/project/todol/)
+- and on Github: [https://github.com/WattoX00/todol](https://github.com/WattoX00/todol)
+
+![Demo](assets/demo.png)
+
+## Running
+
+### Run from anywhere in your terminal
+
+```
+todol
+```
+
+### Additional flags
+
+View all flags (for more options):
+
+```
+todol-help
+```
+
+Check the current version:
+
+```
+todol-version
+```
+
+See where todo files are saved:
+
+```
+todol-path
+```
+
+Update todol with a single command
+
+This runs `pipx upgrade todol` under the hood.
+
+```
+todol-upgrade
+```
+
+## COMMAND GUIDE
+
+```
+ Command     Alias      Action          Usage 
+
+ add         a       Add new task       add [task]
+ done        d       Mark task done     done [id]
+ list        l       Show todo list     list
+ remove      rm      Remove task        rm [id]
+ edit        e       Edit task          edit [id]
+ clear       c       Clear done tasks   clear
+ help        h       Show help          help
+ reload    reset     Reload the app     reload
+ exit        0       Exit app           exit
+```
+### Pro Tips: 
+- You can use Tab for autocomplete.
+- Navigate the terminal efficiently: arrow keys, backspace, and delete all work.
+- You can execute multiple commands at once:
+    - all - apply the command to all items
+
+    - id-id – apply the command to a range of IDs
+
+    - id1 id2 id3 – apply the command to specific IDs
+
+### examples:
+
+```
+done all       # marks all tasks as done
+remove 4-7     # removes tasks with IDs 4 through 7
+rm 3 5 8       # removes tasks 3, 5, and 8
+```
+
+## FAQ
+
+### Where are the saved todo files stored?
+
+#### You can simply check it by running `todol-path`
+
+`todol` stores its data using `platformdirs.user_data_dir`, which means files are written to the standard user data directory for each operating system.
+
+#### Default locations
+
+- **Linux**
+`~/.local/share/todol/todoFiles/`
+
+- **macOS**
+`~/Library/Application Support/todol/todoFiles/`
+
+- **Windows**
+`%APPDATA%\todol\todoFiles\`
+
+## Hotkeys are available!
+
+### Cursor navigation
+
+| Key      | Action                           |
+| -------- | -------------------------------- |
+| `Ctrl‑a` | Move cursor to beginning of line |
+| `Ctrl‑e` | Move cursor to end of line       |
+| `Ctrl‑f` | Move cursor forward (right)      |
+| `Ctrl‑b` | Move cursor backward (left)      |
+| `Alt‑f`  | Move forward one word            |
+| `Alt‑b`  | Move backward one word           |
+| `Home`   | Go to start of line              |
+| `End`    | Go to end of line                |
+
+### Editing
+
+| Key                    | Action                         |
+| ---------------------- | ------------------------------ |
+| `Ctrl‑d`               | Delete character under cursor  |
+| `Ctrl‑h` / `Backspace` | Delete character before cursor |
+| `Alt‑d`                | Delete word forward            |
+| `Ctrl‑k`               | Kill (cut) text to end of line |
+| `Ctrl‑y`               | Yank (paste) killed text       |
+| `Ctrl‑t`               | Transpose characters           |
+
+### History
+
+| Key      | Action                |
+| -------- | --------------------- |
+| `Ctrl‑p` | Previous history item |
+| `Ctrl‑n` | Next history item     |
+
+### Searching
+
+| Key      | Action                                                                 |
+| -------- | ---------------------------------------------------------------------- |
+| `Ctrl‑r` | Reverse search history                                                 |
+| `Ctrl‑s` | Forward search history *(may be intercepted by terminal flow control)* |
+
+### Completion & Accept
+
+| Key          | Action                   |
+| ------------ | ------------------------ |
+| `Tab`        | Trigger completion       |
+| `Ctrl‑Space` | Start/advance completion |
+| `Enter`      | Accept input             |
+
+### Misc
+
+| Key        | Action                               |
+| ---------- | ------------------------------------ |
+| `Ctrl‑c`   | Cancel / raise KeyboardInterrupt     |
+| `Ctrl‑z`   | Suspend (depends on shell)           |
+| `Escape`   | Escape/Meta prefix for `Alt‑` combos |
+| Arrow keys | Move cursor up/down/left/right       |
+
+For the full official key binding documentation, check the prompt_toolkit docs: [prompt_toolkit GITHUB](https://github.com/prompt-toolkit/python-prompt-toolkit)
+
+## Support
+
+If you find this project helpful and would like to support its development, you can make a donation via the following method:
+
+- [PayPal](https://www.paypal.com/paypalme/wattox)
+
+Your contribution helps in maintaining and improving the app. Thank you for your support!
+
+## License
+
+This project is licensed under the [MIT License](LICENSE) - see the [LICENSE](LICENSE) file for details.

todol-0.3.1/todol.egg-info/SOURCES.txt

@@ -0,0 +1,17 @@
+LICENSE
+README.md
+pyproject.toml
+todol/__init__.py
+todol/functions.py
+todol/main.py
+todol.egg-info/PKG-INFO
+todol.egg-info/SOURCES.txt
+todol.egg-info/dependency_links.txt
+todol.egg-info/entry_points.txt
+todol.egg-info/requires.txt
+todol.egg-info/top_level.txt
+todol/flags/__init__.py
+todol/flags/todol_help.py
+todol/flags/todol_path.py
+todol/flags/todol_upgrade.py
+todol/flags/todol_version.py

todol-0.3.1/todol.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

todol-0.3.1/todol.egg-info/entry_points.txt

@@ -0,0 +1,6 @@
+[console_scripts]
+todol = todol.main:main
+todol-help = todol.flags.todol_help:main
+todol-path = todol.flags.todol_path:main
+todol-upgrade = todol.flags.todol_upgrade:main
+todol-version = todol.flags.todol_version:main

todol-0.3.1/todol.egg-info/requires.txt

@@ -0,0 +1,4 @@
+prompt_toolkit>=3.0.52
+platformdirs>=4.5.1
+rich>=14.2.0
+requests>=2.32.5

todol-0.3.1/todol.egg-info/top_level.txt

@@ -0,0 +1 @@
+todol