testops-mirror 0.1.1

Mirror test cases from any TMS into a Git repository as Markdown files

testops-mirror

Mirror test cases from any TMS into a Git repository — one file per test case, history forever.

mirror/
├── Transfers/
│   ├── Negative/
│   │   └── TC-2301-transfer-to-blocked-account.md
│   └── TC-2201-transfer-between-own-accounts.md
└── Auth/
    └── TC-1001-login-with-valid-credentials.md

Why

Your TMS is a single point of failure. Test cases deserve version control just like code — history, diff, blame, and code review through merge requests.

testops-mirror pulls every test case on a schedule and commits changes to a plain Git repo. No vendor lock-in, no proprietary format.

Quick Start

pip:

pip install testops-mirror
cp .env.example .env  # fill in TESTOPS_ENDPOINT and TESTOPS_TOKEN
testops-mirror sync --project-id 42 --repo ./mirror

Docker:

docker run --rm \
  -e TESTOPS_ENDPOINT=https://testops.example.com \
  -e TESTOPS_TOKEN=your-token \
  -v $(pwd)/mirror:/mirror \
  ghcr.io/exzist-qa/testops-mirror \
  sync --project-id 42 --repo /mirror

Example output file

See docs/example/Transfers/Negative/TC-2301-transfer-to-blocked-account.md for a real file generated by the tool from Allure TestOps fixture data.

Supported TMS

TMS	Status
Allure TestOps	✅
TestIT	🚧 planned
TestRail	🤝 contributions welcome

Configuration

Option	Env	Default	Description
--project-id	—	required	TMS project ID
--endpoint	TESTOPS_ENDPOINT	required	Base URL of TMS
--token	TESTOPS_TOKEN	required	API token
--repo	—	./mirror	Local Git repo path
--suite-field	TESTOPS_SUITE_FIELD	Suite	Custom field for folder structure
--dry-run	—	false	Preview changes without writing
-v/--verbose	—	false	Verbose logging

Note: API endpoint paths are verified against Allure TestOps documented API. If your instance uses different paths, check <endpoint>/swagger-ui/ and update the constants in connectors/allure_testops.py.

Roadmap

• Attachments download
• TestIT connector
• Index file (cases/INDEX.md) with a table of all cases
• Reverse import (Markdown → TMS)

License

MIT