utils 0.80.0 → 0.82.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 74d1c4048d40164e89c4edcd2b3bd91516b0bf82d6f8d0b0d68c25b70c21927e
-  data.tar.gz: 290d49a38bd95423c93f0c5df749ada24245731369c9233d11f3de619f5099d6
+  metadata.gz: 3e7a6c6bc8c38c84587412e072fa0ddee7e9e854a61eb50b4caded051d1388b7
+  data.tar.gz: b6e695b2b379c591a0a402cf638e062d8ae84f516684bb72e8a7a6e4e71e3c66
 SHA512:
-  metadata.gz: 253d562cff1325f5218f89b6d800d6e656eeb3c8c5067a38581271720161c55a181c2fbba3e2ff815219805438af9dea258e59e6b00f12ba8485db172d4abab3
-  data.tar.gz: defe6add59ce6268f5d16f3ccc7f20da40c7436f686dfafd5d66cc2f4ed8aedc1a591e2eb1da69cdcfbaf4693fe19d0ba46e8a5d1e297170fbed8a1fec5d717a
+  metadata.gz: e3ac01c79b99a587b32f633dc5ec7d7df26688bdbf5ce24886a8c62f2dd8d13b2db518eeaed4912340b432fcbeee02ffac547ade62d3b7e44e846d3e3c79e089
+  data.tar.gz: 8e39fda010cb4a33cfbc00e390ddf750ffa57d4e39396eed007b489b04a67c1d8be8d3f0ef73930e9f9e9ba4bf714ed27fcea1c9cf3caecb6cc749afb856352c

data/Rakefile

@@ -20,7 +20,7 @@ GemHadar do
   readme      'README.md'
   licenses << 'GPL-2.0'
 
-  dependency 'unix_socks',     '~> 0.2'
+  dependency 'unix_socks',     '~> 0.3'
   dependency 'tins',           '~> 1.51'
   dependency 'term-ansicolor', '~> 1.11'
   dependency 'pstree',         '~> 0.3'

data/bin/code_comment

@@ -184,7 +184,7 @@ end
 filename_linenumber = ARGV.shift or fail "require file_name as second argument"
 $config = Utils::ConfigFile.new
 $config.configure_from_paths
-$config_dir             = Utils::ConfigDir.new('code_comment', env_var: 'XDG_CONFIG_HOME')
+$config_dir         = Utils::ConfigDir.new('code_comment', env_var: 'XDG_CONFIG_HOME')
 base_url            = ENV['OLLAMA_URL'] || 'http://%s' % ENV.fetch('OLLAMA_HOST')
 model               = ENV.fetch('OLLAMA_MODEL', 'llama3.1')
 construct, construct_type = fetch_construct(filename_linenumber)

data/bin/probe

@@ -14,6 +14,7 @@
 
 require 'utils'
 include Utils
+include Utils::Probe
 include Tins::GO
 require 'shellwords'
 
@@ -78,7 +79,10 @@ end
 # probe server instance to handle incoming requests and process jobs.
 def start_server
   Thread.abort_on_exception = $DEBUG
-  Utils::ProbeServer.new.start
+  ProbeServer.new(
+    server_type: $config.probe.server_type,
+    port: $config.probe.tcp_server_port
+  ).start
 end
 
 # The connect_server method establishes a connection to a probe server and
@@ -89,7 +93,10 @@ end
 # It also enqueues jobs for execution on the probe server when specified.
 #
 def connect_server
-  probe_client = ProbeClient.new
+  probe_client = ProbeClient.new(
+    server_type: $config.probe.server_type,
+    port: $config.probe.tcp_server_port
+  )
   if setting = $opts[?C]
     case setting
     when /\A([^=]+)=([^=]+)\z/

data/lib/utils/config_dir.rb

@@ -31,20 +31,6 @@ module Utils
       @directory_path = derive_directory_path(name, root_path)
     end
 
-    # Memoizes the foobar method's return value and returns the result of the computation.
-    # Initializes a new ConfigDir instance with the specified name and optional
-    # root path or environment variable.
-    #
-    # @param name [ String ] the name of the directory to be used
-    # @param root_path [ String, nil ] the root path to use; if nil, the
-    #                                  default root path is used
-    # @param env_var [ String, nil ] the name of the environment variable to
-    #                                check for the root path
-    def initialize(name, root_path: nil, env_var: nil)
-      root_path ||= env_var_path(env_var)
-      @directory_path = derive_directory_path(name, root_path)
-    end
-
     # Returns the string representation of the configuration directory path.
     #
     # @return [ String ] the path of the configuration directory as a string

data/lib/utils/config_file.rb

