glogin 0.16.4 → 0.17.0

data/lib/glogin/cookie.rb

@@ -1,51 +1,74 @@
 # frozen_string_literal: true
 
-#
-# Copyright (c) 2017-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 NONINFINGEMENT. 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.
+# SPDX-FileCopyrightText: Copyright (c) 2017-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
-require 'openssl'
-require 'digest/sha1'
 require 'base64'
+require 'digest/sha1'
+require 'openssl'
 require_relative 'codec'
 
 # GLogin main module.
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
-# Copyright:: Copyright (c) 2017-2024 Yegor Bugayenko
+# Copyright:: Copyright (c) 2017-2025 Yegor Bugayenko
 # License:: MIT
 module GLogin
   # Split symbol inside the cookie text
   SPLIT = '|'
 
+  # Secure cookie management for user sessions.
+  #
+  # This class provides two nested classes for handling cookies:
+  # - Cookie::Open: Creates encrypted cookies from user data
+  # - Cookie::Closed: Decrypts and validates existing cookies
   #
-  # Secure cookie
+  # The cookie format stores user ID, login, avatar URL, and an optional
+  # context string for additional security validation.
   #
+  # @example Creating and reading a cookie
+  #   # After successful authentication
+  #   user_data = auth.user(code)
+  #   cookie = GLogin::Cookie::Open.new(user_data, 'secret-key')
+  #   response.set_cookie('glogin', cookie.to_s)
+  #
+  #   # When reading the cookie
+  #   cookie_text = request.cookies['glogin']
+  #   closed = GLogin::Cookie::Closed.new(cookie_text, 'secret-key')
+  #   user = closed.to_user
+  #   # => {"id"=>"123", "login"=>"username", "avatar_url"=>"https://..."}
   class Cookie
-    # Closed cookie.
+    # Closed cookie for reading existing cookies.
     #
     # An instance of this class is created when a cookie arrives
-    # to the application. The cookie text is provided to the class
-    # as the first parameter. Then, when an instance of the class
-    # is created, the value encypted inside the cookie text may
-    # be retrieved through the +to_user+ method.
+    # from the client. The encrypted cookie text is decrypted to
+    # retrieve the original user information.
+    #
+    # @example Read a cookie from HTTP request
+    #   cookie_text = request.cookies['glogin']
+    #   closed = GLogin::Cookie::Closed.new(cookie_text, ENV['SECRET'])
+    #
+    #   begin
+    #     user = closed.to_user
+    #     session[:user_id] = user['id']
+    #   rescue GLogin::Codec::DecodingError
+    #     # Invalid cookie - redirect to login
+    #     redirect '/login'
+    #   end
+    #
+    # @example Using context for additional security
+    #   closed = GLogin::Cookie::Closed.new(
+    #     cookie_text,
+    #     ENV['SECRET'],
+    #     request.ip  # Validate against IP address
+    #   )
+    #   user = closed.to_user
     class Closed
+      # Creates a new closed cookie instance.
+      #
+      # @param text [String] The encrypted cookie text to decrypt
+      # @param secret [String] The secret key used for decryption
+      # @param context [String] Optional context string for validation
+      # @raise [RuntimeError] if any parameter is nil
       def initialize(text, secret, context = '')
         raise 'Text can\'t be nil' if text.nil?
         @text = text
@@ -55,14 +78,27 @@ module GLogin
         @context = context.to_s
       end
 
-      # Returns a hash with four elements: `id`, `login`, and `avatar_url`.
+      # Decrypts and returns the user information from the cookie.
       #
-      # If the `secret` is empty, the text will not be decrypted, but used
-      # "as is". This may be helpful during testing.
+      # @return [Hash] User information with keys 'id', 'login', and 'avatar_url'
+      # @raise [GLogin::Codec::DecodingError] if:
+      #   - The cookie is corrupted or tampered with
+      #   - The wrong secret key is used
+      #   - The context doesn't match (if provided)
+      # @example Basic usage
+      #   user = closed.to_user
+      #   # => {"id"=>"123", "login"=>"octocat", "avatar_url"=>"https://..."}
       #
-      # If the data is not valid, an exception
-      # `GLogin::Codec::DecodingError` will be raised, which you have
-      # to catch in your applicaiton and ignore the login attempt.
+      # @example Error handling
+      #   begin
+      #     user = closed.to_user
+      #     puts "Welcome, #{user['login']}!"
+      #   rescue GLogin::Codec::DecodingError => e
+      #     puts "Invalid session: #{e.message}"
+      #     redirect_to_login
+      #   end
+      #
+      # @note If the secret is empty (test mode), the text is used as-is without decryption
       def to_user
         plain = Codec.new(@secret).decrypt(@text)
         id, login, avatar_url, ctx = plain.split(GLogin::SPLIT, 5)
