iri 0.6.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ce27b75cc4402cfb28991f6f061b2191e298dde147d77bf6b5c6215b96d1cc83
-  data.tar.gz: 2f01f12f02dbdc96f7923c2a1c2d0ea18ccf9d7c3ae44c001626fc16d96b60c1
+  metadata.gz: 6f999bd94bb431514584216e518edd721ce449e2af0f7cc4921073bc0b3d33a2
+  data.tar.gz: 8b73e9a02dadc087f7024ccc020ce3a1f1e6f816a612edaca4fb4fa92507db24
 SHA512:
-  metadata.gz: 38bc3965b37e014551e3048ec24736d3c56f2810e2b2cc32c50ef199ea19ff96e8396fdc9299a1c5d0aaa360901e5f7fdc37844f43800eddc04513cbe80f4e1f
-  data.tar.gz: e6bdbddd987e10546f8c05939b68dc85ca79961da4deed79fb73eabf00b35b0dfae0ce1324491ae1c01c61bcdaefdd1abd765c3a666572b7581e7d65e9e1998f
+  metadata.gz: 35accdc23c65209ca3436dfa04cb6d026e745fd0d9a4893f7ad4683ba80ef06da5e7a54d8918fb4db7e0692c9e44384d0a606ee09b4186c038f517e83695ea5e
+  data.tar.gz: c74f2a7818bc367b283fe39e16a721525cd080fdd5f56c348fb52244b92273ef2e66d19e2bee71310453731c75605f6b3de3529abd2f15a2e9b2d3b1e80057b3

data/.github/workflows/codecov.yml

@@ -8,13 +8,13 @@ jobs:
   codecov:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4
       - uses: ruby/setup-ruby@v1
         with:
           ruby-version: 2.7
       - run: bundle update
       - run: bundle exec rake
-      - uses: codecov/codecov-action@v3
+      - uses: codecov/codecov-action@v4.0.0-beta.3
         with:
           file: coverage/.resultset.json
           fail_ci_if_error: true

data/.github/workflows/rake.yml

@@ -16,7 +16,7 @@ jobs:
         ruby: [2.7, 3.1]
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4
       - uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby }}

data/.rubocop.yml

@@ -5,8 +5,7 @@ AllCops:
   NewCops: enable
 
 Metrics/ClassLength:
-  Exclude:
-    - 'test/*.rb'
+  Max: 200
 Layout/EmptyLineAfterGuardClause:
   Enabled: false
 Layout/MultilineMethodCallIndentation:

data/.rultor.yml

@@ -1,11 +1,12 @@
 docker:
-  image: yegor256/rultor-image:1.20.0
+  image: yegor256/rultor-image:1.22.0
 assets:
   rubygems.yml: yegor256/home#assets/rubygems.yml
 install: |-
   pdd -f /dev/null
-  sudo bundle install --no-color "--gemfile=$(pwd)/Gemfile"
+  bundle install --no-color
 release:
+  pre: false
   script: |-
     [[ "${tag}" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]] || exit -1
     bundle exec rake

data/Gemfile

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright (c) 2019-2023 Yegor Bugayenko
+# Copyright (c) 2019-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,9 +23,9 @@
 source 'https://rubygems.org'
 gemspec
 
-gem 'minitest', '5.18.0', require: false
-gem 'rake', '13.0.6', require: false
-gem 'rdoc', '6.5.0', require: false
-gem 'rubocop', '1.52.0', require: false
-gem 'rubocop-rspec', '2.22.0', require: false
+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 'simplecov', '0.22.0', require: false

data/LICENSE.txt

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