@@ -224,6 +224,23 @@ class Utils::ConfigFile
     # @param dirs [ Array<String> ] the array of directory names to include
     config :include_dirs, %w[lib test tests ext spec]
 
+    # The server_type method configures the type of server to be used.
+    #
+    # This method sets up the server type configuration option, which
+    # determines the underlying server implementation to be utilized, this is
+    # either :unix for UNIX domain sockets or :tcp for TCP Sockets.
+    #
+    # @return [ Symbol ] returns the server type configured
+    config :server_type, :unix
+
+    # The tcp_server_port method configures the TCP server port setting.
+    #
+    # This method sets up a configuration option that specifies the port number
+    # to be used for TCP server operations.
+    #
+    # @param value [ Integer ] the TCP server port number to use
+    config :tcp_server_port, 59999
+
     # The include_dirs_argument method constructs a colon-separated string from
     # include directories.
     #

data/lib/utils/irb.rb

@@ -2,6 +2,7 @@ require 'irb/completion'
 require 'enumerator'
 require 'tempfile'
 require 'pp'
+require 'shellwords'
 require 'utils'
 require_maybe 'ap'
 
@@ -83,6 +84,48 @@ module Utils
         ri(*patterns, doc: 'yri')
       end
 
+      # The ai method interacts with an Ollama chat service to process queries
+      # and optionally return responses.
+      #
+      # This method constructs command-line arguments for the ollama_chat_send
+      # utility based on the provided options, executes the command with the
+      # query as input, and returns the response if requested.
+      #
+      # @param query [ String ] the input query to send to the Ollama chat
+      #   service
+      # @param command [ TrueClass, FalseClass ] whether to treat the query as
+      #   a command
+      # @param respond [ TrueClass, FalseClass ] whether to capture and return
+      #   the response from the service
+      # @param parse [ TrueClass, FalseClass ] whether to parse the response
+      # @param dir [ String ] the directory to use for the operation
+      #
+      # @return [ String, nil ] the response from the Ollama chat service if
+      #   respond is true, otherwise nil
+      def ai(query, command: false, respond: false, parse: false, dir: ?.)
+        dir = File.expand_path(dir)
+        args = {
+          ?r => respond,
+          ?t => command,
+          ?p => parse,
+          ?d => dir,
+        }
+        args = args.map { |k, v|
+          v == false and next
+          v == true ? "-#{k}" : [ "-#{k}", v.to_s ]
+        }.flatten.compact
+        args.unshift 'ollama_chat_send'
+        response = nil
+        IO.popen(Shellwords.join(args), 'r+') do |io|
+          io.write query
+          io.close_write
+          if respond
+            response = io.read
+          end
+        end
+        response
+      end
+
       # The irb_open method opens a URL or executes a block to capture output
       # and open it.
       #

data/lib/utils/probe/probe_client.rb

@@ -0,0 +1,98 @@
+module Utils::Probe
+  # A client for interacting with the probe server through Unix domain sockets.
+  #
+  # This class provides an interface for enqueueing process jobs and managing
+  # environment variables on a remote probe server. It uses Unix domain sockets
+  # to communicate with the server, enabling distributed task execution and
+  # configuration management.
+  class ProbeClient
+    include ServerHandling
+
+    # A proxy class for managing environment variables through a probe server communication channel.
+    #
+    # This class provides a wrapper around the ENV object that allows setting and retrieving
+    # environment variables while logging these operations through the probe server.
+    # It intercepts assignments and lookups to provide visibility into environment modifications
+    # during probe server operations.
+    class EnvProxy
+      # The initialize method sets up a new instance with the provided server
+      # object.
+      #
+      # @param server [ UnixSocks::Server ] the server object to be assigned
+      # to the instance variable
+      def initialize(server)
+        @server = server
+      end
+
+      # The []= method sets an environment variable value through the probe server.
+      #
+      # This method transmits a request to the probe server to set the specified
+      # environment variable key to the given value, then returns the updated
+      # environment value from the server's response.
+      #
+      # @param key [ String ] the environment variable key to set
+      # @param value [ String ] the value to assign to the environment variable
+      #
+      # @return [ String ] the updated environment variable value returned by the server
+      def []=(key, value)
+        response = @server.transmit_with_response(type: 'set_env', key:, value:)
+        response.env
+      end
+
+      # The [] method retrieves the value of an environment variable from the probe server.
+      #
+      # This method sends a request to the probe server to fetch the current value of the specified
+      # environment variable key and returns the corresponding value.
+      #
+      # @param key [ String ] the environment variable key to retrieve
+      #
+      # @return [ String ] the value of the specified environment variable
+      def [](key)
+        response = @server.transmit_with_response(type: 'get_env', key:)
+        response.env
+      end
+
+      attr_reader :env
+    end
+
+    # The initialize method sets up a new probe server instance.
+    #
+    # This method creates and configures a Unix domain socket server for
+    # handling probe jobs and communication. It initializes the server with a
+    # specific socket name and runtime directory, preparing it to listen for
+    # incoming connections and process jobs.
+    #
+    # @return [ Utils::ProbeServer ] a new probe server instance configured with
+    #         the specified socket name and runtime directory
+    def initialize(server_type: :unix, port: 6666)
+      @server = create_server(server_type, port)
+    end
+
+    # The env method provides access to environment variable management through
+    # a proxy object.
+    #
+    # This method returns an EnvProxy instance that allows for setting and
+    # retrieving environment variables via the probe server communication
+    # channel.
+    #
+    # @return [ Utils::ProbeServer::EnvProxy ] a proxy object for environment
+    # variable operations
+    def env
+      EnvProxy.new(@server)
+    end
+
+    # The enqueue method submits a new process job to the probe server for
+    # execution.
+    #
+    # This method transmits a process job request to the underlying Unix domain
+    # socket server, which then adds the job to the processing queue. The job
+    # includes the specified command arguments that will be executed by the
+    # probe server.
+    #
+    # @param args [ Array ] the command arguments to be executed by the process
+    # job
+    def enqueue(args)
+      @server.transmit({ type: 'process_job', args: })
+    end
+  end
+end

