pangu.py: Automated Paranoid Text Spacing for Enhanced Readability

Introduction

pangu.py is a Python library that implements "paranoid" text spacing to enhance readability. It automatically inserts whitespace between CJK (Chinese, Japanese, Korean) characters and half-width characters (alphabetical letters, numerical digits, and symbols). This opinionated approach ensures consistent and visually pleasing text formatting, making your content easier to read.

Installation

Installing pangu.py is straightforward using uv or pip:

$ uv add pangu
# or
$ pip install -U pangu

Examples

pangu.py can be used both within Python scripts and as a command-line tool.

In Python

import pangu

new_text = pangu.spacing_text("???????????????Monkey Patch????")
# new_text = "??????????????? Monkey Patch ????"

new_content = pangu.spacing_file("path/to/file.txt", encoding="utf-8")
# new_content = "? PM ??????????????? PM"

pangu.has_proper_spacing("?? Hadoop ??????????? Map/Reduce ?")
# True

In CLI

$ pangu-py "?????????????????????DevOps???????????????????????????????1.??2.???3.????"
????????????????????? DevOps??????????????????????????????? 1. ?? 2. ??? 3. ????

$ pangu-py -t "??????????Google?????Bing"
?????????? Google????? Bing

Why Use It

The primary benefit of pangu.py is the automatic improvement of text readability, especially for content mixing CJK and half-width characters. By consistently applying proper spacing, it eliminates common formatting inconsistencies and reduces visual clutter. This makes documents, articles, and user interfaces appear more professional and easier for readers to process, saving manual editing time.

Links

• GitHub Repository
• PyPI Project
• Other pangu implementations:
  • pangu.js
  • pangu.go
  • pangu.java
  • pangu.space