kinetic_sdk 0.1.1 → 1.0.0

data/lib/kinetic_sdk/{request_ce → core}/lib/datastore_form.rb

@@ -1,5 +1,5 @@
 module KineticSdk
-  class RequestCe
+  class Core
 
     # Add a Datastore Form
     #
@@ -20,7 +20,7 @@ module KineticSdk
     # @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_datastore_form(form_properties={}, headers=default_headers)
-      info("Adding the \"#{form_properties['name']}\" Form.")
+      @logger.info("Adding the \"#{form_properties['name']}\" Form.")
       post("#{@api_url}/datastore/forms", form_properties, headers)
     end
 
@@ -30,7 +30,7 @@ module KineticSdk
     # @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_datastore_form(form_slug, headers=default_headers)
-      info("Deleting the \"#{form_slug}\" Datastore Form")
+      @logger.info("Deleting the \"#{form_slug}\" Datastore Form")
       delete("#{@api_url}/datastore/forms/#{form_slug}", headers)
     end
 
@@ -40,7 +40,7 @@ module KineticSdk
     # @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_datastore_form(form_slug, headers=default_headers)
-      info("Exporting the \"#{form_slug}\" Datastore Form.")
+      @logger.info("Exporting the \"#{form_slug}\" Datastore Form.")
       get("#{@api_url}/datastore/forms/#{form_slug}", { 'export' => true }, headers)
     end
 
@@ -50,7 +50,7 @@ module KineticSdk
     # @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_datastore_forms(params={}, headers=default_headers)
-      info("Finding Forms.")
+      @logger.info("Finding Forms.")
       get("#{@api_url}/datastore/forms", params, headers)
     end
 
@@ -61,7 +61,7 @@ module KineticSdk
     # @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_datastore_form(form_slug, params={}, headers=default_headers)
-      info("Finding the \"#{form_slug}\" Datastore Form")
+      @logger.info("Finding the \"#{form_slug}\" Datastore Form")
       get("#{@api_url}/datastore/forms/#{form_slug}", params, headers)
     end
 
@@ -85,7 +85,7 @@ module KineticSdk
     # @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_datastore_form(form_slug, properties={}, headers=default_headers)
-      info("Updating the \"#{form_slug}\" Datastore Form.")
+      @logger.info("Updating the \"#{form_slug}\" Datastore Form.")
       put("#{@api_url}/datastore/forms/#{form_slug}", properties, headers)
     end
 
@@ -102,7 +102,7 @@ module KineticSdk
           "indexes" => indexes
         }
       }
-      info("Building indexes for the \"#{form_slug}\" Datastore Form.")
+      @logger.info("Building indexes for the \"#{form_slug}\" Datastore Form.")
       post("#{@api_url}/datastore/forms/#{form_slug}/backgroundJobs", payload, headers)
     end
 

data/lib/kinetic_sdk/{request_ce → core}/lib/datastore_submissions.rb

@@ -1,5 +1,5 @@
 module KineticSdk
-  class RequestCe
+  class Core
 
     # Add a Datastore Submission
     #
@@ -18,7 +18,7 @@ module KineticSdk
       # 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("Adding a submission in the \"#{form_slug}\" Datastore Form.")
+      @logger.info("Adding a submission in the \"#{form_slug}\" Datastore Form.")
       post("#{@api_url}/datastore/forms/#{form_slug}/submissions", payload, headers)
     end
 
@@ -40,7 +40,7 @@ module KineticSdk
       # 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("Adding a submission page in the \"#{form_slug}\" Datastore Form.")
+      @logger.info("Adding a submission page in the \"#{form_slug}\" Datastore Form.")
       post("#{@api_url}/datastore/forms/#{form_slug}/submissions?page=#{encode(page_name)}", payload, headers)
     end
 
@@ -63,7 +63,7 @@ module KineticSdk
       # 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.")
+      @logger.info("Patching a submission in the \"#{form_slug}\" Form.")
       patch("#{@api_url}/datastore/forms/#{form_slug}/submissions", payload, headers)
     end
 
@@ -80,7 +80,7 @@ module KineticSdk
     # @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_datastore_submissions(form_slug, params={}, headers=default_headers)
-      info("Finding submissions for the \"#{form_slug}\" Datastore Form.")
+      @logger.info("Finding submissions for the \"#{form_slug}\" Datastore Form.")
       # Make the initial request of pages submissions
       response = find_form_datastore_submissions(form_slug, params, headers)
       # Build the Messages Array