data/lib/utils/{probe_server.rb → probe/probe_server.rb}

@@ -1,231 +1,4 @@
-require 'unix_socks'
-require 'term/ansicolor'
-
-module Utils
-  # A process job representation for execution within the probe server system.
-  #
-  # This class encapsulates the information and behavior associated with a
-  # single executable task that can be enqueued and processed by a ProbeServer.
-  # It holds command arguments, manages execution status, and provides
-  # mechanisms for serialization and display of job information.
-  class ProcessJob
-    include Term::ANSIColor
-
-    # Initializes a new ProcessJob instance with the specified arguments and
-    # optional probe server.
-    #
-    # This method creates a process job object that can be enqueued for
-    # execution by a probe server. It assigns a unique job ID from the probe
-    # server if provided and stores the command arguments as an array.
-    #
-    # @param args [ Array ] the command arguments to be executed by the job
-    # @param probe_server [ Utils::ProbeServer, nil ] the probe server instance
-    # to use for generating job IDs
-    #
-    # @return [ Utils::ProcessJob ] a new ProcessJob instance configured with
-    # the provided arguments and server reference
-    def initialize(args:, probe_server: nil)
-      @id   = probe_server&.next_job_id
-      @args = Array(args)
-    end
-
-    # Returns the unique identifier of the process job.
-    #
-    # @return [ Integer ] the job ID
-    attr_reader :id
-
-    # The args reader method provides access to the arguments stored in the
-    # instance.
-    #
-    # @return [ Array ] the array of arguments
-    attr_reader :args
-
-    # The ok method sets the success status of the process job.
-    #
-    # @param value [ TrueClass, FalseClass, nil ] the success status to set
-    attr_writer :ok
-
-    # Returns the type identifier for the process job.
-    #
-    # This method provides a constant string value that identifies the object
-    # as a process job within the probe server system, facilitating type-based
-    # dispatch and handling.
-    #
-    # @return [ String ] the string 'process_job' indicating the object's type
-    def type
-      'process_job'
-    end
-
-    # The ok method returns a character representation of the job's success
-    # status.
-    #
-    # This method provides a visual indicator of whether a process job has
-    # succeeded, failed, or is still in progress. It returns 'y' for successful
-    # jobs, 'n' for failed jobs, and '…' for jobs that are currently running or
-    # pending.
-    #
-    # @return [ String ] 'y' if the job succeeded, 'n' if it failed, or '…' if
-    # the status is unknown
-    def ok
-      case @ok
-      when false then 'n'
-      when true  then 'y'
-      else            '…'
-      end
-    end
-
-    # The ok_colorize method applies color formatting to a string based on the
-    # success status.
-    #
-    # This method returns the input string wrapped with color codes to indicate
-    # whether the associated process job succeeded, failed, or is in progress.
-    # Successful jobs are highlighted in green, failed jobs in red, and pending
-    # jobs are returned without any color formatting.
-    #
-    # @param string [ String ] the string to be colorized
-    #
-    # @return [ String ] the colorized string or the original string if status is unknown
-    def ok_colorize(string)
-      case @ok
-      when false then white { on_red { string } }
-      when true  then black { on_green { string } }
-      else            string
-      end
-    end
-
-    # The inspect method generates a colorized string representation of the
-    # process job.
-    #
-    # This method creates a formatted string that includes the job's unique
-    # identifier and its command arguments, with the status indicator
-    # color-coded based on whether the job succeeded, failed, or is pending.
-    #
-    # @return [ String ] a formatted string representation of the process job
-    #         including its ID, arguments, and color-coded status indicator
-    def inspect
-      ok_colorize("#{id} #{args.map { |a| a.include?(' ') ? a.inspect : a } * ' '}")
-    end
-
-    alias to_s inspect
-
-    # The as_json method converts the process job object into a
-    # JSON-serializable hash.
-    #
-    # This method creates and returns a hash representation of the process job,
-    # containing its type, unique identifier, and command arguments.
-    #
-    # @return [ Hash ] a hash containing the type, id, and args of the process job
-    def as_json(*)
-      { type:, id:, args:, }
-    end
-
-    # The to_json method converts the object to a JSON string representation.
-    #
-    # This method delegates to the as_json method to generate a hash representation
-    # of the object, then converts that hash to a JSON string using the
-    # standard JSON library's to_json method.
-    #
-    # @return [ String ] a JSON string representation of the object
-    def to_json(*)
-      as_json.to_json(*)
-    end
-  end
-
-  # A client for interacting with the probe server through Unix domain sockets.
-  #
-  # This class provides an interface for enqueueing process jobs and managing
-  # environment variables on a remote probe server. It uses Unix domain sockets
-  # to communicate with the server, enabling distributed task execution and
-  # configuration management.
-  class ProbeClient
-    # A proxy class for managing environment variables through a probe server communication channel.
-    #
-    # This class provides a wrapper around the ENV object that allows setting and retrieving
-    # environment variables while logging these operations through the probe server.
-    # It intercepts assignments and lookups to provide visibility into environment modifications
-    # during probe server operations.
-    class EnvProxy
-      # The initialize method sets up a new instance with the provided server
-      # object.
-      #
-      # @param server [ UnixSocks::Server ] the server object to be assigned
-      # to the instance variable
-      def initialize(server)
-        @server = server
-      end
-
-      # The []= method sets an environment variable value through the probe server.
-      #
-      # This method transmits a request to the probe server to set the specified
-      # environment variable key to the given value, then returns the updated
-      # environment value from the server's response.
-      #
-      # @param key [ String ] the environment variable key to set
-      # @param value [ String ] the value to assign to the environment variable
-      #
-      # @return [ String ] the updated environment variable value returned by the server
-      def []=(key, value)
-        response = @server.transmit_with_response(type: 'set_env', key:, value:)
-        response.env
-      end
-
-      # The [] method retrieves the value of an environment variable from the probe server.
-      #
-      # This method sends a request to the probe server to fetch the current value of the specified
-      # environment variable key and returns the corresponding value.
-      #
-      # @param key [ String ] the environment variable key to retrieve
-      #
-      # @return [ String ] the value of the specified environment variable
-      def [](key)
-        response = @server.transmit_with_response(type: 'get_env', key:)
-        response.env
-      end
-
-      attr_reader :env
-    end
-
-    # The initialize method sets up a new probe server instance.
-    #
-    # This method creates and configures a Unix domain socket server for
-    # handling probe jobs and communication. It initializes the server with a
-    # specific socket name and runtime directory, preparing it to listen for
-    # incoming connections and process jobs.
-    #
-    # @return [ Utils::ProbeServer ] a new probe server instance configured with
-    #         the specified socket name and runtime directory
-    def initialize
-      @server = UnixSocks::Server.new(socket_name: 'probe.sock', runtime_dir: Dir.pwd)
-    end
-
-    # The env method provides access to environment variable management through
-    # a proxy object.
-    #
-    # This method returns an EnvProxy instance that allows for setting and
-    # retrieving environment variables via the probe server communication
-    # channel.
-    #
-    # @return [ Utils::ProbeServer::EnvProxy ] a proxy object for environment
-    # variable operations
-    def env
-      EnvProxy.new(@server)
-    end
-
-    # The enqueue method submits a new process job to the probe server for
-    # execution.
-    #
-    # This method transmits a process job request to the underlying Unix domain
-    # socket server, which then adds the job to the processing queue. The job
-    # includes the specified command arguments that will be executed by the
-    # probe server.
-    #
-    # @param args [ Array ] the command arguments to be executed by the process
-    # job
-    def enqueue(args)
-      @server.transmit({ type: 'process_job', args: })
-    end
-  end
-
+module Utils::Probe
   # A probe server for managing and executing process jobs through Unix domain
   # sockets.
   #