@@ -76,18 +112,50 @@ module GLogin
       end
     end
 
-    # Open
+    # Open cookie for creating new cookies.
+    #
+    # This class takes user information from GitHub authentication
+    # and creates an encrypted cookie that can be sent to the client.
+    #
+    # @example Create a cookie after successful authentication
+    #   user_data = auth.user(code)
+    #   open = GLogin::Cookie::Open.new(user_data, ENV['SECRET'])
+    #
+    #   # Set cookie with options
+    #   response.set_cookie('glogin', {
+    #     value: open.to_s,
+    #     expires: 1.week.from_now,
+    #     httponly: true,
+    #     secure: true
+    #   })
+    #
+    # @example Using context for IP-based validation
+    #   open = GLogin::Cookie::Open.new(
+    #     user_data,
+    #     ENV['SECRET'],
+    #     request.ip  # Bind cookie to IP address
+    #   )
+    #   response.set_cookie('glogin', open.to_s)
     class Open
       attr_reader :id, :login, :avatar_url
 
-      # Here comes the JSON you receive from Auth.user().
+      # Creates a new open cookie from user data.
       #
-      # The JSON is a Hash where every key is a string. When the class is instantiated,
-      # its methods `id`, `login`, and `avatar_url` may be used to retrieve
-      # the data inside the JSON, but this is not what this class is mainly about.
-      #
-      # The method +to_s+ returns an encrypted cookie string, that may be
-      # sent to the user as a +Set-Cookie+ HTTP header.
+      # @param json [Hash] User data from Auth#user, must contain 'id' key
+      # @param secret [String] Secret key for encryption
+      # @param context [String] Optional context for additional validation
+      # @raise [RuntimeError] if json is nil or missing 'id' key
+      # @raise [RuntimeError] if secret or context is nil
+      # @example
+      #   user_data = {
+      #     'id' => '123456',
+      #     'login' => 'octocat',
+      #     'avatar_url' => 'https://github.com/octocat.png'
+      #   }
+      #   open = GLogin::Cookie::Open.new(user_data, 'secret-key')
+      #   puts open.id         # => "123456"
+      #   puts open.login      # => "octocat"
+      #   puts open.avatar_url # => "https://github.com/octocat.png"
       def initialize(json, secret, context = '')
         raise 'JSON can\'t be nil' if json.nil?
         raise 'JSON must contain "id" key' if json['id'].nil?
@@ -101,7 +169,27 @@ module GLogin
         @context = context.to_s
       end
 
