einhorn 0.8.2 → 1.0.1

data/lib/einhorn.rb

@@ -1,18 +1,36 @@
-require 'fcntl'
-require 'optparse'
-require 'pp'
-require 'set'
-require 'socket'
-require 'tmpdir'
-require 'yaml'
-require 'shellwords'
+require "fcntl"
+require "optparse"
+require "pp"
+require "set"
+require "socket"
+require "tmpdir"
+require "yaml"
+require "shellwords"
+require "einhorn/safe_yaml"
 
 module Einhorn
   module AbstractState
-    def default_state; raise NotImplementedError.new('Override in extended modules'); end
-    def state; @state ||= default_state; end
-    def state=(v); @state = v; end
-    def dumpable_state; state; end
+    def default_state
+      raise NotImplementedError.new("Override in extended modules")
+    end
+
+    def state
+      @state ||= default_state
+    end
+
+    def state=(v)
+      @state = v
+    end
+
+    def dumpable_state
+      state
+    end
+
+    def respond_to_missing?(name)
+      ((name.to_s =~ /(.*)=$/) && state.has_key?($1.to_sym)) ||
+        state.has_key?(name) ||
+        default_state.has_key?(name)
+    end
 
     def method_missing(name, *args)
       if (name.to_s =~ /(.*)=$/) && state.has_key?($1.to_sym)
@@ -37,39 +55,39 @@ module Einhorn
     # about backwards/forwards compatibility for upgrades/downgrades
     def self.default_state
       {
-        :children => {},
-        :config => {:number => 1, :backlog => 100, :seconds => 1},
-        :versions => {},
-        :version => 0,
-        :sockets => {},
-        :orig_cmd => nil,
-        :bind => [],
-        :bind_fds => [],
-        :bound_ports => [],
-        :cmd => nil,
-        :script_name => nil,
-        :respawn => true,
-        :upgrading => false,
-        :smooth_upgrade => false,
-        :reloading_for_upgrade => false,
-        :path => nil,
-        :cmd_name => nil,
-        :verbosity => 1,
-        :generation => 0,
-        :last_spinup => nil,
-        :ack_mode => {:type => :timer, :timeout => 1},
-        :kill_children_on_exit => false,
-        :command_socket_as_fd => false,
-        :socket_path => nil,
-        :pidfile => nil,
-        :lockfile => nil,
-        :consecutive_deaths_before_ack => 0,
-        :last_upgraded => nil,
-        :nice => {:master => nil, :worker => nil, :renice_cmd => '/usr/bin/renice'},
-        :reexec_commandline => nil,
-        :drop_environment_variables => [],
-        :signal_timeout => nil,
-        :preloaded => false
+        children: {},
+        config: {number: 1, backlog: 100, seconds: 1},
+        versions: {},
+        version: 0,
+        sockets: {},
+        orig_cmd: nil,
+        bind: [],
+        bind_fds: [],
+        bound_ports: [],
+        cmd: nil,
+        script_name: nil,
+        respawn: true,
+        upgrading: false,
+        smooth_upgrade: false,
+        reloading_for_upgrade: false,
+        path: nil,
+        cmd_name: nil,
+        verbosity: 1,
+        generation: 0,
+        last_spinup: nil,
+        ack_mode: {type: :timer, timeout: 1},
+        kill_children_on_exit: false,
+        command_socket_as_fd: false,
+        socket_path: nil,
+        pidfile: nil,
+        lockfile: nil,
+        consecutive_deaths_before_ack: 0,
+        last_upgraded: nil,
+        nice: {master: nil, worker: nil, renice_cmd: "/usr/bin/renice"},
+        reexec_commandline: nil,
+        drop_environment_variables: [],
+        signal_timeout: nil,
+        preloaded: false
       }
     end
   end
@@ -78,20 +96,20 @@ module Einhorn
     extend AbstractState
     def self.default_state
       {
-        :whatami => :master,
-        :script_name => nil,
-        :argv => [],
-        :environ => {},
-        :has_outstanding_spinup_timer => false,
-        :stateful => nil,
+        whatami: :master,
+        script_name: nil,
+        argv: [],
+        environ: {},
+        has_outstanding_spinup_timer: false,
+        stateful: nil,
         # Holds references so that the GC doesn't go and close your sockets.
-        :socket_handles => Set.new
+        socket_handles: Set.new
       }
     end
   end
 
   def self.restore_state(state)
