d2l_sdk 0.1.9 → 0.1.10

data/lib/d2l_sdk/grades.rb

@@ -7,45 +7,169 @@ require 'json-schema'
 # REVIEW: Delete a specific grade object for a particular org unit.
 # Return: nil
 def delete_org_unit_grade_object(org_unit_id, grade_object_id)
-  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/#{grade_object_id}"
-  _delete(path)
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/#{grade_object_id}"
+    _delete(path)
 end
 
 # REVIEW: Retrieve all the current grade objects for a particular org unit.
 # Return: This action returns a JSON array of GradeObject blocks.
 def get_org_unit_grades(org_unit_id)
-  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/"
-  _get(path)
-  # RETURN: This action returns a JSON array of GradeObject blocks.
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/"
+    _get(path)
+    # RETURN: This action returns a JSON array of GradeObject blocks.
 end
 
 # REVIEW: Retrieve a specific grade object for a particular org unit.
 # Return: This action returns a GradeObject JSON block.
 def get_org_unit_grade_object(org_unit_id, grade_object_id)
-  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/#{grade_object_id}"
-  _get(path)
-  # RETURN: This action returns a GradeObject JSON block.
-end
-
-# TODO: Create a new grade object for a particular org unit.
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/#{grade_object_id}"
+    _get(path)
+    # RETURN: This action returns a GradeObject JSON block.
+end
+
+def check_numeric_grade_object
+    {
+        'MaxPoints' => 0.0, # <number:decimal>,
+        'CanExceedMaxPoints' => true, # <boolean>,
+        'IsBonus' => true, # <boolean>,
+        'ExcludeFromFinalGradeCalculation' => true, # <boolean>,
+        'GradeSchemeId' => nil, # <number:D2LID>|null,
+        'Id' => 0, # <number:D2LID>,  // not on input actions
+        'Name' => '', # <string>,
+        'ShortName' => '', # <string>,
+        'GradeType' => 0, # "Numeric",
+        'CategoryId' => nil, # <number:D2LID>|null,
+        'Description' =>  # { <composite:RichTextInput> } on input actions
+        {
+          'Content' => '',
+          'Type' => 'Text|HTML'
+        },
+        'GradeSchemeUrl' => '', # <string:APIURL>,  // not on input actions
+        'Weight' => 0.0, # <number:decimal>,  // not on input actions
+        'ActivityId' => nil, # <string:D2LID>|null,  // not on input actions
+        'AssociatedTool' => # { <composite:AssociatedTool> }|null
+        {
+          'ToolId' => 0, # <string:D2LID>
+          'ToolItemId' => 0 # <string:D2LID>
+        }
+    }
+end
+
+# TODO: Create validity functions for grade objects within this.
+# Create a new grade object for a particular org unit.
 # Return: This action returns a GradeObject JSON block for the grade object
 # that the service just created, so you can quickly retrieve the grade object ID
