kamatera_api_wrapper 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ff3a0a0c39bd3fcc5ae637d0d932256d56d10801741f7579009dbebb00db11b7
+  data.tar.gz: c57b9846789d4f20e17758e0f6bcd2cc803f426194b2a06f6e9a338ed6c421ca
+SHA512:
+  metadata.gz: 20023fea03c1741507267d6e37e56932d14af812a34f18e34a95abb19f9f15006de2a4cd03b8d0c3c0e4de760b54f75895abc025521a32bf5895a9eaa4a5bea1
+  data.tar.gz: b4ae3504dcf3c238a175e36afa042f6875172c9273d3c03a50b626abe51c81c00812126fb72543338d2e8457f31a9a70a2139f4e3fd61d7cfd8e6ee1af135dff

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle
+/vendor
+/.byebug_history
+/.DS_Store
+/.idea
+/.vscode
+/log
+/tmp
+/.env

data/.rspec_status

@@ -0,0 +1,4 @@
+example_id                   | status | run_time       |
+---------------------------- | ------ | -------------- |
+./spec/client_spec.rb[1:1:1] | passed | 0.002 seconds  |
+./spec/client_spec.rb[1:2:1] | passed | 0.0274 seconds |

data/Gemfile

@@ -0,0 +1,9 @@
+source "https://rubygems.org"
+
+gemspec
+
+group :development, :test do
+  gem "rake"
+  gem "rspec"
+  gem "webmock"
+end

data/Gemfile.lock

@@ -0,0 +1,67 @@
+PATH
+  remote: .
+  specs:
+    kamatera_api_wrapper (0.1.0)
+      faraday (~> 2.0)
+      faraday-retry
+      multi_json (~> 1.15)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.8)
+      public_suffix (>= 2.0.2, < 8.0)
+    bigdecimal (3.3.1)
+    crack (1.0.1)
+      bigdecimal
+      rexml
+    diff-lcs (1.6.2)
+    faraday (2.14.0)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-net_http (3.4.2)
+      net-http (~> 0.5)
+    faraday-retry (2.3.2)
+      faraday (~> 2.0)
+    hashdiff (1.2.1)
+    json (2.16.0)
+    logger (1.7.0)
+    multi_json (1.17.0)
+    net-http (0.8.0)
+      uri (>= 0.11.1)
+    public_suffix (7.0.0)
+    rake (13.3.1)
+    rexml (3.4.4)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.7)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.6)
+    uri (1.1.1)
+    webmock (3.26.1)
+      addressable (>= 2.8.0)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
+
+PLATFORMS
+  ruby
+  x86_64-linux
+
+DEPENDENCIES
+  bundler
+  kamatera_api_wrapper!
+  rake
+  rspec
+  webmock
+
+BUNDLED WITH
+   2.5.22

data/README.md

