aishwarya-task-manager-cli 0.1.0__tar.gz

aishwarya_task_manager_cli-0.1.0/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/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,84 @@
+# 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/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "aishwarya-task-manager-cli"
+version = "0.1.0"
+description = "A command-line task manager written in Python."
+readme = "README.md"
+requires-python = ">=3.11"
+authors = [
+    { name = "Aishwarya" }
+]
+dependencies = []
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["cli", "tasks", "productivity"]
+
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+]
+
+[project.optional-dependencies]
+dev = [
+    "build",
+    "pytest",
+    "pytest-cov",
+    "ruff",
+    "twine",
+]
+
+[project.scripts]
+tasker = "task_manager.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 88
+target-version = "py311"

aishwarya_task_manager_cli-0.1.0/setup.cfg

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

aishwarya_task_manager_cli-0.1.0/src/aishwarya_task_manager_cli.egg-info/PKG-INFO

@@ -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/src/aishwarya_task_manager_cli.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+src/aishwarya_task_manager_cli.egg-info/PKG-INFO
+src/aishwarya_task_manager_cli.egg-info/SOURCES.txt
+src/aishwarya_task_manager_cli.egg-info/dependency_links.txt
+src/aishwarya_task_manager_cli.egg-info/entry_points.txt
+src/aishwarya_task_manager_cli.egg-info/requires.txt
+src/aishwarya_task_manager_cli.egg-info/top_level.txt
+src/task_manager/__init__.py
+src/task_manager/cli.py
+src/task_manager/storage.py
+tests/test_cli.py
+tests/test_storage.py

aishwarya_task_manager_cli-0.1.0/src/aishwarya_task_manager_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

aishwarya_task_manager_cli-0.1.0/src/aishwarya_task_manager_cli.egg-info/entry_points.txt

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

aishwarya_task_manager_cli-0.1.0/src/aishwarya_task_manager_cli.egg-info/requires.txt

@@ -0,0 +1,7 @@
+
+[dev]
+build
+pytest
+pytest-cov
+ruff
+twine

aishwarya_task_manager_cli-0.1.0/src/aishwarya_task_manager_cli.egg-info/top_level.txt

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

aishwarya_task_manager_cli-0.1.0/src/task_manager/__init__.py

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

aishwarya_task_manager_cli-0.1.0/src/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()

aishwarya_task_manager_cli-0.1.0/src/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

aishwarya_task_manager_cli-0.1.0/tests/test_cli.py

@@ -0,0 +1,104 @@
+"""Tests for the command-line interface."""
+
+import sys
+from pathlib import Path
+
+import pytest
+
+from task_manager.cli import main
+
+
+def run_cli(
+    monkeypatch: pytest.MonkeyPatch,
+    *arguments: str,
+) -> None:
+    """Run the CLI with the supplied arguments."""
+    monkeypatch.setattr(sys, "argv", ["tasker", *arguments])
+    main()
+
+
+def test_list_command_with_no_tasks(
+    tmp_path: Path,
+    monkeypatch: pytest.MonkeyPatch,
+    capsys: pytest.CaptureFixture[str],
+) -> None:
+    """Listing an empty task collection should display a helpful message."""
+    monkeypatch.chdir(tmp_path)
+
+    run_cli(monkeypatch, "list")
+
+    assert capsys.readouterr().out == "No tasks found.\n"
+
+
+def test_add_and_list_commands(
+    tmp_path: Path,
+    monkeypatch: pytest.MonkeyPatch,
+    capsys: pytest.CaptureFixture[str],
+) -> None:
+    """An added task should appear in the task list."""
+    monkeypatch.chdir(tmp_path)
+
+    run_cli(monkeypatch, "add", "Write automated tests")
+    assert capsys.readouterr().out == (
+        "Added task 1: Write automated tests\n"
+    )
+
+    run_cli(monkeypatch, "list")
+    assert capsys.readouterr().out == (
+        "[ ] 1: Write automated tests\n"
+    )
+
+
+def test_complete_and_delete_commands(
+    tmp_path: Path,
+    monkeypatch: pytest.MonkeyPatch,
+    capsys: pytest.CaptureFixture[str],
+) -> None:
+    """A task should be completable and deletable through the CLI."""
+    monkeypatch.chdir(tmp_path)
+
+    run_cli(monkeypatch, "add", "Finish the project")
+    capsys.readouterr()
+
+    run_cli(monkeypatch, "complete", "1")
+    assert capsys.readouterr().out == (
+        "Completed task 1: Finish the project\n"
+    )
+
+    run_cli(monkeypatch, "list")
+    assert capsys.readouterr().out == (
+        "[x] 1: Finish the project\n"
+    )
+
+    run_cli(monkeypatch, "delete", "1")
+    assert capsys.readouterr().out == (
+        "Deleted task 1: Finish the project\n"
+    )
+
+
+def test_missing_task_messages(
+    tmp_path: Path,
+    monkeypatch: pytest.MonkeyPatch,
+    capsys: pytest.CaptureFixture[str],
+) -> None:
+    """Missing task IDs should produce helpful messages."""
+    monkeypatch.chdir(tmp_path)
+
+    run_cli(monkeypatch, "complete", "99")
+    assert capsys.readouterr().out == "Task 99 was not found.\n"
+
+    run_cli(monkeypatch, "delete", "99")
+    assert capsys.readouterr().out == "Task 99 was not found.\n"
+
+
+def test_empty_task_title_is_rejected(
+    tmp_path: Path,
+    monkeypatch: pytest.MonkeyPatch,
+    capsys: pytest.CaptureFixture[str],
+) -> None:
+    """A task title containing only spaces should be rejected."""
+    monkeypatch.chdir(tmp_path)
+
+    run_cli(monkeypatch, "add", "   ")
+
+    assert capsys.readouterr().out == "Task title cannot be empty.\n"

aishwarya_task_manager_cli-0.1.0/tests/test_storage.py

@@ -0,0 +1,68 @@
+"""Tests for task storage operations."""
+
+from pathlib import Path
+
+from task_manager.storage import (
+    add_task,
+    complete_task,
+    delete_task,
+    load_tasks,
+)
+
+
+def test_load_tasks_returns_empty_list_when_file_is_missing(
+    tmp_path: Path,
+) -> None:
+    """A missing data file should represent an empty task list."""
+    file_path = tmp_path / "tasks.json"
+
+    assert load_tasks(file_path) == []
+
+
+def test_add_task_saves_a_new_task(tmp_path: Path) -> None:
+    """Adding a task should create and persist it."""
+    file_path = tmp_path / "tasks.json"
+
+    task = add_task("Learn pytest", file_path)
+
+    assert task == {
+        "id": 1,
+        "title": "Learn pytest",
+        "completed": False,
+    }
+    assert load_tasks(file_path) == [task]
+
+
+def test_add_task_assigns_increasing_ids(tmp_path: Path) -> None:
+    """Each new task should receive the next available ID."""
+    file_path = tmp_path / "tasks.json"
+
+    first_task = add_task("First task", file_path)
+    second_task = add_task("Second task", file_path)
+
+    assert first_task["id"] == 1
+    assert second_task["id"] == 2
+
+
+def test_complete_task_marks_task_as_completed(tmp_path: Path) -> None:
+    """Completing a task should update the saved data."""
+    file_path = tmp_path / "tasks.json"
+    add_task("Finish project", file_path)
+
+    completed_task = complete_task(1, file_path)
+
+    assert completed_task is not None
+    assert completed_task["completed"] is True
+    assert load_tasks(file_path)[0]["completed"] is True
+
+
+def test_delete_task_removes_the_task(tmp_path: Path) -> None:
+    """Deleting a task should remove it from saved data."""
+    file_path = tmp_path / "tasks.json"
+    add_task("Temporary task", file_path)
+
+    deleted_task = delete_task(1, file_path)
+
+    assert deleted_task is not None
+    assert deleted_task["title"] == "Temporary task"
+    assert load_tasks(file_path) == []