pvectl 0.2.0

data/sig/pvectl/config/models/user.rbs

@@ -0,0 +1,31 @@
+module Pvectl
+  module Config
+    module Models
+      class User
+        SECRET_MASK: String
+
+        attr_reader name: String
+        attr_reader token_id: String?
+        attr_reader token_secret: String?
+        attr_reader username: String?
+        attr_reader password: String?
+
+        def initialize: (
+          name: String,
+          ?token_id: String?,
+          ?token_secret: String?,
+          ?username: String?,
+          ?password: String?
+        ) -> void
+
+        def token_auth?: () -> bool
+        def password_auth?: () -> bool
+        def valid?: () -> bool
+
+        def self.from_hash: (Hash[String, untyped]) -> User
+
+        def to_hash: (?mask_secrets: bool) -> Hash[String, untyped]
+      end
+    end
+  end
+end

data/sig/pvectl/config/provider.rbs

@@ -0,0 +1,40 @@
+module Pvectl
+  module Config
+    class Provider
+      ENV_VARS: Hash[String, Symbol]
+      INTEGER_VARS: Array[Symbol]
+      BOOLEAN_VARS: Array[Symbol]
+
+      def file_exists?: (String path) -> bool
+      def insecure_permissions?: (String path) -> bool
+      def load_file: (String path) -> Hash[String, untyped]
+      def load_env: () -> Hash[Symbol, untyped]
+      def resolve_context_name: (cli_options: Hash[Symbol, untyped], ?file_config: Hash[String, untyped]) -> String?
+
+      def resolve: (
+        config_path: String,
+        cli_options: Hash[Symbol, untyped],
+        ?cluster_override: String?
+      ) -> Models::ResolvedConfig
+
+      private
+
+      def parse_env_value: (Symbol key, String value) -> untyped
+      def parse_boolean_env: (String value) -> bool
+      def parse_integer_env: (Symbol key, String value) -> Integer
+      def find_context: (Hash[String, untyped] config, String name) -> Models::Context
+      def find_cluster: (Hash[String, untyped] config, String name) -> Models::Cluster
+      def find_user: (Hash[String, untyped] config, String name) -> Models::User
+
+      def build_resolved_config: (
+        context: Models::Context,
+        cluster: Models::Cluster,
+        user: Models::User,
+        env_config: Hash[Symbol, untyped],
+        cli_options: Hash[Symbol, untyped]
+      ) -> Models::ResolvedConfig
+
+      def resolve_auth: (Models::User user, Hash[Symbol, untyped] env_config) -> [Symbol, String?, String?, String?, String?]
+    end
+  end
+end

data/sig/pvectl/config/service.rbs

@@ -0,0 +1,65 @@
+module Pvectl
+  module Config
+    class Service
+      DEFAULT_CONFIG_PATH: String
+
+      attr_reader config_path: String
+      attr_reader raw_config: Hash[String, untyped]
+      attr_reader current_context_name: String
+
+      def initialize: (?provider: Provider?, ?store: Store?, ?wizard: Wizard?) -> void
+
+      def load: (?Hash[Symbol, untyped] cli_options) -> Service
+      def current_config: () -> Models::ResolvedConfig
+
+      def contexts: () -> Array[Models::Context]
+      def context: (String name) -> Models::Context?
+
+      def use_context: (String context_name) -> void
+
+      def set_context: (
+        name: String,
+        cluster: String,
+        user: String,
+        ?default_node: String?
+      ) -> Models::Context
+
+      def clusters: () -> Array[Models::Cluster]
+      def cluster: (String name) -> Models::Cluster?
+
+      def set_cluster: (
+        name: String,
+        server: String,
+        ?verify_ssl: bool,
+        ?certificate_authority: String?
+      ) -> Models::Cluster
+
+      def users: () -> Array[Models::User]
+      def user: (String name) -> Models::User?
+
+      def set_credentials: (
+        name: String,
+        ?token_id: String?,
+        ?token_secret: String?,
+        ?username: String?,
+        ?password: String?
+      ) -> Models::User
+
+      def masked_config: () -> Hash[String, untyped]
+      def save: () -> void
+
+      private
+
+      @provider: Provider
+      @store: Store
+      @wizard: Wizard?
+      @loaded: bool
+      @resolved_config: Models::ResolvedConfig?
+
+      def resolve_config_path: (Hash[Symbol, untyped] cli_options) -> String
+      def warn_insecure_permissions: () -> void
+      def refresh_raw_config: () -> void
+      def deep_copy: (untyped obj) -> untyped
+    end
+  end
+end