@@ -0,0 +1,68 @@
+# KamateraApiWrapper
+
+A small Ruby client for authenticating with Kamatera and calling server endpoints (GET /servers etc).
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem "kamatera_api_wrapper"
+```
+
+Then:
+
+```bash
+bundle install
+```
+
+## Usage
+
+```ruby
+require "kamatera_api_wrapper"
+
+client = KamateraApiWrapper::Client.new(
+  client_id: "your_client_id",
+  client_secret: "your_secret"
+)
+
+# authenticate explicitly (optional, client will auto-auth on first request)
+client.authenticate!
+
+# list servers
+servers = client.servers
+puts servers.inspect
+```
+
+## Configuration options
+
+You can pass options to the client:
+
+- `base_url` — default `"https://console.kamatera.com"`
+- `timeout` — Faraday open/read timeout in seconds (default: `10`)
+- `token_expiry_margin` — seconds to subtract from expiry to refresh early (default: `30`)
+
+Example:
+
+```ruby
+client = KamateraApiWrapper::Client.new(
+  client_id: "...",
+  client_secret: "...",
+  base_url: "https://console.kamatera.com",
+  timeout: 15,
+  token_expiry_margin: 10
+)
+```
+
+## Tests
+
+Run:
+
+```bash
+bundle exec rspec
+```
+
+## Notes
+
+- Token caching is in-memory in the `Client` instance. For multi-process environments or long-running services you should persist token(s) appropriately.
+- `Application/json` Content-Type is used for authentication per Kamatera API requirement.

data/Rakefile

@@ -0,0 +1,28 @@
+require "rake/testtask"
+require "rspec/core/rake_task"
+require "kamatera_api_wrapper"
+
+RSpec::Core::RakeTask.new(:spec)
+
+GEMSPEC = Dir.glob("*.gemspec").first or raise "No gemspec found"
+
+def gemspec_spec
+  Gem::Specification.load(GEMSPEC)
+end
+
+desc "Build the gem into the pkg directory"
+task :build do
+  sh "rm -rf pkg"
+  sh "mkdir -p pkg"
+  sh "gem build #{GEMSPEC}"
+  #sh "mv #{gem_filename} pkg/#{gem_filename}"
+  #puts "Built: pkg/#{gem_filename}"
+end
+
+desc "Install the built gem locally"
+task :install_local => :build do
+  gem_filename = Dir.glob("pkg/*.gem").first or raise "No gem in pkg/"
+  sh "gem install --local #{gem_filename}"
+end
+
+task default: :spec

data/bin/console

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# Simple console to load gem during development
+require "bundler/setup"
+require "kamatera_api_wrapper"
+
+puts "KamateraApiWrapper loaded. Example:"
+puts "client = KamateraApiWrapper::Client.new(client_id: 'ID', client_secret: 'SECRET')"

data/kamatera_api_wrapper.gemspec

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'kamatera_api_wrapper'
+
+Gem::Specification.new do |spec|
+  spec.name          = "kamatera_api_wrapper"
+  spec.version       = KamateraApiWrapper::VERSION
+  spec.authors       = ["Stanislaw Zawadzki"]
+  spec.email         = ["st.zawadzki@gmail.com"]
+
+  spec.summary       = "Simple Ruby wrapper for Kamatera server API"
+  spec.description   = "A small client for authenticating with Kamatera and calling server endpoints (GET /servers, etc.)"
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0")
+  end
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "webmock"
+
+  spec.add_runtime_dependency "faraday", "~> 2.0"
+  spec.add_runtime_dependency "faraday-retry"
+  spec.add_runtime_dependency "multi_json", "~> 1.15"
+end

data/lib/kamatera_api_wrapper/client.rb

@@ -0,0 +1,192 @@
+# frozen_string_literal: true
+
+require "mutex_m"
+require "time"
+
+module KamateraApiWrapper
+  # Simple client for Kamatera public API (authentication + servers)
+  #
+  # Example:
+  #   client = KamateraApiWrapper::Client.new(client_id: "...", client_secret: "...")
+  #   client.servers
+  class Client
+    include Mutex_m
+
+    AUTH_PATH = "/service/authenticate".freeze
+    DEFAULT_BASE = "https://console.kamatera.com".freeze
+
+    attr_reader :client_id, :client_secret, :base_url, :timeout, :token_expiry_margin
+
+    # options:
+    # - base_url: base host (default https://console.kamatera.com)
+    # - timeout: seconds for Faraday
+    # - token_expiry_margin: seconds to subtract from token expiry to refresh early
+    def initialize(client_id:, client_secret:, base_url: DEFAULT_BASE, timeout: 10, token_expiry_margin: 30, faraday: nil)
+      super() # Mutex_m
+      @client_id = client_id
+      @client_secret = client_secret
+      @base_url = base_url.chomp("/")
+      @timeout = timeout
+      @token_expiry_margin = token_expiry_margin
+
+      @faraday = faraday || build_connection
+      @token = nil
+      @token_expires_at = nil
+    end
+
+    # Authenticate immediately (you may call this, but other methods auto-authenticate)
+    def authenticate!
+      synchronize do
+        resp = @faraday.post(AUTH_PATH) do |req|
+          req.headers["Content-Type"] = "application/json"
+          req.body = MultiJson.dump(clientId: client_id, secret: client_secret)
+        end
+
+        unless resp.success?
+          raise Errors::AuthenticationError, "Authentication failed (status #{resp.status}): #{resp.body}"
+        end
+
+        parsed = parse_json(resp.body)
+        token = parsed['authentication']
+        token_expires_at = DateTime.strptime(parsed['expires'].to_s, '%s')
+
+        unless token
+          raise Errors::ResponseParseError, "No token found in authentication response: #{resp.body}"
+        end
+
+        @token = token
+        if token_expires_at
+          # seconds
+          @token_expires_at = token_expires_at
+        else
+          # fallback: 1 hour
+          @token_expires_at = Time.now + 3600
+        end
+      end
+
+      true
+    end
+
+    # Returns array / parsed hash for GET /servers
+    def servers(params: nil)
+      ensure_authenticated!
+
+      resp = @faraday.get("/service/servers") do |req|
+        req.headers["Authorization"] = "Bearer #{token}"
+        req.params.update(params) if params
+      end
+
+      handle_response(resp)
+    end
+
+    # Returns array / parsed hash for GET /servers
+    def servers(params: nil)
+      ensure_authenticated!
+
+      resp = @faraday.get("/service/servers") do |req|
+        req.headers["Authorization"] = "Bearer #{token}"
+        req.params.update(params) if params
+      end
+
+      handle_response(resp)
+    end
+
+    def server(server_id: ,params: nil)
+      ensure_authenticated!
+
+      resp = @faraday.get("/service/server/#{server_id}") do |req|
+        req.headers["Authorization"] = "Bearer #{token}"
+        req.params.update(params) if params
+      end
+
+      handle_response(resp)
+    end
+
+    def change_server_cpu(server_id:, body:, params: nil)
+      ensure_authenticated!
+
+      resp = @faraday.put("/service/server/#{server_id}/cpu") do |req|
+        req.headers["Authorization"] = "Bearer #{token}"
+        req.headers['Accept'] = 'text/plain'
+        req.headers['Content-Type'] =  'application/json'
+        req.body = body
+        req.params.update(params) if params
+      end
+
+      handle_response(resp)
+    end
+
+    def change_server_ram(server_id:,body: ,params: nil)
+      ensure_authenticated!
+
+      resp = @faraday.put("/service/server/#{server_id}/ram") do |req|
+        req.headers["Authorization"] = "Bearer #{token}"
+        req.headers['Accept'] = 'text/plain'
+        req.headers['Content-Type'] =  'application/json'
+        req.body = body
+        req.params.update(params) if params
+      end
+
+      handle_response(resp)
+    end
+
+    def get(path, params: nil)
+      ensure_authenticated!
+
+      resp = @faraday.get(path) do |req|
+        req.headers["Authorization"] = "Bearer #{token}"
+        req.params.update(params) if params
+      end
+
+      handle_response(resp)
+    end
+
+    private
+
+    def build_connection
+      Faraday.new(url: base_url) do |f|
+        f.request :retry, max: 2, interval: 0.05
+        f.response :raise_error # will raise Faraday::ClientError for 4xx/5xx
+        f.adapter Faraday.default_adapter
+        f.options.timeout = timeout
+        f.options.open_timeout = timeout
+      end
+    end
+
+    def ensure_authenticated!
+      # double-check token presence and expiration; thread-safe
+      if token.nil? || token_expired?
+        authenticate!
+      end
+    end
+
+    def token
+      @token
+    end
+
+    def token_expired?
+      return true if @token_expires_at.nil?
+      DateTime.now >= (@token_expires_at - token_expiry_margin)
+    end
+
+    def handle_response(resp)
+      if resp.status >= 200 && resp.status < 300
+        parse_json(resp.body)
+      else
+        raise Errors::RequestError, "API request failed (status #{resp.status}): #{resp.body}"
+      end
+    rescue MultiJson::ParseError => e
+      raise Errors::ResponseParseError, "Failed to parse JSON: #{e.message}"
+    rescue Faraday::ClientError => e
+      # Faraday might raise error due to response middleware
+      raise Errors::RequestError, "HTTP error: #{e.class}: #{e.message}"
+    end
+
+    def parse_json(body)
+      body = "{}" if body.nil? || body.strip == ""
+      MultiJson.load(body)
+    rescue MultiJson::ParseError => e
+      raise Errors::ResponseParseError, e.message
+    end
+  end
+end

data/lib/kamatera_api_wrapper/errors.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module KamateraApiWrapper
+  module Errors
+    class KamateraError < StandardError; end
+    class AuthenticationError < KamateraError; end
+    class RequestError < KamateraError; end
+    class ResponseParseError < KamateraError; end
+  end
+end

data/lib/kamatera_api_wrapper/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module KamateraApiWrapper
+  VERSION = "0.1.0"
+end

data/lib/kamatera_api_wrapper.rb

@@ -0,0 +1,11 @@
+require "faraday"
+require 'faraday/retry'
+require "multi_json"
+
+require_relative "kamatera_api_wrapper/version"
+require_relative "kamatera_api_wrapper/errors"
+require_relative "kamatera_api_wrapper/client"
+
+module KamateraApiWrapper
+  class Error < StandardError; end
+end

data/spec/client_spec.rb

@@ -0,0 +1,40 @@
+require "spec_helper"
+
+RSpec.describe KamateraApiWrapper::Client do
+  let(:client_id) { "abc" }
+  let(:client_secret) { "shh" }
+  let(:base_url) { "https://console.kamatera.com" }
+  let(:client) { described_class.new(client_id: client_id, client_secret: client_secret, base_url: base_url) }
+
+  describe "#authenticate!" do
+    it "requests token and stores it" do
+      stub = stub_request(:post, "#{base_url}/service/authenticate")
+             .with(
+               headers: { "Content-Type" => "application/json" },
+               body: { clientId: client_id, secret: client_secret }.to_json
+             )
+               .to_return(status: 200, body: { authentication: "tok", expires: Time.now.to_i + 3600 }.to_json, headers: { "Content-Type" => "application/json" })
+
+      expect(client.authenticate!).to eq(true)
+      # token internals are not exposed; call servers to assert token used via WebMock
+      stub_request(:get, "#{base_url}/servers")
+        .with(headers: { "Authorization" => "Bearer tok" })
+        .to_return(status: 200, body: [{ id: "srv-1" }].to_json, headers: { "Content-Type" => "application/json" })
+
+      expect(client.servers).to eq([{"id" => "srv-1"}])
+    end
+  end
+
+  describe "#servers" do
+    it "auto-authenticates when needed" do
+      stub_request(:post, "#{base_url}/service/authenticate")
+        .to_return(status: 200, body: { authentication: "auto-tok", expires: Time.now.to_i + 3600 }.to_json)
+
+      stub_request(:get, "#{base_url}/servers")
+        .with(headers: { "Authorization" => "Bearer auto-tok" })
+        .to_return(status: 200, body: [{ id: "s1" }].to_json)
+
+      expect(client.servers).to eq([{"id" => "s1"}])
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+require "bundler/setup"
+require "kamatera_api_wrapper"
+require "webmock/rspec"
+
+RSpec.configure do |config|
+  config.order = :random
+  config.example_status_persistence_file_path = ".rspec_status"
+end

metadata

@@ -0,0 +1,157 @@
+--- !ruby/object:Gem::Specification
+name: kamatera_api_wrapper
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Stanislaw Zawadzki
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-12-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: faraday-retry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+description: A small client for authenticating with Kamatera and calling server endpoints
+  (GET /servers, etc.)
+email:
+- st.zawadzki@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec_status"
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- bin/console
+- kamatera_api_wrapper.gemspec
+- lib/kamatera_api_wrapper.rb
+- lib/kamatera_api_wrapper/client.rb
+- lib/kamatera_api_wrapper/errors.rb
+- lib/kamatera_api_wrapper/version.rb
+- pkg/kamatera_api_wrapper-0.1.0.gem
+- spec/client_spec.rb
+- spec/spec_helper.rb
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.10
+signing_key:
+specification_version: 4
+summary: Simple Ruby wrapper for Kamatera server API
+test_files: []