Context CLI commands
The commands in this section allow you to manage project entities that involve Uniform's classification and personalization features. This includes:
| Project entity | Command | More information |
|---|---|---|
| Aggregates | aggregate | Capabilities |
| Enrichments | enrichment | Capabilities |
| Manifest | manifest | Capabilities |
| Quirks | quirk | Capabilities |
| Signals | signal | Capabilities |
| Tests | test | Capabilities |
Aggregates#
Get aggregate#
command
Fetch an aggregate definition from the Uniform project.
| Command | Output details |
|---|---|
-f, --format | Format for the output (YAML or JSON) |
-o, --filename | File name for the output. If not specified the output is written to stdout. |
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
List aggregates#
command
List aggregate definitions from the Uniform project.
| Command | Output details |
|---|---|
--offset | Number of rows to skip before fetching. |
limit | Number of rows to fetch. |
| -f, --format string (optional, default value: YAML) | Format for the output. YAML JSON |
-o, --filename | File name for the output. If not specified the output is written to stdout. |
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Pull aggregate#
command Fetch all aggregate definitions from the Uniform project and save them locally.
- If you pass a directory, the CLI writes each of the aggregates to its own file.
- If you pass a file path ending in
.yaml,.yml, or.json, the CLI writes all aggregates to a single file.
| Command | Output details |
|---|---|
-w, --what-if | If true, reports what would be done but changes no files. |
-m, --mode | Specifies what kind of changes can be made. |
| -d, --diff string (optional, default value: off) | Specifies which changes are written to stdout. If not specified, the environment variable UNIFORM_CLI_DIFF_MODE is used. If the environment variable isn't set, the default value is used. off - No changes are written.update - Only update changes are written.on - Update, create, and delete changes are written. |
-f, --format | Format for the output (YAML or JSON) |
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Push aggregate#
command Insert or update all aggregate definitions from local disk to the Uniform project.
- If a directory path is specified, the aggregates defined in the files in the directory used.
- If a file path is specified, the aggregates in the file are used.
| Command | Output details |
|---|---|
-w, --what-if | If true, reports what would be done but changes no files. |
-m, --mode | Specifies what kind of changes can be made. |
-d, --diff | Specifies which changes are written to stdout. If not specified, the environment variable UNIFORM_CLI_DIFF_MODE is used. If the environment variable isn't set, the default value is used. |
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Remove aggregate#
command Delete an aggregate definition from the Uniform project.
| Command | Output details |
|---|---|
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Update aggregate#
command Insert or update an aggregate definition from a local file to the Uniform project.
| Command | Output details |
|---|---|
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Enrichments#
Get enrichment#
command
Fetch an enrichment definition from the Uniform project.
| Command | Output details |
|---|---|
-f, --format | Format for the output (YAML or JSON) |
-o, --filename | File name for the output. If not specified the output is written to stdout. |
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
List enrichments#
command
List enrichment definitions from the Uniform project.
| Command | Output details |
|---|---|
--offset | Number of rows to skip before fetching. |
limit | Number of rows to fetch. |
| -f, --format string (optional, default value: YAML) | Format for the output. YAML JSON |
-o, --filename | File name for the output. If not specified the output is written to stdout. |
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Pull enrichment#
command Fetch all enrichment definitions from the Uniform project and save them locally.
- If you pass a directory, the CLI writes each of the enrichments to its own file.
- If you pass a file path ending in
.yaml,.yml, or.json, the CLI writes all enrichments to a single file.
| Command | Output details |
|---|---|
-w, --what-if | If true, reports what would be done but changes no files. |
-m, --mode | Specifies what kind of changes can be made. |
| -d, --diff string (optional, default value: off) | Specifies which changes are written to stdout. If not specified, the environment variable UNIFORM_CLI_DIFF_MODE is used. If the environment variable isn't set, the default value is used. off - No changes are written.update - Only update changes are written.on - Update, create, and delete changes are written. |
-f, --format | Format for the output (YAML or JSON) |
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Push enrichment#
command Insert or update all enrichment definitions from local disk to the Uniform project.
- If a directory path is specified, the enrichment defined in the files in the directory used.
- If a file path is specified, the enrichment in the file are used.
| Command | Output details |
|---|---|
-w, --what-if | If true, reports what would be done but changes no files. |
-m, --mode | Specifies what kind of changes can be made. |
-d, --diff | Specifies which changes are written to stdout. If not specified, the environment variable UNIFORM_CLI_DIFF_MODE is used. If the environment variable isn't set, the default value is used. |
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Remove enrichment#
command Delete an enrichment definition from the Uniform project.
| Command | Output details |
|---|---|
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Manifests#
Get manifest#
command Download the Uniform Context manifest for the project. The output path is required; use -o or --output. You can use the download (or dl) alias instead of get.
| Command | Output details |
|---|---|
| -o, --output string (required) | Path to write the manifest file to. Defaults to UNIFORM_MANIFEST_PATH if set. |
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Publish manifest#
command Publish the manifest for the Uniform project.
-p, --project | Uniform project id. If not specified, the environment variable |
|---|---|
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Quirks#
Get quirk#
command
Fetch a quirk definition from the Uniform project.
| Command | Output details |
|---|---|
-f, --format | Format for the output (YAML or JSON) |
-o, --filename | File name for the output. If not specified the output is written to stdout. |
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
List quirks#
command
List quirk definitions from the Uniform project.
| Command | Output details |
|---|---|
--offset | Number of rows to skip before fetching. |
limit | Number of rows to fetch. |
| -f, --format string (optional, default value: YAML) | Format for the output. YAML JSON |
-o, --filename | File name for the output. If not specified the output is written to stdout. |
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Pull quirk#
command Fetch all quirk definitions from the Uniform project and save them locally.
- If you pass a directory, the CLI writes each of the quirks to its own file.
- If you pass a file path ending in
.yaml,.yml, or.json, the CLI writes all quirks to a single file.
| Command | Output details |
|---|---|
-w, --what-if | If true, reports what would be done but changes no files. |
-m, --mode | Specifies what kind of changes can be made. |
| -d, --diff string (optional, default value: off) | Specifies which changes are written to stdout. If not specified, the environment variable UNIFORM_CLI_DIFF_MODE is used. If the environment variable isn't set, the default value is used. off - No changes are written.update - Only update changes are written.on - Update, create, and delete changes are written. |
-f, --format | Format for the output (YAML or JSON) |
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Push quirk#
command Insert or update all quirk definitions from local disk to the Uniform project.
- If a directory path is specified, the quirks defined in the files in the directory used.
- If a file path is specified, the quirks in the file are used.
| Command | Output details |
|---|---|
-w, --what-if | If true, reports what would be done but changes no files. |
-m, --mode | Specifies what kind of changes can be made. |
-d, --diff | Specifies which changes are written to stdout. If not specified, the environment variable UNIFORM_CLI_DIFF_MODE is used. If the environment variable isn't set, the default value is used. |
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Remove quirk#
command Delete a quirk definition from the Uniform project.
| Command | Output details |
|---|---|
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Update quirk#
command Insert or update a quirk definition from a local file to the Uniform project.
| Command | Output details |
|---|---|
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Signals#
Get signal#
command
Fetch a signal definition from the Uniform project.
| Command | Output details |
|---|---|
-f, --format | Format for the output (YAML or JSON) |
-o, --filename | File name for the output. If not specified the output is written to stdout. |
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
List signals#
command
List signal definitions from the Uniform project.
| Command | Output details |
|---|---|
| -f, --format string (optional, default value: YAML) | Format for the output. YAML JSON |
-o, --filename | File name for the output. If not specified the output is written to stdout. |
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Pull signal#
command Fetch all signal definitions from the Uniform project and save them locally.
- If you pass a directory, the CLI writes each of the signals to its own file.
- If you pass a file path ending in
.yaml,.yml, or.json, the CLI writes all signals to a single file.
| Command | Output details |
|---|---|
-w, --what-if | If true, reports what would be done but changes no files. |
-m, --mode | Specifies what kind of changes can be made. |
| -d, --diff string (optional, default value: off) | Specifies which changes are written to stdout. If not specified, the environment variable UNIFORM_CLI_DIFF_MODE is used. If the environment variable isn't set, the default value is used. off - No changes are written.update - Only update changes are written.on - Update, create, and delete changes are written. |
-f, --format | Format for the output (YAML or JSON) |
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Push signal#
command Insert or update all signal definitions from local disk to the Uniform project.
- If a directory path is specified, the signals defined in the files in the directory used.
- If a file path is specified, the signals in the file are used.
| Command | Output details |
|---|---|
-w, --what-if | If true, reports what would be done but changes no files. |
-m, --mode | Specifies what kind of changes can be made. |
-d, --diff | Specifies which changes are written to stdout. If not specified, the environment variable UNIFORM_CLI_DIFF_MODE is used. If the environment variable isn't set, the default value is used. |
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Remove signal#
command Delete a signal definition from the Uniform project.
| Command | Output details |
|---|---|
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Update signal#
command Insert or update a signal definition from a local file to the Uniform project.
| Command | Output details |
|---|---|
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Tests#
Get test#
command
Fetch a test definition from the Uniform project.
| Command | Output details |
|---|---|
-f, --format | Format for the output (YAML or JSON) |
-o, --filename | File name for the output. If not specified the output is written to stdout. |
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
List tests#
command
List test definitions from the Uniform project.
| Command | Output details |
|---|---|
--offset | Number of rows to skip before fetching. |
limit | Number of rows to fetch. |
| -f, --format string (optional, default value: YAML) | Format for the output. YAML JSON |
-o, --filename | File name for the output. If not specified the output is written to stdout. |
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Pull test#
command Fetch all test definitions from the Uniform project and save them locally.
- If you pass a directory, the CLI writes each of the tests to its own file.
- If you pass a file path ending in
.yaml,.yml, or.json, the CLI writes all tests to a single file.
| Command | Output details |
|---|---|
-w, --what-if | If true, reports what would be done but changes no files. |
-m, --mode | Specifies what kind of changes can be made. |
| -d, --diff string (optional, default value: off) | Specifies which changes are written to stdout. If not specified, the environment variable UNIFORM_CLI_DIFF_MODE is used. If the environment variable isn't set, the default value is used. off - No changes are written.update - Only update changes are written.on - Update, create, and delete changes are written. |
-f, --format | Format for the output (YAML or JSON) |
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Push test#
command Insert or update all test definitions from local disk to the Uniform project.
- If a directory path is specified, the tests defined in the files in the directory used.
- If a file path is specified, the tests in the file are used.
| Command | Output details |
|---|---|
-w, --what-if | If true, reports what would be done but changes no files. |
-m, --mode | Specifies what kind of changes can be made. |
-d, --diff | Specifies which changes are written to stdout. If not specified, the environment variable UNIFORM_CLI_DIFF_MODE is used. If the environment variable isn't set, the default value is used. |
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Remove test#
command Delete a test definition from the Uniform project.
| Command | Output details |
|---|---|
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |
Update test#
command Insert or update a test definition from a local file to the Uniform project.
| Command | Output details |
|---|---|
-p, --project | Uniform project id. If not specified, the environment variable |
-f, --format | Uniform API key. If not specified, the environment variable |
--apiHost | Uniform host. If not specified, the environment variable |
--proxy | Proxy server. If not specified, the following environment variables are used (with the first match being used): |