Modernize code.

Author: ioquatix

.github/workflows/documentation-coverage.yaml

@@ -13,7 +13,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - uses: ruby/setup-ruby@v1
       with:
         ruby-version: ruby

.github/workflows/documentation.yaml

@@ -24,7 +24,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
 
     - uses: ruby/setup-ruby@v1
       with:
@@ -39,7 +39,7 @@ jobs:
       run: bundle exec bake utopia:project:static --force no
 
     - name: Upload documentation artifact
-      uses: actions/upload-pages-artifact@v3
+      uses: actions/upload-pages-artifact@v4
       with:
         path: docs
 

.github/workflows/rubocop.yaml

@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - uses: ruby/setup-ruby@v1
       with:
         ruby-version: ruby

.github/workflows/test-coverage.yaml

@@ -23,7 +23,7 @@ jobs:
           - ruby
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - uses: ruby/setup-ruby@v1
       with:
         ruby-version: ${{matrix.ruby}}
@@ -33,7 +33,7 @@ jobs:
       timeout-minutes: 5
       run: bundle exec bake test
 
-    - uses: actions/upload-artifact@v4
+    - uses: actions/upload-artifact@v5
       with:
         include-hidden-files: true
         if-no-files-found: error
@@ -45,13 +45,13 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - uses: ruby/setup-ruby@v1
       with:
         ruby-version: ruby
         bundler-cache: true
 
-    - uses: actions/download-artifact@v4
+    - uses: actions/download-artifact@v6
 
     - name: Validate coverage
       timeout-minutes: 5

.github/workflows/test-external.yaml

@@ -20,9 +20,10 @@ jobs:
           - "3.2"
           - "3.3"
           - "3.4"
+          - "4.0"
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - uses: ruby/setup-ruby@v1
       with:
         ruby-version: ${{matrix.ruby}}

.github/workflows/test.yaml

@@ -21,6 +21,7 @@ jobs:
           - "3.2"
           - "3.3"
           - "3.4"
+          - "4.0"
 
         experimental: [false]
 
@@ -36,7 +37,7 @@ jobs:
             experimental: true
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - uses: ruby/setup-ruby@v1
       with:
         ruby-version: ${{matrix.ruby}}

.rubocop.yml

@@ -1,12 +1,23 @@
 plugins:
+  - rubocop-md
   - rubocop-socketry
 
 AllCops:
   DisabledByDefault: true
 
+# Socketry specific rules:
+
 Layout/ConsistentBlankLineIndentation:
   Enabled: true
 
+Layout/BlockDelimiterSpacing:
+  Enabled: true
+
+Style/GlobalExceptionVariables:
+  Enabled: true
+
+# General Layout rules:
+
 Layout/IndentationStyle:
   Enabled: true
   EnforcedStyle: tabs
@@ -33,6 +44,9 @@ Layout/BeginEndAlignment:
   Enabled: true
   EnforcedStyleAlignWith: start_of_line
 
+Layout/RescueEnsureAlignment:
+  Enabled: true
+
 Layout/ElseAlignment:
   Enabled: true
 
@@ -41,10 +55,15 @@ Layout/DefEndAlignment:
 
 Layout/CaseIndentation:
   Enabled: true
+  EnforcedStyle: end
 
 Layout/CommentIndentation:
   Enabled: true
 
+Layout/FirstHashElementIndentation:
+  Enabled: true
+  EnforcedStyle: consistent
+
 Layout/EmptyLinesAroundClassBody:
   Enabled: true
 

context/design-overview.md

@@ -205,5 +205,5 @@ interim_response_callback = proc do |status, headers|
 	end
 end
 
-response = client.post("/upload", {'expect' => '100-continue'}, body, interim_response: interim_response_callback)
+response = client.post("/upload", {"expect" => "100-continue"}, body, interim_response: interim_response_callback)
 ```

context/getting-started.md

@@ -34,7 +34,7 @@ This gem does not provide any specific client or server implementation, rather i
 {ruby Protocol::HTTP::Request} represents an HTTP request which can be used both server and client-side.
 
 ``` ruby
-require 'protocol/http/request'
+require "protocol/http/request"
 
 # Short form (recommended):
 request = Protocol::HTTP::Request["GET", "/index.html", {"accept" => "text/html"}]
@@ -54,7 +54,7 @@ request.headers          # => Protocol::HTTP::Headers instance
 {ruby Protocol::HTTP::Response} represents an HTTP response which can be used both server and client-side.
 
 ``` ruby
-require 'protocol/http/response'
+require "protocol/http/response"
 
 # Short form (recommended):
 response = Protocol::HTTP::Response[200, {"content-type" => "text/html"}, "Hello, World!"]
@@ -83,15 +83,15 @@ response.failure?        # => false (400-599)
 #### Basic Usage
 
 ``` ruby
-require 'protocol/http/headers'
+require "protocol/http/headers"
 
 headers = Protocol::HTTP::Headers.new
 
 # Assignment by title-case key:
