tetrascience-cli 1.4.0b0

Tetrascience CLI

ts-cli

Tetrascience CLI

Version

v1.3.3

Table of Contents

Show

• Install
• Usage
  • Create an artifact
  • Publish an artifact
    • API Configuration
    • IDS Validation
• Documentation
• Changelog

Intro

ts-cli allows you to interface with the Tetrascience Data Platform from the comfort of your shell

Example

Create and publish a new task script:

ts-cli config save ~/Downloads/ts-cfg.json
ts-cli init task-script
ts-cli publish

Install

pip install tetrascience-cli

Usage

Create an artifact

Using an IDS, Protocol, Task Script or "All-in-one" template

ts-cli init <template-type>

To set up the artifact's configuration interactively, use the --interactive or -i flag.

ts-cli init --interactive

Publish an artifact

Including IDS, Protocol, and Task Script artifacts from their source code

ts-cli publish

The artifact's type, namespace, slug and version are automatically read from its manifest.json file if it exists.
To set up the artifact's configuration interactively, use the --interative or -i flag. Examples:

ts-cli publish --interactive

API Configuration

An API configuration is required. This can be the API configuration JSON file (cfg.json) found on the Tetra Data Platform.

{
	"api_url": "https://api.tetrascience.com/v1",
	"auth_token": "your-token",
	"org": "your-org",
	"ignore_ssl": false
}

This configuration can be referred to explicitly in the command line. Example:

ts-cli publish --config cfg.json

Or saved to a specific profile.

ts-cli config save cfg.json --profile dev
ts-cli publish --profile dev

To apply the API configuration to all your projects automatically, save your configuration file globally

ts-cli config save cfg.json --global
ts-cli publish

IDS Validation

When uploading IDS artifact, validation will be performed using ts-ids-validator package. Validation failures for IDS will be printed to the console.

Documentation

Click here for --help and a development guide

Changelog

Show

v1.3.3

• update vulnerable dependencies
• update documentation

v1.3.2

• fix output of monitored build when no args provided (build from the artifact directory)

v1.3.1

• output {namespace, slug, version} when monitored build (via CodeBuild) completes

v1.3.0

• Rename the delete command to unpublish
• Display the number of other artifacts that depend on artifact that is to be unpublished
  • Example: warning: This protocol artifact is used by at least 1 pipeline

v1.2.0

• Allow publishing of connectors artifacts

v1.1.0

• Adjust publish to support Codebuild build_id in response for all artifact types

v1.0.5

• Fix incorrect messages to console when using ts-cli init --interactive

v1.0.4

• Add a delete command
• Remove extra <unset> strings in task script configurations

v1.0.3

• Rename the nodeType field to category in the tetraflow template
• Fix a crash on ts-cli config {save,set}
• Fix broken IDS schemas generated from non-existent manifest.json

v1.0.2

• Adds the dry-run flag to the publish cli

v1.0.1

• Fix a crash on startup

v1.0.0

• Initial release
• Includes the init, publish and config commands