vers-sdk 0.1.7 → 0.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c951cf2151004223920df0bb138293192188e8d1c0f9745bf784bbe89aa58162
-  data.tar.gz: cbbdf495be7bc1d4600eea1a9166987ca74ea4c5185a0d542e1abecf1c264e62
+  metadata.gz: 7a2dcc5a41778ee85766e42933c29a3bef0836381b8f73b1130048602896ae9e
+  data.tar.gz: d2f1183f925fc04050b43a7ee96daa602d55016a7789184b27cb965ceb7a869f
 SHA512:
-  metadata.gz: 179a482d53ff0bce6c840820c12238e35976d279d0d6cc905535587269569a10f06cdd01c64b4a522f2ef3582b1158b512f9339fc636d97bbfc24ffa5c50c51b
-  data.tar.gz: cbf6c8f749280c44a0fb07f1f39617a5b8cf9aabf02d989ed512b5d7a19362de30a1e23aa0cf518a334683b9ef76d65fe7325ad4aab33b572fcab7140b3791a4
+  metadata.gz: 14dea0ed131c7929f2e04b24794bfaef9fb717df211c47318db89e3bf6fc7983e8ea8c8ea580cf802dc8f7744418059b56b82d7f0dadcdce151fc1c96142adde
+  data.tar.gz: 966a0221d365dba8e402d0bced5a6ef9e8206fe5751ccee46ac62eb14b088fc0fb62228403cb675855e6c057f775bf24125aa6b94c385722f740dd18e8b562cd

data/lib/vers_sdk/client.rb

@@ -51,7 +51,7 @@ module VersSdk
       @default_headers = {
         "Content-Type" => "application/json",
         "Accept" => "application/json",
-        "User-Agent" => "vers-sdk/0.1.7 ruby/#{RUBY_VERSION} #{RUBY_PLATFORM}"
+        "User-Agent" => "vers-sdk/0.1.9 ruby/#{RUBY_VERSION} #{RUBY_PLATFORM}"
       }
       @default_headers["Authorization"] = "Bearer #{@api_key}" if @api_key
     end
@@ -67,8 +67,37 @@ module VersSdk
     end
 
     # 
-    def resize_vm_disk(vm_id, body: nil, params: nil, options: nil)
-      path = sprintf("/api/v1/vm/%s/disk", vm_id)
+    def vm_logs(vm_id, params: nil, options: nil)
+      path = sprintf("/api/v1/vm/%s/logs", vm_id)
+      query = {}
+      if params
+        h = params.is_a?(Hash) ? params : params.to_h
+        h.each { |k, v| query[k.to_s] = v.to_s unless v.nil? }
+      end
+      request("GET", path, options: options, query: query)
+    end
+
+    # Upsert (additive) labels on a VM.
+    def upsert_vm_labels(vm_id, body: nil, options: nil)
+      path = sprintf("/api/v1/vm/%s/label", vm_id)
+      request("PATCH", path, options: options, body: body)
+    end
+
+    # 
+    def list_public_repo_tags(org_name, repo_name, options: nil)
+      path = sprintf("/api/v1/public/repositories/%s/%s/tags", org_name, repo_name)
+      request("GET", path, options: options)
+    end
+
+    # 
+    def list_parent_commits(commit_id, options: nil)
+      path = sprintf("/api/v1/vm/commits/%s/parents", commit_id)
+      request("GET", path, options: options)
+    end
+
+    # 
+    def update_vm_state(vm_id, body: nil, params: nil, options: nil)
+      path = sprintf("/api/v1/vm/%s/state", vm_id)
       query = {}
       if params
         h = params.is_a?(Hash) ? params : params.to_h
@@ -78,31 +107,132 @@ module VersSdk
     end
 
     # 
-    def exec_vm_stream_attach(vm_id, body: nil, options: nil)
-      path = sprintf("/api/v1/vm/%s/exec/stream/attach", vm_id)
+    def list_repositories(options: nil)
+      path = "/api/v1/repositories"
+      request("GET", path, options: options)
+    end
+
+    # 
+    def create_repository(body: nil, options: nil)
+      path = "/api/v1/repositories"
       request("POST", path, options: options, body: body)
     end
 
     # 
