student-task-manager-cli 0.1.0__tar.gz

student_task_manager_cli-0.1.0/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: student-task-manager-cli
+Version: 0.1.0
+Summary: A simple command-line task manager
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+## Install
+
+From the project directory, on macOS or Linux:
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install -e .
+```
+
+On Windows PowerShell:
+
+```powershell
+py -m venv .venv
+.venv\Scripts\Activate.ps1
+python -m pip install -e .
+```
+
+After activation, run `task` to open the interactive terminal view.
+Enter commands at the `❯` prompt, for example `add Write report`, `ls`, or `/help`.
+`list` and `ls` are the same command. `list` shows To do tasks, `list --done` shows completed tasks, and `list --all` shows both.
+Titles may contain spaces without quotes. `clear` and `cls` clear the interactive screen;
+`clear-completed` removes completed tasks. Type `task` at the prompt to show the welcome view again.
+
+Tab completes commands and the arrow keys recall history on terminals with readline.
+The welcome screen shows your next task and a small activity chart.
+
+You can also run single commands directly, such as:
+`task add "Write report"` or `task --help`. 
+
+To leave the environment, run `deactivate`.
+
+## Commands
+
+| Command | Purpose |
+| --- | --- |
+| `task add "Write report"` | Add a task |
+| `task list` or `task ls` | List To do tasks |
+| `task list --done` | List completed tasks |
+| `task list --undone` | List To do tasks |
+| `task list --all` | List every task |
+| `task done 1` | Complete task 1 |
+| `task undone 1` | Make task 1 pending |
+| `task delete 1` | Delete task 1 |
+| `task update 1 "New title"` | Change task 1's title |
+| `task show 1` | Show task 1's details |
+| `task clear` | Delete completed tasks |
+| `task stats` | Show progress and a 7-day completion chart |
+| `task demo` | Try 26 sample tasks in a temporary workspace |
+| `task help` | Show all commands |
+
+Also available: `task --help`, `task --version`, and `task <command> --help` (for example, `task add --help`). IDs are positive integers. After deletion or a status change, tasks are renumbered from 1, with To do tasks first. Use `list --all` to see current IDs. Existing task files are normalized when read; new IDs are saved on the next change. Titles cannot be blank.
+
+## Try it with sample data
+
+```bash
+task demo
+```
+
+Or run `python test_task.py` from the project directory. Both open a separate
+session with 8 pending and 18 completed tasks spread across the last week.
+Try `ls`, `ls --done`, `done 1`, then `stats`. Type `/exit` to leave.
+Demo changes are discarded; your own tasks stay untouched.
+`task demo --preview` prints the sample list and chart without opening a prompt.
+
+## Progress
+
+`stats` shows task counts, completion percentage, and a daily chart:
+
+```text
+Progress  ━━━━━━━━━━━━━━──────  69%
+
+This week · completed tasks
+
+Tue 06  ━━━━              1
+Wed 07  ━━━━━━━━━━━━      3
+Thu 08  ━━━━━━━━          2
+Fri 09  ━━━━━━━━━━━━━━━━  4
+Sat 10  ━━━━              1
+Sun 11  ━━━━━━━━━━━━      3
+Mon 12  ━━━━━━━━━━━━━━━━  4
+```
+
+Dates follow your local timezone. `done` records the completion time; `undone`
+removes it. The chart counts tasks still in the file, so deleting completed tasks
+also removes them from the chart. Older tasks without a completion date still
+count toward the total, but not the daily chart.
+
+## Project structure
+
+```text
+src/task_manager/
+  cli.py            Entry point: one command or interactive mode
+  arguments.py      Command names, flags, and ls alias
+  commands.py       Add, edit, complete, delete, list
+  storage.py        JSON file, validation, task IDs
+  productivity.py   Weekly counts and progress
+  input.py          Parse commands typed at the prompt
+  interactive.py    Input loop and command history
+  demo.py           Sample tasks and temporary workspace
+  ui/
+    theme.py        Colors and terminal sizing
+    animation.py    Startup and result transitions
+    views.py        Welcome screen, help, and task list
+tests/              CLI, interactive, demo, and productivity tests
+test_task.py        Start the demo from the project directory
+```
+
+A command goes through `cli → arguments → commands → storage`.
+Interactive mode adds `input` and `ui`; both modes use the same commands.
+No runtime dependencies. Set `TASK_MANAGER_NO_ANIMATION=1` to disable motion,
+or `NO_COLOR=1` for plain output. Redirected output has no colors or animation.
+
+## Where tasks are stored
+
+The file is `tasks.json` in `~/Library/Application Support/task-manager/` on macOS, `%APPDATA%\task-manager\` on Windows, or `${XDG_DATA_HOME:-~/.local/share}/task-manager/` on Linux. It is created when a command saves tasks. A missing or empty file means no tasks. If JSON is corrupted, the command reports an error and leaves the file intact.
+
+## Run tests
+
+With the virtual environment active, install pytest separately for development:
+
+```bash
+python -m pip install pytest
+python -m pytest
+```
+
+Tests set `TASK_MANAGER_DATA_DIR` to a temporary directory. Your real task data is never cleared by the test suite.

student_task_manager_cli-0.1.0/README.md

@@ -0,0 +1,127 @@
+## Install
+
+From the project directory, on macOS or Linux:
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install -e .
+```
+
+On Windows PowerShell:
+
+```powershell
+py -m venv .venv
+.venv\Scripts\Activate.ps1
+python -m pip install -e .
+```
+
+After activation, run `task` to open the interactive terminal view.
+Enter commands at the `❯` prompt, for example `add Write report`, `ls`, or `/help`.
+`list` and `ls` are the same command. `list` shows To do tasks, `list --done` shows completed tasks, and `list --all` shows both.
+Titles may contain spaces without quotes. `clear` and `cls` clear the interactive screen;
+`clear-completed` removes completed tasks. Type `task` at the prompt to show the welcome view again.
+
+Tab completes commands and the arrow keys recall history on terminals with readline.
+The welcome screen shows your next task and a small activity chart.
+
+You can also run single commands directly, such as:
+`task add "Write report"` or `task --help`. 
+
+To leave the environment, run `deactivate`.
+
+## Commands
+
+| Command | Purpose |
+| --- | --- |
+| `task add "Write report"` | Add a task |
+| `task list` or `task ls` | List To do tasks |
+| `task list --done` | List completed tasks |
+| `task list --undone` | List To do tasks |
+| `task list --all` | List every task |
+| `task done 1` | Complete task 1 |
+| `task undone 1` | Make task 1 pending |
+| `task delete 1` | Delete task 1 |
+| `task update 1 "New title"` | Change task 1's title |
+| `task show 1` | Show task 1's details |
+| `task clear` | Delete completed tasks |
+| `task stats` | Show progress and a 7-day completion chart |
+| `task demo` | Try 26 sample tasks in a temporary workspace |
+| `task help` | Show all commands |
+
+Also available: `task --help`, `task --version`, and `task <command> --help` (for example, `task add --help`). IDs are positive integers. After deletion or a status change, tasks are renumbered from 1, with To do tasks first. Use `list --all` to see current IDs. Existing task files are normalized when read; new IDs are saved on the next change. Titles cannot be blank.
+
+## Try it with sample data
+
+```bash
+task demo
+```
+
+Or run `python test_task.py` from the project directory. Both open a separate
+session with 8 pending and 18 completed tasks spread across the last week.
+Try `ls`, `ls --done`, `done 1`, then `stats`. Type `/exit` to leave.
+Demo changes are discarded; your own tasks stay untouched.
+`task demo --preview` prints the sample list and chart without opening a prompt.
+
+## Progress
+
+`stats` shows task counts, completion percentage, and a daily chart:
+
+```text
+Progress  ━━━━━━━━━━━━━━──────  69%
+
+This week · completed tasks
+
+Tue 06  ━━━━              1
+Wed 07  ━━━━━━━━━━━━      3
+Thu 08  ━━━━━━━━          2
+Fri 09  ━━━━━━━━━━━━━━━━  4
+Sat 10  ━━━━              1
+Sun 11  ━━━━━━━━━━━━      3
+Mon 12  ━━━━━━━━━━━━━━━━  4
+```
+
+Dates follow your local timezone. `done` records the completion time; `undone`
+removes it. The chart counts tasks still in the file, so deleting completed tasks
+also removes them from the chart. Older tasks without a completion date still
+count toward the total, but not the daily chart.
+
+## Project structure
+
+```text
+src/task_manager/
+  cli.py            Entry point: one command or interactive mode
+  arguments.py      Command names, flags, and ls alias
+  commands.py       Add, edit, complete, delete, list
+  storage.py        JSON file, validation, task IDs
+  productivity.py   Weekly counts and progress
+  input.py          Parse commands typed at the prompt
+  interactive.py    Input loop and command history
+  demo.py           Sample tasks and temporary workspace
+  ui/
+    theme.py        Colors and terminal sizing
+    animation.py    Startup and result transitions
+    views.py        Welcome screen, help, and task list
+tests/              CLI, interactive, demo, and productivity tests
+test_task.py        Start the demo from the project directory
+```
+
+A command goes through `cli → arguments → commands → storage`.
+Interactive mode adds `input` and `ui`; both modes use the same commands.
+No runtime dependencies. Set `TASK_MANAGER_NO_ANIMATION=1` to disable motion,
+or `NO_COLOR=1` for plain output. Redirected output has no colors or animation.
+
+## Where tasks are stored
+
+The file is `tasks.json` in `~/Library/Application Support/task-manager/` on macOS, `%APPDATA%\task-manager\` on Windows, or `${XDG_DATA_HOME:-~/.local/share}/task-manager/` on Linux. It is created when a command saves tasks. A missing or empty file means no tasks. If JSON is corrupted, the command reports an error and leaves the file intact.
+
+## Run tests
+
+With the virtual environment active, install pytest separately for development:
+
+```bash
+python -m pip install pytest
+python -m pytest
+```
+
+Tests set `TASK_MANAGER_DATA_DIR` to a temporary directory. Your real task data is never cleared by the test suite.

student_task_manager_cli-0.1.0/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "student-task-manager-cli"
+version = "0.1.0"
+description = "A simple command-line task manager"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = []
+
+[project.scripts]
+task = "task_manager.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

student_task_manager_cli-0.1.0/setup.cfg

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

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

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: student-task-manager-cli
+Version: 0.1.0
+Summary: A simple command-line task manager
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+## Install
+
+From the project directory, on macOS or Linux:
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install -e .
+```
+
+On Windows PowerShell:
+
+```powershell
+py -m venv .venv
+.venv\Scripts\Activate.ps1
+python -m pip install -e .
+```
+
+After activation, run `task` to open the interactive terminal view.
+Enter commands at the `❯` prompt, for example `add Write report`, `ls`, or `/help`.
+`list` and `ls` are the same command. `list` shows To do tasks, `list --done` shows completed tasks, and `list --all` shows both.
+Titles may contain spaces without quotes. `clear` and `cls` clear the interactive screen;
+`clear-completed` removes completed tasks. Type `task` at the prompt to show the welcome view again.
+
+Tab completes commands and the arrow keys recall history on terminals with readline.
+The welcome screen shows your next task and a small activity chart.
+
+You can also run single commands directly, such as:
+`task add "Write report"` or `task --help`. 
+
+To leave the environment, run `deactivate`.
+
+## Commands
+
+| Command | Purpose |
+| --- | --- |
+| `task add "Write report"` | Add a task |
+| `task list` or `task ls` | List To do tasks |
+| `task list --done` | List completed tasks |
+| `task list --undone` | List To do tasks |
+| `task list --all` | List every task |
+| `task done 1` | Complete task 1 |
+| `task undone 1` | Make task 1 pending |
+| `task delete 1` | Delete task 1 |
+| `task update 1 "New title"` | Change task 1's title |
+| `task show 1` | Show task 1's details |
+| `task clear` | Delete completed tasks |
+| `task stats` | Show progress and a 7-day completion chart |
+| `task demo` | Try 26 sample tasks in a temporary workspace |
+| `task help` | Show all commands |
+
+Also available: `task --help`, `task --version`, and `task <command> --help` (for example, `task add --help`). IDs are positive integers. After deletion or a status change, tasks are renumbered from 1, with To do tasks first. Use `list --all` to see current IDs. Existing task files are normalized when read; new IDs are saved on the next change. Titles cannot be blank.
+
+## Try it with sample data
+
+```bash
+task demo
+```
+
+Or run `python test_task.py` from the project directory. Both open a separate
+session with 8 pending and 18 completed tasks spread across the last week.
+Try `ls`, `ls --done`, `done 1`, then `stats`. Type `/exit` to leave.
+Demo changes are discarded; your own tasks stay untouched.
+`task demo --preview` prints the sample list and chart without opening a prompt.
+
+## Progress
+
+`stats` shows task counts, completion percentage, and a daily chart:
+
+```text
+Progress  ━━━━━━━━━━━━━━──────  69%
+
+This week · completed tasks
+
+Tue 06  ━━━━              1
+Wed 07  ━━━━━━━━━━━━      3
+Thu 08  ━━━━━━━━          2
+Fri 09  ━━━━━━━━━━━━━━━━  4
+Sat 10  ━━━━              1
+Sun 11  ━━━━━━━━━━━━      3
+Mon 12  ━━━━━━━━━━━━━━━━  4
+```
+
+Dates follow your local timezone. `done` records the completion time; `undone`
+removes it. The chart counts tasks still in the file, so deleting completed tasks
+also removes them from the chart. Older tasks without a completion date still
+count toward the total, but not the daily chart.
+
+## Project structure
+
+```text
+src/task_manager/
+  cli.py            Entry point: one command or interactive mode
+  arguments.py      Command names, flags, and ls alias
+  commands.py       Add, edit, complete, delete, list
+  storage.py        JSON file, validation, task IDs
+  productivity.py   Weekly counts and progress
+  input.py          Parse commands typed at the prompt
+  interactive.py    Input loop and command history
+  demo.py           Sample tasks and temporary workspace
+  ui/
+    theme.py        Colors and terminal sizing
+    animation.py    Startup and result transitions
+    views.py        Welcome screen, help, and task list
+tests/              CLI, interactive, demo, and productivity tests
+test_task.py        Start the demo from the project directory
+```
+
+A command goes through `cli → arguments → commands → storage`.
+Interactive mode adds `input` and `ui`; both modes use the same commands.
+No runtime dependencies. Set `TASK_MANAGER_NO_ANIMATION=1` to disable motion,
+or `NO_COLOR=1` for plain output. Redirected output has no colors or animation.
+
+## Where tasks are stored
+
+The file is `tasks.json` in `~/Library/Application Support/task-manager/` on macOS, `%APPDATA%\task-manager\` on Windows, or `${XDG_DATA_HOME:-~/.local/share}/task-manager/` on Linux. It is created when a command saves tasks. A missing or empty file means no tasks. If JSON is corrupted, the command reports an error and leaves the file intact.
+
+## Run tests
+
+With the virtual environment active, install pytest separately for development:
+
+```bash
+python -m pip install pytest
+python -m pytest
+```
+
+Tests set `TASK_MANAGER_DATA_DIR` to a temporary directory. Your real task data is never cleared by the test suite.

student_task_manager_cli-0.1.0/src/student_task_manager_cli.egg-info/SOURCES.txt

@@ -0,0 +1,25 @@
+README.md
+pyproject.toml
+src/student_task_manager_cli.egg-info/PKG-INFO
+src/student_task_manager_cli.egg-info/SOURCES.txt
+src/student_task_manager_cli.egg-info/dependency_links.txt
+src/student_task_manager_cli.egg-info/entry_points.txt
+src/student_task_manager_cli.egg-info/top_level.txt
+src/task_manager/__init__.py
+src/task_manager/__main__.py
+src/task_manager/arguments.py
+src/task_manager/cli.py
+src/task_manager/commands.py
+src/task_manager/demo.py
+src/task_manager/input.py
+src/task_manager/interactive.py
+src/task_manager/productivity.py
+src/task_manager/storage.py
+src/task_manager/ui/__init__.py
+src/task_manager/ui/animation.py
+src/task_manager/ui/theme.py
+src/task_manager/ui/views.py
+tests/test_demo.py
+tests/test_interactive.py
+tests/test_productivity.py
+tests/test_tasks.py

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

@@ -0,0 +1 @@
+

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

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

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

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

student_task_manager_cli-0.1.0/src/task_manager/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

student_task_manager_cli-0.1.0/src/task_manager/__main__.py

@@ -0,0 +1,5 @@
+from .cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

student_task_manager_cli-0.1.0/src/task_manager/arguments.py

@@ -0,0 +1,52 @@
+import argparse
+
+from . import __version__
+
+
+def positive_id(value: str) -> int:
+    try:
+        task_id = int(value)
+    except ValueError as error:
+        raise argparse.ArgumentTypeError("task ID must be a positive number") from error
+    if task_id < 1:
+        raise argparse.ArgumentTypeError("task ID must be a positive number")
+    return task_id
+
+
+def parser_for_cli() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog="task", description="Manage your tasks.")
+    parser.add_argument("--version", action="version", version=f"task {__version__}")
+    commands = parser.add_subparsers(dest="command", required=True)
+    descriptions = {
+        "add": "Add a new task",
+        "list": "List pending tasks (or filter by status)",
+        "done": "Mark a task as completed",
+        "undone": "Mark a task as pending",
+        "delete": "Delete a task",
+        "update": "Change a task title",
+        "show": "Show task details",
+        "clear": "Delete completed tasks",
+        "stats": "Show weekly productivity",
+        "demo": "Open a session with sample tasks",
+        "help": "Show all commands",
+    }
+    for name, description in descriptions.items():
+        command = commands.add_parser(
+            name, aliases=["ls"] if name == "list" else [],
+            help=description, description=description,
+        )
+        command.set_defaults(command=name)
+        if name in ("done", "undone", "delete", "update", "show"):
+            command.add_argument("id", type=positive_id, help="positive task ID")
+        if name in ("add", "update"):
+            command.add_argument("title", help="task title")
+        if name == "demo":
+            command.add_argument("--preview", action="store_true", help="print the demo and exit")
+        if name == "list":
+            filters = command.add_mutually_exclusive_group()
+            filters.add_argument("--done", action="store_true", help="show completed tasks")
+            filters.add_argument("--undone", action="store_true", help="show pending tasks")
+            filters.add_argument("--all", action="store_true", help="show every task")
+    return parser
+
+

student_task_manager_cli-0.1.0/src/task_manager/cli.py

@@ -0,0 +1,22 @@
+import sys
+
+from .arguments import parser_for_cli
+from .commands import execute
+
+
+def main(argv: list[str] | None = None) -> int:
+    argv = sys.argv[1:] if argv is None else argv
+    if not argv:
+        from .interactive import run_interactive
+
+        return run_interactive(main)
+    parser = parser_for_cli()
+    args = parser.parse_args(argv)
+    if args.command == "help":
+        parser.print_help()
+        return 0
+    if args.command == "demo":
+        from .demo import run_demo
+
+        return run_demo(preview=args.preview)
+    return execute(args)

student_task_manager_cli-0.1.0/src/task_manager/commands.py

@@ -0,0 +1,75 @@
+import sys
+from datetime import datetime, timezone
+
+from .productivity import format_stats
+from .storage import StorageError, load_data, save_data
+
+
+def execute(args) -> int:
+    if args.command in ("add", "update"):
+        title = args.title.strip()
+        if not title:
+            print("Error: task title cannot be empty.", file=sys.stderr)
+            return 1
+
+    try:
+        data = load_data()
+        tasks = data["tasks"]
+
+        if args.command == "add":
+            task = {
+                "id": data["next_id"],
+                "title": title,
+                "status": "pending",
+                "created_at": datetime.now(timezone.utc).isoformat(timespec="seconds"),
+            }
+            tasks.append(task)
+            save_data(data)
+            print(f"Added task {task['id']}: {title}")
+        elif args.command == "list":
+            visible = [task for task in tasks if args.all or task["status"] == ("completed" if args.done else "pending")]
+            if not visible:
+                print("No tasks yet." if not tasks else "No completed tasks." if args.done else "No pending tasks.")
+            for task in visible:
+                print(f"{task['id']}. [{task['status']}] {task['title']}")
+        elif args.command == "stats":
+            print(format_stats(tasks))
+        elif args.command == "clear":
+            remaining = [task for task in tasks if task["status"] != "completed"]
+            removed = len(tasks) - len(remaining)
+            data["tasks"] = remaining
+            save_data(data)
+            print(f"Removed {removed} completed task(s).")
+        else:
+            task = next((task for task in tasks if task["id"] == args.id), None)
+            if task is None:
+                print(f"Error: task {args.id} not found.", file=sys.stderr)
+                return 1
+            if args.command == "show":
+                print(f"ID: {task['id']}\nTitle: {task['title']}\nStatus: {task['status']}\nCreated: {task['created_at']}")
+                if task.get("completed_at"):
+                    print(f"Completed: {task['completed_at']}")
+            elif args.command == "delete":
+                tasks.remove(task)
+                save_data(data)
+                print(f"Deleted task {args.id}.")
+            else:
+                if args.command == "update":
+                    task["title"] = title
+                else:
+                    if args.command == "done" and task["status"] != "completed":
+                        task["completed_at"] = datetime.now(timezone.utc).isoformat(timespec="seconds")
+                    elif args.command == "undone":
+                        task.pop("completed_at", None)
+                    task["status"] = "completed" if args.command == "done" else "pending"
+                save_data(data)
+                if args.command == "done":
+                    print(f"Completed: {task['title']}")
+                elif args.command == "undone":
+                    print(f"Back to To do: {task['title']}")
+                else:
+                    print(f"Renamed task {task['id']}: {task['title']}")
+    except StorageError as error:
+        print(f"Error: {error}", file=sys.stderr)
+        return 1
+    return 0