@@ -234,6 +7,7 @@ module Utils
   # maintains a queue of jobs, tracks their execution status, and provides an
   # interactive interface for managing the server.
   class ProbeServer
+    include Utils::Probe::ServerHandling
     include Term::ANSIColor
 
     # The initialize method sets up a new probe server instance.
@@ -245,8 +19,8 @@ module Utils
     #
     # @return [ Utils::ProbeServer ] a new probe server instance configured
     # with the specified socket name and runtime directory
-    def initialize
-      @server         = UnixSocks::Server.new(socket_name: 'probe.sock', runtime_dir: Dir.pwd)
+    def initialize(server_type: :unix, port: 6666)
+      @server         = create_server(server_type, port)
       @history        = [].freeze
       @jobs_queue     = Queue.new
       @current_job_id = 0
@@ -258,7 +32,7 @@ module Utils
     # from the queue and entering a receive loop to handle incoming requests.
     # It also manages interrupt signals to enter interactive mode when needed.
     def start
-      output_message "Starting probe server listening to #{@server.server_socket_path}.", type: :info
+      output_message "Starting probe server listening to #{@server.to_url}", type: :info
       Thread.new do
         loop do
           job = @jobs_queue.pop
@@ -278,7 +52,7 @@ module Utils
           $VERBOSE = old
         end
         @server.remove_socket_path