@@ -10,7 +10,6 @@
 [![Yard Docs](http://img.shields.io/badge/yard-docs-blue.svg)](http://rubydoc.info/github/yegor256/iri/master/frames)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/yegor256/iri/blob/master/LICENSE.txt)
 [![Test Coverage](https://img.shields.io/codecov/c/github/yegor256/iri.svg)](https://codecov.io/github/yegor256/iri?branch=master)
-![Lines of code](https://img.shields.io/tokei/lines/github/yegor256/iri)
 [![Hits-of-Code](https://hitsofcode.com/github/yegor256/iri)](https://hitsofcode.com/view/github/yegor256/iri)
 
 The class [`Iri`](https://www.rubydoc.info/github/yegor256/iri/master/Iri)
@@ -23,7 +22,7 @@ url = Iri.new('http://google.com/')
   .append('find').append('me') # -> http://google.com/find/me
   .add(q: 'books about OOP', limit: 50) # -> ?q=books+about+OOP&limit=50
   .del(:q) # remove this query parameter
-  .del('limit') # remove this one too
+  .del('limit', 'speed') # also remove these two
   .over(q: 'books about tennis', limit: 10) # replace these params
   .scheme('https') # replace 'http' with 'https'
   .host('localhost') # replace the host name

data/Rakefile

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

@@ -2,7 +2,7 @@
 
 # (The MIT License)
 #
-# Copyright (c) 2019-2023 Yegor Bugayenko
+# Copyright (c) 2019-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
@@ -27,11 +27,13 @@ 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.6.0'
+  s.version = '0.8.0'
   s.license = 'MIT'
   s.summary = 'Simple Immutable Ruby URI Builder'
-  s.description = 'Class Iri helps you build a URI and then modify its \
-parts via a simple fluent interface.'
+  s.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 existing one. This makes the object \
+safer and much easier for reuse."
   s.authors = ['Yegor Bugayenko']
   s.email = 'yegor256@gmail.com'
   s.homepage = 'https://github.com/yegor256/iri'

data/lib/iri.rb

@@ -2,7 +2,7 @@
 
 # (The MIT License)
 #
-# Copyright (c) 2019-2023 Yegor Bugayenko
+# Copyright (c) 2019-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
@@ -42,12 +42,15 @@ require 'cgi'
 # {README}[https://github.com/yegor256/iri/blob/master/README.md] file.
 #
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
-# Copyright:: Copyright (c) 2019-2023 Yegor Bugayenko
+# Copyright:: Copyright (c) 2019-2024 Yegor Bugayenko
 # License:: MIT
 class Iri
   # When URI is not valid.
   class InvalidURI < StandardError; end
 
+  # When .add(), .over(), or .del() arguments are not valid.
+  class InvalidArguments < StandardError; end
+
   # Makes a new object.
   #
   # You can even ignore the argument, which will produce an empty URI.
@@ -65,6 +68,11 @@ class Iri
     @uri.to_s
   end
 
+  # Inspect it, like a string can be inspected.
+  def inspect
+    @uri.to_s.inspect
+  end
+
   # Convert it to an object of class +URI+.
   def to_uri
     the_uri.clone
@@ -83,6 +91,7 @@ class Iri
   #  Iri.new('https://google.com').del(:q).add(q: 'test')
   #
   def add(hash)
+    raise InvalidArguments unless hash.is_a?(Hash)
     modify_query do |params|
       hash.each do |k, v|
         params[k.to_s] = [] unless params[k.to_s]
@@ -110,6 +119,7 @@ class Iri
   #  Iri.new('https://google.com?q=test').over(q: 'hey you!')
   #
   def over(hash)
+    raise InvalidArguments unless hash.is_a?(Hash)
     modify_query do |params|
       hash.each do |k, v|
         params[k.to_s] = [] unless params[k]

data/test/test__helper.rb

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

@@ -2,7 +2,7 @@
 
 # (The MIT License)
 #
-# Copyright (c) 2019-2023 Yegor Bugayenko
+# Copyright (c) 2019-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
@@ -27,7 +27,7 @@ require_relative '../lib/iri'
 
 # Iri test.
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
-# Copyright:: Copyright (c) 2019-2023 Yegor Bugayenko
+# Copyright:: Copyright (c) 2019-2024 Yegor Bugayenko
 # License:: MIT
 class IriTest < Minitest::Test
   def test_builds_uri
@@ -49,6 +49,18 @@ class IriTest < Minitest::Test
     end
   end
 
+  def test_incorrect_call_of_add
+    assert_raises Iri::InvalidArguments do
+      Iri.new('https://example.com/').add('hello5')
+    end
+  end
+
+  def test_incorrect_call_of_over
+    assert_raises Iri::InvalidArguments do
+      Iri.new('https://example5.com/').over('boom44')
+    end
+  end
+
   def test_broken_uri_in_safe_mode
     Iri.new('https://example.com/>>>').add(a: 1)
   end
@@ -60,6 +72,13 @@ class IriTest < Minitest::Test
     )
   end
 
+  def test_inspects_iri
+    assert_equal(
+      '"https://openai.com"',
+      Iri.new('https://openai.com').inspect
+    )
+  end
+
   def test_replaces_scheme
     assert_equal(
       'https://google.com/',

metadata

@@ -1,18 +1,18 @@
 --- !ruby/object:Gem::Specification
 name: iri
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Yegor Bugayenko
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-06-04 00:00:00.000000000 Z
+date: 2024-01-08 00:00:00.000000000 Z
 dependencies: []
-description: |-
-  Class Iri helps you build a URI and then modify its \
-  parts via a simple fluent interface.
+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
+  existing one. This makes the object safer and much easier for reuse.
 email: yegor256@gmail.com
 executables: []
 extensions: []
@@ -58,7 +58,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.15
+rubygems_version: 3.4.10
 signing_key: 
 specification_version: 4
 summary: Simple Immutable Ruby URI Builder