-    def create_new_root_vm(body: nil, params: nil, options: nil)
-      path = "/api/v1/vm/new_root"
+    def get_public_repo_tag(org_name, repo_name, tag_name, options: nil)
+      path = sprintf("/api/v1/public/repositories/%s/%s/tags/%s", org_name, repo_name, tag_name)
+      request("GET", path, options: options)
+    end
+
+    # 
+    def list_tags(options: nil)
+      path = "/api/v1/commit_tags"
+      request("GET", path, options: options)
+    end
+
+    # 
+    def create_tag(body: nil, options: nil)
+      path = "/api/v1/commit_tags"
+      request("POST", path, options: options, body: body)
+    end
+
+    # 
+    def list_vms(options: nil)
+      path = "/api/v1/vm"
+      request("GET", path, options: options)
+    end
+
+    # 
+    def get_vm_metadata(vm_id, options: nil)
+      path = sprintf("/api/v1/vm/%s/metadata", vm_id)
+      request("GET", path, options: options)
+    end
+
+    # 
+    def list_commits(options: nil)
+      path = "/api/v1/commits"
+      request("GET", path, options: options)
+    end
+
+    # 
+    def list_repo_tags(repo_name, options: nil)
+      path = sprintf("/api/v1/repositories/%s/tags", repo_name)
+      request("GET", path, options: options)
+    end
+
+    # 
+    def create_repo_tag(repo_name, body: nil, options: nil)
+      path = sprintf("/api/v1/repositories/%s/tags", repo_name)
+      request("POST", path, options: options, body: body)
+    end
+
+    # 
+    def exec_vm(vm_id, body: nil, options: nil)
+      path = sprintf("/api/v1/vm/%s/exec", vm_id)
+      request("POST", path, options: options, body: body)
+    end
+
+    # 
+    def set_repository_visibility(repo_name, body: nil, options: nil)
+      path = sprintf("/api/v1/repositories/%s/visibility", repo_name)
+      request("PATCH", path, options: options, body: body)
+    end
+
+    # 
+    def list_images(options: nil)
+      path = "/api/v1/images"
+      request("GET", path, options: options)
+    end
+
+    # 
+    def read_file_vm(vm_id, params: nil, options: nil)
+      path = sprintf("/api/v1/vm/%s/files", vm_id)
       query = {}
       if params
         h = params.is_a?(Hash) ? params : params.to_h
         h.each { |k, v| query[k.to_s] = v.to_s unless v.nil? }
       end
-      request("POST", path, options: options, body: body, query: query)
+      request("GET", path, options: options, query: query)
     end
 
     # 
-    def vm_logs(vm_id, params: nil, options: nil)
-      path = sprintf("/api/v1/vm/%s/logs", vm_id)
+    def write_file_vm(vm_id, body: nil, options: nil)
+      path = sprintf("/api/v1/vm/%s/files", vm_id)
+      request("PUT", path, options: options, body: body)
+    end
+
+    # 
+    def get_public_repository(org_name, repo_name, options: nil)
+      path = sprintf("/api/v1/public/repositories/%s/%s", org_name, repo_name)
+      request("GET", path, options: options)
+    end
+
+    # 
+    def resize_vm_disk(vm_id, body: nil, params: nil, options: nil)
+      path = sprintf("/api/v1/vm/%s/disk", vm_id)
       query = {}
       if params
         h = params.is_a?(Hash) ? params : params.to_h
         h.each { |k, v| query[k.to_s] = v.to_s unless v.nil? }
       end
-      request("GET", path, options: options, query: query)
+      request("PATCH", path, options: options, body: body, query: query)
+    end
+
+    # 
+    def exec_vm_stream_attach(vm_id, body: nil, options: nil)
+      path = sprintf("/api/v1/vm/%s/exec/stream/attach", vm_id)
+      request("POST", path, options: options, body: body)
+    end
+
+    # 
+    def create_new_root_vm(body: nil, params: nil, options: nil)
+      path = "/api/v1/vm/new_root"
+      query = {}
+      if params
+        h = params.is_a?(Hash) ? params : params.to_h
+        h.each { |k, v| query[k.to_s] = v.to_s unless v.nil? }
+      end
+      request("POST", path, options: options, body: body, query: query)
     end
 
     # 
@@ -116,6 +246,12 @@ module VersSdk
       request("POST", path, options: options, body: body, query: query)
     end
 
+    # Replace **all** labels on a VM with the provided map.
+    def replace_vm_labels(vm_id, body: nil, options: nil)
+      path = sprintf("/api/v1/vm/%s/labels", vm_id)
+      request("PUT", path, options: options, body: body)
+    end
+
     # 
     def list_public_commits(options: nil)
       path = "/api/v1/commits/public"
@@ -123,25 +259,20 @@ module VersSdk
     end
 
     # 
