You can get started by installing packages you’re interested in working with. Once you have added all your packages, you can then push this a new ActiveState Platform Project, so you can easily collaborate with others, as well as use the full feature set of the platform, including a web based interface to work and collaborate on your project.
By default State Tool operates on a project in your cwd. Which is to say, it will look for an activestate.yaml in your current directory or its parent directories and uses the project defined in that file.
If no such activestate.yaml exists, running
state install will create a new
one in your current working directory. This is important to note, because if you
then run another
state install command in a different unrelated directory;
you will end up with two separate projects.
To install a new package run the following command:
state install pandas[@1.3.1]
Note that the version specification is optional. See the state install reference documentation for more info.
TIP: You can search for specific packages on the Platform using
state search subcommand. See the state search
reference documentation for usage information.
If your project already has packages defined for a different package manager then odds are you will be able to import these to the Platform by running:
state import requirements.txt
Some examples of supported package files:
See the state import reference documentation for usage information.
A Platform is essentially an Operating System on which you would like your project to run.
By default State Tool will use your current platform as the target platform for your requests. If you would like to target multiple platforms you can add these manually.
Let’s say you’re working on Linux, but you also want to target Windows. You can do this by invoking the following command.
state platforms add Windows
See the state platforms reference documentation for usage information.
Once you’ve installed some packages you’re now ready to turn your local-only virtual environment into an ActiveState Platform Project. This will allow you to share your virtual environment with other people or different runtime environments (eg. a staging or production environment).
To turn your local virtual environment into a project, run:
Then follow the prompts and instructions on screen.
See the state push reference documentation for usage information.
While you can run
state install without first activating your virtual environment,
in order to actually start working with your virtual environment you’ll need to
There are several ways of doing this, but they all utilize the
See the state activate reference documentation for usage information.
Change your current working directory to the directory containing your projects’
activestate.yaml (eg. the directory you ran
state install in). Then simply
This will activate the project under your current working directory.
If you followed the steps in this guide you will likely want to activate your project using this method.
You can activate a project simply by giving
state activate the “namespace” of
your project, that is; the owner name followed by the project name, eg.
To activate using this method, run the following command:
state activate <owner>/<projectName>
If you already had this project checked out locally State Tool will direct you to the correct local directory. If you had not checked it out locally then State Tool will perform a fresh checkout.
When you are finished working with your project, you can deactivate the
runtime environment for your project by entering
exit or pressing
to return to your regular shell environment.
When you want to work on your project again you can run the
state activate owner/projectName command from any directory and you’ll be
switched into an activated state under your project directory. Alternatively you
can manually move to the root of your project directory and run
without any other arguments.
Now that you have your project set up and the basics configured check out the following sections to further discover what you can do with the State Tool: