leptris 1.9.30 → 1.9.31

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b0b15f4a5205c3ad2ed40cddbddf2c6d517b02fba4d80001d1a803ee4d1c5c47
-  data.tar.gz: 52cbfce90c464a45894568060b38d906e0ab9e2d613f0d005051ff51768ef180
+  metadata.gz: 61af1b12021e7a1cf22f04004ea36d27df6f740ff135d039854c51497abf87f3
+  data.tar.gz: 0a842331a02a988b8bfce2920f8878b87c5ff5fdbd4c471f2f04694f4a1b3465
 SHA512:
-  metadata.gz: 6eec31bcfa4b5fdadcaa14902374fe177541e8db51a1b13488899984c8ec425d94e7d047f1a4726173869a9b306e15519bb097018109ec9177dc4b11b72cb103
-  data.tar.gz: 21a07b86e6fb0237eca6aed383badc2f30c41caafb690dbb45ba152bdabd6a9f25446cb8ebd9c7c52a99446da5fe1bae88b76abb95078a0d18c70a80e7b00098
+  metadata.gz: e832da72a4e2fe0ddede057023c1e981705a41f196d85e7d7e5d61051d524bddfc2305065fef940ef60af48b87e978bc46be7e61030d598de83fb916db8bba3e
+  data.tar.gz: 7a266c15d5983229591bf414ad0dde95cc93018ba01388bf721f98977c026c164797e1dc805fc9a46625a6b2037c7709a65cb0e0640ca5ed6c46f40614dd37c0

data/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to Leptris will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.9.31] - 2026-08-28
+
+### Fixed
+
+- **PI data consumes the leading whitespace run (leptris-ruby#85,
+  libxml2 parity)**: the engine retains the full whitespace run
+  after the PI target as data where libxml2 consumes it at parse
+  time — every Ruby-facing PI-data read now normalizes through one
+  seam helper (`FFI.read_pi_data`): `PI#content`,
+  `Document#processing_instructions` pairs, the SAX
+  `processing_instruction` callback, pull `:pi` events, and
+  recorder `:pi` events. Whitespace-only data reads as `""`, so
+  "pi-without-data" PIs report empty consistently; trailing
+  whitespace is kept (libxml2 trims only the leading run).
+  Read-time only — `PI#data=` still stores verbatim.
+
 ## [1.9.30] - 2026-08-28
 
 ### Fixed

data/lib/leptris/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Leptris
-  VERSION = "1.9.30"
+  VERSION = "1.9.31"
 end

data/lib/leptris/xml/document.rb

@@ -295,7 +295,8 @@ class Leptris::XML::Document
     count = Leptris::XML::FFI.leptris_document_pi_count(@c_ptr)
     result = count.times.map do |i|
       [Leptris::XML::FFI.leptris_document_pi_target(@c_ptr, i),
-       Leptris::XML::FFI.leptris_document_pi_data(@c_ptr, i)]
+       Leptris::XML::FFI.read_pi_data(
+         Leptris::XML::FFI.leptris_document_pi_data(@c_ptr, i)).to_s]
     end
     @processing_instructions = result
     @pi_version = @version

data/lib/leptris/xml/ffi.rb

@@ -924,6 +924,16 @@ module Leptris
         [raw, status.read_int]
       end
 
+      # libxml2 consumes the whole whitespace run following the PI
+      # target when parsing; the engine retains it as data
+      # (leptris-ruby#85). Every Ruby-facing PI-data read normalizes
+      # here — whitespace-only data becomes "" so
+      # "pi-without-data" PIs report empty consistently. Read-time
+      # only: PI#data= stores verbatim.
+      def self.read_pi_data(data)
+        data&.sub(/\A[ \t\r\n]+/, "")
+      end
+
       # Thread-local scratch buffers for batch handle fetches (round
       # XX): the per-call MemoryPointer new/free was pure cold-path
       # overhead — two allocations and a GC visit per children() /

data/lib/leptris/xml/processing_instruction.rb

@@ -16,7 +16,8 @@ class Leptris::XML::ProcessingInstruction < Leptris::XML::Node
   def content
     return @content if memo_hit?(@content_version)
     ensure_alive!
-    result = Leptris::XML::FFI.leptris_pi_node_get_data(@c_ptr).to_s
+    result = Leptris::XML::FFI.read_pi_data(
+      Leptris::XML::FFI.leptris_pi_node_get_data(@c_ptr)).to_s
     if @document
       @content = result
       @content_version = @document.version

data/lib/leptris/xml/pull.rb

@@ -84,13 +84,14 @@ module Leptris::XML::Pull
           base = i * stride
           name_ptr = buffer.get_pointer(base + name_off)
           text_ptr = buffer.get_pointer(base + text_off)
-          Event.new(
-            TYPES[buffer.get_int(base + type_off)],
+          type = TYPES[buffer.get_int(base + type_off)]
+          text = text_ptr.null? ? nil :
+            text_ptr.read_string.force_encoding(Encoding::UTF_8)
+          text = Leptris::XML::FFI.read_pi_data(text) if type == :pi
+          Event.new(type,
             name_ptr.null? ? nil :
               name_ptr.read_string.force_encoding(Encoding::UTF_8),
-            text_ptr.null? ? nil :
-              text_ptr.read_string.force_encoding(Encoding::UTF_8),
-            nil
+            text, nil
           )
         end
         # The attr mirror holds the batch's most recent start.
@@ -125,11 +126,13 @@ module Leptris::XML::Pull
       name_ptr = raw.get_pointer(NAME_OFFSET)
       text_ptr = raw.get_pointer(TEXT_OFFSET)
       attrs = type == :start_element ? capture_attrs : nil
+      text = text_ptr.null? ? nil :
+        text_ptr.read_string.force_encoding(Encoding::UTF_8)
+      text = Leptris::XML::FFI.read_pi_data(text) if type == :pi
       Event.new(
         type,
         name_ptr.null? ? nil : name_ptr.read_string.force_encoding(Encoding::UTF_8),
-        text_ptr.null? ? nil : text_ptr.read_string.force_encoding(Encoding::UTF_8),
-        attrs
+        text, attrs
       )
     end
 

data/lib/leptris/xml/sax/parser.rb

@@ -149,7 +149,8 @@ class Leptris::XML::SAX::Parser
 
     if overridden?(:processing_instruction)
       s[:processing_instruction] = callback(:void, [:pointer, :string, :string]) do |_, target, data|
-        handler.processing_instruction(utf8(target), utf8(data))
+        handler.processing_instruction(
+          utf8(target), Leptris::XML::FFI.read_pi_data(utf8(data)))
       end
     end
 

data/lib/leptris/xml/sax/recorder.rb

@@ -122,9 +122,11 @@ class Leptris::XML::SAX::Recorder
         kind = KIND_BY_CODE[fields[i * 9]]
         if kind && (wanted.nil? || wanted[kind])
           base = i * 9 + 1
+          text = slice(arena, fields[base + 2], fields[base + 3])
+          text = Leptris::XML::FFI.read_pi_data(text) if kind == :pi
           yield kind,
                 slice(arena, fields[base], fields[base + 1]),
-                slice(arena, fields[base + 2], fields[base + 3]),
+                text,
                 attrs_from(arena, fields[base + 4], fields[base + 5]),
                 fields[base + 6], fields[base + 7]
         end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: leptris
 version: !ruby/object:Gem::Version
-  version: 1.9.30
+  version: 1.9.31
 platform: ruby
 authors:
 - Ribose Inc.