-    def list_public_repo_tags(org_name, repo_name, options: nil)
-      path = sprintf("/api/v1/public/repositories/%s/%s/tags", org_name, repo_name)
+    def get_image_status(image_name, options: nil)
+      path = sprintf("/api/v1/images/%s/status", image_name)
       request("GET", path, options: options)
     end
 
     # 
-    def branch_by_tag(tag_name, body: nil, params: nil, options: nil)
-      path = sprintf("/api/v1/vm/branch/by_tag/%s", tag_name)
-      query = {}
-      if params
-        h = params.is_a?(Hash) ? params : params.to_h
-        h.each { |k, v| query[k.to_s] = v.to_s unless v.nil? }
-      end
-      request("POST", path, options: options, body: body, query: query)
+    def version_handler(options: nil)
+      path = "/api/v1/system/version"
+      request("GET", path, options: options)
     end
 
     # 
-    def branch_vm(vm_or_commit_id, body: nil, params: nil, options: nil)
-      path = sprintf("/api/v1/vm/%s/branch", vm_or_commit_id)
+    def branch_by_tag(tag_name, body: nil, params: nil, options: nil)
+      path = sprintf("/api/v1/vm/branch/by_tag/%s", tag_name)
       query = {}
       if params
         h = params.is_a?(Hash) ? params : params.to_h
@@ -168,6 +299,17 @@ module VersSdk
       request("PATCH", path, options: options, body: body)
     end
 
+    # 
+    def branch_vm(vm_or_commit_id, body: nil, params: nil, options: nil)
+      path = sprintf("/api/v1/vm/%s/branch", vm_or_commit_id)
+      query = {}
+      if params
+        h = params.is_a?(Hash) ? params : params.to_h
+        h.each { |k, v| query[k.to_s] = v.to_s unless v.nil? }
+      end
+      request("POST", path, options: options, body: body, query: query)
+    end
+
     # 
     def get_repository(repo_name, options: nil)
       path = sprintf("/api/v1/repositories/%s", repo_name)
@@ -181,20 +323,9 @@ module VersSdk
     end
 
     # 
-    def list_parent_commits(commit_id, options: nil)
-      path = sprintf("/api/v1/vm/commits/%s/parents", commit_id)
-      request("GET", path, options: options)
-    end
-
-    # 
-    def update_vm_state(vm_id, body: nil, params: nil, options: nil)
-      path = sprintf("/api/v1/vm/%s/state", vm_id)
-      query = {}
-      if params
-        h = params.is_a?(Hash) ? params : params.to_h
-        h.each { |k, v| query[k.to_s] = v.to_s unless v.nil? }
-      end
-      request("PATCH", path, options: options, body: body, query: query)
+    def validate_key(body: nil, options: nil)
+      path = "/api/v1/keys/validate"
+      request("POST", path, options: options, body: body)
     end
 
     # 
@@ -203,15 +334,15 @@ module VersSdk
       request("POST", path, options: options, body: body)
     end
 
-    # 
-    def list_repositories(options: nil)
-      path = "/api/v1/repositories"
-      request("GET", path, options: options)
+    # Delete a single label from a VM by name.
+    def delete_vm_label(vm_id, label_name, options: nil)
+      path = sprintf("/api/v1/vm/%s/label/%s", vm_id, label_name)
+      request("DELETE", path, options: options)
     end
 
     # 
-    def create_repository(body: nil, options: nil)
-      path = "/api/v1/repositories"
+    def create_image(body: nil, options: nil)
+      path = "/api/v1/images/create"
       request("POST", path, options: options, body: body)
     end
 
@@ -233,36 +364,12 @@ module VersSdk
       request("DELETE", path, options: options)
     end
 
-    # 
-    def list_tags(options: nil)
-      path = "/api/v1/commit_tags"
-      request("GET", path, options: options)
-    end
-
-    # 
-    def create_tag(body: nil, options: nil)
-      path = "/api/v1/commit_tags"
-      request("POST", path, options: options, body: body)
-    end
-
     # 
     def list_public_repositories(options: nil)
       path = "/api/v1/public/repositories"
       request("GET", path, options: options)
     end
 
-    # 
-    def get_public_repo_tag(org_name, repo_name, tag_name, options: nil)
-      path = sprintf("/api/v1/public/repositories/%s/%s/tags/%s", org_name, repo_name, tag_name)
-      request("GET", path, options: options)
-    end
-
-    # 
-    def get_vm_metadata(vm_id, options: nil)
-      path = sprintf("/api/v1/vm/%s/metadata", vm_id)
-      request("GET", path, options: options)
-    end
-
     # 
     def list_env_vars(options: nil)
       path = "/api/v1/env_vars"
