fix(content): keep blocks inside u/mark/ins, and pin four reader guards (0.4.1)

[baraline]

Why

0.4.0's fix 11 keeps , and as raw tags, including around blocks. Markdown has no inline tag round blocks, so a table inside one read as pipe text, and a list, a heading, a quote or a rule read as Markdown source. Paragraphs were not a fixed point.

code

left a fence open that showed the rest of the memo as code.

A review also found four guards of 0.4.0's fixes that no test caught, and a few inaccurate statements in docs/content.rst.

What

• Reader (content/conversion.py): a , or holding a block is dropped and its blocks kept, as glpi_python_client's reader at 917f030 read them. Inside a table cell or a heading, whose blocks are one line, the tag stays; around inline content nothing changes. One walk marks the tags that hold a block, linear however deep they nest. glpi_python_client's port makes the identical change.
• Tests:
  • the correction, for every block kind, the stray fence, nested tags and the one-line controls;
  • one test each for four guards: a second "<" before a space (fix 5), a header cell (fix 6), an anchor without href (fix 7), and an item numbered 10 or more (fix 12);
  • a count of the walk's checks;
  • the display oracle now counts an

    ---

    inside an inline element as a rule.
• docs/content.rst corrected:
  • start values;
  • any ValueError degrading to text;
  • the CVE-2025-6069 tail, which also shows an unterminated comment or a cut-short closing tag;
  • a second write-and-read cycle has two exceptions;
  • the new behaviour, and a known hole for , and round blocks.
• Version 0.4.1 and a CHANGELOG entry. Nothing outside easyvista_python_client.content changes.

Verification

• The new tests fail 40 of 42 on 0.4.0's converter; the two that pass are the controls.
• Every guard mutant (the walk, the one-line exception, popping, the block set, the stop, and the four pinned guards) fails the content suite.
• Parity with glpi_python_client's port:
  • identical ASTs once names, messages, docstrings and the import guard are set aside;
  • 135,738 differential comparisons over both packages' test bodies and a seeded fuzz corpus, 0 mismatches.
• Gates:
  • pytest -m "not integration" with coverage: 2085 passed, 98.93%;
  • ruff check, ruff format --check, mypy strict, unasync_build.py --check, scripts/lint_hand_written_sync.py --check;
  • sphinx -E -W, built offline.

Known follow-ups (from the review; all Minor)

• , and round blocks remain a documented hole.
• The converter reads start with isdecimal; a browser reads " 3", "+3" or "3abc" as 3. This is documented.
• The module docstring and content.rst still say the fixes are to be proposed to glpi_python_client; update them once its port is released.
• An inline wrapper (<span>, <font>, and now a dropped <u>/<mark>/<ins>) round a list, followed by inline text, reads that text into the list's last item. This is markdownify's general behaviour, the same on every tree; the fix belongs in the list converter's next-sibling handling.
• A data-glpi-block / data-ev-block attribute already present in stored HTML is trusted by the block walk. Only hand-made or sanitiser-kept HTML carries one; clear it on read.
• No test pins that the block walk runs after nested tables are flattened (formatting-only effect on a rare shape).
• The documented exceptions to the second-cycle fixed point are still too narrow: two adjacent lists separated by anything that reads as nothing (a comment, an empty <div>) also change on the second cycle.
• The start-value docs omit a negative start, a full-width digit, and a start of 10 or more digits, which reads as a paragraph.

Twin PR: baraline/glpi_python_client#40

🤖 Generated with Claude Code

[codecov-commenter]

⚠️ Please install the to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.92%. Comparing base (31318e6) to head (d75cda3).
❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files

@@           Coverage Diff           @@
##             main       #8   +/-   ##
=======================================
  Coverage   98.92%   98.92%           
=======================================
  Files          40       40           
  Lines        2595     2614   +19     
=======================================
+ Hits         2567     2586   +19     
  Misses         28       28           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.