Skip to content


smersh-cli made by respecting the CRUD standards, the command line is interactive and easy to use



Via Docker

This project includes a Dockerfile that you can build using the following command:

cd <project folder>
docker image build -t smershcli:v1.0 .

Once the image is built, you can simply run smersh-cli using the following command:

docker run -it <container id> <smersh api url>

Via Pip

You can also install the latest release directly from PyPI using the following command:

pip install smersh_cli


smersh-cli requires at least Python 3.5 because of the usage of typing (see PEP 484 for more information). However, we recommend Python 3.8 to avoid using a hack to get the project working (see issue #12). If you have an older Python version, you will need to upgrade as we won't support any version below 3.5.

smersh-cli also depends on the following libraries:

  • rich
  • cmd2
  • requests
  • dataclasses_json
  • pydantic
  • importlib_metadata

If you have setuptools installed you can use the following command to install all dependencies and the package at once:

python install

You can then use smersh-cli simply by using the command smersh-cli.


To run smersh-cli, you simply have to invoke the script with your SMERSH API url as one single argument:

python <smersh api url>

You will then be asked to enter your credentials before having an interactive command line interface (see below for an example).


smersh-cli implements every single builtin cmd2 command (see the cmd2 documentation for more information about these commands). However, please think twice before using commands like py or ipy because you can easily break something.

In addition to these commands, smersh-cli implements the following ones:

  • show
  • use
  • assign
  • save
  • upload
  • delete
  • exit

Please note that every command is documented. The documentation can be shown with the help command.


It is also possible to upload a file to add your entire scope. However, the file must be formatted like this:


Commands and contexts

Some commands require a 'context' to be used. This is the case for the assign, save and delete commands. A context is used to tell the program about which object the operation you want to perform refers to. To change the context you need to use the use command. You can see at any time which context is active thanks to the prompt of the interactive command line. In order to exit the active context, use the exit command (warning: every unsaved modification will be lost).