data/sig/pvectl/config/store.rbs

@@ -0,0 +1,14 @@
+module Pvectl
+  module Config
+    class Store
+      SECURE_MODE: Integer
+      SECURE_DIR_MODE: Integer
+
+      def save: (String path, Hash[String, untyped] config) -> void
+      def update_current_context: (String path, String context_name) -> void
+      def upsert_context: (String path, Models::Context context) -> void
+      def upsert_cluster: (String path, Models::Cluster cluster) -> void
+      def upsert_user: (String path, Models::User user) -> void
+    end
+  end
+end

data/sig/pvectl/config/wizard.rbs

@@ -0,0 +1,48 @@
+module Pvectl
+  module Config
+    class Wizard
+      def self.available?: () -> bool
+
+      def initialize: (?prompt: untyped?) -> void
+
+      def run: () -> Hash[String, untyped]
+
+      private
+
+      attr_reader prompt: untyped
+
+      def create_default_prompt: () -> untyped
+      def prompt_server: () -> String
+      def prompt_ssl: () -> bool
+      def prompt_auth_type: () -> Symbol
+      def prompt_credentials: (Symbol auth_type) -> Hash[Symbol, String]
+      def prompt_context_name: () -> String
+
+      def build_config: (
+        server: String,
+        verify_ssl: bool,
+        auth_type: Symbol,
+        credentials: Hash[Symbol, String],
+        context_name: String
+      ) -> Hash[String, untyped]
+
+      def build_user_config: (String name, Symbol auth_type, Hash[Symbol, String] credentials) -> Hash[String, untyped]
+      def valid_server_url?: (String url) -> bool
+      def valid_token_id?: (String token_id) -> bool
+    end
+
+    class SimplePrompt
+      def ask: (String question, ?default: untyped, ?required: bool, ?convert: Symbol?, **untyped) -> untyped
+      def yes?: (String question, **untyped) -> bool
+      def select: (String question, Array[untyped] choices, **untyped) -> untyped
+      def mask: (String question, **untyped) -> String?
+      def ok: (untyped message) -> void
+      def warn: (untyped message) -> void
+      def error: (untyped message) -> void
+
+      private
+
+      def convert_value: (untyped value, Symbol? type) -> untyped
+    end
+  end
+end

data/sig/pvectl/config_serializer.rbs

