Uniqueness

Code Climate Build Status Coverage Status

Rails recently introduced has_secure_token but it's very primitive. Meet the competition.

Code Documentation

Requirements

Minimum requirements are:

  1. Rails 4.0.0+
  2. Ruby 2.0.0+

Installation

Add this line to your application's Gemfile:

gem 'uniqueness'

And then execute:

$ bundle

Or install it yourself as:

$ gem install uniqueness

Usage

Adds random field support to Rails models.

To auto-generate a new random string for field foo:

class Example < ActiveRecord::Base
  has_unique_field :foo
end

You can customize the generated string by passing an options hash. The following keys are supported:

:length number of characters, defaults to 32

:type type of string, defaults to :hash and can be one of: :human, :hash

:blacklist characters to exclude when generating the random string, defaults to []

Development

After checking out the repo, run bin/setup to install dependencies. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Please see CONTRIBUTING.md for details.

Credits

recognition was originally written by Omar Abdel-Wahab.