Class: Agilix::Buzz::Api

Inherits:
Object
  • Object
show all
Includes:
Commands::Authentication, Commands::Course, Commands::Domain, Commands::Enrollment, Commands::General, Commands::Library, Commands::Report, Commands::Resource, Commands::Right, Commands::User, HTTParty
Defined in:
lib/agilix/buzz/api.rb

Defined Under Namespace

Classes: AuthenticationError

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Commands::User

#create_users2, #delete_users, #get_active_user_count, #get_domain_activity, #get_profile_picture, #get_user2, #get_user_activity, #get_user_activity_stream, #list_users, #restore_user, #update_users

Methods included from Commands::Right

#create_role, #delete_role, #delete_subscriptions, #get_actor_rights, #get_effective_rights, #get_effective_subscription_list, #get_entity_rights, #get_entity_subscription_list, #get_personas, #get_rights, #get_rights_list, #get_role, #get_subscription_list, #list_roles, #restore_role, #right_flags, #right_flags_hex, #right_flags_lookup_value, #update_rights, #update_role, #update_subscriptions

Methods included from Commands::Resource

#copy_resources, #delete_documents, #delete_resources, #get_document, #get_document_info, #get_entity_resource_id, #get_resource, #get_resource_info2, #get_resource_list2, #list_restorable_documents, #list_restorable_resources, #put_resource, #put_resource_folders, #restore_documents, #restore_resources

Methods included from Commands::Report

#get_report_info, #get_report_list, #get_runnable_report_list, #run_report

Methods included from Commands::Library

#create_library_page, #get_library_page, #list_library_pages

Methods included from Commands::General

#echo, #get_basic_status, #get_command_list, #get_entity_type, #get_status, #get_upload_limits, #send_mail

Methods included from Commands::Enrollment

#create_enrollments, #delete_enrollments, #enrollment_status, #enrollment_status_lookup_value, #get_enrollment3, #get_enrollment_activity, #get_enrollment_gradebook2, #get_enrollment_group_list, #get_enrollment_metrics_report, #list_enrollments, #list_enrollments_by_teacher, #list_entity_enrollments, #list_user_enrollments, #put_self_assessment, #restore_enrollment, #update_enrollments

Methods included from Commands::Domain

#create_domains, #delete_domain, #get_domain2, #get_domain_content, #get_domain_enrollment_metrics, #get_domain_parent_list, #get_domain_settings, #get_domain_stats, #list_domains, #restore_domain, #update_domains

Methods included from Commands::Course

#copy_courses, #create_courses, #create_demo_course, #deactivate_course, #delete_courses, #get_course2, #get_course_history, #list_courses, #merge_courses, #restore_course, #update_courses

Methods included from Commands::Authentication

#compute_hmac, #extend_session, #force_password_change, #get_key, #get_password_login_attempt_history, #get_password_policy, #get_password_question, #login2, #logout, #proxy, #proxy_api, #proxy_sso_link, #put_key, #reset_lockout, #reset_password, #unproxy, #update_password, #update_password_question_answer

Constructor Details

#initialize(options = {}) ⇒ Api

Returns a new instance of Api.



19
20
21
22
23
24
25
26
 
# File 'lib/agilix/buzz/api.rb', line 19

def initialize(options = {})
  @username = options.fetch(:username, default_username)
  @password = options.fetch(:password, default_password)
  @domain = options.fetch(:domain, default_domain)
  @token = options.dig(:token)
  @token_expiration = options.dig(:token_expiration)
  @agilix_url_endpoint = options.fetch(:agilix_url_endpoint, default_agilix_url_endpoint)
end

Instance Attribute Details

#agilix_url_endpoint ⇒ Object

Returns the value of attribute agilix_url_endpoint.



17
18
19
 
# File 'lib/agilix/buzz/api.rb', line 17

def agilix_url_endpoint
  @agilix_url_endpoint
end

#domain ⇒ Object

