Module: Billfold::Identity::ClassMethods

Included in:
ActiveRecordIdentity::ClassMethods
Defined in:
lib/billfold/identity.rb

Instance Method Summary collapse

Instance Method Details

#update_or_create!(attributes = {}) ⇒ Object

Billfold::Identity.update_or_create!

Updates or creates a Billfold::Identity.

Parameters: a single Hash with the following keys:

  • :provider -- the name of an OmniAuth provider (e.g. "twitter")
  • :user -- if nil, creates a new User for the Identity
  • :value -- the unique identifier
  • :data -- extra data for the Identity

Behavior

If :provider or :value is nil, this method raises an ArgumentError.

If :user is nil, this method creates a new User for the Identity.

If :user exists and there is no other Identity with the same :value, this method adds a new Identity to the User.

If there exists another Identity with the same :value and that Identity is owned by the given User, this method updates that Identity.

If :user exists and there exists another Identity with the same :value and that Identity is owned by a different User, this method merges that User into :user and updates the Identity.

Raises:

  • (ArgumentError) 


63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
 
# File 'lib/billfold/identity.rb', line 63

def update_or_create!(attributes = {})
  raise ArgumentError.new("provider must not be blank") if attributes[:provider].blank?
  raise ArgumentError.new("value must not be blank") if attributes[:value].blank?
  identity = with_provider_and_value(attributes[:provider], attributes[:value])
  if identity
    old_owner, new_owner = identity.user, attributes[:user]
    transaction do
      identity.update_attributes!(attributes)
      old_owner.merge_into!(new_owner) if old_owner != new_owner
    end
  else
    identity = new(attributes)
    identity.user = attributes[:user] || ::Billfold.user_class.new(:name => identity.name_for_user)
    identity.save!
  end
  identity
end

#with_provider_and_value(provider, value) ⇒ Object

Billfold::Identity.with_provider_and_value

Return the identity with the given provider and value, or nil, if no such identity exists. Including classes must redefine this method.

Raises:

  • (NotImplementedError) 


32
33
34
 
# File 'lib/billfold/identity.rb', line 32

def with_provider_and_value(provider, value)
  raise NotImplementedError.new('classes including Billfold::Identity MUST redefine class method with_provider_and_value')
end