Python 教程 / 最终项目:SQLite 支出管理程序

这个最终项目把日期、分类和金额输入、SQLite 存储、记录列表与分类汇总连接成一个完整命令行程序。明确区分初始化、添加、查询和验证,才能判断重复执行时哪些数据会保留、哪些操作会新增记录。

明确功能范围与数据规则

本例金额使用整韩元的非负整数,范围是 0 至 1,000,000,000,000,不进行货币换算;日期使用真实存在的 YYYY-MM-DD,分类去除首尾空白后不能为空。程序不包含银行连接、付款或多用户认证。

请使用 Python 3.12 以上和独立练习目录,只需标准库。默认 ledger.db 在当前工作目录中;--db 可以指定另一个数据库路径,不能指向业务文件或不相关的练习数据库。存储背景参见sqlite3 保存与事务,接口见Python 官方 sqlite3 文档。

init 按需建立表,不清空已有数据;add 每次都会插入一条新支出。同样的 add 命令执行两次,就有两条记录,与按外部 ID 更新的收集器政策不同。不能把重复添加理解成自动去重。

保存完整程序

将下面全部内容以 UTF-8 保存为 ledger.py。amount_value 转换并检查金额,date_value 解析日期并要求规范文字格式,main 负责子命令分派与数据库连接寿命:

import argparse
import sqlite3
from datetime import date
from pathlib import Path

MAX_AMOUNT = 1_000_000_000_000

def amount_value(text):
    try:
        value = int(text)
    except ValueError as error:
        raise argparse.ArgumentTypeError("expected an integer") from error
    if not 0 <= value <= MAX_AMOUNT:
        raise argparse.ArgumentTypeError("amount must be between 0 and 1000000000000")
    return value

def date_value(text):
    try:
        parsed = date.fromisoformat(text)
    except ValueError as error:
        raise argparse.ArgumentTypeError("invalid date") from error
    if parsed.isoformat() != text:
        raise argparse.ArgumentTypeError("use YYYY-MM-DD")
    return text

def main():
    parser = argparse.ArgumentParser()
    parser.add_argument("--db", type=Path, default=Path("ledger.db"))
    commands = parser.add_subparsers(dest="command", required=True)
    commands.add_parser("init")
    add = commands.add_parser("add")
    add.add_argument("day", type=date_value)
    add.add_argument("category")
    add.add_argument("amount", type=amount_value)
    commands.add_parser("list")
    commands.add_parser("summary")
    args = parser.parse_args()
    if args.command != "init" and not args.db.is_file():
        parser.error("database not initialized")
    if args.command == "add" and not args.category.strip():
        parser.error("category is required")
    con = sqlite3.connect(args.db, autocommit=False)
    try:
        if args.command == "init":
            with con:
                con.execute("CREATE TABLE IF NOT EXISTS expenses (id INTEGER PRIMARY KEY, day TEXT NOT NULL, category TEXT NOT NULL CHECK(length(trim(category))>0), amount INTEGER NOT NULL CHECK(amount BETWEEN 0 AND 1000000000000))")
            print("initialized")
        elif args.command == "add":
            with con:
                con.execute("INSERT INTO expenses(day,category,amount) VALUES(?,?,?)", (args.day, args.category.strip(), args.amount))
            print("added")
        elif args.command == "list":
            for row in con.execute("SELECT id,day,category,amount FROM expenses ORDER BY day,id"):
                print(*row)
        else:
            totals = {}
            for category, amount in con.execute("SELECT category,amount FROM expenses"):
                totals[category] = totals.get(category, 0) + amount
            for category, total in sorted(totals.items()):
                print(category, total)
    finally:
        con.close()

if __name__ == "__main__":
    main()

date.fromisoformat 可识别的格式比本例界面更宽,因此解析后还比较 isoformat() 与原始文字,让 20261017 这样的紧凑格式不能绕过 YYYY-MM-DD 规则。日历解析规则见Python 官方 date 文档。

依次初始化、添加和查询

