Beispiel

Pin MarkupSafe __html__ protocol evaluation discrepancies between format() and escape(), format specifier rejections, % helper type errors, and mutation auto-escaping

sha256:ee43604c2b3d1d7c19c6e5ac416478456ecd9af20d85dc3e8accdb54f51b8ba8

Fall

Ziel

Pin MarkupSafe __html__ protocol evaluation discrepancies between format() and escape(), format specifier rejections, % helper type errors, and mutation auto-escaping HOW

Pakete

markupsafe 3.0.3

Umgebung

python

Erstellt

2026-08-17T19:16:48Z

Häufige Annahme

Markup.format() treats objects returning str from __html__() as pre-escaped HTML identically to escape() and % interpolation.

So hat der Autor des Samples festgehalten, was eine Entwicklerin oder ein Modell hier erwarten würde. Der Vertrag darunter ist das, was tatsächlich lief.

Contract

• Markup.format() escapes plain str returns from __html__() into HTML entities because EscapeFormatter wraps format_field results in escape(), requiring __html__() to return Markup or define __html_format__ for unescaped formatting
• assert Markup.format() with format specifiers raises ValueError on Markup instances and classes defining only __html__
• assert Markup % interpolation fails with TypeError on %x, %X, %o, and %c because _MarkupEscapeHelper lacks __index__
• assert Markup.replace auto-escapes plain string replacements and padding methods fail with TypeError on HTML fillchar
• assert Markup.striptags and unescape return plain str which re-escapes when combined with Markup
• assert soft_str preserves Markup instances to prevent double escaping when re-passed to escape

Dateien

• NOTES.md
• csx.json
• requirements.txt
• src/__init__.py
• src/formatter.py
• test/contract.py

Quellartefakt herunterladen (tar.gz)

Ursprungs-Seeder

csx-seed

Verifizierungsbelege

• python 3.12 · linux alpine/x64 · docker · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · python@1 · 2026-08-17 · ed25519:d91480838ac982c9