@@ -286,12 +393,6 @@ module VersSdk
       request("DELETE", path, options: options, query: query)
     end
 
-    # 
-    def list_commits(options: nil)
-      path = "/api/v1/commits"
-      request("GET", path, options: options)
-    end
-
     # 
     def get_tag(tag_name, options: nil)
       path = sprintf("/api/v1/commit_tags/%s", tag_name)
@@ -328,9 +429,9 @@ module VersSdk
     end
 
     # 
-    def exec_vm_stream(vm_id, body: nil, options: nil)
-      path = sprintf("/api/v1/vm/%s/exec/stream", vm_id)
-      request("POST", path, options: options, body: body)
+    def delete_image(base_image_id, options: nil)
+      path = sprintf("/api/v1/images/images/%s", base_image_id)
+      request("DELETE", path, options: options)
     end
 
     # 
@@ -357,14 +458,14 @@ module VersSdk
     end
 
     # 
-    def list_repo_tags(repo_name, options: nil)
-      path = sprintf("/api/v1/repositories/%s/tags", repo_name)
-      request("GET", path, options: options)
+    def exec_vm_stream(vm_id, body: nil, options: nil)
+      path = sprintf("/api/v1/vm/%s/exec/stream", vm_id)
+      request("POST", path, options: options, body: body)
     end
 
-    # 
-    def create_repo_tag(repo_name, body: nil, options: nil)
-      path = sprintf("/api/v1/repositories/%s/tags", repo_name)
+    # Deploy a GitHub repository to a new Vers project.
+    def deploy_handler(body: nil, options: nil)
+      path = "/api/v1/deploy"
       request("POST", path, options: options, body: body)
     end
 
@@ -375,20 +476,8 @@ module VersSdk
     end
 
     # 
-    def exec_vm(vm_id, body: nil, options: nil)
-      path = sprintf("/api/v1/vm/%s/exec", vm_id)
-      request("POST", path, options: options, body: body)
-    end
-
-    # 
-    def set_repository_visibility(repo_name, body: nil, options: nil)
-      path = sprintf("/api/v1/repositories/%s/visibility", repo_name)
-      request("PATCH", path, options: options, body: body)
-    end
-
-    # 
-    def list_vms(options: nil)
-      path = "/api/v1/vms"
+    def vm_status(vm_id, options: nil)
+      path = sprintf("/api/v1/vm/%s/status", vm_id)
       request("GET", path, options: options)
     end
 
@@ -410,15 +499,15 @@ module VersSdk
     end
 
     # 
-    def vm_status(vm_id, options: nil)
-      path = sprintf("/api/v1/vm/%s/status", vm_id)
+    def whoami_handler(options: nil)
+      path = "/api/v1/whoami"
       request("GET", path, options: options)
     end
 
     # 
-    def get_public_repository(org_name, repo_name, options: nil)
-      path = sprintf("/api/v1/public/repositories/%s/%s", org_name, repo_name)
-      request("GET", path, options: options)
+    def upload_image(body: nil, options: nil)
+      path = "/api/v1/images/upload"
+      request("POST", path, options: options, body: body)
     end
 
     # 
@@ -467,7 +556,7 @@ module VersSdk
           end
 
           check_response(response)
-          return response
+          return JSON.parse(response.body) rescue response.body
         rescue APIError
           raise
         rescue Errno::ECONNREFUSED, Errno::ECONNRESET, Errno::ETIMEDOUT,
@@ -551,9 +640,14 @@ module VersSdk
 
       body = nil
       message = nil
-      begin
-        body = JSON.parse(response.body)
-      rescue StandardError
+      ct = response["content-type"] || ""
+      if ct.include?("application/json")
+        begin
+          body = JSON.parse(response.body)
+        rescue StandardError
+          message = response.body
+        end
+      else
         message = response.body
       end
 

data/lib/vers_sdk/errors.rb

@@ -18,6 +18,17 @@ module VersSdk
       super(make_message(status, body, message))
     end
 
+    # Extract the human-readable error message from the response body.
+    # Looks for an "error" or "message" field in the JSON body,
+    # or falls back to the raw message.
+    def error_message
+      if body.is_a?(Hash)
+        return body["error"] if body["error"].is_a?(String)
+        return body["message"] if body["message"].is_a?(String)
+      end
+      message
+    end
+
     def self.generate(status:, body: nil, message: nil, headers: nil)
       return APIConnectionError.new(message: message) if status.nil? || headers.nil?