在文件所在目录选用项目环境,依次运行下列命令。如果已经确认解释器命令是 python3,则统一替换命令名。不要在已装入其他支出的默认数据库中期待相同初始结果:

python ledger.py init
python ledger.py add 2026-10-17 food 3500
python ledger.py add 2026-10-17 food 8000
python ledger.py add 2026-10-17 transport 2500
python ledger.py list
python ledger.py summary

init 输出 initialized,每次 add 输出 added。list 按日期再按 id 排序,显示 id、日期、分类、金额。新数据库中的三个列表记录应分别是 3500、8000、2500;最后的 summary 为:

food 11500
transport 2500

这三笔总计 14000。为了从空状态重新比较,使用新目录或新的数据库路径。全局选项必须放在子命令前,例如 python ledger.py --db other-ledger.db init;路径有空格时,用所用 shell 的引号规则将其作为一个参数传入。不要为重置演示而随意删除未知数据库。

文件存在检查只说明路径上有文件,不能证明其中已有正确的 expenses 表。如果指定一个其他 SQLite 文件,list 仍可能报 no such table。init 的 IF NOT EXISTS 也不会修复旧表的字段或约束;应先核对路径和数据库结构,再决定是否需要迁移。

检查拒绝、持久化与集成结果

  1. 尝试 2026-02-30,确认输入在添加记录前被拒绝。
  2. 再试负金额、超过上限的金额和空白分类,分别检查失败退出码,并确认列表记录数没有增长。
  3. 每次命令都是独立进程。添加成功后再运行 list,应仍能看到保存的数据。
  4. 在新数据库重新输入三笔支出,核对相同汇总;重复 init 不应清空记录,重复 add 则应增加一条。

把下面完整检查另存为同目录中的 check_ledger.py,保持 ledger.py 也在这里,运行 python check_ledger.py。它明确把 --db 指向自己创建的临时数据库,不使用默认业务路径。

import subprocess
import sys
import tempfile
from pathlib import Path
program = Path("ledger.py").resolve()
with tempfile.TemporaryDirectory() as folder:
    db = Path(folder) / "test.db"
    def run(*args):
        return subprocess.run([sys.executable, str(program), "--db", str(db), *args], capture_output=True, text=True)
    assert run("init").returncode == 0
    assert run("add", "2026-10-17", "food", "8000").returncode == 0
    assert run("add", "2026-02-30", "food", "8000").returncode != 0
    assert run("add", "2026-10-17", "food", "-1").returncode != 0
    assert run("add", "2026-10-17", "food", "1000000000001").returncode != 0
    result = run("summary")
    assert result.returncode == 0 and result.stdout.strip() == "food 8000"
    assert len(run("list").stdout.splitlines()) == 1
print("integration checks passed")

预期输出:

integration checks passed

这段脚本使用普通 assert,不要使用 -O 优化参数执行,否则这些检查会被移除。TemporaryDirectory 在退出时清理自己创建的临时文件。自动测试应只处理独立的可丢弃数据,实际个人记录仍需另行保护。

SQL 值参数避免把输入直接拼入语句,Python 验证和数据库 CHECK 相互补充。写入异常时连接上下文回滚未提交操作,finally 关闭连接;上下文本身不会代替 close。当前数据库声明也不是所有字段的严格类型与日期约束,其他写入路径必须遵守同样的输入政策。

扩大项目时拆分职责

处理顺序是参数解析、日期金额验证、数据库文件检查、事务写入或查询、输出。功能增加时可把输入验证、数据访问与汇总拆成模块,用自动测试保留已有行为。保留 main 入口保护,使 import 本身不创建数据库、不解析调用方的参数。

summary 在 Python 中累加整数,避免依赖 SQLite 整数 SUM 的累计范围,也不将金额改为浮点 total()。聚合差异见SQLite 官方 sum 与 total 说明。读取按行进行,但合计字典的内存仍随分类数量增长。

使用真实个人数据之前,还要明确文件权限、备份、恢复、共享位置、结构迁移和并发访问政策。评价这个练习时同时看合计、无效输入拒绝和重复命令的意义,而不能只看一次打印的数字正确。