1
0
mirror of https://github.com/alexandrev/xslt-lab.git synced 2026-09-13 08:43:16 +00:00
claude-code 3925ed9e77 Feat: report how often each construct actually ran, alongside the trace
Static rules can only guess at what is slow; the trace knows. The listener now
also counts template, apply-templates, for-each, for-each-group, call-template
and function executions, and reports the top 25 with the trace, so "this
template ran 4,312 times" is a fact rather than a heuristic.

The counting is kept strictly apart from the variable reporting it sits next
to. That deque pairs enter/leave and stays balanced only because both handlers
filter on isVariable() identically: pushing non-variable frames onto it would
make a variable's leave pop someone else's frame and silently attribute the
wrong value in the UI. countHotspot touches its own map and nothing else, and
handleEnter/handleLeave are unchanged.

Two things this needed along the way:

- Saxon never calls TraceListener.close() before the daemon reads the trace
  buffer, so relying on it dropped every hot spot. attachTraceListener now
  returns a flush the daemon runs once the transform is done.
- getConstructType() is null on these objects in Saxon 12 — which is why
  isVariable() already falls back to class names — so constructs are
  recognised the same way.

Verified end to end against a real transform: the variables still come back
intact (6 entries with their values) and a template applied to five elements
is reported as five executions.

Note for later: only SaxonDaemon attaches the listener, so tracing — and now
profiling — is XSLT 3.0 only. That predates this change.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KZntQUfw463NW4ftgSjWw5
2026-07-28 16:01:38 +00:00
2025-11-15 22:26:25 +01:00
2026-01-27 13:10:36 +01:00
2025-11-15 22:26:25 +01:00
2025-07-01 21:35:11 +02:00
2025-11-15 22:26:25 +01:00

XSLT Playground — free online XSLT 1.0/2.0/3.0 tester & editor (Saxon HE)

Live tool: xsltplayground.com · Blog: xsltplayground.com/blog

XSLT Playground is a free online XSLT editor, tester and validator that runs XSLT 1.0, 2.0 and 3.0 on a real Saxon HE 12.5 backend — the same processor used in production integration pipelines. No install, no signup. Unlike browser-only (Saxon-JS) tools, it executes server-side Saxon HE, so results match production behaviour, including full XSLT 3.0: maps, arrays, xsl:merge, higher-order functions, streaming and JSON output.

What makes it useful for real-world XSLT work:

  • XSLT 1.0, 2.0 and 3.0 via Saxon HE 12.5 (real server-side processor)
  • Multiple XML inputs passed as named parameters — like a production pipeline
  • Execution trace to debug stylesheets step by step
  • Validation with exact line-number error messages from Saxon
  • Up to 3 independent workspaces, export/import as JSON to share setups
  • Custom Saxon extension functions (tib:uuid(), tib:timestamp(), …)

Built for integration engineers working with enterprise middleware (SAP, MuleSoft, Tibco, IBM), XML data engineers, and anyone who needs to write or debug XSLT without a heavy desktop IDE.

This repository hosts the source: a React/Vite frontend and a Go backend that orchestrates Java/Saxon. Suggested GitHub topics: xslt, xslt-3-0, saxon, xml, online-tool, xslt-editor, xslt-tester.

TinyLaunch Badge

News & Releases

Frontend

The React/Vite frontend lives in frontend/. Use npm install inside that folder and run:

npm run dev

This starts the playground at http://localhost:3000.

The app will call the Go backend at /transform to perform XSLT transformations. Set the backend URL by creating a .env file inside frontend/ or by exporting VITE_BACKEND_URL when starting the dev server:

VITE_BACKEND_URL=http://localhost:8000 npm run dev

If omitted the app assumes the backend runs on the same host and port. In the containerized version the URL is now read at runtime from environment variables so you can configure it directly in the pod.

When VITE_GO_PRO=true the UI exposes additional features like Google authentication. For authentication you must provide Firebase configuration via VITE_FIREBASE_CONFIG containing the JSON object used by initializeApp. Set VITE_GA_ID to enable Google Analytics tracking.

The playground keeps up to three independent workspaces (tabs). Each workspace persists its own inputs, trace output, errors and results, and you can export or import them as JSON files to share setups easily.

Docker

To build a container with the compiled frontend run:

docker build -t xslt-playground-frontend frontend

The resulting image serves the static files with nginx on port 80. When the container starts it logs the value of VITE_BACKEND_URL so you can confirm the backend in use in the pod logs. The URL is now picked up at runtime from the container environment.

Using this URL as backendURL: http://localhost:8000

Backend

The Go backend resides under backend/. Compile it using the Makefile which downloads Go modules automatically:

make backend-build
./backend/server

You can also produce a container image using the provided Dockerfile:

docker build -t xslt-playground-backend backend

By default it listens on port 8000 as configured in backend/app.config. The same file sets saxon_classpath so the Java process can load Saxon and its dependencies from /opt/saxon/*.

The backend image also builds a small jar with custom Saxon extension functions. It gets copied to /opt/saxon/custom-functions.jar during the Docker build. You can call these from XSLT using the namespace xmlns:tib="http://www.tibco.com/bw/xslt/custom-functions". The jar exposes many helper functions such as tib:uuid(), tib:timestamp() and tib:addToDate().

Environment

When VITE_GO_PRO=true the backend stores transformation history and requires a PostgreSQL database as well as Firebase credentials for authentication. Provide these via environment variables:

export DATABASE_URL="postgres://user:pass@localhost/dbname"
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/serviceAccount.json
export SAXON_CLASSPATH=/opt/saxon/*

The Firebase project ID is read from the credentials file.

If VITE_GO_PRO is not set or is false the backend skips database and Firebase initialization and only exposes the /transform endpoint.

Makefile

Common tasks are defined in the provided Makefile. Running make without arguments will build both binaries, create the container images and start Docker Compose without shutting it down automatically:

# Build Go binary
make backend-build
# Build React production files
make frontend-build
# Create container images
make backend-image
make frontend-image

Docker Compose

To run the entire stack locally with PostgreSQL use:

make backend-image frontend-image
docker compose up

For a lightweight setup without PostgreSQL run:

docker compose -f docker-compose.local.yml up

This starts just the frontend and backend with VITE_GO_PRO=false.

The compose file passes VITE_BACKEND_URL=http://backend:8000 to the frontend container so it talks to the backend container.

This starts the backend on port 8000, the frontend on 3000 and a PostgreSQL instance on 5432.

Helm Chart

A Helm chart is provided under charts/xslt-playground to deploy the frontend and backend on Kubernetes. By default it expects Firebase credentials and a PostgreSQL database. Before installing, create a secret with your Firebase credentials:

kubectl create secret generic firebase-config \
  --from-file=service-account.json=</path/to/serviceAccount.json> \
  --from-file=firebase-config.json=</path/to/firebaseConfig.json>

Install the chart with:

helm install xslt charts/xslt-playground
# Disable Firebase or database support if desired
# helm install xslt charts/xslt-playground --set firebase.enabled=false
# helm install xslt charts/xslt-playground --set storage.enabled=false
S
Description
Mirror de solo lectura de github.com/alexandrev/xslt-lab — el origen, los issues y el despliegue siguen en GitHub
https://github.com/alexandrev/xslt-lab
Readme 12 MiB
Languages
JavaScript 34.8%
Java 23.2%
HTML 19.9%
CSS 8.7%
Go 6.7%
Other 6.6%