iri 0.8.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6f999bd94bb431514584216e518edd721ce449e2af0f7cc4921073bc0b3d33a2
-  data.tar.gz: 8b73e9a02dadc087f7024ccc020ce3a1f1e6f816a612edaca4fb4fa92507db24
+  metadata.gz: c9981ebf1f6a24c408671ca60df156211a1866a23c0ba2a5e8a7424dfb8461b4
+  data.tar.gz: f0bcbb8b78b70e14b1e6b42c7b141174aca57d00d0b1e33e101061bb10f12ee0
 SHA512:
-  metadata.gz: 35accdc23c65209ca3436dfa04cb6d026e745fd0d9a4893f7ad4683ba80ef06da5e7a54d8918fb4db7e0692c9e44384d0a606ee09b4186c038f517e83695ea5e
-  data.tar.gz: c74f2a7818bc367b283fe39e16a721525cd080fdd5f56c348fb52244b92273ef2e66d19e2bee71310453731c75605f6b3de3529abd2f15a2e9b2d3b1e80057b3
+  metadata.gz: 5cbeb1064fabf1906d158a48219f418a11ac0d11ed40b436988006710002c8b0ce3cb66381905e23e28c4b4479ebc4a03b324f7a3a4dc7692b5b11bee4d44361
+  data.tar.gz: fa47c762b50c2046f0d7b3beb3dce405362cd2079d04d554f764b88b985421510242a7fe281093eb7927b01a6c92d15cd41d6cccdad0be60d1f4513669876bf0

data/.0pdd.yml

@@ -1,9 +1,27 @@
+# (The MIT License)
+#
+# Copyright (c) 2019-2025 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:
-#   github:
-#     - yegor256
-
 tags:
   - pdd
   - bug

data/.github/workflows/actionlint.yml

@@ -0,0 +1,43 @@
+# (The MIT License)
+#
+# Copyright (c) 2019-2025 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-24.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

@@ -1,20 +1,44 @@
+# (The MIT License)
+#
+# Copyright (c) 2019-2025 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:
+'on':
   push:
     branches:
       - master
 jobs:
   codecov:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     steps:
-      - uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4
+      - uses: actions/checkout@v4
       - uses: ruby/setup-ruby@v1
         with:
-          ruby-version: 2.7
-      - run: bundle update
+          ruby-version: 3.3
+          bundler-cache: true
+      - run: bundle config set --global path "$(pwd)/vendor/bundle"
+      - run: bundle install
       - run: bundle exec rake
-      - uses: codecov/codecov-action@v4.0.0-beta.3
+      - uses: codecov/codecov-action@v5
         with:
-          file: coverage/.resultset.json
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: coverage/.resultset.json
           fail_ci_if_error: true

data/.github/workflows/copyrights.yml

@@ -0,0 +1,32 @@
+# (The MIT License)
+#
+# Copyright (c) 2019-2025 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-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: yegor256/copyrights-action@0.0.8

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

@@ -0,0 +1,40 @@
+# (The MIT License)
+#
+# Copyright (c) 2019-2025 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-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: articulate/actions-markdownlint@v1

data/.github/workflows/pdd.yml

@@ -0,0 +1,36 @@
+# (The MIT License)
+#
+# Copyright (c) 2019-2025 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-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: volodya-lombrozo/pdd-action@master

data/.github/workflows/rake.yml

@@ -1,6 +1,27 @@
+# (The MIT License)
+#
+# Copyright (c) 2019-2025 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:
+'on':
   push:
     branches:
       - master
@@ -12,13 +33,15 @@ jobs:
     name: test
     strategy:
       matrix:
-        os: [ubuntu-20.04, macos-12, windows-2022]
-        ruby: [2.7, 3.1]
+        os: [ubuntu-24.04, macos-15, windows-2022]
+        ruby: [3.3]
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4
+      - uses: actions/checkout@v4
       - uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby }}