Returns the value of attribute domain.



17
18
19
 
# File 'lib/agilix/buzz/api.rb', line 17

def domain
  @domain
end

#password ⇒ Object

Returns the value of attribute password.



17
18
19
 
# File 'lib/agilix/buzz/api.rb', line 17

def password
  @password
end

#token ⇒ Object

Returns the value of attribute token.



17
18
19
 
# File 'lib/agilix/buzz/api.rb', line 17

def token
  @token
end

#token_expiration ⇒ Object

Returns the value of attribute token_expiration.



17
18
19
 
# File 'lib/agilix/buzz/api.rb', line 17

def token_expiration
  @token_expiration
end

#username ⇒ Object

Returns the value of attribute username.



17
18
19
 
# File 'lib/agilix/buzz/api.rb', line 17

def username
  @username
end

Instance Method Details

#authenticated_bulk_post(query = {}) ⇒ Object 



43
44
45
46
 
# File 'lib/agilix/buzz/api.rb', line 43

def authenticated_bulk_post(query = {})
  check_authentication
  bulk_post query
end

#authenticated_get(query = {}) ⇒ Object 



28
29
30
31
 
# File 'lib/agilix/buzz/api.rb', line 28

def authenticated_get(query = {})
  check_authentication
  get query
end

#authenticated_post(query = {}) ⇒ Object 



33
34
35
36
 
# File 'lib/agilix/buzz/api.rb', line 33

def authenticated_post(query = {})
  check_authentication unless query.delete(:bypass_authentication_check)
  post query
end

#authenticated_query_post(query = {}) ⇒ Object 



38
39
40
41
 
# File 'lib/agilix/buzz/api.rb', line 38

def authenticated_query_post(query = {})
  check_authentication unless query.delete(:bypass_authentication_check)
  query_post query
end

#bulk_post(query = {}) ⇒ Object 



90
91
92
93
94
95
96
97
98
 
# File 'lib/agilix/buzz/api.rb', line 90

def bulk_post(query = {})
  cmd = query.delete(:cmd)
  url = agilix_url_base + "?cmd=#{cmd}&_token=#{token}"
  query_params = query.delete(:query_params)
  if query_params
    url += query_params.map {|k,v| "&#{k}=#{v}" }.join("")
  end
  response = self.class.post(url, body: modify_bulk_body(query), timeout: 60, headers: headers)
end

#check_authentication ⇒ Object 



100
101
102
103
104
105
106
107
108
 
# File 'lib/agilix/buzz/api.rb', line 100

def check_authentication
  if token && token_expiration
    if token_expiration < Time.now
      extend_session
    end
  else
    authenticate!
  end
end

#get(query = {}) ⇒ Object 



48
49
50
 
# File 'lib/agilix/buzz/api.rb', line 48

def get(query = {})
  response = self.class.get(agilix_url_base, query: modify_query(query), timeout: 60, headers: headers)
end

#post(query = {}) ⇒ Object 



52
53
54
 
# File 'lib/agilix/buzz/api.rb', line 52

def post(query = {})
  response = self.class.post(agilix_url_base, body: modify_body(query), timeout: 60, headers: headers)
end

#query_post(query = {}) ⇒ Object

For when the api is super unconventional & you need to modify both query params & body params in a custom fashion, and upload a file even!



74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
 
# File 'lib/agilix/buzz/api.rb', line 74

def query_post(query = {})
  url = agilix_url_base
  query_params = query.delete(:query_params)
  if query_params
    url += "?&_token=#{token}" + query_params.map {|k,v| "&#{k}=#{v}" }.join("")
  end
  file = query.delete(:file)
  if file
    new_headers = headers
    new_headers["Content-Type"] = "multipart/form-data"
    response = self.class.post(url, multipart: true, body: {file: file}, timeout: 60, headers: new_headers)
  else
    response = self.class.post(url, body: query.to_json, timeout: 60, headers: headers)
  end
end