mflux-testing

Run pytest-based fast, slow, and full test suites for the mflux codebase.

2.3k|169|Updated Aug 10, 2024
One-click install
npx skills add https://github.com/filipstrand/mflux --skill mflux-testing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mflux-testing
Source: https://github.com/filipstrand/mflux/tree/main/.cursor/skills/mflux-testing
Command: npx skills add https://github.com/filipstrand/mflux --skill mflux-testing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the validation of the mflux codebase by running the test suites (fast, slow, and full) and preserving outputs for quick review and audit. It targets developers who need reliable test feedback and artifact preservation to support CI and debugging workflows.

Core Features & Use Cases

  • Test orchestration: Run fast, slow, or full test suites with consistent environment settings.
  • Output preservation: Retain generated artifacts and logs for debugging and audit without altering reference outputs.
  • Failure analysis: Provide concise summaries of failing tests and locations of artifacts to speed triage.

Quick Start

Use the Cursor commands to run tests:

  • /test-fast — fast tests with no image generation
  • /test-slow — slow tests that may generate images
  • /test — full test suite Ensure MFLUX_PRESERVE_TEST_OUTPUT=1 is enabled in the environment, and review the summarized failures and artifacts on disk.

Frequently Asked Questions about mflux-testing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I preserve pytest test outputs for debugging in CI?

To preserve pytest test outputs for debugging, you must set the MFLUX_PRESERVE_TEST_OUTPUT environment variable to 1. This retains generated artifacts and logs on disk for quick review and audit without altering reference outputs.

What is the best way to run fast tests without generating images?

The best way to run fast tests without image generation is to execute the fast test suite. This targets local development and PR validation by providing reliable test feedback while skipping slow image generation processes.

How do I triage failing tests and golden image diffs in a CI pipeline?

To triage failing tests and golden image diffs in CI, run the full test suite with output preservation enabled. This provides concise summaries of failures and links to artifact locations on disk to speed up triage.

Do I need specific environment variables to ensure deterministic pytest results?

Yes, you need the MFLUX_PRESERVE_TEST_OUTPUT environment variable enabled to ensure deterministic, reproducible results. It enforces the repository's test configuration and standard pytest dependencies for consistent test execution.

When should I run the slow test suite during local development?

You should run the slow test suite during local development when you need to validate code paths that may generate images. It ensures comprehensive validation by executing tests that produce image outputs for review.