d2l_sdk 0.1.10 → 0.1.11

data/lib/d2l_sdk/demographics.rb

@@ -59,12 +59,14 @@ def get_user_demographics(user_id, field_ids = '', bookmark = '')
   path += "?"
   path += "fieldIds=#{field_ids}&" if field_ids != ''
   path += "bookmark=#{bookmark}" if bookmark != ''
+  _get(path)
 end
 
-def check_demographics_user_entry_data_validity(demographics_user_entry_data)
+def check_demographics_entry_data_validity(demographics_entry_data)
     # A hash with one value, "EntryValues", which is an array of hashes that
     # include the keys "Name" and "Values", where "Name" is a string and "Values"
     # is an array of string.
+    # { "key" => [ { "key" => "string", "key" => [] } ] }
     schema = {
         'type' => 'object',
         'required' => %w(EntryValues),
@@ -94,14 +96,27 @@ def check_demographics_user_entry_data_validity(demographics_user_entry_data)
             }
         }
     }
-    JSON::Validator.validate!(schema, demographics_user_entry_data, validate_schema: true)
+    JSON::Validator.validate!(schema, demographics_entry_data, validate_schema: true)
 end
 
 
-# TODO: Update the demographics entries for a single user.
+# REVIEW: Update the demographics entries for a single user.
 # Return: a DemographicsUserEntryData JSON block containing the user’s updated entries.
 def update_user_demographics(user_id, demographics_entry_data)
+  payload =
+  {
+    "EntryValues" =>
+    [
+      {
+        "Name" => "placeholder_name",
+        "Values" => %w(value1 value2)
+      }
+    ]
+  }.merge!(demographics_entry_data)
   # PUT /d2l/api/lp/(version)/demographics/users/(userId)
+  path = "/d2l/api/lp/#{$lp_ver}/demographics/users/#{user_id}"
+  check_demographics_user_entry_data_validity(payload)
+  _put(path, payload)
 end
 
 ########################
@@ -117,7 +132,7 @@ end
 # Retrieve list of all demographics fields
 def get_all_demographic_fields(bookmark = '')
   path = "/d2l/api/lp/#{$lp_ver}/demographics/fields/"
-  path += "#{bookmark}" if bookmark != ''
+  path += bookmark.to_s if bookmark != ''
   _get(path)
   # returns paged result set of DemographicsField JSON blocks
 end
@@ -154,7 +169,7 @@ def create_demographic_field(demographics_field)
     "Name" => "String",
     "Description" => "String",
     "DataTypeId" => "String:GUID"
-  }
+  }.merge!(demographics_field)
   check_create_demographics_field(payload)
   _post(path, payload)
   # RETURNS: fetch form of a DemographicsField JSON block
@@ -168,7 +183,7 @@ def check_update_demographics_field(demographics_data)
         'required' => %w(Name Description),
         'properties' => {
             'Name' => { 'type' => 'string' },
-            'Description' => { 'type' => 'string' },
+            'Description' => { 'type' => 'string' }
         }
     }
     JSON::Validator.validate!(schema, demographics_data, validate_schema: true)
@@ -184,7 +199,7 @@ def update_demographics_field(field_id, demographics_field)
     "Name" => "String",
     "Description" => "String",
     "DataTypeId" => "String:GUID"
-  }
+  }.merge!(demographics_field)
   check_update_demographics_field(payload)
   _put(path, payload)
   # RETURNS: fetch form of a DemographicsField JSON block
@@ -198,7 +213,7 @@ end
 # uses DataTypeId's as a paging control value
 def get_all_demographic_types(bookmark = '')
   path = "/d2l/api/lp/#{$lp_ver}/demographics/dataTypes/"
-  path += "#{bookmark}" if bookmark != ''
+  path += bookmark.to_s if bookmark != ''
   _get(path)
   # returns paged result set of DemographicsDataType JSON blocks
 end

data/lib/d2l_sdk/discussions.rb

@@ -6,29 +6,61 @@ require 'json-schema'
 ##################
 
 # REVIEW: Delete a particular discussion forum from an org unit.
-# => DELETE /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)
-def dete_org_unit_discussion(org_unit_id, forum_id)
+# => DELETE /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}
+def delete_org_unit_discussion(org_unit_id, forum_id)
     path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}"
     _delete(path)
 end
 
 # REVIEW: Retrieve a list of all discussion forums for an org unit.
-# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/
 def get_org_unit_discussions(org_unit_id)
     path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/"
     _get(path)
 end
 
 # REVIEW: Retrieve a particular discussion forum for an org unit.
-# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}
 def get_org_unit_discussion(org_unit_id, forum_id)
     path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}"
     _get(path)
 end
 
-# TODO: Validate input of create_org_unit_discussion
-# Create a new forum for an org unit.
-# => POST /d2l/api/le/(version)/(orgUnitId)/discussions/forums/
+def check_forum_data_validity(forum_data)
+  schema = {
+      'type' => 'object',
+      'required' => %w(Name Description ShowDescriptionInTopics StartDate
+                       EndDate PostStartDate PostEndDate IsHidden
+                       IsLocked RequiresApproval MustPostToParticipate
+                       DisplayInCalendar DisplayPostDatesInCalendar),
+      'properties' => {
+          'Name' => { 'type' => 'string' },
+          'Description' => {
+            'type' => 'object',
+            'properties' =>
+            {
+              "Text" => { 'type' => "string" },
+              "Html" => { 'type' => %w(string null) }
+            }
+          },
+          'ShowDescriptionInTopics' => { 'type' => %w(boolean null) },
+          'StartDate' => { 'type' => %w(string null) },
+          'EndDate' => { 'type' => %w(string null) },
+          'PostStartDate' => { 'type' => %w(string null) },
+          'PostEndDate' => { 'type' => %w(string null) },
+          'IsHidden' => { 'type' => 'boolean' },
+          'IsLocked' => { 'type' => 'boolean' },
+          'RequiresApproval' => { 'type' => 'boolean' }, #: <boolean>,
+          'MustPostToParticipate' => { 'type' => %w(boolean null) },
+          'DisplayInCalendar' => { 'type' => %w(boolean null) }, # Added with LE API v1.11
+          'DisplayPostDatesInCalendar' => { 'type' => %w(boolean null) }
+      }
+  }
+  JSON::Validator.validate!(schema, forum_data, validate_schema: true)
+end
+
+# REVIEW: Create a new forum for an org unit.
+# => POST /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/
 def create_org_unit_discussion(org_unit_id, forum_data)
     path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/"
     payload =
@@ -36,10 +68,10 @@ def create_org_unit_discussion(org_unit_id, forum_data)
         'Name' => '', #: <string>,
         'Description' => #: { <composite:RichText> },
         {
-            "Text" => "",#<string:plaintext_version_of_text>,
-            "Html" => nil #<string:HTML_formatted_version_of_text>|null
+            "Text" => "", # <string:plaintext_version_of_text>,
+            "Html" => nil # <string:HTML_formatted_version_of_text>|null
         },
-        'ShowDescriptionInTopics' => nil, #: <boolean>|null,  // Added with LE API v1.14
+        'ShowDescriptionInTopics' => nil, # : <boolean>|null,  // Added with LE API v1.14
         'StartDate' => nil, #: <string:UTCDateTime>|null,
         'EndDate' => nil, #: <string:UTCDateTime>|null,
         'PostStartDate' => nil, #: <string:UTCDateTime>|null,
@@ -52,75 +84,240 @@ def create_org_unit_discussion(org_unit_id, forum_data)
         'DisplayInCalendar' => nil, #: <boolean>|null,  // Added with LE API v1.11
         'DisplayPostDatesInCalendar' => nil, #: <boolean>|null  // Added with LE API v1.11
     }.merge!(forum_data)
-    # TODO: Validate payload
+    # REVIEW: Validate payload
+    check_forum_data_validity(payload)
     _post(path, payload)
 end
 
