kinetic_sdk 0.1.1

data/lib/kinetic_sdk/request_ce/lib/submissions.rb

@@ -0,0 +1,215 @@
+module KineticSdk
+  class RequestCe
+
+    # Add a Submission
+    #
+    # @param kapp_slug [String] slug of the Kapp
+    # @param form_slug [String] slug of the Form
+    # @param payload [Hash] payload of the submission
+    #   - +origin+ - Origin ID of the submission to be added
+    #   - +parent+ - Parent ID of the submission to be added
+    #   - +values+ - hash of field values for the submission
+    # @param parameters [Hash] hash of query parameters to append to the URL
+    #   - +include+ - comma-separated list of properties to include in the response
+    #   - +completed+ - signals that the submission should be completed, default is false
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def add_submission(kapp_slug, form_slug, payload={}, parameters={}, headers=default_headers)
+      # initialize "values" if nil
+      payload["values"] = {} if payload["values"].nil?
+      # set origin hash if origin was passed as a string
+      payload["origin"] = { "id" => payload["origin"] } if payload["origin"].is_a? String
+      # set parent hash if parent was passed as a string
+      payload["parent"] = { "id" => payload["parent"] } if payload["parent"].is_a? String
+      # build the uri with the encoded parameters
+      uri = URI.parse("#{@api_url}/kapps/#{kapp_slug}/forms/#{form_slug}/submissions")
+      uri.query = URI.encode_www_form(parameters) unless parameters.empty?
+      # Create the submission
+      info("Adding a submission in the \"#{form_slug}\" Form.")
+      post(uri.to_s, payload, headers)
+    end
+
+    # Add a Submission page
+    #
+    # @param kapp_slug [String] slug of the Kapp
+    # @param form_slug [String] slug of the Form
+    # @param page_name [String] name of the Page
+    # @param payload [Hash] payload of the submission
+    #   - +origin+ - Origin ID of the submission to be added
+    #   - +parent+ - Parent ID of the submission to be added
+    #   - +values+ - hash of field values for the submission
+    # @param parameters [Hash] hash of query parameters to append to the URL
+    #   - +include+ - comma-separated list of properties to include in the response
+    #   - +staged+ - Indicates whether field validations and page advancement should occur, default is false
+    #   - +defer+ - Indicates the submission is for a subform embedded in a parent, default is false
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def add_submission_page(kapp_slug, form_slug, page_name, payload={}, parameters={}, headers=default_headers)
+      # initialize "values" if nil
+      payload["values"] = {} if payload["values"].nil?
+      # set origin hash if origin was passed as a string
+      payload["origin"] = { "id" => payload["origin"] } if payload["origin"].is_a? String
+      # set parent hash if parent was passed as a string
+      payload["parent"] = { "id" => payload["parent"] } if payload["parent"].is_a? String
+      # add the page name to the parameters
+      parameters["page"] = page_name
+      # build the uri with the encoded parameters
+      uri = URI.parse("#{@api_url}/kapps/#{kapp_slug}/forms/#{form_slug}/submissions")
+      uri.query = URI.encode_www_form(parameters)
+      # Create the submission
+      info("Adding a submission page in the \"#{form_slug}\" Form.")
+      post(uri.to_s, payload, headers)
+    end
+
+    # Patch a new Submission
+    #
+    # @param kapp_slug [String] slug of the Kapp
+    # @param form_slug [String] slug of the Form
+    # @param payload [Hash] payload of the submission
+    #   - +origin+ - Origin ID of the submission to be patched
+    #   - +parent+ - Parent ID of the submission to be patched
+    #   - +values+ - hash of field values for the submission
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def patch_new_submission(kapp_slug, form_slug, payload={}, headers=default_headers)
+      # set the currentPage hash if currentPage was passed as a string
+      payload["currentPage"] = { "name" => payload["currentPage"] } if payload["currentPage"].is_a? String
+      # initialize "values" if nil
+      payload["values"] = {} if payload["values"].nil?
+      # set origin hash if origin was passed as a string
+      payload["origin"] = { "id" => payload["origin"] } if payload["origin"].is_a? String
+      # set parent hash if parent was passed as a string
+      payload["parent"] = { "id" => payload["parent"] } if payload["parent"].is_a? String
+      # Create the submission
+      info("Patching a submission in the \"#{form_slug}\" Form.")
+      patch("#{@api_url}/kapps/#{kapp_slug}/forms/#{form_slug}/submissions", payload, headers)
+    end
+
+    # Patch an existing Submission
+    #
+    # @param submission_id [String] id of the Submission
+    # @param payload [Hash] payload of the submission
+    #   - +origin+ - Origin ID of the submission to be patched
+    #   - +parent+ - Parent ID of the submission to be patched
+    #   - +values+ - hash of field values for the submission
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def patch_existing_submission(submission_id, payload={}, headers=default_headers)
+      # set the currentPage hash if currentPage was passed as a string
+      payload["currentPage"] = { "name" => payload["currentPage"] } if payload["currentPage"].is_a? String
+      # initialize "values" if nil
+      payload["values"] = {} if payload["values"].nil?
+      # set origin hash if origin was passed as a string
+      payload["origin"] = { "id" => payload["origin"] } if payload["origin"].is_a? String
+      # set parent hash if parent was passed as a string
+      payload["parent"] = { "id" => payload["parent"] } if payload["parent"].is_a? String
+      # Create the submission
+      info("Patching a submission with id \"#{submission_id}\"")
+      patch("#{@api_url}/submissions/#{submission_id}", payload, headers)
+    end
+
+    # Find all Submissions for a form.
+    #
+    # This method will process pages of form submissions and internally
+    # concatenate the results into a single array.
+    #
+    # Warning - using this method can cause out of memory errors on large
+    #           result sets.
+    #
+    # @param kapp_slug [String] slug of the Kapp
+    # @param form_slug [String] slug of the Form
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_all_form_submissions(kapp_slug, form_slug, params={}, headers=default_headers)
+      info("Finding submissions for the \"#{form_slug}\" Form.")
+      # Make the initial request of pages submissions
+      response = find_form_submissions(kapp_slug, form_slug, params, headers)
+      # Build the Messages Array
+      messages = response.content["messages"]
+      # Build Submissions Array
+      submissions = response.content["submissions"]
+      # if a next page token exists, keep retrieving submissions and add them to the results
+      while (!response.content["nextPageToken"].nil?)
+        params['pageToken'] = response.content["nextPageToken"]
+        response = find_form_submissions(kapp_slug, form_slug, params, headers)
+        # concat the messages
+        messages.concat(response.content["messages"] || [])
+        # concat the submissions
+        submissions.concat(response.content["submissions"] || [])
+      end
+      final_content = { "messages" => messages, "submissions" => submissions, "nextPageToken" => nil }
+      # Return the results
+      response.content=final_content
+      response.content_string=final_content.to_json
+      response
+    end
+
+    # Find a page of Submissions for a form.
+    #
+    # The page offset can be defined by passing in the "pageToken" parameter,
+    # indicating the value of the token that will represent the first
+    # submission in the result set.  If not provided, the first page of
+    # submissions will be retrieved.
+    #
+    # @param kapp_slug [String] slug of the Kapp
+    # @param form_slug [String] slug of the Form
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    #   - +pageToken+ - used for paginated results
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_form_submissions(kapp_slug, form_slug, params={}, headers=default_headers)
+      # Get next page token
+      token = params["pageToken"]
+      if token.nil?
+        info("Finding first page of submissions for the \"#{form_slug}\" Form.")
+      else
+        info("Finding page of submissions starting with token \"#{token}\" for the \"#{form_slug}\" Form.")
+      end
+
+      # Build Submission URL
+      url = "#{@api_url}/kapps/#{kapp_slug}/forms/#{form_slug}/submissions"
+      # Return the response
+      get(url, params, headers)
+    end
+
+    # Find a page of Submissions for a kapp.
+    #
+    # The page offset can be defined by passing in the "pageToken" parameter,
+    # indicating the value of the token that will represent the first
+    # submission in the result set.  If not provided, the first page of
+    # submissions will be retrieved.
+    #
+    # @param kapp_slug [String] slug of the Kapp
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    #   - +pageToken+ - used for paginated results
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_kapp_submissions(kapp_slug, params={}, headers=default_headers)
+      # Get next page token
+      token = params["pageToken"]
+      if token.nil?
+        info("Finding first page of submissions for the \"#{kapp_slug}\" Kapp.")
+      else
+        info("Finding page of submissions starting with token \"#{token}\" for the \"#{kapp_slug}\" Kapp.")
+      end
+
+      # Build Submission URL
+      url = "#{@api_url}/kapps/#{kapp_slug}/submissions"
+      # Return the response
+      get(url, params, headers)
+    end
+
+    # Update a submission
+    #
+    # @param submission_id [String] String value of the Submission Id (UUID)
+    # @param body [Hash] submission properties to update
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def update_submission(submission_id, body={}, headers=default_headers)
+      info("Updating Submission \"#{submission_id}\"")
+      put("#{@api_url}/submissions/#{encode(submission_id)}", body, headers)
+    end
+
+  end
+end

