BAT CLI Reference
The BAT command line interface lets you run tests locally and schedule monitors for continuous API testing. You can schedule tests in the cloud using the CLI-xAPI. The BAT CLI is integrated with Anypoint Platform.
This reference covers the syntax and key options you can use with the bat command. Using the bat command, you can debug and run tests, get credentials for scheduling tests, schedule tests, list test schedules, and perform additional operations.
bat Command
The bat command provides an API functional monitoring command line interface.
Syntax
bat [<file> … | <option> …]
bat [login --username=<value> [--profile=<value>] --host=<value>]
This option displays an interactive command for the password.
password for user [username]: <password>
Optionally, you can include the option --password=<password> in the login command.
Where:
-
file is the relative path to the path and file name. The file must have one of the following base names and one of the following extensions:
-
base file names: main, bat
-
extensions: .yaml, or .yml
When you execute bat without any arguments, BAT reads the YAML in the current directory and runs the specified tests. You can create a
configfolder and add different configuration files inconfigfor the environments.
-
test-project
├── bat.yaml
├── tests
└── config
├── default
├── devx
├── qax
├── stgx
└── prod
Command Line Options
-
bat ~/path/to/folder/
Executes the desired folder. BAT searches for and executes thebat.yamlandmain.dwlfiles. -
bat ./folder/file.dwl
Executes the desired file. The root of the project is the current folder. The root of the project is used to resolve imports, and load libraries and files.-
--bat-version=1.0.51Executes BAT using the specified version.
-
--config=<name>Selects a configuration file (from the
configfolder) and registers the result as a global variable. -
--init-folderStores the files, exchange.json and main.dwl, generated by creating the monitor in the current directory. Optional.
-
--initSame as the
bat initcommand, which sets up a basic project folder. The folder contains the following files:bat.yaml tests/ tests/HelloWorld.dwl config/ config/default.dwl config/prod.dwl config/dev.dwl
-
--password=<value>Value is the password for the Anypoint Platform user name.
-
--profile=<value>Profile is:
-
The name of a profile for accessing an Anypoint Platform location and retaining the login information between BAT sessions. Using this option eliminates the need to relogin between sessions. Optional.
-
The name of a profile for scheduling an endpoint that can be different from the BAT login profile you used. By default, BAT uses the login profile for scheduling. Optional.
-
-
--updateInstalls the latest BAT CLI.
-
--username=<value>Value is an Anypoint Platform user name.
-
--validateValidates the file or folder. Also works with
--configto validate specific configurations. -
--versionPrints to standard output the version numbers of installed BAT and wrapper. If the latest version is not installed, that version is downloaded.
-
get_tokenReturns the token for accessing Anypoint Platform in the credentials file. Requires that you first run
bat loginto generate a profile. -
location createCreates a private location in your organization in Anypoint Platform. A private location is a namespace in an instance of Anypoint Virtual Cloud (VPC) that is configured to allow workers to access your private network. Requires a subscription to VPC. See Differences in the Monitoring of the Endpoints of Public and Private APIs for more information about private locations and how they differ from public locations.
-
location deleteDeletes a private location from the list of private locations in your organization in Anypoint Platform.
-
location ls|listLists the private and public locations in your organization in Anypoint Platform. This command replaces
target ls|list. -
schedule create [--cron="<expression>"]Create a scheduler using a cron expression and generating a zip that includes the tests and all the files. By default, if a cron expression is not entered, tests are scheduled to run every 15 minutes.
-
schedule disable <scheduleID>Disables the schedule that is identified by the specified ID. If you runbat schedule lsafter you run this command, you will see that the value -
schedule enable <scheduleID>Enables the schedule that is identified by the specified ID. Use this command only when you want to enable a schedule that you have disabled with the
bat schedule disable <scheduleID>command. -
schedule endpoint <arbitrary-URL> [--cron="<cron>"] [--name=<suiteName>] [--target=<targetId>] [--new-relic-license-key=<newRelicLicenseKey>] [--slack-webhook=<slackWebHook>] [--sumo-endpoint=<sumoEndpoint>] [--pager-duty-routing-key=<pagerDutyRoutingKey>] [--custom-report-url=<customReportUrl>] [--custom-report-headers=<header1,header2,…,headerN>] [--custom-report-transformation=<pathToDwlFile>][--init-folder]Create a monitor in Exchange of using an arbitrary URL, for example
http://example.com. Optionally, you can add commands to generate the bat.yaml with different parameters.-
[--cron="<cron>"]By default, tests are scheduled to run every 15 minutes. You can change with the cron expression -
[--name="<suiteName>"]To set the name of the suite -
[--target="<targetId>"]Set a specific target to the monitor -
[--new-relic-license-key="<newRelicLicenseKey>"]Add the new relic report to the bat.yaml. -
[--slack-webhook="<slackWebHook>"]Add the slack report to the bat.yaml. -
[--sumo-endpoint="<sumoEndpoint>"]Add the sumo report to the bat.yaml. -
[--pager-duty-routing-key="<pagerDutyRoutingKey>"]Add the pager duty report to the bat.yaml. -
[--custom-report-url="<customReportUrl>"] [--custom-report-headers="<header1,header2,…,headerN>"] | [--custom-report-transformation="<pathToDwlFile>"]Add the custom report to the bat.yaml file and optionally you can add the transformation file. -
[--init-folder]Store generated exchange.json, bat.yaml and main.dml in the current directory.
-
-
schedule ls | listList all the schedulers information from the profile’s organization.
-
schedule rm | remove <scheduleId>Deletes a schedule by its ID.
-
worker registerGenerates a post with the machine name and create a dummy target.
-
BAT Command Examples
-
Run multiple test files from the bat.yaml file.
bat bat.yaml -
Run a single file.
bat ./test/myFile.dwl -
Determine the installed version.
bat --versionExample output if you do not have the latest version is:
Updating Version: You have an older BAT version. The new version will be downloaded in /Users/<username>/.bat/bat-cli-1.0.51 Downloading version 1.0.51. Please wait`....................... BAT Wrapper: 1.0.53 BAT Version: 1.0.51