-# TODO: Update a forum for an org unit.
-# => PUT /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)
+# REVIEW: Update a forum for an org unit.
+# => PUT /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}
+# NOTE: <  LE v 1.10 ignores date filed of the forum_data
+# NOTE: >= LE v 1.11 applies date fields that are sent, otherwise they're
+#       assumed null.
+def update_forum(org_unit_id, forum_id, forum_data)
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/"
+  payload =
+  {
+      'Name' => '', #: <string>,
+      'Description' => #: { <composite:RichText> },
+      {
+          "Text" => "", # <string:plaintext_version_of_text>,
+          "Html" => nil # <string:HTML_formatted_version_of_text>|null
+      },
+      'ShowDescriptionInTopics' => nil, #: <boolean>|null,  // Added with LE API v1.14
+      'StartDate' => nil, #: <string:UTCDateTime>|null,
+      'EndDate' => nil, #: <string:UTCDateTime>|null,
+      'PostStartDate' => nil, #: <string:UTCDateTime>|null,
+      'PostEndDate' => nil, # <string:UTCDateTime>|null,
+      'AllowAnonymous' => false, # <boolean>,
+      'IsLocked' => false,  #: <boolean>,
+      'IsHidden' => false,  #: <boolean>,
+      'RequiresApproval' => '', #: <boolean>,
+      'MustPostToParticipate' => nil, #: <boolean>|null,
+      'DisplayInCalendar' => nil, #: <boolean>|null,  // Added with LE API v1.11
+      'DisplayPostDatesInCalendar' => nil, #: <boolean>|null  // Added with LE API v1.11
+  }.merge!(forum_data)
+  # REVIEW: Validate payload
+  check_forum_data_validity(payload)
+  _put(path, payload)
+# RETURNS: Forum JSON block
+end
 
 ##################
 ## TOPICS: #######
 ##################
 
-# TODO: Delete a particular topic from the provided discussion forum in an org unit.
-# => DELETE /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)
-# TODO: Delete a group restriction for a discussion forum topic.
-# => DELETE /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/groupRestrictions/
+# REVIEW: Delete a particular topic from the provided discussion forum in an org unit.
+# => DELETE /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}
+def delete_topic(org_unit_id, forum_id, topic_id)
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}"
+  _delete(path)
+end
+
+# REVIEW: Delete a group restriction for a discussion forum topic.
+# => DELETE /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/groupRestrictions/
+def delete_topic_group_restriction(org_unit_id, forum_id, topic_id)
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/groupRestrictions/"
+  _delete(path)
+end
+
 # REVIEW: Retrieve topics from the provided discussion forum in an org unit.
-# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/
 def get_forum_topics(org_unit_id, forum_id)
     path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/"
     _get(path)
 end
 
 # REVIEW: Retrieve a particular topic from the provided discussion forum in an org unit.
-# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}
 def get_forum_topic(org_unit_id, forum_id, topic_id)
     path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}"
     _get(path)
 end
 
 # REVIEW: Retrieve the group restrictions for a discussion forum topic.
-# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/groupRestrictions/
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/groupRestrictions/
 def get_forum_topic_group_restrictions(org_unit_id, forum_id, topic_id)
     path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/groupRestrictions/"
     _get(path)
 end
 