data/lib/kinetic_sdk/request_ce/lib/system_api.rb

@@ -0,0 +1,69 @@
+module KineticSdk
+  class RequestCe
+
+    # Add a new Space
+    #
+    # @param name [String] name of the Space
+    # @param slug [String] value that is used in URL routes to identity the Space
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def add_space(name, slug, headers=default_headers)
+      payload = { "name" => name, "slug" => slug }
+      info("Creating Space \"#{name}\" with slug \"#{slug}\"")
+      post("#{@api_url}/spaces", payload, headers)
+    end
+
+
+    # Delete a Space
+    #
+    # @param slug [String] slug of the space
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def delete_space(slug, headers=default_headers)
+      info("Deleting Space \"#{slug}\"")
+      delete("#{@api_url}/spaces/#{slug}", headers)
+    end
+
+    # Find all spaces
+    #
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_spaces(params={}, headers=default_headers)
+      info("Finding Spaces")
+      get("#{@api_url}/spaces", params, headers)
+    end
+
+    # Find the space (System API)
+    #
+    # @param slug [String] slug of the space
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_space_in_system(slug, params={}, headers=default_headers)
+      info("Retrieving Space \"#{slug}\"")
+      get("#{@api_url}/spaces/#{slug}", params, headers)
+    end
+
+    # Update the space (System API)
+    #
+    # @param slug [String] slug of the space
+    # @param body [Hash] updated properties of the space
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def update_space_in_system(slug, body, headers=default_headers)
+      info("Updating Space \"#{slug}\"")
+      put("#{@api_url}/spaces/#{slug}", body, headers)
+    end
+
+    # Reset the license count (System API)
+    #
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def reset_license_count(headers=default_headers)
+      info("Resetting License Count")
+      put("#{@api_url}/license/reset", {}, headers)
+    end
+
+  end
+end

