kube_cluster 0.1.1 → 0.2.0

data/examples/quick-repl/docker-compose.yml

@@ -0,0 +1,52 @@
+# to run define K3S_TOKEN, K3S_VERSION is optional, eg:
+#   K3S_TOKEN=${RANDOM}${RANDOM}${RANDOM} docker-compose up
+
+services:
+
+  server:
+    image: "rancher/k3s:${K3S_VERSION:-latest}"
+    command: server
+    tmpfs:
+      - /run
+      - /var/run
+    ulimits:
+      nproc: 65535
+      nofile:
+        soft: 65535
+        hard: 65535
+    privileged: true
+    restart: always
+    environment:
+      - K3S_TOKEN=${K3S_TOKEN:?err}
+      - K3S_KUBECONFIG_OUTPUT=/output/kubeconfig.yaml
+      - K3S_KUBECONFIG_MODE=666
+    volumes:
+      #- k3s-server:/var/lib/rancher/k3s
+      # This is just so that we get the kubeconfig file out
+      - .:/output
+    ports:
+      - 6443:6443  # Kubernetes API Server
+      - 80:80      # Ingress controller port 80
+      - 443:443    # Ingress controller port 443
+
+  #agent:
+  #  image: "rancher/k3s:${K3S_VERSION:-latest}"
+  #  tmpfs:
+  #    - /run
+  #    - /var/run
+  #  ulimits:
+  #    nproc: 65535
+  #    nofile:
+  #      soft: 65535
+  #      hard: 65535
+  #  privileged: true
+  #  restart: always
+  #  environment:
+  #    - K3S_URL=https://server:6443
+  #    - K3S_TOKEN=${K3S_TOKEN:?err}
+  #  volumes:
+  #    - k3s-agent:/var/lib/rancher/k3s
+
+#volumes:
+#  k3s-server: {}
+#  k3s-agent: {}

data/exe/kube_cluster

@@ -1,6 +1,6 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-require_relative "../lib/kube_cluster"
+require_relative "../lib/kube/cluster"
 
 puts "hello from kube_cluster"

data/kube_cluster.gemspec

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
-require_relative "lib/kube_cluster/version"
+require_relative "lib/kube/cluster/version"
 
 Gem::Specification.new do |spec|
   spec.name = "kube_cluster"
-  spec.version = KubeCluster::VERSION
+  spec.version = Kube::Cluster::VERSION
   spec.authors = ["Nathan K"]
   spec.email = ["nathankidd@hey.com"]
 
@@ -23,7 +23,7 @@ Gem::Specification.new do |spec|
   spec.metadata["documentation_uri"] = spec.homepage
   spec.metadata["rubygems_mfa_required"] = "true"
 
-  spec.files = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features|data)/}) }
+  spec.files = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   spec.bindir = "exe"
   spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
@@ -31,4 +31,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "minitest", "~> 5.0"
   spec.add_development_dependency "rake", "~> 13.0"
   spec.add_development_dependency "rubocop", "~> 1.21"
+
+  spec.add_dependency "kube_schema", "~> 1.0"
 end

