philiprehberger-multipart 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6f8a73fa59b67a22903e4c5e89acf357e638a5a9ccd352a2a20c08ae8b0b1b74
-  data.tar.gz: 6185783dacffad0857177ac51b0e4f8d0ed3e1d288710be7003a4da39e192f91
+  metadata.gz: 52149f84f550056bd81cb48582d4f83ed2d4994367d3bfed999f73ed8ce84da7
+  data.tar.gz: c8be86b7ee7424e73729e0819ecff13caee6a585e733e9f4fd788056432af5a2
 SHA512:
-  metadata.gz: d462b2a310a15bb9c36d90dacd45759c2ff6f44cb818e838938990e5c5ac9431a1d6d26e6945523a2dc0017e875693a6c84a81b1b1e6b90b8315bcdfd1f9d929
-  data.tar.gz: d05baa1fcd1ee9f9ee0b0c6a795f694c6cd15574abee38700d5ec83471f8f27259de2ea2b9c6970baab5983e05449893d33a2705c7343f39200861c1d69b0ce2
+  metadata.gz: 2b733e65fbdf0f3431a766ca7d495f07d9512d996f405573dedcf1f033002b3a50cf289bc9648588b928ed72a1a5712232f071cb2cd32eafb07eec4546cdbc6e
+  data.tar.gz: 14ecdc2bb2269b7de32ce4203d5105fd83583466c229ca56574397e3f3d5922cbcde722e032967d269e4a7f1c3d9168379eecd16939168e5dd219f2134bb7cbb

data/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.0] - 2026-04-30
+
+### Added
+- `Builder#size` — alias for `content_length`, matching the familiar Ruby `size` idiom
+- `Builder#to_h` — structured `{ boundary:, parts: [...] }` summary of the builder for logging and debugging
+- `Part#text?` — predicate, true when a part has no filename (inverse of `file?`)
+- `Part#size` — byte size of the part's value
+
 ## [0.6.0] - 2026-04-20
 
 ### Added

data/README.md

@@ -140,6 +140,25 @@ builder.part('avatar').content_type = 'image/webp'
 builder.part(:missing)  # => nil
 ```
 
+### Inspecting the Builder
+
+```ruby
+builder = Philiprehberger::Multipart.build do
+  field :name, 'Alice'
+  file :avatar, '/path/to/photo.png'
+end
+
+builder.size  # => same as builder.content_length
+builder.to_h
+# => {
+#      boundary: "----PhiliprehbergerMultipart...",
+#      parts: [
+#        { name: "name",   filename: nil,            content_type: nil,         size: 5 },
+#        { name: "avatar", filename: "photo.png",    content_type: "image/png", size: 4096 }
+#      ]
+#    }
+```
+
 ### Custom Boundary
 
 ```ruby
@@ -167,6 +186,8 @@ builder.content_type  # => "multipart/form-data; boundary=my-boundary"
 | `Builder#boundary` | The multipart boundary string |
 | `Builder#write_to(io)` | Stream the multipart body to an IO object |
 | `Builder#content_length` | Byte size of the body for Content-Length headers |
+| `Builder#size` | Alias for `content_length` |
+| `Builder#to_h` | Structured `{ boundary:, parts: [...] }` summary |
 | `Builder#headers` | Hash with Content-Type and Content-Length headers |
 | `Part#name` | The field name |
 | `Part#value` | The part value / body content |
@@ -174,6 +195,8 @@ builder.content_type  # => "multipart/form-data; boundary=my-boundary"
 | `Part#filename` | The original filename (nil for text fields) |
 | `Part#content_type` | The MIME content type (nil for text fields) |
 | `Part#file?` | Whether this part is a file upload |
+| `Part#text?` | Whether this part is a plain text field (inverse of `file?`) |
+| `Part#size` | Byte size of the part's value |
 
 ## Development
 

data/lib/philiprehberger/multipart/builder.rb

@@ -123,6 +123,32 @@ module Philiprehberger
         size + "--#{@boundary}--\r\n".bytesize
       end
 
+      # Alias for {#content_length} matching the familiar Ruby `size` idiom.
+      #
+      # @return [Integer]
+      alias size content_length
+
+      # Inspect the builder state as a structured hash.
+      #
+      # Each entry in `:parts` summarizes a single part with its name,
+      # filename (or nil for text fields), content_type, and byte size.
+      # Useful for logging or debugging without dumping the full body.
+      #
+      # @return [Hash] `{ boundary:, parts: [{ name:, filename:, content_type:, size: }, ...] }`
+      def to_h
+        {
+          boundary: @boundary,
+          parts: @parts.map do |part|
+            {
+              name: part.name.to_s,
+              filename: part.filename,
+              content_type: part.content_type,
+              size: part.size
+            }
+          end
+        }
+      end
+
       # Return the headers hash for the request
       #
       # @return [Hash]

data/lib/philiprehberger/multipart/part.rb

@@ -41,6 +41,20 @@ module Philiprehberger
         !@filename.nil?
       end
 
+      # Whether this part is a plain text field (not a file upload)
+      #
+      # @return [Boolean]
+      def text?
+        !file?
+      end
+
+      # Byte size of this part's value
+      #
+      # @return [Integer]
+      def size
+        @value.bytesize
+      end
+
       # Render this part as a multipart body segment
       #
       # @param boundary [String] the multipart boundary

data/lib/philiprehberger/multipart/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module Multipart
-    VERSION = '0.6.0'
+    VERSION = '0.7.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-multipart
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-20 00:00:00.000000000 Z
+date: 2026-05-01 00:00:00.000000000 Z
 dependencies: []
 description: Build and parse multipart/form-data request bodies with a clean DSL for
   adding text fields and file uploads, including automatic MIME type detection, IO