data/lib/kinetic_sdk/request_ce/lib/teams.rb

@@ -0,0 +1,113 @@
+require 'digest/md5'
+
+module KineticSdk
+  class RequestCe
+
+    # Add an attribute to a team
+    #
+    # @param team_name [String] the team name
+    # @param attribute_name [String] the attribute name
+    # @param attribute_value [String] the attribute value
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def add_team_attribute(team_name, attribute_name, attribute_value, headers=default_headers)
+      # first find the team
+      response = find_team(team_name, { "include" => "attributes"}, headers)
+      team = response.content["team"]
+      attributes = team["attributes"]
+      # either add or update the attribute value
+      exists = false
+      attributes.each do |attribute|
+        info("Attribute: #{attribute.inspect}")
+        # if the attribute already exists, update it
+        if attribute["name"] == attribute_name
+          attribute["values"] = [ attribute_value ]
+          exists = true
+        end
+      end
+      # add the attribute if it didn't exist
+      attributes.push({
+        "name" => attribute_name,
+        "values" => [ attribute_value ]
+        }) unless exists
+
+      # set the updated attributes list
+      body = { "attributes" => attributes }
+      if exists
+        info("Updating attribute \"#{attribute_name}\" = \"#{attribute_value}\" in the \"#{team_name}\" team.")
+      else
+        info("Adding attribute \"#{attribute_name}\" = \"#{attribute_value}\" to the \"#{team_name}\" team.")
+      end
+      # Update the space
+      put("#{@api_url}/teams/#{team['slug']}", body, headers)
+    end
+
+    # Add a Team
+    #
+    # @param team_properties [Hash] the property values for the team
+    #   - +name+ - Name of the team to be added
+    #   - +description+ - Description of the Team to be added
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def add_team(team_properties, headers=default_headers)
+      raise StandardError.new "Team properties is not valid, must be a Hash." unless team_properties.is_a? Hash
+      info("Adding Team \"#{team_properties['name']}\"")
+      post("#{@api_url}/teams", team_properties, headers)
+    end
+
+    # Add a team membership
+    #
+    # @param team_name [String] the team name
+    # @param username [String] the username to add to the team
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def add_team_membership(team_name, username, headers=default_headers)
+      body = {
+        "team" => {
+          "name" => team_name
+        },
+        "user" => {
+          "username" => username
+        }
+      }
+      info("Adding user: \"#{username}\" to \"#{team_name}\" team")
+      post("#{@api_url}/memberships/", body, headers)
+    end
+
+    # Find teams
+    #
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_teams(params={}, headers=default_headers)
+      info("Finding Teams")
+      get("#{@api_url}/teams", params, headers)
+    end
+
+    # Export a team
+    #
+    # @param team_name [String] the team name
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def export_team(team_name, headers=default_headers)
+      team_slug = Digest::MD5.hexdigest(team_name)
+      info("Exporting the \"#{team_name}\" (#{team_slug}) Team.")
+      get("#{@api_url}/teams/#{team_slug}", { 'export' => true}, headers)
+    end
+
+    # Find the team
+    #
+    # Attributes
+    #
+    # @param team_name [String] the team name
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_team(team_name, params={}, headers=default_headers)
+      team_slug = Digest::MD5.hexdigest(team_name)
+      info("Finding the \"#{team_name}\" (#{team_slug}) Team.")
+      get("#{@api_url}/teams/#{team_slug}", params, headers)
+    end
+
+  end
+end