-def create_org_unit_grade_object(org_unit_id, grade_object)
-  # POST /d2l/api/le/(version)/(orgUnitId)/grades/
-  # NOTE: must be grade object of type numeric, passfail, selectbox, or text
-  # NOTE: the name must be unique!
-  # Return: This action returns a GradeObject JSON block for the grade object
-  # that the service just created, so you can quickly retrieve the grade object
-  # ID
+def create_org_unit_grade_object(org_unit_id, grade_object, type)
+    # POST /d2l/api/le/(version)/(orgUnitId)/grades/
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/"
+    payload = {}
+    # NOTE: must be grade object of type numeric, passfail, selectbox, or text
+    # NOTE: the name must be unique!
+    if type == 'Numeric' || type == 'numeric'
+      payload =
+      {
+          'MaxPoints' => 0.0, # <number:decimal>,
+          'CanExceedMaxPoints' => true, # <boolean>,
+          'IsBonus' => true, # <boolean>,
+          'ExcludeFromFinalGradeCalculation' => true, # <boolean>,
+          'GradeSchemeId' => nil, # <number:D2LID>|null,
+          'Name' => '', # <string>,
+          'ShortName' => '', # <string>,
+          'GradeType' => 'Numeric', #
+          'CategoryId' => nil, # <number:D2LID>|null,
+          'Description' =>  # { <composite:RichTextInput> } on input actions
+          {
+            'Content' => '',
+            'Type' => 'Text|HTML'
+          },
+          'AssociatedTool' => # { <composite:AssociatedTool> }|null
+          {
+            'ToolId' => 0, # <string:D2LID>
+            'ToolItemId' => 0 # <string:D2LID>
+          }
+      }.merge!(grade_object)
+      # TODO: check numeric grade object validity
+    elsif type == 'PassFail' || type == 'passfail'
+      payload =
+      {
+          'MaxPoints' => 0.0, # <number:decimal>,
+          'IsBonus' => true, # <boolean>,
+          'ExcludeFromFinalGradeCalculation' => true, # <boolean>,
+          'GradeSchemeId' => nil, # <number:D2LID>|null
+          'Name' => '', # <string>,
+          'ShortName' => '', # <string>,
+          'GradeType' => 'PassFail', #
+          'CategoryId' => nil, # <number:D2LID>|null,
+          'Description' =>  # { <composite:RichTextInput> } on input actions
+          {
+            'Content' => '',
+            'Type' => 'Text|HTML'
+          },
+          'AssociatedTool' => # { <composite:AssociatedTool> }|null
+          {
+            'ToolId' => 0, # <string:D2LID>
+            'ToolItemId' => 0 # <string:D2LID>
+          }
+      }.merge!(grade_object)
+      # TODO: check PassFail grade object validity
+    elsif type == 'SelectBox' || type == 'selectbox'
+      payload =
+      {
+          'MaxPoints' => 0.0, # <number:decimal>,
+          'IsBonus' => true, # <boolean>,
+          'ExcludeFromFinalGradeCalculation' => true, # <boolean>,
+          'GradeSchemeId' => nil, # nil/null on input
+          'Name' => '', # <string>,
+          'ShortName' => '', # <string>,
+          'GradeType' => 'SelectBox', #
+          'CategoryId' => nil, # <number:D2LID>|null,
+          'Description' =>  # { <composite:RichTextInput> } on input actions
+          {
+            'Content' => '',
+            'Type' => 'Text|HTML'
+          },
+          'AssociatedTool' => # { <composite:AssociatedTool> }|null
+          {
+            'ToolId' => 0, # <string:D2LID>
+            'ToolItemId' => 0 # <string:D2LID>
+          }
+      }.merge!(grade_object)
+      # TODO: check SelectBox grade object validity
+    elsif type == 'Text' || type == 'text'
+      payload =
+      {
+          'Name' => '', # <string>,
+          'ShortName' => '', # <string>,
+          'GradeType' => 'Text',
+          'CategoryId' => nil, # <number:D2LID>|null,
+          'Description' =>  # { <composite:RichTextInput> } on input actions
+          {
+            'Content' => '',
+            'Type' => 'Text|HTML'
+          },
+          'AssociatedTool' => # { <composite:AssociatedTool> }|null
+          {
+            'ToolId' => 0, # <string:D2LID>
+            'ToolItemId' => 0 # <string:D2LID>
+          }
+      }.merge!(grade_object)
+      # TODO: check Text grade object validity
+    else
+      raise ArgumentError, 'Grade Object Type not a valid type'
+    end
+    _post(path, payload)
+    # Return: This action returns a GradeObject JSON block for the grade object
+    # that the service just created, so you can quickly retrieve the grade object
+    # ID
 end
 
 # TODO: Update a specific grade object.
 def update_org_unit_grade_object(org_unit_id, grade_object)
-  # NOTE: if new name, it must be Unique
-  # NOTE: must be grade object of type numeric, passfail, selectbox, or text
-  # PUT /d2l/api/le/(version)/(orgUnitId)/grades/(gradeObjectId)
-  # Return: This action returns a GradeObject JSON block for the grade object
-  # that the service just updated.
+    # NOTE: if new name, it must be Unique
+    # NOTE: must be grade object of type numeric, passfail, selectbox, or text
+    # PUT /d2l/api/le/(version)/(orgUnitId)/grades/(gradeObjectId)
+    # Return: This action returns a GradeObject JSON block for the grade object
+    # that the service just updated.
 end
 
 ########################
