Updated New Script

This Script is faster, more powerful, and easier to implement.

Appsurify Script Installation

Index

  • Installation Instructions

    • Requirements

    • Support OS / Python

    • Installation Command

  • Repository Push / Git2TestBrain (git2appsurify)

    • Possible params

    • Usage Examples

  • Repository Checkout

    • Possible Params

    • Usage Examples

Installation Instructions

Requirements

Python 3.7+

Support OS / Python

OS
Python
Support

Linux

3.7

🟢

Linux

3.8

🟢

Linux

3.11

🟢

MacOS

3.7

🟢

MacOS

3.8

🟢

MacOS

3.11

🟢

Windows

3.7

🟢

Windows

3.8

🟢

Windows

3.11

🟢

Installation Command

pip install appsurify-testbrain-cli

or

poetry add appsurify-testbrain-cli

Note: Use -U or --upgrade for force upgrade to last version

Docker image "appsurify-testbrain-cli"

Latest Version

docker pull appsurifyinc/appsurify-testbrain-cli

Specify version

docker pull appsurifyinc/appsurify-testbrain-cli:2023.10.24

Repository Push | Git2Testbrain (git2appsurify)

This module is used to push changes in the repository to the Testbrain server for further analysis and testing optimization.

This module can be used as an independent command in the OS or as a subcommand of the main CLI application "testbrain"

Alias #1

testbrain repository push --help

Alias #2

git2testbrain push --help

Alias #3

testbrain git2testbrain push --help

Parameters

Required
Parameter
Default
Env
Description

Yes

--server

TESTBRAIN_SERVER

Enter your Testbrain server instance url.

Yes

--token

TESTBRAIN_TOKEN

Enter your testbrain server instance token or API Key. Located in top-right hand corner of user-interface under user profile.

Yes

--project

TESTBRAIN_PROJECT

Enter your Testbrain projet name.

No

--work-dir

current dir

TESTBRAIN_WORK_DIR

Enter the testbrain script working directory. If not specified, the current working directory will be used.

No

--repo name

TESTBRAIN_REPO_NAME

Define repository name. If not specified, it will be automatically taken from the GitRepository repository.

No

--repo-dir

current dir

TESTBRAIN_REPO_DIR

Enter the git repository directory. If not specified, the current working directory will be used.

No

--branch

current

TESTBRAIN_BRANCH

Enter the explicit branch to process commits. If not specified, use current active branch.

No

--start / --commit

latest (HEAD)

TESTBRAIN_START_COMMIT

Enter the commit that should be starter. If not specified, it will be used 'latest' commit.

No

--number

1

TESTBRAIN_NUMBER_OF_COMMITS

Enter the number of commits to process.

No (unavailable)

--blame

false

Add blame information.

No

--minimize

false

Suppress commit changes information. [default; (False)]

No

--pr-mode

false

TESTBRAIN_PR_MODE

Activate PR mode

No

-l, --loglevel

INFO

Possible fatalities: DEBUG/INFO/WARNING/ERROR

No

--logfile

stderr

Saves logs to file

No

--quiet

fales

Quiet mode...every time exit with 0

Usage Examples

Push to Testbrain server only one last commit from current branch:

git2testbrain --server https://demo.appsurify.com --token ************************************************************** --project DEMO

Or

git2testbrain push --server https://demo.appsurify.com --token ************************************************************** --project DEMO

Push to Testbrain server last 100 commits started from specify commit into specify branch:

git2testbrain --server https://demo.appsurify.com --token ************************************************************** --project DEMO --branch main --start latest --number 100

If need more process information - change logging level:

git2testbrain --server https://demo.appsurify.com --token ************************************************************** --project DEMO --branch main --start latest --number 100 --loglevel DEBUG

Add log file with full or relative path:

git2testbrain --server https://demo.appsurify.com --token ************************************************************** --project DEMO --branch main --start latest --number 100 --loglevel INFO --logfile ./git2testbrain.log

If any crash errors script will create crash dump file into {WORK_DIR}/.crashdumps/

git2testbrain --server https://demo.appsurify.com --token ************************************************************** --project DEMO

You can see this message:

2023-11-05 21:16:03 INFO     testbrain.repository.cli push [repository/cli.py:184] Running...
2023-11-05 21:16:03 DEBUG    testbrain.terminal.process Process.__init__ [terminal/process.py:22] Set up execution working dir ...
Dumped crash report to <path_to_work_dir>/.crashdumps/git2testbrain-2023-10-23-11-27-39.dump

Docker version usage

$(pwd) - git repository path

docker run --rm -it \
-v $(pwd)/:/data \
appsurifyinc/appsurify-testbrain-cli git2testbrain --server https://demo.appsurify.com --token ************************************************************** --project DEMO

CI example (github actions)

.github/workflows/testbrain-git2testbrain.yml

name: "Testbrain"

on:
    workflow_dispatch:
    pull_request:
        branches:
            - "main"
            - "development"
    push:
        branches:
            - "main"
            - "releases/*.*.*"
            - "development"

jobs:
    push-changes:
        name: "Push changes to server"
        runs-on: ubuntu-latest
        permissions:
            contents: write
            pull-requests: write
            checks: write
        steps:
            - name: "Checkout repository"
              uses: actions/checkout@v4
              with:
                  fetch-depth: 0
            - name: "Extract branch name"
              shell: bash
              run: echo "branch=${GITHUB_HEAD_REF:-${GITHUB_REF#refs/heads/}}" >> $GITHUB_OUTPUT
              id: extract_branch
            - name: "Push"
              uses: addnab/docker-run-action@v3
              with:
                  image: appsurifyinc/appsurify-testbrain-cli:latest
                  options: -v ${{ github.workspace }}:/data -e TESTBRAIN_PR_MODE=${{ github.event_name == 'pull_request' }}
                  run: |
                      git2testbrain push --server ${{ vars.TESTBRAIN_SERVER }} --token ${{ secrets.TESTBRAIN_TOKEN }} --project ${{ vars.TESTBRAIN_PROJECT }} --branch ${{ steps.extract_branch.outputs.branch }} --start ${{ github.sha }} --number ${{ vars.TESTBRAIN_NUMBER_OF_COMMITS }} -l DEBUG
            - name: "Upload crash dumps"
              uses: actions/upload-artifact@v3
              if: failure()
              with:
                  name: "crashdumps"
                  path: ${{ github.workspace }}/.crashdumps/
                  retention-days: 1

Repository Checkout

This module is used to checkout branches during the execution of CI pipelines or manually. Cloning is not provided.

Alias #1 

testbrain repository checkout --help

Alias #2 

git2testbrain checkout --help

Alias #3 

testbrain git2testbrain checkout --help

Parameters

Required
Parameter
Default
Env
Description

No

--repo-dir

current dir

TESTBRAIN_REPO_DIR

Enter the git repository directory. If not specified, the current working directly will be used.

No

--branch

current

TESTBRAIN_BRANCH

Enter the explicit branch to process commits. If not specified, use current active branch.

No

--commit

latest (HEAD)

TESTBRAIN_START_COMMIT

Enter the commit that should be starter. If not specified, it will be used 'latest' commit.

No

--pr-mode

False

TESTBRAIN_PR_MODE

Activate PR mode

No

--work-dir

current dir

TEST_WORK_DIR

Enter the testbrain script working directory, the current working directory will be used.

No

-l, --loglevel

INFO

Possible Fatalities: DEBUG/INFO/WARNING/ERROR

No

--logfile

stderr

Save logs to file

No

--quiet

false

Quiet mode...every time exit with 0

Usage Examples:

Checkout using Testbrain CLI

git2testbrain checkout --branch main -l INFO

Or

git2testbrain checkout --branch main --commit 75ec2f061868c33306963a27d5164211553c049b --pr-mode -l INFO

Or

git2testbrain checkout --branch main --commit 676c581 --pr-mode -l INFO

Docker version usage

$(pwd) - git repository path

docker run --rm -it \
-v $(pwd)/:/data \
appsurifyinc/appsurify-testbrain-cli git2testbrain checkout --branch main --commit 676c581 --pr-mode -l INFO
PreviousStep 2: Connect RepositoryNextStep 3: Connect Tests

Last updated