jux-container-format

Single source of truth for the .jxz signed container format specification.

What is .jxz?

The .jxz (Jux Archive) format is a JAR-style signed container based on ZIP, used to package JUnit XML test reports with attachments and digital signatures for secure transmission to a Jux server.

report.jxz
├── META-INF/
│   ├── MANIFEST.MF          # Container metadata, file inventory with digests
│   └── SIGNATURE.XML        # Detached XML signature covering manifest
├── junit.xml                # JUnit XML report
└── attachments/             # Optional test attachments
    ├── screenshot.png
    └── trace.json

Quick Links

• Format Specification - Full prose specification
• Manifest JSON Schema - Machine-readable manifest validation
• Examples - Sample unpacked .jxz containers
• Changelog - Version history
• Versioning Policy - How the format evolves

Current Version

v1.0.0 - Initial specification

Implementations

Project	Role	Status
pytest-jux	Producer	Planned
behave-jux	Producer	Planned
jux	Consumer	Planned

Validation

./scripts/validate.sh path/to/file.jxz

Related

• jux-openapi - REST API contract (sibling project)
• jux-test-fixtures - Test fixtures including .jxz samples

License

Copyright (c) 2026 Georges Martin. All rights reserved.