-      - run: bundle update
+          bundler-cache: true
+      - run: bundle config set --global path "$(pwd)/vendor/bundle"
+      - run: bundle install
       - run: bundle exec rake

data/.github/workflows/xcop.yml

@@ -0,0 +1,32 @@
+# (The MIT License)
+#
+# Copyright (c) 2019-2025 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-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: g4s8/xcop-action@master

data/.github/workflows/yamllint.yml

@@ -0,0 +1,36 @@
+# (The MIT License)
+#
+# Copyright (c) 2019-2025 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: yamllint
+'on':
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+jobs:
+  yamllint:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ibiqlik/action-yamllint@v3

data/.gitignore

@@ -1,4 +1,3 @@
-Gemfile.lock
 *.gem
 .bundle/
 .DS_Store

data/.rubocop.yml

@@ -1,9 +1,36 @@
+# (The MIT License)
+#
+# Copyright (c) 2019-2025 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.2
   SuggestExtensions: false
   NewCops: enable
+require:
+  - rubocop-minitest
+  - rubocop-performance
 
+Minitest/EmptyLineBeforeAssertionMethods:
+  Enabled: false
 Metrics/ClassLength:
   Max: 200
 Layout/EmptyLineAfterGuardClause:

data/.rultor.yml

@@ -1,5 +1,27 @@
+# (The MIT License)
+#
+# Copyright (c) 2019-2025 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.22.0
+  image: yegor256/rultor-ruby
 assets:
   rubygems.yml: yegor256/home#assets/rubygems.yml
 install: |-

data/Gemfile

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright (c) 2019-2024 Yegor Bugayenko
+# Copyright (c) 2019-2025 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,9 +23,11 @@
 source 'https://rubygems.org'
 gemspec
 
-gem 'minitest', '5.20.0', require: false
-gem 'rake', '13.1.0', require: false
-gem 'rdoc', '6.6.2', require: false
-gem 'rubocop', '1.59.0', require: false
-gem 'rubocop-rspec', '2.25.0', require: false
+gem 'minitest', '5.25.4', require: false
+gem 'rake', '13.2.1', require: false
+gem 'rdoc', '6.11.0', require: false
+gem 'rubocop', '1.71.0', require: false
+gem 'rubocop-minitest', '0.36.0', require: false
+gem 'rubocop-performance', '1.23.1', require: false
+gem 'rubocop-rspec', '3.4.0', require: false
 gem 'simplecov', '0.22.0', require: false

data/Gemfile.lock

