Chepy

Chepyは、CyberChefの機能の一部をミラーリングすることを目的としたPythonライブラリで、便利なCLIを備えています。Chepyは、CyberChefが提供する様々な機能との互換性を持たせるために、かなりの労力が費やされました。すべて純粋なPythonの方法で実現しています。ChepyにはCyberchefに比べていくつかの重要な利点と欠点があります。Cyberchefの異なるモジュールを_積み重ねる_という概念は、Chepyでも活かされています。

ChepyはまだCyberchefの全機能を提供しているわけではないため、まだ長い道のりがあります。

プロジェクトに⭐️を付けていただけると嬉しいです!

ドキュメント

完全な使用方法についてはドキュメントを参照してください

例

すべての使用法と例については、ドキュメントを参照してください。

ChepyはCyberchefと同様のスタッキングメカニズムを備えています。例えば、Cyberchefで次のような処理があります：

これは以下のコードと同等です。

from chepy import Chepy

file_path = "/tmp/demo/encoding"

print(
    Chepy(file_path)
    .load_file()
    .reverse()
    .rot_13()
    .from_base64()
    .from_base32()
    .hexdump_to_str()
    .o
)

Chepy vs Cyberchef

利点

• Chepyは純粋なPythonであり、アクセスしやすいPython APIを備えています。
• ChepyにはCLIがあります。
• Chepy CLIは完全なオートコンプリート機能を備えています。
• PE、ELF、その他の様々なファイル形式固有のパースをサポートしています。
• プラグインを介して拡張可能です。
• Pythonライブラリ全体を活用できるため、無限にスケーラブルです。
• Chepyは、ある程度CyberchefのWebアプリ全体と連携できます。必要に応じてChepyからCyberchefに移行することも容易です。
• Chepy PythonライブラリはCyberchef Nodeライブラリよりも大幅に高速です。
• CORSの問題なしにHTTP/Sリクエストで動作します。
• Chepy MLプラグインを介したmagicサポートがあります。

欠点

• ChepyはCyberchefが提供するすべての機能を提供しているわけではありません。

インストール

Chepyはいくつかの方法でインストールできます。

Pypi

pip3 install chepy
# オプションで追加要件もインストール
pip3 install chepy[extras]

Git

git clone --recursive https://github.com/securisec/chepy.git
cd chepy
pip3 install -e .
# ここでは -e を使用しています。これにより、後で git pull で更新した場合でも（依存関係が変更されていない限り）再インストールする必要がありません。

スタンドアロンバイナリ

Chepyをスタンドアロンバイナリにビルドすることもできます。これにはすべての依存関係をまとめてパッケージ化します。

git clone https://github.com/securisec/chepy.git
cd chepy
pip install .
pip install pyinstaller
pyinstaller cli.py --name chepy --onefile

バイナリは dist/ フォルダに生成されます。

プラグイン

プラグインドキュメントはこちら

使用実績

Remnux linux

.. toctree::
   :maxdepth: 3
   :caption: 目次:

   usage.md
   examples.md
   cli.rst
   chepy.md
   core.md
   modules.rst
   extras.rst
   plugins.md
   pullrequest.md
   config.md
   faq.md


索引と表
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`