-        output_message "Quitting interactive mode, but still listening to #{@server.server_socket_path}.", type: :info
+        output_message "Quitting interactive mode, but still listening to #{@server.to_url}", type: :info
         retry
       end
     end

data/lib/utils/probe/process_job.rb

@@ -0,0 +1,130 @@
+module Utils::Probe
+  # A process job representation for execution within the probe server system.
+  #
+  # This class encapsulates the information and behavior associated with a
+  # single executable task that can be enqueued and processed by a ProbeServer.
+  # It holds command arguments, manages execution status, and provides
+  # mechanisms for serialization and display of job information.
+  class ProcessJob
+    include Term::ANSIColor
+
+    # Initializes a new ProcessJob instance with the specified arguments and
+    # optional probe server.
+    #
+    # This method creates a process job object that can be enqueued for
+    # execution by a probe server. It assigns a unique job ID from the probe
+    # server if provided and stores the command arguments as an array.
+    #
+    # @param args [ Array ] the command arguments to be executed by the job
+    # @param probe_server [ Utils::ProbeServer, nil ] the probe server instance
+    # to use for generating job IDs
+    #
+    # @return [ Utils::ProcessJob ] a new ProcessJob instance configured with
+    # the provided arguments and server reference
+    def initialize(args:, probe_server: nil)
+      @id   = probe_server&.next_job_id
+      @args = Array(args)
+    end
+
+    # Returns the unique identifier of the process job.
+    #
+    # @return [ Integer ] the job ID
+    attr_reader :id
+
+    # The args reader method provides access to the arguments stored in the
+    # instance.
+    #
+    # @return [ Array ] the array of arguments
+    attr_reader :args
+
+    # The ok method sets the success status of the process job.
+    #
+    # @param value [ TrueClass, FalseClass, nil ] the success status to set
+    attr_writer :ok
+
+    # Returns the type identifier for the process job.
+    #
+    # This method provides a constant string value that identifies the object
+    # as a process job within the probe server system, facilitating type-based
+    # dispatch and handling.
+    #
+    # @return [ String ] the string 'process_job' indicating the object's type
+    def type
+      'process_job'
+    end
+
+    # The ok method returns a character representation of the job's success
+    # status.
+    #
+    # This method provides a visual indicator of whether a process job has
+    # succeeded, failed, or is still in progress. It returns 'y' for successful
+    # jobs, 'n' for failed jobs, and '…' for jobs that are currently running or
+    # pending.
+    #
+    # @return [ String ] 'y' if the job succeeded, 'n' if it failed, or '…' if
+    # the status is unknown
+    def ok
+      case @ok
+      when false then 'n'
+      when true  then 'y'
+      else            '…'
+      end
+    end
+
+    # The ok_colorize method applies color formatting to a string based on the
+    # success status.
+    #
+    # This method returns the input string wrapped with color codes to indicate
+    # whether the associated process job succeeded, failed, or is in progress.
+    # Successful jobs are highlighted in green, failed jobs in red, and pending
+    # jobs are returned without any color formatting.
+    #
+    # @param string [ String ] the string to be colorized
+    #
+    # @return [ String ] the colorized string or the original string if status is unknown
+    def ok_colorize(string)
+      case @ok
+      when false then white { on_red { string } }
+      when true  then black { on_green { string } }
+      else            string
+      end
+    end
+
+    # The inspect method generates a colorized string representation of the
+    # process job.
+    #
+    # This method creates a formatted string that includes the job's unique
+    # identifier and its command arguments, with the status indicator
+    # color-coded based on whether the job succeeded, failed, or is pending.
+    #
+    # @return [ String ] a formatted string representation of the process job
+    #         including its ID, arguments, and color-coded status indicator
+    def inspect
+      ok_colorize("#{id} #{args.map { |a| a.include?(' ') ? a.inspect : a } * ' '}")
+    end
+
+    alias to_s inspect
+
+    # The as_json method converts the process job object into a
+    # JSON-serializable hash.
+    #
+    # This method creates and returns a hash representation of the process job,
+    # containing its type, unique identifier, and command arguments.
+    #
+    # @return [ Hash ] a hash containing the type, id, and args of the process job
+    def as_json(*)
+      { type:, id:, args:, }
+    end
+
+    # The to_json method converts the object to a JSON string representation.
+    #
+    # This method delegates to the as_json method to generate a hash representation
+    # of the object, then converts that hash to a JSON string using the
+    # standard JSON library's to_json method.
+    #
+    # @return [ String ] a JSON string representation of the object
+    def to_json(*)
+      as_json.to_json(*)
+    end
+  end
+end

