Package: chikkarpy
chikkarpychikkarpyはchikkarのPython版です。
chikkarpy はSudachi 同義語辞書を利用し、SudachiPyの出力に同義語展開を追加するために開発されたライブラリです。
単体でも同義語辞書の検索ツールとして利用できます。chikkarpy is a Python version ofchikkar.
chikkarpy is developed to utilize theSudachi synonym dictionaryand add synonym expansion to the output ofSudachiPy.
This library alone can be used as a search tool for our synonym dictionaries.利用方法 UsageTL;DR$pipinstallchikkarpy

$echo"閉店"|chikkarpy
閉店クローズ,close,店仕舞いStep 1. chikkarpyのインストール Install chikkarpy$pipinstallchikkarpyStep 2. 使用方法 Usageコマンドライン Command Line$echo"閉店"|chikkarpy
閉店クローズ,close,店仕舞いchikkarpyは入力された単語を見て一致する同義語のリストを返します。
chikkarpy looks at a headword of synonym dictionary by the entered word and returns a list of matching synonyms.同義語辞書内の曖昧性フラグが1の見出し語をトリガーにすることはできません。
You cannot use a headword with an ambiguity flag of1in a synonym dictionary as a search trigger.出力はクエリ\t同義語リストの形式です。
The output is in the form of aquery \t synonym list.デフォルトのSudachi 同義語辞書の見出し語は、
SudachiPyの正規化形 (normalized_form()) で登録されています。The headwords in the Sudachi synonym dictionary are registered in SudachiPy's normalized form,normalized_form().$chikkarpysearch-h
usage:chikkarpysearch[-h][-d[file[file...]]][-ev][-ofile][-v][file[file...]]Searchsynonyms

positionalarguments:filetextwritteninutf-8

optionalarguments:-h,--helpshowthishelpmessageandexit-d[file[file...]]synonymdictionary(default:systemsynonymdictionary)-evEnableverbandadjectivesynonyms.-ofiletheoutputfile-v,--versionprintchikkarpyversion自分で用意したユーザー辞書を使いたい場合は-dで読み込むバイナリ辞書を指定できます。
（バイナリ辞書のビルドは辞書の作成を参照してください。）
When you use your user dictionary, you should specify the binary dictionary to read with-d.
(For building a binary dictionary, seeBuilding a Dictionary.)複数辞書を読み込む場合は順番に注意してください。
When reading multiple dictionaries, pay attention to the order.以下の場合，user2 > user > systemの順で同義語を検索して見つかった時点で検索結果を返します。
In the following cases, the synonyms are searched in the order ofuser2 > user > system, and the search results are returned which are first found.chikkarpy-dsystem.dicuser.dicuser2.dicまた、出力はデフォルトで体言のみです。
Also, the output isnounonly by default.用言も出力したい場合は-evを有効にしてください。
When you want to outputverbas well, please enable-ev.$echo"開放"|chikkarpy
開放オープン,open
$echo"開放"|chikkarpy-ev
開放開け放す,開く,オープン,openPython ライブラリ / Python library使用例 Example of usefromchikkarpyimportChikkarfromchikkarpy.dictionarylibimportDictionarychikkar=Chikkar()# デフォルトのシステム同義語辞書を使う場合，Dictionaryの引数は省略可能 You may omit the ``Dictionary`` arguments if you want to use the system synonym dictionarysystem_dic=Dictionary()chikkar.add_dictionary(system_dic)print(chikkar.find("閉店"))# => ['クローズ', 'close', '店仕舞い']print(chikkar.find("閉店",group_ids=[5]))# グループIDによる検索 Search by group ID# => ['クローズ', 'close', '店仕舞い']print(chikkar.find("開放"))# => ['オープン', 'open']chikkar.enable_verb()# 用言の出力制御（デフォルトは体言のみ出力） Output control of verbs (default is to output only nouns)print(chikkar.find("開放"))# => ['開け放す', '開く', 'オープン', 'open']chikkar.add_dictionary()で複数の辞書を読み込ませる場合は順番に注意してください。
最後に読み込んだ辞書を優先して検索します。
また、enable_trieをFalseに設定した辞書では、同義語を検索するときに見出し語よりもグループIDを優先して検索します。When you read multiple dictionaries withchikkar.add_dictionary(), pay attention to the order.
Priority is given to the last read dictionary.
Ifenable_trieisFalse, a search by synonym group IDs takes precedence over a search by the headword.chikkar=Chikkar()system_dic=Dictionary(enable_trie=False)user_dic=Dictionary(user_dict_path,enable_trie=True)user2_dic=Dictionary(user_dict_path,enable_trie=True)chikkar.add_dictionary(system_dic)chikkar.add_dictionary(user_dic)chikkar.add_dictionary(user2_dic)辞書の作成 Build a dictionary新しく辞書を追加する場合は、利用前にバイナリ形式辞書の作成が必要です。
Before using new dictionary, you need to create a binary format dictionary.同義語辞書のフォーマットはSudachi 同義語辞書に従ってください。
Follow theSudachi Synonym Dictionaryfor the format of the synonym dictionary.$chikkarpybuild-isynonym_dict.csv-osystem.dic$chikkarpybuild-h
usage:chikkarpybuild[-h]-ifile[-ofile][-dstring]BuildSynonymDictionary

optionalarguments:-h,--helpshowthishelpmessageandexit-ifiledictionaryfile(csv)-ofileoutputfile(default:synonym.dic)-dstringdescriptioncommenttobeembeddedondictionary開発者向けCode Formatscripts/lint.shを実行して、コードが正しいフォーマットかを確認してください。
Runscripts/lint.shto check if your code is formatted correctly.flake8flake8-import-orderflake8-builtinsが必要です。
You need packagesflake8flake8-import-orderflake8-builtins.Testscripts/test.shを実行してテストしてください。
Runscripts/test.shto run the tests.ContactchikkarpyはWAP Tokushima Laboratory of AI and NLPによって開発されています。
chikkarpy is developed by WAP Tokushima Laboratory of AI and NLP.開発者やユーザーの方々が質問したり議論するためのSlackワークスペースを用意しています。
Open an issue, or come to our Slack workspace for questions and discussion.https://sudachi-dev.slack.com/(招待を受ける/Get invitation)