@@ -119,9 +119,9 @@ module KineticSdk
       # Get next page token
       token = params["pageToken"]
       if token.nil?
-        info("Finding first page of submissions for the \"#{form_slug}\" Datastore.")
+        @logger.info("Finding first page of submissions for the \"#{form_slug}\" Datastore.")
       else
-        info("Finding page of submissions starting with token \"#{token}\" for the \"#{form_slug}\" Form.")
+        @logger.info("Finding page of submissions starting with token \"#{token}\" for the \"#{form_slug}\" Form.")
       end
 
       # Build Submission URL
@@ -130,6 +130,17 @@ module KineticSdk
       get(url, params, headers)
     end
 
+    # Find a Datastore submission
+    #
+    # @param submission_id [String] String value of the Submission Id (UUID)
+    # @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_datastore_submission(submission_id, params={}, headers=default_headers)
+      @logger.info("Finding Datastore Submission \"#{submission_id}\"")
+      get("#{@api_url}/datastore/submissions/#{encode(submission_id)}", params, headers)
+    end
+
 
     # Update a Datastore submission
     #
@@ -138,7 +149,7 @@ module KineticSdk
     # @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_datastore_submission(submission_id, body={}, headers=default_headers)
-      info("Updating Datastore Submission \"#{submission_id}\"")
+      @logger.info("Updating Datastore Submission \"#{submission_id}\"")
       put("#{@api_url}/datastore/submissions/#{encode(submission_id)}", body, headers)
     end
 
@@ -149,7 +160,7 @@ module KineticSdk
     # @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_datastore_submission(submission_id, headers=default_headers)
-      info("Deleting Datastore Submission \"#{submission_id}\"")
+      @logger.info("Deleting Datastore Submission \"#{submission_id}\"")
       delete("#{@api_url}/datastore/submissions/#{encode(submission_id)}", headers)
     end
 

data/lib/kinetic_sdk/{request_ce → core}/lib/form.rb

@@ -1,5 +1,5 @@
 module KineticSdk
-  class RequestCe
+  class Core
 
     # Add a Form
     #
@@ -21,7 +21,7 @@ module KineticSdk
     # @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_form(kapp_slug, form_properties={}, headers=default_headers)
-      info("Adding the \"#{form_properties['name']}\" Form.")
+      @logger.info("Adding the \"#{form_properties['name']}\" Form.")
       post("#{@api_url}/kapps/#{kapp_slug}/forms", form_properties, headers)
     end
 
@@ -32,7 +32,7 @@ module KineticSdk
     # @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_form(kapp_slug, form_slug, headers=default_headers)
-      info("Deleting the \"#{form_slug}\" Form in the \"#{kapp_slug}\" Kapp.")
+      @logger.info("Deleting the \"#{form_slug}\" Form in the \"#{kapp_slug}\" Kapp.")
       delete("#{@api_url}/kapps/#{kapp_slug}/forms/#{form_slug}", headers)
     end
 
@@ -43,7 +43,7 @@ module KineticSdk
     # @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_form(kapp_slug, form_slug, headers=default_headers)
-      info("Exporting the \"#{form_slug}\" Form in the \"#{kapp_slug}\" Kapp.")
+      @logger.info("Exporting the \"#{form_slug}\" Form in the \"#{kapp_slug}\" Kapp.")
       get("#{@api_url}/kapps/#{kapp_slug}/forms/#{form_slug}", { 'export' => true }, headers)
     end
 
@@ -54,7 +54,7 @@ module KineticSdk
     # @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_forms(kapp_slug, params={}, headers=default_headers)
-      info("Finding Forms.")
+      @logger.info("Finding Forms.")
       get("#{@api_url}/kapps/#{kapp_slug}/forms", params, headers)
     end
 
@@ -66,7 +66,7 @@ module KineticSdk
     # @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(kapp_slug, form_slug, params={}, headers=default_headers)
-      info("Finding the \"#{form_slug}\" Form in the \"#{kapp_slug}\" Kapp.")
+      @logger.info("Finding the \"#{form_slug}\" Form in the \"#{kapp_slug}\" Kapp.")
       get("#{@api_url}/kapps/#{kapp_slug}/forms/#{form_slug}", params, headers)
     end
 
@@ -91,7 +91,7 @@ module KineticSdk
     # @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_form(kapp_slug, form_slug, properties={}, headers=default_headers)
