encoding-fix · diff
v1.0.0 to v1.0.0
18 added, 21 removed. Audit A to A.
---
name: encoding-fix
version: 1.0.0
type: tool
author: Lukas Geiger
created: 2026-03-12
updated: 2026-03-12
description: Mojibake repair for double/triple encoded UTF-8. Fixes Windows cp1252/Latin-1 misinterpretations. Zero dependencies.
standalone: true
anthropic_compatible: true
bach_compatible: true
bach_origin: true
category: utilities
tags: [encoding, utf-8, mojibake, windows, cp1252, text-repair]
language: de
status: active
visibility: public
dependencies: {'tools': [], 'services': [], 'protocols': [], 'python': []}
provenance: {'origin': 'bach', 'origin_path': 'system/tools/encoding_fix.py', 'origin_version': '1.0.0', 'origin_repo': 'github.com/ellmos-ai/bach', 'last_sync_from_origin': '2026-03-12', 'last_sync_to_origin': None, 'local_changes_since_sync': False}
---
-
<img src="banner.png" width="100%" alt="encoding-fix banner">
- > **Deutsch** — Offizielle Deutsch-Version / Documento Oficial en Deutsch.
-
-
- # Encoding Fix (Deutsch)
+ # Encoding Fix
- Repairs mojibake (double/triple encoded UTF-8) caused by Windows cp1252/Latin-1
- misinterpretation. Zero dependencies — Python stdlib only.
+ Repariert Mojibake (doppelt/dreifach kodiertes UTF-8) das durch Windows cp1252/Latin-1
+ Fehlinterpretation entsteht. Zero Dependencies — nur Python stdlib.
- ## Typical Problem
+ ## Typisches Problem
```
- "ue" (U+00FC) -> UTF-8 \xc3\xbc -> read as cp1252 -> "ü"
+ "ue" (U+00FC) → UTF-8 \xc3\xbc → als cp1252 gelesen → "ü"
```
- ## Usage
+ ## Nutzung
- ### As Library
+ ### Als Library
```python
from encoding_fix import sanitize_outbound
- clean = sanitize_outbound("Würge") # -> "Wuerge"
+ clean = sanitize_outbound("Würge") # → "Würge"
```
- ### Subprocess Output
+ ### Subprocess-Output
```python
from encoding_fix import sanitize_subprocess_output
text = sanitize_subprocess_output(process.stdout)
```
### CLI
```bash
- python encoding_fix.py "Würge" # Check a single string
- python encoding_fix.py # Self-test
+ python encoding_fix.py "Würge" # Einzelnen String prüfen
+ python encoding_fix.py # Selbst-Test
```
## Features
- - **Idempotent:** Correctly encoded text is not modified
- - **Up to 3 rounds:** Repairs even triple-encoded strings
- - **Subprocess decoder:** UTF-8/cp1252 fallback for process output
- - **Zero dependencies:** Python stdlib only
+ - **Idempotent:** Korrekt kodierter Text wird nicht veraendert
+ - **Bis zu 3 Runden:** Repariert auch dreifach-kodierte Strings
+ - **Subprocess-Dekoder:** UTF-8/cp1252 Fallback fuer Prozess-Output
+ - **Zero Dependencies:** Nur Python stdlib
- ## Änderungsprotokoll
+ ## Changelog
### 1.0.0 (2026-03-12)
- - Ported from BACH system/tools/encoding_fix.py
+ - Portiert aus BACH system/tools/encoding_fix.py
+