data/lib/utils/probe/server_handling.rb

@@ -0,0 +1,32 @@
+module Utils::Probe
+  # A module that provides server handling functionality for creating and
+  # managing socket servers.
+  #
+  # This module encapsulates the logic for initializing different types of
+  # socket servers based on the specified server type, supporting both TCP and
+  # domain socket configurations. It provides a centralized approach to server
+  # creation and management within the Utils library.
+  module ServerHandling
+    # The create_server method initializes and returns a socket server instance
+    # based on the specified server type.
+    #
+    # This method creates either a TCP socket server or a domain socket server
+    # depending on the server type parameter. It configures the server with the
+    # appropriate parameters including port number for TCP servers or socket
+    # name and runtime directory for domain sockets.
+    #
+    # @param server_type [ Symbol ] the type of socket server to create, either :tcp or another value for domain socket
+    # @param port [ Integer ] the port number to use for TCP socket server creation
+    #
+    # @return [ UnixSocks::TCPSocketServer, UnixSocks::DomainSocketServer ] a
+    #   new socket server instance of the specified type
+    def create_server(server_type, port)
+      case server_type
+      when :tcp
+        UnixSocks::TCPSocketServer.new(port:)
+      else
+        UnixSocks::DomainSocketServer.new(socket_name: 'probe.sock', runtime_dir: Dir.pwd)
+      end
+    end
+  end
+end

data/lib/utils/probe.rb

@@ -0,0 +1,23 @@
+# A module that provides probe server functionality for managing and executing
+# process jobs through Unix domain sockets.
+#
+# This module encapsulates the core components for creating and interacting
+# with probe servers that can enqueue and run process jobs in a distributed
+# manner.
+#
+# The module includes classes for handling server communication, managing
+# process jobs, and providing client interfaces for interacting with probe
+# servers.
+#
+# It supports both TCP and Unix domain socket configurations for server
+# communication and provides mechanisms for environment variable management and
+# job execution tracking.
+module Utils::Probe
+end
+
+require 'unix_socks'
+require 'term/ansicolor'
+require 'utils/probe/server_handling'
+require 'utils/probe/process_job'
+require 'utils/probe/probe_server'
+require 'utils/probe/probe_client'

data/lib/utils/version.rb

@@ -1,6 +1,6 @@
 module Utils
   # Utils version
-  VERSION         = '0.80.0'
+  VERSION         = '0.82.0'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

data/lib/utils.rb

@@ -14,7 +14,7 @@ module Utils
   require 'utils/editor'
   require 'utils/finder'
   require 'utils/grepper'
-  require 'utils/probe_server'
+  require 'utils/probe'
   require 'utils/ssh_tunnel_specification'
   require 'utils/line_blamer'
   require 'utils/config_dir'

data/utils.gemspec

@@ -1,9 +1,9 @@
 # -*- encoding: utf-8 -*-
