Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

...

Code Block
sl-python config {--token <token> | --tokenfile <file>} --appname <appname> --branch <branch> --build <build> [--buildsessionid <buildsessionid>] [--proxy <proxy>] [--failbuild {true|false}]
code

tokenfile

branch

Parameter

Description

token

Access token generated from the Sealights server

Code Block

Path to file containing access token generated from the SeaLights server

code

appname

Name of the application

Code Block

The source branch of the application

code

build

The build label of the current build

code

buildsessionid

Optional: A user provided session ID

code

proxy

Address of proxy to run connection through

Code Block
failbuild

Exit with an error code if an error is encountered (Default: false)

help

Show Help message and exit.

Scanning a build

Code Block
sl-python build {--token  <token> | --tokenfile <file>} {--buildsessionid <id> | --buildsessionidfile <file>} --workspacepath <workspacepath>  --scm {git|none} [--projectRoot <folder>] [--excludedpaths <excludedpaths>] [--uniqueModuleId <id>] [--es-modules] [--jobName <jobName>] [--logsUrl <logsUrl>] [--dependenciesFile <dependenciesFile>] [--instrumentForBrowsers --outputpath <folder> [--downloadAgent {true|false}] [--instrumentationOnly] [--labid <labid>]] [--proxy <proxy>] [--failbuild {true|false}] [--scmBaseUrl --scmProvider {github|gitlab|bitbucket} --scmVersion] [--babylonPlugins decorators-legacy]

Parameter

Description

Code Block
token

Access token generated from the SeaLights server

Code Block
tokenfile

Path to file containing access token generated from the SeaLights server

Code Block
buildsessionid 

Session ID of configuration created

Code Block
buildsessionidfile

Path to file containing the Session ID of configuration created

Code Block
workspacepath

Path to the source workspace

Code Block
excludedpaths

Comma-separated list of files to exclude from scan

Supports wildcards (* = any string, ? = any character). For example: '*-with-dependencies.jar , bad-bad?.war, *-source.jar'

Code Block
projectRoot

Path to the root of the project. Usually where the src folder resides

Code Block
uniqueModuleId

Unique name when providing more than one build scan per build

es-modules

Indicates that you use es6 modules

Code Block
jobName

Name of Jenkins job

Code Block
logsUrl 

Path to Jenkins log folder

Code Block
scm 

Source control used

Current options are: git, none

Code Block
dependenciesFile 

A path to a json file that is in the following format:
[{"appName":"","branch":"","build":""}, {...}]

Code Block
instrumentForBrowsers

Instrument the JS files for providing browser front-end coverage information. Must be used with the outputpath parameter.

Code Block
downloadAgent

Set this value to 'false' in order to prevent the instrumented javascript to try and download the browser test listener (for example, when using 'Karma').

Code Block
instrumentationOnly

Only instrument the javascript files, without sending the build information to the SeaLights server

Code Block
outputpath

Folder to generate the instrumented JS files in when using the instrumentForBrowsers parameter

Code Block
labid

Unique ID for a set of test labs in case multiple labs are running simultaneously or for an integration build.
This needs to be done during the instrumentation process when using the instrumentForBrowsers option

Code Block
proxy

Address of proxy to run connection through

Code Block
failbuild

Exit with an error code if an error is encountered (Default: false)

scmProvider

The provider name of your Source Control Management (SCM) tool.
Values: Github, Bitbucket and Gitlab (Default is Github)

scmBaseUrl

The URL to the repository which contains the code.

If not provided, the url of the remote GIT origin will be used

Example: https://my.bitbucket.com/projects/ABCD/repos/XYZ/browse/A1

scmVersion

The version of your Source Control Management (SCM) tool.

If not provided, cloud version is assumed

babylonPlugins 

When there are decorators in the code, you should use this flag with the "decorators-legacy" value

...