-# TODO: Create a new topic for the provided discussion forum in an org unit.
-# => POST /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/
-# TODO: Update an existing topic for the provided discussion forum in an org unit.
-# => PUT /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)
-# TODO: Add a group to the group restriction list for a discussion forum topic.
-# => PUT /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/groupRestrictions/
+def check_create_topic_data_validity(create_topic_data)
+  schema = {
+      'type' => 'object',
+      'required' => %w(Name Description AllowAnonymousPosts StartDate
+                       EndDate UnlockStartDate UnlockEndDate IsHidden
+                       IsLocked RequiresApproval ScoreOutOf IsAutoScore
+                       IncludeNonScoredValues ScoringType MustPostToParticipate
+                       RatingType DisplayInCalendar DisplayUnlockDatesInCalendar),
+      'properties' =>
+      {
+          'Name' => { 'type' => 'string' },
+          'Description' =>
+          {
+            'type' => 'object',
+            'properties' =>
+            {
+              "Content" => { 'type' => "string" },
+              "Type" => { 'type' => "string" }
+            }
+          },
+          'AllowAnonymousPosts' => { 'type' => 'boolean' },
+          'StartDate' => { 'type' => %w(string null) },
+          'EndDate' => { 'type' => %w(string null) },
+          'UnlockStartDate' => { 'type' => %w(string null) },
+          'UnlockEndDate' => { 'type' => %w(string null) },
+          'IsHidden' => { 'type' => 'boolean' },
+          'IsLocked' => { 'type' => 'boolean' },
+          'RequiresApproval' => { 'type' => 'boolean' }, #: <boolean>,
+          'ScoreOutOf' => { 'type' => %w(integer null) },
+          'IsAutoScore' => { 'type' => 'boolean' }, # Added with LE API v1.11
+          'IncludeNonScoredValues' => { 'type' => 'boolean' },
+          'ScoringType' => { 'type' => %w(string null) },
+          'MustPostToParticipate' => { 'type' => 'boolean' }, #: <boolean>,
+          'RatingType' => { 'type' => %w(string null) },
+          'DisplayInCalendar' => { 'type' => %w(boolean null) }, # Added with LE API v1.12
+          'DisplayUnlockDatesInCalendar' => { 'type' => %w(boolean null) } # Added with LE API v1.12
+      }
+  }
+  JSON::Validator.validate!(schema, create_topic_data, validate_schema: true)
+end
+
+# REVIEW: Create a new topic for the provided discussion forum in an org unit.
+# => POST /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/
+def create_forum_topic(org_unit_id, forum_id, create_topic_data)
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/"
+  payload =
+  {
+    "Name" => "", # : <string>,
+    "Description" =>
+    {
+        "Text" => "", # <string:plaintext_version_of_text>,
+        "Html" => nil # <string:HTML_formatted_version_of_text>|null
+    }, # { <composite:RichTextInput> },
+    "AllowAnonymousPosts" => false, # <boolean>,
+    "StartDate" => nil, # <string:UTCDateTime>|null,
+    "EndDate" => nil, # : <string:UTCDateTime>|null,
+    "IsHidden" => false, # : <boolean>,
+    "UnlockStartDate" => nil, # : <string:UTCDateTime>|null,
+    "UnlockEndDate" => nil, # : <string:UTCDateTime>|null,
+    "RequiresApproval" => false, # : <boolean>,
+    "ScoreOutOf" => nil, # : <number>|null,
+    "IsAutoScore" => false, # : <boolean>,
+    "IncludeNonScoredValues" => "", # : <boolean>,
+    "ScoringType" => nil, # : <string:SCORING_T>|null,
+    "IsLocked" => false, # : <boolean>,
+    "MustPostToParticipate" => false, # : <boolean>,
+    "RatingType" => nil, # : <string:RATING_T>|null,
+    "DisplayInCalendar" => nil, # : <boolean>|null,  // Added with LE API v1.12
+    "DisplayUnlockDatesInCalendar" => nil, # : <boolean>|null  // Added with LE API v1.12
+  }.merge!(create_topic_data)
+  check_create_topic_data_validity(payload) # REVIEW: Validity check of topic data
+  _post(path, payload)
+  # RETURNS: Topic JSON data block
+end
+
+# REVIEW: Update an existing topic for the provided discussion forum in an org unit.
+# => PUT /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}
+def update_forum_topic(org_unit_id, forum_id, topic_id, create_topic_data)
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}"
+  payload =
+  {
+    "Name" => "", # : <string>,
+    "Description" =>
+    {
+        "Text" => "", # <string:plaintext_version_of_text>,
+        "Html" => nil # <string:HTML_formatted_version_of_text>|null
+    }, # { <composite:RichTextInput> },
+    "AllowAnonymousPosts" => false, # <boolean>,
+    "StartDate" => nil, # <string:UTCDateTime>|null,
+    "EndDate" => nil, # : <string:UTCDateTime>|null,
+    "IsHidden" => false, # : <boolean>,
+    "UnlockStartDate" => nil, # : <string:UTCDateTime>|null,
+    "UnlockEndDate" => nil, # : <string:UTCDateTime>|null,
+    "RequiresApproval" => false, # : <boolean>,
+    "ScoreOutOf" => nil, # : <number>|null,
+    "IsAutoScore" => false, # : <boolean>,
+    "IncludeNonScoredValues" => "", # : <boolean>,
+    "ScoringType" => nil, # : <string:SCORING_T>|null,
+    "IsLocked" => false, # : <boolean>,
+    "MustPostToParticipate" => false, # : <boolean>,
+    "RatingType" => nil, # : <string:RATING_T>|null,
+    "DisplayInCalendar" => nil, # : <boolean>|null,  // Added with LE API v1.12
+    "DisplayUnlockDatesInCalendar" => nil, # : <boolean>|null  // Added with LE API v1.12
+  }.merge!(create_topic_data)
+  check_create_topic_data_validity(payload) # REVIEW: Validity check of topic data
+  _post(path, payload)
+  # RETURNS: Topic JSON data block
+end
+
+# REVIEW: Add a group to the group restriction list for a discussion forum topic.
+# => PUT /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/groupRestrictions/
+def add_group_to_group_restriction_list(org_unit_id, forum_id, topic_id, group_id)
+  raise ArgumentError, "Argument 'group_id' is not numeric value." unless group_id.is_a? Numeric
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/groupRestrictions/"
+  payload = { "GroupRestriction" => { "GroupId" => group_id } }
+  _put(path, payload)
+  # RETURNS: ??
+end
 
 ##################
 ## POSTS: ########
 ##################
 
