# pinchar

[![GitHub License](https://img.shields.io/github/license/PRO-2684/pinchar?logo=opensourceinitiative)](https://github.com/PRO-2684/pinchar/blob/main/LICENSE)
[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/PRO-2684/pinchar/release.yml?logo=githubactions)](https://github.com/PRO-2684/pinchar/blob/main/.github/workflows/release.yml)
[![GitHub Release](https://img.shields.io/github/v/release/PRO-2684/pinchar?logo=githubactions)](https://github.com/PRO-2684/pinchar/releases)
[![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/PRO-2684/pinchar/total?logo=github)](https://github.com/PRO-2684/pinchar/releases)
[![Crates.io Version](https://img.shields.io/crates/v/pinchar?logo=rust)](https://crates.io/crates/pinchar)
[![Crates.io Total Downloads](https://img.shields.io/crates/d/pinchar?logo=rust)](https://crates.io/crates/pinchar)
[![docs.rs](https://img.shields.io/docsrs/pinchar?logo=rust)](https://docs.rs/pinchar)

**Pin**yin to Chinese **char**acters.

## 📥 Installation

### Using [`binstall`](https://github.com/cargo-bins/cargo-binstall)

```shell
cargo binstall pinchar
```

### Downloading from Releases

Navigate to the [Releases page](https://github.com/PRO-2684/pinchar/releases) and download respective binary for your platform. Make sure to give it execute permissions.

### Compiling from Source

```shell
cargo install pinchar
```

## 📖 Usage

This tool allows you to query Chinese characters with given pinyin. To use the CLI, simply pass a list of pinyin separated by space:

```shell
$ pinchar he yi wei
he: 98 character(s) found:
何 佫 劾 合 呵 咊 和 哬 啝 喝 嗃 嗬 垎 壑 姀 寉 峆 惒 抲 敆 曷 柇 核 楁 欱 毼 河 涸 渮 澕 焃 煂 熆 熇 燺 爀 狢 癋 皬 盇 盉 盍 盒 碋 礉 禾 秴 穒 篕 籺 粭 紇 翮 翯 荷 菏 萂 蚵 螛 蠚 袔 褐 覈 訶 訸 詥 謞 诃 貈 賀 贺 赫 輅 郃 鉌 鑉 闔 阂 阖 靍 靎 靏 鞨 頜 颌 饸 魺 鲄 鶡 鶮 鶴 鸖 鹖 鹤 麧 齕 龁 龢
---
yi: 364 character(s) found:
一 乁 乂 义 乊 乙 亄 亦 亿 以 仪 伇 伊 伿 佁 佚 佾 侇 依 俋 倚 偯 儀 億 兿 冝 刈 劓 劮 勚 勩 匇 匜 医 吚 呓 呭 呹 咦 咿 唈 噫 囈 圛 圯 坄 垼 埶 埸 墿 壱 壹 夁 夷 奕 姨 媐 嫕 嫛 嬄 嬑 嬟 宐 宜 宧 寱 寲 屹 峄 峓 崺 嶧 嶬 嶷 已 巸 帟 帠 幆 庡 廙 异 弈 弋 弌 弬 彛 彜 彝 彞 役 忆 怈 怡 怿 恞 悒 悘 悥 意 憶 懌 懿 扅 扆 抑 拸 挹 掜 揖 撎 攺 敡 敼 斁 旑 旖 易 晹 暆 曀 曎 杙 枍 枻 柂 栘 栧 栺 桋 棭 椅 椬 椸 榏 槸 檍 檥 檹 欥 欭 欹 歝 殔 殪 殹 毅 毉 沂 沶 泆 洢 浂 浥 浳 渏 湙 溢 漪 潩 澺 瀷 炈 焲 熠 熤 熪 熼 燚 燡 燱 狋 猗 獈 玴 珆 瑿 瓵 畩 異 疑 疫 痍 痬 瘗 瘞 瘱 癔 益 眙 睪 瞖 矣 硛 礒 祎 禕 秇 移 稦 穓 竩 笖 箷 簃 籎 縊 繄 繶 繹 绎 缢 羛 羠 義 羿 翊 翌 翳 翼 耛 耴 肄 肊 胰 膉 臆 舣 艗 艤 艺 芅 苅 苡 苢 萓 萟 蓺 薏 藙 藝 蘙 虉 蚁 蛜 蛡 蛦 蜴 螔 螘 螠 蟻 衣 衤 衪 衵 袘 袣 裔 裛 裿 褹 襼 觺 訑 訲 訳 詍 詑 詒 詣 誃 誼 謻 譩 譯 議 讉 讛 议 译 诒 诣 谊 豙 豛 豷 貖 貤 貽 賹 贀 贻 跇 跠 踦 軼 輢 轙 轶 辷 迆 迤 迻 逘 逸 遗 遺 邑 郼 酏 醫 醳 醷 釔 釴 鈘 鈠 鉯 銥 鎰 鏔 鐿 钇 铱 镒 镱 陭 隿 霬 靾 頉 頤 頥 顊 顗 颐 飴 饐 饴 駅 驛 驿 骮 鮨 鯣 鳦 鶂 鶃 鶍 鷁 鷊 鷖 鷧 鷾 鸃 鹝 鹢 鹥 黓 黟 黳 齮 齸
---
wei: 194 character(s) found:
为 亹 伟 伪 位 偉 偎 偽 僞 儰 卫 危 厃 叞 味 唯 喂 喡 喴 囗 围 圍 圩 墛 壝 委 威 娓 媁 媙 媦 寪 尉 尾 屗 峗 峞 崣 嵔 嵬 嶶 巍 帏 帷 幃 徫 微 惟 愄 愇 慰 懀 捤 揋 揻 撱 斖 暐 未 桅 梶 椲 椳 楲 欈 沩 洈 洧 浘 涠 渨 渭 湋 溈 溦 潍 潙 潿 濰 濻 瀢 炜 為 烓 煀 煒 煟 煨 熭 燰 爲 犚 犩 猥 猬 玮 琟 瑋 璏 畏 痏 痿 癓 硊 硙 碨 磈 磑 維 緭 緯 縅 纬 维 罻 胃 腲 艉 芛 苇 苿 荱 菋 萎 葦 葨 葳 蒍 蓶 蔚 蔿 薇 薳 藯 蘶 蜲 蜼 蝛 蝟 螱 衛 衞 褽 覣 覹 詴 諉 謂 讆 讏 诿 谓 踓 躗 躛 軎 轊 违 逶 違 鄬 醀 鍏 鍡 鏏 闈 闱 隇 隈 霨 霺 韋 韑 韙 韡 韦 韪 頠 颹 餧 餵 饖 骩 骪 骫 魏 鮇 鮠 鮪 鰃 鰄 鲔 鳂 鳚
---
```

## 🎉 Credits

- [rust-pinyin](https://github.com/mozillazg/rust-pinyin)