@@ -0,0 +1,121 @@
+module Pvectl
+  module ConfigSerializer
+    VM_SECTIONS: Hash[Symbol, Hash[Symbol, Array[Symbol] | Array[Regexp] | Hash[Symbol, Hash[Symbol, Array[Symbol] | Array[Regexp]]]]]
+
+    CONTAINER_SECTIONS: Hash[Symbol, Hash[Symbol, Array[Symbol] | Array[Regexp] | Hash[Symbol, Hash[Symbol, Array[Symbol] | Array[Regexp]]]]]
+
+    YAML_SPECIAL_CHARS: Array[String]
+
+    AGENT_DEFAULTS: Hash[Symbol, String]
+
+    VM_DEFAULTS: Hash[Symbol, String]
+
+    VM_BOOLEAN_KEYS: Array[Symbol]
+
+    CT_BOOLEAN_KEYS: Array[Symbol]
+
+    HOTPLUG_CAPABILITIES: Array[Symbol]
+
+    AGENT_BOOLEAN_SUBKEYS: Array[Symbol]
+
+    NET_BOOLEAN_SUBKEYS: Array[Symbol]
+
+    DISK_BOOLEAN_SUBKEYS: Array[Symbol]
+
+    VM_COMPLEX_KEYS: Hash[Symbol, Hash[Symbol, Regexp | Symbol]]
+
+    CT_COMPLEX_KEYS: Hash[Symbol, Hash[Symbol, Regexp | Symbol]]
+
+    def self.to_yaml: (Hash[Symbol, untyped] flat_config, type: Symbol, ?resource: Hash[Symbol, untyped]) -> String
+
+    def self.from_yaml: (String yaml_string, type: Symbol) -> Hash[Symbol, untyped]
+
+    def self.validate: (String yaml_string, type: Symbol) -> Array[String]
+
+    def self.readonly_violations: (Hash[Symbol, untyped] original_flat, Hash[Symbol, untyped] edited_flat, type: Symbol) -> Array[String]
+
+    def self.diff: (Hash[Symbol, untyped] original, Hash[Symbol, untyped] edited) -> Hash[Symbol, Hash[Symbol, untyped] | Array[Symbol]]
+
+    def self.format_diff: (Hash[Symbol, untyped] diff_hash) -> String
+
+    def self.to_nested: (Hash[Symbol, untyped] flat_config, type: Symbol) -> Hash[Symbol, Hash[Symbol, untyped]]
+
+    def self.from_nested: (Hash[Symbol, untyped] nested, type: Symbol) -> Hash[Symbol, untyped]
+
+    def self.complete_from_api: (Hash[Symbol, untyped] manifest_flat, Hash[Symbol, untyped] api_flat, type: Symbol) -> Hash[Symbol, untyped]
+
+    private
+
+    def self.sections_for: (Symbol type) -> Hash[Symbol, untyped]
+
+    def self.header_comment: (Symbol type, Hash[Symbol, untyped] resource) -> String
+
+    def self.keys_for_section: (Hash[Symbol, untyped] config, Hash[Symbol, Array[Symbol] | Array[Regexp]] section_def) -> Array[Symbol]
+
+    def self.key_in_section?: (Symbol key, Hash[Symbol, Array[Symbol] | Array[Regexp]] section_def) -> bool
+
+    def self.readonly_key?: (Symbol key, Hash[Symbol, Array[Symbol] | Array[Regexp]] section_def) -> bool
+
+    def self.collect_readonly_keys: (Array[Symbol] keys, Hash[Symbol, untyped] sections) -> Array[Symbol]
+
+    def self.format_yaml_value: (untyped value) -> String
+
+    def self.needs_quoting?: (String value) -> bool
+
+    def self.strip_comments: (String yaml_string) -> String
+
+    def self.wrapper_section?: (Hash[Symbol, untyped] section_def) -> bool
+
+    def self.inject_defaults: (Hash[Symbol, untyped] flat_config, Symbol type) -> Hash[Symbol, untyped]
+
+    def self.to_boolean: (untyped value) -> (bool | untyped)
+
+    def self.from_boolean: (untyped value) -> (Integer | untyped)
+
+    def self.boolean_keys_for: (Symbol type) -> Array[Symbol]
+
+    def self.render_leaf_section: (Array[String] lines, Symbol section_name, Hash[Symbol, Array[Symbol] | Array[Regexp]] section_def, Hash[Symbol, untyped] flat_config) -> void
+
+    def self.render_wrapper_section: (Array[String] lines, Symbol wrapper_name, Hash[Symbol, untyped] wrapper_def, Hash[Symbol, untyped] flat_config) -> void
+
+    def self.validate_wrapper_section: (Array[String] errors, String wrapper_name, Hash[Symbol, untyped] wrapper_def, Hash[String, untyped] wrapper_values) -> void
+
+    def self.each_leaf_section: (Hash[Symbol, untyped] sections) -> Array[Hash[Symbol, Array[Symbol] | Array[Regexp]]]
+
+    def self.flatten_sections: (Hash[String, untyped] parsed) -> Hash[Symbol, untyped]
+
+    def self.complex_keys_for: (Symbol type) -> Hash[Symbol, Hash[Symbol, Regexp | Symbol]]
+
+    def self.find_complex_key: (Symbol key, Symbol type) -> Hash[Symbol, Regexp | Symbol]?
+
+    def self.build_nested_section: (Hash[Symbol, untyped] flat_config, Hash[Symbol, Array[Symbol] | Array[Regexp]] section_def, Symbol type) -> Hash[Symbol, untyped]
+
+    def self.flatten_nested_section: (Hash[Symbol, untyped] section_hash, Symbol type, Hash[Symbol, untyped] result) -> void
+
+    def self.parse_vm_net_value: (String string) -> Hash[Symbol, untyped]
+
+    def self.serialize_vm_net_value: (Hash[Symbol, untyped] hash) -> String
+
+    def self.normalize_cloudinit_volume: (untyped parsed) -> untyped
+
+    def self.parse_disk_value: (String string) -> Hash[Symbol, untyped]
+
+    def self.serialize_disk_value: (Hash[Symbol, untyped] hash) -> String
+
+    def self.parse_kv_value: (String string, ?default_key: Symbol?) -> Hash[Symbol, String?]
+
+    def self.serialize_kv_value: (Hash[Symbol, String] hash) -> String
+
+    def self.parse_agent_value: (String string) -> Hash[Symbol, untyped]
+
+    def self.serialize_agent_value: (Hash[Symbol, untyped] hash) -> String
+
+    def self.parse_boot_value: (String string) -> Hash[Symbol, String | Array[String]]
+
+    def self.serialize_boot_value: (Hash[Symbol, String | Array[String]] hash) -> String
+
+    def self.parse_hotplug_value: (String string) -> Hash[Symbol, bool]
+
+    def self.serialize_hotplug_value: (Hash[Symbol, bool] hash) -> String
+  end
+end

data/sig/pvectl/connection/retry_handler.rbs

@@ -0,0 +1,31 @@
+module Pvectl
+  class Connection
+    class RetryHandler
+      RETRYABLE_EXCEPTIONS: Array[singleton(StandardError)]
+
+      READ_METHODS: Array[Symbol]
+
+      attr_reader max_retries: Integer
+
+      attr_reader base_delay: Numeric
+
+      attr_reader max_delay: Numeric
+
+      attr_reader retry_writes: bool
+
+      attr_reader logger: untyped
+
+      def initialize: (max_retries: Integer, base_delay: Numeric, max_delay: Numeric, ?retry_writes: bool, ?logger: untyped) -> void
+
+      def with_retry: [T] (?method: Symbol) { () -> T } -> T
+
+      private
+
+      def should_retry?: (Symbol method, Integer attempts) -> bool
+
+      def calculate_delay: (Integer attempt) -> Numeric
+
+      def log_retry: (Integer attempt, Numeric delay, Exception error) -> void
+    end
+  end
+end

data/sig/pvectl/connection.rbs

@@ -0,0 +1,35 @@
+module Pvectl
+  class Connection
+    attr_reader config: untyped
+
+    attr_reader retry_handler: untyped
+
+    def initialize: (untyped config, ?logger: untyped?) -> void
+
+    def client: () -> untyped
+
+    def verify!: () -> void
+
+    def version: () -> Hash[String, untyped]
+
+    private
+
+    @config: untyped
+
+    @client: untyped?
+
+    @logger: untyped?
+
+    @retry_handler: untyped
+
+    def with_timeout: [T] () { () -> T } -> T
+
+    def create_client: () -> untyped
+
+    def extract_host: () -> String
+
+    def build_client_options: () -> Hash[Symbol, untyped]
+
+    def parse_username: (String full_username) -> [String, String]
+  end
+end

data/sig/pvectl/console/terminal_session.rbs

@@ -0,0 +1,63 @@
+module Pvectl
+  module Console
+    class TerminalSession
+      CTRL_CLOSE_BRACKET: String
+
+      PING_INTERVAL: Integer
+
+      READ_CHUNK_SIZE: Integer
+
+      def initialize: (url: String, cookie: String, user: String, ticket: String, verify_ssl: bool) -> void
+
+      def run: () -> void
+
+      private
+
+      def encode_input: (String data) -> String
+
+      def encode_resize: (Integer cols, Integer rows) -> String
+
+      def encode_ping: () -> String
+
+      def disconnect_key?: (String byte) -> bool
+
+      def handshake_message: () -> String
+
+      def open_socket: (URI::Generic uri) -> (TCPSocket | OpenSSL::SSL::SSLSocket)
+
+      def wrap_ssl: (TCPSocket tcp, String hostname) -> OpenSSL::SSL::SSLSocket
+
+      def create_driver: (URI::Generic uri, TCPSocket | OpenSSL::SSL::SSLSocket socket) -> untyped
+
+      def build_referer: (URI::Generic uri) -> String
+
+      def read_from_socket: (TCPSocket | OpenSSL::SSL::SSLSocket socket, timeout: Numeric) -> String?
+
+      def perform_websocket_handshake: (untyped driver, TCPSocket | OpenSSL::SSL::SSLSocket socket) -> void
+
+      def run_io_loop: (untyped driver, TCPSocket | OpenSSL::SSL::SSLSocket socket) -> void
+
+      def handle_stdin: (untyped driver) -> void
+
+      def handle_socket: (untyped driver, TCPSocket | OpenSSL::SSL::SSLSocket socket) -> void
+
+      def enable_raw_terminal: () -> void
+
+      def restore_terminal: () -> void
+
+      def send_initial_resize: (untyped driver) -> void
+
+      def trap_resize: (untyped driver) -> void
+
+      def detect_terminal_size: () -> [Integer, Integer]
+
+      class SocketAdapter
+        attr_reader url: String
+
+        def initialize: (String url, TCPSocket | OpenSSL::SSL::SSLSocket socket) -> void
+
+        def write: (String data) -> Integer
+      end
+    end
+  end
+end

