GitHub integration

TCG can push generated automation scripts directly to a GitHub repository. This creates a seamless bridge between test case generation and your automation pipeline.

What GitHub integration enables

• Push a single script from the Script Generator dialog

• Push all scripts from the Batch Script builder

• Auto-create a repository (generated-test-cases) if you don't have one yet

• Commit scripts with structured commit messages and metadata

Connecting your GitHub account

1

Step - Initiate the OAuth flow

Click Connect GitHub from either the Script Generator dialog or the Test Automation Builder.

A new browser window or tab opens for GitHub OAuth.

2

Step - Authorize TCG

GitHub asks you to authorise TCG to access your repositories:

1. Review the requested permissions.

2. Click Authorize.

3. The window closes automatically.

Your GitHub connection is now stored in the browser session. You will see a connected indicator showing your GitHub username.

3

Step - Repository setup

TCG checks for a repository named generated-test-cases in your account:

• If it exists: TCG uses it.

• If it doesn't exist: TCG creates a new public repository named generated-test-cases automatically.

You can change the target repository by editing the Target Path / Repository settings before pushing.

Pushing a single script

After generating a script in the Script generation:

1. Click Push to GitHub.

2. TCG shows a commit preview:

   • File path - Where the script will be placed (e.g. tests/auth/test_login.py)

   • Commit message - Auto-generated from the test case title

3. Confirm to commit.

4. A success notification appears with a link to the committed file on GitHub.

Pushing all scripts (batch)

After a batch generation in the Batch scripts:

1. Click Push All to GitHub.

2. TCG shows a summary:

   • Total scripts to commit

   • Target repository and branch

   • Base path for all files

3. Confirm to commit all files in a single push.

4. A link to the repository is shown when complete.

Where scripts are committed

Scripts are committed to:

<repository>/
  <target-path>/<language>/test_NNN_<test_case_title>.<ext>

For example, with target path tests/ and language Python:

generated-test-cases/
  tests/python/test_001_user_authentication.py
  tests/python/test_002_password_reset_flow.py
  tests/python/test_003_session_timeout.py

Commit message format

Each commit from TCG uses:

feat(tcg): add automation scripts for [generation name]

Generated by Test Case Generator
Source: [spec file name]
Test cases: [count]
Language: [language/framework]

Disconnecting GitHub

1

1. Click the GitHub icon in the Script Generator or Automation Builder.

2

1. Click Disconnect.

3

1. Your access token is removed from local storage.

Disconnecting does not remove any files already committed to GitHub.

Troubleshooting

Problem	Solution
"Repository not found"	Check you authorized the correct GitHub account. Reconnect if needed.
"Permission denied"	Ensure TCG has repo scope. Revoke and re-authorize to re-grant permissions.
"File already exists"	TCG will overwrite the file with the latest version.
Connection window doesn't close	Close it manually and refresh the TCG page.