-      # Returns the text you should drop back to the user as a cookie.
+      # Generates the encrypted cookie string.
+      #
+      # This method encrypts the user information (id, login, avatar_url, and context)
+      # into a string that can be sent as an HTTP cookie. The encryption ensures
+      # the cookie cannot be tampered with.
+      #
+      # @return [String] The encrypted cookie value
+      # @example Generate cookie for HTTP response
+      #   open = GLogin::Cookie::Open.new(user_data, secret)
+      #   cookie_value = open.to_s
+      #   # => "3Hs9k2LgU..." (encrypted string)
+      #
+      #   # Use with Sinatra
+      #   response.set_cookie('glogin', cookie_value)
+      #
+      #   # Use with Rails
+      #   cookies[:glogin] = {
+      #     value: cookie_value,
+      #     expires: 1.week.from_now,
+      #     httponly: true
+      #   }
       def to_s
         Codec.new(@secret).encrypt(
           [

data/lib/glogin/version.rb

@@ -1,30 +1,22 @@
 # frozen_string_literal: true
 
-#
-# Copyright (c) 2017-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 NONINFINGEMENT. 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.
+# SPDX-FileCopyrightText: Copyright (c) 2017-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
 # GLogin main module.
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
-# Copyright:: Copyright (c) 2017-2024 Yegor Bugayenko
+# Copyright:: Copyright (c) 2017-2025 Yegor Bugayenko
 # License:: MIT
 module GLogin
-  VERSION = '0.16.4'
+  # Current version of the GLogin gem.
+  #
+  # @example Check the gem version
+  #   puts GLogin::VERSION
+  #   # => "0.17.0"
+  #
+  # @example Version comparison
+  #   if Gem::Version.new(GLogin::VERSION) >= Gem::Version.new('0.1.0')
+  #     puts "Using GLogin version 0.1.0 or newer"
+  #   end
+  VERSION = '0.17.0'
 end

data/lib/glogin.rb

@@ -1,34 +1,39 @@
 # frozen_string_literal: true
 
-#
-# Copyright (c) 2017-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 NONINFINGEMENT. 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.
+# SPDX-FileCopyrightText: Copyright (c) 2017-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
-require 'nokogiri'
-require_relative 'glogin/version'
 require_relative 'glogin/auth'
 require_relative 'glogin/cookie'
+require_relative 'glogin/version'
 
 # GLogin main module.
+#
+# GLogin is a Ruby gem that provides OAuth integration with GitHub. It simplifies
+# the process of authenticating users through GitHub and managing their sessions
+# using secure cookies.
+#
+# @example Basic usage with Sinatra
+#   require 'sinatra'
+#   require 'glogin'
+#
+#   configure do
+#     set :glogin, GLogin::Auth.new(
+#       ENV['GITHUB_CLIENT_ID'],
+#       ENV['GITHUB_CLIENT_SECRET'],
+#       'http://localhost:4567/auth'
+#     )
+#   end
+#
+#   get '/auth' do
+#     user = settings.glogin.user(params[:code])
+#     cookie = GLogin::Cookie::Open.new(user, ENV['ENCRYPTION_SECRET'])
+#     response.set_cookie('glogin', cookie.to_s)
+#     redirect '/'
+#   end
+#
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
-# Copyright:: Copyright (c) 2017-2024 Yegor Bugayenko
+# Copyright:: Copyright (c) 2017-2025 Yegor Bugayenko
 # License:: MIT
 module GLogin
 end

data/logo.svg

@@ -16,4 +16,4 @@
             </g>
         </g>
     </g>
-</svg>
+</svg>

data/test/glogin/test_auth.rb

@@ -1,29 +1,10 @@
 # frozen_string_literal: true
 
-#
-# Copyright (c) 2017-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 NONINFINGEMENT. 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.
+# SPDX-FileCopyrightText: Copyright (c) 2017-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
-require 'minitest/autorun'
-require 'webmock/minitest'
 require_relative '../../lib/glogin/cookie'
+require_relative '../test__helper'
 
 class TestAuth < Minitest::Test
   def test_authenticate_via_https
@@ -62,21 +43,21 @@ class TestAuth < Minitest::Test
   def test_failed_authentication
     auth = GLogin::Auth.new('1234', '4433', 'https://example.org')
     stub_request(:post, 'https://github.com/login/oauth/access_token').to_return(status: 401)
-    e = assert_raises { auth.user('437849732894732') }
-    assert(e.message.include?('with code "43784***'))
+    e = assert_raises(StandardError) { auth.user('437849732894732') }
+    assert_includes(e.message, 'with code "43784***')
   end
 
   def test_broken_json
     auth = GLogin::Auth.new('1234', '4433', 'https://example.org')
     stub_request(:post, 'https://github.com/login/oauth/access_token').to_return(body: 'Hello!')
-    e = assert_raises { auth.user('47839893') }
-    assert(e.message.include?('unexpected token'), e)
+    e = assert_raises(StandardError) { auth.user('47839893') }
+    assert_includes(e.message, 'unexpected', e)
   end
 
   def test_no_token_in_json
     auth = GLogin::Auth.new('1234', '4433', 'https://example.org')
     stub_request(:post, 'https://github.com/login/oauth/access_token').to_return(body: '{}')
-    e = assert_raises { auth.user('47839893') }
-    assert(e.message.include?('There is no \'access_token\''), e)
+    e = assert_raises(StandardError) { auth.user('47839893') }
+    assert_includes(e.message, 'There is no \'access_token\'', e)
   end
 end

data/test/glogin/test_codec.rb

@@ -1,29 +1,11 @@
 # frozen_string_literal: true
 
-#
-# Copyright (c) 2017-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 NONINFINGEMENT. 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.
+# SPDX-FileCopyrightText: Copyright (c) 2017-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
-require 'minitest/autorun'
 require 'base64'
 require_relative '../../lib/glogin/codec'
+require_relative '../test__helper'
 
 class TestCodec < Minitest::Test
   def test_encodes_and_decodes
@@ -48,10 +30,18 @@ class TestCodec < Minitest::Test
     end
   end
 
+  def test_decrypts_broken_base58
+    %w[abc0 abcO abcl abcI].each do |t|
+      assert_raises GLogin::Codec::DecodingError do
+        GLogin::Codec.new('some-key').decrypt(t)
+      end
+    end
+  end
+
   def test_encrypts_into_plain_string
     text = GLogin::Codec.new('6hFGrte5LLmwi').encrypt("K&j\n\n\tuIpwp00{]=")
-    assert(text =~ /^[a-zA-Z0-9]+$/, text)
-    assert(!text.include?("\n"), text)
+    assert_match(/^[a-zA-Z0-9]+$/, text, text)
+    refute_includes(text, "\n", text)
   end
 
   def test_encrypts_using_base64

data/test/glogin/test_cookie.rb

@@ -1,28 +1,10 @@
 # frozen_string_literal: true
 
-#
-# Copyright (c) 2017-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 NONINFINGEMENT. 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.
+# SPDX-FileCopyrightText: Copyright (c) 2017-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
-require 'minitest/autorun'
 require_relative '../../lib/glogin/cookie'
+require_relative '../test__helper'
 
 class TestCookie < Minitest::Test
   def test_encrypts_and_decrypts
@@ -38,8 +20,8 @@ class TestCookie < Minitest::Test
       ).to_s,
       secret
     ).to_user
