uri-builder 0.1.11 → 0.1.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e06f8d4bcafa879c5e15eca5eea2465375d069f45dff718f3cb2d2639370ad64
-  data.tar.gz: 2fb08af317f38650f039793e95a8d02ef01ec56029dc899190e79342ea500006
+  metadata.gz: 2a0af25288f9f2c4f6385d2a7ad29016951a1c9048c40722d893b1b49151c5e5
+  data.tar.gz: 370b0a62178447bcd9c313c6fa522ac77926a793af19765a0c1bab9ff167fcb9
 SHA512:
-  metadata.gz: 5715d70198f6cc9bff67b5f51aac33b6d28966ae4c85909b0b34f890ec8102d5a960691093b554237bc6aef571812b730c93a131268844454013254313f4daad
-  data.tar.gz: 8331306c424006462e51f310903e67c9f9f6c41987788e6e917302633ab9eda1d661978615341499c588ddc566012468ba2105878691e48c411f700cb0e8fbf7
+  metadata.gz: f92b5696f4694868faafd3a0ebec001105431e60fcd656c0eb4d547251903aaefe09cb349a139d65004c84bbd8c46401ad3778e42b491d2337678e67df2a55d6
+  data.tar.gz: 4da7c5653b3fc86f37eab3ff04a50f352957e91716dcc011f452fa2669a7ea9e522f29cebd12ab833947202c298454c0c1322fcfed5421a5c9c1f846f84b549b

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    uri-builder (0.1.11)
+    uri-builder (0.1.13)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -9,7 +9,7 @@ URI.build("https://www.example.com/api/v1").path("/api/v2").query(search: "great
 Or if you prefer a block format that automatically converts back to an URI object after the transformation.
 
 ```ruby
-URI.build("https://www.example.com/api/v1") { _1.path("/api/v2").query search: "great books" }
+URI.build("https://www.example.com/api/v1") { it.path("/api/v2").query search: "great books" }
 ```
 
 Compare that to:
@@ -36,6 +36,25 @@ uri.query = URI.encode_www_form(first_name: "Brad")
 uri
 ```
 
+Paths may be traversed with various methods:
+
+```ruby
+URI.build("https://www.example.com/api/v1") { it.join("books/search").query search: "great books" } # => "https://www.example.com/api/v1/books/search?search=great+books"
+
+URI.build("https://www.example.com/api/v1") { it.parent.join("v2/articles/search").query search: "great books" }.uri # => #<URI::HTTPS https://www.example.com/api/v2/articles/search?search=great+books>
+
+URI.build("https://www.example.com/api/v1") { it.root.join("about").uri # => #<URI::HTTPS https://www.example.com/about>
+```
+
+Compare that to:
+
+```ruby
+uri = URI("https://www.example.com/api/v1")
+uri.path = uri.path + "/books/search"
+uri.query = URI.encode_www_form(search: "great books")
+uri
+```
+
 Each chain creates a duplicate of the original URL, so you can transform away without worrying about thrashing the original URL object.
 
 ## Installation

data/lib/uri/builder/version.rb

@@ -2,6 +2,6 @@
 
 module URI
   module Build
-    VERSION = "0.1.11"
+    VERSION = "0.1.13"
   end
 end

data/lib/uri/builder.rb

@@ -7,6 +7,32 @@ module URI
   module Builder
     class Error < StandardError; end
 
+    class Path
+      File = ::File
+
+      def initialize(*segments)
+        @trailing_slash = segments.last.to_s.end_with?("/")
+        @segments = segments.compact.flat_map { _1.to_s.split("/") }
+      end
+
+      def join(*segments)
+        self.class.new(*@segments, *segments)
+      end
+
+      def parent
+        self.class.new(*@segments[0...-1])
+      end
+
+      def to_s
+        File.join("/", *@segments.map(&:to_s).tap { _1.append "/" if @trailing_slash })
+      end
+
+      def trailing_slash(value = true)
+        @trailing_slash = value
+        self
+      end
+    end
+
     class DSL
       attr_reader :uri
 
@@ -14,12 +40,16 @@ module URI
         @uri = uri.clone
       end
 
-      [:host, :query, :fragment, :port].each do |property|
+      [:host, :fragment, :port].each do |property|
         define_method property do |value|
           wrap property, value
         end
       end
 
+      def clear_fragment
+        wrap :fragment, nil
+      end
+
       def scheme(value)
         if @uri.scheme
           # Handles URLs without schemes, like https://example.com/foo
@@ -48,17 +78,34 @@ module URI
         wrap :query, value
       end
 
+      def clear_query
+        wrap :query, nil
+      end
+
       def path(*segments)
         # Make sure there's a leading / if a non leading / is given.
-        wrap :path, ::File.join(*segments.compact.map(&:to_s).prepend("/"))
+        wrap :path, Path.new(*segments).to_s
       end
 
+      def clear_path
+        path "/"
+      end
+      alias :root :clear_path
+
       def trailing_slash
-        wrap :path, @uri.path + "/" unless @uri.path.end_with?("/")
+        wrap :path, Path.new(@uri.path).trailing_slash(true).to_s
+      end
+
+      def clear_trailing_slash
+        wrap :path, Path.new(@uri.path).trailing_slash(false).to_s
+      end
+
+      def join(...)
+        wrap :path, Path.new(@uri.path).join(...).to_s
       end
 
-      def remove_trailing_slash
-        wrap :path, @uri.path.chomp("/") if @uri.path.end_with?("/") and @uri.path != "/"
+      def parent(...)
+        wrap :path, Path.new(@uri.path).parent(...).to_s
       end
 
       def to_s

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: uri-builder
 version: !ruby/object:Gem::Version
-  version: 0.1.11
+  version: 0.1.13
 platform: ruby
 authors:
 - Brad Gessler
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-11-11 00:00:00.000000000 Z
+date: 2025-02-07 00:00:00.000000000 Z
 dependencies: []
 description: Build URIs via chains
 email:
@@ -36,7 +35,6 @@ metadata:
   homepage_uri: https://github.com/rubymonolith/uri-builder
   source_code_uri: https://github.com/rubymonolith/uri-builder
   changelog_uri: https://github.com/rubymonolith/uri-builder
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -51,8 +49,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.16
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Build URIs via chains
 test_files: []