@@ -0,0 +1,79 @@
+PATH
+  remote: .
+  specs:
+    iri (0.0.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    date (3.4.1)
+    docile (1.4.1)
+    json (2.9.1)
+    language_server-protocol (3.17.0.4)
+    minitest (5.25.4)
+    parallel (1.26.3)
+    parser (3.3.7.0)
+      ast (~> 2.4.1)
+      racc
+    psych (5.2.3)
+      date
+      stringio
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.2.1)
+    rdoc (6.11.0)
+      psych (>= 4.0.0)
+    regexp_parser (2.10.0)
+    rubocop (1.71.0)
+      json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.36.2, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.38.0)
+      parser (>= 3.3.1.0)
+    rubocop-minitest (0.36.0)
+      rubocop (>= 1.61, < 2.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
+    rubocop-performance (1.23.1)
+      rubocop (>= 1.48.1, < 2.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
+    rubocop-rspec (3.4.0)
+      rubocop (~> 1.61)
+    ruby-progressbar (1.13.0)
+    simplecov (0.22.0)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.13.1)
+    simplecov_json_formatter (0.1.4)
+    stringio (3.1.2)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
+
+PLATFORMS
+  arm64-darwin-22
+  arm64-darwin-23
+  arm64-darwin-24
+  x64-mingw-ucrt
+  x86_64-linux
+
+DEPENDENCIES
+  iri!
+  minitest (= 5.25.4)
+  rake (= 13.2.1)
+  rdoc (= 6.11.0)
+  rubocop (= 1.71.0)
+  rubocop-minitest (= 0.36.0)
+  rubocop-performance (= 1.23.1)
+  rubocop-rspec (= 3.4.0)
+  simplecov (= 0.22.0)
+
+BUNDLED WITH
+   2.5.16

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2019-2024 Yegor Bugayenko
+Copyright (c) 2019-2025 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,4 +1,4 @@
-<img src="/logo.svg" width="64px" height="64px"/>
+# Immutable URI Builder for Ruby
 
 [![EO principles respected here](https://www.elegantobjects.org/badge.svg)](https://www.elegantobjects.org)
 [![DevOps By Rultor.com](http://www.rultor.com/b/yegor256/iri)](http://www.rultor.com/p/yegor256/iri)
@@ -14,7 +14,7 @@
 
 The class [`Iri`](https://www.rubydoc.info/github/yegor256/iri/master/Iri)
 helps you build a URI and then modify its
-parts via a simple [fluent interface](https://en.wikipedia.org/wiki/Fluent_interface):
+parts via a simple [fluent interface]:
 
 ```ruby
 require 'iri'
@@ -34,17 +34,18 @@ url = Iri.new('http://google.com/')
   .to_s # convert it to a string
 ```
 
-The full list of methods is [here](https://www.rubydoc.info/github/yegor256/iri/master/Iri).
+The full list of methods is
+[here](https://www.rubydoc.info/github/yegor256/iri/master/Iri).
 
 Install it:
 
 ```bash
-$ gem install iri
+gem install iri
 ```
 
 Or add this to your `Gemfile`:
 
-```bash
+```ruby
 gem 'iri'
 ```
 
@@ -64,18 +65,23 @@ Of course, it's better to create the `iri` object only once per request
 and re-use it where you need. It's _immutable_, so you won't have any
 side-effects.
 
-PS. See how I use it in this Sinatra web app: [yegor256/0rsk](https://github.com/yegor256/0rsk).
+PS. See how I use it in this Sinatra web app:
+[yegor256/0rsk](https://github.com/yegor256/0rsk).
 
 ## 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.
+
+[fluent interface]: https://en.wikipedia.org/wiki/Fluent_interface

data/Rakefile

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright (c) 2019-2024 Yegor Bugayenko
+# Copyright (c) 2019-2025 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/iri.gemspec

@@ -2,7 +2,7 @@
 
 # (The MIT License)
 #
-# Copyright (c) 2019-2024 Yegor Bugayenko
+# Copyright (c) 2019-2025 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
@@ -27,7 +27,7 @@ Gem::Specification.new do |s|
   s.required_rubygems_version = Gem::Requirement.new('>= 0') if s.respond_to? :required_rubygems_version=
   s.required_ruby_version = '>=2.2'
   s.name = 'iri'
-  s.version = '0.8.0'
+  s.version = '0.10.0'
   s.license = 'MIT'
   s.summary = 'Simple Immutable Ruby URI Builder'
   s.description = "Class Iri helps you build a URI and then modify its \

data/lib/iri.rb

@@ -2,7 +2,7 @@
 
 # (The MIT License)
 #
-# Copyright (c) 2019-2024 Yegor Bugayenko
+# Copyright (c) 2019-2025 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
@@ -42,7 +42,7 @@ require 'cgi'
 # {README}[https://github.com/yegor256/iri/blob/master/README.md] file.
 #
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
-# Copyright:: Copyright (c) 2019-2024 Yegor Bugayenko
+# Copyright:: Copyright (c) 2019-2025 Yegor Bugayenko
 # License:: MIT
 class Iri
   # When URI is not valid.
@@ -58,26 +58,55 @@ class Iri
   # By default, this class will never throw any exceptions, even if your URI
   # is not valid. It will just assume that the URI is"/". However,
   # you can turn this mode off, by specifying safe as FALSE.
-  def initialize(uri = '', safe: true)
+  #
+  # @param [String] uri URI
+  # @param [Boolean] local Is it local (no host, port, and scheme)?
+  # @param [Boolean] safe Should it safe?
+  def initialize(uri = '', local: false, safe: true)
     @uri = uri
+    @local = local
     @safe = safe
   end
 
   # Convert it to a string.
+  #
+  # @return [String] New URI
   def to_s
-    @uri.to_s
+    u = the_uri
+    if @local
+      [
+        u.path,
+        u.query ? "?#{u.query}" : '',
+        u.fragment ? "##{u.fragment}" : ''
+      ].join
+    else
+      u.to_s
+    end
   end
 
   # Inspect it, like a string can be inspected.
+  #
+  # @return [String] Details of it
   def inspect
     @uri.to_s.inspect
   end
 
   # Convert it to an object of class +URI+.
+  #
+  # @return [String] New URI
   def to_uri
     the_uri.clone
   end
 
+  # Removes the host, the port, and the scheme and returns
+  # only the local address, for example, converting "https://google.com/foo"
+  # into "/foo".
+  #
+  # @return [Iri] Iri with no host/port/scheme
+  def to_local
+    Iri.new(@uri, local: true, safe: @safe)
+  end
+
   # Add a few query arguments.
   #
   # For example:
@@ -90,6 +119,8 @@ class Iri
   #
   #  Iri.new('https://google.com').del(:q).add(q: 'test')
   #
+  # @param [Hash] hash Hash of names/values to set into the query part
+  # @return [Iri] A new iri
   def add(hash)
     raise InvalidArguments unless hash.is_a?(Hash)
     modify_query do |params|
@@ -106,6 +137,8 @@ class Iri
   #
   #  Iri.new('https://google.com?q=test').del(:q)
   #
+  # @param [Array] keys List of keys to delete
+  # @return [Iri] A new iri
   def del(*keys)
     modify_query do |params|
       keys.each do |k|
@@ -118,6 +151,8 @@ class Iri
   #
   #  Iri.new('https://google.com?q=test').over(q: 'hey you!')
   #
+  # @param [Hash] hash Hash of names/values to set into the query part
+  # @return [Iri] A new iri
   def over(hash)
     raise InvalidArguments unless hash.is_a?(Hash)
     modify_query do |params|
@@ -129,6 +164,9 @@ class Iri
   end
 
   # Replace the scheme.
+  #
+  # @param [String] val New scheme to set, like "https" or "http"
+  # @return [Iri] A new iri
   def scheme(val)
     modify do |c|
       c.scheme = val
@@ -136,6 +174,9 @@ class Iri
   end
 
   # Replace the host.
+  #
+  # @param [String] val New host to set, like "google.com" or "192.168.0.1"
+  # @return [Iri] A new iri
   def host(val)
     modify do |c|
       c.host = val
@@ -143,6 +184,9 @@ class Iri
   end
 
   # Replace the port.
+  #
+  # @param [String] val New TCP port to set, like "8080" or "443"
+  # @return [Iri] A new iri
   def port(val)
     modify do |c|
       c.port = val
@@ -150,6 +194,9 @@ class Iri
   end
 
   # Replace the path part of the URI.
+  #
+  # @param [String] val New path to set, like "/foo/bar"
+  # @return [Iri] A new iri
   def path(val)
     modify do |c|
       c.path = val
@@ -157,6 +204,9 @@ class Iri
   end
 
   # Replace the fragment part of the URI.
+  #
+  # @param [String] val New fragment to set, like "hello"
+  # @return [Iri] A new iri
   def fragment(val)
     modify do |c|
       c.fragment = val.to_s
@@ -164,6 +214,9 @@ class Iri
   end
 
   # Replace the query part of the URI.
+  #
+  # @param [String] val New query to set, like "a=1&b=2"
+  # @return [Iri] A new iri
   def query(val)
     modify do |c|
       c.query = val
@@ -177,6 +230,9 @@ class Iri
   #  Iri.new('https://google.com/a/b?q=test').cut('/hello')
   #
   # The result will contain "https://google.com/hello".
+  #
+  # @param [String] path New path to set, like "/foo"
+  # @return [Iri] A new iri
   def cut(path = '/')
     modify do |c|
       c.query = nil
@@ -192,6 +248,9 @@ class Iri
   #  Iri.new('https://google.com/a/b?q=test').append('/hello')
   #
   # The result will contain "https://google.com/a/b/hello?q=test".
+  #
+  # @param [String] part New segment to add to existing path
+  # @return [Iri] A new iri
   def append(part)
     modify do |c|
       tail = (c.path.end_with?('/') ? '' : '/') + CGI.escape(part.to_s)
@@ -211,7 +270,7 @@ class Iri
   def modify
     c = the_uri.clone
     yield c
-    Iri.new(c)
+    Iri.new(c, local: @local, safe: @safe)
   end
 
   def modify_query

data/logo.svg

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

data/test/test__helper.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright (c) 2019-2024 Yegor Bugayenko
+# Copyright (c) 2019-2025 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/test/test_iri.rb

@@ -2,7 +2,7 @@
 
 # (The MIT License)
 #
-# Copyright (c) 2019-2024 Yegor Bugayenko
+# Copyright (c) 2019-2025 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
@@ -27,7 +27,7 @@ require_relative '../lib/iri'
 
 # Iri test.
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
-# Copyright:: Copyright (c) 2019-2024 Yegor Bugayenko
+# Copyright:: Copyright (c) 2019-2025 Yegor Bugayenko
 # License:: MIT
 class IriTest < Minitest::Test
   def test_builds_uri
@@ -43,6 +43,28 @@ class IriTest < Minitest::Test
     assert_equal('https://localhost:443/?q=books+about+tennis&limit=10', url)
   end
 
+  def test_converts_to_uri
+    assert_equal(
+      'https://alpha.local?t=1',
+      Iri.new('https://alpha.local').over(t: 1).to_uri.to_s
+    )
+  end
+
+  def test_converts_to_local
+    {
+      'http://localhost:9292/' => '/',
+      'https://google.com/' => '/',
+      'https://google.com/foo' => '/foo',
+      'https://google.com/bar?x=900' => '/bar?x=900',
+      'https://google.com/what#yes' => '/what#yes',
+      'https://google.com/what?a=8&b=9#yes' => '/what?a=8&b=9#yes'
+    }.each { |a, b| assert_equal(b, Iri.new(a).to_local.to_s) }
+  end
+
+  def test_deals_with_local
+    assert_equal('/foo?x=1', Iri.new('https://google.com/foo').to_local.add(x: 1).to_s)
+  end
+
   def test_broken_uri
     assert_raises Iri::InvalidURI do
       Iri.new('https://example.com/>', safe: false).add(a: 1)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: iri
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Yegor Bugayenko
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-08 00:00:00.000000000 Z
+date: 2025-01-30 00:00:00.000000000 Z
 dependencies: []
 description: Class Iri helps you build a URI and then modify its parts via a simple
   immutable fluent interface. It always returns a new object instead of changing the
@@ -21,13 +21,20 @@ extra_rdoc_files:
 files:
 - ".0pdd.yml"
 - ".gitattributes"
+- ".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"
+- ".github/workflows/yamllint.yml"
 - ".gitignore"
 - ".pdd"
 - ".rubocop.yml"
 - ".rultor.yml"
 - Gemfile
+- Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile
@@ -42,7 +49,7 @@ licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'true'
-post_install_message: 
+post_install_message:
 rdoc_options:
 - "--charset=UTF-8"
 require_paths:
@@ -59,7 +66,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.4.10
-signing_key: 
+signing_key:
 specification_version: 4
 summary: Simple Immutable Ruby URI Builder
 test_files: []