process_bot 0.1.5 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8ba4b3227493fa167bf23dfa8338ab83baf626a444eb91ff98d8d7ce40056cc2
-  data.tar.gz: 605f53e2980a549cb945470e6010877ce2b4eed5f5adef5dd7c80f2f46976332
+  metadata.gz: 5f2f79412eb217c8a18aa20f8f54e0009bbc646c51ad253a852889b80d4e2a04
+  data.tar.gz: ccb5234f5d4e43d00f1bb12256d01eac975c40e4ed7d8c393ff9c990022fd459
 SHA512:
-  metadata.gz: cf82581d6d23036f2bbd5a91587f752b89d45e5c24a045193acd24911eb7ef5e427991baa7d0c6bb9299207c0c67595b4b645fb13743737e5771fde19063edba
-  data.tar.gz: 49f2aeca472a0a5957b86f70db38be1516faf8503ba04b70108e6ef8bf91b40b1bd2cb241339e79b447ba47290e47a25c81568cf516fbfa057a0745742f7e061
+  metadata.gz: 9860f2583903182f3e8cb5ca55dc181fcc0fdd41c2a895f9d50899627b7bcc1279cdfc4089d4ad69f9ed97e36f311f3d4a00949581add9082589e4ab947ea709
+  data.tar.gz: 1a54dca286519b9f16786ba142fca462906218fd2ef1fdd0e50cfb75332502ccc4a295706348d1e415c965d253d6c4c8fb6a20758c179caf20696ae2a42677ec

data/.rubocop.yml

@@ -4,7 +4,7 @@ AllCops:
   NewCops: enable
   TargetRubyVersion: 2.7
 
-require:
+plugins:
   - rubocop-performance
   - rubocop-rake
   - rubocop-rspec

data/Gemfile

@@ -5,11 +5,6 @@ source "https://rubygems.org"
 # Specify your gem's dependencies in process_bot.gemspec
 gemspec
 
-gem "pry"
-gem "rake"
-gem "rspec"
-gem "string-cases"
-
 group :development do
   gem "rubocop"
   gem "rubocop-performance"

data/Gemfile.lock

@@ -1,8 +1,12 @@
 PATH
   remote: .
   specs:
-    process_bot (0.1.5)
+    process_bot (0.1.6)
       knjrbfw (>= 0.0.116)
+      pry
+      rake
+      rspec
+      string-cases
 
 GEM
   remote: https://rubygems.org/
@@ -10,10 +14,10 @@ GEM
     ast (2.4.3)
     coderay (1.1.3)
     datet (0.0.25)
-    diff-lcs (1.5.1)
+    diff-lcs (1.6.2)
     http2 (0.0.36)
       string-cases (~> 0)
-    json (2.10.2)
+    json (2.13.2)
     knjrbfw (0.0.116)
       datet
       http2
@@ -21,11 +25,11 @@ GEM
       ruby_process
       tsafe
       wref (>= 0.0.8)
-    language_server-protocol (3.17.0.4)
+    language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
     method_source (1.1.0)
-    parallel (1.26.3)
-    parser (3.3.7.4)
+    parallel (1.27.0)
+    parser (3.3.9.0)
       ast (~> 2.4.1)
       racc
     php4r (0.0.4)
@@ -38,23 +42,23 @@ GEM
       method_source (~> 1.0)
     racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.2.1)
+    rake (13.3.0)
     ref (2.0.0)
-    regexp_parser (2.10.0)
-    rspec (3.13.0)
+    regexp_parser (2.11.2)
+    rspec (3.13.1)
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)
       rspec-mocks (~> 3.13.0)
-    rspec-core (3.13.0)
+    rspec-core (3.13.5)
       rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.0)
+    rspec-expectations (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.0)
+    rspec-mocks (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-support (3.13.0)
-    rubocop (1.75.2)
+    rspec-support (3.13.5)
+    rubocop (1.80.0)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -62,10 +66,10 @@ GEM
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.44.0, < 2.0)
+      rubocop-ast (>= 1.46.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.44.0)
+    rubocop-ast (1.46.0)
       parser (>= 3.3.7.2)
       prism (~> 1.4)
     rubocop-performance (1.25.0)