data/lib/kinetic_sdk/request_ce/lib/users.rb

@@ -0,0 +1,245 @@
+module KineticSdk
+  class RequestCe
+
+    # Add a user in a space.
+    #
+    # If the SDK was initialized as a System user, the space_slug property
+    # must be provided in the user hash.
+    #
+    # If the SDK was initialized as a Space user, the space_slug property
+    # is ignored.
+    #
+    # @param user [Hash] hash of user properties
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    #
+    # Example
+    #
+    #     add_user({
+    #       "space_slug" => "bar",
+    #       "username" => "foo",
+    #       "password" => "bar",
+    #       "displayName" => "Foo",
+    #       "email" => "foo@bar.com",
+    #       "enabled" => true,
+    #       "preferredLocale" => "en_US",
+    #       "spaceAdmin" => false
+    #     })
+    #
+    def add_user(user, headers=default_headers)
+      if !@space_slug.nil?
+        info("Adding user \"#{user['username']}\" for Space \"#{@space_slug}\" as system user.")
+        post("#{@api_url}/users", user, headers)
+      elsif !user['space_slug'].nil?
+        space_slug = user.delete('space_slug')
+        info("Adding user \"#{user['username']}\" for Space \"#{space_slug}\".")
+        post("#{@api_url}/spaces/#{space_slug}/users", user, headers)
+      else
+        raise StandardError.new "The space slug must be supplied to add the user."
+      end
+    end
+
+    # Delete a user in a space.
+    #
+    # If the SDK was initialized as a System user, the space_slug property
+    # must be provided in the user hash.
+    #
+    # If the SDK was initialized as a Space user, the space_slug property
+    # is ignored.
+    #
+    # @param user [Hash] properties of the user
+    #   - +space_slug+ - only used when initialized as a System user
+    #   - +username+ - username of the user
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    #
+    # Example
+    #
+    #     delete_user({
+    #       "username" => "user1"
+    #     })
+    #
+    # Example
+    #
+    #     delete_user({
+    #       "space_slug" => "foo",
+    #       "username" => "user1"
+    #     })
+    #
+    def delete_user(user, headers=default_headers)
+      if !@space_slug.nil?
+        info("Deleting user \"#{user['username']}\" for Space \"#{@space_slug}\" as system user.")
+        delete("#{@api_url}/users/#{encode(user['username'])}", headers)
+      elsif !user['space_slug'].nil?
+        space_slug = user.delete('space_slug')
+        info("Deleting user \"#{user['username']}\" for Space \"#{space_slug}\".")
+        delete("#{@api_url}/spaces/#{space_slug}/users/#{encode(user['username'])}", headers)
+      else
+        raise StandardError.new "The space slug must be supplied to add the user."
+      end
+    end
+
+    # Add an attribute value to the user, or update an attribute if it already exists
+    #
+    # @param username [String] username of the user
+    # @param attribute_name [String] name of the attribute
+    # @param attribute_value [String] value of the attribute
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def add_user_attribute(username, attribute_name, attribute_value, headers=default_headers)
+      # first find the user
+      response = find_user(username, { "include" => "attributes"}, headers)
+      user = response.content["user"]
+      attributes = user["attributes"]
+      # either add or update the attribute value
+      exists = false
+      attributes.each do |attribute|
+        # if the attribute already exists, update it
+        if attribute["name"] == attribute_name
+          attribute["values"] = attribute_value.is_a?(Array) ? attribute_value : [ attribute_value ]
+          exists = true
+        end
+      end
+      # add the attribute if it didn't exist
+      attributes.push({
+        "name" => attribute_name,
+        "values" => attribute_value.is_a?(Array) ? attribute_value : [ attribute_value ]
+        }) unless exists
+
+      # set the updated attributes list
+      body = { "attributes" => attributes }
+      if exists
+        info("Updating attribute \"#{attribute_name}\" on user \"#{username}\".")
+      else
+        info("Adding attribute \"#{attribute_name}\" to user \"#{username}\".")
+      end
+      # Update the user
+      put("#{@api_url}/users/#{encode(username)}", body, headers)
+    end
+
+    # Adds an attribute value to an attribute.
+    #
+    # @param username [String] username of the user
+    # @param attribute_name [String] name of the attribute
+    # @param attribute_value [String] value of the attribute
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def add_user_attribute_value(username, attribute_name, attribute_value, headers=default_headers)
+      # first find the user
+      response = find_user(username, { "include" => "attributes"}, headers)
+      user = response.content["user"]
+      attributes = user["attributes"]
+      # either add or update the attribute value
+      exists = false
+      attributes.each do |attribute|
+        # if the attribute already exists, update it
+        if attribute["name"] == attribute_name
+          if attribute_value.is_a?(Array)
+            attribute["values"].concat(attribute_value)
+          else 
+            attribute["values"] << attribute_value
+          end
+          attribute["values"].uniq!
+          exists = true
+        end
+      end
+      # add the attribute if it didn't exist
+      attributes.push({
+        "name" => attribute_name,
+        "values" => attribute_value.is_a?(Array) ? attribute_value : [ attribute_value ]
+        }) unless exists
+
+      # set the updated attributes list
+      body = { "attributes" => attributes }
+      if exists
+        info("Updating attribute \"#{attribute_name}\" on user \"#{username}\".")
+      else
+        info("Adding attribute \"#{attribute_name}\" to user \"#{username}\".")
+      end
+      # Update the user
+      put("#{@api_url}/users/#{encode(username)}", body, headers)
+    end
+
+    # Find all users
+    #
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_users(params={}, headers=default_headers)
+      info("Finding Users \"#{username}\"")
+      get("#{@api_url}/users", params, headers)
+    end
+
+    # Find the user
+    #
+    # @param username [String] username of the user
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_user(username, params={}, headers=default_headers)
+      info("Finding User \"#{username}\"")
+      get("#{@api_url}/users/#{encode(username)}", params, headers)
+    end
+
+    # Update a user in a space.
+    #
+    # If the SDK was initialized as a System user, the space_slug property
+    # must be provided in the user hash.
+    #
+    # If the SDK was initialized as a Space user, the space_slug property
+    # is ignored.
+    #
+    # @param username [String] username of the user to update
+    # @param user [Hash] user properties to update
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    #
+    # Example
+    #
+    #     update_user("xyz", {
+    #       "space_slug" => "bar",
+    #       "username" => "foo",
+    #       "password" => "bar",
+    #       "displayName" => "Foo",
+    #       "email" => "foo@bar.com",
+    #       "enabled" => true,
+    #       "preferredLocale" => "en_US",
+    #       "spaceAdmin" => false
+    #     })
+    #
+    def update_user(username, user, headers=default_headers)
+      if !@space_slug.nil?
+        info("Updating user \"#{username}\" for Space \"#{@space_slug}\" as system user.")
+        put("#{@api_url}/users/#{encode(username)}", user, headers)
+      elsif !user['space_slug'].nil?
+        space_slug = user.delete('space_slug')
+        info("Updating user \"#{username}\" for Space \"#{space_slug}\".")
+        put("#{@api_url}/spaces/#{space_slug}/users/#{encode(username)}", user, headers)
+      else
+        raise StandardError.new "The space slug must be supplied to update the user."
+      end
+    end
+
+    # Generate Password Reset Token.
+    #
+    # @param username [String] username of the user
+    # @param body [Hash] properties
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def generate_password_token(username, body={}, headers=default_headers)
+      info("Generating PW Token for \"#{username}\"")
+      post("#{@api_url}/users/#{encode(username)}/passwordResetToken", body, headers)
+    end
+
+    # Find the current user
+    #
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def me(params={}, headers=default_headers)
+      info("Finding Me")
+      get("#{@api_url}/me", params, headers)
+    end
+
+  end
+end