Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/saitoha/jacot
jacot - Japanese Auto character encoding COnversion on Tty
https://github.com/saitoha/jacot
Last synced: about 1 month ago
JSON representation
jacot - Japanese Auto character encoding COnversion on Tty
- Host: GitHub
- URL: https://github.com/saitoha/jacot
- Owner: saitoha
- License: gpl-3.0
- Created: 2012-10-25T10:36:07.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2012-11-05T11:51:35.000Z (about 12 years ago)
- Last Synced: 2024-10-15T07:51:04.353Z (3 months ago)
- Language: Python
- Homepage:
- Size: 1.93 MB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README-ja.md
- License: COPYING
Awesome Lists containing this project
README
jacot
=====
概要
--------
ターミナルとアプリケーションの間の入出力に介入し、CP932/EUC-JP/UTF-8が混在したエンコーディングを解釈します。
また、入力の円サインをバックスラッシュに変換したり、日本語入力メソッドSKKを独自に提供するなど、
ターミナルで日本語を扱う際に発生しがちな諸問題の解決を目指すサバイバルツールとしての側面を持ちます。
インストール
------------
```
$ git clone https://github.com/saitoha/jacot.git
$ cd jacot
$ python setup.py install
```
またはpip経由で、
```
$ pip install jacot
```
とします。
使い方
------
```
$ jacot [options] [command | -]
```
### Options:
-h, --help ヘルプメッセージを出力します。
--version バージョンを表示します。
-t TERM, --term=TERM 環境変数TERMを上書きします。
-l LANG, --lang=LANG 環境変数LANGを上書きします。
-o ENC, --outenc=ENC 出力エンコーディングを設定します。
--disable-input-conversion
入力方向の自動変換を抑制します。
--disable-output-conversion
出力方向の自動変換を抑制します。
-s, --enable-skk SKK日本語入力メソッド、円サイン->バックスラッシュ変換を有効にします。
### Example:
#### 1. Create auto-conversion TTY session, like cocot.
```
$ LANG=ja_JP.UTF-8 $SHELL
$ echo 'あいうえお今日は≠〆＞' | iconv -t cp932
???????????????́??Y??
$ jacot
$ echo 'あいうえお今日は≠〆＞' | iconv -t cp932
あいうえお今日は≠〆＞
```
#### 2. Read from stdin, without TTY session, just like nkf.
```
$ LANG=ja_JP.UTF-8 $SHELL
$ '三 ┏( ^o^)┛' | iconv -t eucjp | jacot
三 ┏( ^o^)┛
```
#### 3. Set terminal encoding
```
$ LANG=ja_JP.EUC-JP $SHELL
$ jacot -o eucjp
$ '三 ┏( ^o^)┛' | iconv -t sjis
三 ┏( ^o^)┛
```
#### 4. Use SKK input method
```
$ jacot --enable-skk
```
How It Works
------------
Comming soon...
Dependence
----------
- Hayaki Saito's TFF, Terminal Filter Framework
https://github.com/saitoha/tff
- Hayaki Saito's Sentimental-SKK
https://github.com/saitoha/sentimental-skk
Sentimental-SKK package includes the large SKK dictionary,
SKK-JISYO.L (Masahiko Sato et al./SKK Development Team).
http://openlab.jp/skk/skk/dic/SKK-JISYO.L
References
----------
- Luit - locale and ISO 2022 support for Unicode terminals http://www.pps.univ-paris-diderot.fr/~jch/software/luit/
- cocot - COde COnverter on Tty http://vmi.jp/software/cygwin/cocot.html
- cygwin ck terminal emulator http://www.geocities.jp/meir000/ck/
- Unicode Text Editor MinEd http://towo.net/mined/
- libfep https://github.com/ueno/libfep
- Daredevil SKK (DDSKK) http://openlab.ring.gr.jp/skk/ddskk-ja.html
TODO
-----
- Improve conversion algorithm (ck)
- Implement glyph substitution or replacement mechanism with considering East Asian Width. (cocot)
- Auto terminal encodings detection. (MinEd)
- Switch auto detection on/off setting with private sequence "DECSET/DECRST 8850".
- Improve Terminal Filter Framework(TFF), support plugin architecture.
- libfep like API/language binding, socket connection support
- Support Python 3.x