data/lib/kube/cluster/command_node.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+module Kube
+  module Cluster
+    class CommandNode
+      include Enumerable
+
+      BLANK_DATA = { commands: [], resource: nil, args: [], flags: {} }.freeze
+
+      attr_reader :command_data
+
+      def initialize(current_node:, command_data: BLANK_DATA)
+        @current_node = current_node
+        @command_data = command_data
+      end
+
+      def flag(key, value = nil)
+        self.class.new(
+          current_node: @current_node,
+          command_data: @command_data.merge(
+            flags: @command_data[:flags].merge(key.to_s.tr("_", "-") => value)
+          )
+        )
+      end
+
+      def each(&block)
+        to_a.each(&block)
+      end
+
+      def to_a
+        QueryBuilder.new(@command_data).to_a
+      end
+
+      def to_s
+        QueryBuilder.new(@command_data).to_s
+      end
+
+      def inspect
+        "#<#{self.class.name} #{to_s}>"
+      end
+
+      def method_missing(name, *args, &block)
+        segment = name.to_s.tr("_", "-")
+        child   = @current_node.children[segment]
+
+        if child&.command?
+          self.class.new(
+            current_node: child,
+            command_data: @command_data.merge(
+              commands: @command_data[:commands] + [segment],
+              args:     @command_data[:args] + args.map(&:to_s)
+            )
+          )
+        elsif child&.resource?
+          self.class.new(
+            current_node: child,
+            command_data: @command_data.merge(
+              resource: (@command_data[:resource] || ResourceSelector.new) + [segment],
+              args:     @command_data[:args] + args.map(&:to_s)
+            )
+          )
+        elsif @current_node.resource? || @current_node.children.empty?
+          # Leaf command or already in resource mode — free-form resource segment
+          self.class.new(
+            current_node: TreeNode.new(name: segment, type: :resource),
+            command_data: @command_data.merge(
+              resource: (@command_data[:resource] || ResourceSelector.new) + [segment],
+              args:     @command_data[:args] + args.map(&:to_s)
+            )
+          )
+        elsif Enumerable.method_defined?(name)
+          to_a.public_send(name, *args, &block)
+        else
+          super
+        end
+      end
+
+      def respond_to_missing?(name, include_private = false)
+        segment = name.to_s.tr("_", "-")
+
+        @current_node.children.key?(segment) ||
+          @current_node.resource? ||
+          @current_node.children.empty? ||
+          Enumerable.method_defined?(name) ||
+          super
+      end
+    end
+  end
+end

data/lib/kube/cluster/ctl.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Kube
+  module Cluster
+    class Ctl
+      GEM_ROOT = File.expand_path("../../..", __dir__)
+
+      COMMAND_TREE = JSON.parse(
+        File.read(File.join(GEM_ROOT, "data", "kubectl-command-tree-v1-minimal.json"))
+      )
+
+      ROOT = TreeNode.new(
+        name:     "kubectl",
+        type:     :command,
+        children: TreeNode.build(COMMAND_TREE)
+      )
+
+      def method_missing(name, *args, &block)
+        CommandNode.new(current_node: ROOT).public_send(name, *args, &block)
+      end
+
+      def respond_to_missing?(name, include_private = false)
+        CommandNode.new(current_node: ROOT).respond_to?(name) || super
+      end
+
+      def inspect
+        "#<#{self.class.name}>"
+      end
+    end
+  end
+end

data/lib/kube/cluster/query_builder.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require "open3"
+
+module Kube
+  module Cluster
+    class QueryBuilder
+      def initialize(command_data)
+        @commands = command_data[:commands] || []
+        @resource = command_data[:resource]
+        @args     = command_data[:args] || []
+        @flags    = command_data[:flags] || {}
+      end
+
+      def to_s
+        ["kubectl", *@commands, *resource_arg, *@args, *rendered_flags].join(" ")
+      end
+
+      def to_a
+        stdout, _status = Open3.capture2("kubectl", *@commands, *resource_arg, *@args, *rendered_flags)
+        stdout.lines.map(&:chomp)
+      end
+
+      private
+
+      def resource_arg
+        @resource ? [@resource.to_s] : []
+      end
+
+      def rendered_flags
+        @flags.flat_map { |k, v| v.nil? ? ["--#{k}"] : ["--#{k}", v.to_s] }
+      end
+    end
+  end
+end

data/lib/kube/cluster/resource_selector.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Kube
+  module Cluster
+    class ResourceSelector < Array
+      def +(other)
+        self.class.new(super)
+      end
+
+      def to_s
+        join(".")
+      end
+
+      def to_regex
+        Regexp.new(map { |s| Regexp.escape(s) }.join('.*\.'))
+      end
+    end
+  end
+end

