Quick Start: State Tool CLI

This quick start is for intermediate or advanced developers who want to get up and running right away.

Install the State Tool

On Linux:

sh <(curl -q https://platform.activestate.com/dl/cli/install.sh)

On Windows:

  1. Run the following as Administrator in PowerShell:

    IEX(New-Object Net.WebClient).downloadString('https://platform.activestate.com/dl/cli/install.ps1')
    
  2. Start the command prompt (cmd.exe) to use the State Tool.

Sign in to the ActiveState Platform

If you don’t have a Platform account yet, you need to sign up:

state auth signup 

Enter the requested information at the prompt to register your account. You will receive an email to verify your account. You have limited permissions to the Platform before you verify it. After registering your account you can sign in.

If you already have an ActiveState Platform account, or you just created an account you need to sign in:

state auth

Enter your username and password for the Platform at the prompts.

Create a new project locally

state init <username_or_org_name>/<project_name> language@version

For example:

state init jsmith/python-3-6 python3@3.6.6

Change directories into your project folder

Linux:

cd <username_or_org_name>/<project_name>

Windows:

cd <username_or_org_name>\<project_name>

Push your project to the ActiveState Platform

state push

Add required packages for your project

state packages add requests@2.21.0
state packages add pandas

If you have a requirements.txt file for your Python project, you can alternatively import all your packages using the file.

state packages import --file requirements.txt

Synchronize your local project with the Platform project

state pull

Activate your project

state activate

Access documentation for CLI commands

To learn more about the State Tool commands, run state –help in the terminal.

For help on individual commands, run state COMMAND --help. For example, state packages --help.

For more information on the State Tool and the available commands see the State Tool section of the docs.