@@ -75,7 +79,7 @@ GEM
     rubocop-rake (0.7.1)
       lint_roller (~> 1.1)
       rubocop (>= 1.72.1)
-    rubocop-rspec (3.5.0)
+    rubocop-rspec (3.6.0)
       lint_roller (~> 1.1)
       rubocop (~> 1.72, >= 1.72.1)
     ruby-progressbar (1.13.0)
@@ -86,7 +90,7 @@ GEM
     string-cases (0.0.4)
     string-strtr (0.0.3)
     tsafe (0.0.12)
-    unicode-display_width (3.1.4)
+    unicode-display_width (3.1.5)
       unicode-emoji (~> 4.0, >= 4.0.4)
     unicode-emoji (4.0.4)
     wref (0.0.11)
@@ -98,14 +102,10 @@ PLATFORMS
 
 DEPENDENCIES
   process_bot!
-  pry
-  rake
-  rspec
   rubocop
   rubocop-performance
   rubocop-rake
   rubocop-rspec
-  string-cases
 
 BUNDLED WITH
    2.3.8

data/exe/process_bot

@@ -2,8 +2,7 @@
 
 require "pathname"
 
-ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
-  Pathname.new(__FILE__).realpath)
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile", Pathname.new(__FILE__).realpath)
 
 require "bundler/setup"
 require "optparse"

data/lib/process_bot/capistrano/custom.rake

@@ -0,0 +1,31 @@
+git_plugin = self
+
+namespace :process_bot do
+  namespace :custom do
+    desc "Stops the custom command"
+    task :stop do
+      git_plugin.process_bot_command(
+        process_bot_data,
+        :stop,
+        "--handler" => "custom",
+        "--name" => ENV.fetch("PROCESS_BOT_CUSTOM_ID")
+      )
+    end
+
+    desc "Starts a custom command"
+    task :start do
+      git_plugin.process_bot_command(
+        process_bot_data,
+        :start,
+        "--handler" => "custom",
+        "--name" => ENV.fetch("PROCESS_BOT_CUSTOM_ID")
+      )
+    end
+
+    desc "Restart a custom command"
+    task :restart do
+      invoke! "process_bot:custom:stop"
+      invoke! "process_bot:custom:start"
+    end
+  end
+end

data/lib/process_bot/capistrano/puma/common.rb

@@ -54,7 +54,7 @@ module ProcessBot::Capistrano::Puma::Common
       kind == :ssl
     end
 
-    def tcp
+    def tcp # rubocop:disable Naming/PredicateMethod
       kind == :tcp || ssl?
     end
 

data/lib/process_bot/capistrano/sidekiq_helpers.rb

@@ -32,7 +32,7 @@ module ProcessBot::Capistrano::SidekiqHelpers # rubocop:disable Metrics/ModuleLe
     end
   end
 
-  def process_bot_command(process_bot_data, command) # rubocop:disable Metrics/AbcSize
+  def process_bot_command(process_bot_data, command, args = {}) # rubocop:disable Metrics/AbcSize
     raise "No port in process bot data? #{process_bot_data}" unless process_bot_data["port"]
 
     mode = "exec"
@@ -55,6 +55,10 @@ module ProcessBot::Capistrano::SidekiqHelpers # rubocop:disable Metrics/ModuleLe
         "--command #{command} " \
         "--port #{process_bot_data.fetch("port")}"
 
+      args.each do |key, value|
+        backend_command << "#{key} #{value}"
+      end
+
       if command == :graceful && !fetch(:process_bot_wait_for_gracefully_stopped).nil?
         backend_command << " --wait-for-gracefully-stopped #{fetch(:process_bot_wait_for_gracefully_stopped)}"
       end

data/lib/process_bot/client_socket.rb

@@ -20,7 +20,7 @@ class ProcessBot::ClientSocket
   end
 
   def send_command(data) # rubocop:disable Metrics/AbcSize
-    logger.log "Sending: #{data}"
+    logger.logs "Sending: #{data}"
     client.puts(JSON.generate(data))
     response_raw = client.gets
 

data/lib/process_bot/control_socket.rb

@@ -23,8 +23,8 @@ class ProcessBot::ControlSocket
   def start_tcp_server
     tries ||= 0
     tries += 1
