random-port 0.5.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a0eff0b3b8395e2d245b309a7a15dd27362f0d983ce3b91587b66119a4e68a3f
-  data.tar.gz: af26bb1c3daecaf2260fb2601870f2c4c2386f3359be714071c5790e90fad0ee
+  metadata.gz: b71762c94a8e91f18c8ad99635fccc5a1d970933383788e33ce5c7e727309bb5
+  data.tar.gz: 6615e680ca4ff3307658e32bc259068ec0d18b8855233f7f2f0e4f9677de59dc
 SHA512:
-  metadata.gz: 4d25042a756ac83966d45085888b26c5fe95f3960967320d6a9e81ed9900f72769f745f4032320487e35c9d31d029250d1358425bffda91562372bc499c4fc52
-  data.tar.gz: 503e22ad9b530666b290506936f20aeb69b5273a1ac36f550b9bd5cbd2c22ab0b593c50bd0005dab250a20040058080903894e1353a5e1323784f2a162f12d1b
+  metadata.gz: 1d682b677cbc3cd75ea175905f7329606deb6bf791e78d7bdad3b011c9c0c2ef2b020cbda389cd83ae6677d57d42cf5dfa3884f78a6e22fd2961abd1c808c04f
+  data.tar.gz: 273fd54dcd45d2acad27ec446eea6cb8570e79318cf92e20144f7dad46000a534a1ff958be7b347e0a20a9c1c8156b2a63e233013a5e064be0e5fa12ad576905

data/.0pdd.yml

@@ -1,3 +1,23 @@
+# Copyright (c) 2018-2024 Yegor Bugayenko
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the 'Software'), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+---
 errors:
   - yegor256@gmail.com
 # alerts:

data/.github/workflows/actionlint.yml

@@ -0,0 +1,41 @@
+# Copyright (c) 2018-2024 Yegor Bugayenko
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the 'Software'), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+---
+name: actionlint
+'on':
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+jobs:
+  actionlint:
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v4
+      - name: Download actionlint
+        id: get_actionlint
+        # yamllint disable-line rule:line-length
+        run: bash <(curl https://raw.githubusercontent.com/rhysd/actionlint/main/scripts/download-actionlint.bash)
+        shell: bash
+      - name: Check workflow files
+        run: ${{ steps.get_actionlint.outputs.executable }} -color
+        shell: bash

data/.github/workflows/codecov.yml

@@ -0,0 +1,38 @@
+# Copyright (c) 2018-2024 Yegor Bugayenko
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the 'Software'), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+---
+name: codecov
+on:
+  push:
+    branches:
+      - master
+jobs:
+  codecov:
+    runs-on: ubuntu-20.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 2.7
+      - run: bundle update
+      - run: bundle exec rake
+      - uses: codecov/codecov-action@v3
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}

data/.github/workflows/copyrights.yml

@@ -0,0 +1,30 @@
+# Copyright (c) 2018-2024 Yegor Bugayenko
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the 'Software'), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+---
+name: copyrights
+'on':
+  push:
+  pull_request:
+jobs:
+  copyrights:
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: yegor256/copyrights-action@0.0.4

data/.github/workflows/markdown-lint.yml

@@ -0,0 +1,38 @@
+# Copyright (c) 2018-2024 Yegor Bugayenko
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the 'Software'), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+---
+name: markdown-lint
+'on':
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+    paths-ignore: ['paper/**', 'sandbox/**']
+concurrency:
+  group: markdown-lint-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  markdown-lint:
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: articulate/actions-markdownlint@v1

data/.github/workflows/pdd.yml

@@ -0,0 +1,34 @@
+# Copyright (c) 2018-2024 Yegor Bugayenko
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the 'Software'), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+---
+name: pdd
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+jobs:
+  pdd:
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: volodya-lombrozo/pdd-action@master

data/.github/workflows/rake.yml

@@ -0,0 +1,43 @@
+# Copyright (c) 2018-2024 Yegor Bugayenko
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the 'Software'), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+---
+name: rake
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+jobs:
+  test:
+    name: test
+    strategy:
+      matrix:
+        os: [ubuntu-20.04, macos-12]
+        ruby: [2.7, 3.2]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+      - run: bundle update
+      - run: bundle exec rake

