expressir 1.2.10-aarch64-linux → 2.4.29-aarch64-linux

data/lib/expressir.rb

@@ -1,19 +1,89 @@
-require "expressir/version"
+require "lutaml/model"
+# Liquid is intentionally NOT required here: lutaml-model's Liquefiable
+# lazily loads it on first #to_liquid (lutaml-model#800), keeping ~170ms
+# off the boot of every consumer that never renders Liquid templates.
 
-require "expressir/cli"
-require "expressir/config"
-
-Dir[File.join(__dir__, "expressir", "express", "*.rb")].sort.each do |fea|
-  require fea
+# ..........................................................
+# https://bugs.ruby-lang.org/issues/19319
+# The issue is that this bug is fixed for 3.1 and above,
+# but not for 3.0 or 2.7, so we need a "safe" function
+# ..........................................................
+if RUBY_VERSION < "3.1"
+  class String
+    def safe_downcase
+      each_char.map(&:downcase).join
+    end
+  end
+else
+  class String
+    def safe_downcase
+      downcase
+    end
+  end
 end
 
 module Expressir
-  class Error < StandardError; end
+  # Namespace modules - autoload loads the namespace file which contains
+  # autoload definitions for classes within that namespace
+  autoload :Config, "#{__dir__}/expressir/config"
+  extend Config
+
+  autoload :Version, "#{__dir__}/expressir/version"
+  autoload :Mapping, "#{__dir__}/expressir/mapping"
+
+  # Error classes — autoload the same errors.rb file from each name.
+  # The first reference triggers the load; the file defines all 21 classes.
+  autoload :Error, "#{__dir__}/expressir/errors"
+  autoload :FileNotFoundError, "#{__dir__}/expressir/errors"
+  autoload :ManifestNotFoundError, "#{__dir__}/expressir/errors"
+  autoload :PackageNotFoundError, "#{__dir__}/expressir/errors"
+  autoload :SchemaNotFoundError, "#{__dir__}/expressir/errors"
+  autoload :UsageError, "#{__dir__}/expressir/errors"
+  autoload :MissingRequiredArgumentError, "#{__dir__}/expressir/errors"
+  autoload :InvalidOptionError, "#{__dir__}/expressir/errors"
+  autoload :ValidationError, "#{__dir__}/expressir/errors"
+  autoload :ManifestValidationError, "#{__dir__}/expressir/errors"
+  autoload :SchemaValidationError, "#{__dir__}/expressir/errors"
+  autoload :ReferentialIntegrityError, "#{__dir__}/expressir/errors"
+  autoload :NoValidSchemaPathsError, "#{__dir__}/expressir/errors"
+  autoload :CommandError, "#{__dir__}/expressir/errors"
+  autoload :PackageBuildError, "#{__dir__}/expressir/errors"
+  autoload :PackageReadError, "#{__dir__}/expressir/errors"
+  autoload :PackageExtractError, "#{__dir__}/expressir/errors"
+  autoload :PackageValidationError, "#{__dir__}/expressir/errors"
+  autoload :PackageListError, "#{__dir__}/expressir/errors"
+  autoload :PackageSearchError, "#{__dir__}/expressir/errors"
+  autoload :PackageTreeError, "#{__dir__}/expressir/errors"
 
-  def self.ui
-    Expressir::Cli::UI
+  # Backward-compatible top-level VERSION constant.
+  # Expressir::VERSION is a string, which Ruby autoload cannot lazy-load
+  # (autoload only works for module/class constants). The actual value
+  # lives in Expressir::Version::VERSION, autoloaded on first reference.
+  # This const_missing triggers the autoload when Expressir::VERSION is
+  # referenced, then caches the result.
+  def self.const_missing(name)
+    return Version::VERSION if name == :VERSION
+
+    super
   end
 
+  autoload :Benchmark, "#{__dir__}/expressir/benchmark"
+  autoload :Coverage, "#{__dir__}/expressir/coverage"
+
+  autoload :Express, "#{__dir__}/expressir/express"
+  autoload :Model, "#{__dir__}/expressir/model"
+  autoload :Commands, "#{__dir__}/expressir/commands"
+  autoload :Changes, "#{__dir__}/expressir/changes"
+  autoload :Package, "#{__dir__}/expressir/package"
+  autoload :Manifest, "#{__dir__}/expressir/manifest"
+  autoload :Eengine, "#{__dir__}/expressir/eengine"
+  autoload :SchemaManifest, "#{__dir__}/expressir/schema_manifest"
+  autoload :SchemaManifestEntry, "#{__dir__}/expressir/schema_manifest_entry"
+
+  # CLI is loaded last so that namespace autoloads are defined first
+  # CLI uses Expressir::Commands::* which triggers autoload
+  autoload :Cli, "#{__dir__}/expressir/cli"
+
   def self.root
     File.dirname(__dir__)
   end

data/lib/tasks/verify_remarks.rake

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+# `rake verify:remarks` — the remark conservation gate. Runs only the
+# production-scale checks (`:production_scale` tag; see spec_helper's
+# filter), which the default suite excludes: they parse a full-size
+# schema and cost about a minute.
+#
+# Guarded: rake-compiler-dock's bundle carries production dependencies
+# only, and cross-gem rake invocations must still load the task files.
+if defined?(RSpec)
+  RSpec::Core::RakeTask.new(:"verify:remarks") do |task|
+    task.rspec_opts = "--tag production_scale"
+  end
+else
+  warn "verify_remarks: rspec not available — task not defined"
+end

data/rakelib/native.rake

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+# Prebuilt platform gems (TODO.suma-improvements/01): the compiled Rust
+# core ships inside per-platform gems, mirroring the parsanol-ruby
+# pattern (RbSys::ExtensionTask + cross_compiling staging). The source
+# gem keeps its gemspec-declared extconf build; platform gems carry the
+# artifact in lib/expressir/, which core.rb's first require finds.
+begin
+  require "rb_sys/extensiontask"
+
+  gemspec = Gem::Specification.load("expressir.gemspec")
+
+  RbSys::ExtensionTask.new("expressir_core", gemspec) do |ext|
+    ext.lib_dir = "lib/expressir"
+    # rb-sys stages the cross-built artifact itself; a manual cp into
+    # lib_dir here would claim the file rake-compiler's own
+    # copy:expressir_core:<host-platform> task owns, and the cross gem's
+    # dependency chain would then force a host-ruby build (rb-sys
+    # refuses windows bindings from linux headers).
+  end
+rescue LoadError
+  # rake-compiler/rb_sys not installed (consumer checkouts); the native
+  # gem tasks are a maintainer/CI concern only.
+end

data/rakelib/oracle.rake

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require "digest"
+require "fileutils"
+
+ORACLE_TAG = "eeng-5.2.8"
+ORACLE_BASE =
+  "https://github.com/expresslang/eengine-releases/releases/download/#{ORACLE_TAG}".freeze
+# Release-asset naming convention for the pinned tag: platform prefix
+# and CPU tag used by expresslang/eengine-releases.
+ORACLE_ASSET_NAMES = {
+  %w[darwin arm64] => "mac-arm64",
+  %w[darwin x86_64] => "mac-x86-64",
+  %w[linux x86_64] => "lnx-x86-64",
+  %w[linux arm64] => "lnx-arm64",
+  %w[mingw x86_64] => "win-x86-64",
+}.freeze
+
+namespace :oracle do
+  desc "Fetch the eengine oracle (#{ORACLE_TAG}) into tmp/oracle/eengine " \
+       "for the SHTOLO corpus differential"
+  task :fetch do
+    platform = [Gem::Platform.local.os, Gem::Platform.local.cpu]
+    tag = ORACLE_ASSET_NAMES[platform]
+    abort "no #{ORACLE_TAG} asset for #{platform.join('-')}" unless tag
+
+    version = ORACLE_TAG.delete_prefix("eeng-")
+    asset = "eengine-#{version}-#{tag}-sbcl#{'.exe' if platform.first == 'mingw'}"
+    target = File.expand_path("../tmp/oracle/eengine", __dir__)
+    digest = "#{target}.sha256"
+
+    if File.executable?(target)
+      expected = File.read(digest).strip.split(/\s+/).first if File.exist?(digest)
+      if expected && Digest::SHA256.file(target).hexdigest == expected
+        warn "oracle already present: #{target}"
+        exit 0
+      end
+      warn "cached oracle is missing or corrupt; refetching"
+      rm_f target
+    end
+
+    dir = File.dirname(target)
+    mkdir_p dir
+    download = File.join(dir, "#{asset}.part")
+    sh "curl", "-fSL", "-o", download, "#{ORACLE_BASE}/#{asset}"
+    sha = Digest::SHA256.file(download).hexdigest
+    mv download, target
+    chmod 0o755, target
+    File.write(digest, "#{sha}  eengine\n")
+    puts "oracle ready: #{target} (#{sha})"
+  end
+end

data/rakelib/verify_remarks.rake

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+namespace :verify do
+  desc "Check remarks against the recorded round-trip gaps, production included"
+  task :remarks do
+    specs = %w[
+      spec/expressir/remark_conservation_spec.rb
+      spec/expressir/remark_ownership_spec.rb
+      spec/expressir/express/formatter_remark_conservation_spec.rb
+      spec/expressir/express/formatter_remark_ownership_spec.rb
+    ]
+
+    sh({ "EXPRESSIR_PRODUCTION_SCALE" => "1" },
+       "bundle", "exec", "rspec", *specs)
+  end
+end