在昨天的 Todo CLI 基础上,增加:分类、截止日期、统计、筛选。把它从玩具变成真正能用的工具。
给任务加两个新字段:category(分类)和 due_date(截止日期)。
| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| id | int | 自动 | 唯一标识 |
| content | str | 必填 | 任务内容 |
| done | bool | False | 是否完成 |
| priority | str | "medium" | high / medium / low |
| category | str | "默认" | 分类标签 |
| due_date | str? | None | 截止日期 YYYY-MM-DD |
| created_at | str | 自动 | 创建时间 |
import json
from datetime import datetime
from pathlib import Path
DATA_FILE = Path(__file__).parent / 'tasks.json'
def load_tasks():
if DATA_FILE.exists():
with open(DATA_FILE, 'r', encoding='utf-8') as f:
return json.load(f)
return []
def save_tasks(tasks):
with open(DATA_FILE, 'w', encoding='utf-8') as f:
json.dump(tasks, f, ensure_ascii=False, indent=2)
def add_task(content, priority='medium', category='默认', due_date=None):
tasks = load_tasks()
task = {
'id': len(tasks) + 1,
'content': content,
'done': False,
'priority': priority,
'category': category,
'due_date': due_date,
'created_at': datetime.now().strftime('%Y-%m-%d %H:%M')
}
tasks.append(task)
save_tasks(tasks)
return task
def get_task(task_id):
tasks = load_tasks()
for t in tasks:
if t['id'] == task_id:
return t
return None
def update_task(task_id, **kwargs):
"""更新任务字段,如 done=True 或 content='新内容'"""
tasks = load_tasks()
for t in tasks:
if t['id'] == task_id:
t.update(kwargs)
save_tasks(tasks)
return t
return None
def delete_task(task_id):
tasks = load_tasks()
tasks = [t for t in tasks if t['id'] != task_id]
save_tasks(tasks)
def stats():
"""统计信息"""
tasks = load_tasks()
total = len(tasks)
done = sum(1 for t in tasks if t['done'])
overdue = sum(1 for t in tasks
if not t['done'] and t['due_date']
and t['due_date'] < datetime.now().strftime('%Y-%m-%d'))
return {'total': total, 'done': done, 'pending': total - done, 'overdue': overdue}
#!/usr/bin/env python3
"""Todo CLI - 命令行任务管理器"""
import argparse
from datetime import datetime
from storage import (load_tasks, save_tasks, add_task,
get_task, update_task, delete_task, stats)
def cmd_add(args):
task = add_task(args.content, args.priority, args.category, args.due)
print(f'✅ 添加任务 #{task["id"]}: {task["content"]}')
print(f' 优先级: {task["priority"]} | 分类: {task["category"]} | 截止: {task["due_date"] or "无"}')
def cmd_list(args):
tasks = load_tasks()
# 筛选
if args.category:
tasks = [t for t in tasks if t['category'] == args.category]
if args.priority:
tasks = [t for t in tasks if t['priority'] == args.priority]
if args.status == 'done':
tasks = [t for t in tasks if t['done']]
elif args.status == 'pending':
tasks = [t for t in tasks if not t['done']]
# 排序
priority_order = {'high': 0, 'medium': 1, 'low': 2}
tasks.sort(key=lambda x: (x['done'], priority_order.get(x['priority'], 1)))
if not tasks:
print('📝 暂无任务')
return
for t in tasks:
status = '✓' if t['done'] else '○'
due = f' ⏰{t["due_date"]}' if t['due_date'] else ''
print(f'{status} [{t["priority"][0].upper()}] #{t["id"]} {t["content"]} ({t["category"]}){due}')
def cmd_done(args):
t = update_task(args.id, done=True)
if t:
print(f'✅ 完成任务 #{args.id}: {t["content"]}')
else:
print(f'❌ 找不到任务 #{args.id}')
def cmd_delete(args):
delete_task(args.id)
print(f'🗑️ 删除任务 #{args.id}')
def cmd_stats(args):
s = stats()
print('📊 统计信息')
print(f' 总任务: {s["total"]}')
print(f' 已完成: {s["done"]}')
print(f' 待办: {s["pending"]}')
print(f' 已逾期: {s["overdue"]}')
if s['total'] > 0:
pct = s['done'] / s['total'] * 100
print(f' 完成率: {pct:.1f}%')
def main():
parser = argparse.ArgumentParser(description='Todo 任务管理器')
subparsers = parser.add_subparsers(dest='command')
# add
p_add = subparsers.add_parser('add', help='添加任务')
p_add.add_argument('content', help='任务内容')
p_add.add_argument('-p', '--priority', choices=['high', 'medium', 'low'], default='medium')
p_add.add_argument('-c', '--category', default='默认', help='分类')
p_add.add_argument('-d', '--due', help='截止日期 YYYY-MM-DD')
p_add.set_defaults(func=cmd_add)
# list
p_list = subparsers.add_parser('list', help='列出任务')
p_list.add_argument('-c', '--category', help='按分类筛选')
p_list.add_argument('-p', '--priority', choices=['high', 'medium', 'low'])
p_list.add_argument('-s', '--status', choices=['done', 'pending'], help='按状态筛选')
p_list.set_defaults(func=cmd_list)
# done
p_done = subparsers.add_parser('done', help='标记完成')
p_done.add_argument('id', type=int)
p_done.set_defaults(func=cmd_done)
# delete
p_del = subparsers.add_parser('delete', help='删除任务')
p_del.add_argument('id', type=int)
p_del.set_defaults(func=cmd_delete)
# stats
p_stats = subparsers.add_parser('stats', help='统计信息')
p_stats.set_defaults(func=cmd_stats)
args = parser.parse_args()
if args.command:
args.func(args)
else:
parser.print_help()
if __name__ == '__main__':
main()
program
.command('add <content>')
.option('-p, --priority <p>')
.option('-c, --category <c>')
.action((content, opts) => {
console.log('添加:', content, opts);
});
p_add = subparsers.add_parser('add')
p_add.add_argument('content')
p_add.add_argument('-p', '--priority')
p_add.add_argument('-c', '--category')
p_add.set_defaults(func=cmd_add)
set_defaults(func=...) 把命令和函数绑定。Python 方式更清晰,每个命令一个函数,便于测试。
添加 search <关键词> 命令,在任务内容中模糊搜索。
def cmd_search(args):
tasks = load_tasks()
results = [t for t in tasks if args.keyword in t['content']]
for t in results:
status = '✓' if t['done'] else '○'
print(f'{status} #{t["id"]} {t["content"]}')
# argparse
p_search = subparsers.add_parser('search', help='搜索任务')
p_search.add_argument('keyword', help='搜索关键词')
p_search.set_defaults(func=cmd_search)
stats 命令显示每个分类的任务数量。
def cmd_stats(args):
tasks = load_tasks()
categories = {}
for t in tasks:
cat = t['category']
categories[cat] = categories.get(cat, 0) + 1
print('📊 按分类统计:')
for cat, count in categories.items():
print(f' {cat}: {count} 个任务')
添加 edit <id> --content "新内容" 命令修改任务。
def cmd_edit(args):
kwargs = {}
if args.content:
kwargs['content'] = args.content
if args.priority:
kwargs['priority'] = args.priority
if args.category:
kwargs['category'] = args.category
t = update_task(args.id, **kwargs)
print(f'✏️ 更新任务 #{args.id}')
# argparse
p_edit = subparsers.add_parser('edit', help='编辑任务')
p_edit.add_argument('id', type=int)
p_edit.add_argument('--content')
p_edit.add_argument('-p', '--priority', choices=['high', 'medium', 'low'])
p_edit.add_argument('-c', '--category')
p_edit.set_defaults(func=cmd_edit)
添加 export <文件名> 命令,把任务导出为 CSV 文件。
import csv
def cmd_export(args):
tasks = load_tasks()
with open(args.filename, 'w', newline='', encoding='utf-8') as f:
writer = csv.DictWriter(f, fieldnames=['id','content','done','priority','category','due_date','created_at'])
writer.writeheader()
writer.writerows(tasks)
print(f'📄 导出 {len(tasks)} 个任务到 {args.filename}')
# argparse
p_export = subparsers.add_parser('export', help='导出 CSV')
p_export.add_argument('filename', help='输出文件名')
p_export.set_defaults(func=cmd_export)
| 天 | 主题 | 关键知识点 |
|---|---|---|
| Day 1 | 环境 + 语法 | print、变量、类型 |
| Day 2 | 控制流 | if/for/while、列表推导式 |
| Day 3 | 函数 | def、参数、返回值、作用域 |
| Day 4 | 数据结构 | list/dict/tuple/set |
| Day 5 | 文件操作 | open、with、Path、JSON |
| Day 6 | Todo 上 | argparse、子命令、JSON 存储 |
| Day 7 | Todo 下 | 分类、筛选、统计、CSV 导出 |
set_defaults(func=...) 模式,知道为什么比 if/elif 好commander 回调和 Python argparse 函数绑定