Using the CLI

This topic describes how to download, install and get acquainted with the Dis.co command-line interface (CLI). A full description of the Dis.co commands is provided in the CLI Reference. If you have not yet set up an account, please read the Quick Start Guide.

Install CLI

Install the Dis.co CLI from your terminal. Dis.co supports Python version 3.6 or higher.

Run:

$ pip install disco

Login to disco

disco login --user YOUR_EMAIL --password YOUR_PASSWORD

After successful login, you can add and run a new job.

Add and run a new job

disco job create --name YOUR_JOB_NAME --script YOUR_SCRIPT_FILE_PATH --run

Now you will see the job status as it is submitted and starts running.

Viewing the jobs status

To follow the job's status, run the view command

disco job view <job_id>

When the job is done you can download its results.

Download the result files

disco job download-results <job id> --destination YOUR_RESULTS_DESTINATION_PATH

More examples

Create job with multiple input files using wildcards:

disco job create -n jobName -s ~/jobs/primes/prime_finder.py -i "~/jobs/primes/Data/*"

or:

disco job create -n jobName -s ~/jobs/primes/prime_finder.py -i "~/jobs/primes/Data/Range*.txt"