-    @server = TCPServer.new("localhost", @port)
-  rescue Errno::EADDRNOTAVAIL => e
+    @server = actually_start_tcp_server("localhost", @port)
+  rescue Errno::EADDRINUSE, Errno::EADDRNOTAVAIL => e
     if tries <= 100
       @port += 1
       retry
@@ -33,8 +33,12 @@ class ProcessBot::ControlSocket
     end
   end
 
+  def actually_start_tcp_server(host, port)
+    TCPServer.new(host, port)
+  end
+
   def stop
-    server.close
+    server&.close
   end
 
   def run_client_loop
@@ -68,8 +72,8 @@ class ProcessBot::ControlSocket
           process.__send__(command_type, **command_options)
           client.puts(JSON.generate(type: "success"))
         rescue => e # rubocop:disable Style/RescueStandardError
-          logger.logs e.message, type: :stderr
-          logger.logs e.backtrace, type: :stderr
+          logger.error e.message
+          logger.error e.backtrace
 
           client.puts(JSON.generate(type: "error", message: e.message, backtrace: e.backtrace))
 

data/lib/process_bot/logger.rb

@@ -5,6 +5,10 @@ class ProcessBot::Logger
     @options = options
   end
 
+  def error(output)
+    logs(output, type: :stderr)
+  end
+
   def log(output, type: :stdout)
     if type == :stdout || (type == :debug && options[:debug])
       $stdout.print output

data/lib/process_bot/process/handlers/custom.rb

@@ -0,0 +1,54 @@
+class ProcessBot::Process::Handlers::Custom
+  attr_reader :options, :process
+
+  def initialize(process)
+    @process = process
+    @options = process.options
+  end
+
+  def current_pid
+    process.current_pid
+  end
+
+  def daemonize
+    logger.logs "Daemonize!"
+
+    pid = Process.fork do
+      Process.daemon
+      yield
+    end
+
+    Process.detach(pid) if pid
+  end
+
+  def false_value?(value)
+    !value || value == "false"
+  end
+
+  def fetch(*args, **opts)
+    options.fetch(*args, **opts)
+  end
+
+  def logger
+    @logger ||= ProcessBot::Logger.new(options: options)
+  end
+
+  def set_option(key, value)
+    raise "Unknown option for Sidekiq handler: #{key}" unless options.key?(key)
+
+    set(key, value)
+  end
+
+  def set(*args, **opts)
+    options.set(*args, **opts)
+  end
+
+  def start_command
+    "bash -c 'cd #{options.fetch(:release_path)} && #{options.options.fetch(:custom_command)}'"
+  end
+
+  def stop(**_args)
+    puts "Stop related processes"
+    process.runner.stop_related_processes
+  end
+end

data/lib/process_bot/process/handlers/sidekiq.rb

@@ -92,20 +92,27 @@ class ProcessBot::Process::Handlers::Sidekiq
   end
 
   def stop(**_args)
-    process.set_stopped
+    if current_pid
+      Process.kill("TERM", current_pid)
+    else
+      related_sidekiq_processes = process.runner.related_sidekiq_processes
 
-    unless current_pid
-      warn "#{handler_name} not running with a PID"
-      return
+      if related_sidekiq_processes.empty?
+        logger.error "#{handler_name} didn't have any processes running"
+      else
+        related_sidekiq_processes.each do |related_sidekiq_process|
+          Process.kill("TERM", related_sidekiq_process.pid)
+        end
+      end
     end
-
-    Process.kill("TERM", current_pid)
   end
 
   def wait_for_no_jobs # rubocop:disable Metrics/AbcSize
     loop do
       found_process = false
 
+      raise "No current PID for Sidekiq" unless current_pid
+
       Knj::Unix_proc.list("grep" => current_pid) do |process|
         process_command = process.data.fetch("cmd")
         process_pid = process.data.fetch("pid").to_i

data/lib/process_bot/process/runner.rb

@@ -1,14 +1,15 @@
 require "knjrbfw"
 
 class ProcessBot::Process::Runner