data/sig/pvectl/editor_session.rbs

@@ -0,0 +1,33 @@
+module Pvectl
+  class EditorSession
+    ERROR_SEPARATOR: String
+
+    def initialize: (?editor: _Callable?, ?validator: _Callable?) -> void
+
+    def edit: (String original_content) -> String?
+
+    private
+
+    @editor: _Callable
+
+    @validator: _Callable?
+
+    interface _Callable
+      def call: (untyped) -> untyped
+    end
+
+    def edit_loop: (String path, String original_content) -> String?
+
+    def cancelled?: (String content, String original_content) -> bool
+
+    def inject_errors: (String path, String content, Array[String] errors) -> void
+
+    def strip_error_block: (String content) -> String
+
+    def build_error_block: (Array[String] errors) -> String
+
+    def system_editor: (String path) -> void
+
+    def default_editor: () -> String?
+  end
+end

data/sig/pvectl/exit_codes.rbs

@@ -0,0 +1,19 @@
+module Pvectl
+  module ExitCodes
+    SUCCESS: Integer
+
+    GENERAL_ERROR: Integer
+
+    USAGE_ERROR: Integer
+
+    CONFIG_ERROR: Integer
+
+    CONNECTION_ERROR: Integer
+
+    NOT_FOUND: Integer
+
+    PERMISSION_DENIED: Integer
+
+    INTERRUPTED: Integer
+  end
+end

data/sig/pvectl/formatters/base.rbs

@@ -0,0 +1,13 @@
+module Pvectl
+  module Formatters
+    class Base
+      def format: (untyped data, untyped presenter, ?color_enabled: bool, **untyped context) -> String
+
+      public
+
+      def collection?: (untyped data) -> bool
+
+      def normalize_nil: (untyped value, ?String nil_placeholder) -> untyped
+    end
+  end
+end

data/sig/pvectl/formatters/color_support.rbs

@@ -0,0 +1,13 @@
+module Pvectl
+  module Formatters
+    module ColorSupport
+      STATUS_COLORS: Hash[String, Symbol]
+
+      def self.enabled?: (?explicit_flag: bool?) -> bool
+
+      def self.pastel: (?explicit_flag: bool?) -> untyped
+
+      def self.colorize_status: (String? status, untyped pastel_instance) -> String
+    end
+  end
+end

data/sig/pvectl/formatters/json.rbs

@@ -0,0 +1,7 @@
+module Pvectl
+  module Formatters
+    class Json < Base
+      def format: (untyped data, untyped presenter, ?color_enabled: bool, ?describe: bool, **untyped context) -> String
+    end
+  end
+end

data/sig/pvectl/formatters/output_helper.rbs

@@ -0,0 +1,9 @@
+module Pvectl
+  module Formatters
+    module OutputHelper
+      def self.print: (data: untyped, presenter: untyped, ?format: String, ?color_flag: bool?, ?describe: bool, **untyped context) -> void
+
+      def self.render: (data: untyped, presenter: untyped, ?format: String, ?color_flag: bool?, ?describe: bool, **untyped context) -> String
+    end
+  end
+end

data/sig/pvectl/formatters/registry.rbs

