Contents

require 'uuidtools'

module Vault
  module User
    ID_CAPTURE = /^user(\d+)\@[\w\.]+com$/
    # Convert a user ID into a Heroku user ID.
    #
    # @param user_id [Fixnum] A user ID.
    # @return [String] A Heroku ID that uniquely represents the user.
    def self.id_to_hid(user_id)
      "user#{user_id}@heroku.com"
    end

    # Convert a user ID into a v5 UUID.
    #
    # @param user_id [Fixnum] A user ID.
    # @return [String] A v5 UUID that uniquely represents the user.
    def self.id_to_uuid(user_id)
      url = "https://vault.heroku.com/users/#{user_id}"
      UUIDTools::UUID.sha1_create(UUIDTools::UUID_URL_NAMESPACE, url).to_s
    end

    # Convert a Heroku user ID into a core user ID.
    #
    # @param heroku_id [String] A Heroku user ID, such as
    #   `[e-mail]`.
    # @raise [ArgumentError] Raised if a malformed Heroku ID is provided.
    # @return [Fixnum] The core user ID that uniquely represents the user.
    def self.hid_to_id(heroku_id)
      if user_id = heroku_id.slice(ID_CAPTURE, 1)
        user_id.to_i
      else
        raise ArgumentError,"#{heroku_id} is not a valid Heroku user ID."
      end
    end

    # Convert a Heroku user ID into a v5 UUID.
    #
    # @param heroku_id [String] A Heroku user ID, such as
    #   `[e-mail]`.
    # @raise [ArgumentError] Raised if a malformed Heroku ID is provided.
    # @return [String] A v5 UUID that uniquely represents the user.
    def self.hid_to_uuid(heroku_id)
      if user_id = heroku_id.slice(ID_CAPTURE, 1)
        id_to_uuid(user_id)
      else
        raise ArgumentError,"#{heroku_id} is not a valid Heroku user ID."
      end
    end
  end
end

Version data entries

41 entries across 41 versions & 1 rubygems

Version	Path
vault-tools-0.4.7	lib/vault-tools/user.rb