-# stub: utils 0.80.0 ruby lib
+# stub: utils 0.82.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "utils".freeze
-  s.version = "0.80.0".freeze
+  s.version = "0.82.0".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
@@ -12,8 +12,8 @@ Gem::Specification.new do |s|
   s.description = "This ruby gem provides some useful command line utilities".freeze
   s.email = "flori@ping.de".freeze
   s.executables = ["ascii7".freeze, "blameline".freeze, "changes".freeze, "classify".freeze, "code_comment".freeze, "code_indexer".freeze, "commit_message".freeze, "discover".freeze, "edit".freeze, "edit_wait".freeze, "enum".freeze, "git-empty".freeze, "git-versions".freeze, "json_check".freeze, "long_lines".freeze, "myex".freeze, "on_change".freeze, "path".freeze, "print_method".freeze, "probe".freeze, "rainbow".freeze, "rd2md".freeze, "search".freeze, "sedit".freeze, "serve".freeze, "ssh-tunnel".freeze, "strip_spaces".freeze, "sync_dir".freeze, "untest".freeze, "utils-utilsrc".freeze, "vcf2alias".freeze, "yaml_check".freeze]
-  s.extra_rdoc_files = ["README.md".freeze, "lib/utils.rb".freeze, "lib/utils/config_dir.rb".freeze, "lib/utils/config_file.rb".freeze, "lib/utils/editor.rb".freeze, "lib/utils/finder.rb".freeze, "lib/utils/grepper.rb".freeze, "lib/utils/irb.rb".freeze, "lib/utils/line_blamer.rb".freeze, "lib/utils/line_formatter.rb".freeze, "lib/utils/md5.rb".freeze, "lib/utils/patterns.rb".freeze, "lib/utils/probe_server.rb".freeze, "lib/utils/ssh_tunnel_specification.rb".freeze, "lib/utils/version.rb".freeze, "lib/utils/xt/source_location_extension.rb".freeze]
-  s.files = ["Gemfile".freeze, "LICENSE".freeze, "README.md".freeze, "Rakefile".freeze, "bin/ascii7".freeze, "bin/blameline".freeze, "bin/changes".freeze, "bin/classify".freeze, "bin/code_comment".freeze, "bin/code_indexer".freeze, "bin/commit_message".freeze, "bin/discover".freeze, "bin/edit".freeze, "bin/edit_wait".freeze, "bin/enum".freeze, "bin/git-empty".freeze, "bin/git-versions".freeze, "bin/json_check".freeze, "bin/long_lines".freeze, "bin/myex".freeze, "bin/on_change".freeze, "bin/path".freeze, "bin/print_method".freeze, "bin/probe".freeze, "bin/rainbow".freeze, "bin/rd2md".freeze, "bin/search".freeze, "bin/sedit".freeze, "bin/serve".freeze, "bin/ssh-tunnel".freeze, "bin/strip_spaces".freeze, "bin/sync_dir".freeze, "bin/untest".freeze, "bin/utils-utilsrc".freeze, "bin/vcf2alias".freeze, "bin/yaml_check".freeze, "lib/utils.rb".freeze, "lib/utils/config_dir.rb".freeze, "lib/utils/config_file.rb".freeze, "lib/utils/editor.rb".freeze, "lib/utils/finder.rb".freeze, "lib/utils/grepper.rb".freeze, "lib/utils/irb.rb".freeze, "lib/utils/line_blamer.rb".freeze, "lib/utils/line_formatter.rb".freeze, "lib/utils/md5.rb".freeze, "lib/utils/patterns.rb".freeze, "lib/utils/probe_server.rb".freeze, "lib/utils/ssh_tunnel_specification.rb".freeze, "lib/utils/version.rb".freeze, "lib/utils/xt/source_location_extension.rb".freeze, "tests/test_helper.rb".freeze, "tests/utils_test.rb".freeze, "utils.gemspec".freeze]
+  s.extra_rdoc_files = ["README.md".freeze, "lib/utils.rb".freeze, "lib/utils/config_dir.rb".freeze, "lib/utils/config_file.rb".freeze, "lib/utils/editor.rb".freeze, "lib/utils/finder.rb".freeze, "lib/utils/grepper.rb".freeze, "lib/utils/irb.rb".freeze, "lib/utils/line_blamer.rb".freeze, "lib/utils/line_formatter.rb".freeze, "lib/utils/md5.rb".freeze, "lib/utils/patterns.rb".freeze, "lib/utils/probe.rb".freeze, "lib/utils/probe/probe_client.rb".freeze, "lib/utils/probe/probe_server.rb".freeze, "lib/utils/probe/process_job.rb".freeze, "lib/utils/probe/server_handling.rb".freeze, "lib/utils/ssh_tunnel_specification.rb".freeze, "lib/utils/version.rb".freeze, "lib/utils/xt/source_location_extension.rb".freeze]
+  s.files = ["Gemfile".freeze, "LICENSE".freeze, "README.md".freeze, "Rakefile".freeze, "bin/ascii7".freeze, "bin/blameline".freeze, "bin/changes".freeze, "bin/classify".freeze, "bin/code_comment".freeze, "bin/code_indexer".freeze, "bin/commit_message".freeze, "bin/discover".freeze, "bin/edit".freeze, "bin/edit_wait".freeze, "bin/enum".freeze, "bin/git-empty".freeze, "bin/git-versions".freeze, "bin/json_check".freeze, "bin/long_lines".freeze, "bin/myex".freeze, "bin/on_change".freeze, "bin/path".freeze, "bin/print_method".freeze, "bin/probe".freeze, "bin/rainbow".freeze, "bin/rd2md".freeze, "bin/search".freeze, "bin/sedit".freeze, "bin/serve".freeze, "bin/ssh-tunnel".freeze, "bin/strip_spaces".freeze, "bin/sync_dir".freeze, "bin/untest".freeze, "bin/utils-utilsrc".freeze, "bin/vcf2alias".freeze, "bin/yaml_check".freeze, "lib/utils.rb".freeze, "lib/utils/config_dir.rb".freeze, "lib/utils/config_file.rb".freeze, "lib/utils/editor.rb".freeze, "lib/utils/finder.rb".freeze, "lib/utils/grepper.rb".freeze, "lib/utils/irb.rb".freeze, "lib/utils/line_blamer.rb".freeze, "lib/utils/line_formatter.rb".freeze, "lib/utils/md5.rb".freeze, "lib/utils/patterns.rb".freeze, "lib/utils/probe.rb".freeze, "lib/utils/probe/probe_client.rb".freeze, "lib/utils/probe/probe_server.rb".freeze, "lib/utils/probe/process_job.rb".freeze, "lib/utils/probe/server_handling.rb".freeze, "lib/utils/ssh_tunnel_specification.rb".freeze, "lib/utils/version.rb".freeze, "lib/utils/xt/source_location_extension.rb".freeze, "tests/test_helper.rb".freeze, "tests/utils_test.rb".freeze, "utils.gemspec".freeze]
   s.homepage = "http://github.com/flori/utils".freeze
   s.licenses = ["GPL-2.0".freeze]
   s.rdoc_options = ["--title".freeze, "Utils - Some useful command line utilities".freeze, "--main".freeze, "README.md".freeze]
