0.0
No release in over 3 years
Low commit activity in last 3 years
Easily obscure the primary key of your Sequel models
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 5.0
~> 10.0
~> 1.3.13

Runtime

~> 1.0
< 6.0, >= 4.0
 Project Readme

Sequel Hash ID

Easily obfuscate your Integer-based primary keys in Sequel models. The anonymity of a UUID without any overhead.

These are commonly used for URL shorteners, but they have other use cases as well. Specifically, they are very handy to prevent nieve crawling / scraping, where your records are known to be incremental.

Installation

Add this line to your application's Gemfile:

gem "sequel-hash_id"

And then execute:

$ bundle

Or install it yourself as:

$ gem install sequel-hash_id

Usage

This plugin likely only makes sense at the Model level, so configure it for each model you want to have a hashid for. The only required option is the salt you wish to use.

plugin :hash_id, salt: "your-salt".freeze

Once you've done that, you can now access the following methods:

# Get the instance's hashid
instance = YourModel.create
instance.hashid

# Lookup using a hashid
YourModel.with_hashid("the-hashid")

# Dataset lookup method
YourModel.where { ... }.with_hashid("the-hashid")

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/adam12/sequel-hash_id.

I love pull requests! If you fork this project and modify it, please ping me to see if your changes can be incorporated back into this project.

That said, if your feature idea is nontrivial, you should probably open an issue to discuss it before attempting a pull request.

License

The gem is available as open source under the terms of the MIT License.