data/lib/kube/cluster/tree_node.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Kube
+  module Cluster
+    class TreeNode
+      # Commands whose leaf children are resource types.
+      # Non-leaf children (those with their own subtree) remain commands.
+      RESOURCE_PARENTS = %w[
+        create
+        create/secret
+        create/service
+        top
+      ].freeze
+
+      attr_reader :name, :type, :children
+
+      def initialize(name:, type:, children: {})
+        @name     = name.freeze
+        @type     = type
+        @children = children.freeze
+      end
+
+      def command?  = type == :command
+      def resource? = type == :resource
+
+      # Recursively build a children hash of TreeNodes from the parsed JSON.
+      # parent_path tracks position in the tree to determine child types.
+      def self.build(hash, parent_path: nil)
+        hash.each_with_object({}) do |(key, subtree), children|
+          name         = key.to_s
+          current_path = [parent_path, name].compact.join("/")
+          leaf         = subtree.empty?
+
+          # Under a resource parent, leaf nodes are resources, non-leaves are commands.
+          # Everywhere else, everything is a command.
+          child_type = if RESOURCE_PARENTS.include?(parent_path.to_s) && leaf
+                         :resource
+                       else
+                         :command
+                       end
+
+          children[name] = new(
+            name:     name,
+            type:     child_type,
+            children: build(subtree, parent_path: current_path)
+          )
+        end
+      end
+    end
+  end
+end

data/lib/kube/cluster/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Kube
+  module Cluster
+    VERSION = "0.2.0"
+  end
+end

data/lib/kube/cluster/version.rb.erb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Kube
+  module Cluster
+    VERSION = "<%= version %>"
+  end
+end

data/lib/kube/cluster.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+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"
+
+module Kube
+  module Cluster
+    def self.ctl
+      Ctl.new
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kube_cluster
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Nathan K
@@ -51,6 +51,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.21'
+- !ruby/object:Gem::Dependency
+  name: kube_schema
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 description: 'OOP abstraction that allows you to deploy and manage kubernetes resources
   using Ruby.
 
@@ -64,24 +78,35 @@ extra_rdoc_files: []
 files:
 - ".envrc"
 - ".gitignore"
+- ".rubocop.yml"
 - Gemfile
+- Gemfile.lock
 - LICENSE
 - README.md
 - Rakefile
+- TREE_PLAN.md
 - bin/console
+- bin/generate-command-schema-v1
 - 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
 - flake.lock
 - flake.nix
 - kube_cluster.gemspec
-- kube_cluster.gemspec.erb
-- lib/kube_cluster.rb
-- lib/kube_cluster/version.rb
-- lib/kube_cluster/version.rb.erb
+- 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/version.rb
+- lib/kube/cluster/version.rb.erb
 homepage: https://github.com/general-intelligence-systems/kube_cluster
 licenses:
 - Apache-2.0

data/kube_cluster.gemspec.erb

@@ -1,34 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "lib/kube_cluster/version"
-
-Gem::Specification.new do |spec|
-  spec.name = "<%= gem_name %>"
-  spec.version = KubeCluster::VERSION
-  spec.authors = [<%= authors.map { |a| %("#{a}") }.join(", ") %>]
-  spec.email = [<%= emails.map { |e| %("#{e}") }.join(", ") %>]
-
-  spec.summary = "<%= summary %>"
-
-  spec.description = <<~DESC
-    <%= description %>
-  DESC
-
-  spec.homepage = "<%= homepage %>"
-  spec.license = "<%= license %>"
-  spec.required_ruby_version = ">= <%= ruby_version %>"
-
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = spec.homepage
-  spec.metadata["documentation_uri"] = spec.homepage
-  spec.metadata["rubygems_mfa_required"] = "true"
-
-  spec.files = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features|data)/}) }
-  spec.bindir = "exe"
-  spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  spec.add_development_dependency "minitest", "~> 5.0"
-  spec.add_development_dependency "rake", "~> 13.0"
-  spec.add_development_dependency "rubocop", "~> 1.21"
-end

data/lib/kube_cluster/version.rb

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

data/lib/kube_cluster/version.rb.erb

@@ -1,5 +0,0 @@
-# frozen_string_literal: true
-
-module KubeCluster
-  VERSION = "<%= version %>"
-end

data/lib/kube_cluster.rb

@@ -1,6 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "kube_cluster/version"
-
-module KubeCluster
-end