Metadata-Version: 2.4
Name: zhongwen
Version: 5.35.14
Summary: 以中文命名之文、數、時、表及檔等處理工具集。
Project-URL: Homepage, https://github.com/fhopecc/zhongwen
Project-URL: Bug Tracker, https://github.com/fhopecc/zhongwen/issues
Author-email: fhopecc <fhopecc@gmail.com>
License: GPL-3.0-only
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.7
Requires-Dist: clipboard
Requires-Dist: comtypes
Requires-Dist: diskcache
Requires-Dist: lark
Requires-Dist: marisa-trie
Requires-Dist: pandas
Requires-Dist: pdf2image
Requires-Dist: pygtrans
Requires-Dist: pymupdf
Requires-Dist: pypdf2
Requires-Dist: pytesseract
Requires-Dist: python-docx
Requires-Dist: pywin32
Requires-Dist: requests
Requires-Dist: selenium
Requires-Dist: winshell
Description-Content-Type: text/markdown

# 給懂中文的程式設計師

## 命名原則及數字處理

本程式庫設計哲學就是函數以中文命名且能簡明表達功能，
函數命名係以「動詞」加「受詞」為原則，受詞表達傳入參數，動詞表達函數功能。
另以簡體名稱表示處理簡體中文情形，
繁體名稱表示處理繁體中文情形。
舉如中文數字處理模組(zhongwen.數)用法示例： 

    from zhongwen.數 import 取中文數字, 取中文数字, 取大寫中文數字
    取中文數字(10600)
    >>> '一萬零六百'
    取中文数字(10600)
    >>> '一万零六百'
    取大寫中文數字(23232.00518)
    >>> '貳萬參仟貳佰參拾貳點零零伍壹捌'

## 民國日期處理

臺灣地區使用民國紀年，
【取日期】函數可將民國日期字串轉成時間資料(pd.Timestamp)，
而【取民國日期】可將時間資料轉成表達民國紀年日期之字串，示例如次：

    from zhongwen.時 import 取日期
    from pandas import Timestamp
    取日期('111.9.23')
    >>> Timestamp(2022,9,23,0,0)
    取日期('110/12/27')
    >>> Timestamp(2021,12,27,0,0)

    from zhongwen.時 import 取民國日期
    取民國日期(datetime(2021,12,27,0,0), '%Y年%M月%d日')
    >>> '110年12月27日'

## 中文字元判斷

中文字元判斷功能示例如次：

    from zhongwen.文 import 是否為中文字元

    是否為中文字元('繁')
    >>> True
    是否為中文字元('简')
    >>> True
    是否為中文字元('a')
    >>> False

## 校正重碼字

字型相似編碼相異之中文字元稱【重碼字】，
如【車】編碼為\u8eca(正式字集)，
而【車】編碼為\uf902(中日韓相容表意文字區)，
其細明體字形幾無差異。
而中日韓相容表意文字區[\uF900-\uFAFF]字元依字源分離原則未與正式字集（包括擴展 A、B、C、D 區）中的字形統一的字，因為許多「第三方字型」都沒有實作這個區域的文字，
【校正中文字】可將重碼字均轉為正體字，即輸入法優先輸出的編碼，以因使用字型未包含中日韓相容表意文字編碼，而以細明體字型表示造成同字卻字型不一問題。

校正中文字示例：

    校正中文字('汽車')
    >>> '汽車'

## 查中文字典

示例：

    查萌典('查')
    >>> ['ㄔㄚˊ：考察、檢查。翻閱、檢尋。大筏，水中的浮木。', 
         'ㄓㄚ：姓。如五代時南唐有查文徽。我。同「咱」(一)。']

## 翻譯

【翻譯】可將外國文字譯為中文，示例如次：

    from zhongwen.文 import 翻譯
    翻譯('test')
    >>> '測試'
    翻譯('取り')
    >>> '拿'

## 安裝

安裝步驟如次：
    
    py -m pip install zhongwen
    py -m zhongwen.pdf --setup
