dns_json 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d8cd792f367a5afca6685d1739ba086f7922090bfca844c6802e7a8e551bc09d
-  data.tar.gz: 6b2b2bbce0fd2d6fc2046d3ac2c6e6f6802588b7b138d08564b92c292fd7b6d7
+  metadata.gz: b29b6137d69056ed0139b7941615de79f65389671d83ecbb75bd6187596e556f
+  data.tar.gz: 294615c14a872f89a884c156615c61987c1607732f1aa08b586d3cfd10c65478
 SHA512:
-  metadata.gz: 8a161dca28081a7f9fe94c9706692efdc28910796325409352c576d2342ed3b51ae68ad45b6f5412b8024a4e20585d18b2c69275014ea7f5c05fa96594bebe78
-  data.tar.gz: 901c4e8ea33b37b6cdd94fa6999fb994f2c95998a41c4d1a1bbc45914e7733637b5aac571b825472ca98b139db7739f0869d8120485f6193fb76f2c547881a32
+  metadata.gz: 1d0680b62186f09a057844bca21f5f84837a8415b7714d6d307d8e7f68d9c497525d87e5b642a89fe2ebf2c4072e7c013a13b54a99dfc14cdf334190606d5110
+  data.tar.gz: 2285cd145074cad2fe596198b599ea8640b11077ca36fe396dd3eb3ef7b89e2e7f166b37e700169d8ca70584c980a35a3e261132fe1fdea2eab9b60951151eca

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.2.0 - 2026-10-12
+
+- Preserve validation mode and resource limits when accessing a pair's query or response message.
+- Preserve the caller's timestamp timezone when reading wire data, including frozen timestamps.
+
 ## 0.1.0 - 2026-10-12
 
 Initial release.

data/README.md

@@ -1,22 +1,59 @@
-# dns_json
+<h1 align="center">dns_json</h1>
 
