xlsxrb 0.1.0

data/measure_memory.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require "opentelemetry/sdk"
+require "objspace"
+require_relative "lib/xlsxrb"
+
+# Outputs memory and GC stats for a given tracing span
+class MemorySpanProcessor < OpenTelemetry::SDK::Trace::SpanProcessor
+  def on_start(span, _parent_context)
+    span.set_attribute("ruby.gc.count.start", GC.stat[:count])
+    span.set_attribute("ruby.memory.bytes_allocated.start", ObjectSpace.memsize_of_all)
+  end
+
+  def on_finish(span)
+    gc_start = span.attributes["ruby.gc.count.start"]
+    mem_start = span.attributes["ruby.memory.bytes_allocated.start"]
+
+    gc_diff = GC.stat[:count] - (gc_start || 0)
+    mem_diff = ObjectSpace.memsize_of_all - (mem_start || 0)
+
+    mem_mb = mem_diff.to_f / 1024 / 1024
+
+    puts "[#{span.name}] Memory delta: #{mem_mb.round(2)} MB, GC count: #{gc_diff}"
+  end
+end
+
+OpenTelemetry::SDK.configure do |c|
+  c.add_span_processor(MemorySpanProcessor.new)
+end
+
+puts "Generating 100,000 cells (10,000 rows x 10 cols) to measure memory..."
+
+# Using a smaller size first so it runs quickly
+Xlsxrb.generate("test_memory.xlsx") do |w|
+  w.add_sheet("Data") do
+    10_000.times do |i|
+      w.add_row(["A", "B", "C", "D", "E", "F", "G", "H", "I", i])
+    end
+  end
+end
+
+puts "Done."

data/sig/xlsxrb.rbs

@@ -0,0 +1,23 @@
+module Xlsxrb
+  VERSION: String
+
+  module Ooxml
+    class Event
+      attr_reader type: Symbol
+      attr_reader args: Array[untyped]
+      attr_reader source: Hash[Symbol, untyped]
+
+      def self.new: (type: Symbol, args: Array[untyped], source: Hash[Symbol, untyped]) -> Event
+    end
+
+    class WorksheetParser
+      def self.each_event: (String, ?shared_strings: Array[String], ?part_name: String) ?{ (Event) -> void } -> void
+                        | (String, ?shared_strings: Array[String], ?part_name: String) -> Enumerator[Event, void]
+    end
+
+    class SharedStringsParser
+      def self.each_event: (String, ?part_name: String) ?{ (Event) -> void } -> void
+                        | (String, ?part_name: String) -> Enumerator[Event, void]
+    end
+  end
+end

data/vendor/sdk_runner/Program.cs

@@ -0,0 +1,91 @@
+using Microsoft.CodeAnalysis.CSharp.Scripting;
+using Microsoft.CodeAnalysis.Scripting;
+using DocumentFormat.OpenXml.Packaging;
+using DocumentFormat.OpenXml.Validation;
+
+if (args.Length < 2)
+{
+    Console.Error.WriteLine("Usage: dotnet run --project vendor/sdk_runner -- <scenario.cs> <xlsx-path>");
+    return 2;
+}
+
+var scenarioPath = Path.GetFullPath(args[0]);
+var xlsxPath = Path.GetFullPath(args[1]);
+
+if (!File.Exists(scenarioPath))
+{
+    Console.Error.WriteLine($"Scenario file not found: {scenarioPath}");
+    return 2;
+}
+
+if (!File.Exists(xlsxPath))
+{
+    Console.Error.WriteLine($"XLSX file not found: {xlsxPath}");
+    return 2;
+}
+
+var code = await File.ReadAllTextAsync(scenarioPath);
+var result = await RunScenario(code, xlsxPath);
+if (result.Success)
+{
+    Console.WriteLine("SCENARIO_PASS");
+    return 0;
+}
+
+Console.Error.WriteLine(result.ErrorOutput);
+return 1;
+
+
+async Task<ScenarioExecResult> RunScenario(string code, string xlsxPath)
+{
+    var globals = new ScenarioContext(xlsxPath);
+
+    var options = ScriptOptions.Default
+        .AddReferences(
+            typeof(object).Assembly,
+            typeof(Enumerable).Assembly,
+            typeof(Console).Assembly,
+            typeof(SpreadsheetDocument).Assembly,
+            typeof(OpenXmlValidator).Assembly
+        )
+        .AddImports(
+            "System",
+            "System.IO",
+            "System.Linq",
+            "System.Collections.Generic",
+            "DocumentFormat.OpenXml",
+            "DocumentFormat.OpenXml.Packaging",
+            "DocumentFormat.OpenXml.Spreadsheet",
+            "DocumentFormat.OpenXml.Validation",
+            "DocumentFormat.OpenXml.CustomProperties",
+            "DocumentFormat.OpenXml.VariantTypes"
+        );
+
+    try
+    {
+        await CSharpScript.RunAsync(code, options, globals, typeof(ScenarioContext));
+        return new ScenarioExecResult { Success = true };
+    }
+    catch (CompilationErrorException ex)
+    {
+        var errorMsg = "SCENARIO_COMPILE_ERROR\n" + string.Join("\n", ex.Diagnostics.Select(d => d.ToString()));
+        return new ScenarioExecResult { Success = false, ErrorOutput = errorMsg };
+    }
+    catch (Exception ex)
+    {
+        var errorMsg = "SCENARIO_FAIL\n" + ex.ToString();
+        return new ScenarioExecResult { Success = false, ErrorOutput = errorMsg };
+    }
+}
+
+record ScenarioExecResult(bool Success = false, string ErrorOutput = "");
+
+public sealed class ScenarioContext
+{
+    public ScenarioContext(string xlsxPath)
+    {
+        XlsxPath = xlsxPath;
+    }
+
+    public string XlsxPath { get; }
+}