-# TODO: Delete a particular post from a discussion forum topic.
-# => DELETE /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)
-# TODO: DELETE /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Rating/MyRating
+# REVIEW: Delete a particular post from a discussion forum topic.
+# => DELETE /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}
+def delete_topic_post(org_unit_id, forum_id, topic_id, post_id)
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}"
+  _delete(path)
+end
+
+# REVIEW: DELETE /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Rating/MyRating
 # => Delete the current user context’s rating for a particular post from a discussion forum topic.
+def delete_current_user_context_post_rating
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Rating/MyRating"
+  _delete(path)
+  # NOTE: Doing so is actually an update, setting the current user's rating
+  #       of a post to null
+end
 
 # REVIEW: Retrieve all posts in a discussion forum topic.
-# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/
 # RETURNS: JSON array of Post data blocks containing the properties for all the post
 def get_forum_topic_posts(org_unit_id, forum_id, topic_id, page_size = 0, page_number = 0,
                           threads_only = nil, thread_id = 0, sort = '')
     path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/?"
-    path += "pageSize=#{page_size}&" unless page_size == 0
-    path += "pageNumber=#{page_number}&" unless page_number == 0
+    path += "pageSize=#{page_size}&" unless page_size.zero?
+    path += "pageNumber=#{page_number}&" unless page_number.zero?
     path += "threadsOnly=#{threads_only}&" unless threads_only.nil?
-    path += "threadId=#{thread_id}&" unless thread_id == 0
+    path += "threadId=#{thread_id}&" unless thread_id.zero?
     path += "sort=#{sort}" unless sort == ''
     _get(path)
     # RETURNS: JSON array of Post data blocks containing the properties for all the post
 end
 
 # REVIEW: Retrieve a particular post in a discussion forum topic.
-# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}
 def get_forum_topic_post(org_unit_id, forum_id, topic_id, post_id)
     path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}"
     _get(path)
@@ -128,15 +325,15 @@ def get_forum_topic_post(org_unit_id, forum_id, topic_id, post_id)
 end
 
 # REVIEW: Retrieve the approval status for a particular post in a discussion forum topic.
-# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Approval
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Approval
 def get_forum_topic_post_approval_status(org_unit_id, forum_id, topic_id, post_id)
     path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Approval"
     _get(path)
     # RETURNS: ApprovalData JSON data block
 end
 
