mp_wcwidth

mp_wcwidth is a simplified, size-optimized port of the wcwidth library for MicroPython and embedded systems. It provides accurate width measurement for Unicode characters, including wide CJK characters and emoji, which is essential for proper text alignment and display in terminal applications.

Key Features

• Unicode 17.0.0 Support — Includes full character width tables for the latest Unicode standard.
• Character Width Measurement — wcwidth() function returns width of single characters (1, 2, 0, or -1 for control).
• String Width Measurement — wcswidth() function calculates total display width of strings.
• Wide Character Handling — Correctly processes CJK characters, emoji, and other wide characters.
• Zero-Width Support — Handles combining marks, ZWJ, and other zero-width characters.
• Performance Optimization — Includes a minimal dict-based cache to speed up repeated lookups.
• Control Character Detection — Identifies control characters (returning -1) for proper terminal behavior.

Philosophy

The project prioritizes minimal footprint and MicroPython compatibility, removing multi-version support and complex caching to achieve a 90% size reduction while retaining core functionality for embedded use.