-    assert_equal(user['login'], 'yegor256')
-    assert_equal(user['avatar_url'], 'https://avatars1.githubusercontent.com/u/526301')
+    assert_equal('yegor256', user['login'])
+    assert_equal('https://avatars1.githubusercontent.com/u/526301', user['avatar_url'])
   end
 
   def test_encrypts_and_decrypts_with_context
@@ -54,18 +36,18 @@ class TestCookie < Minitest::Test
       secret,
       context
     ).to_user
-    assert_equal(user['id'], '123')
-    assert_equal(user['login'], 'jeffrey')
-    assert_equal(user['avatar_url'], '#')
+    assert_equal('123', user['id'])
+    assert_equal('jeffrey', user['login'])
+    assert_equal('#', user['avatar_url'])
   end
 
   def test_decrypts_in_test_mode
     user = GLogin::Cookie::Closed.new(
       '123|test|http://example.com', ''
     ).to_user
-    assert_equal(user['id'], '123')
-    assert_equal(user['login'], 'test')
-    assert_equal(user['avatar_url'], 'http://example.com')
+    assert_equal('123', user['id'])
+    assert_equal('test', user['login'])
+    assert_equal('http://example.com', user['avatar_url'])
   end
 
   def test_decrypts_in_test_mode_with_context

data/test/test__helper.rb

@@ -1,30 +1,32 @@
 # frozen_string_literal: true
 
-#
-# Copyright (c) 2017-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 NONINFINGEMENT. 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.
+# SPDX-FileCopyrightText: Copyright (c) 2017-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
 $stdout.sync = true
 
 require 'simplecov'
-SimpleCov.start
+require 'simplecov-cobertura'
+unless SimpleCov.running || ENV['PICKS']
+  SimpleCov.command_name('test')
+  SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter.new(
+    [
+      SimpleCov::Formatter::HTMLFormatter,
+      SimpleCov::Formatter::CoberturaFormatter
+    ]
+  )
+  SimpleCov.minimum_coverage 100
+  SimpleCov.minimum_coverage_by_file 95
+  SimpleCov.start do
+    add_filter 'test/'
+    add_filter 'vendor/'
+    add_filter 'target/'
+    track_files 'lib/**/*.rb'
+    track_files '*.rb'
+  end
+end
 
 require 'minitest/autorun'
-require_relative '../lib/glogin'
+require 'minitest/reporters'
+require 'webmock/minitest'
+Minitest::Reporters.use! [Minitest::Reporters::SpecReporter.new]

data/test/test_glogin.rb

@@ -1,32 +1,14 @@
 # frozen_string_literal: true
 
-#
-# Copyright (c) 2017-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 NONINFINGEMENT. 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.
+# SPDX-FileCopyrightText: Copyright (c) 2017-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
-require 'minitest/autorun'
 require_relative '../lib/glogin'
+require_relative 'test__helper'
 
 # GLogin main module test.
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
-# Copyright:: Copyright (c) 2017-2024 Yegor Bugayenko
+# Copyright:: Copyright (c) 2017-2025 Yegor Bugayenko
 # License:: MIT
 class TestGLogin < Minitest::Test
   def test_basic