uri-builder 0.1.12 → 0.1.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2c35a6790d4fa14b69e8dbe73f2ce8f5b7814fd4f125aff996cdbb228d417375
-  data.tar.gz: 20e34111ccfc4a4440f4a4c0ffb126e4a9109aeb24decc9fe825af0942ad6195
+  metadata.gz: 2a0af25288f9f2c4f6385d2a7ad29016951a1c9048c40722d893b1b49151c5e5
+  data.tar.gz: 370b0a62178447bcd9c313c6fa522ac77926a793af19765a0c1bab9ff167fcb9
 SHA512:
-  metadata.gz: f9c635ee513fe5f7e9854185e2d8e8d346560a9165fbbbda30f9b465c8bb6c6d7939137632ed2a7546ee1876736bc36f42299c4e84451bed44b57fae0651c061
-  data.tar.gz: 5263fa6e147a0e8c23a57fc3401b7ba95ba47d8aa65b280c8145bd55b8d6d69208b2f5d5c07668cea90a10a5562352c57a9939378f5c64b22fe7d329a722d610
+  metadata.gz: f92b5696f4694868faafd3a0ebec001105431e60fcd656c0eb4d547251903aaefe09cb349a139d65004c84bbd8c46401ad3778e42b491d2337678e67df2a55d6
+  data.tar.gz: 4da7c5653b3fc86f37eab3ff04a50f352957e91716dcc011f452fa2669a7ea9e522f29cebd12ab833947202c298454c0c1322fcfed5421a5c9c1f846f84b549b

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    uri-builder (0.1.12)
+    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.12"
+    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
 
@@ -58,19 +84,28 @@ module URI
 
       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, @uri.path.chomp("/") if @uri.path.end_with?("/") and @uri.path != "/"
+        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 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.12
+  version: 0.1.13
 platform: ruby
 authors:
 - Brad Gessler
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-11-12 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: []