@@ -54,35 +178,53 @@ end
 
 # REVIEW: Delete a specific grade category for a provided org unit.
 def delete_org_unit_grade_category(org_unit_id, category_id)
-  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/categories/#{category_id}"
-  _delete(path)
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/categories/#{category_id}"
+    _delete(path)
 end
 
 # REVIEW: Retrieve a list of all grade categories for a provided org unit.
 # Return: This action retrieves a JSON array of GradeObjectCategory blocks.
 def get_org_unit_grade_categories(org_unit_id)
-  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/categories/"
-  _get(path)
-  # Return: This action retrieves a JSON array of GradeObjectCategory blocks.
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/categories/"
+    _get(path)
+    # Return: This action retrieves a JSON array of GradeObjectCategory blocks.
 end
 
 # REVIEW: Retrieve a specific grade category for a provided org unit.
 # Return: This action retrieves a GradeObjectCategory JSON block.
 def get_org_unit_grade_category(org_unit_id, category_id)
-  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/categories/#{category_id}"
-  _get(path)
-  # Return: This action retrieves a GradeObjectCategory JSON block.
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/categories/#{category_id}"
+    _get(path)
+    # Return: This action retrieves a GradeObjectCategory JSON block.
 end
 
-# TODO: Create a new grade category for a provided org unit.
+# REVIEW: Create a new grade category for a provided org unit.
 # Return. This action returns the newly created grade object category in a
 # GradeObjectCategory JSON block, so that you can quickly gather its grade
 # category ID.
 def create_org_unit_grade_category(org_unit_id, grade_category_data)
-  # POST /d2l/api/le/(version)/(orgUnitId)/grades/
-  # Return. This action returns the newly created grade object category in a
-  # GradeObjectCategory JSON block, so that you can quickly gather its grade
-  # category ID.
+    # POST /d2l/api/le/(version)/(orgUnitId)/grades/
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/"
+    payload =
+    {
+      'Name' => '', # <string>,
+      'ShortName'=> '', # <string>,
+      'CanExceedMax'=> false, # <boolean>,
+      'ExcludeFromFinalGrade'=> false, # <boolean>,
+      'StartDate' => nil, # <string:UTCDateTime>|null,
+      'EndDate' => nil, # <string:UTCDateTime>|null,
+      'Weight' => nil, # <number:decimal>|null,
+      'MaxPoints' => nil, # <number:decimal>|null,
+      'AutoPoints' => nil, # <boolean>|null,
+      'WeightDistributionType' => nil, # <number>|null,
+      'NumberOfHighestToDrop' => nil, # <number>|null,
+      'NumberOfLowestToDrop' => nil, # <number>|null
+    }.merge!(grade_category_data)
+    # TODO: Validity check of 'create_org_unit_grade_category'!
+    _post(path, payload)
+    # Return. This action returns the newly created grade object category in a
+    # GradeObjectCategory JSON block, so that you can quickly gather its grade
+    # category ID.
 end
 
 ########################
@@ -92,17 +234,17 @@ end
 # REVIEW: Retrieve all the grade schemes for a provided org unit.
 # Return: This action returns a JSON array of GradeScheme blocks.
 def get_org_unit_grade_schemes(org_unit_id)
-  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/schemes/"
-  _get(path)
-  # Return: This action returns a JSON array of GradeScheme blocks.
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/schemes/"
+    _get(path)
+    # Return: This action returns a JSON array of GradeScheme blocks.
 end
 
 # REVIEW: Retrieve a particular grade scheme.
 # Return: This action returns a GradeScheme JSON block.
 def get_org_unit_grade_scheme(org_unit_id, grade_scheme_id)
-  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/schemes/#{grade_scheme_id}"
-  _get(path)
-  # Return: This action returns a GradeScheme JSON block.
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/schemes/#{grade_scheme_id}"
+    _get(path)
+    # Return: This action returns a GradeScheme JSON block.
 end
 
 ########################