-# TODO: Retrieve the flagged status for a particular post in a discussion forum topic.
-# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Flag
+# REVIEW: Retrieve the flagged status for a particular post in a discussion forum topic.
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Flag
 def get_forum_topic_post_flagged_status(org_unit_id, forum_id, topic_id, post_id)
     path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Flag"
     _get(path)
@@ -144,7 +341,7 @@ def get_forum_topic_post_flagged_status(org_unit_id, forum_id, topic_id, post_id
 end
 
 # REVIEW: Retrieve the rating data for a particular post in a discussion forum topic.
-# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Rating
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Rating
 def get_forum_topic_post_rating_data(org_unit_id, forum_id, topic_id, post_id)
     path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Rating"
     _get(path)
@@ -152,7 +349,7 @@ def get_forum_topic_post_rating_data(org_unit_id, forum_id, topic_id, post_id)
 end
 
 # REVIEW: Retrieve the current user context’s rating data for a particular post in a discussion forum topic.
-# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Rating/MyRating
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Rating/MyRating
 def get_current_user_forum_topic_post_rating_data(org_unit_id, forum_id, topic_id, post_id)
     path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Rating/MyRating"
     _get(path)
@@ -160,7 +357,7 @@ def get_current_user_forum_topic_post_rating_data(org_unit_id, forum_id, topic_i
 end
 
 # REVIEW: Retrieve the current read status for a particular post in a discussion forum topic.
-# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/ReadStatus
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/ReadStatus
 def get_forum_topic_post_read_status(org_unit_id, forum_id, topic_id, post_id)
     path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/ReadStatus"
     _get(path)
@@ -168,7 +365,7 @@ def get_forum_topic_post_read_status(org_unit_id, forum_id, topic_id, post_id)
 end
 
 # REVIEW: Retrieve all the vote data for a particular post in a discussion forum topic.
-# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Votes
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Votes
 def get_forum_topic_post_vote_data(org_unit_id, forum_id, topic_id, post_id)
     path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Votes"
     _get(path)
@@ -176,24 +373,132 @@ def get_forum_topic_post_vote_data(org_unit_id, forum_id, topic_id, post_id)
 end
 
 # REVIEW: Retrieve the current user’s vote data for a particular post in a discussion forum topic.
-# => GET /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Votes/MyVote
+# => GET /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Votes/MyVote
 def get_current_user_forum_topic_post_vote_data(org_unit_id, forum_id, topic_id, post_id)
     path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Votes/MyVote"
     _get(path)
     # RETURNS: UserVoteData JSON data block
 end
 
-# TODO: Create a new post in a discussion forum topic.
-# => POST /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/
-# TODO: Update a particular post in a discussion forum topic.
-# => PUT /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)
-# TODO: Update the approval status of a particular post in a discussion forum topic.
-# => PUT /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Approval
-# TODO: Update the flagged status of a particular post in a discussion forum topic.
-# => PUT /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Flag
-# TODO: Update the current user context’s rating for a particular post in a discussion forum topic.
-# => PUT /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Rating/MyRating
-# TODO: Update the read status of a particular post in a discussion forum topic.
-# => PUT /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/ReadStatus
-# TODO: Update a discussion forum topic post’s vote data for the current user.
-# => PUT /d2l/api/le/(version)/(orgUnitId)/discussions/forums/(forumId)/topics/(topicId)/posts/(postId)/Votes/MyVote
+def check_create_post_data_validity(create_post_data)
+  schema = {
+      'type' => 'object',
+      'required' => %w(ParentPostId Subject Message IsAnonymous),
+      'properties' =>
+      {
+          'ParentPostId' => { 'type' => %w(integer null) },
+          'Subject' => { 'type' => "string" },
+          'Message' =>
+          {
+            'type' => 'object',
+            'properties' =>
+            {
+              "Content" => { 'type' => "string" },
+              "Type" => { 'type' => "string" }
+            }
+          },
+          'IsAnonymous' => { 'type' => 'boolean' }
+      }
+  }
+  JSON::Validator.validate!(schema, create_post_data, validate_schema: true)
+end
+
+# REVIEW: Create a new post in a discussion forum topic.
+# => POST /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/
+# NOTE: No file attachments? Send it normally :)
+# NOTE: File attachments? Send using Multipart/Mixed body conforming to RFC2388
+# RETURNS: Post JSON data block
+def create_topic_post(org_unit_id, forum_id, topic_id, create_post_data, files = [])
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/"
+  payload = {
+    "ParentPostId" => nil, # integer or nil
+    "Subject" => "",
+    "Message" => {
+      "Content" => "",
+      "Type" => "Text|Html"
+    },
+    "IsAnonymous" => false
+  }.merge!(create_post_data)
+  check_create_post_data_validity(payload)
+  if files == []
+    # can do a simple POST request.
+    _post(path, payload)
+  else
+    # Have to do multipart/mixed body custom POST request.
+    _upload_post_data(path, payload, files, "POST")
+  end
+end
+
+# REVIEW: Update a particular post in a discussion forum topic.
+# => PUT /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}
+# RETURNS: Post JSON data block
+def update_topic_post(org_unit_id, forum_id, topic_id, post_id, create_post_data)
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}"
+  payload = {
+    "ParentPostId" => nil, # integer or nil
+    "Subject" => "",
+    "Message" => {
+      "Content" => "",
+      "Type" => "Text|Html"
+    },
+    "IsAnonymous" => false
+  }.merge!(create_post_data)
+  check_create_post_data_validity(payload)
+  _put(path, payload)
+end
+
+# REVIEW: Update the approval status of a particular post in a discussion forum topic.
+# => PUT /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Approval
+# RETURNS: ApprovalData JSON data block
+def update_topic_post_approval_status(org_unit_id, forum_id, topic_id, post_id, is_approved)
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Approval"
+  raise ArgumentError, "Argument 'is_approved' is not a boolean value." unless is_approved == true || is_approved == false
+  payload = { "IsApproved" => is_approved }
+  _put(path, payload)
+end
+
+
+# REVIEW: Update the flagged status of a particular post in a discussion forum topic.
+# => PUT /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Flag
+# RETURNS: FlagData JSON data block
+def update_topic_post_flagged_status(org_unit_id, forum_id, topic_id, post_id, is_flagged)
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Flag"
+  raise ArgumentError, "Argument 'is_flagged' is not a boolean value." unless is_flagged == true || is_flagged == false
+  payload = { "IsFlagged" => is_flagged }
+  _put(path, payload)
+end
+
+# REVIEW: Update the current user context’s rating for a particular post in a discussion forum topic.
+# => PUT /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Rating/MyRating
+# RETURNS: UserRatingData JSON data block
+def update_topic_post_current_user_rating(org_unit_id, forum_id, topic_id, post_id, rating)
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Rating/MyRating"
+  raise ArgumentError, "Argument 'rating' is not a number or null value." unless rating.is_a?(Numeric) || rating.nil?
+  payload = { "Rating" => rating }
+  _put(path, payload)
+end
+
+# REVIEW: Update the read status of a particular post in a discussion forum topic.
+# => PUT /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/ReadStatus
+# RETURNS: ReadStatusData JSON data block
+def update_topic_post_read_status(org_unit_id, forum_id, topic_id, post_id, is_read)
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/ReadStatus"
+  raise ArgumentError, "Argument 'is_read' is not a boolean value." unless is_read == true || is_read == false
+  payload = { "IsRead" => is_read }
+  _put(path, payload)
+end
+
+# REVIEW: Update a discussion forum topic post’s vote data for the current user.
+# => PUT /d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Votes/MyVote
+# RETURNS: ??
+def update_topic_post_current_user_vote_data(org_unit_id, forum_id, topic_id, post_id, vote)
+  path = "/d2l/api/le/#{$le_ver}/#{org_unit_id}/discussions/forums/#{forum_id}/topics/#{topic_id}/posts/#{post_id}/Votes/MyVote"
+  unless vote.is_a? String
+    raise ArgumentError, "Argument 'vote' is not a string value."
+  else
+    payload = {
+      "Vote" => vote
+    }
+    _put(path, payload)
+  end
+end