-      info("Updating the \"#{form_slug}\" Form in the \"#{kapp_slug}\" Kapp.")
+      @logger.info("Updating the \"#{form_slug}\" Form in the \"#{kapp_slug}\" Kapp.")
       put("#{@api_url}/kapps/#{kapp_slug}/forms/#{form_slug}", properties, headers)
     end
 

data/lib/kinetic_sdk/{request_ce → core}/lib/form_types.rb

@@ -1,5 +1,5 @@
 module KineticSdk
-  class RequestCe
+  class Core
 
     # Add a form type on a Kapp
     #
@@ -10,7 +10,7 @@ module KineticSdk
     # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
     def add_form_type_on_kapp(kapp_slug, body, headers=default_headers)
       raise StandardError.new "Form Type properties is not valid, must be a Hash." unless body.is_a? Hash
-      info("Adding Form Type \"#{body['name']}\" for \"#{kapp_slug}\" kapp")
+      @logger.info("Adding Form Type \"#{body['name']}\" for \"#{kapp_slug}\" kapp")
       post("#{@api_url}/kapps/#{kapp_slug}/formTypes", body, headers)
     end
 
@@ -21,7 +21,7 @@ module KineticSdk
     # @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_form_type(kapp_slug, name, headers=default_headers)
-      info("Deleting form type \"#{name}\" from \"#{kapp_slug}\" kapp")
+      @logger.info("Deleting form type \"#{name}\" from \"#{kapp_slug}\" kapp")
       delete("#{@api_url}/kapps/#{kapp_slug}/formTypes/#{encode(name)}", headers)
     end
 
@@ -43,7 +43,7 @@ module KineticSdk
     # @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_types_on_kapp(kapp_slug, params={}, headers=default_headers)
-      info("Finding Form Types for \"#{kapp_slug}\" kapp")
+      @logger.info("Finding Form Types for \"#{kapp_slug}\" kapp")
       get("#{@api_url}/kapps/#{kapp_slug}/formTypes", params, headers)
     end
 

data/lib/kinetic_sdk/{request_ce → core}/lib/jwt.rb

@@ -1,7 +1,7 @@
 module KineticSdk
-  class RequestCe
+  class Core
 
-    # Gets an authentication code
+    # Gets an authentication token
     #
     # @param client_id [String] the oauth client id
     # @param client_secret [String] the oauth client secret
@@ -11,7 +11,7 @@ module KineticSdk
       # retrieve the jwt code
       jwt_code = jwt_code(client_id, headers)
       # retrieve the jwt token
-      info("Retrieving JWT authorization token")
+      @logger.info("Retrieving JWT authorization token")
       url = "#{@server}/app/oauth/token?grant_type=authorization_code&response_type=token&client_id=#{client_id}&code=#{jwt_code}"
       token_headers = header_accept_json.merge(header_basic_auth(client_id, client_secret))
       response = post(url, {}, token_headers, 0)
@@ -33,7 +33,7 @@ module KineticSdk
     # @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 jwt_code(client_id, headers=default_headers)
-      info("Retrieving JWT authorization code")
+      @logger.info("Retrieving JWT authorization code")
       url = "#{@server}/app/oauth/authorize?grant_type=authorization_code&response_type=code&client_id=#{client_id}"
       response = post(url, {}, headers, -1)
 

data/lib/kinetic_sdk/{request_ce → core}/lib/kapp.rb

@@ -1,5 +1,5 @@
 module KineticSdk
-  class RequestCe
+  class Core
 
     # Add a Kapp
     #
@@ -22,7 +22,7 @@ module KineticSdk
         "name" => kapp_name,
         "slug" => kapp_slug
       })
-      info("Adding the \"#{kapp_name}\" Kapp.")
+      @logger.info("Adding the \"#{kapp_name}\" Kapp.")
       post("#{@api_url}/kapps", properties, headers)
     end
 
@@ -32,7 +32,7 @@ module KineticSdk
     # @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_kapp(kapp_slug, headers=default_headers)
-      info("Deleting the \"#{kapp_slug}\" Kapp.")
+      @logger.info("Deleting the \"#{kapp_slug}\" Kapp.")
       delete("#{@api_url}/kapps/#{kapp_slug}", headers)
     end
 
@@ -42,7 +42,7 @@ module KineticSdk
     # @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_kapp(kapp_slug, headers=default_headers)
