1 line
4.3 KiB
JSON
1 line
4.3 KiB
JSON
{"Implementation approach":"本项目使用Python标准库实现，无需第三方依赖。命令行参数解析采用argparse模块，数据持久化使用json模块，文件存储于用户主目录下的.todo_cli/todos.json。核心逻辑封装在TodoManager类中，提供增删改查方法。CLI接口通过TodoCLI类处理用户输入并调用TodoManager。数据模型TodoItem使用dataclass简化定义。整体设计遵循单一职责原则，确保代码简洁可维护。","File list":["main.py","todo.py","storage.py"],"Data structures and interfaces":"classDiagram\n class TodoItem {\n -int id\n -str title\n -str description\n -str due_date\n -bool completed\n -str created_at\n +__init__(id: int, title: str, description: str = \"\", due_date: str = \"\", completed: bool = False, created_at: str = \"\")\n +to_dict() dict\n +from_dict(data: dict) TodoItem\n }\n class Storage {\n -str file_path\n +__init__(file_path: str)\n +load() list[dict]\n +save(data: list[dict]) None\n }\n class TodoManager {\n -list[TodoItem] items\n -Storage storage\n -int next_id\n +__init__(storage: Storage)\n +add(title: str, description: str = \"\", due_date: str = \"\") TodoItem\n +list_all() list[TodoItem]\n +list_by_status(completed: bool) list[TodoItem]\n +mark_done(item_id: int) bool\n +mark_undone(item_id: int) bool\n +delete(item_id: int) bool\n +edit(item_id: int, title: str = None, description: str = None, due_date: str = None, completed: bool = None) bool\n +_load() None\n +_save() None\n +_find_by_id(item_id: int) TodoItem | None\n }\n class TodoCLI {\n -TodoManager manager\n -argparse.ArgumentParser parser\n +__init__(manager: TodoManager)\n +run(args: list[str] = None) None\n +_setup_parser() None\n +_handle_add(args) None\n +_handle_list(args) None\n +_handle_done(args) None\n +_handle_delete(args) None\n +_handle_edit(args) None\n }\n TodoCLI --> TodoManager\n TodoManager --> Storage\n TodoManager --> TodoItem\n Storage ..> TodoItem : uses to_dict/from_dict\n","Program call flow":"sequenceDiagram\n participant User as 用户\n participant CLI as TodoCLI\n participant Manager as TodoManager\n participant Storage as Storage\n participant File as JSON文件\n User->>CLI: python main.py add \"任务标题\" -d \"描述\" -due 2025-01-01\n CLI->>CLI: _setup_parser() 解析参数\n CLI->>CLI: _handle_add(args)\n CLI->>Manager: add(title, description, due_date)\n Manager->>Manager: 生成新TodoItem，设置id=next_id\n Manager->>Manager: 将item加入items列表\n Manager->>Manager: _save()\n Manager->>Storage: save([item.to_dict() for item in items])\n Storage->>File: 写入JSON文件\n File-->>Storage: 成功\n Storage-->>Manager: None\n Manager-->>CLI: 返回新TodoItem\n CLI-->>User: 打印添加成功信息\n\n User->>CLI: python main.py list\n CLI->>CLI: _handle_list(args)\n CLI->>Manager: list_all()\n Manager->>Manager: 返回items列表\n Manager-->>CLI: list[TodoItem]\n CLI->>CLI: 格式化输出表格\n CLI-->>User: 显示所有任务\n\n User->>CLI: python main.py done 1\n CLI->>CLI: _handle_done(args)\n CLI->>Manager: mark_done(1)\n Manager->>Manager: _find_by_id(1) -> item\n Manager->>Manager: item.completed = True\n Manager->>Manager: _save()\n Manager-->>CLI: True\n CLI-->>User: 打印标记成功\n\n User->>CLI: python main.py delete 1\n CLI->>CLI: _handle_delete(args)\n CLI->>Manager: delete(1)\n Manager->>Manager: _find_by_id(1) -> item\n Manager->>Manager: 从items中移除\n Manager->>Manager: _save()\n Manager-->>CLI: True\n CLI-->>User: 打印删除成功\n\n User->>CLI: python main.py edit 1 --title \"新标题\" --description \"新描述\"\n CLI->>CLI: _handle_edit(args)\n CLI->>Manager: edit(1, title=\"新标题\", description=\"新描述\")\n Manager->>Manager: _find_by_id(1) -> item\n Manager->>Manager: 更新item属性\n Manager->>Manager: _save()\n Manager-->>CLI: True\n CLI-->>User: 打印编辑成功\n","Anything UNCLEAR":"无"} |