data/.github/workflows/xcop.yml

@@ -0,0 +1,30 @@
+# Copyright (c) 2018-2024 Yegor Bugayenko
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the 'Software'), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+---
+name: xcop
+on:
+  push:
+  pull_request:
+jobs:
+  xcop:
+    runs-on: ubuntu-20.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: g4s8/xcop-action@master

data/.gitignore

@@ -4,3 +4,5 @@ Gemfile.lock
 .DS_Store
 rdoc/
 coverage/
+.yardoc/
+doc/

data/.rubocop.yml

@@ -1,7 +1,33 @@
+# Copyright (c) 2018-2024 Yegor Bugayenko
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the 'Software'), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+---
 AllCops:
   DisplayCopNames: true
   TargetRubyVersion: 2.3.3
+  NewCops: enable
+  SuggestExtensions: false
 
+Layout/EmptyLineAfterGuardClause:
+  Enabled: false
+Style/ClassAndModuleChildren:
+  Enabled: false
 Naming/FileName:
   Enabled: false
 Metrics/MethodLength:

data/.rultor.yml

@@ -1,10 +1,32 @@
+# Copyright (c) 2018-2024 Yegor Bugayenko
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the 'Software'), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+---
+docker:
+  image: yegor256/rultor-image:1.23.1
 assets:
-  rubygems.yml: zerocracy/home#assets/rubygems.yml
+  rubygems.yml: yegor256/home#assets/rubygems.yml
 install: |-
-  export GEM_HOME=~/.ruby
-  export GEM_PATH=$GEM_HOME:$GEM_PATH
-  bundle install --no-color
+  pdd -f /dev/null
+  sudo bundle install --no-color "--gemfile=$(pwd)/Gemfile"
 release:
+  pre: false
   script: |-
     bundle exec rake
     rm -rf *.gem
@@ -17,7 +39,3 @@ release:
 merge:
   script: |-
     bundle exec rake
-deploy:
-  script: |-
-    echo Nothing to deploy
-    exit -1

data/Gemfile

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright (c) 2018 Yegor Bugayenko
+# Copyright (c) 2018-2024 Yegor Bugayenko
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the 'Software'), to deal
@@ -22,3 +22,11 @@
 
 source 'https://rubygems.org'
 gemspec
+
+gem 'minitest', '5.24.1', require: false
+gem 'rake', '13.2.1', require: false
+gem 'rubocop', '1.64.1', require: false
+gem 'rubocop-rspec', '3.0.2', require: false
+gem 'simplecov', '0.22.0', require: false
+gem 'threads', '0.3.0', require: false
+gem 'yard', '0.9.36', require: false

data/LICENSE.txt

@@ -1,6 +1,6 @@
 (The MIT License)
 
-Copyright (c) 2019 Yegor Bugayenko
+Copyright (c) 2018-2024 Yegor Bugayenko
 
 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.md

@@ -1,12 +1,13 @@
+# Random TCP Port Generator for Ruby
+
 [![DevOps By Rultor.com](http://www.rultor.com/b/yegor256/random-port)](http://www.rultor.com/p/yegor256/random-port)
 [![We recommend RubyMine](http://www.elegantobjects.org/rubymine.svg)](https://www.jetbrains.com/ruby/)
 
-[![Build Status](https://travis-ci.org/yegor256/random-port.svg)](https://travis-ci.org/yegor256/random-port)
+[![rake](https://github.com/yegor256/random-port/actions/workflows/rake.yml/badge.svg)](https://github.com/yegor256/random-port/actions/workflows/rake.yml)
 [![Gem Version](https://badge.fury.io/rb/random-port.svg)](http://badge.fury.io/rb/random-port)
 [![Maintainability](https://api.codeclimate.com/v1/badges/349b8c31884d3b34d926/maintainability)](https://codeclimate.com/github/yegor256/random-port/maintainability)
 [![Yard Docs](http://img.shields.io/badge/yard-docs-blue.svg)](http://rubydoc.info/github/yegor256/random-port/master/frames)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/yegor256/random-port/blob/master/LICENSE.txt)
-
 [![Test Coverage](https://img.shields.io/codecov/c/github/yegor256/random-port.svg)](https://codecov.io/github/yegor256/random-port?branch=master)
 [![Hits-of-Code](https://hitsofcode.com/github/yegor256/random-port)](https://hitsofcode.com/view/github/random-port/mailanes)
 
@@ -15,7 +16,7 @@ It's a simple Ruby gem to get a random TCP port.
 First, install it:
 
 ```bash
-$ gem install random-port
+gem install random-port
 ```
 
 Then, use it like this, to reserve a random TCP port:
@@ -57,14 +58,16 @@ not-thread-safe, using optional `sync` argument of the constructor.
 
 ## How to contribute
 
-Read [these guidelines](https://www.yegor256.com/2014/04/15/github-guidelines.html).
+Read
+[these guidelines](https://www.yegor256.com/2014/04/15/github-guidelines.html).
 Make sure you build is green before you contribute
-your pull request. You will need to have [Ruby](https://www.ruby-lang.org/en/) 2.3+ and
+your pull request. You will need to have
+[Ruby](https://www.ruby-lang.org/en/) 2.3+ and
 [Bundler](https://bundler.io/) installed. Then:
 
-```
-$ bundle update
-$ bundle exec rake
+```bash
+bundle update
+bundle exec rake
 ```
 
 If it's clean and you don't see any error messages, submit your pull request.

data/Rakefile

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright (c) 2018 Yegor Bugayenko
+# Copyright (c) 2018-2024 Yegor Bugayenko
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the 'Software'), to deal
@@ -24,7 +24,7 @@ require 'rubygems'
 require 'rake'
 require 'rake/clean'
 
-CLEAN = FileList['coverage']
+CLEAN << 'coverage'
 
 def name
   @name ||= File.basename(Dir['*.gemspec'].first, '.*')
@@ -34,7 +34,7 @@ def version
   Gem::Specification.load(Dir['*.gemspec'].first).version
 end
 
-task default: %i[clean test rubocop]
+task default: %i[clean test yard rubocop]
 
 require 'rake/testtask'
 desc 'Run all unit tests'
@@ -50,3 +50,9 @@ RuboCop::RakeTask.new(:rubocop) do |task|
   task.fail_on_error = true
   task.requires << 'rubocop-rspec'
 end
+
+require 'yard'
+desc 'Build Yard documentation'
+YARD::Rake::YardocTask.new do |t|
+  t.files = ['lib/**/*.rb']
+end

data/lib/random-port/module.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+# (The MIT License)
+#
+# Copyright (c) 2018-2024 Yegor Bugayenko
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the 'Software'), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+# The module for all classes.
+#
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2018-2024 Yegor Bugayenko
+# License:: MIT
+module RandomPort
+end

data/lib/random-port/pool.rb

@@ -2,7 +2,7 @@
 
 # (The MIT License)
 #
-# Copyright (c) 2018 Yegor Bugayenko
+# Copyright (c) 2018-2024 Yegor Bugayenko
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the 'Software'), to deal
@@ -24,121 +24,123 @@
 
 require 'socket'
 require 'monitor'
+require_relative 'module'
 
-module RandomPort
-  # Pool of TPC ports.
-  #
-  # Use it like this:
-  #
-  #  RandomPort::Pool.new.acquire do |port|
-  #    # Use the TCP port. It will be returned back
-  #    # to the pool afterwards.
-  #  end
-  #
-  # You can specify the maximum amount of ports to acquire, using +limit+.
-  # If more acquiring requests will arrive, an exception will be raised.
-  #
-  # The class is thread-safe, by default. You can configure it to be
-  # not-thread-safe, using optional <tt>sync</tt> argument of the constructor.
-  #
-  # Author:: Yegor Bugayenko (yegor256@gmail.com)
-  # Copyright:: Copyright (c) 2018 Yegor Bugayenko
-  # License:: MIT
-  class Pool
-    # If can't acquire by time out.
-    class Timeout < StandardError; end
+# Pool of TPC ports.
+#
+# Use it like this:
+#
+#  RandomPort::Pool.new.acquire do |port|
+#    # Use the TCP port. It will be returned back
+#    # to the pool afterwards.
+#  end
+#
+# You can specify the maximum amount of ports to acquire, using +limit+.
+# If more acquiring requests will arrive, an exception will be raised.
+#
+# The class is thread-safe, by default. You can configure it to be
+# not-thread-safe, using optional +sync+ argument of the constructor,
+# passing <tt>FALSE</tt>.
+#
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2018-2024 Yegor Bugayenko
+# License:: MIT
+class RandomPort::Pool
+  # If can't acquire by time out.
+  class Timeout < StandardError; end
 
-    attr_reader :limit
+  attr_reader :limit
 
-    # Ctor.
-    def initialize(sync: false, limit: 65_536)
-      @ports = []
-      @sync = sync
-      @monitor = Monitor.new
-      @limit = limit
-    end
+  # Ctor.
+  # @param [bool] Set it to FALSE if you want this pool to be NOT thread-safe
+  # @param [int] Set the maximum number of ports in the pool
+  def initialize(sync: true, limit: 65_536)
+    @ports = []
+    @sync = sync
+    @monitor = Monitor.new
+    @limit = limit
+  end
 
-    # Application wide pool of ports
-    SINGLETON = Pool.new
+  # Application wide pool of ports
+  SINGLETON = RandomPort::Pool.new
 
-    # How many ports acquired now?
-    def count
-      @ports.count
-    end
-    alias size count
+  # How many ports acquired now?
+  def count
+    @ports.count
+  end
+  alias size count
 
-    # Is it empty?
-    def empty?
-      @ports.empty?
-    end
+  # Is it empty?
+  def empty?
+    @ports.empty?
+  end
 
-    # Acquire a new random TCP port.
-    #
-    # You can specify the number of ports to acquire. If it's more than one,
-    # an array will be returned.
-    #
-    # You can specify the amount of seconds to wait until a new port
-    # is available.
-    def acquire(total = 1, timeout: 4)
-      start = Time.now
-      loop do
-        if Time.now > start + timeout
-          raise Timeout, "Can't find a place in the pool of #{@limit} ports \
+  # Acquire a new random TCP port.
+  #
+  # You can specify the number of ports to acquire. If it's more than one,
+  # an array will be returned.
+  #
+  # You can specify the amount of seconds to wait until a new port
+  # is available.
+  def acquire(total = 1, timeout: 4)
+    start = Time.now
+    loop do
+      if Time.now > start + timeout
+        raise Timeout, "Can't find a place in the pool of #{@limit} ports \
 for #{total} port(s), in #{format('%.02f', Time.now - start)}s"
-        end
-        opts = safe do
-          next if @ports.count + total > @limit
-          opts = Array.new(0, total)
-          begin
-            (0..(total - 1)).each do |i|
-              opts[i] = i.zero? ? take : take(opts[i - 1] + 1)
-            end
-          rescue Errno::EADDRINUSE, SocketError
-            next
-          end
-          next if opts.any? { |p| @ports.include?(p) }
-          d = total * (total - 1) / 2
-          next unless opts.inject(&:+) - total * opts.min == d
-          @ports += opts
-          opts
-        end
-        next if opts.nil?
-        opts = opts[0] if total == 1
-        return opts unless block_given?
+      end
+      opts = safe do
+        next if @ports.count + total > @limit
+        opts = Array.new(0, total)
         begin
-          return yield opts
-        ensure
-          release(opts)
+          (0..(total - 1)).each do |i|
+            opts[i] = i.zero? ? take : take(opts[i - 1] + 1)
+          end
+        rescue Errno::EADDRINUSE, SocketError
+          next
         end
+        next if opts.any? { |p| @ports.include?(p) }
+        d = total * (total - 1) / 2
+        next unless opts.inject(&:+) - (total * opts.min) == d
+        @ports += opts
+        opts
+      end
+      next if opts.nil?
+      opts = opts[0] if total == 1
+      return opts unless block_given?
+      begin
+        return yield opts
+      ensure
+        release(opts)
       end
     end
+  end
 
-    # Return it/them back to the pool.
-    def release(port)
-      safe do
-        if port.is_a?(Array)
-          port.each { |p| @ports.delete(p) }
-        else
-          @ports.delete(port)
-        end
+  # Return it/them back to the pool.
+  def release(port)
+    safe do
+      if port.is_a?(Array)
+        port.each { |p| @ports.delete(p) }
+      else
+        @ports.delete(port)
       end
     end
+  end
 
-    private
+  private
 
-    def take(opt = 0)
-      server = TCPServer.new('127.0.0.1', opt)
-      p = server.addr[1]
-      server.close
-      p
-    end
+  def take(opt = 0)
+    server = TCPServer.new('127.0.0.1', opt)
+    p = server.addr[1]
+    server.close
+    p
+  end
 
-    def safe
-      if @sync
-        @monitor.synchronize { yield }
-      else
-        yield
-      end
+  def safe(&block)
+    if @sync
+      @monitor.synchronize(&block)
+    else
+      yield
     end
   end
 end

data/lib/random-port.rb

@@ -2,7 +2,7 @@
 
 # (The MIT License)
 #
-# Copyright (c) 2018 Yegor Bugayenko
+# Copyright (c) 2018-2024 Yegor Bugayenko
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the 'Software'), to deal
@@ -22,4 +22,5 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 
-require 'random-port/pool'
+require_relative 'random-port/module'
+require_relative 'random-port/pool'

data/random-port.gemspec

@@ -2,7 +2,7 @@
 
 # (The MIT License)
 #
-# Copyright (c) 2018 Yegor Bugayenko
+# Copyright (c) 2018-2024 Yegor Bugayenko
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the 'Software'), to deal
@@ -24,14 +24,10 @@
 
 require 'English'
 Gem::Specification.new do |s|
-  s.specification_version = 2 if s.respond_to? :specification_version=
-  if s.respond_to? :required_rubygems_version=
-    s.required_rubygems_version = Gem::Requirement.new('>= 0')
-  end
-  s.rubygems_version = '2.3.3'
+  s.required_rubygems_version = Gem::Requirement.new('>= 0') if s.respond_to? :required_rubygems_version=
   s.required_ruby_version = '>=2.3'
   s.name = 'random-port'
-  s.version = '0.5.1'
+  s.version = '0.7.0'
   s.license = 'MIT'
   s.summary = 'Random TCP port'
   s.description = 'Reserves a random TCP port'
@@ -39,13 +35,7 @@ Gem::Specification.new do |s|
   s.email = 'yegor256@gmail.com'
   s.homepage = 'http://github.com/yegor256/random-port'
   s.files = `git ls-files`.split($RS)
-  s.test_files = s.files.grep(%r{^(test)/})
   s.rdoc_options = ['--charset=UTF-8']
   s.extra_rdoc_files = ['README.md']
-  s.add_development_dependency 'codecov', '0.1.10'
-  s.add_development_dependency 'minitest', '5.11.3'
-  s.add_development_dependency 'rake', '12.3.1'
-  s.add_development_dependency 'rdoc', '4.3.0'
-  s.add_development_dependency 'rubocop', '0.58.1'
-  s.add_development_dependency 'rubocop-rspec', '1.27.0'
+  s.metadata['rubygems_mfa_required'] = 'true'
 end

data/renovate.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": [
+    "config:recommended"
+  ]
+}

data/test/test__helper.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright (c) 2018-2019 Yegor Bugayenko
+# Copyright (c) 2018-2024 Yegor Bugayenko
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the 'Software'), to deal
@@ -20,13 +20,8 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 
-STDOUT.sync = true
+$stdout.sync = true
 
 require 'simplecov'
 SimpleCov.start
-if ENV['CI'] == 'true'
-  require 'codecov'
-  SimpleCov.formatter = SimpleCov::Formatter::Codecov
-end
-
 require 'minitest/autorun'

data/test/test_pool.rb

@@ -2,7 +2,7 @@
 
 # (The MIT License)
 #
-# Copyright (c) 2018 Yegor Bugayenko
+# Copyright (c) 2018-2024 Yegor Bugayenko
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the 'Software'), to deal
@@ -23,88 +23,110 @@
 # SOFTWARE.
 
 require 'minitest/autorun'
+require 'threads'
+require 'socket'
 require_relative '../lib/random-port/pool'
 
 # Pool test.
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
-# Copyright:: Copyright (c) 2018 Yegor Bugayenko
+# Copyright:: Copyright (c) 2018-2024 Yegor Bugayenko
 # License:: MIT
-module RandomPort
-  class TestAmount < Minitest::Test
-    def test_acquires_and_releases
-      pool = Pool.new
-      port = pool.acquire
-      assert(!port.nil?)
-      assert(port.positive?)
-      pool.release(port)
-    end
+class RandomPort::TestPool < Minitest::Test
+  def test_acquires_and_releases
+    pool = RandomPort::Pool.new
+    port = pool.acquire
+    server = TCPServer.new('localhost', port)
+    server.close
+    assert(!port.nil?)
+    assert(port.positive?)
+    pool.release(port)
+  end
 
-    def test_acquires_and_releases_three_ports
-      pool = Pool.new(limit: 3)
-      assert_equal(0, pool.size)
-      ports = pool.acquire(3, timeout: 16)
-      assert_equal(3, pool.size)
-      assert_equal(3, ports.count)
-      pool.release(ports)
-      assert_equal(0, pool.size)
+  def test_acquires_and_releases_three_ports
+    pool = RandomPort::Pool.new(limit: 3)
+    assert_equal(0, pool.size)
+    ports = pool.acquire(3, timeout: 16)
+    ports.each do |p|
+      server = TCPServer.new('localhost', p)
+      server.close
     end
+    assert_equal(3, pool.size)
+    assert_equal(3, ports.count)
+    pool.release(ports)
+    assert_equal(0, pool.size)
+  end
 
-    def test_acquires_and_releases_three_ports_in_block
-      pool = Pool.new(limit: 3)
-      assert_equal(0, pool.size)
-      pool.acquire(3, timeout: 16) do |ports|
-        assert(ports.is_a?(Array))
-        assert_equal(3, ports.count)
-        assert_equal(3, pool.size)
+  def test_acquires_and_releases_three_ports_in_block
+    pool = RandomPort::Pool.new(limit: 3)
+    assert_equal(0, pool.size)
+    pool.acquire(3, timeout: 16) do |ports|
+      assert(ports.is_a?(Array))
+      assert_equal(3, ports.count)
+      assert_equal(3, pool.size)
+      ports.each do |p|
+        server = TCPServer.new('localhost', p)
+        server.close
       end
-      assert_equal(0, pool.size)
     end
+    assert_equal(0, pool.size)
+  end
 
-    def test_acquires_and_releases_in_block
-      result = Pool.new.acquire do |port|
-        assert(!port.nil?)
-        assert(port.positive?)
-        123
-      end
-      assert_equal(123, result)
+  def test_acquires_and_releases_in_block
+    result = RandomPort::Pool.new.acquire do |port|
+      assert(!port.nil?)
+      assert(port.positive?)
+      123
     end
+    assert_equal(123, result)
+  end
 
-    def test_acquires_and_releases_safely
-      pool = Pool.new
-      assert_raises do
-        pool.acquire do
-          raise 'Itended'
+  def test_acquires_and_releases_in_threads
+    pool = RandomPort::Pool.new
+    Threads.new(100).assert do
+      pool.acquire(5) do |ports|
+        ports.each do |p|
+          server = TCPServer.new('localhost', p)
+          server.close
         end
       end
-      assert(pool.count.zero?)
     end
+  end
 
-    def test_acquires_and_releases_from_singleton
-      Pool::SINGLETON.acquire do |port|
-        assert(!port.nil?)
-        assert(port.positive?)
+  def test_acquires_and_releases_safely
+    pool = RandomPort::Pool.new
+    assert_raises do
+      pool.acquire do
+        raise 'Itended'
       end
     end
+    assert(pool.count.zero?)
+  end
 
-    def test_acquires_unique_numbers
-      total = 25
-      numbers = (0..total - 1).map { Pool::SINGLETON.acquire }
-      assert_equal(total, numbers.uniq.count)
+  def test_acquires_and_releases_from_singleton
+    RandomPort::Pool::SINGLETON.acquire do |port|
+      assert(!port.nil?)
+      assert(port.positive?)
     end
+  end
 
-    def test_raises_when_too_many
-      pool = Pool.new(limit: 1)
-      pool.acquire
-      assert_raises Pool::Timeout do
-        pool.acquire(timeout: 0.1)
-      end
-    end
+  def test_acquires_unique_numbers
+    total = 25
+    numbers = (0..total - 1).map { RandomPort::Pool::SINGLETON.acquire }
+    assert_equal(total, numbers.uniq.count)
+  end
 
-    def test_acquires_unique_numbers_in_no_sync_mode
-      total = 25
-      pool = Pool.new(sync: false)
-      numbers = (0..total - 1).map { pool.acquire }
-      assert_equal(total, numbers.uniq.count)
+  def test_raises_when_too_many
+    pool = RandomPort::Pool.new(limit: 1)
+    pool.acquire
+    assert_raises RandomPort::Pool::Timeout do
+      pool.acquire(timeout: 0.1)
     end
   end
+
+  def test_acquires_unique_numbers_in_no_sync_mode
+    total = 25
+    pool = RandomPort::Pool.new(sync: false)
+    numbers = (0..total - 1).map { pool.acquire }
+    assert_equal(total, numbers.uniq.count)
+  end
 end

metadata

@@ -1,99 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: random-port
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Yegor Bugayenko
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-09-10 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: codecov
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 0.1.10
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 0.1.10
-- !ruby/object:Gem::Dependency
-  name: minitest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 5.11.3
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 5.11.3
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 12.3.1
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 12.3.1
-- !ruby/object:Gem::Dependency
-  name: rdoc
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 4.3.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 4.3.0
-- !ruby/object:Gem::Dependency
-  name: rubocop
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 0.58.1
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 0.58.1
-- !ruby/object:Gem::Dependency
-  name: rubocop-rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 1.27.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 1.27.0
+date: 2024-07-10 00:00:00.000000000 Z
+dependencies: []
 description: Reserves a random TCP port
 email: yegor256@gmail.com
 executables: []
@@ -102,24 +18,33 @@ extra_rdoc_files:
 - README.md
 files:
 - ".0pdd.yml"
+- ".github/workflows/actionlint.yml"
+- ".github/workflows/codecov.yml"
+- ".github/workflows/copyrights.yml"
+- ".github/workflows/markdown-lint.yml"
+- ".github/workflows/pdd.yml"
+- ".github/workflows/rake.yml"
+- ".github/workflows/xcop.yml"
 - ".gitignore"
 - ".pdd"
 - ".rubocop.yml"
 - ".rultor.yml"
-- ".travis.yml"
 - Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
 - lib/random-port.rb
+- lib/random-port/module.rb
 - lib/random-port/pool.rb
 - random-port.gemspec
+- renovate.json
 - test/test__helper.rb
 - test/test_pool.rb
 homepage: http://github.com/yegor256/random-port
 licenses:
 - MIT
-metadata: {}
+metadata:
+  rubygems_mfa_required: 'true'
 post_install_message: 
 rdoc_options:
 - "--charset=UTF-8"
@@ -136,10 +61,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.1
+rubygems_version: 3.4.10
 signing_key: 
-specification_version: 2
+specification_version: 4
 summary: Random TCP port
-test_files:
-- test/test__helper.rb
-- test/test_pool.rb
+test_files: []

data/.travis.yml

@@ -1,13 +0,0 @@
-language: ruby
-rvm:
-  - 2.6.0
-cache: bundler
-branches:
-  only:
-    - master
-install:
-  - travis_retry bundle update
-script:
-  - bundle exec rake
-after_success:
-  - "bash <(curl -s https://codecov.io/bash)"