@@ -0,0 +1,13 @@
+module Pvectl
+  module Formatters
+    class Registry
+      FORMATS: Hash[String, singleton(Base)]
+
+      def self.for: (String | Symbol format_name) -> Base
+
+      def self.available_formats: () -> Array[String]
+
+      def self.supported?: (String | Symbol format_name) -> bool
+    end
+  end
+end

data/sig/pvectl/formatters/table.rbs

@@ -0,0 +1,25 @@
+module Pvectl
+  module Formatters
+    class Table < Base
+      def format: (untyped data, untyped presenter, ?color_enabled: bool, ?describe: bool, **untyped context) -> String
+
+      private
+
+      def format_table: (untyped data, untyped presenter, untyped pastel, **untyped context) -> String
+
+      def format_describe: (untyped model, untyped presenter, untyped pastel) -> String
+
+      def colorize_row: (Array[untyped] row, Array[String] headers, untyped pastel) -> Array[untyped]
+
+      def format_describe_hash: (Hash[untyped, untyped]? hash, untyped pastel, ?indent: Integer) -> String
+
+      def format_describe_table: (Array[Hash[untyped, untyped]] array, ?indent: Integer) -> String
+
+      def format_describe_value: (untyped value, String key, untyped pastel) -> String
+
+      def humanize_key: (String | Symbol key) -> String
+
+      def render_table: (Array[String] headers, Array[Array[untyped]] rows) -> String
+    end
+  end
+end

data/sig/pvectl/formatters/wide.rbs

@@ -0,0 +1,15 @@
+module Pvectl
+  module Formatters
+    class Wide < Base
+      def format: (untyped data, untyped presenter, ?color_enabled: bool, ?describe: bool, **untyped context) -> String
+
+      private
+
+      def format_wide_table: (untyped data, untyped presenter, bool color_enabled, **untyped context) -> String
+
+      def colorize_row: (Array[untyped] row, Array[String] headers, untyped pastel) -> Array[untyped]
+
+      def render_table: (Array[String] headers, Array[Array[untyped]] rows) -> String
+    end
+  end
+end

data/sig/pvectl/formatters/yaml.rbs

@@ -0,0 +1,7 @@
+module Pvectl
+  module Formatters
+    class Yaml < Base
+      def format: (untyped data, untyped presenter, ?color_enabled: bool, ?describe: bool, **untyped context) -> String
+    end
+  end
+end

data/sig/pvectl/manifest_serializer.rbs

@@ -0,0 +1,18 @@
+module Pvectl
+  module ManifestSerializer
+    API_VERSION: String
+    KINDS: Hash[Symbol, String]
+    KINDS_REVERSE: Hash[String, Symbol]
+
+    def self.to_yaml: (Hash[Symbol, untyped] nested_config, type: Symbol, metadata: Hash[Symbol, untyped]) -> String
+    def self.from_yaml: (String yaml_string) -> Hash[Symbol, untyped]
+    def self.validate: (String yaml_string) -> Array[String]
+
+    private
+
+    def self.build_metadata: (Hash[Symbol, untyped] metadata) -> Hash[String, untyped]
+    def self.stringify_keys_deep: (Hash[Symbol, untyped] hash) -> Hash[String, untyped]
+    def self.symbolize_metadata: (Hash[String, untyped] hash) -> Hash[Symbol, untyped]
+    def self.symbolize_keys_deep: (Hash[String, untyped] hash) -> Hash[Symbol, untyped]
+  end
+end

data/sig/pvectl/models/apt_package.rbs

@@ -0,0 +1,26 @@
+module Pvectl
+  module Models
+    class AptPackage < Base
+      attr_reader package: String?
+      attr_reader title: String?
+      attr_reader version: String?
+      attr_reader old_version: String?
+      attr_reader origin: String?
+      attr_reader section: String?
+      attr_reader priority: String?
+      attr_reader arch: String?
+      attr_reader description: String?
+      attr_reader notify_status: String?
+      attr_reader current_state: String?
+      attr_reader manager_version: String?
+      attr_reader running_kernel: String?
+      attr_reader node: String?
+
+      def initialize: (?Hash[Symbol, untyped] attrs) -> void
+
+      def upgrade?: () -> bool
+
+      def installed_state: () -> String
+    end
+  end
+end