Files
rengine/shared/utils/text.py
T
Yogesh OjhaandClaude Opus 5 2cb8d73280 style: strip explanatory comments across the codebase
The comment rule in CLAUDE.md is one line maximum, never narration: no
multi-line blocks, no module-header explainers, no sentences that explain or
justify the code to the reader. The tree had drifted a long way from it, and
most of the drift is mine.

Removed:
  232  lines of multi-line comment blocks
  203  single-line comments that argued instead of stating
  154  comments joined by so/because/otherwise/rather-than
  143  narrating comments in the frontend
  112  test docstrings (the test name already says what it asserts)
   25  test module docstrings and 25 decorative section dividers

Collapsed:
  324  multi-line docstrings to one factual line
  271  one-line docstrings that had a justifying clause bolted on

Kept: functional directives, section dividers, short field labels, alembic
revision headers, and the eight FastAPI route docstrings that render in /docs.
Where a fact was load-bearing it is in CLAUDE.md, which is where it belongs.

284 python tests and 34 frontend tests pass, ruff and ruff-format clean across
ten packages, svelte-check 0 errors, prettier and eslint clean, app.main imports.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013dKUV96WkQQETZBMoAG98C
2026-09-11 14:11:23 +05:30

31 lines
897 B
Python

"""Text stored in postgres: NUL is rejected outright, in text and in json alike."""
from __future__ import annotations
import re
from typing import Any
_NUL = "\x00"
_CTRL = re.compile(r"[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]")
def strip_nul(value: str) -> str:
"""Drop only what postgres refuses to store."""
return value.replace(_NUL, "") if _NUL in value else value
def strip_control(value: str) -> str:
"""strip_nul plus the other control characters, for text a person reads back."""
return _CTRL.sub("", value)
def scrub(value: Any) -> Any:
"""strip_nul through strings, lists and dicts on their way to a column."""
if isinstance(value, str):
return strip_nul(value)
if isinstance(value, list):
return [scrub(item) for item in value]
if isinstance(value, dict):
return {scrub(k): scrub(v) for k, v in value.items()}
return value