puma-daemon 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 56b4e579687433f3eae998a8b30c3b1b02834c1dde9ef7f57c90d4c501866092
-  data.tar.gz: 1dcd52a307ddabc3083f30b6eba58bc8b679d3f743cd1925199de2e52045b3f4
+  metadata.gz: 181a06dc6b28bae8af85a9eaa03ad0e8eb5c0a147647b10907022db5d596b74e
+  data.tar.gz: 21907cb861b6fb67538502fd70fa56d6c3038997869af268a8891de93f0f728c
 SHA512:
-  metadata.gz: 24e84862cf484e0b08f24356d63cf7fe223f257960f972b1b84ef30e42339e2ec5f6d443b724414bd505a6d9fa176460ac284839155f590c5ca598eed151fbd4
-  data.tar.gz: b8555d31db72c344b076d98aef64dc915dcee38bce42ae4425c2e33dfbecaef10242d7e76cc94f175a41598f6827ea3cee2b7b5f9728da6a330f6c26803028e7
+  metadata.gz: d1c287db4aaa4a4ec29abb422ed9800a31ecc32891a600ced60bf796c192d08eb7e75642a7b8137afcb283fbd1ae2872e4b02124f7ec3bbb09b8072ce72f867b
+  data.tar.gz: c26fe226d00997d7432ef73fadaf44d70719a0c20dc5efdf6c55062dcc6df8e00b69b5794e1b94591c7625e255574135d5d36c2bc4747599e39f8c510bd3e3a7

data/.github/workflows/main.yml

@@ -5,14 +5,22 @@ on: [push,pull_request]
 jobs:
   build:
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby-version: [3.0.0, 2.7.2, 2.6.6, 2.5.7]
+
     steps:
     - uses: actions/checkout@v2
-    - name: Set up Ruby
+    - name: Set up Ruby ${{ matrix.ruby-version }}
       uses: ruby/setup-ruby@v1
       with:
-        ruby-version: 3.0.0
-    - name: Run the default task
-      run: |
-        gem install bundler -v 2.2.4
-        bundle install
-        bundle exec rake
+        ruby-version: ${{ matrix.ruby-version }}
+    - name: Install dependencies
+      run: bundle install
+    - name: Run RSpecs
+      run: bundle exec rspec --color
+    - name: Run Rubocop
+      run: bundle exec rubocop
+    - name: Upload Code Coverage
+      run: bash <(curl -s https://codecov.io/bash)
+

data/.gitignore

@@ -6,6 +6,9 @@
 /pkg/
 /spec/reports/
 /tmp/
-
+.idea/
 # rspec failure tracking
 .rspec_status
+.ruby-version
+/Gemfile.lock
+

data/.rubocop.yml

@@ -1,10 +1,21 @@
+inherit_gem:
+  relaxed-rubocop: .rubocop.yml
+
+AllCops:
+  TargetRubyVersion: 2.4
+  NewCops: enable
+
+Style/OptionalBooleanParameter:
+  Exclude:
+    - 'lib/puma/daemon/dsl.rb'
+
 Style/StringLiterals:
   Enabled: true
-  EnforcedStyle: double_quotes
+  EnforcedStyle: single_quotes
 
 Style/StringLiteralsInInterpolation:
   Enabled: true
-  EnforcedStyle: double_quotes
+  EnforcedStyle: single_quotes
 
 Layout/LineLength:
   Max: 120

data/.rubocop_todo.yml

@@ -0,0 +1,14 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2021-01-24 15:37:53 UTC using RuboCop version 0.93.1.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods.
+# AllowedMethods: respond_to_missing?
+Style/OptionalBooleanParameter:
+  Exclude:
+    - 'lib/puma/daemon/dsl.rb'

data/Gemfile

@@ -1,12 +1,14 @@
 # frozen_string_literal: true
 
-source "https://rubygems.org"
+source 'https://rubygems.org'
 
 # Specify your gem's dependencies in puma-daemon.gemspec
 gemspec
 
-gem "rake", "~> 13.0"
+gem 'rake', '~> 13.0'
 
-gem "rspec", "~> 3.0"
-
-gem "rubocop", "~> 0.80"
+group :test do
+  gem 'codecov', require: false
+  gem 'rspec', '~> 3.0'
+  gem 'rubocop', '~> 0.80'
+end

data/LICENSE.txt

@@ -1,6 +1,4 @@
-The MIT License (MIT)
-
-Copyright (c) 2021 Konstantin Gredeskoul
+Copyright © 2021 Konstantin Gredeskoul
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.adoc

@@ -1,8 +1,40 @@
 = Puma::Daemon
+:toc:
+:toclevels: 4
+:sectnums:
+:icons: font
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/puma/daemon`. To experiment with that code, run `bin/console` for an interactive prompt.
+image:https://github.com/kigster/puma-daemon/workflows/Ruby/badge.svg[link=https://github.com/kigster/puma-daemon/actions?query=workflow%3ARuby] image:https://codecov.io/gh/kigster/puma-daemon/branch/master/graph/badge.svg?token=asxarMSGbz[link=https://codecov.io/gh/kigster/puma-daemon]
 
-TODO: Delete this and the text above, and describe your gem
+In version 5.0 of the popular Ruby HTTP server https://github.com/puma/puma[Puma] the developers chose to https://github.com/puma/puma/pull/2170/files[drop the daemonization] support from Puma. They did that because the code wasn't actively maintained. Other and perhaps better options now exist (such as `systemd`, etc), not to mention that many people have switched to Kubernetes and Docker, where you generally want to start all servers in the foreground.
+
+And yet, on occasion, it was rather useful and straightforward to use the built-in daemonization feature that was cross-platform and is now gone. Some folks are still using this feature and are therefore stuck with Puma version 4, or must wrap Puma either in the `systemd` manifest or `launchctl plist` on Mac OS-X, or a Docker container. Well, **not anymore!** 
+
+NOTE: Add this gem to your dependencies, and make a one line change either in your `config/puma.rb` file, or use `pumad` binary to start Puma as per usual, and you can even leave `-d` flags there (they are ignored when started via `pumad`, and Puma always goes to the background when started that way).
+
+One of the nice features of the old daemonization functionality was that it worked across all platforms. 
+
+So, if you want to use the latest and greatest Puma 5+, but have it self-daemonize, this gem is for you.
+
+== Compatility
+
+We did not restore the daemonization code for JRuby; so at the moment this will work with the MRI distribution,  and possibly others that support `Process.daemon(true)`.
+
+We currently run CI suite on Github Actions against
+
+ * MRI Ruby 3.0.0
+ * MRI Ruby 2.7.2
+ * MRI Ruby 2.6.6
+ * MRI Ruby 2.5.7
+
+
+== Design Decisions 
+
+This gem's goal was to surgically augment Puma's source code to restore daemonization by merely requiring `puma/daemon`. We almost got there, but not quite.
+
+While this was an admirable goal, it has not been accomplished in the current version.  The internals of Puma isn't very easy to monkey-patch or augment. For example, we couldn't think of a way to add back the `-d` flags to the Option Parsing method without having to override the entire method: — which is _not a good solution_, because — what if Puma developers add a new flag in the future? We would have to keep this overridden method frequently updated and potentially choose a different version depending on what version of Puma you are using. That sounds like a nightmare.
+
+It is why instead, we took an approach that requires you — the user — to make a couple of small changes in your Puma configuration to bring daemonization back, or in your scripts, change `puma` to `pumad`, and everything should work. If you run into problems, please https://github.com/kigster/puma-daemon/issues/new[submit an issue].
 
 == Installation
 
@@ -10,20 +42,95 @@ Add this line to your application's Gemfile:
 
 [source,ruby]
 ----
-gem 'puma-daemon'
+gem 'puma-daemon', require: false
+gem 'puma',  '~> 5'
 ----
 
 And then execute:
 
  $ bundle install
 
-Or install it yourself as:
+== Usage
 
- $ gem install puma-daemon
+There were two ways you could daemonize Puma in the past:
 
-== Usage
+ 1. By specifying `daemonize` or `daemonize(true)` in your config file.
+ 2. Or, by passing a `-d` or `--daemonize` command line flag.
+
+This gem allows you to daemonize using both ways, but with a small caveat in each case.
+
+Please note that both ways require you to include this gem in your Gemfile, but you may specify it as `require: false` — it will only activate if you explicitly require it, or use `pumad` executable.
+
+=== Daemonizing via the Config File
+
+If you want to specify `daemonize` in your config file, simply include `require 'puma/daemon'` at the top of your config file:
+
+[source,ruby]
+----
+# file: config/puma.rb
+require 'puma/daemon'
+
+port 3001
+workers 3
+threads 2,3
+# accepts true or false, and if false is passed will NOT daemonize
+daemonize 
+----
+
+With this method you can continue using the standard `puma` executable to get it started, but (and this is important) — **you must remove any `-d` or `--daemonize` from the command line**, or Puma v5 and above will fail with an error.
+
+Here is an example of daemonizing via the config file shown above, and using the regular `puma` binary:
+
+[source,bash]
+----
+❯ gem install puma-daemon puma -N
+❯ puma -C config/puma.rb config.ru
+
+[98795] Puma starting in cluster mode...
+[98795] * Puma version: 5.1.1 (ruby 2.7.2-p137) ("At Your Service")
+[98795] *  Min threads: 2
+[98795] *  Max threads: 3
+[98795] *  Environment: production
+[98795] *   Master PID: 98795
+[98795] *      Workers: 3
+[98795] *     Restarts: (✔) hot (✔) phased
+[98795] * Listening on http://0.0.0.0:3001
+[98795] *  Puma Daemon: Daemonizing (puma-daemon v0.1.1)...
+----
+
+Note that using this method you can decide whether to daemonize or not by passing true or false to the `daemonize` method.
+
+=== Daemonizing on the Command Line
+
+If you prefer to make a decision whether to daemonize or not on the command line, you only have to make one chance: replace `puma` with `pumad`.
+
+NOTE: We did not want to conflict with the `puma` gem by introducing another executable under the same name. The executable this gem provides is called `pumad` (where 'd' stands for daemon, and follows standard UNIX convention, as in eg `sshd`, `ftpd`, etc).
+
+If you replace `puma` with `pumad` — you no longer need to pass any aditional command line flag t ocontinue passing it `-d` or you can remove it (both `-d` and `--daemonize` are stripped out before ARGV is passed onto Puma's CLI parser.)
+
+[source,bash]
+----
+❯ gem install puma --version 5.1.1 -N
+❯ gem install puma-daemon -N
+
+❯ pumad -C config/puma.rb spec/rackup/bind.ru
+
+[98795] Puma starting in cluster mode...
+[98795] * Puma version: 5.1.1 (ruby 2.7.2-p137) ("At Your Service")
+[98795] *  Min threads: 2
+[98795] *  Max threads: 8
+[98795] *  Environment: production
+[98795] *   Master PID: 98795
+[98795] *      Workers: 3
+[98795] *     Restarts: (✔) hot (✔) phased
+[98795] * Listening on http://0.0.0.0:3000
+[98795] *  Puma Daemon: Daemonizing (puma-daemon v0.1.1)...
+----
+
+As you can see, at the end it says "Daemonizing".
+
+If you start puma this way, you can still specify `daemonize(false)` in the configuration file to turn it off, but the default is to daemonize. Also, if you start with `pumad` you do not need to include `require 'puma/daemon'` in your configuration file, as the `pumad` binary loads all dependencies prior to parsing the config.
 
-Work in progress.
 
 == Development
 

data/Rakefile

@@ -1,8 +1,9 @@
+# frozen_string_literal: true
+
 require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
 require 'rubocop/rake_task'
 require 'yard'
-require 'timeout'
 
 def shell(*args)
   puts "running: #{args.join(' ')}"
@@ -10,33 +11,28 @@ def shell(*args)
 end
 
 task :clean do
-  shell('rm -rf pkg/ tmp/ coverage/ doc/ ' )
+  shell('rm -rf pkg/ tmp/ coverage/ doc/ ')
 end
 
-task :gem => [:build] do
+task gem: [:build] do
   shell('gem install pkg/*')
 end
 
-task :permissions => [ :clean ] do
-  shell("chmod -v o+r,g+r * */* */*/* */*/*/* */*/*/*/* */*/*/*/*/*")
-  shell("find . -type d -exec chmod o+x,g+x {} \\;")
+task permissions: [:clean] do
+  shell('chmod -v o+r,g+r * */* */*/* */*/*/* */*/*/*/* */*/*/*/*/*')
+  shell('find . -type d -exec chmod o+x,g+x {} \\;')
 end
 
-task :build => :permissions
+task build: :permissions
 
 YARD::Rake::YardocTask.new(:doc) do |t|
-  t.files = %w(lib/**/*.rb exe/*.rb - README.adoc CHANGELOG.md LICENSE)
-  t.options.unshift('--title', '"Sym – Symmetric Encryption for Humins"')
-  t.after = -> { Thread.new { sleep 5; exec('open doc/index.html') }  }
+  t.files = %w[lib/**/*.rb exe/*.rb - README.adoc CHANGELOG.md LICENSE.txt]
+  t.options.unshift('--title', '"Puma Daemon"')
+  t.after = -> { exec('open doc/index.html') }
 end
 
 RSpec::Core::RakeTask.new(:spec)
 
 RuboCop::RakeTask.new
 
-task :default => :spec
-
-
-
-
-
+task default: %i[spec rubocop]

data/bin/console

@@ -1,8 +1,8 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-require "bundler/setup"
-require "puma/daemon"
+require 'bundler/setup'
+require 'puma/daemon'
 
 # You can add fixtures and/or initialization code here to make experimenting
 # with your gem easier. You can also use a different console, if you like.
@@ -11,5 +11,5 @@ require "puma/daemon"
 # require "pry"
 # Pry.start
 
-require "irb"
+require 'irb'
 IRB.start(__FILE__)

data/config/puma.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'puma/daemon'
+
+workers     3
+threads     2, 8
+port        3000
+environment ENV['RAILS_ENV'] || 'production'
+daemonize   ENV['NO_DAEMON'] ? false : true

data/exe/pumad

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'puma/daemon'
+
+# If we are passing -d or --daemonize, do so
+# otherwise invoke to the original puma
+if (ARGV & %w[-d --daemonize]).size.positive?
+  ARGV.delete '-d'
+  ARGV.delete '--daemonize'
+end
+
+Puma::Daemon::CLI.new(ARGV)&.run

data/lib/puma/daemon.rb

@@ -1,10 +1,27 @@
 # frozen_string_literal: true
 
-require_relative "daemon/version"
+require 'puma/runner'
+require 'puma/single'
+require 'puma/cluster'
+require 'puma/dsl'
+require 'puma/cli'
+
+require 'puma/daemon/version'
+require 'puma/daemon/runner'
+require 'puma/daemon/configuration'
+require 'puma/daemon/cli'
+require 'puma/daemon/dsl'
 
 module Puma
   module Daemon
-    class Error < StandardError; end
-    # Your code goes here...
+    def self.daemonize!
+      ::Puma::Single.include(::Puma::Daemon::Runner)
+      ::Puma::Cluster.include(::Puma::Daemon::Runner)
+      ::Puma::DSL.include(::Puma::Daemon::DSL)
+      ::Puma::Configuration.prepend(::Puma::Daemon::Configuration)
+      ::Puma::CLI.instance_eval { attr_reader :options }
+    end
   end
 end
+
+Puma::Daemon.daemonize!

data/lib/puma/daemon/cli.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Puma
+  module Daemon
+    class CLI
+      attr_accessor :argv, :cli
+
+      def initialize(argv = ARGV, events = Events.stdio)
+        self.argv = argv
+        self.cli = ::Puma::CLI.new(argv, events)
+      end
+
+      def run
+        cli.run
+      end
+    end
+  end
+end

data/lib/puma/daemon/configuration.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Puma
+  module Daemon
+    module Configuration
+      attr_reader :default_dsl, :file_dsl, :user_dsl
+
+      def puma_default_options
+        super.merge({ daemon: true })
+      end
+    end
+  end
+end

data/lib/puma/daemon/dsl.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Puma
+  module Daemon
+    module DSL
+      # Daemonize the server into the background. It's highly recommended to
+      # use this in combination with +pidfile+ and +stdout_redirect+.
+      #
+      # The default is "false".
+      #
+      # @example
+      #   daemonize
+      #
+      # @example
+      #   daemonize false
+      def daemonize(which = true)
+        @options[:daemon] = which
+      end
+
+      attr_reader :options
+    end
+  end
+end

data/lib/puma/daemon/runner.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require_relative 'version'
+
+module Puma
+  module Daemon
+    module Runner
+      attr_reader :options
+
+      def redirect_io
+        super
+
+        daemonize! if daemon?
+      end
+
+      def daemon?
+        options[:daemon]
+      end
+
+      def daemonize!
+        log "*  Puma Daemon: Daemonizing (puma-daemon v#{::Puma::Daemon::VERSION})..."
+        Process.daemon(true)
+      end
+
+      def log(str)
+        super(str) unless str == 'Use Ctrl-C to stop'
+      end
+    end
+  end
+end

data/lib/puma/daemon/version.rb

@@ -2,6 +2,6 @@
 
 module Puma
   module Daemon
-    VERSION = "0.1.0"
+    VERSION = '0.1.1'
   end
 end

data/puma-daemon.gemspec

@@ -1,38 +1,60 @@
 # frozen_string_literal: true
 
-require_relative "lib/puma/daemon/version"
+require_relative 'lib/puma/daemon/version'
 
 Gem::Specification.new do |spec|
-  spec.name          = "puma-daemon"
+  spec.name          = 'puma-daemon'
   spec.version       = Puma::Daemon::VERSION
-  spec.authors       = ["Konstantin Gredeskoul"]
-  spec.email         = ["kigster@gmail.com"]
+  spec.authors       = ['Konstantin Gredeskoul']
+  spec.email         = ['kigster@gmail.com']
 
-  spec.summary       = "Daemonize puma without any external OS-dependent method"
-  spec.description   = "Daemonize puma without any external OS-dependent method"
-  spec.homepage      = "https://github.com/kig/puma-daemon"
-  spec.license       = "MIT"
-  
-  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+  spec.summary       = "Restore somewhat Puma's ability to self-daemonize, since Puma 5.0 dropped it"
+  spec.description   = <<~DESCRIPTION
 
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/kig/puma-daemon"
-  spec.metadata["changelog_uri"] = "https://github.com/kig/puma-daemon/master/CHANAGELOG"
+    In version 5.0 the authors of the popular Ruby web server Puma chose
+    to remove the daemonization support from Puma, because the code wasn't wall maintained, 
+    and because other and perhaps better options exist (such as systemd, etc), not to 
+    mention many people have switched to Kubernetes and Docker, where you want to start 
+    all servers on the foreground.
+
+    And yet, something useful and simple got lost — in our humble opinion. Some folks were 
+    indeed happily using the `--daemonize` feature until in 5.0 they got an error that this flag is 
+    not supported.
+
+    So, if you want to use the latest and greatest Puma 5+, but have it self-daemonize, 
+    this gem is for you. Just use *pumad* binary instead of *puma*, or require 'puma/daemon' inside
+    your config file.
+  DESCRIPTION
+
+  spec.homepage      = 'https://github.com/kig/puma-daemon'
+  spec.license       = 'MIT'
+
+  spec.required_ruby_version = Gem::Requirement.new('>= 2.4.0')
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/kig/puma-daemon'
+  spec.metadata['changelog_uri'] = 'https://github.com/kig/puma-daemon/master/CHANAGELOG'
 
   # 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 { |f| f.match(%r{\A(?:test|spec|features)/}) }
   end
-  spec.bindir        = "exe"
+  spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'puma', '>= 5.0'
+  spec.add_dependency 'rack'
+
+  spec.add_development_dependency 'asciidoctor'
+  spec.add_development_dependency 'codecov'
+  spec.add_development_dependency 'relaxed-rubocop'
+  spec.add_development_dependency 'rspec-its'
+  spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'simplecov'
+  spec.add_development_dependency 'yard'
 
-  spec.add_dependency "puma", ">= 5.0"
-  
-  spec.add_development_dependency "asciidoctor"
-  spec.add_development_dependency "rspec-its"
-  spec.add_development_dependency "relaxed-rubocop"
   # Uncomment to register a new dependency of your gem
   # spec.add_dependency "example-gem", "~> 1.0"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: puma-daemon
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Konstantin Gredeskoul
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-01-18 00:00:00.000000000 Z
+date: 2021-01-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: puma
@@ -24,6 +24,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rack
+  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: asciidoctor
   requirement: !ruby/object:Gem::Requirement
@@ -39,7 +53,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rspec-its
+  name: codecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -66,11 +80,76 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Daemonize puma without any external OS-dependent method
+- !ruby/object:Gem::Dependency
+  name: rspec-its
+  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: rubocop
+  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: simplecov
+  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: yard
+  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'
+description: "\nIn version 5.0 the authors of the popular Ruby web server Puma chose\nto
+  remove the daemonization support from Puma, because the code wasn't wall maintained,
+  \nand because other and perhaps better options exist (such as systemd, etc), not
+  to \nmention many people have switched to Kubernetes and Docker, where you want
+  to start \nall servers on the foreground.\n\nAnd yet, something useful and simple
+  got lost — in our humble opinion. Some folks were \nindeed happily using the `--daemonize`
+  feature until in 5.0 they got an error that this flag is \nnot supported.\n\nSo,
+  if you want to use the latest and greatest Puma 5+, but have it self-daemonize,
+  \nthis gem is for you. Just use *pumad* binary instead of *puma*, or require 'puma/daemon'
+  inside\nyour config file.\n"
 email:
 - kigster@gmail.com
 executables:
-- puma-daemon
+- pumad
 extensions: []
 extra_rdoc_files: []
 files:
@@ -78,15 +157,20 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
+- ".rubocop_todo.yml"
 - Gemfile
-- Gemfile.lock
 - LICENSE.txt
 - README.adoc
 - Rakefile
 - bin/console
 - bin/setup
-- exe/puma-daemon
+- config/puma.rb
+- exe/pumad
 - lib/puma/daemon.rb
+- lib/puma/daemon/cli.rb
+- lib/puma/daemon/configuration.rb
+- lib/puma/daemon/dsl.rb
+- lib/puma/daemon/runner.rb
 - lib/puma/daemon/version.rb
 - puma-daemon.gemspec
 homepage: https://github.com/kig/puma-daemon
@@ -104,15 +188,16 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.3.0
+      version: 2.4.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.4
+rubygems_version: 3.1.4
 signing_key:
 specification_version: 4
-summary: Daemonize puma without any external OS-dependent method
+summary: Restore somewhat Puma's ability to self-daemonize, since Puma 5.0 dropped
+  it
 test_files: []

data/Gemfile.lock

@@ -1,67 +0,0 @@
-PATH
-  remote: .
-  specs:
-    puma-daemon (0.1.0)
-      puma (>= 5.0)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    asciidoctor (2.0.12)
-    ast (2.4.1)
-    diff-lcs (1.4.4)
-    nio4r (2.5.4)
-    parallel (1.20.1)
-    parser (3.0.0.0)
-      ast (~> 2.4.1)
-    puma (5.1.1)
-      nio4r (~> 2.0)
-    rainbow (3.0.0)
-    rake (13.0.3)
-    regexp_parser (2.0.3)
-    relaxed-rubocop (2.5)
-    rexml (3.2.4)
-    rspec (3.10.0)
-      rspec-core (~> 3.10.0)
-      rspec-expectations (~> 3.10.0)
-      rspec-mocks (~> 3.10.0)
-    rspec-core (3.10.1)
-      rspec-support (~> 3.10.0)
-    rspec-expectations (3.10.1)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.10.0)
-    rspec-its (1.3.0)
-      rspec-core (>= 3.0.0)
-      rspec-expectations (>= 3.0.0)
-    rspec-mocks (3.10.1)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.10.0)
-    rspec-support (3.10.1)
-    rubocop (0.93.1)
-      parallel (~> 1.10)
-      parser (>= 2.7.1.5)
-      rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8)
-      rexml
-      rubocop-ast (>= 0.6.0)
-      ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 2.0)
-    rubocop-ast (1.4.0)
-      parser (>= 2.7.1.5)
-    ruby-progressbar (1.11.0)
-    unicode-display_width (1.7.0)
-
-PLATFORMS
-  x86_64-darwin-20
-
-DEPENDENCIES
-  asciidoctor
-  puma-daemon!
-  rake (~> 13.0)
-  relaxed-rubocop
-  rspec (~> 3.0)
-  rspec-its
-  rubocop (~> 0.80)
-
-BUNDLED WITH
-   2.2.4

data/exe/puma-daemon

@@ -1,3 +0,0 @@
-#!/usr/bin/env ruby
-
-require "puma/daemon"