mirror of
https://github.com/bahdotsh/wrkflw.git
synced 2026-09-02 12:16:16 +02:00
c67e4bfd20
The documentation had grown into the kind of sprawling mess where the same feature gets explained three times in three different files, none of which agree with each other. The main README alone was 610 lines of duplicated sections, speculative roadmaps, and verbose limitation disclaimers that nobody reads. Remove 12 files that had no business existing: junk test files (hello.cpp, hello.rs, test.py), duplicate agent configs, a 487-line Podman testing manual, unused asciinema recordings, and 7MB of unreferenced GIF files. Merge the useful bits from GITLAB_USAGE.md into the main README where they belong. Rewrite the main README from 610 lines down to ~170. Every feature is mentioned once, in one place, with one example. The crate README now actually lists all 14 crates instead of pretending secrets doesn't exist. Net result: 3,819 lines deleted, 197 added. The documentation now fits in your head, which is the whole point.
Testing
This directory contains integration and end-to-end tests for wrkflw.
Test Organization
- Unit tests: alongside source files in
src/using#[cfg(test)]modules - Integration tests: in this
tests/directorymatrix_test.rs— matrix expansionreusable_workflow_test.rs— reusable workflow validation
- End-to-end tests: also in this directory
cleanup_test.rs— cleanup with Docker resources
Directory Structure
fixtures/— test data (e.g.,gitlab-ci/configs)workflows/— GitHub Actions workflow YAML files for testingscripts/— test automation scripts (test-podman-basic.sh,test-preserve-containers.sh)
Running Tests
# All tests
cargo test
# Unit tests only
cargo test --lib
# Integration tests only
cargo test --test matrix_test --test reusable_workflow_test
# End-to-end tests only
cargo test --test cleanup_test
# A specific test
cargo test test_name