-    parsed = YAML.load(state)
+    parsed = SafeYAML.load(state)
     updated_state, message = update_state(Einhorn::State, "einhorn", parsed[:state])
     Einhorn::State.state = updated_state
     Einhorn::Event.restore_persistent_descriptors(parsed[:persistent_descriptors])
@@ -113,15 +131,13 @@ module Einhorn
       # them all
       dead = []
       updated_state[:children].each do |pid, v|
-        begin
-          pid = Process.wait(pid, Process::WNOHANG)
-          dead << pid if pid
-        rescue Errno::ECHILD
-          dead << pid
-        end
+        pid = Process.wait(pid, Process::WNOHANG)
+        dead << pid if pid
+      rescue Errno::ECHILD
+        dead << pid
       end
       Einhorn::Event::Timer.open(0) do
-        dead.each {|pid| Einhorn::Command.cleanup(pid)}
+        dead.each { |pid| Einhorn::Command.cleanup(pid) }
       end
     end
 
@@ -130,12 +146,12 @@ module Einhorn
     deleted_keys = updated_state.keys - default.keys
     return [updated_state, message.first] if added_keys.length == 0 && deleted_keys.length == 0
 
-    added_keys.each {|key| updated_state[key] = default[key]}
-    deleted_keys.each {|key| updated_state.delete(key)}
+    added_keys.each { |key| updated_state[key] = default[key] }
+    deleted_keys.each { |key| updated_state.delete(key) }
 
     message << "adding default values for #{added_keys.inspect}"
     message << "deleting values for #{deleted_keys.inspect}"
-    message = "State format for #{store_name} has changed: #{message.join(', ')}"
+    message = "State format for #{store_name} has changed: #{message.join(", ")}"
 
     # Can't print yet, since state hasn't been set, so we pass along the message.
     [updated_state, message]
@@ -150,14 +166,14 @@ module Einhorn
     sd = Socket.new(Socket::AF_INET, Socket::SOCK_STREAM, 0)
     Einhorn::Compat.cloexec!(sd, false)
 
-    if flags.include?('r') || flags.include?('so_reuseaddr')
+    if flags.include?("r") || flags.include?("so_reuseaddr")
       sd.setsockopt(Socket::SOL_SOCKET, Socket::SO_REUSEADDR, 1)
     end
 
     sd.bind(Socket.pack_sockaddr_in(port, addr))
     sd.listen(Einhorn::State.config[:backlog])
 
-    if flags.include?('n') || flags.include?('o_nonblock')
+    if flags.include?("n") || flags.include?("o_nonblock")
       fl = sd.fcntl(Fcntl::F_GETFL)
       sd.fcntl(Fcntl::F_SETFL, fl | Fcntl::O_NONBLOCK)
     end
@@ -167,28 +183,28 @@ module Einhorn
   end
 
   # Implement these ourselves so it plays nicely with state persistence
-  def self.log_debug(msg, tag=nil)
-    $stderr.puts("#{log_tag} DEBUG: #{msg}\n") if Einhorn::State.verbosity <= 0
+  def self.log_debug(msg, tag = nil)
+    warn("#{log_tag} DEBUG: #{msg}\n") if Einhorn::State.verbosity <= 0
     $stderr.flush
-    self.send_tagged_message(tag, msg) if tag
+    send_tagged_message(tag, msg) if tag
   end
-  def self.log_info(msg, tag=nil)
-    $stderr.puts("#{log_tag} INFO: #{msg}\n") if Einhorn::State.verbosity <= 1
+
+  def self.log_info(msg, tag = nil)
+    warn("#{log_tag} INFO: #{msg}\n") if Einhorn::State.verbosity <= 1
     $stderr.flush
-    self.send_tagged_message(tag, msg) if tag
+    send_tagged_message(tag, msg) if tag
   end
-  def self.log_error(msg, tag=nil)
-    $stderr.puts("#{log_tag} ERROR: #{msg}\n") if Einhorn::State.verbosity <= 2
+
+  def self.log_error(msg, tag = nil)
+    warn("#{log_tag} ERROR: #{msg}\n") if Einhorn::State.verbosity <= 2
     $stderr.flush
-    self.send_tagged_message(tag, "ERROR: #{msg}") if tag
+    send_tagged_message(tag, "ERROR: #{msg}") if tag
   end
 
-  def self.send_tagged_message(tag, message, last=false)
+  def self.send_tagged_message(tag, message, last = false)
     Einhorn::Command::Interface.send_tagged_message(tag, message, last)
   end
 
-  private
-
   def self.log_tag
     case whatami = Einhorn::TransientState.whatami
     when :master
@@ -201,17 +217,16 @@ module Einhorn
       "[UNKNOWN (#{whatami.inspect}) #{$$}]"
     end
   end
-
-  public
+  private_class_method :log_tag
 
   def self.which(cmd)
-    if cmd.include?('/')
-      return cmd if File.exists?(cmd)
+    if cmd.include?("/")
+      return cmd if File.exist?(cmd)
       raise "Could not find #{cmd}"
     else
-      ENV['PATH'].split(':').each do |f|
+      ENV["PATH"].split(":").each do |f|
         abs = File.join(f, cmd)
-        return abs if File.exists?(abs)
+        return abs if File.exist?(abs)
       end
       raise "Could not find #{cmd} in PATH"
     end
@@ -221,19 +236,19 @@ module Einhorn
   def self.is_script(file)
     File.open(file) do |f|
       bytes = f.read(2)
-      bytes == '#!'
+      bytes == "#!"
     end
   end
 
   def self.preload
-    if path = Einhorn::State.path
+    if (path = Einhorn::State.path)
       set_argv(Einhorn::State.cmd, false)
 
       begin
         # Reset preloaded state to false - this allows us to monitor for failed preloads during reloads.
         Einhorn::State.preloaded = false
         # If it's not going to be requireable, then load it.
-        if !path.end_with?('.rb') && File.exists?(path)
+        if !path.end_with?(".rb") && File.exist?(path)
           log_info("Loading #{path} (if this hangs, make sure your code can be properly loaded as a library)", :upgrade)
           load path
         else
@@ -242,7 +257,7 @@ module Einhorn
 
           force_move_to_oldgen if Einhorn::State.config[:gc_before_fork]
         end
-      rescue Exception => e
+      rescue StandardError, LoadError => e
         log_info("Proceeding with postload -- could not load #{path}: #{e} (#{e.class})\n  #{e.backtrace.join("\n  ")}", :upgrade)
       else
         if defined?(einhorn_main)
@@ -274,7 +289,7 @@ module Einhorn
   def self.set_argv(cmd, set_ps_name)
     # TODO: clean up this hack
     idx = 0
-    if cmd[0] =~ /(^|\/)ruby$/
+    if /(^|\/)ruby$/.match?(cmd[0])
       idx = 1
     elsif !is_script(cmd[0])
       log_info("WARNING: Going to set $0 to #{cmd[idx]}, but it doesn't look like a script")
@@ -291,7 +306,7 @@ module Einhorn
       $0 = worker_ps_name
     end
 
