Atlassian AutoTestCase Manager (atlas-atc-manager)

Extract test cases from automation code and sync them to Jira Xray — without manual copy-pasting!

This open-source CLI tool is developed and maintained by Will Shi @ TMAN Consulting, with the goal of bridging the gap between automated test code and Jira-based test management.

It helps QA and DevOps engineers extract test cases directly from Python, Java, or Robot Framework code and auto-create structured test cases in Jira Xray (both Cloud and Data Center editions).

🚀 What's Next: TMAN AutoTestCase Extractor (Jira Cloud Plugin)

We’re building a native Jira Cloud plugin, based on this CLI engine but designed for remote Git repositories, no local installation, and seamless integration with GitHub / GitLab / Bitbucket via API.

🎯 No installation. No CLI. Just connect your repo and sync test cases — all inside Jira.

🔔 Sign up for early access: Google Forms

⭐ Love this tool?

If you find this project helpful:

• 🌟 Please star the repo to support further development
• 👀 Follow the repo or enable “Watch” to get notified about major updates
• 🧪 Try it in your test projects and open issues/feedback
• 📢 Share it with your team or in your community

Your encouragement helps this project (and the upcoming plugin) grow stronger 💪

   ___ ________   ___   ____  ___ ___________  __  ___
  / _ /_  __/ /  / _ | / __/ / _ /_  __/ ___/ /  |/  /__ ____  ___ ____ ____ ____
 / __ |/ / / /__/ __ |_\ \  / __ |/ / / /__  / /|_/ / _ `/ _ \/ _ `/ _ `/ -_) __/
/_/ |_/_/ /____/_/ |_/___/ /_/ |_/_/  \___/ /_/  /_/\_,_/_//_/\_,_/\_, /\__/_/
                                                                  /___/          

✨ Key Features

• ✅ Auto-detect and parse test cases from Python (pytest, unittest), Java (JUnit-style), or Robot Framework files
• ✅ Create or update corresponding test cases in Jira (Xray) Cloud or Data Center
• ✅ Add source code or docstrings as structured test steps
• ✅ CLI-based, easy to integrate into CI/CD pipelines
• ✅ Configurable via command-line arguments or persistent credential file

🔧 Why Use This Tool?

• Reduce manual overhead of copying test cases to Jira
• Keep your test documentation and automation always in sync
• Enhance traceability between code and Jira Xray artifacts
• Empower your QA/dev team to focus on testing, not on syncing

🎯 Roadmap

We aim to support teams who want:

• Traceability from test code to Jira
• No manual duplication of test cases
• Scalable test management for QA + DevOps

⚡️ Quick Start

🏗 Check preconditions

• Python >= 3
• pip (Python package manager)

📦 Install atlas-atc-manager tool

pip install atlassian-auto-test-case-manager
atlas-atc-manager show-version

🧰 Usage

Available Commands

Usage: atlas-atc-manager [COMMAND] [OPTIONS]

Commands:
  show-version        display version info for this tool and your Python runtime
  show-variables      show all supported environment variables
  show-config         show config
  config-cred         set and save Jira credentials/config (project, token, etc.)
  extract-case        extract test cases from code and sync them to Jira (Xray, Zephyr Scale, etc.)

Use 'atlas-atc-manager <command> --help' for more info on a specific command.

extract-case

Usage: atlas-atc-manager extract-case --test-path <TEST_CODE_PATH> [options]

Options:
  --test-path <TEST_CODE_PATH>
                        Path to a test file or folder (supports .py, .java, .robot)
  --jira-plugin <xray>  Target test management tool on Jira : xray
  --jira-project <PROJECT_KEY>
                        Jira project key (e.g. "TEST")
  --jira-hosting <cloud|dc>
                        Jira hosting type (supports cloud, data-center) : cloud | dc
  --jira-site <URL>     Jira site URL (e.g. https://yourcompany.atlassian.net)
  --jira-user <USERNAME>
                        Specify the Jira username for authentication
  --jira-token <TOKEN>  Jira API token for authentication
  --xray-client-id <CLIENT_ID>
                        XRAY Cloud client id for authentication
  --xray-client-secret <CLIENT_SECRET>
                        XRAY Cloud client secret for authentication
  -h, --help            Show this help message and exit

• How to Get Jira Cloud API Token

🧪 Example

atlas-atc-manager extract-case \
  --test-path ./tests/ \
  --jira-plugin xray \
  --jira-project QA \
  --jira-hosting dc \
  --jira-site https://jira.mycompany.com \
  --jira-token xxxx-xxxx-xxxx

config-cred

Save frequently used configuration to a local file (~/.atlas_atc_manager/credential.conf), so you don’t need to pass everything each time.

atlas-atc-manager config-cred --jira-plugin xray --jira-project QA --jira-hosting dc --jira-site https://jira.company.com --jira-token xxxx

Re-run with --overwrite to update.

🛠 Supported Test Formats

📌 Notes

• Current version supports Xray for Jira Data Center and Xray for Jira Cloud.
• The tool works best in Git-tracked repos, as it uses the repo name to organize test set paths.

🌍 License

Apache License 2.0

LICENSE

📒 Credits

Developed by Will Shi at TMAN Consulting Designed to help teams move faster by connecting code with Jira.

📚 References

XRAY

• Create XRAY Cloud API Key
• Create Test via XRAY Cloud Graphql REST API