Code Block
sl-python uploadReports {--token  <token> | --tokenfile <file>} {--buildsessionid <id> | --buildsessionidfile <file>} {--reportFile <reportFile> | --reportFilesFolder <reportFilesFolder>} [--hasmorerequests {False|True}] [--labid <labid>] [--source <source>] [--type <type>] [--proxy <proxy>] [--failbuild {true|false}help]
code

buildsessionid

buildsessionidfile

reportFile

reportfile

Name of testing framework type. The report type. If not set, the default will be 'JunitReport'

  • JUnitReport - For uploading JUnit test report files

  • commitLog - For uploading git style commit logs

Parameter

Description

Code Block
appname

Name of the application

Code Block
branch

The source branch of the application

Code Block
build

The build label of the current build

Parameter

Description

token

Access token generated from the SeaLights server

code

tokenfile

Path to file containing access token generated from the SeaLights server

Code Block

Session ID of configuration created

Code Block

Path to file containing the Session ID of configuration created

Code Block

Path to report file (multiple entries can be provided)

Code Block
reportFilesFolder

Path to folder containing report files (multiple entries can be provided). This argument can be declared multiple times in order to upload multiple files.

reportfilesfolder

Path to folder that contains nothing but report files. All files in folder will be uploaded.
This argument can be declared multiple times in order to upload multiple files from multiple folders containing report files.

Note: all files in the folder will be uploaded

code

hasmorerequests

Set to ‘True’ if test results contains multiple reports (Default: ‘False’).

labid

Unique ID for a set of test labs in case multiple labs are running simultaneously

code

(case-sensitive)

source

The reports providerDefault: . If not set, the default will be 'Junit xml report'.

type

Code Block
Values:
Code Block
JUnitReport - For uploading JUnit test report files
Code Block
commitLog - For uploading git style commit logs

type

Name of testing framework type

Code Block

proxy

Address of proxy to run connection through

Code Block
failbuild

Exit with an error code if an error is encountered (Default: false)

Optional override parameters:

help

Show Help message and exit.

Ending a test stage

Code Block
sl-python end {--token  <token> | --tokenfile <file>} {--buildsessionid <id> | --buildsessionidfile <file>} [--labid <labid>] [--proxy <proxy>] [--failbuild {true|false}]
code

tokenfile

Parameter

Description

token

Access token generated from the SeaLights server

Code Block

Path to file containing access token generated from the SeaLights server

code

buildsessionid

Session ID of configuration created

code

buildsessionidfile

Path to file containing the Session ID of configuration created

code

labid

Unique ID for a set of test labs in case multiple labs are running simultaneously

code

proxy

Address of proxy to run connection through

Code Block
failbuild

Exit with an error code if an error is encountered (Default: false)

help

Show Help message and exit.

Running backend server

Code Block
sl-python run {--token  <token> | --tokenfile <file>} {--buildsessionid <id> | --buildsessionidfile <file>} [--cov-workspacepathreport <path>] [--useinitialcolorper-test {true|false}] [--teststageinterval <teststage><interval>] [--labid <labid>] [--proxy <proxy>] [--failbuild {true|false}help] args...

token

buildsessionid

workspacepath

cov-report

proxy

Parameter

Description

Code Block

Access token generated from the SeaLights server

code

tokenfile

Path to file containing access token generated from the SeaLights server

Code Block

Session ID of configuration created

code

buildsessionidfile

Path to file containing the Session ID of configuration created

Code Block

Path to the source workspace

Code Block
useinitialcolor

When reporting tests manually this should be set to false generate XML coverage report

per-test

Collect coverage per test (Default: false)

Code Block
teststage

Name of the test stage

code

interval

Interval in milliseconds to send data

labid

Unique ID for a set of test labs in case multiple labs are running simultaneously (case-sensitive)

Code Block

Address of proxy to run connection through

Code Block
failbuild

Exit with an error code if an error is encountered (Default: false)help

Show Help message and exit.

args...

Extra arguments for running mocha framework teststhe application server

Logging

Enabling logging in Python is done using by setting the SL_DEBUG environment variable to “true”.

...