crates.io

開発とデータ · crates.io の結果 · 公開ソース

公式ドキュメント

現在の公開データ

crates.io から新しい結果を読み込みます。検索語の入力は不要です。

レスポンスに含まれる項目

確認したい項目

開発とデータ
crates.io の結果
公開ソース

検索結果には crates とページ送りの情報が含まれます

/api/v1/crates は q、page、per_page を受け取ります。応答には crates の一覧と meta オブジェクトがあり、serde の検索では meta に total と next_page がありました。リクエストの間に変わり得る件数から URL を計算するのではなく、この次のパスで続きを取得してください。

共有できるフィルターでは q、page、per_page を見える形で保持します。
meta.next_page は存在するときだけ使います。
検索文脈を残さず total を固定結果として示さないでください。

version、downloads、description には文脈が必要です

項目には name、description、downloads、recent_downloads、max_version、updated_at、repository、documentation、homepage が含まれることがあります。downloads と recent_downloads はレジストリの利用回数であり、安全性、互換性、品質の評価ではありません。max_version はその時点で報告された最大の version です。依存関係を評価するには、crate 自身が示す documentation と repository を開いてください。

新しさが重要なら updated_at と日付を併記します。
downloads だけで crates を比較しません。
パッケージのページと repository、documentation のような任意の外部リンクを分けます。

選択を深く調べるには crate のルートを使います

/api/v1/crates/{crate} はパッケージの詳細と versions、keywords、categories などのブロックを返します。一覧のルートは発見向きで、crate のルートは依存関係を提案する前に versions と分類を確認する場所です。URL には正確な crate 名を残し、200 以外の応答は識別子または利用可能性を見直す合図として扱ってください。

近い名前を避けるため、詳細 URL を作る前に検索します。
max_version がプロジェクトと互換であると決めつけず versions を読みます。
短い description を統合ドキュメントとして扱わないでください。