-    ARGV[0..-1] = cmd[idx+1..-1]
+    ARGV[0..-1] = cmd[idx + 1..-1]
     log_info("Set#{set_ps_name ? " $0 = #{$0.inspect}, " : nil} ARGV = #{ARGV.inspect}")
   end
 
@@ -304,15 +319,15 @@ module Einhorn
   end
 
   def self.worker_ps_name
-    Einhorn::State.cmd_name ? "ruby #{Einhorn::State.cmd_name}" : Einhorn::State.orig_cmd.join(' ')
+    Einhorn::State.cmd_name ? "ruby #{Einhorn::State.cmd_name}" : Einhorn::State.orig_cmd.join(" ")
   end
 
   def self.renice_self
     whatami = Einhorn::TransientState.whatami
-    return unless nice = Einhorn::State.nice[whatami]
+    return unless (nice = Einhorn::State.nice[whatami])
     pid = $$
 
-    unless nice.kind_of?(Fixnum)
+    unless nice.is_a?(Integer)
       raise "Nice must be a fixnum: #{nice.inspect}"
     end
 
@@ -334,28 +349,9 @@ module Einhorn
     end
   end
 
-  # This duplicates some code from the environment path, but is
-  # deprecated so that's ok.
-  def self.socketify!(cmd)
-    cmd.map! do |arg|
-      if arg =~ /^(.*=|)srv:([^:]+):(\d+)((?:,\w+)*)$/
-        log_error("Using deprecated command-line configuration for Einhorn; should upgrade to the environment variable interface.")
-        opt = $1
-        host = $2
-        port = $3
-        flags = $4.split(',').select {|flag| flag.length > 0}.map {|flag| flag.downcase}
-        Einhorn::State.sockets[[host, port]] ||= bind(host, port, flags)[0]
-        fd = Einhorn::State.sockets[[host, port]]
-        "#{opt}#{fd}"
-      else
-        arg
-      end
-    end
-  end
-
   # Construct and a command and args that can be used to re-exec
   # Einhorn for upgrades.
-  def self.upgrade_commandline(einhorn_flags=[])
+  def self.upgrade_commandline(einhorn_flags = [])
     cmdline = []
     if Einhorn::State.reexec_commandline
       cmdline += Einhorn::State.reexec_commandline
@@ -363,7 +359,7 @@ module Einhorn
       cmdline << Einhorn::TransientState.script_name
     end
     cmdline += einhorn_flags
-    cmdline << '--'
+    cmdline << "--"
     cmdline += Einhorn::State.cmd
     [cmdline[0], cmdline[1..-1]]
   end
@@ -375,7 +371,7 @@ module Einhorn
     upgrade_sentinel = fork do
       Einhorn::TransientState.whatami = :upgrade_sentinel
       Einhorn.initialize_reload_environment
-      Einhorn::Compat.exec(*Einhorn.upgrade_commandline(['--upgrade-check']))
+      Einhorn::Compat.exec(*Einhorn.upgrade_commandline(["--upgrade-check"]))
     end
     Process.wait(upgrade_sentinel)
     $?.exitstatus.zero?
@@ -400,10 +396,10 @@ module Einhorn
   # startup. Currently, this means the bundler and rbenv versions.
   def self.dump_environment_info
     log_info("Running under Ruby #{RUBY_VERSION}", :environment)
-    log_info("Rbenv ruby version: #{ENV['RBENV_VERSION']}", :environment) if ENV['RBENV_VERSION']
+    log_info("Rbenv ruby version: #{ENV["RBENV_VERSION"]}", :environment) if ENV["RBENV_VERSION"]
     begin
-      bundler_gem = Gem::Specification.find_by_name('bundler')
-      log_info("Using Bundler #{bundler_gem.version.to_s}", :environment)
+      bundler_gem = Gem::Specification.find_by_name("bundler")
+      log_info("Using Bundler #{bundler_gem.version}", :environment)
     rescue Gem::LoadError
     end
   end
@@ -424,7 +420,6 @@ module Einhorn
       # TODO: don't actually alter ARGV[0]?
       Einhorn::State.cmd[0] = which(Einhorn::State.cmd[0])
       socketify_env!
-      socketify!(Einhorn::State.cmd)
     end
 
     set_master_ps_name
@@ -459,10 +454,10 @@ module Einhorn
   end
 end
 
-require 'einhorn/command'
-require 'einhorn/compat'
-require 'einhorn/client'
-require 'einhorn/event'
-require 'einhorn/worker'
-require 'einhorn/worker_pool'
-require 'einhorn/version'
+require "einhorn/command"
+require "einhorn/compat"
+require "einhorn/client"
+require "einhorn/event"
+require "einhorn/worker"
+require "einhorn/worker_pool"
+require "einhorn/version"

metadata

@@ -1,134 +1,101 @@
 --- !ruby/object:Gem::Specification
 name: einhorn
 version: !ruby/object:Gem::Version
-  version: 0.8.2
+  version: 1.0.1
 platform: ruby
 authors:
-- Greg Brockman
-autorequire: 
+- Stripe
+- Mike Perham
 bindir: bin
 cert_chain: []
-date: 2020-10-29 00:00:00.000000000 Z
+date: 2025-04-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rack
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: '13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: pry
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
+        version: '13'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '5'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '5'
 - !ruby/object:Gem::Dependency
   name: mocha
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.13'
+        version: '2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.13'
+        version: '2'
 - !ruby/object:Gem::Dependency
-  name: chalk-rake
+  name: subprocess
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1'
 - !ruby/object:Gem::Dependency
-  name: subprocess
+  name: fiddle
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
+        version: '1.1'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.1'
 description: Einhorn makes it easy to run multiple instances of an application server,
   all listening on the same port. You can also seamlessly restart your workers without
   dropping any requests. Einhorn requires minimal application-level support, making
   it easy to use with an existing project.
 email:
-- gdb@stripe.com
+- support+github@stripe.com
+- mperham@gmail.com
 executables:
 - einhorn
 - einhornsh
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".travis.yml"
-- CONTRIBUTORS
-- Gemfile
-- History.txt
-- LICENSE
+- Changes.md
+- LICENSE.txt
 - README.md
-- README.md.in
-- Rakefile
 - bin/einhorn
 - bin/einhornsh
 - einhorn.gemspec
@@ -150,36 +117,18 @@ files:
 - lib/einhorn/event/timer.rb
 - lib/einhorn/prctl.rb
 - lib/einhorn/prctl_linux.rb
+- lib/einhorn/safe_yaml.rb
 - lib/einhorn/third.rb
 - lib/einhorn/version.rb
 - lib/einhorn/worker.rb
 - lib/einhorn/worker_pool.rb
-- test/_lib.rb
-- test/integration/_lib.rb
-- test/integration/_lib/fixtures/env_printer/env_printer.rb
-- test/integration/_lib/fixtures/exit_during_upgrade/exiting_server.rb
-- test/integration/_lib/fixtures/exit_during_upgrade/upgrade_reexec.rb
-- test/integration/_lib/fixtures/pdeathsig_printer/pdeathsig_printer.rb
-- test/integration/_lib/fixtures/signal_timeout/sleepy_server.rb
-- test/integration/_lib/fixtures/upgrade_project/upgrading_server.rb
-- test/integration/_lib/helpers.rb
-- test/integration/_lib/helpers/einhorn_helpers.rb
-- test/integration/pdeathsig.rb
-- test/integration/startup.rb
-- test/integration/upgrading.rb
-- test/unit/_lib/bad_worker.rb
-- test/unit/_lib/sleep_worker.rb
-- test/unit/einhorn.rb
-- test/unit/einhorn/client.rb
-- test/unit/einhorn/command.rb
-- test/unit/einhorn/command/interface.rb
-- test/unit/einhorn/event.rb
-- test/unit/einhorn/worker_pool.rb
-homepage: https://github.com/stripe/einhorn
+homepage: https://github.com/contribsys/einhorn
 licenses:
 - MIT
-metadata: {}
-post_install_message: 
+metadata:
+  bug_tracker_uri: https://github.com/contribsys/einhorn/issues
+  documentation_uri: https://github.com/contribsys/einhorn/wiki
+  changelog_uri: https://github.com/contribsys/einhorn/blob/main/Changes.md
 rdoc_options: []
 require_paths:
 - lib
@@ -187,36 +136,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.5.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.6.2
 specification_version: 4
 summary: 'Einhorn: the language-independent shared socket manager'
-test_files:
-- test/_lib.rb
-- test/integration/_lib.rb
-- test/integration/_lib/fixtures/env_printer/env_printer.rb
-- test/integration/_lib/fixtures/exit_during_upgrade/exiting_server.rb
-- test/integration/_lib/fixtures/exit_during_upgrade/upgrade_reexec.rb
-- test/integration/_lib/fixtures/pdeathsig_printer/pdeathsig_printer.rb
-- test/integration/_lib/fixtures/signal_timeout/sleepy_server.rb
-- test/integration/_lib/fixtures/upgrade_project/upgrading_server.rb
-- test/integration/_lib/helpers.rb
-- test/integration/_lib/helpers/einhorn_helpers.rb
-- test/integration/pdeathsig.rb
-- test/integration/startup.rb
-- test/integration/upgrading.rb
-- test/unit/_lib/bad_worker.rb
-- test/unit/_lib/sleep_worker.rb
-- test/unit/einhorn.rb
-- test/unit/einhorn/client.rb
-- test/unit/einhorn/command.rb
-- test/unit/einhorn/command/interface.rb
-- test/unit/einhorn/event.rb
-- test/unit/einhorn/worker_pool.rb
+test_files: []

data/.gitignore

@@ -1,17 +0,0 @@
-*.gem
-*.rbc
-.bundle
-.config
-.yardoc
-Gemfile.lock
-InstalledFiles
-_yardoc
-coverage
-doc/
-lib/bundler/man
-pkg
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp