Skip to main content

Command line frontend for the cihai CJK language library

Project description

cihai-cli - Command line interface to the cihai CJK-language library

Python Package Docs Build Status Code Coverage License

This project is under active development. Follow our progress and check back for updates!

Installation

$ pip install --user cihai[cli]

Character lookup

See CLI in the documentation for full usage information.

$ cihai info 
char: 
kCantonese: hou2 hou3
kDefinition: good, excellent, fine; well
kHangul: 
kJapaneseOn: KOU
kKorean: HO
kMandarin: hǎo
kTang: '*xɑ̀u *xɑ̌u'
kTotalStrokes: '6'
ucn: U+597D

# retrieve all character information (including book indices)
$ cihai info  -a
char: 
kCangjie: VND
kCantonese: hou2 hou3
kCihaiT: '378.103'
kDefinition: good, excellent, fine; well
kFenn: 552A
kFourCornerCode: '4744.7'
kFrequency: '1'
kGradeLevel: '1'
kHKGlyph: 0871
kHangul: 
kHanyuPinlu: hǎo(6060) hāo(142) hào(115)
kHanyuPinyin: 21028.010:hǎo,hào
kJapaneseKun: KONOMU SUKU YOI
kJapaneseOn: KOU
kKorean: HO
kMandarin: hǎo
kPhonetic: '481'
kRSAdobe_Japan1_6: C+1975+38.3.3 C+1975+39.3.3
kRSKangXi: '38.3'
kTang: '*xɑ̀u *xɑ̌u'
kTotalStrokes: '6'
kVietnamese: háo
kXHC1983: 0445.030:hǎo 0448.030:hào
ucn: U+597D

Reverse lookup

$ cihai reverse library
char: 
kCantonese: syu1
kDefinition: library
kJapaneseOn: TOSHOKAN SHO
kMandarin: 
kTotalStrokes: '13'
ucn: U+5715
--------
char: 
kCantonese: long4
kDefinition: the place where the supreme stores his books; library
kJapaneseOn: ROU
kMandarin: láng
kTotalStrokes: '11'
ucn: U+5ACF
--------

Developing

poetry is a required package to develop.

git clone https://github.com/cihai/cihai-cli.git

cd cihai-cli

poetry install -E "docs test coverage lint format"

Makefile commands prefixed with watch_ will watch files and rerun.

Tests

poetry run py.test

Helpers: make test Rerun tests on file change: make watch_test (requires entr(1))

Documentation

Default preview server: http://localhost:8037

cd docs/ and make html to build. make serve to start http server.

Helpers: make build_docs, make serve_docs

Rebuild docs on file change: make watch_docs (requires entr(1))

Rebuild docs and run server via one terminal: make dev_docs (requires above, and a make(1) with -J support, e.g. GNU Make)

Formatting / Linting

The project uses black and isort (one after the other) and runs flake8 via CI. See the configuration in pyproject.toml and setup.cfg:

make black isort: Run black first, then isort to handle import nuances make flake8, to watch (requires entr(1)): make watch_flake8

Releasing

As of 0.6, poetry handles virtualenv creation, package requirements, versioning, building, and publishing. Therefore there is no setup.py or requirements files.

Update __version__ in __about__.py and pyproject.toml:

git commit -m 'build(cihai-cli): Tag v0.1.1'
git tag v0.1.1
git push
git push --tags
poetry build
poetry deploy

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cihai-cli-0.7.1.tar.gz (6.8 kB view details)

Uploaded Source

Built Distribution

cihai_cli-0.7.1-py3-none-any.whl (6.6 kB view details)

Uploaded Python 3

File details

Details for the file cihai-cli-0.7.1.tar.gz.

File metadata

  • Download URL: cihai-cli-0.7.1.tar.gz
  • Upload date:
  • Size: 6.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.0.10 CPython/3.7.9 Linux/4.19.128-microsoft-standard

File hashes

Hashes for cihai-cli-0.7.1.tar.gz
Algorithm Hash digest
SHA256 10c7de480722094f7fa1b261ee809f2b10e03cd58b09c480e35e4682bc35f576
MD5 bcaa9d9f5788666d46c704c4d3df54cb
BLAKE2b-256 02c3e55fb6cbd8f6fdcb0978a695d03c9fd17607ba1217a0cbfb752839566bde

See more details on using hashes here.

File details

Details for the file cihai_cli-0.7.1-py3-none-any.whl.

File metadata

  • Download URL: cihai_cli-0.7.1-py3-none-any.whl
  • Upload date:
  • Size: 6.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.0.10 CPython/3.7.9 Linux/4.19.128-microsoft-standard

File hashes

Hashes for cihai_cli-0.7.1-py3-none-any.whl
Algorithm Hash digest
SHA256 586546ccf7ccc0a79d43c5ffb199f80d4c4c4cdeaff5e124ae0080e722d74adb
MD5 1139f0eb1705d8f70ba5fad6ca068bd9
BLAKE2b-256 26e5abb4b89088b4c5718f4781f22b73e7e0b3bc99d17794ce4754d667712bdd

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page