philiprehberger-uri_kit 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a026f3d20cd016c911d1a4218e7eae2a8f636a54548ca0b226cb9306d20161fd
-  data.tar.gz: 557e3f6ff76a3c92c9346f67f0d3c9d44b083a07ca768bea060c4fa31d2966ff
+  metadata.gz: 6805b914ee5a6a261855d040fb9709751d291785b84e1b3cac359aa15b970b60
+  data.tar.gz: dbd6208984bcae93f03fb402e9a0c2afafc2d2ccb6ce1ca80bd23c33c8d281c1
 SHA512:
-  metadata.gz: 6f97d4a9d71f30dd31520affc81b20d49927c17068ab6ac58149e018c1cc2db7f49dbe02c05906c03364c3e8d924f9a95068f23ae6b6a8879b8b10c5dbd6952d
-  data.tar.gz: 5415549cb15e13d66785af54af0c4c5664e7fbbd7ce1bae50399e54af5dd644d3e9d6f8fc7db4b36255b386f73d4d9ea92b97cd3444e2af817ecd5322e360fd8
+  metadata.gz: 539b261b7251b4228f9015f307744b151f4b34c826a2678f78bddc9c94bfedee38c382fced41b0f8f9e0a35fcab6cb55a90465b3e659735acd0e721e1bf200f8
+  data.tar.gz: 8667c1db624c568cb0a2cdd03b0f46f723ff4d0168309e90fa3da6564b316a563a74ce4c15775ab6772147e49d8582cb3fbb4a586ab153dada798f43c41fba91

data/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-04-20
+
+### Added
+- `Url#keep_params(*keys)` — return a new `Url` containing only the listed query parameters, dropping every other key. Accepts individual `String`/`Symbol` keys or a single array argument; calling with no keys drops the whole query.
+
+## [0.3.1] - 2026-04-15
+
+### Changed
+- Update homepage metadata URL to use hyphenated package slug
+
 ## [0.3.0] - 2026-04-09
 
 ### Added

data/README.md

@@ -87,6 +87,9 @@ with_params.to_s  # => "https://example.com/search?q=ruby&page=1&limit=10"
 
 cleared = url.clear_params
 cleared.to_s  # => "https://example.com/search"
+
+tracking = Philiprehberger::UriKit.parse('https://example.com/p?utm_source=x&id=42')
+tracking.keep_params('id').to_s  # => "https://example.com/p?id=42"
 ```
 
 ### Base URL
@@ -144,6 +147,7 @@ url.to_s  # => "https://example.com/base/page.html"
 | `Url#replace_path(new_path)` | Replace the entire path, returns new Url |
 | `Url#add_params(hash)` | Add multiple query parameters, returns new Url |
 | `Url#clear_params` | Remove all query parameters, returns new Url |
+| `Url#keep_params(*keys)` | Keep only the listed query params, drop the rest; returns new Url |
 | `Url#base_url` | Get scheme + host + port as a string |
 | `Url#scheme` | URL scheme (e.g. `"https"`) |
 | `Url#host` | Hostname |

data/lib/philiprehberger/uri_kit/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module UriKit
-    VERSION = '0.3.0'
+    VERSION = '0.4.0'
   end
 end

data/lib/philiprehberger/uri_kit.rb

@@ -133,6 +133,20 @@ module Philiprehberger
         build_with(query: nil)
       end
 
+      # Keep only the query parameters matching the given keys. Returns a new
+      # Url with every other parameter dropped. Accepts String or Symbol keys;
+      # comparison is performed against the decoded parameter names.
+      #
+      # @param keys [Array<String, Symbol>] parameter keys to retain
+      # @return [Url] a new Url containing at most the listed parameters
+      def keep_params(*keys)
+        allow = keys.flatten.map(&:to_s)
+        filtered = params.slice(*allow)
+        new_url = build_with(query: nil)
+        new_url.instance_variable_get(:@uri).query = encode_params(filtered) unless filtered.empty?
+        new_url
+      end
+
       # Get the base URL (scheme + host + port only)
       #
       # @return [String] the base URL string

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-uri_kit
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-10 00:00:00.000000000 Z
+date: 2026-04-20 00:00:00.000000000 Z
 dependencies: []
 description: Parse, build, and manipulate URLs with query parameter management, normalization,
   domain extraction, and URL joining. Built on Ruby stdlib URI.