allure_dart_commons

allure_dart_commons contains the framework-agnostic Allure model, lifecycle, runtime message, and writer primitives shared by the Dart test adapters in this workspace.

Use this package when you need low-level Allure result generation without the package:test or Flutter adapter layers.

Advanced APIs

• AllureLifecycleListener can observe lifecycle events and mutate a TestResult before it is written.
• AllureExecutorInfo writes executor.json sidecar metadata.
• AllureStatusDetails preserves known, muted, and flaky classifications.
• addAttachmentStreamToRoot and addPreparedAttachmentToRoot write large or late artifacts before the result references them.
• attachImageDiff writes an Allure visual comparison attachment (application/vnd.allure.image.diff) from expected/actual/diff PNG bytes.
• globalError accepts an error object (plus optional stackTrace) and extracts message, trace, actual, expected, and status via getGlobalErrorDetails, or takes those fields explicitly. Fixture hooks use toGlobalErrorMessage to prefix {name} failed on global errors.
• AllureConfig loads checked-in allure-dart.yaml/allure-dart.yml defaults for resultsDir, global labels, and run-level environment properties.

All result and attachment writes stage into .allure-write-*.tmp in the results directory, apply a durable flush (fsync / FlushFileBuffers, plus macOS F_FULLSYNC when available), then rename to the final name so downstream report generation does not see partially written payloads. Readers such as Allure Report / allure run should ignore incomplete *.tmp staging names if they scan a live results directory.