-      info("Exporting the \"#{kapp_slug}\" Kapp.")
+      @logger.info("Exporting the \"#{kapp_slug}\" Kapp.")
       get("#{@api_url}/kapps/#{kapp_slug}", { 'export' => true }, headers)
     end
 
@@ -52,7 +52,7 @@ module KineticSdk
     # @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_kapps(params={}, headers=default_headers)
-      info("Finding Kapps.")
+      @logger.info("Finding Kapps.")
       get("#{@api_url}/kapps", params, headers)
     end
 
@@ -63,7 +63,7 @@ module KineticSdk
     # @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(kapp_slug, params={}, headers=default_headers)
-      info("Finding Kapp \"#{kapp_slug}\"")
+      @logger.info("Finding Kapp \"#{kapp_slug}\"")
       get("#{@api_url}/kapps/#{kapp_slug}", params, headers)
     end
 
@@ -85,7 +85,7 @@ module KineticSdk
     # @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_kapp(kapp_slug, properties={}, headers=default_headers)
-      info("Updating the \"#{kapp_slug}\" Kapp.")
+      @logger.info("Updating the \"#{kapp_slug}\" Kapp.")
       put("#{@api_url}/kapps/#{kapp_slug}", properties, headers)
     end
 

data/lib/kinetic_sdk/{request_ce → core}/lib/meta.rb

@@ -1,12 +1,12 @@
 module KineticSdk
-  class RequestCe
+  class Core
 
-    # Retrieve Request CE application version
+    # Retrieve Core application version
     #
     # @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 app_version(headers=default_headers)
-      info("Retrieving Request CE application version.")
+      @logger.info("Retrieving Core application version.")
       get("#{@api_url}/version", {}, headers)
     end
 

data/lib/kinetic_sdk/{request_ce → core}/lib/oauth.rb

@@ -1,5 +1,5 @@
 module KineticSdk
-  class RequestCe
+  class Core
 
     # Add an OAuth client
     #
@@ -7,7 +7,7 @@ module KineticSdk
     # @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_oauth_client(options, headers=default_headers)
-      info("Adding the \"#{options['clientId']}\" OAuth client")
+      @logger.info("Adding the \"#{options['clientId']}\" OAuth client")
       post("#{@api_url}/oauthClients", options, headers)
     end
 
@@ -18,7 +18,7 @@ module KineticSdk
     # @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_oauth_client(client_id, params={}, headers=default_headers)
-      info("Finding OAuth Client \"#{client_id}\"")
+      @logger.info("Finding OAuth Client \"#{client_id}\"")
       get("#{@api_url}/oauthClients/#{encode(client_id)}", params, headers)
     end
 
@@ -29,7 +29,7 @@ module KineticSdk
     # @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_oauth_client(client_id, options, headers=default_headers)
-      info("Updating the \"#{client_id}\" OAuth client")
+      @logger.info("Updating the \"#{client_id}\" OAuth client")
       put("#{@api_url}/oauthClients/#{encode(client_id)}", options, headers)
     end
 

data/lib/kinetic_sdk/{request_ce → core}/lib/security_policy_definitions.rb

@@ -1,5 +1,5 @@
 module KineticSdk
-  class RequestCe
+  class Core
 
     # Add a Space security policy definition
     #
@@ -11,7 +11,7 @@ module KineticSdk
     # @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_security_policy_definition(body, headers=default_headers)
-      info("Adding Space Security Policy Definition \"#{body['name']}\".")
+      @logger.info("Adding Space Security Policy Definition \"#{body['name']}\".")
       # Create the space security policy definition
       post("#{@api_url}/securityPolicyDefinitions", body, headers)
     end
@@ -22,7 +22,7 @@ module KineticSdk
     # @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_security_policy_definition(name, headers=default_headers)
-      info("Deleting Space Security Policy Definition \"#{name}\".")
+      @logger.info("Deleting Space Security Policy Definition \"#{name}\".")
       # Delete the space security policy definition
       delete("#{@api_url}/securityPolicyDefinitions/#{encode(name)}", headers)
     end
@@ -43,7 +43,7 @@ module KineticSdk
     # @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_security_policy_definitions(params={}, headers=default_headers)
-      info("Finding Space Security Policy Definitions.")
+      @logger.info("Finding Space Security Policy Definitions.")
       get("#{@api_url}/securityPolicyDefinitions", params, headers)
     end
 
@@ -54,7 +54,7 @@ module KineticSdk
     # @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_security_policy_definition(name, params={}, headers=default_headers)
-      info("Finding Space Security Policy Definition \"#{name}\"")
+      @logger.info("Finding Space Security Policy Definition \"#{name}\"")
       get("#{@api_url}/securityPolicyDefinitions/#{encode(name)}", params, headers)
     end
   
@@ -69,7 +69,7 @@ module KineticSdk
     # @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_security_policy_definition(name, body, headers=default_headers)
-      info("Updating Space Security Policy Definition \"#{name}\"")
+      @logger.info("Updating Space Security Policy Definition \"#{name}\"")
       put("#{@api_url}/securityPolicyDefinitions/#{encode(name)}", body, headers)
     end
 
@@ -86,7 +86,7 @@ module KineticSdk
     # @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_security_policy_definition(kapp_slug, body, headers=default_headers)
-      info("Adding Security Policy Definition \"#{body['name']}\" to the \"#{kapp_slug}\" kapp.")
+      @logger.info("Adding Security Policy Definition \"#{body['name']}\" to the \"#{kapp_slug}\" kapp.")
       # Create the kapp security policy definition
       post("#{@api_url}/kapps/#{kapp_slug}/securityPolicyDefinitions", body, headers)
     end
@@ -98,7 +98,7 @@ module KineticSdk
     # @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_security_policy_definition(kapp_slug, name, headers=default_headers)
-      info("Deleting Security Policy Definition \"#{name}\" from the \"#{kapp_slug}\" kapp.")
+      @logger.info("Deleting Security Policy Definition \"#{name}\" from the \"#{kapp_slug}\" kapp.")
       # Delete the kapp security policy definition
       delete("#{@api_url}/kapps/#{kapp_slug}/securityPolicyDefinitions/#{encode(name)}", headers)
     end
@@ -121,7 +121,7 @@ module KineticSdk
     # @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_security_policy_definitions(kapp_slug, params={}, headers=default_headers)
-      info("Listing Security Policy Definitions on the \"#{kapp_slug}\" kapp.")
+      @logger.info("Listing Security Policy Definitions on the \"#{kapp_slug}\" kapp.")
       get("#{@api_url}/kapps/#{kapp_slug}/securityPolicyDefinitions", params, headers)
     end
 
@@ -133,7 +133,7 @@ module KineticSdk
     # @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_security_policy_definition(kapp_slug, name, params={}, headers=default_headers)
-      info("Finding Security Policy Definition \"#{name}\" on the \"#{kapp_slug}\" kapp.")
+      @logger.info("Finding Security Policy Definition \"#{name}\" on the \"#{kapp_slug}\" kapp.")
       get("#{@api_url}/kapps/#{kapp_slug}/securityPolicyDefinitions/#{encode(name)}", params, headers)
     end
 
@@ -149,7 +149,7 @@ module KineticSdk
     # @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_security_policy_definition(kapp_slug, name, body, headers=default_headers)
-      info("Updating Security Policy Definition \"#{name}\" on the \"#{kapp_slug}\" kapp.")
+      @logger.info("Updating Security Policy Definition \"#{name}\" on the \"#{kapp_slug}\" kapp.")
       put("#{@api_url}/kapps/#{kapp_slug}/securityPolicyDefinitions/#{encode(name)}", body, headers)
     end
 

data/lib/kinetic_sdk/core/lib/space.rb

