Tokens

class User < ActiveRecord::Base
  tokenizable
end

# create a new user; remember that the token requires an existing record
# because it depends on its id
user = User.create(username: "fnando")

# create token that never expires
user.add_token(:activate)

# uses custom expires_at
user.add_token(:activate, expires_at: 10.days.from_now)

# uses the default size (12 characters)
user.add_token(:activate)

# uses custom size (up to 122)
user.add_token(:activate, size: 20)

# uses custom token value
user.add_token(:activate, token: 'abc123')

# create token with arbitrary data.
user.add_token(:activate, data: {action: "do something"})

# find token by name
user.find_token_by_name(:reset_account)

# find valid token per user context.
user.find_valid_token(:reset_account, "ea2f14aeac40")

# find token by hash
user.find_token("ea2f14aeac40")

# check if a token has expired
user.tokens.first.expired?

# find user by token
User.find_by_token(:activate, "ea2f14aeac40")

# remove all expired tokens except those with NULL values
Token.clean

# generate a token as string, without saving it
User.generate_token

# remove a token by its name
user.remove_token(:activate)

# find user by valid token (same name, same hash, not expired)
User.find_by_valid_token(:activate, "ea2f14aeac40")

# find a token using class scope
User.find_token(:activate, "ea2f14aeac40")

# Token hash
token.to_s #=> ea2f14aeac40