data/vendor/sdk_runner/sdk_runner.csproj

@@ -0,0 +1,13 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net8.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="DocumentFormat.OpenXml" Version="3.0.2" />
+    <PackageReference Include="Microsoft.CodeAnalysis.CSharp.Scripting" Version="4.11.0" />
+  </ItemGroup>
+</Project>

metadata

@@ -0,0 +1,144 @@
+--- !ruby/object:Gem::Specification
+name: xlsxrb
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- niku
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: opentelemetry-api
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: rexml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ruby_wasm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webrick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A minimal dependency XLSX reading and writing library for Ruby, relying
+  on standard libraries for core logic and opentelemetry-api for observability.
+email:
+- 10890+niku@users.noreply.github.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".devcontainer/Dockerfile"
+- ".devcontainer/devcontainer.json"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- benchmark.rb
+- docs/ARCHITECTURE.md
+- docs/SPEC_SOURCES.md
+- docs/visual/VisualGallery.md
+- docs/wasm/wasm_doc_helper.css
+- docs/wasm/wasm_doc_helper.js
+- lib/xlsxrb.rb
+- lib/xlsxrb/elements.rb
+- lib/xlsxrb/elements/cell.rb
+- lib/xlsxrb/elements/column.rb
+- lib/xlsxrb/elements/row.rb
+- lib/xlsxrb/elements/types.rb
+- lib/xlsxrb/elements/workbook.rb
+- lib/xlsxrb/elements/worksheet.rb
+- lib/xlsxrb/ooxml.rb
+- lib/xlsxrb/ooxml/reader.rb
+- lib/xlsxrb/ooxml/shared_strings_parser.rb
+- lib/xlsxrb/ooxml/styles_parser.rb
+- lib/xlsxrb/ooxml/utils.rb
+- lib/xlsxrb/ooxml/workbook_parser.rb
+- lib/xlsxrb/ooxml/workbook_writer.rb
+- lib/xlsxrb/ooxml/worksheet_parser.rb
+- lib/xlsxrb/ooxml/worksheet_writer.rb
+- lib/xlsxrb/ooxml/writer.rb
+- lib/xlsxrb/ooxml/xml_builder.rb
+- lib/xlsxrb/ooxml/xml_parser.rb
+- lib/xlsxrb/ooxml/zip_generator.rb
+- lib/xlsxrb/ooxml/zip_reader.rb
+- lib/xlsxrb/ooxml/zip_writer.rb
+- lib/xlsxrb/style_builder.rb
+- lib/xlsxrb/version.rb
+- measure_memory.rb
+- sig/xlsxrb.rbs
+- vendor/sdk_runner/Program.cs
+- vendor/sdk_runner/sdk_runner.csproj
+homepage: https://github.com/niku/xlsxrb
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/niku/xlsxrb
+  source_code_uri: https://github.com/niku/xlsxrb
+  changelog_uri: https://github.com/niku/xlsxrb/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 4.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.10
+specification_version: 4
+summary: A streaming-capable, fast, low-memory XLSX reader/writer.
+test_files: []