Sqidsとは何ですか?

Sqidsは、数値から短い一意の識別子を生成できるオープンソースのライブラリです。これらのIDはURLセーフであり、複数の数値をエンコードでき、一般的な卑語を含んでいません。 もっと読む .

こう見えます:

https://example.com/Lqj8a0

クイックエンコード&デコードの例:

sqids = Sqids.new
id = sqids.encode([1, 2, 3]) # "86Rf07"
numbers = sqids.decode(id) # [1, 2, 3]

IDが短すぎる場合は、特定の長さまでパディングすることができます:

sqids = Sqids.new(min_length: 10)
id = sqids.encode([1, 2, 3]) # "86Rf07xd4z"
numbers = sqids.decode(id) # [1, 2, 3]

アルファベットをシャッフルしてユニークなIDを作成する:

sqids = Sqids.new(alphabet: "k3G7QAe51FCsPW92uEOyq4Bg6Sp8YzVTmnU0liwDdHXLajZrfxNhobJIRcMvKt")
id = sqids.encode([1, 2, 3]) # "XRKUdQ"
numbers = sqids.decode(id) # [1, 2, 3]

完全なドキュメントはこちら https://github.com/sqids/sqids-crystal

元のHashids Crystalをお探しの場合は、こちらで見つけることができます: https://github.com/splattael/hashids.cr

使用例

Sqidsの主な用途は純粋に視覚的です。プロジェクトで数字の代わりにIDを使用したい場合、Sqidsは良い選択肢になるかもしれません。

適している

  • 主キーのエンコード リレーショナルデータベースを使用している場合
  • データベースの検索を節約 複数のオブジェクトをエンコードすることで
  • 一時的なログイントークン 卑語フリーでURLセーフ

適していない

  • 機密データ これは暗号化ライブラリではありません
  • ユーザーID 暗号化アルファベットが漏れた場合、ユーザー数を明らかにすることができます

機能

  • 🆔 非負の数値から短いIDを生成
  • 簡単なエンコード&デコード
  • 🫣 自動生成されたIDに一般的な卑語は含まれていません
  • 🎲 シャッフルされたアルファベットを介したカスタムIDのサポート
  • 🥳 44 インテグレーション (75% は新しいデザインを使用しています)
  • 📌 すべてのバージョンで同じIDが生成されます
  • 🍻 許容的なライセンスを持つ小さなライブラリ

例 / プレイグラウンド