-headers['Content-Type'] = "image/jpeg"
+headers["Content-Type"] = "image/jpeg"
 
 # Lookup by lower-case (normalized) key:
-headers['content-type']
+headers["content-type"]
 # => "image/jpeg"
 ```
 
@@ -101,8 +101,8 @@ Many headers receive special semantic processing, automatically splitting comma-
 
 ``` ruby
 # Accept header with quality values:
-headers['Accept'] = 'text/html, application/json;q=0.8, */*;q=0.1'
-accept = headers['accept']
+headers["Accept"] = "text/html, application/json;q=0.8, */*;q=0.1"
+accept = headers["accept"]
 # => ["text/html", "application/json;q=0.8", "*/*;q=0.1"]
 
 # Access parsed media ranges with quality factors:
@@ -114,17 +114,17 @@ end
 # */* (q=0.1)
 
 # Accept-Encoding automatically splits values:
-headers['Accept-Encoding'] = 'gzip, deflate, br;q=0.9'
-headers['accept-encoding']
+headers["Accept-Encoding"] = "gzip, deflate, br;q=0.9"
+headers["accept-encoding"]
 # => ["gzip", "deflate", "br;q=0.9"]
 
 # Cache-Control splits directives:
-headers['Cache-Control'] = 'max-age=3600, no-cache, must-revalidate'
-headers['cache-control']
+headers["Cache-Control"] = "max-age=3600, no-cache, must-revalidate"
+headers["cache-control"]
 # => ["max-age=3600", "no-cache", "must-revalidate"]
 
 # Vary header normalizes field names to lowercase:
-headers['Vary'] = 'Accept-Encoding, User-Agent'
-headers['vary']
+headers["Vary"] = "Accept-Encoding, User-Agent"
+headers["vary"]
 # => ["accept-encoding", "user-agent"]
 ```

context/headers.md

@@ -15,17 +15,17 @@ This guide explains how to work with HTTP headers using `protocol-http`.
 The {Protocol::HTTP::Headers} class provides a comprehensive interface for creating and manipulating HTTP headers:
 
 ```ruby
-require 'protocol/http'
+require "protocol/http"
 
 headers = Protocol::HTTP::Headers.new
-headers.add('content-type', 'text/html')
-headers.add('set-cookie', 'session=abc123')
+headers.add("content-type", "text/html")
+headers.add("set-cookie", "session=abc123")
 
 # Access headers
-content_type = headers['content-type'] # => "text/html"
+content_type = headers["content-type"] # => "text/html"
 
 # Check if header exists
-headers.include?('content-type') # => true
+headers.include?("content-type") # => true
 ```
 
 ### Header Policies
@@ -34,11 +34,11 @@ Different header types have different behaviors for merging, validation, and tra
 
 ```ruby
 # Some headers can be specified multiple times
-headers.add('set-cookie', 'first=value1')
-headers.add('set-cookie', 'second=value2')
+headers.add("set-cookie", "first=value1")
+headers.add("set-cookie", "second=value2")
 
 # Others are singletons and will raise errors if duplicated
-headers.add('content-length', '100')
+headers.add("content-length", "100")
 # headers.add('content-length', '200') # Would raise DuplicateHeaderError
 ```
 
@@ -48,11 +48,11 @@ Some headers have specialized classes for parsing and formatting:
 
 ```ruby
 # Accept header with media ranges
-accept = Protocol::HTTP::Header::Accept.new('text/html,application/json;q=0.9')
+accept = Protocol::HTTP::Header::Accept.new("text/html,application/json;q=0.9")
 media_ranges = accept.media_ranges
 
 # Authorization header
-auth = Protocol::HTTP::Header::Authorization.basic('username', 'password')
+auth = Protocol::HTTP::Header::Authorization.basic("username", "password")
 # => "Basic dXNlcm5hbWU6cGFzc3dvcmQ="
 ```
 
@@ -63,20 +63,20 @@ HTTP trailers are headers that appear after the message body. For security reaso
 ```ruby
 # Working with trailers
 headers = Protocol::HTTP::Headers.new([
-  ['content-type', 'text/html'],
-  ['content-length', '1000']
+		["content-type", "text/html"],
+		["content-length", "1000"]
 ])
 
 # Start trailer section
 headers.trailer!
 
 # These will be allowed (safe metadata)
-headers.add('etag', '"12345"')
-headers.add('date', Time.now.httpdate)
+headers.add("etag", '"12345"')
+headers.add("date", Time.now.httpdate)
 
 # These will be silently ignored for security
-headers.add('authorization', 'Bearer token') # Ignored - credential leakage risk
-headers.add('connection', 'close') # Ignored - hop-by-hop header
+headers.add("authorization", "Bearer token") # Ignored - credential leakage risk
+headers.add("connection", "close") # Ignored - hop-by-hop header
 ```
 
 The trailer security system prevents HTTP request smuggling by restricting which headers can appear in trailers: