Add WSDL.dump as symmetric counterpart to WSDL.load

WSDL.load(hash) restores a Definition, but there was no top-level
method to serialize one. Now there is one besides Definition#to_h.

Author: rubiii

AGENTS.md

@@ -17,7 +17,7 @@ WSDL toolkit for Ruby. Turn WSDL 1.1 documents into inspectable definitions and
 
 ## Key Concepts
 
-- **Definition** — Frozen IR of a parsed WSDL service (`lib/wsdl/definition.rb`). Created by `WSDL.parse`, restored by `WSDL.load`. Provides discovery, introspection, provenance, and serialization. Everything downstream operates on the Definition.
+- **Definition** — Frozen IR of a parsed WSDL service (`lib/wsdl/definition.rb`). Created by `WSDL.parse`, serialized by `WSDL.dump`, restored by `WSDL.load`. Provides discovery, introspection, provenance, and serialization. Everything downstream operates on the Definition.
 - **Client** — Wraps a Definition with an HTTP client for calling operations (`lib/wsdl/client.rb`)
 - **Operation** — Callable SOAP operation with body, headers, and security
 - **Parser** — Parses WSDL and XSD documents into intermediate structures consumed by the Definition Builder

docs/core/configuration.md

@@ -100,7 +100,7 @@ When an error is raised due to a strictness check, the error message tells you e
 
 ## Caching
 
-The built-in parser cache has been removed. `Definition` is serializable via `to_h`/`to_json` and restorable via `WSDL.load` — cache at the Definition level instead:
+The built-in parser cache has been removed. `Definition` is serializable via `WSDL.dump`/`to_h`/`to_json` and restorable via `WSDL.load` — cache at the Definition level instead:
 
 ```ruby
 # Parse once

lib/wsdl.rb

@@ -109,11 +109,31 @@ def parse(source, http: nil, strictness: nil, sandbox_paths: nil, limits: nil)
       )
     end
 
+    # Serializes a {Definition} to a plain Hash.
+    #
+    # The returned hash is suitable for JSON serialization and can be
+    # restored via {.load}. This is the inverse of {.load}.
+    #
+    # @param definition [Definition] the definition to serialize
+    # @return [Hash{String => Object}] serializable hash with string keys
+    #
+    # @example Save to file
+    #   definition = WSDL.parse('http://example.com/service?wsdl')
+    #   File.write('service.json', JSON.generate(WSDL.dump(definition)))
+    #
+    # @example Round-trip
+    #   hash = WSDL.dump(definition)
+    #   restored = WSDL.load(hash)
+    #
+    def dump(definition)
+      definition.to_h
+    end
+
     # Restores a {Definition} from a serialized Hash.
     #
-    # The hash must have been produced by {Definition#to_h} or parsed
-    # from {Definition#to_json}. Raises if the schema version doesn't
-    # match the current library version.
+    # The hash must have been produced by {.dump}, {Definition#to_h},
+    # or parsed from {Definition#to_json}. Raises if the schema version
+    # doesn't match the current library version.
     #
     # @param hash [Hash{String => Object}] serialized definition hash
     # @return [Definition] the restored definition

lib/wsdl/definition.rb

@@ -292,7 +292,7 @@ def resolve_service_and_port
     # Serializes this Definition to a plain Hash.
     #
     # The hash is suitable for JSON serialization and can be restored
-    # via {WSDL.load} or {.from_h}.
+    # via {WSDL.load} or {.from_h}. Equivalent to calling {WSDL.dump}.
     #
     # @return [Hash{String => Object}] serializable hash with string keys
     def to_h

spec/wsdl/parse_load_spec.rb

@@ -109,4 +109,44 @@
       end
     end
   end
+
+  describe '.dump' do
+    let(:definition) { described_class.parse(fixture('wsdl/authentication'), http: http_mock) }
+
+    it 'returns a serializable hash' do
+      hash = described_class.dump(definition)
+
+      expect(hash).to be_a(Hash)
+      expect(hash.keys).to all(be_a(String))
+    end
+
+    it 'produces the same hash as Definition#to_h' do
+      expect(described_class.dump(definition)).to eq(definition.to_h)
+    end
+
+    it 'is the inverse of .load' do
+      restored = described_class.load(described_class.dump(definition))
+
+      expect(restored.service_name).to eq(definition.service_name)
+      expect(restored.fingerprint).to eq(definition.fingerprint)
+      expect(restored.to_h).to eq(definition.to_h)
+    end
+
+    it 'round-trips through JSON with .load' do
+      json = JSON.generate(described_class.dump(definition))
+      restored = described_class.load(JSON.parse(json))
+
+      expect(restored.service_name).to eq(definition.service_name)
+      expect(restored.fingerprint).to eq(definition.fingerprint)
+    end
+
+    it 'round-trips every standard fixture' do
+      %w[authentication temperature blz_service bronto].each do |name|
+        original = described_class.parse(fixture("wsdl/#{name}"), http: http_mock)
+        restored = described_class.load(described_class.dump(original))
+
+        expect(restored.to_h).to eq(original.to_h), "#{name}: dump/load round-trip mismatch"
+      end
+    end
+  end
 end

spec/wsdl/wsdl_spec.rb

@@ -77,4 +77,27 @@ def config
       }.to raise_error(ArgumentError, /schema version mismatch/)
     end
   end
+
+  describe '.dump' do
+    let(:definition) { described_class.parse(fixture('wsdl/authentication')) }
+
+    it 'serializes a Definition to a hash' do
+      hash = described_class.dump(definition)
+
+      expect(hash).to be_a(Hash)
+      expect(hash).to have_key('schema_version')
+      expect(hash).to have_key('service_name')
+    end
+
+    it 'produces the same hash as Definition#to_h' do
+      expect(described_class.dump(definition)).to eq(definition.to_h)
+    end
+
+    it 'round-trips through load' do
+      restored = described_class.load(described_class.dump(definition))
+
+      expect(restored.service_name).to eq(definition.service_name)
+      expect(restored.fingerprint).to eq(definition.fingerprint)
+    end
+  end
 end