aishwarya-task-manager-cli 0.1.0__py3-none-any.whl

aishwarya_task_manager_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: aishwarya-task-manager-cli
+Version: 0.1.0
+Summary: A command-line task manager written in Python.
+Author: Aishwarya
+License-Expression: MIT
+Keywords: cli,tasks,productivity
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# Task Manager CLI
+
+A simple command-line task manager written in Python.
+
+## Features
+
+- Add tasks
+- List tasks
+- Mark tasks as completed
+- Delete tasks
+- Save tasks between runs in a JSON file
+
+## Requirements
+
+- Python 3.11 or newer
+
+## Development setup
+
+Create and activate a virtual environment:
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\Activate.ps1
+```
+
+Install the package and its development tools:
+
+```powershell
+python -m pip install --editable ".[dev]"
+```
+
+## Usage
+
+Display help:
+
+```powershell
+tasker --help
+```
+
+Add a task:
+
+```powershell
+tasker add "Review Python basics"
+```
+
+List tasks:
+
+```powershell
+tasker list
+```
+
+Complete a task:
+
+```powershell
+tasker complete 1
+```
+
+Delete a task:
+
+```powershell
+tasker delete 1
+```
+
+Tasks are stored in `tasks.json` in the current directory.
+
+## Quality checks
+
+Check the code:
+
+```powershell
+ruff check .
+```
+
+Run the tests:
+
+```powershell
+pytest
+```
+
+Run tests with coverage:
+
+```powershell
+pytest --cov=task_manager --cov-report=term-missing
+```

aishwarya_task_manager_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+aishwarya_task_manager_cli-0.1.0.dist-info/licenses/LICENSE,sha256=64qLdXy1MFdUkS5xeTLU-LBMCAUCZp3CnNewasqWLvk,1085
+task_manager/__init__.py,sha256=fz1cTbElCAuoUNZ4bw_Ep65HeE4QFcJ7IuY42DiHlZk,59
+task_manager/cli.py,sha256=fWXDiNSVp4HTTlOiDikflxIeiBGcQrOBWPk442c_9jw,2773
+task_manager/storage.py,sha256=1AfsBjpaQViSyA3sSWHcbMhAhQJ-UUvH2v_SQRZvoTY,1935
+aishwarya_task_manager_cli-0.1.0.dist-info/METADATA,sha256=rJnOMOYRnreGrst7Lb2maAdUGB6ZnzWKKnJN5rX04sk,1882
+aishwarya_task_manager_cli-0.1.0.dist-info/WHEEL,sha256=a-udL2m4V_6Yn8b-uKzWb12RjRxwwMo6ohYFM24tpaY,91
+aishwarya_task_manager_cli-0.1.0.dist-info/entry_points.txt,sha256=QbikjLgyJeBGMDNMyPLv5QxsFwvE973tOIAJ954Rtpo,49
+aishwarya_task_manager_cli-0.1.0.dist-info/top_level.txt,sha256=txVWUWwaSeBBGIFJea7iM-OGDJJYKyVuQPPXqt-CXyw,13
+aishwarya_task_manager_cli-0.1.0.dist-info/RECORD,,

aishwarya_task_manager_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

aishwarya_task_manager_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+tasker = task_manager.cli:main

aishwarya_task_manager_cli-0.1.0.dist-info/licenses/LICENSE

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

aishwarya_task_manager_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+task_manager

task_manager/__init__.py

@@ -0,0 +1,3 @@
+"""A command-line task manager."""
+
+__version__ = "0.1.0"

task_manager/cli.py

@@ -0,0 +1,113 @@
+"""Command-line interface for the task manager."""
+
+from argparse import ArgumentParser, Namespace
+
+from task_manager.storage import (
+    add_task,
+    complete_task,
+    delete_task,
+    load_tasks,
+)
+
+
+def build_parser() -> ArgumentParser:
+    """Create and configure the command-line argument parser."""
+    parser = ArgumentParser(
+        prog="tasker",
+        description="Create and manage tasks from the command line.",
+    )
+    parser.add_argument(
+        "--version",
+        action="version",
+        version="%(prog)s 0.1.0",
+    )
+
+    subparsers = parser.add_subparsers(
+        dest="command",
+        required=True,
+    )
+
+    add_parser = subparsers.add_parser(
+        "add",
+        help="Add a new task.",
+    )
+    add_parser.add_argument(
+        "title",
+        help="Description of the task.",
+    )
+
+    subparsers.add_parser(
+        "list",
+        help="List all tasks.",
+    )
+
+    complete_parser = subparsers.add_parser(
+        "complete",
+        help="Mark a task as completed.",
+    )
+    complete_parser.add_argument(
+        "task_id",
+        type=int,
+        help="ID of the task to complete.",
+    )
+
+    delete_parser = subparsers.add_parser(
+        "delete",
+        help="Delete a task.",
+    )
+    delete_parser.add_argument(
+        "task_id",
+        type=int,
+        help="ID of the task to delete.",
+    )
+
+    return parser
+
+
+def handle_command(args: Namespace) -> None:
+    """Handle the command selected by the user."""
+    if args.command == "add":
+        if not args.title.strip():
+            print("Task title cannot be empty.")
+            return
+
+        task = add_task(args.title)
+        print(f'Added task {task["id"]}: {task["title"]}')
+
+    elif args.command == "list":
+        tasks = load_tasks()
+
+        if not tasks:
+            print("No tasks found.")
+            return
+
+        for task in tasks:
+            marker = "x" if task["completed"] else " "
+            print(f'[{marker}] {task["id"]}: {task["title"]}')
+
+    elif args.command == "complete":
+        task = complete_task(args.task_id)
+
+        if task is None:
+            print(f"Task {args.task_id} was not found.")
+        else:
+            print(f'Completed task {task["id"]}: {task["title"]}')
+
+    elif args.command == "delete":
+        task = delete_task(args.task_id)
+
+        if task is None:
+            print(f"Task {args.task_id} was not found.")
+        else:
+            print(f'Deleted task {task["id"]}: {task["title"]}')
+
+
+def main() -> None:
+    """Run the task manager CLI."""
+    parser = build_parser()
+    args = parser.parse_args()
+    handle_command(args)
+
+
+if __name__ == "__main__":
+    main()

task_manager/storage.py

@@ -0,0 +1,85 @@
+"""Read and write task data."""
+
+import json
+from pathlib import Path
+from typing import TypedDict
+
+
+class Task(TypedDict):
+    """Structure of one task."""
+
+    id: int
+    title: str
+    completed: bool
+
+
+DEFAULT_TASKS_FILE = Path("tasks.json")
+
+
+def load_tasks(file_path: Path = DEFAULT_TASKS_FILE) -> list[Task]:
+    """Load tasks from a JSON file."""
+    if not file_path.exists():
+        return []
+
+    with file_path.open(encoding="utf-8") as file:
+        return json.load(file)
+
+
+def save_tasks(
+    tasks: list[Task],
+    file_path: Path = DEFAULT_TASKS_FILE,
+) -> None:
+    """Save tasks to a JSON file."""
+    with file_path.open("w", encoding="utf-8") as file:
+        json.dump(tasks, file, indent=2, ensure_ascii=False)
+
+
+def add_task(
+    title: str,
+    file_path: Path = DEFAULT_TASKS_FILE,
+) -> Task:
+    """Create and save a new task."""
+    tasks = load_tasks(file_path)
+    next_id = max((task["id"] for task in tasks), default=0) + 1
+
+    task: Task = {
+        "id": next_id,
+        "title": title.strip(),
+        "completed": False,
+    }
+
+    tasks.append(task)
+    save_tasks(tasks, file_path)
+    return task
+
+
+def complete_task(
+    task_id: int,
+    file_path: Path = DEFAULT_TASKS_FILE,
+) -> Task | None:
+    """Mark a task as completed."""
+    tasks = load_tasks(file_path)
+
+    for task in tasks:
+        if task["id"] == task_id:
+            task["completed"] = True
+            save_tasks(tasks, file_path)
+            return task
+
+    return None
+
+
+def delete_task(
+    task_id: int,
+    file_path: Path = DEFAULT_TASKS_FILE,
+) -> Task | None:
+    """Delete a task."""
+    tasks = load_tasks(file_path)
+
+    for index, task in enumerate(tasks):
+        if task["id"] == task_id:
+            deleted_task = tasks.pop(index)
+            save_tasks(tasks, file_path)
+            return deleted_task
+
+    return None