moxml 0.1.9 → 0.1.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4b2faed71c75f32fcfe528621b1d3ed01c603b04f81e75d5b45b6c525d9d1836
-  data.tar.gz: 68ead788c2e5098b2f1f88653443fe4d8ff1e76b17dab09c08badb64c7ab70a3
+  metadata.gz: 22ee4b9d877466a93b1253a05f5b64f65cb637335f8e5a02b02c357fd87b505d
+  data.tar.gz: 90c377d7eac0bd5bb9e15393b00c3cfa9e8b5b4eeb80f56d6f52ccb7e11b5774
 SHA512:
-  metadata.gz: 8aa59a486d44d101e1c078fc6fde2eea1cad9d4d7690d937dc7faef233a4143206432ffab53da3a2ef01af9245d17f706ddb01bc55b2c3555b358a6a3df10143
-  data.tar.gz: b5256089daef1f94012046bd7ff0fcbff1827c615b46d416231933de3193f3a262063a6ad761a87c629cdfe15fc51644fc1887d43eaeff5f8710bd16a791ea3c
+  metadata.gz: 73b2b180410acadc4be69bd87948f5966cdd8c8c2480bf61cb66f212e7cd893a6ab31e536f8922dde8814a6e04e57b794206d504b8a479e68288b714b2396ddb
+  data.tar.gz: ec4a72fc0c930dc2abfef2719dea6cce1ff37efb00e0255f46828f624aaab4007c9f523d39f86680a01f49a8a3a1c4f184319dd6fc6381562bd151167f22f780

data/.github/workflows/docs.yml

@@ -26,7 +26,7 @@ jobs:
       - name: Setup Ruby
         uses: ruby/setup-ruby@v1
         with:
-          ruby-version: '3.3'
+          ruby-version: '4.0'
           bundler-cache: true
           cache-version: 0
           working-directory: docs

data/.github/workflows/rake.yml

@@ -1,23 +1,26 @@
 name: rake
 
-permissions:
-  contents: write
-
 on:
   push:
     branches: [ main ]
     tags: [ v* ]
   pull_request:
 
+permissions:
+  contents: read
+
 jobs:
   rake:
-    uses: metanorma/ci/.github/workflows/generic-rake.yml@main
-    with:
-      before-setup-ruby: |
-        vcpkg install libxml2:x64-windows 2>&1 || true
-        vcpkg integrate install 2>&1 || true
-        mkdir -p .bundle 2>&1 || true
-        echo "---" > .bundle/config 2>&1 || true
-        echo 'BUNDLE_BUILD__LIBXML___RUBY: "--with-xml2-dir=C:/vcpkg/installed/x64-windows --with-xml2-include=C:/vcpkg/installed/x64-windows/include/libxml2 --with-xml2-lib=C:/vcpkg/installed/x64-windows/lib"' >> .bundle/config 2>&1 || true
-    secrets:
-      pat_token: ${{ secrets.GITHUB_TOKEN }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+      - name: Install dependencies
+        run: bundle install
+      - name: Run fast tests (unit + adapter + integration)
+        run: bundle exec rake spec:fast
+      - name: Run rubocop
+        run: bundle exec rubocop

data/.github/workflows/release.yml

@@ -3,6 +3,7 @@ name: release
 permissions:
   contents: write
   packages: write
+  id-token: write
 
 on:
   workflow_dispatch:

data/.github/workflows/round-trip.yml

@@ -0,0 +1,74 @@
+name: round-trip
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  # Fast: Ruby versions with full-support adapters (Nokogiri + Oga).
+  # These adapters provide complete XML conformance for production use.
+  ruby-versions:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: [ "3.1", "3.2", "3.3", "3.4", "4.0" ]
+        category: [ metanorma, rfcxml, niso-jats ]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - name: Run round-trip tests (${{ matrix.category }})
+        run: bundle exec rspec spec/consistency/ --tag round_trip --tag fixture_category:${{ matrix.category }}
+        env:
+          MOXML_ROUNDTRIP_TIMEOUT: 120
+          MOXML_ROUNDTRIP_ADAPTERS: nokogiri,oga
+
+  # Experimental: Ox adapter with Nokogiri (Ox lacks full XPath/namespace support).
+  nokogiri-ox:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: [ "3.3", "4.0" ]
+        category: [ metanorma, rfcxml, niso-jats ]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - name: Run Nokogiri × Ox round-trip tests (${{ matrix.category }})
+        run: bundle exec rspec spec/consistency/ --tag round_trip --tag fixture_category:${{ matrix.category }}
+        env:
+          MOXML_ROUNDTRIP_TIMEOUT: 300
+          MOXML_ROUNDTRIP_ADAPTERS: nokogiri,ox
+
+  # Experimental: REXML adapter with Nokogiri (REXML is pure Ruby, exponentially slow).
+  # Skips fixtures over 50KB due to O(n²) complexity.
+  nokogiri-rexml:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: [ "3.3", "4.0" ]
+        category: [ metanorma, rfcxml, niso-jats ]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - name: Run Nokogiri × REXML round-trip tests (${{ matrix.category }})
+        run: bundle exec rspec spec/consistency/ --tag round_trip --tag fixture_category:${{ matrix.category }}
+        env:
+          MOXML_ROUNDTRIP_TIMEOUT: 300
+          MOXML_ROUNDTRIP_ADAPTERS: nokogiri,rexml
+          MOXML_ROUNDTRIP_REXML_MAX_SIZE: 50000

data/.gitignore

@@ -43,6 +43,7 @@ libxml_*.txt
 # Ruby version managers
 .ruby-version.lock
 .rvmrc
+.ruby-version
 
 # Artifacts from static site generators
 /_site

data/.rubocop.yml

@@ -16,3 +16,4 @@ AllCops:
     - 'test_*.rb'
     - 'vendor/**/*'
     - 'tmp/**/*'
+    - 'spec/consistency/round_trip_spec.rb'

data/.rubocop_todo.yml

@@ -1,18 +1,97 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2025-11-24 13:45:20 UTC using RuboCop version 1.80.0.
+# on 2026-04-05 03:01:25 UTC using RuboCop version 1.86.0.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 192
+# Offense count: 5
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: with_first_argument, with_fixed_indentation
+Layout/ArgumentAlignment:
+  Exclude:
+    - 'lib/moxml/config.rb'
+    - 'lib/moxml/entity_registry.rb'
+    - 'spec/moxml/entity_registry_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyleAlignWith.
+# SupportedStylesAlignWith: either, start_of_block, start_of_line
+Layout/BlockAlignment:
+  Exclude:
+    - 'spec/moxml/config_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Layout/BlockEndNewline:
+  Exclude:
+    - 'spec/moxml/config_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Layout/ClosingParenthesisIndentation:
+  Exclude:
+    - 'spec/moxml/entity_registry_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Layout/EmptyLineAfterGuardClause:
+  Exclude:
+    - 'lib/moxml/config.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: consistent, consistent_relative_to_receiver, special_for_inner_method_call, special_for_inner_method_call_in_parentheses
+Layout/FirstArgumentIndentation:
+  Exclude:
+    - 'spec/moxml/entity_registry_spec.rb'
+
+# Offense count: 2
 # This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
+# Configuration parameters: AllowMultipleStyles, EnforcedHashRocketStyle, EnforcedColonStyle, EnforcedLastArgumentHashStyle.
+# SupportedHashRocketStyles: key, separator, table
+# SupportedColonStyles: key, separator, table
+# SupportedLastArgumentHashStyles: always_inspect, always_ignore, ignore_implicit, ignore_explicit
+Layout/HashAlignment:
+  Exclude:
+    - 'spec/moxml/entity_registry_spec.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Width, EnforcedStyleAlignWith, AllowedPatterns.
+# SupportedStylesAlignWith: start_of_line, relative_to_receiver
+Layout/IndentationWidth:
+  Exclude:
+    - 'spec/moxml/config_spec.rb'
+
+# Offense count: 238
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: Max, AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https
 Layout/LineLength:
   Enabled: false
 
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: symmetrical, new_line, same_line
+Layout/MultilineMethodCallBraceLayout:
+  Exclude:
+    - 'spec/moxml/entity_registry_spec.rb'
+
+# Offense count: 4
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowInHeredoc.
+Layout/TrailingWhitespace:
+  Exclude:
+    - 'lib/moxml/config.rb'
+    - 'lib/moxml/entity_registry.rb'
+    - 'spec/moxml/entity_registry_spec.rb'
+
 # Offense count: 7
 # Configuration parameters: AllowedMethods.
 # AllowedMethods: enums
@@ -30,12 +109,26 @@ Lint/DuplicateBranch:
     - 'lib/moxml/adapter/libxml.rb'
     - 'lib/moxml/document.rb'
 
-# Offense count: 2
+# Offense count: 3
 Lint/DuplicateMethods:
   Exclude:
+    - 'lib/moxml/config.rb'
     - 'lib/moxml/element.rb'
     - 'lib/moxml/node.rb'
 
+# Offense count: 2
+# Configuration parameters: AllowComments, AllowEmptyLambdas.
+Lint/EmptyBlock:
+  Exclude:
+    - 'spec/moxml/xpath/axes_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowComments.
+Lint/EmptyConditionalBody:
+  Exclude:
+    - 'spec/performance/xpath_benchmark_spec.rb'
+
 # Offense count: 1
 # Configuration parameters: AllowComments.
 Lint/EmptyWhen:
@@ -60,7 +153,7 @@ Lint/NoReturnInBeginEndBlocks:
   Exclude:
     - 'examples/api_client/api_client.rb'
 
-# Offense count: 93
+# Offense count: 97
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes, Max.
 Metrics/AbcSize:
   Enabled: false
@@ -76,12 +169,12 @@ Metrics/BlockLength:
 Metrics/BlockNesting:
   Max: 4
 
-# Offense count: 63
+# Offense count: 65
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/CyclomaticComplexity:
   Enabled: false
 
-# Offense count: 164
+# Offense count: 170
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
   Max: 110
@@ -91,12 +184,12 @@ Metrics/MethodLength:
 Metrics/ParameterLists:
   Max: 7
 
-# Offense count: 42
+# Offense count: 44
 # Configuration parameters: AllowedMethods, AllowedPatterns, Max.
 Metrics/PerceivedComplexity:
   Enabled: false
 
-# Offense count: 15
+# Offense count: 16
 # Configuration parameters: MinNameLength, AllowNamesEndingInNumbers, AllowedNames, ForbiddenNames.
 # AllowedNames: as, at, by, cc, db, id, if, in, io, ip, of, on, os, pp, to
 Naming/MethodParameterName:
@@ -108,14 +201,16 @@ Naming/MethodParameterName:
     - 'lib/moxml/adapter/ox.rb'
     - 'lib/moxml/adapter/rexml.rb'
     - 'lib/moxml/attribute.rb'
+    - 'lib/moxml/node_set.rb'
     - 'lib/moxml/xpath/lexer.rb'
 
-# Offense count: 1
+# Offense count: 2
 # Configuration parameters: Mode, AllowedMethods, AllowedPatterns, AllowBangMethods, WaywardPredicates.
 # AllowedMethods: call
-# WaywardPredicates: nonzero?
+# WaywardPredicates: infinite?, nonzero?
 Naming/PredicateMethod:
   Exclude:
+    - 'lib/moxml/config.rb'
     - 'lib/moxml/xpath/ruby/node.rb'
 
 # Offense count: 46
@@ -131,35 +226,15 @@ RSpec/ContextWording:
     - 'spec/moxml/xpath/parser_spec.rb'
     - 'spec/performance/benchmark_spec.rb'
 
-# Offense count: 15
+# Offense count: 16
 # Configuration parameters: IgnoredMetadata.
 RSpec/DescribeClass:
-  Exclude:
-    - '**/spec/features/**/*'
-    - '**/spec/requests/**/*'
-    - '**/spec/routing/**/*'
-    - '**/spec/system/**/*'
-    - '**/spec/views/**/*'
-    - 'spec/consistency/adapter_parity_spec.rb'
-    - 'spec/integration/all_adapters_spec.rb'
-    - 'spec/integration/headed_ox_integration_spec.rb'
-    - 'spec/moxml/declaration_preservation_spec.rb'
-    - 'spec/moxml/error_spec.rb'
-    - 'spec/moxml/xpath/axes_spec.rb'
-    - 'spec/moxml/xpath/functions/boolean_functions_spec.rb'
-    - 'spec/moxml/xpath/functions/node_functions_spec.rb'
-    - 'spec/moxml/xpath/functions/numeric_functions_spec.rb'
-    - 'spec/moxml/xpath/functions/position_functions_spec.rb'
-    - 'spec/moxml/xpath/functions/special_functions_spec.rb'
-    - 'spec/moxml/xpath/functions/string_functions_spec.rb'
-    - 'spec/moxml/xpath/parser_integration_spec.rb'
-    - 'spec/moxml/xpath_capabilities_spec.rb'
-    - 'spec/performance/xpath_benchmark_spec.rb'
+  Enabled: false
 
-# Offense count: 217
+# Offense count: 233
 # Configuration parameters: CountAsOne.
 RSpec/ExampleLength:
-  Max: 85
+  Max: 64
 
 # Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
@@ -192,7 +267,7 @@ RSpec/LeakyConstantDeclaration:
 RSpec/MessageSpies:
   EnforcedStyle: receive
 
-# Offense count: 317
+# Offense count: 327
 RSpec/MultipleExpectations:
   Max: 10
 
@@ -219,13 +294,15 @@ RSpec/PendingWithoutReason:
     - 'spec/moxml/xpath/functions/position_functions_spec.rb'
     - 'spec/moxml/xpath/functions/special_functions_spec.rb'
 
-# Offense count: 2
+# Offense count: 4
 RSpec/RepeatedExample:
   Exclude:
     - 'spec/integration/shared_examples/node_wrappers/node_set_behavior.rb'
+    - 'spec/unit/rexml_isolated_test.rb'
 
 # Offense count: 10
-# Configuration parameters: CustomTransform, IgnoreMethods, IgnoreMetadata.
+# Configuration parameters: CustomTransform, IgnoreMethods, IgnoreMetadata, InflectorPath, EnforcedInflector.
+# SupportedInflectors: default, active_support
 RSpec/SpecFilePathFormat:
   Exclude:
     - '**/spec/routing/**/*'
@@ -240,6 +317,11 @@ RSpec/SpecFilePathFormat:
     - 'spec/moxml/xpath/ruby/node_spec.rb'
     - 'spec/moxml/xpath_spec.rb'
 
+# Offense count: 1
+RSpec/SpecFilePathSuffix:
+  Exclude:
+    - 'spec/unit/rexml_isolated_test.rb'
+
 # Offense count: 1
 # Configuration parameters: IgnoreNameless, IgnoreSymbolicNames.
 RSpec/VerifiedDoubles:
@@ -251,6 +333,18 @@ Security/Eval:
   Exclude:
     - 'spec/moxml/xpath/ruby/generator_spec.rb'
 
+# Offense count: 3
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, ProceduralMethods, FunctionalMethods, AllowedMethods, AllowedPatterns, AllowBracesOnProceduralOneLiners, BracesRequiredMethods.
+# SupportedStyles: line_count_based, semantic, braces_for_chaining, always_braces
+# ProceduralMethods: benchmark, bm, bmbm, create, each_with_object, measure, new, realtime, tap, with_object
+# FunctionalMethods: let, let!, subject, watch
+# AllowedMethods: lambda, proc, it
+Style/BlockDelimiters:
+  Exclude:
+    - 'spec/moxml/config_spec.rb'
+    - 'spec/moxml/entity_registry_spec.rb'
+
 # Offense count: 1
 Style/DocumentDynamicEvalDefinition:
   Exclude:
@@ -273,6 +367,26 @@ Style/MissingRespondToMissing:
   Exclude:
     - 'lib/moxml/xpath/ruby/node.rb'
 
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+Style/MultilineIfModifier:
+  Exclude:
+    - 'lib/moxml/entity_registry.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Style/NilLambda:
+  Exclude:
+    - 'spec/moxml/entity_registry_spec.rb'
+
+# Offense count: 5
+# Configuration parameters: AllowedClasses.
+Style/OneClassPerFile:
+  Exclude:
+    - 'examples/api_client/api_client.rb'
+    - 'examples/rss_parser/rss_parser.rb'
+    - 'examples/web_scraper/web_scraper.rb'
+
 # Offense count: 4
 # Configuration parameters: AllowedMethods.
 # AllowedMethods: respond_to_missing?
@@ -280,3 +394,11 @@ Style/OptionalBooleanParameter:
   Exclude:
     - 'lib/moxml/adapter/libxml.rb'
     - 'lib/moxml/xpath/compiler.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyleForMultiline.
+# SupportedStylesForMultiline: comma, consistent_comma, diff_comma, no_comma
+Style/TrailingCommaInArguments:
+  Exclude:
+    - 'lib/moxml/context.rb'

data/Gemfile

@@ -6,12 +6,13 @@ source "https://rubygems.org"
 gemspec
 
 # Provides iteration per second benchmarking for Ruby
+gem "benchmark"
 gem "benchmark-ips"
 gem "get_process_mem"
 gem "libxml-ruby", "~> 5.0"
 gem "nokogiri", "~> 1.18"
 gem "oga", "~> 3.4"
-gem "openssl"
+gem "openssl", "~> 3.0"
 gem "ox", "~> 2.14"
 gem "rake"
 gem "rexml"