Class: Io::Flow::V0::Clients::Users

Inherits:
Object
  • Object
show all
Defined in:
lib/flow_commerce/flow_api_v0_client.rb

Instance Method Summary collapse

Constructor Details

#initialize(client) ⇒ Users

Returns a new instance of Users.



4829
4830
4831
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 4829

def initialize(client)
  @client = HttpClient::Preconditions.assert_class('client', client, ::Io::Flow::V0::Client)
end

Instance Method Details

#delete_passwords_by_id(id) ⇒ Object

Deletes a password for the given user.



4881
4882
4883
4884
4885
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 4881

def delete_passwords_by_id(id)
  HttpClient::Preconditions.assert_class('id', id, String)
  r = @client.request("/users/#{CGI.escape(id)}/passwords").delete
  nil
end

#get(incoming = {}) ⇒ Object

Search users. Always paginated.



4834
4835
4836
4837
4838
4839
4840
4841
4842
4843
4844
4845
4846
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 4834

def get(incoming={})
  opts = HttpClient::Helper.symbolize_keys(incoming)
  query = {
    :id => (x = opts.delete(:id); x.nil? ? nil : HttpClient::Preconditions.assert_class('id', x, Array).map { |v| HttpClient::Preconditions.assert_class('id', v, String) }),
    :email => (x = opts.delete(:email); x.nil? ? nil : HttpClient::Preconditions.assert_class('email', x, String)),
    :status => (x = opts.delete(:status); x.nil? ? nil : (x = x; x.is_a?(::Io::Flow::V0::Models::UserStatus) ? x : ::Io::Flow::V0::Models::UserStatus.apply(x)).value),
    :limit => HttpClient::Preconditions.assert_class('limit', (x = opts.delete(:limit); x.nil? ? 25 : x), Integer),
    :offset => HttpClient::Preconditions.assert_class('offset', (x = opts.delete(:offset); x.nil? ? 0 : x), Integer),
    :sort => HttpClient::Preconditions.assert_class('sort', (x = opts.delete(:sort); x.nil? ? "-created_at" : x), String)
  }.delete_if { |k, v| v.nil? }
  r = @client.request("/users").with_query(query).get
  r.map { |x| ::Io::Flow::V0::Models::User.new(x) }
end

#get_by_id(id) ⇒ Object

Returns information about a specific user.



4858
4859
4860
4861
4862
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 4858

def get_by_id(id)
  HttpClient::Preconditions.assert_class('id', id, String)
  r = @client.request("/users/#{CGI.escape(id)}").get
  ::Io::Flow::V0::Models::User.new(r)
end

#get_versions(incoming = {}) ⇒ Object

Provides visibility into recent changes of each object, including deletion



4896
4897
4898
4899
4900
4901
4902
4903
4904
4905
4906
4907
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 4896

def get_versions(incoming={})
  opts = HttpClient::Helper.symbolize_keys(incoming)
  query = {
    :id => (x = opts.delete(:id); x.nil? ? nil : HttpClient::Preconditions.assert_class('id', x, Array).map { |v| HttpClient::Preconditions.assert_class('id', v, String) }),
    :user_id => (x = opts.delete(:user_id); x.nil? ? nil : HttpClient::Preconditions.assert_class('user_id', x, Array).map { |v| HttpClient::Preconditions.assert_class('user_id', v, String) }),
    :limit => HttpClient::Preconditions.assert_class('limit', (x = opts.delete(:limit); x.nil? ? 25 : x), Integer),
    :offset => HttpClient::Preconditions.assert_class('offset', (x = opts.delete(:offset); x.nil? ? 0 : x), Integer),
    :sort => HttpClient::Preconditions.assert_class('sort', (x = opts.delete(:sort); x.nil? ? "journal_timestamp" : x), String)
  }.delete_if { |k, v| v.nil? }
  r = @client.request("/users/versions").with_query(query).get
  r.map { |x| ::Io::Flow::V0::Models::UserVersion.new(x) }
end

#patch_passwords_by_id(id, password_change_form) ⇒ Object

Update the password for a user.



4873
4874
4875
4876
4877
4878
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 4873

def patch_passwords_by_id(id, password_change_form)
  HttpClient::Preconditions.assert_class('id', id, String)
  (x = password_change_form; x.is_a?(::Io::Flow::V0::Models::PasswordChangeForm) ? x : ::Io::Flow::V0::Models::PasswordChangeForm.new(x))
  r = @client.request("/users/#{CGI.escape(id)}/passwords").with_json(password_change_form.to_json).patch
  nil
end

#post(user_form) ⇒ Object

Create a new user. Note that new users will be created with a status of pending and will not be able to authenticate until approved by a member of the Flow team.



4851
4852
4853
4854
4855
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 4851

def post(user_form)
  (x = user_form; x.is_a?(::Io::Flow::V0::Models::UserForm) ? x : ::Io::Flow::V0::Models::UserForm.new(x))
  r = @client.request("/users").with_json(user_form.to_json).post
  ::Io::Flow::V0::Models::User.new(r)
end

#post_authenticate(authentication_form) ⇒ Object

Authenticates a user by email / password. Note only users that have a status of active will be authorized.



4889
4890
4891
4892
4893
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 4889

def post_authenticate(authentication_form)
  (x = authentication_form; x.is_a?(::Io::Flow::V0::Models::AuthenticationForm) ? x : ::Io::Flow::V0::Models::AuthenticationForm.new(x))
  r = @client.request("/users/authenticate").with_json(authentication_form.to_json).post
  ::Io::Flow::V0::Models::User.new(r)
end

#put_by_id(id, user_put_form) ⇒ Object

Update a user.



4865
4866
4867
4868
4869
4870
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 4865

def put_by_id(id, user_put_form)
  HttpClient::Preconditions.assert_class('id', id, String)
  (x = user_put_form; x.is_a?(::Io::Flow::V0::Models::UserPutForm) ? x : ::Io::Flow::V0::Models::UserPutForm.new(x))
  r = @client.request("/users/#{CGI.escape(id)}").with_json(user_put_form.to_json).put
  ::Io::Flow::V0::Models::User.new(r)
end