@@ -113,10 +255,10 @@ end
 # Return: This action returns a GradeValue JSON block containing the final
 # calculated grade value for the current user context.
 def get_current_user_final_grade(org_unit_id)
- path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/final/values/myGradeValue"
- _get(path)
- # Return: This action returns a GradeValue JSON block containing the final
- # calculated grade value for the current user context.
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/final/values/myGradeValue"
+    _get(path)
+    # Return: This action returns a GradeValue JSON block containing the final
+    # calculated grade value for the current user context.
 end
 
 # TODO: Retrieve a list of final grade values for the current user
@@ -127,9 +269,9 @@ end
 # final calculated grade values sorted by the OrgUnitIds that match the provided
 # query parameter filters.
 def get_current_user_final_grades(org_unit_ids_csv)
-  # RETURN: This action returns an ObjectListPage JSON block containing a list
-  # of final calculated grade values sorted by the OrgUnitIds that match the
-  # provided query parameter filters.
+    # RETURN: This action returns an ObjectListPage JSON block containing a list
+    # of final calculated grade values sorted by the OrgUnitIds that match the
+    # provided query parameter filters.
 end
 
 # REVIEW: Retrieve the final grade value for a particular user.
@@ -138,11 +280,11 @@ end
 # Return: This action returns a GradeValue JSON block containing the final
 # calculated grade value for the provided user.
 def get_user_final_grade(org_unit_id, user_id, grade_type = '')
-  path = "/d2l/api/le/#{le_ver}/#{org_unit_id}/grades/final/values/#{user_id}"
-  path += "?gradeType=#{grade_type}" if grade_type != ''
-  _get(path)
-  # Return: This action returns a GradeValue JSON block containing the final
-  # calculated grade value for the provided user.
+    path = "/d2l/api/le/#{le_ver}/#{org_unit_id}/grades/final/values/#{user_id}"
+    path += "?gradeType=#{grade_type}" if grade_type != ''
+    _get(path)
+    # Return: This action returns a GradeValue JSON block containing the final
+    # calculated grade value for the provided user.
 end
 
 # REVIEW: Retrieve each user’s grade value for a particular grade object.
@@ -151,39 +293,39 @@ end
 # of user grade values for your provided grade object.
 def get_all_grade_object_grades(org_unit_id, grade_object_id, sort = '',
                                 page_size = 0, is_graded = nil, search_text = '')
-  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/#{grade_object_id}/values/"
-  path += "?"
-  path += "sort=#{sort}&" if sort != ''
-  path += "pageSize=#{page_size}&" if page_size != 0
-  path += "isGraded=#{is_graded}&" if is_graded != nil
-  path += "searchText=#{search_text}" if search_text != ''
-  _get(path)
-  # RETURN: This action returns an ObjectListPage JSON block containing a list
-  # of user grade values for your provided grade object.
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/#{grade_object_id}/values/"
+    path += '?'
+    path += "sort=#{sort}&" if sort != ''
+    path += "pageSize=#{page_size}&" if page_size != 0
+    path += "isGraded=#{is_graded}&" unless is_graded.nil?
+    path += "searchText=#{search_text}" if search_text != ''
+    _get(path)
+    # RETURN: This action returns an ObjectListPage JSON block containing a list
+    # of user grade values for your provided grade object.
 end
 
 # REVIEW: Retrieve a specific grade value for the current user context assigned
 # in a particular org unit.
 # RETURN: This action returns a GradeValue JSON block.
 def get_user_grade_object_grade(org_unit_id, grade_object_id, user_id)
-  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/#{grade_object_id}/values/#{user_id}"
-  _get(path)
-  # RETURN: This action returns a GradeValue JSON block.
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/#{grade_object_id}/values/#{user_id}"
+    _get(path)
+    # RETURN: This action returns a GradeValue JSON block.
 end
 
 # REVIEW: Retrieve all the grade objects for the current user context assigned
 # in a particular org unit.
 def get_current_user_org_unit_grades(org_unit_id)
