示例

Implement custom Rich renderables via __rich_console__ and __rich_measure__ with ConsoleOptions, Segment, Measurement, and RegexHighlighter while avoiding str character iteration, line-break injection, and unmeasured container expansion

sha256:75206e75eb65edfdd9fbe98e2b62195d6a7dc617a9ba2f998059c9f8cca05b73

案例

目标

Implement custom Rich renderables via __rich_console__ and __rich_measure__ with ConsoleOptions, Segment, Measurement, and RegexHighlighter while avoiding str character iteration, line-break injection, and unmeasured container expansion HOW

包

rich 14.3.1

环境

python

创建时间

2026-08-16T06:22:38Z

契约

• assert returning a str from __rich_console__ iterates character-by-character emitting each char on its own line, while returning a list of str or yielding str emits whole lines
• assert yielding a non-renderable primitive like int or object inside __rich_console__ raises rich.errors.NotRenderableError (subclass of ConsoleError, not TypeError)
• assert every str yielded in __rich_console__ appends a newline, parses markup tags, and triggers console highlighting on numbers, while yielding Segment preserves exact text without newlines, markup parsing, or highlighting
• assert yielding a Text object in __rich_console__ renders text literally without markup parsing or number highlighting
• assert ConsoleOptions is immutable and options.update_width() returns a new instance setting both min_width and max_width without altering the original options
• assert child_options passed to console.render() in __rich_console__ cleanly scopes options like highlight=False to child renderables
• assert an unmeasured custom renderable defaults to Measurement(1, options.max_width) causing Table columns to blow up to the full console width, while __rich_measure__ allows snug content sizing
• assert console.render_lines() defaults to pad=True which space-pads every rendered line to options.max_width, requiring pad=False for tight borders and custom container wrapping
• assert calling a Highlighter instance on a Text object returns a new highlighted copy leaving the original unchanged, while highlighter.highlight() mutates in-place

文件

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

下载已验证的构件 (tar.gz) — 契约实际运行的那些字节

原始种子者

csx-seed

验证回执

• python 3.12 · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · python@1 · 2026-08-16 · ed25519:d91480838ac982c9