HashPrint

これは何？

注：これは学生プロジェクトです

'b318c90ba09d05dfc9ff3991974eee68' のようなランダムな文字列は、確かに怖く見えるかもしれません。 もう怖がる必要はありません。HashPrint があなたをサポートします。

HashPrint について

HashPrint は、上記のような不気味に見える文字列（ハッシュと呼ばれます）を生成したアルゴリズム（MD5、bcrypt、SHA256 など）を特定できるフォレンジック CLI ツールです。

HashPrint の機能

1. ハッシュサポート： HashPrint は 90 種類以上のハッシュを識別できます。
2. エクスポートオプション： HashPrint では、JSON や YAML などさまざまな形式で結果をエクスポートできます。
3. 複数のハッシュ： HashPrint はテキストファイルから複数のハッシュを読み取ることができます。ディレクトリを再帰的にスキャンして、ハッシュを含むテキストファイルを特定することもできます。また、コマンドラインから複数のハッシュを受け取ることもできます。
4. カラー出力： HashPrint は色付きで結果を出力するため、読みやすくなっています。
5. 使いやすさ： 行き詰まったと感じたら、ヘルプはフラグ一つで表示できることを思い出してください。

インストール

Python 3.14 以上が必要です

pip でインストールする場合、システムに Python 3.14 以上がインストールされている必要があります

$ pip install pyhashprint

または uv を使用する場合

uv は必要に応じて正しい Python バージョンをインストールします

まず仮想環境をセットアップします：

$ uv venv

次にインストールします：

$ uv pip install pyhashprint

インストールせずに使用する

uv が必要です

$ uv tool run pyhashprint

または

$ uvx pyhashprint

HashPrint の使い方

オプション	目的
-h, --help	ヘルプメッセージを表示して終了します。
-f, --hash-file	このオプションは引数としてテキストファイルへのパスを受け取ります。このオプションを指定すると、HashPrint は指定されたパスのファイルからハッシュを読み取ります。ファイルには 1 行につき 1 つのハッシュが含まれている必要があります。
-c, --hash	このオプションは引数としてハッシュを受け取り、それを識別します。ハッシュはシングルクォートで囲み、0x プレフィックスを付けないでください。
-x, --format	このオプションでは、エクスポート形式を選択できます。結果を JSON、YAML、テキスト形式でエクスポートできます。このオプションは -p、--path オプションなしでは機能しません。
-p, --path	このオプションはエクスポートファイルのパスを指定します。既存のファイルへのパスを指定した場合、すでに内容が含まれていれば上書きされます。指定されたパスにファイルが存在しない場合、HashPrint が作成します。
-w, --walk	このオプションは、指定されたパスのディレクトリを再帰的にスキャンして、1 行につき 1 つのハッシュを含むテキストファイルを探します。
-v, --version	このオプションは HashPrint のバージョン番号を表示します。

使用例

ヘルプを表示する

$ hashprint --help

バージョン番号を表示する

$ hashprint --version

単一のハッシュを識別する

$ hashprint -c 'a9993e364706816aba3e25717850c26c9cd0d89d'

または

$ hashprint --hash 'a9993e364706816aba3e25717850c26c9cd0d89d'

複数のハッシュを識別する

$ hashprint -c '0cc175b9c0f1b6a831c399e269772661' -c 'e8b7be43'

ファイルからハッシュを識別する + 結果をファイルにエクスポートする

$ hashprint -f path/to/txt/file/containing/hashes -x text -p path/of/export/file

上記のコマンドは、結果を人間が読めるテキスト形式で任意のファイルにエクスポートします。ファイルが存在しない場合、HashPrint が作成します。

再帰的ディレクトリスキャナー + 結果をファイルにエクスポートする

$ hashprint -w path/to/directory -x format -p path/of/export/file

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。

バグ報告と機能リクエスト

バグを見つけたり、新機能のアイデアがありますか？

-バグの場合： Issue を作成する。

-機能や改善を提案する場合： Issue を作成する。

-新しいアイデアや質問の場合： Discussions でスレッドを自由に開始してください！