serialbench 0.1.3 → 0.2.0

data/lib/serialbench/site_generator.rb

@@ -30,6 +30,48 @@ module Serialbench
       generator.generate_site
     end
 
+    def self.resultset_payload(resultset)
+      new(output_path: '/dev/null', resultset: resultset).resultset_payload
+    end
+
+    def self.export_raw_data(resultset, data_dir)
+      new(output_path: '/dev/null', resultset: resultset).export_raw_data_to(data_dir)
+    end
+
+    def resultset_payload
+      transform_resultset_for_dashboard(@resultset)
+        .merge('libraries' => libraries_information(@resultset))
+    end
+
+    # Static capability matrix (adapter declarations) plus the versions
+    # actually measured in this resultset.
+    def libraries_information(resultset)
+      versions = {}
+      resultset.results.each do |result|
+        serializers = result.benchmark_result.serializers || []
+        serializers.each { |si| versions[si.name] ||= si.version }
+      end
+
+      Serialbench::Serializers.all.filter_map do |adapter|
+        next if adapter.name == 'syck'
+
+        features = adapter.features
+        next if features.is_a?(Array)
+
+        {
+          'name' => adapter.name,
+          'format' => adapter.format.to_s,
+          'version' => versions[adapter.name] || 'unknown',
+          'features' => features.transform_values { |v| v == true }
+        }
+      end
+    end
+
+    def export_raw_data_to(data_dir)
+      FileUtils.mkdir_p(data_dir)
+      export_resultset(@resultset, data_dir)
+    end
+
     def generate_site
       target_name = @result ? @result.environment_config.name : @resultset.name
 
@@ -140,6 +182,18 @@ module Serialbench
       }
     end
 
+    # Environment identity for the site: use the CI platform_string
+    # ("macos-26-ruby-3.4") when it is runner-shaped, so each runner label is
+    # its own environment; fall back to os-arch for other sources (docker,
+    # local runs, older resultsets).
+    def env_identity(result)
+      platform_string = result.platform.platform_string
+      ruby = result.platform.ruby_version
+      return platform_string if platform_string&.end_with?("-ruby-#{ruby}")
+
+      "#{result.platform.os}-#{result.platform.arch}-ruby-#{ruby}"
+    end
+
     # Transform a ResultSet (collection of Results) into dashboard-compatible format
     # Combines all results into a single dashboard structure
     def transform_resultset_for_dashboard(resultset)
@@ -148,7 +202,7 @@ module Serialbench
 
       resultset.results.each do |result|
         # Create unique env key for this result
-        env_key = "#{result.platform.os}-#{result.platform.arch}-ruby-#{result.platform.ruby_version}"
+        env_key = env_identity(result)
 
         # Merge this result's data into combined_results
         result_combined = build_combined_results(result, env_key)
@@ -258,7 +312,7 @@ module Serialbench
 
     def export_single_result(result, data_dir)
       # Create filename based on platform info
-      env_key = "#{result.platform.os}-#{result.platform.arch}-ruby-#{result.platform.ruby_version}"
+      env_key = env_identity(result)
       filename = "#{env_key}.yaml"
       filepath = File.join(data_dir, filename)
 

data/lib/serialbench/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Serialbench
-  VERSION = '0.1.3'
+  VERSION = '0.2.0'
 end

data/site/.gitignore

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+.astro/
+src/data/sample.json
+public/data/

data/site/README.md

@@ -0,0 +1,32 @@
+# serialbench site
+
+The benchmark console at https://metanorma.github.io/serialbench/.
+
+Astro 7 (Vite 8) with Vue islands and Tailwind 4. Charts are Chart.js 4,
+bundled — no CDN.
+
+## Develop
+
+```
+npm install
+npm run generate:sample-data   # writes src/data/sample.json (gitignored)
+npm run dev                    # http://localhost:4321/serialbench/
+```
+
+`src/data/sample.json` is generated from the race numbers in
+`scripts/gen-sample-data.mjs` and is ignored by git. In CI the real payload
+(written by `serialbench resultset export-data`) replaces it before
+`astro build`; the shape is identical — see `src/lib/dashboard.ts`.
+
+## Data contract
+
+```
+combined_results[op][size][format][serializer][envKey] = {
+  iterations_per_second, time_per_iteration   # perf ops
+  allocated_memory, retained_memory            # op == "memory"
+}
+environments[envKey] = { ruby_version, os, arch, timestamp, ... }
+metadata = { resultset_name, total_runs, generated_at }
+```
+
+Missing entries mean "not measured on that leg" — never zero.

data/site/astro.config.mjs

@@ -0,0 +1,12 @@
+import { defineConfig } from 'astro/config';
+import vue from '@astrojs/vue';
+import tailwindcss from '@tailwindcss/vite';
+
+export default defineConfig({
+  site: 'https://metanorma.github.io',
+  base: '/serialbench/',
+  integrations: [vue()],
+  vite: {
+    plugins: [tailwindcss()],
+  },
+});