commonlit-clever-ruby 2.1.4 → 2.1.6.beta1

data/lib/clever-ruby/api/sections_api.rb

@@ -0,0 +1,500 @@
+=begin
+#Data API
+
+#Serves the Clever Data API
+
+OpenAPI spec version: 2.1.0
+
+Generated by: https://github.com/swagger-api/swagger-codegen.git
+Swagger Codegen version: 2.4.37
+
+=end
+
+require 'uri'
+
+module Clever
+  class SectionsApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Returns the course for a section
+    # @param id 
+    # @param [Hash] opts the optional parameters
+    # @return [CourseResponse]
+    def get_course_for_section(id, opts = {})
+      data, _status_code, _headers = get_course_for_section_with_http_info(id, opts)
+      data
+    end
+
+    # Returns the course for a section
+    # @param id 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(CourseResponse, Fixnum, Hash)>] CourseResponse data, response status code and response headers
+    def get_course_for_section_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SectionsApi.get_course_for_section ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SectionsApi.get_course_for_section"
+      end
+      # resource path
+      local_var_path = '/sections/{id}/course'.sub('{' + 'id' + '}', id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['oauth']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'CourseResponse')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SectionsApi#get_course_for_section\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Returns the district for a section
+    # @param id 
+    # @param [Hash] opts the optional parameters
+    # @return [DistrictResponse]
+    def get_district_for_section(id, opts = {})
+      data, _status_code, _headers = get_district_for_section_with_http_info(id, opts)
+      data
+    end
+
+    # Returns the district for a section
+    # @param id 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DistrictResponse, Fixnum, Hash)>] DistrictResponse data, response status code and response headers
+    def get_district_for_section_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SectionsApi.get_district_for_section ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SectionsApi.get_district_for_section"
+      end
+      # resource path
+      local_var_path = '/sections/{id}/district'.sub('{' + 'id' + '}', id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['oauth']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'DistrictResponse')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SectionsApi#get_district_for_section\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Returns the school for a section
+    # @param id 
+    # @param [Hash] opts the optional parameters
+    # @return [SchoolResponse]
+    def get_school_for_section(id, opts = {})
+      data, _status_code, _headers = get_school_for_section_with_http_info(id, opts)
+      data
+    end
+
+    # Returns the school for a section
+    # @param id 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SchoolResponse, Fixnum, Hash)>] SchoolResponse data, response status code and response headers
+    def get_school_for_section_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SectionsApi.get_school_for_section ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SectionsApi.get_school_for_section"
+      end
+      # resource path
+      local_var_path = '/sections/{id}/school'.sub('{' + 'id' + '}', id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['oauth']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'SchoolResponse')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SectionsApi#get_school_for_section\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Returns a specific section
+    # @param id 
+    # @param [Hash] opts the optional parameters
+    # @return [SectionResponse]
+    def get_section(id, opts = {})
+      data, _status_code, _headers = get_section_with_http_info(id, opts)
+      data
+    end
+
+    # Returns a specific section
+    # @param id 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SectionResponse, Fixnum, Hash)>] SectionResponse data, response status code and response headers
+    def get_section_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SectionsApi.get_section ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SectionsApi.get_section"
+      end
+      # resource path
+      local_var_path = '/sections/{id}'.sub('{' + 'id' + '}', id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['oauth']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'SectionResponse')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SectionsApi#get_section\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Returns a list of sections
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit 
+    # @option opts [String] :starting_after 
+    # @option opts [String] :ending_before 
+    # @option opts [String] :count 
+    # @return [SectionsResponse]
+    def get_sections(opts = {})
+      data, _status_code, _headers = get_sections_with_http_info(opts)
+      data
+    end
+
+    # Returns a list of sections
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit 
+    # @option opts [String] :starting_after 
+    # @option opts [String] :ending_before 
+    # @option opts [String] :count 
+    # @return [Array<(SectionsResponse, Fixnum, Hash)>] SectionsResponse data, response status code and response headers
+    def get_sections_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SectionsApi.get_sections ...'
+      end
+      if @api_client.config.client_side_validation && opts[:'count'] && !['', 'true', 'false', 'undefined'].include?(opts[:'count'])
+        fail ArgumentError, 'invalid value for "count", must be one of , true, false, undefined'
+      end
+      # resource path
+      local_var_path = '/sections'
+
+      # query parameters
+      query_params = {}
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'starting_after'] = opts[:'starting_after'] if !opts[:'starting_after'].nil?
+      query_params[:'ending_before'] = opts[:'ending_before'] if !opts[:'ending_before'].nil?
+      query_params[:'count'] = opts[:'count'] if !opts[:'count'].nil?
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['oauth']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'SectionsResponse')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SectionsApi#get_sections\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Returns the students for a section
+    # @param id 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit 
+    # @option opts [String] :starting_after 
+    # @option opts [String] :ending_before 
+    # @return [StudentsResponse]
+    def get_students_for_section(id, opts = {})
+      data, _status_code, _headers = get_students_for_section_with_http_info(id, opts)
+      data
+    end
+
+    # Returns the students for a section
+    # @param id 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit 
+    # @option opts [String] :starting_after 
+    # @option opts [String] :ending_before 
+    # @return [Array<(StudentsResponse, Fixnum, Hash)>] StudentsResponse data, response status code and response headers
+    def get_students_for_section_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SectionsApi.get_students_for_section ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SectionsApi.get_students_for_section"
+      end
+      # resource path
+      local_var_path = '/sections/{id}/students'.sub('{' + 'id' + '}', id.to_s)
+
+      # query parameters
+      query_params = {}
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'starting_after'] = opts[:'starting_after'] if !opts[:'starting_after'].nil?
+      query_params[:'ending_before'] = opts[:'ending_before'] if !opts[:'ending_before'].nil?
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['oauth']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'StudentsResponse')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SectionsApi#get_students_for_section\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Returns the primary teacher for a section
+    # @param id 
+    # @param [Hash] opts the optional parameters
+    # @return [TeacherResponse]
+    def get_teacher_for_section(id, opts = {})
+      data, _status_code, _headers = get_teacher_for_section_with_http_info(id, opts)
+      data
+    end
+
+    # Returns the primary teacher for a section
+    # @param id 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(TeacherResponse, Fixnum, Hash)>] TeacherResponse data, response status code and response headers
+    def get_teacher_for_section_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SectionsApi.get_teacher_for_section ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SectionsApi.get_teacher_for_section"
+      end
+      # resource path
+      local_var_path = '/sections/{id}/teacher'.sub('{' + 'id' + '}', id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['oauth']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'TeacherResponse')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SectionsApi#get_teacher_for_section\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Returns the teachers for a section
+    # @param id 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit 
+    # @option opts [String] :starting_after 
+    # @option opts [String] :ending_before 
+    # @return [TeachersResponse]
+    def get_teachers_for_section(id, opts = {})
+      data, _status_code, _headers = get_teachers_for_section_with_http_info(id, opts)
+      data
+    end
+
+    # Returns the teachers for a section
+    # @param id 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :limit 
+    # @option opts [String] :starting_after 
+    # @option opts [String] :ending_before 
+    # @return [Array<(TeachersResponse, Fixnum, Hash)>] TeachersResponse data, response status code and response headers
+    def get_teachers_for_section_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SectionsApi.get_teachers_for_section ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SectionsApi.get_teachers_for_section"
+      end
+      # resource path
+      local_var_path = '/sections/{id}/teachers'.sub('{' + 'id' + '}', id.to_s)
+
+      # query parameters
+      query_params = {}
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'starting_after'] = opts[:'starting_after'] if !opts[:'starting_after'].nil?
+      query_params[:'ending_before'] = opts[:'ending_before'] if !opts[:'ending_before'].nil?
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['oauth']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'TeachersResponse')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SectionsApi#get_teachers_for_section\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Returns the term for a section
+    # @param id 
+    # @param [Hash] opts the optional parameters
+    # @return [TermResponse]
+    def get_term_for_section(id, opts = {})
+      data, _status_code, _headers = get_term_for_section_with_http_info(id, opts)
+      data
+    end
+
+    # Returns the term for a section
+    # @param id 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(TermResponse, Fixnum, Hash)>] TermResponse data, response status code and response headers
+    def get_term_for_section_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SectionsApi.get_term_for_section ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling SectionsApi.get_term_for_section"
+      end
+      # resource path
+      local_var_path = '/sections/{id}/term'.sub('{' + 'id' + '}', id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['oauth']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'TermResponse')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SectionsApi#get_term_for_section\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end