@@ -0,0 +1,156 @@
+module KineticSdk
+  class Core
+
+    # Add an attribute value to the space, or update an attribute if it already exists
+    #
+    # @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_space_attribute(attribute_name, attribute_value, headers=default_headers)
+      # first find the space
+      response = find_space({ "include" => "attributes"}, headers)
+      # hack to try a second time if space isn't found
+      if response.status == 404
+        sleep 2
+        response = find_space({ "include" => "attributes"}, headers)
+      end
+      space = response.content["space"]
+      attributes = space["attributes"]
+      # either add or update the attribute value
+      exists = false
+      attributes.each do |attribute|
+        @logger.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
+        @logger.info("Updating attribute \"#{attribute_name}\" = \"#{attribute_value}\" in the \"#{space_slug}\" space.")
+      else
+        @logger.info("Adding attribute \"#{attribute_name}\" = \"#{attribute_value}\" to the \"#{space_slug}\" space.")
+      end
+      # Update the space
+      put("#{@api_url}/space", body, headers)
+    end
+
+    # Update a space
+    #
+    # @param body [Hash] properties for 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(body={}, headers=default_headers)
+      @logger.info("Updating Space \"#{@space_slug}\"")
+      put("#{@api_url}/space", body, headers)
+    end
+
+    # Export a space to the export_directory
+    #
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return nil
+    def export_space(headers=default_headers)
+      raise StandardError.new "An export directory must be defined to export space." if @options[:export_directory].nil?
+      @logger.info("Exporting space definition to #{@options[:export_directory]}.")
+      # Build up the tree of how files should be written
+      export_shape = prepare_shape(
+        "space.bridges.{name}",
+        "space.datastore.forms.{slug}",
+        "space.kapps.{slug}.categories",
+        "space.kapps.{slug}.categoryAttributeDefinitions",
+        "space.kapps.{slug}.forms.{slug}",
+        "space.kapps.{slug}.formAttributeDefinitions",
+        "space.kapps.{slug}.formsTypes",
+        "space.kapps.{slug}.kappAttributeDefinitions",
+        "space.kapps.{slug}.securityPolicyDefinitions",
+        "space.kapps.{slug}.webhooks.{name}",
+        "space.models.{name}",
+        "space.teams.{name}",
+        "space.datastoreFormAttributeDefinitions",
+        "space.securityPolicyDefinitions",
+        "space.spaceAttributeDefinitions",
+        "space.teamAttributeDefinitions",
+        "space.userAttributeDefinitions",
+        "space.userProfileAttributeDefinitions",
+        "space.webhooks.{name}",
+      )
+      core_data = get("#{@api_url}/space", { 'export' => true}, headers).content
+      process_export(@options[:export_directory], export_shape, core_data)
+      @logger.info("Finished exporting space definition to #{@options[:export_directory]}.")
+    end
+
+    # Find 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(params={}, headers=default_headers)
+      @logger.info("Finding Space \"#{@space_slug}\"")
+      get("#{@api_url}/space", params, headers)
+    end
+
+    # Imports a full space definition from the export_directory
+    #
+    # @param slug [String] the slug of the space that is being imported
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return nil
+    def import_space(slug, headers=default_headers)
+      raise StandardError.new "An export directory must be defined to import space." if @options[:export_directory].nil?
+      @logger.info("Importing space definition from #{@options[:export_directory]}.")
+
+      # Loop over all provided files sorting files before folders
+      Dir["#{@options[:export_directory]}/**/*.json"].map { |file| [file.count("/"), file] }.sort.map { |file| file[1] }.each do |file|
+        rel_path = file.gsub("#{@options[:export_directory]}/", '')
+        body = JSON.parse(File.read(file))
+        if rel_path == "space.json"
+          api_path = "/space"
+          @logger.info("Importing #{rel_path} to #{api_path}.")
+          body['slug'] = slug
+          resp = put("#{@api_url}#{api_path}", body, headers)
+        elsif body.is_a?(Array)
+          api_path = "/#{rel_path.sub(/^space\//,'').sub(/\.json$/,'')}"
+          body.each do |part|
+            @logger.info("Importing #{rel_path} to #{api_path}.")
+            resp = post("#{@api_url}#{api_path}", part, headers)
+          end
+        else
+          api_path = "/#{rel_path.sub(/^space\//,'').sub(/\/[^\/]+$/,'')}"
+          # TODO: Remove this block when core API is updated to not export Key
+          if api_path == "/bridges" && body.has_key?("key")
+            body.delete("key")
+          end
+          @logger.info("Importing #{rel_path} to #{api_path}.")
+          resp = post("#{@api_url}#{api_path}", body, headers)
+          # TODO: Remove this block when core API is updated to not pre-create SPDs
+          if api_path == "/kapps"
+            kapp_slug = resp.content["kapp"]["slug"]
+            delete_security_policy_definitions(kapp_slug)
+          end
+        end
+      end
+      @logger.info("Finished importing space definition to #{@options[:export_directory]}.")
+    end
+
+    # Checks if the space exists
+    #
+    # @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 space_exists?(slug, params={}, headers=default_headers)
+      @logger.info("Checking if the \"#{slug}\" space exists")
+      response = get("#{@api_url}/spaces/#{slug}", params, headers)
+      response.status == 200
+    end
+
+  end
+end