@@ -23,9 +23,9 @@ Gem::Specification.new do |s|
 
   s.specification_version = 4
 
-  s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 2.10".freeze])
+  s.add_development_dependency(%q<gem_hadar>.freeze, [">= 2.16.2".freeze])
   s.add_development_dependency(%q<test-unit>.freeze, [">= 0".freeze])
-  s.add_runtime_dependency(%q<unix_socks>.freeze, ["~> 0.2".freeze])
+  s.add_runtime_dependency(%q<unix_socks>.freeze, ["~> 0.3".freeze])
   s.add_runtime_dependency(%q<tins>.freeze, ["~> 1.51".freeze])
   s.add_runtime_dependency(%q<term-ansicolor>.freeze, ["~> 1.11".freeze])
   s.add_runtime_dependency(%q<pstree>.freeze, ["~> 0.3".freeze])

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: utils
 version: !ruby/object:Gem::Version
-  version: 0.80.0
+  version: 0.82.0
 platform: ruby
 authors:
 - Florian Frank
@@ -13,16 +13,16 @@ dependencies:
   name: gem_hadar
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.10'
+        version: 2.16.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.10'
+        version: 2.16.2
 - !ruby/object:Gem::Dependency
   name: test-unit
   requirement: !ruby/object:Gem::Requirement
@@ -43,14 +43,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.3'
 - !ruby/object:Gem::Dependency
   name: tins
   requirement: !ruby/object:Gem::Requirement
@@ -310,7 +310,11 @@ extra_rdoc_files:
 - lib/utils/line_formatter.rb
 - lib/utils/md5.rb
 - lib/utils/patterns.rb
-- lib/utils/probe_server.rb
+- lib/utils/probe.rb
+- lib/utils/probe/probe_client.rb
+- lib/utils/probe/probe_server.rb
+- lib/utils/probe/process_job.rb
+- lib/utils/probe/server_handling.rb
 - lib/utils/ssh_tunnel_specification.rb
 - lib/utils/version.rb
 - lib/utils/xt/source_location_extension.rb
@@ -362,7 +366,11 @@ files:
 - lib/utils/line_formatter.rb
 - lib/utils/md5.rb
 - lib/utils/patterns.rb
-- lib/utils/probe_server.rb
+- lib/utils/probe.rb
+- lib/utils/probe/probe_client.rb
+- lib/utils/probe/probe_server.rb
+- lib/utils/probe/process_job.rb
+- lib/utils/probe/server_handling.rb
 - lib/utils/ssh_tunnel_specification.rb
 - lib/utils/version.rb
 - lib/utils/xt/source_location_extension.rb