-  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/values/myGradeValues/"
-  _get(path)
-  # RETURN: This action returns a JSON array of GradeValue blocks.
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/values/myGradeValues/"
+    _get(path)
+    # RETURN: This action returns a JSON array of GradeValue blocks.
 end
 
 # REVIEW: Retrieve all the grade objects for a particular user assigned in an org unit.
 def get_user_org_unit_grades(org_unit_id, user_id)
-  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/values/#{user_id}/"
-  _get(path)
-  # RETURN: This action returns a JSON array of GradeValue blocks.
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/values/#{user_id}/"
+    _get(path)
+    # RETURN: This action returns a JSON array of GradeValue blocks.
 end
 
 ########################
@@ -193,8 +335,8 @@ end
 # REVIEW: Delete a course completion.
 # RETURNS: nil
 def delete_course_completion(org_unit_id, completion_id)
-  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/courseCompletion/#{completion_id}"
-  _delete(path)
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/courseCompletion/#{completion_id}"
+    _delete(path)
 end
 
 # REVIEW: Retrieve all the course completion records for an org unit.
@@ -203,52 +345,52 @@ end
 # parameter (or the first segment if the parameter is empty or missing).
 def get_org_unit_completion_records(org_unit_id, user_id = 0, start_expiry = '',
                                     end_expiry = '', bookmark = '')
-  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/courseCompletion/"
-  path += "?"
-  path += "userId=#{user_id}&" if user_id != 0
-  path += "startExpiry=#{start_expiry}&" if startExpiry != ''
-  path += "endExpiry=#{end_expiry}&" if endExpiry != ''
-  path += "bookmark=#{bookmark}" if bookmark != ''
-  _get(path)
-  # RETURNS: This action returns a paged result set containing the resulting
-  # CourseCompletion data blocks for the segment following your bookmark
-  # parameter (or the first segment if the parameter is empty or missing).
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/courseCompletion/"
+    path += '?'
+    path += "userId=#{user_id}&" if user_id != 0
+    path += "startExpiry=#{start_expiry}&" if startExpiry != ''
+    path += "endExpiry=#{end_expiry}&" if endExpiry != ''
+    path += "bookmark=#{bookmark}" if bookmark != ''
+    _get(path)
+    # RETURNS: This action returns a paged result set containing the resulting
+    # CourseCompletion data blocks for the segment following your bookmark
+    # parameter (or the first segment if the parameter is empty or missing).
 end
 
 # REVIEW: Retrieve all the course completion records for a user.
 # RETURNS: This action returns a paged result set containing the resulting
 # CourseCompletion data blocks for the segment following your bookmark
 # parameter (or the first segment if the parameter is empty or missing).
-def get_user_completion_records(user_id, start_expiry = '', end_expiry = '',
+def get_user_completion_records(_user_id, start_expiry = '', end_expiry = '',
                                 bookmark = '')
-  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/courseCompletion/"
-  path += "?"
-  path += "startExpiry=#{start_expiry}&" if startExpiry != ''
-  path += "endExpiry=#{end_expiry}&" if endExpiry != ''
-  path += "bookmark=#{bookmark}" if bookmark != ''
-  _get(path)
-  # RETURNS: This action returns a paged result set containing the resulting
-  # CourseCompletion data blocks for the segment following your bookmark
-  # parameter (or the first segment if the parameter is empty or missing).
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/courseCompletion/"
+    path += '?'
+    path += "startExpiry=#{start_expiry}&" if startExpiry != ''
+    path += "endExpiry=#{end_expiry}&" if endExpiry != ''
+    path += "bookmark=#{bookmark}" if bookmark != ''
+    _get(path)
+    # RETURNS: This action returns a paged result set containing the resulting
+    # CourseCompletion data blocks for the segment following your bookmark
+    # parameter (or the first segment if the parameter is empty or missing).
 end
 
 # TODO: Create a new course completion for an org unit.
 # RETURNS: a CourseCompletion JSON block with the newly created course completion record.
 def create_course_completion(org_unit_id, course_completion_data)
-  #CourseCompletionCreationData JSON data block example:
-  # {"UserId" => 0,
-  # "CompletedDate" => "UTCDateTime",
-  # "ExpiryDate" => "UTCDateTime" || nil}
-  # POST /d2l/api/le/(version)/(orgUnitId)/grades/courseCompletion/
+    # CourseCompletionCreationData JSON data block example:
+    # {"UserId" => 0,
+    # "CompletedDate" => "UTCDateTime",
+    # "ExpiryDate" => "UTCDateTime" || nil}
+    # POST /d2l/api/le/(version)/(orgUnitId)/grades/courseCompletion/
 end
 
 # TODO: Update an existing course completion.
 # RETURNS: a CourseCompletion JSON block with the newly created course completion record.
 def update_course_completion(org_unit_id, completion_id, course_completion_data)
-  # CourseCompletionUpdateData JSON data block example:
-  # {"CompletedDate" => "UTCDateTime",
-  # "ExpiryDate" => "UTCDateTime" || nil}
-  # PUT /d2l/api/le/(version)/(orgUnitId)/grades/courseCompletion/(completionId)
+    # CourseCompletionUpdateData JSON data block example:
+    # {"CompletedDate" => "UTCDateTime",
+    # "ExpiryDate" => "UTCDateTime" || nil}
+    # PUT /d2l/api/le/(version)/(orgUnitId)/grades/courseCompletion/(completionId)
 end
 
 ########################
@@ -258,9 +400,9 @@ end
 # REVIEW: Get statistics for a specified grade item.
 # RETURNS: a GradeStatisticsInfo JSON block.
 def get_grade_item_statistics(org_unit_id, grade_object_id)
-  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/#{grade_object_id}/statistics"
-  _get(path)
-  # RETURNS: a GradeStatisticsInfo JSON block.
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/#{grade_object_id}/statistics"
+    _get(path)
+    # RETURNS: a GradeStatisticsInfo JSON block.
 end
 
 ########################
@@ -270,21 +412,21 @@ end
 # REVIEW: Retrieve the grades configuration for the org unit.
 # RETURNS: a GradeSetupInfo JSON block.
 def get_org_unit_grade_config(org_unit_id)
-  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/setup/"
-  _get(path)
-  # RETURNS: a GradeSetupInfo JSON block.
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/setup/"
+    _get(path)
+    # RETURNS: a GradeSetupInfo JSON block.
 end
 
 # TODO: Update the grades configuration for the org unit.
 # INPUT: a GradeSetupInfo JSON block. (grade_setup_info)
 # RETURNS: a GradeSetupInfo JSON block.
 def update_org_unit_grade_config(org_unit_id, grade_setup_info)
-  # Grade.GradeSetupInfo JSON data block example:
-  # {"GradingSystem" => "Points", # Other types: "Weighted", "Formula"
-  # "IsNullGradeZero" => false,
-  # "DefaultGradeSchemeId" => 0}
-  # PUT /d2l/api/le/(version)/(orgUnitId)/grades/setup/
-  # RETURNS: a GradeSetupInfo JSON block.
+    # Grade.GradeSetupInfo JSON data block example:
+    # {"GradingSystem" => "Points", # Other types: "Weighted", "Formula"
+    # "IsNullGradeZero" => false,
+    # "DefaultGradeSchemeId" => 0}
+    # PUT /d2l/api/le/(version)/(orgUnitId)/grades/setup/
+    # RETURNS: a GradeSetupInfo JSON block.
 end
 
 ########################
@@ -294,33 +436,33 @@ end
 # REVIEW: Retrieve all the exempt users for a provided grade.
 # RETURNS: a JSON array of User blocks.
 def get_grade_exempt_users(org_unit_id, grade_object_id)
-  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/#{grade_object_id}/exemptions/"
-  _get(path)
-  # RETURNS: a JSON array of User blocks.
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/#{grade_object_id}/exemptions/"
+    _get(path)
+    # RETURNS: a JSON array of User blocks.
 end
 
 # REVIEW: Determine if a user is exempt from a grade.
 # RETURNS: a User JSON block.
 def get_is_user_exempt(org_unit_id, grade_object_id, user_id)
-  path = "GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/#{grade_object_id}/exemptions/#{user_id}"
-  _get(path)
-  # RETURNS: a User JSON block.
+    path = "GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/#{grade_object_id}/exemptions/#{user_id}"
+    _get(path)
+    # RETURNS: a User JSON block.
 end
 
 # REVIEW: Exempt a user from a grade.
 # RETURNS: a User JSON block.
 def exempt_user_from_grade(org_unit_id, grade_object_id, user_id)
-  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/#{grade_object_id}/exemptions/#{user_id}"
-  _post(path, {})
-  # RETURNS: a User JSON block.
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/#{grade_object_id}/exemptions/#{user_id}"
+    _post(path, {})
+    # RETURNS: a User JSON block.
 end
 
 # REVIEW: Remove a user’s exemption from a grade.
 # RETURNS: nil
 def remove_user_grade_exemption(org_unit_id, grade_object_id, user_id)
-  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/#{grade_object_id}/exemptions/#{user_id}"
-  _delete(path)
-  # RETURNS: nil
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/#{grade_object_id}/exemptions/#{user_id}"
+    _delete(path)
+    # RETURNS: nil
 end
 
 #############################
@@ -330,9 +472,9 @@ end
 # REVIEW: Retrieve all the grade objects for a provided user in a provided org unit with exemption status included.
 # RETURNS: BulkGradeObjectExemptionResult JSON block.
 def get_user_grade_exemptions(org_unit_id, user_id)
-  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/exemptions/#{user_id}"
-  _get(path)
-  # RETURNS: BulkGradeObjectExemptionResult JSON block.
+    path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/grades/exemptions/#{user_id}"
+    _get(path)
+    # RETURNS: BulkGradeObjectExemptionResult JSON block.
 end
 
 # TODO: Attempt to exempt or unexempt a set of grades for a user.
@@ -342,11 +484,36 @@ end
 #       be exempted or unexempted.
 # RETURNS: a JSON array of BulkGradeObjectExemptionConflict blocks.
 def bulk_grade_exemption_update(org_unit_id, user_id, bulk_grade_exmption_update_block)
-  # Grade.BulkGradeObjectExemptionUpdate JSON data block example:
-  # {"ExemptedIds" => [0,1,2,3], # D2LIDs
-  # "UnexemptedIds" => [0,1,2,3], # D2LIDs
-  # "ExemptionAccessDate" => 'UTCDateTime'}
+    # Grade.BulkGradeObjectExemptionUpdate JSON data block example:
+    # {"ExemptedIds" => [0,1,2,3], # D2LIDs
+    # "UnexemptedIds" => [0,1,2,3], # D2LIDs
+    # "ExemptionAccessDate" => 'UTCDateTime'}
+
+    # POST /d2l/api/le/(version)/(orgUnitId)/grades/exemptions/(userId)
+    # RETURNS: a JSON array of BulkGradeObjectExemptionConflict blocks.
+end
+
+###################
+# ASSESSMENTS:#####
+###################
+
+# TODO: --UNSTABLE-- Retrieve rubrics for an object in an org unit.
+# RETURNS: a JSON array of Rubric blocks.
+def get_org_unit_rubrics(org_unit_id, object_type, object_id)
+    # GET /d2l/api/le/(version)/(orgUnitId)/rubrics
+    # RETURNS: a JSON array of Rubric blocks.
+end
+
+# TODO: --UNSTABLE-- Retrieve an assessment in an org unit.
+# RETURNS: a RubricAssessment JSON structure.
+def get_org_unit_assessment(org_unit_id, assessment_type, object_type, object_id, user_id)
+    # GET /d2l/api/le/(version)/(orgUnitId)/assessment
+    # RETURNS: a RubricAssessment JSON structure.
+end
 
-  # POST /d2l/api/le/(version)/(orgUnitId)/grades/exemptions/(userId)
-  # RETURNS: a JSON array of BulkGradeObjectExemptionConflict blocks.
+# TODO: --UNSTABLE-- Update an assessment in an org unit.
+# RETURNS: value of the assessment in a RubricAssessment JSON structure.
+def update_org_unit_assessment(org_unit_id, assessment_type, object_type, object_id, user_id)
+    # PUT /d2l/api/le/(version)/(orgUnitId)/assessment
+    # RETURNS: value of the assessment in a RubricAssessment JSON structure.
 end