beads/tests/integration
matt wilkie e2e4975044
Document supported go install modes (bd-o5a) (#3480)
- Removed bare first-party go install .../cmd/bd@latest guidance from docs,
    website docs, plugin/npm docs, examples, and doctor hints.
  - Standardized on:
      - CGO_ENABLED=0 go install ... for server-mode only
      - CGO_ENABLED=1 GOFLAGS=-tags=gms_pure_go go install ... for embedded-
        capable
  - Added scripts/check-go-install-guidance.sh and wired it into CI.
  - Updated default.nix to use gms_pure_go instead of ICU flags.

  Validation passed locally:

  - make test
  - golangci-lint run --build-tags=gms_pure_go ./...
  - ./scripts/check-go-install-guidance.sh
  - ./scripts/check-build-tags.sh
  - go test -tags gms_pure_go ./cmd/bd/doctor
  - doc flag check
2026-04-25 11:30:19 -07:00
..
README.md Document supported go install modes (bd-o5a) (#3480) 2026-04-25 11:30:19 -07:00

Integration Tests

This directory contains integration tests for bd (beads) that test end-to-end functionality.

Prerequisites

  • bd installed: curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash
  • Python 3.7+ for Python-based tests

Running Tests

# Run all integration tests
python3 -m pytest tests/integration/

Adding New Tests

Integration tests should:

  1. Use temporary workspaces (cleaned up automatically)
  2. Test real bd CLI commands, not just internal APIs
  3. Use embedded mode for fast execution (no Dolt server dependency)
  4. Verify behavior via bd show --json or bd list --json when relevant
  5. Clean up resources in finally blocks
  6. Provide clear output showing what's being tested