-  attr_reader :command, :exit_status, :logger, :monitor, :options, :pid, :stop_time, :subprocess_pid
+  attr_reader :command, :exit_status, :handler_instance, :handler_name, :logger, :monitor, :options, :pid, :stop_time, :subprocess_pid
 
-  def initialize(command:, logger:, options:)
+  def initialize(command:, handler_instance:, handler_name:, logger:, options:)
     @command = command
+    @handler_instance = handler_instance
+    @handler_name = handler_name
     @logger = logger
     @monitor = Monitor.new
     @options = options
-    @output = []
   end
 
   def output(output:, type:)
@@ -52,11 +53,13 @@ class ProcessBot::Process::Runner
         end
       end
 
-      find_sidekiq_pid
+      find_sidekiq_pid if handler_name == "sidekiq"
 
       stdout_reader_thread.join
       stderr_reader_thread.join
 
+      logger.logs "Process stopped"
+
       @stop_time = Time.new
     end
   end
@@ -69,32 +72,71 @@ class ProcessBot::Process::Runner
     options.fetch(:application)
   end
 
-  def find_sidekiq_pid # rubocop:disable Metrics/AbcSize
-    Thread.new do
-      while running? && !pid
-        Knj::Unix_proc.list("grep" => "sidekiq") do |process|
-          cmd = process.data.fetch("cmd")
+  def related_processes
+    related_processes = []
 
-          if /sidekiq ([0-9]+\.[0-9]+\.[0-9]+) (#{options.possible_process_titles_joined_regex})/.match?(cmd)
-            sidekiq_pid = process.data.fetch("pid").to_i
+    Knj::Unix_proc.list do |process|
+      begin
+        process_pgid = Process.getpgid(process.pid)
+      rescue Errno::ESRCH
+        # Process no longer running
+      end
 
-            begin
-              sidekiq_pgid = Process.getpgid(sidekiq_pid)
-            rescue Errno::ESRCH
-              # Process no longer running
-            end
+      related_processes << process if subprocess_pgid == process_pgid
+    end
 
-            if subprocess_pgid == sidekiq_pgid
-              puts "FOUND PID: #{sidekiq_pid}"
+    related_processes
+  end
 
-              @pid = sidekiq_pid
-              options.events.call(:on_process_started, pid: pid)
+  def related_sidekiq_processes
+    related_sidekiq_processes = []
 
-              break
-            else
-              puts "PGID didn't match - Sidekiq: #{sidekiq_pgid} Own: #{subprocess_pgid}"
-            end
-          end
+    Knj::Unix_proc.list("grep" => "sidekiq") do |process|
+      cmd = process.data.fetch("cmd")
+
+      if /sidekiq ([0-9]+\.[0-9]+\.[0-9]+) (#{options.possible_process_titles_joined_regex})/.match?(cmd)
+        sidekiq_pid = process.data.fetch("pid").to_i
+
+        begin
+          sidekiq_pgid = Process.getpgid(sidekiq_pid)
+        rescue Errno::ESRCH
+          # Process no longer running
+        end
+
+        related_sidekiq_processes << process if subprocess_pgid == sidekiq_pgid
+      end
+    end
+
+    related_sidekiq_processes
+  end
+
+  def stop_related_processes
+    loop do
+      processes = related_processes
+
+      if processes.length <= 0
+        logger.logs "No related processes could be found"
+        break
+      else
+        processes.each do |process|
+          logger.logs "Terminating PID #{process.pid}: #{process.data.fetch("cmd")}"
+          Process.kill("TERM", process.pid)
+        end
+
+        sleep 0.5
+      end
+    end
+  end
+
+  def find_sidekiq_pid
+    Thread.new do
+      while running? && !pid
+        related_sidekiq_processes.each do |related_sidekiq_process| # rubocop:disable Lint/UnreachableLoop
+          puts "FOUND PID: #{related_sidekiq_process.pid}"
+          @pid = related_sidekiq_process.pid
+          options.events.call(:on_process_started, pid: related_sidekiq_process.pid)
+
+          break
         end
 
         unless pid

data/lib/process_bot/process.rb

@@ -29,7 +29,11 @@ class ProcessBot::Process
     if command == "start"
       start
     elsif command == "graceful" || command == "stop"
-      client.send_command(command: command, options: options.options)
+      begin
+        client.send_command(command: command, options: options.options)
+      rescue Errno::ECONNREFUSED => e
+        raise e unless options[:ignore_no_process_bot]
+      end
     else
       raise "Unknown command: #{command}"
     end
@@ -68,6 +72,10 @@ class ProcessBot::Process
     update_process_title
   end
 
+  def set_stopped
+    @stopped = true
+  end
+
   def start_control_socket
     @control_socket = ProcessBot::ControlSocket.new(options: options, process: self)
     @control_socket.start
@@ -88,15 +96,26 @@ class ProcessBot::Process
     end
   end
 
-  def set_stopped
+  def stop(**args)
+    puts "Stop process #{args}"
     @stopped = true
+    handler_instance.stop
   end
 
   def run
-    runner = ProcessBot::Process::Runner.new(command: handler_instance.start_command, logger: logger, options: options)
     runner.run
   end
 
+  def runner
+    @runner ||= ProcessBot::Process::Runner.new(
+      command: handler_instance.start_command,
+      handler_name: handler_name,
+      handler_instance: handler_instance,
+      logger: logger,
+      options: options
+    )
+  end
+
   def update_process_title
     process_args = {application: options[:application], handler: handler_name, id: options[:id], pid: current_pid, port: port}
     @current_process_title = "ProcessBot #{JSON.generate(process_args)}"

data/lib/process_bot/version.rb

@@ -1,3 +1,3 @@
 module ProcessBot
-  VERSION = "0.1.5".freeze
+  VERSION = "0.1.6".freeze
 end

data/process_bot.gemspec

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require_relative "lib/process_bot/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "process_bot"
+  spec.version = ProcessBot::VERSION
+  spec.authors = ["kaspernj"]
+  spec.email = ["k@spernj.org"]
+
+  spec.summary = "Run and control processes."
+  spec.description = "Run and control processes."
+  spec.homepage = "https://github.com/kaspernj/process_bot"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 2.7.0"
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/kaspernj/process_bot"
+  spec.metadata["changelog_uri"] = "https://github.com/kaspernj/process_bot/blob/master/CHANGELOG.md"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      f.match(%r{\A(?:(?:bin|pkg|test|spec|features)/|\.(?:git|github|travis|circleci)|appveyor)})
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "knjrbfw", ">= 0.0.116"
+  spec.add_dependency "pry"
+  spec.add_dependency "rake"
+  spec.add_dependency "rspec"
+  spec.add_dependency "string-cases"
+
+  spec.metadata["rubygems_mfa_required"] = "true"
+end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: process_bot
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.6
 platform: ruby
 authors:
 - kaspernj
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-04-08 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: knjrbfw
@@ -24,6 +23,62 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.0.116
+- !ruby/object:Gem::Dependency
+  name: pry
+  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: rake
+  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: rspec
+  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: string-cases
+  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'
 description: Run and control processes.
 email:
 - k@spernj.org
@@ -44,6 +99,7 @@ files:
 - exe/process_bot
 - lib/process_bot.rb
 - lib/process_bot/capistrano.rb
+- lib/process_bot/capistrano/custom.rake
 - lib/process_bot/capistrano/puma.rake
 - lib/process_bot/capistrano/puma.rb
 - lib/process_bot/capistrano/puma/common.rb
@@ -56,11 +112,12 @@ files:
 - lib/process_bot/options.rb
 - lib/process_bot/process.rb
 - lib/process_bot/process/handlers.rb
+- lib/process_bot/process/handlers/custom.rb
 - lib/process_bot/process/handlers/sidekiq.rb
 - lib/process_bot/process/runner.rb
 - lib/process_bot/version.rb
 - peak_flow.yml
-- sig/process_bot.rbs
+- process_bot.gemspec
 homepage: https://github.com/kaspernj/process_bot
 licenses:
 - MIT
@@ -70,7 +127,6 @@ metadata:
   source_code_uri: https://github.com/kaspernj/process_bot
   changelog_uri: https://github.com/kaspernj/process_bot/blob/master/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -85,8 +141,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Run and control processes.
 test_files: []

data/sig/process_bot.rbs

@@ -1,4 +0,0 @@
-module ProcessBot
-  VERSION: String
-  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-end