-Read and write DNS messages as [RFC 8427](https://www.rfc-editor.org/rfc/rfc8427) JSON, including malformed packets used for diagnostics. Ruby 3.3+; CRuby, JRuby and TruffleRuby. No dependency on the other JSON format gems.
+<p align="center">DNS wire messages and RFC 8427 JSON, with malformed-packet diagnostics.</p>
+
+<p align="center">
+  <a href="https://rubygems.org/gems/dns_json"><img src="https://img.shields.io/gem/v/dns_json" alt="Gem version"></a>
+  <a href="https://github.com/ydah/dns_json/actions/workflows/main.yml"><img src="https://github.com/ydah/dns_json/actions/workflows/main.yml/badge.svg?branch=main" alt="CI"></a>
+  <a href="https://www.ruby-lang.org/"><img src="https://img.shields.io/badge/Ruby-%3E%3D%203.3-CC342D?logo=ruby&amp;logoColor=white" alt="Ruby 3.3 or later"></a>
+  <a href="LICENSE.txt"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
+</p>
+
+<p align="center">
+  <a href="#installation">Installation</a> &middot;
+  <a href="#quick-start">Quick start</a> &middot;
+  <a href="#wire-reconstruction-and-names">Wire reconstruction and names</a> &middot;
+  <a href="#development">Development</a> &middot;
+  <a href="#license">License</a>
+</p>
+
+Read and write DNS messages as [RFC 8427](https://www.rfc-editor.org/rfc/rfc8427) JSON, including malformed packets used for diagnostics.
+
+## Features
+
+- Decode DNS wire messages, inspect diagnostics, and preserve original packet bytes.
+- Build structured messages with RFC RDATA fields, output profiles, and JSON text sequences.
+- Bound parsing and validation without performing DNS resolution.
+
+## Installation
+
+Add the gem to your Gemfile:
 
 ```ruby
-require "dns_json"
+gem "dns_json"
+```
 
-message = DNSJSON.from_wire(packet_bytes, date: Time.now)
-message.malformed? # true when wire diagnostics were collected
-message.problems   # DNSJSON::Problem objects with byte offset and reason
-message.to_json(profile: DNSJSON::Profile::LOGGING)
-DNSJSON.parse(message.to_json).to_wire == packet_bytes # true
+Then run `bundle install`.
+
+Requires Ruby 3.3 or later and `json` 2.19.4 or later, below version 4. CI tests CRuby, JRuby, and TruffleRuby. No other gem from this format family is required.
+
+## Quick start
+
+```ruby
+require "dns_json"
 
 query = DNSJSON::Message.new({
   "ID" => 1042, "RD" => 1, "QNAME" => "service.test.",
   "QTYPE" => 28, "QCLASS" => 1
 })
-query.to_wire
-query.qname
+packet_bytes = query.to_wire
+message = DNSJSON.from_wire(packet_bytes, date: Time.now)
+
+message.qname       # => "service.test."
+message.malformed?  # => false
+message.problems    # => [] (malformed input reports byte offsets and reasons)
+message.to_json(profile: DNSJSON::Profile::LOGGING)
+DNSJSON.parse(message.to_json).to_wire == packet_bytes # => true
 ```
 
 `Message` and `RR` wrap a Hash; `[]` accesses any member and `to_h` returns a deep copy. Unknown extension members survive the default JSON roundtrip. All RFC members are optional. `parse(..., strict: false)` retains invalid values and provides `warnings` with JSON Pointers; serialization validates strictly. JSON input and output use ASCII, with escaped Unicode in string values. Duplicate object keys are rejected on both json 2.x and 3.x.
@@ -64,24 +101,28 @@ Sequence readers process input incrementally, skip malformed elements by default
 
 Limits are configurable on `parse`, `from_wire`, and model construction: `max_bytes: 65_535`, `max_records: 4096`, `max_pointers: 128`, `max_json_bytes: 4_194_304`, `max_depth: 32`. Limits raise `LimitError`; reaching the record or pointer bound while decoding wire data instead returns a malformed message and preserves the original bytes. A JSON sequence has a per-element size bound.
 
-## Development and release
+## Development
 
 ```sh
 bundle install
 bundle exec rake test
 COVERAGE=1 bundle exec rake test
-bundle exec rubocop
 bundle exec rbs -I sig validate
 bundle exec ruby script/benchmark.rb
-python3 -m venv tmp/interop/venv
-tmp/interop/venv/bin/python -m pip install --require-hashes -r script/interop-requirements.txt
-bundle exec ruby script/interop.rb
 ```
 
 RFC text, extracted examples and notices are downloaded only into ignored `tmp/`. No RFC excerpts, fixtures or third-party implementation source are distributed in Git or the gem. `script/sources.json` pins SHA-256 checksums; fixture generation tests §5.1, §5.2 and its rrSet alternative. The malformed optional fragment examples in §5.1 are not standalone JSON documents; equivalent combinations are covered by independently authored tests. `data/*.yml` contains independently maintained property/RDATA metadata and IANA type identifier facts. Run `script/update_registry.rb` to check the pinned registry; audit a new source and update the checksum before `--write`.
 
-Tests include all RDATA forms, a Ruby `resolv` oracle, pinned dnspython comparison, random packets and names, truncation, pointer loops, resource bounds, and JSON validation. CI covers supported CRuby versions plus head, JRuby and TruffleRuby on Ubuntu/macOS, json 2/3, coverage, lint, RBS and interoperability. dnspython and miekg/dns were reviewed as independent implementations; only dnspython is used in the external oracle.
+Tests include all RDATA forms, a Ruby standard-library `resolv` oracle, random packets and names, truncation, pointer loops, resource bounds, and JSON validation. CI covers supported CRuby versions plus head, JRuby and TruffleRuby on Ubuntu/macOS, json 2/3, coverage, syntax checks, RBS and standard-library interoperability.
 
 A `v*` tag runs `.github/workflows/release.yml` with the GitHub environment `release`, validates/builds the gem, publishes through RubyGems Trusted Publishing, then creates the GitHub release from CHANGELOG. Initial RubyGems publication and Trusted Publishing setup require the owner's action before tagging.
 
+## Contributing
+
+Bug reports and pull requests are welcome on [GitHub](https://github.com/ydah/dns_json/issues). See [Development](#development) for the checks to run before submitting a change. Report security vulnerabilities privately as described in [SECURITY.md](SECURITY.md).
+
+## License
+
 MIT; see [LICENSE.txt](LICENSE.txt).
+
+Additional dependencies must offer the MIT license, including development and comparison tools. The Ruby runtime and its standard libraries are exceptions to this policy. Reference documents and registry facts are test/specification inputs, not dependency implementations. See [implementation provenance](docs/provenance.md) for the scope and limits of the source audit.

data/SECURITY.md

@@ -7,3 +7,5 @@ Treat captured DNS packets as untrusted. The reader bounds packet length, record
 This library performs no network requests during use, DNS resolution, DNSSEC validation, or packet transmission. JSON fields can intentionally disagree. `messageOctetsHEX` takes precedence over all other wire representations. Do not authorize a packet using one representation and then transmit another.
 
 The privacy profile excludes raw HEX, additional records (including EDNS Client Subnet), message identifiers, comments and unknown metadata. It retains query names and answer addresses and therefore is not an anonymizer. Apply your own retention and access policy.
+
+Dependency changes must satisfy the MIT-only additional-dependency policy. The Ruby runtime and standard libraries are excepted. Consult the actual license files as well as package metadata; do not infer implementation provenance from packaging exclusions.

data/lib/dns_json/model.rb

@@ -12,6 +12,7 @@ module DNSJSON
       raise ValidationError, "expected an object" unless data.is_a?(Hash)
 
       @limits = DNSJSON.validate_limits(limits)
+      @strict = strict
       @data = DNSJSON.copy(data)
       @problems = problems.freeze
       @warnings = validate
@@ -112,8 +113,8 @@ module DNSJSON
       super(data, **)
     end
 
-    def query = self["queryMessage"] && Message.new(self["queryMessage"])
-    def response = self["responseMessage"] && Message.new(self["responseMessage"])
+    def query = self["queryMessage"] && Message.new(self["queryMessage"], strict: @strict, **@limits)
+    def response = self["responseMessage"] && Message.new(self["responseMessage"], strict: @strict, **@limits)
     def to_wire = raise(ConversionError, "select the query or response before writing wire data")
   end
 

data/lib/dns_json/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DnsJson
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/dns_json/wire/reader.rb

@@ -49,7 +49,7 @@ module DNSJSON
         if date
           raise ArgumentError, "date must be a nonnegative Time" unless date.is_a?(Time) && date.to_f >= 0
 
-          @data["dateString"] = date.utc.iso8601(6)
+          @data["dateString"] = date.getutc.iso8601(6)
           @data["dateSeconds"] = date.to_f
         end
         Message.new(@data, problems: @problems, **@limits)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dns_json
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Yudai Takada
@@ -77,7 +77,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Read and write DNS messages as RFC 8427 JSON
 test_files: []