Day 7 · Todo CLI 项目(下)

Week 1 · Day 7 / 56 · 预计 2 小时 · 返回大纲

一、今日目标

在昨天的 Todo CLI 基础上,增加:分类、截止日期、统计、筛选。把它从玩具变成真正能用的工具。

二、数据模型升级

给任务加两个新字段:category(分类)和 due_date(截止日期)。

字段类型默认值说明
idint自动唯一标识
contentstr必填任务内容
doneboolFalse是否完成
prioritystr"medium"high / medium / low
categorystr"默认"分类标签
due_datestr?None截止日期 YYYY-MM-DD
created_atstr自动创建时间

三、完整 storage.py

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}

四、完整 todo.py

#!/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()

五、运行示例

$ python todo.py add "写周报" -p high -c 工作 -d 2026-09-20
✅ 添加任务 #1: 写周报
优先级: high | 分类: 工作 | 截止: 2026-09-20

$ python todo.py add "买牛奶" -c 生活
✅ 添加任务 #2: 买牛奶
优先级: medium | 分类: 生活 | 截止: 无

$ python todo.py list
○ [H] #1 写周报 (工作) ⏰2026-09-20
○ [M] #2 买牛奶 (生活)

$ python todo.py list -c 工作
○ [H] #1 写周报 (工作) ⏰2026-09-20

$ python todo.py done 1
✅ 完成任务 #1: 写周报

$ python todo.py stats
📊 统计信息
总任务: 2
已完成: 1
待办: 1
已逾期: 0
完成率: 50.0%

六、JS vs Python 对比

Node.js (commander.js)
program
  .command('add <content>')
  .option('-p, --priority <p>')
  .option('-c, --category <c>')
  .action((content, opts) => {
    console.log('添加:', content, opts);
  });
Python (argparse)
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)
💡 关键区别:JavaScript 用回调函数处理命令,Python 用 set_defaults(func=...) 把命令和函数绑定。Python 方式更清晰,每个命令一个函数,便于测试。

七、练习

练习 1:搜索命令

添加 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)

练习 2:按分类统计

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} 个任务')

练习 3:编辑任务

添加 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)

练习 4:导出功能

添加 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 6Todo 上argparse、子命令、JSON 存储
Day 7Todo 下分类、筛选、统计、CSV 导出

九、打卡验收

完成了 Todo CLI 完整版,包含分类、优先级、截止日期
实现了按分类、优先级、状态筛选和排序
实现了统计功能,能显示总数、已完成、待办、逾期
理解了 set_defaults(func=...) 模式,知道为什么比 if/elif 好
对比了 JS commander 回调和 Python argparse 函数绑定
完成了至少 2 个练习,代码能跑通
本周所有知识点串起来了,能独立完成一个 CLI 项目
运行测试了所有命令,输出符合预期
打卡方式: 全部勾选后,告诉我 "Day 7 打卡",并贴出你的代码,我帮你检查。
🎉 Week 1 完成! 明天开始 Week 2:面向对象编程、迭代器、生成器、装饰器、错误处理。