跳到主内容
芝麻园地

F04 · 预测 · 排错 · 本地验证

F04 输入校验:为什么示例通过换个输入就出错

换成空白标题、缺少 tags 或规范化重名,程序报错了,集合里却已经留下半条记录。报错不等于没有副作用。

返回实战路线 →

故障现场与本地契约

def add_document(documents, candidate):
    documents.append(candidate)
    validate_document(candidate)
    return candidate
  • 实现 validate_document、add_document、update_document。遵守公共字段类型、ID、500 条、标题 120 码点、分类 40 码点、最多 12 个标签且每项 32 码点的契约。
  • 标题去首尾空白后 casefold() 去重。更新保留 ID,只改 title、category、tags,查重排除自己。合法重命名成功,撞名、坏字段、未知 ID 明确失败。
  • 先在独立候选上校验,全部通过再提交;失败保持原集合完整不变。网页只用 Python 生成的规范化预置值,不声称支持任意 Unicode 输入。

使用虚构资料元数据;网页推演不执行任意代码。

01 · 模型推演

先预测,再逐步观察

这里只推演所选预设,没有执行你的 Python 草稿,也没有读写电脑文件。一组模型符合预期,不能证明所有输入都正确。

成功要得到完整候选;失败既要报错,也要保持集合逐字段不变。规范化结果是 Python 预生成值,不对自由输入执行 casefold。

未检查或已失效

    操作前

    {
      "records": [
        {
          "id": "doc_00000000000000000000000000000001",
          "title": "Straße",
          "category": "course",
          "tags": [
            "study"
          ]
        },
        {
          "id": "doc_00000000000000000000000000000002",
          "title": "Notes",
          "category": "course",
          "tags": [
            "study"
          ]
        }
      ],
      "operation": "add",
      "input": {
        "id": "doc_00000000000000000000000000000003",
        "title": "New Notes",
        "category": "course",
        "tags": [
          "study"
        ]
      }
    }

    推演结果

    逐步观察后查看结果

    分级学习提示

    提示是固定教学内容,使用情况会记入学习记录。

    提示 1

    列出失败时的预期集合。返回“失败”够吗?比较前后每一个字段。

    提示 2

    在候选记录上检查类型、长度、规范化标题,再写回。更新查重先排除自身 ID。

    提示 3

    覆盖空白、重名、边界长度、错误类型和重命名撞名;失败不能留下新记录或覆盖旧字段。toLowerCase() 不等于 casefold()。

    我的 Python 草稿

    这里只保存和导出草稿,不运行代码,也不与起始工程同步。修改草稿、输入或策略后,原模型结果与自报记录会失效。

    本机学习记录

    只保存在当前浏览器,可导出;不跨设备同步,不证明掌握。F01 与六任务旧记录会迁移保留。

    • 已打开 F04: —
    • 模型检查: 未检查或已失效
    • 本地测试自报: —
    • 最高提示层级: 0/3
    • 已查看参考: —
    • 无帮助变式自报: —

    02 · 修复自己的本地工程

    每项任务都能独立开始:本包保留该任务的故障,其余业务函数作为可运行基线。Python 3.11+,仅标准库;实际环境见包内验收说明。

    下载本任务起始工程

    1. 解压到新目录,打开终端并确认正在运行的文件。先运行公开测试,复现故障。起始包的预期失败列表以包内说明为准。
    2. 写下假设,选择一个可观察的值;修改指定函数,保留公开测试。记录修复前后差异与自己的最小反例。
    3. 先运行本任务测试,再运行完整回归。网页结果不替代本地运行;自报不代表本站远程验证。
    python check_environment.py
    python -m unittest tests.test_f04 -v
    python -m unittest discover -s tests -v

    03 · 独立变式

    在 challenges.py 实现 register_attendee(attendees, name):本包要求非空字符串、最多 50 个码点、strip().casefold() 后不重名。解释至少两项规则,写出能击穿“先加入再检查”的测试,再实现添加;错误明确且原集合不变,补上自己的边界反例。

    python -m unittest tests.test_variants -v

    只看需求自行实现,在 tests/test_student_counterexamples.py 中替换跳过占位,补上能暴露原故障的断言,并说明为何失败。查看参考或提示后,本次不会记录为无帮助完成。

    参考解释与答案

    先尝试自己的修复。展开或下载参考会记录答案使用;参考包通过测试只证明材料可运行。

    查看参考解释(会记录使用)

    先建立候选、验证全部规则、最后一次提交,避免半条记录。标题规范化只定义本项目规则:Straße 与 STRASSE 的 casefold 结果相同,不意味着现实所有同名资料都要合并。

    下载本任务参考实现(答案) · 版本与来源摘要

    课名索引与补学