moxml 0.1.10 → 0.1.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 07caeff68b2413d8ccaab1e827b151c4b98381f76b0f1feb63cec118be54ae05
-  data.tar.gz: 76e3eb23022b6d49e5c265467966d29d6ad12617f2a00af3b34680b32f96b8ac
+  metadata.gz: 4157530fd51f50d52969541f0a41d18f3b70d2ccada5dea86ea38e3882511385
+  data.tar.gz: ea71910278f9883ac2580e3f20d9d6a5ea2d0981fbbd9d9c7fecbcf6b2694247
 SHA512:
-  metadata.gz: e0a41270e30bca0664d5e4bf32019d82a262cbfe6c2d001879d8e6259bf06e80a24df2372698ecd651835e88b27be2b7f2552b0d26aaf40aa514de7a870bf5e8
-  data.tar.gz: 7ade8a4b671b3eb3fe06d2b909783f61bd5172d1645e3c1e9c6344d3e3fb01b5b1c32b8da09b39fedc2b73d04e52edb19956bf00240fbb145798f4be9c598058
+  metadata.gz: 47dd22ad3d886d60cd6f4c2717f0d39e78ebbcaa743cb14a072476753410c681fb19b0a6d3fd6019f7a70bb2a7902bbb3239d4255f5fe5041a4fd2dce5beec74
+  data.tar.gz: fa217b1a960165a88dc97bcf765147d836dbe77e90be528cdb045ed99c28f6181d59634e50a4059348b89f0a23c4661660e1fb10fe8a46e06e1a434f9e08f456

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-26 03:06:16 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: 203
+# 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: 43
+# 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"