kube_cluster 0.2.0 → 0.3.0

data/lib/kube/cluster.rb

@@ -1,16 +1,43 @@
 # frozen_string_literal: true
 
+require "kube/schema"
+require_relative "../kube/errors"
 require_relative "cluster/version"
-require_relative "cluster/tree_node"
-require_relative "cluster/resource_selector"
-require_relative "cluster/query_builder"
-require_relative "cluster/command_node"
-require_relative "cluster/ctl"
+require_relative "cluster/connection"
+require_relative "cluster/instance"
+require_relative "cluster/resource"
+require_relative "cluster/manifest"
+require_relative "cluster/middleware"
+require 'kube/ctl'
 
 module Kube
+  def self.cluster
+    Cluster
+  end
+
   module Cluster
-    def self.ctl
-      Ctl.new
+    def self.connect(kubeconfig:)
+      Instance.new(kubeconfig: kubeconfig)
+    end
+
+    # Returns an anonymous subclass of Kube::Cluster::Resource for the
+    # given Kubernetes kind, mirroring Kube::Schema[kind] but with
+    # dirty tracking, persistence, and resource helper methods.
+    #
+    #   Kube::Cluster["Deployment"].new { metadata.name = "web" }
+    #
+    def self.[](kind)
+      @resource_classes ||= {}
+      @resource_classes[kind] ||= begin
+        schema_class = Kube::Schema[kind]
+        Class.new(Resource) do
+          @schema   = schema_class.schema
+          @defaults = schema_class.defaults
+
+          def self.schema   = @schema   || superclass.schema
+          def self.defaults = @defaults || superclass.defaults
+        end
+      end
     end
   end
 end

data/lib/kube/errors.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+# This file defines cluster-specific errors in the Kube namespace.
+
+module Kube
+  # Base error class for the Kube namespace.
+  class Error < StandardError; end
+  # Raised when a kubectl command fails.
+  #
+  #   begin
+  #     resource.patch
+  #   rescue Kube::CommandError => e
+  #     e.subcommand  # => "patch"
+  #     e.stderr      # => "Error from server (NotFound): ..."
+  #     e.exit_code   # => 1
+  #     e.reason      # => "NotFound"  (parsed from stderr, or nil)
+  #   end
+  #
+  class CommandError < Error
+    attr_reader :subcommand, :stderr, :exit_code, :reason
+
+    def initialize(message = nil, subcommand: nil, stderr: nil, exit_code: nil, reason: nil)
+      @subcommand = subcommand
+      @stderr     = stderr
+      @exit_code  = exit_code
+      @reason     = reason || parse_reason(stderr)
+      super(message || build_message)
+    end
+
+    def self.from_kubectl(subcommand:, stderr:, exit_code:)
+      new(
+        subcommand: subcommand,
+        stderr: stderr,
+        exit_code: exit_code
+      )
+    end
+
+    private
+
+      def build_message
+        "kubectl #{@subcommand} failed (exit #{@exit_code}): #{@stderr}"
+      end
+
+      # Attempts to extract the reason from kubectl stderr.
+      # kubectl errors typically look like:
+      #   Error from server (NotFound): deployments.apps "foo" not found
+      #   Error from server (Forbidden): ...
+      #   error: the server doesn't have a resource type "foo"
+      def parse_reason(stderr)
+        return nil if stderr.nil? || stderr.empty?
+
+        if stderr =~ /\((\w+)\)/
+          $1
+        end
+      end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kube_cluster
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Nathan K
@@ -57,56 +57,108 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 1.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 1.2.0
+- !ruby/object:Gem::Dependency
+  name: kube_kit
+  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: kube_kubectl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.0
 description: 'OOP abstraction that allows you to deploy and manage kubernetes resources
   using Ruby.
 
   '
 email:
 - nathankidd@hey.com
-executables:
-- kube_cluster
+executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - ".envrc"
+- ".github/workflows/release.yml"
+- ".github/workflows/tag-gem-version-bump.yml"
 - ".gitignore"
 - ".rubocop.yml"
 - Gemfile
 - Gemfile.lock
 - LICENSE
 - README.md
-- Rakefile
-- TREE_PLAN.md
 - bin/console
-- bin/generate-command-schema-v1
+- bin/dev
 - bin/increment-version
 - bin/release-gem
 - bin/setup
 - bin/tag-version
 - bin/test
-- data/kubectl-command-tree-v1-minimal.json
-- data/kubectl-command-tree-v1.json
-- examples/quick-repl/docker-compose.yml
-- exe/kube_cluster
+- docker-compose.yml
+- examples/01-basic-redis-pod/manifest.rb
+- examples/02-manifest-with-middleware/manifest.rb
+- examples/02-manifest-with-middleware/middleware/labels.rb
+- examples/02-manifest-with-middleware/middleware/namespace.rb
+- examples/02-manifest-with-middleware/templates/config_map.rb
+- examples/02-manifest-with-middleware/templates/deployment.rb
+- examples/02-manifest-with-middleware/templates/horizontal_pod_autoscaler.rb
+- examples/02-manifest-with-middleware/templates/ingress.rb
+- examples/02-manifest-with-middleware/templates/service.rb
+- examples/03-app-with-database/demo.rb
+- examples/03-app-with-database/helpers.rb
+- examples/03-app-with-database/my_app.rb
+- examples/03-app-with-database/postgresql.rb
+- examples/03-app-with-database/ruby_on_rails.rb
 - flake.lock
 - flake.nix
 - kube_cluster.gemspec
+- lib/kube/cli/cluster.rb
 - lib/kube/cluster.rb
-- lib/kube/cluster/command_node.rb
-- lib/kube/cluster/ctl.rb
-- lib/kube/cluster/query_builder.rb
-- lib/kube/cluster/resource_selector.rb
-- lib/kube/cluster/tree_node.rb
+- lib/kube/cluster/connection.rb
+- lib/kube/cluster/instance.rb
+- lib/kube/cluster/manifest.rb
+- lib/kube/cluster/middleware.rb
+- lib/kube/cluster/middleware/annotations.rb
+- lib/kube/cluster/middleware/hpa_for_deployment.rb
+- lib/kube/cluster/middleware/ingress_for_service.rb
+- lib/kube/cluster/middleware/labels.rb
+- lib/kube/cluster/middleware/namespace.rb
+- lib/kube/cluster/middleware/pod_anti_affinity.rb
+- lib/kube/cluster/middleware/resource_preset.rb
+- lib/kube/cluster/middleware/security_context.rb
+- lib/kube/cluster/middleware/service_for_deployment.rb
+- lib/kube/cluster/middleware/stack.rb
+- lib/kube/cluster/resource.rb
+- lib/kube/cluster/resource/dirty_tracking.rb
+- lib/kube/cluster/resource/persistence.rb
 - lib/kube/cluster/version.rb
 - lib/kube/cluster/version.rb.erb
+- lib/kube/errors.rb
 homepage: https://github.com/general-intelligence-systems/kube_cluster
 licenses:
 - Apache-2.0

data/Rakefile

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-require "rake/testtask"
-
-Rake::TestTask.new(:test) do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/**/*_test.rb"]
-end
-
-task default: :test