proxmox-sdk 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18becda6b3edf4aba2a1146a3f889e618c9c49ad9d476f45197b63bae0930f5e
-  data.tar.gz: bc2b3f12e06eb9ef9941acf1035a81bdad3be29627fbdec33ee520e374ddb221
+  metadata.gz: 366fb7b7ffeb686acc3a60998150f76bd28422038f8df24581b25cc0181819b0
+  data.tar.gz: 7cf6a08e8838aae0f74f9b6e0e5a7e44decbc1fabea47f16e6ddf433bd5cd143
 SHA512:
-  metadata.gz: 4aa011f0cb9ea2ca0694a095e549a410f572cd96325d3cf4886bc1a9ba80536e8d4f64ea9005bdf9836368c2b8a5c823e8d28cc81da77601958a96cd27132865
-  data.tar.gz: 3628b92158ebb7288bdd9f231e9db71eb180789df6e36fc7faa69d744b41bcde25535efc90bec9f0b48c1c959a5d9f0811a9aa54850a4a83ab75af6c4016ccb5
+  metadata.gz: 0b557b203e667b509053a55c9fb921b92bb3b7895a57e5e89117ad93339cc7ccaf2a69990ed0ecb527b9bf5f0bf2f82367f34e75b121b235bb03f547be932a1e
+  data.tar.gz: 2da70d05399e669f1a804d50aac56900f8a2f0300f61450eb43341fd891eff1bbfa5c9fa79b8991ba1f9b296e80d5a521357705d98bc2090555168a61b114d5e

data/README.md

@@ -1,5 +1,7 @@
 # Proxmox
 
+[![Gem Version](https://badge.fury.io/rb/proxmox-sdk.svg)](https://badge.fury.io/rb/proxmox-sdk)
+
 A lightweight Ruby gem that provides a clean, idiomatic interface to the Proxmox VE REST API. It handles authentication, token management, and all common API endpoints (nodes, virtual machines, storage, containers, etc.) so you can focus on building automation, orchestration, or custom tooling without dealing with raw HTTP calls.
 
 ## Installation

data/lib/proxmox/client.rb

@@ -1,27 +1,50 @@
 # frozen_string_literal: true
 
 require "faraday"
+require "json"
+require "time"
 
 module Proxmox
   # Proxmox SDK Http Client
   class Client
+    # Konstanten für die Gültigkeit des Tokens
+    # Proxmox Tickets sind standardmäßig 2 Stunden (7200 Sekunden) gültig.
+    TOKEN_VALIDITY_SECONDS = 7200
+    # Wir erneuern den Token 5 Minuten (300 Sekunden) vor Ablauf.
+    RENEWAL_BUFFER_SECONDS = 300
+
     attr_reader :ticket, :csrf_token, :base_url
 
     def initialize(base_url:, username:, password:, realm: "pam", ignore_ssl: false)
       @base_url = base_url
       @verify_ssl = !ignore_ssl
-      login(username, password, realm)
+
+      # Anmeldedaten für die automatische Erneuerung speichern
+      @username = username
+      @password = password
+      @realm = realm
+
+      # Initiales Login
+      login
     end
 
-    def login(user, pass, realm)
+    def login
       resp = http.post("/api2/json/access/ticket",
-                       { username: "#{user}@#{realm}", password: pass })
+                       { username: "#{@username}@#{@realm}", password: @password })
+
+      raise "Login failed: #{resp.body}" unless resp.success?
+
       data = JSON.parse(resp.body)["data"]
-      @ticket     = data["ticket"]
+      @ticket = data["ticket"]
       @csrf_token = data["CSRFPreventionToken"]
+      # Zeitstempel der Ticketerstellung speichern
+      @ticket_creation_time = Time.now
     end
 
     def request(method, path, params = {}, body = nil)
+      # Vor jeder Anfrage die Gültigkeit des Tokens prüfen und ggf. erneuern
+      ensure_token_validity
+
       response = perform_http_call(method, path, params, body)
 
       ensure_success!(response)
@@ -30,6 +53,23 @@ module Proxmox
 
     private
 
+    # NEUE METHODE: Stellt sicher, dass der Token gültig ist
+    def ensure_token_validity
+      login if token_expired?
+    end
+
+    # NEUE METHODE: Prüft, ob der Token abgelaufen ist oder bald abläuft
+    def token_expired?
+      # Wenn noch kein Ticket erstellt wurde, nicht als abgelaufen betrachten
+      return false if @ticket_creation_time.nil?
+
+      # Berechne die Ablaufzeit (Erstellungszeit + Gültigkeit - Puffer)
+      renewal_time = @ticket_creation_time + TOKEN_VALIDITY_SECONDS - RENEWAL_BUFFER_SECONDS
+
+      # Ist die aktuelle Zeit nach der errechneten Erneuerungszeit?
+      Time.now > renewal_time
+    end
+
     def perform_http_call(method, path, params, body)
       http.send(method) do |req|
         set_url(req, path)
@@ -63,10 +103,18 @@ module Proxmox
     end
 
     def ensure_success!(response)
-      raise ApiError, response.body unless response.success?
+      # Optional: Wenn ein 401 (Unauthorized) Fehler kommt, könnte man hier auch ein erneutes Login erzwingen.
+      # if response.status == 401
+      #   login
+      #   # Hier könnte man die Anfrage wiederholen.
+      # end
+      raise "ApiError: #{response.body}" unless response.success?
     end
 
     def extract_data(response)
+      # Sicherstellen, dass der Body nicht leer ist, bevor geparst wird
+      return nil if response.body.nil? || response.body.empty?
+
       JSON.parse(response.body)["data"]
     end
 
@@ -77,4 +125,7 @@ module Proxmox
       end
     end
   end
+
+  # Eigene Fehlerklasse (optional, aber guter Stil)
+  class ApiError < StandardError; end
 end

data/lib/proxmox/resources/clusters/backup.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Proxmox
+  module Resources
+    module Clusters
+      # Proxmox Cluster Acme class
+      class Backup
+        def initialize(client)
+          @client = client
+        end
+
+        def all
+          @client.request(:get, "/cluster/backup")
+        end
+      end
+    end
+  end
+end

data/lib/proxmox/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Proxmox
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

data/lib/proxmox.rb

@@ -4,6 +4,7 @@ require "proxmox/version"
 require "proxmox/client"
 require "proxmox/resources/cluster"
 require "proxmox/resources/clusters/acme"
+require "proxmox/resources/clusters/backup"
 require "proxmox/resources/node"
 
 module Proxmox

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: proxmox-sdk
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Alex Wellnitz
+autorequire:
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2025-10-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -38,6 +39,7 @@ files:
 - lib/proxmox/client.rb
 - lib/proxmox/resources/cluster.rb
 - lib/proxmox/resources/clusters/acme.rb
+- lib/proxmox/resources/clusters/backup.rb
 - lib/proxmox/resources/node.rb
 - lib/proxmox/version.rb
 - sig/proxmox.rbs
@@ -49,6 +51,7 @@ metadata:
   homepage_uri: https://github.com/alexohneander/proxmox-sdk-ruby
   source_code_uri: https://github.com/alexohneander/proxmox-sdk-ruby
   changelog_uri: https://raw.githubusercontent.com/alexohneander/proxmox-sdk-ruby/refs/heads/main/CHANGELOG.md
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -63,7 +66,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.5.3
+signing_key:
 specification_version: 4
 summary: A gem that provides a client interface for Proxmox
 test_files: []