Metadata-Version: 2.0
Name: pangu
Version: 3.3.0.1
Summary: Paranoid text spacing for good readability, to automatically insert whitespace between CJK (Chinese, Japanese, Korean) and half-width characters (alphabetical letters, numerical digits and symbols).
Home-page: https://github.com/vinta/pangu.py
Author: Vinta Chen
Author-email: vinta.chen@gmail.com
License: MIT
Keywords: pangu space white text spacing readability
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Natural Language :: Chinese (Traditional)
Classifier: Natural Language :: Chinese (Simplified)
Classifier: Natural Language :: Japanese
Classifier: Natural Language :: Korean
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Education
Classifier: Topic :: Software Development :: Internationalization
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Text Processing
Classifier: Topic :: Text Processing :: General
Classifier: Topic :: Text Processing :: Linguistic
Classifier: Topic :: Utilities

pangu.py
========

.. image:: https://img.shields.io/travis/vinta/pangu.py/master.svg?style=flat-square
    :target: https://travis-ci.org/vinta/pangu.py

.. image:: https://img.shields.io/codecov/c/github/vinta/pangu.py/master.svg?style=flat-square
    :target: https://codecov.io/github/vinta/pangu.py

.. image:: https://img.shields.io/pypi/v/pangu.svg?style=flat-square
    :target: https://pypi.python.org/pypi/pangu

.. image:: https://img.shields.io/pypi/pyversions/pangu.svg?style=flat-square
    :target: https://pypi.python.org/pypi/pangu

.. image:: https://img.shields.io/badge/made%20with-%e2%9d%a4-ff69b4.svg?style=flat-square
    :target: https://vinta.ws

Paranoid text spacing for good readability, to automatically insert whitespace between CJK (Chinese, Japanese, Korean) and half-width characters (alphabetical letters, numerical digits and symbols).

- `pangu.go <https://github.com/vinta/pangu>`_ (Go)
- `pangu.java <https://github.com/vinta/pangu.java>`_ (Java)
- `pangu.js <https://github.com/vinta/pangu.js>`_ (JavaScript)
- `pangu.py <https://github.com/vinta/pangu.py>`_ (Python)

Installation
============

.. code-block:: bash

    $ pip install -U pangu

Usage
=====

In Python code
--------------

.. code-block:: py

    import pangu

    pangu.spacing_text('當你凝視著bug，bug也凝視著你')
    # output: '當你凝視著 bug，bug 也凝視著你'

    pangu.spacing_file('path/to/file.txt')
    # output: '與 PM 戰鬥的人，應當小心自己不要成為 PM'

In Terminal
-----------

.. code-block:: bash

    $ pangu "請使用uname -m指令來檢查你的Linux作業系統是32位元或是[敏感词已被屏蔽]位元"
    # output: "請使用 uname -m 指令來檢查你的 Linux 作業系統是 32 位元或是 [敏感词已被屏蔽] 位元"

    $ python -m pangu "為什麼小明有問題都不Google？因為他有Bing"
    # output: 為什麼小明有問題都不 Google？因為他有 Bing

    $ echo "未來的某一天，Gmail配備的AI可能會得出一個結論：想要消滅垃圾郵件最好的辦法就是消滅人類" >> path/to/file.txt
    $ pangu -f path/to/file.txt
    # output: "未來的某一天，Gmail 配備的 AI 可能會得出一個結論：想要消滅垃圾郵件最好的辦法就是消滅人類"

    $ echo "心裡想的是Microservice，手裡做的是Distributed Monolith" | pangu
    # output: "心裡想的是 Microservice，手裡做的是 Distributed Monolith"

    $ echo "你從什麼時候開始產生了我沒使用Monkey Patch的錯覺？" | python -m pangu
    # output: "你從什麼時候開始產生了我沒使用 Monkey Patch 的錯覺？"

History
=======

3.3.0.1 (2018-01-20)
--------------------

- Support Python 3.6
- Add a method: ``pangu.spacing_file()``
- Add a command-line tool: ``pangu``

3.0.0 (2016-01-24)
------------------

- Support Python 3.5
- Refactoring
- Rename ``text_spacing()`` to ``spacing_text()``

2.5.6.3 (2015-05-18)
--------------------

- Add an alias to ``spacing()``: ``text_spacing()``
- Fix unicode issue in Python 2.x

2.5.6.2 (2015-05-17)
--------------------

- Fix setup.py

2.5.6 (2015-05-17)
------------------

- Synchronize version number with `pangu.js <https://github.com/vinta/pangu.js>`_
- Improve Paranoid Text Spacing algorithm

1.0.0 (2014-02-12)
------------------

- Hello World


