new

Creates a new CAT project file using predefined templates.

CAT configuration is easy. But still, why should you remember the syntax? CAT comes with predefined templates for your project files - their goal is to get you started ASAP. Whether you are starting with CAT or you use CAT daily, cat new will help you get things done quickly.

Let’s start simple

The simplest way to create a new project from a template is this:

# useful for regular users of CAT
catcli new -t default

It creates very simple project file. This is most useful for people who already know and use CAT and don’t wont a project file cluttered with lots of comments and examples.

List available templates

If you are new to CAT, we have a good news for you. We prepared lots of examples how to use CAT (and we’ll be adding new). To see what examles are available, run:

catcli new --list

The command will return list of templates that come out-of-the-box with CAT:

List of templates for new project

New to CAT? Use these…

If you are just starting with CAT and you want to explore and run sample test against data, we recommand you choose one of these templates:

Get started - MS Windows

catcli new --template getStartedWindows --commented

This template contains only a few simple tests and should help you understand the CAT’s configuration. (Get started for Linux is coming soon).

Examle CAT project (AERO)

catcli new --template sampleProject --commented

The goal of this template is to give you an idea what a typical small testing project may look like. It contains lots of tests.

Online templates

We add new templates and we also update existing templates. You don’t have to wait for new versions of CAT to get those. CAT CLI can connect to our server and get new versions of project templates. Also, the bigger samples, such as AERO sample project, we plan to keep only online - to keep the installation footprint of CAT small.

CAT does not communicate online by default, you have to specifically request that, using --online (or simply -o) switch:

catcli new --list --online

Add the switch when you create a new project from a online template:

catcli new -t default --online

In that case CAT first checs if there is newer version online. If yes, it downloads it and uses it (and uses it since then in “offline” mode too).

Template content

The templates typically contain the CAT project file, read-me file, sample data and a script that can run the sample from command line. This depends on the template, all the stuff is present only when it makes sence.

CAT project template content

All options

Short Long name Description
N/A --list Shows list of available templates. Can be combined only with -o and -l
-t --template Code of the template to use
-o --online When combined with -l returns list of templates from CAT server. When combined with -t gets the template (or newer version) from CAT server, if needed
n --name Name for the new created project. Use only English letters and numbers.
-d --directory Target path, where you want the files to be created. CAT will not wrap then in a directory unless combined with -w. If not specified, current directory is used.
-c --commented Include descriptive comments to the project file.
-f --force Clears the target directory before creating new content. !! Take care, beware where you are. Combine with -t ideally.
-w --wrap Wrap the creted content in a directory. It will have the same name as the project name.
-l --loggingLevel Useful only for troubleshooting. None, Error, Information, Debug. Default is Error.

Example:

catcli new -t default -n MyNewProject -w

The command will create a new directory named MyNewProject in your current working directory. It will create the content from the default template.