Nexla CLI

The Nexla CLI is a Python library that includes convenient methods for accessing Nexla resources and data from your Python development enviorment. Check out our Guide pages for some sample recipes on how to use Nexla CLI inside a Jupyter notebook.

Nexla CLI requires Python 3 development environment. Head over to Python.org for instructions on setting up Python in your development envionment.

Getting the CLI

Download

First, click on the button below to launch the page for fetching the latest version of Nexla CLI.

Head over to the Authentication section to see how to fetch the root path and access token for accessing Nexla API.

Install

Next, using your favorite command line tool, run the following command where you have saved your downloaded Nexla CLI pacakge, run:

Install Nexla CLI
pip install <nexla-cli-package-name>

That's it! You now have the latest Nexla CLI in your machine.

You can verify cli installation using below command

Check CLI installation
nexla --version
Sample Output
nexlacli.version=2.0.0
python.version=3.6.4
os.version=Darwin-16.7.0-x86_64-i386-64bit

Uninstall

Run the following command if you wish to uninstall Nexla CLI:

Uninstall Nexla CLI
pip uninstall nexla

Upgrade

To upgrade the CLI version, simply uninstall the version you have and then download & install the latest version of the CLI.

Environment

With Nexla CLI you can connect to different Nexla infrastructure environments you have access to. For most users this will be Nexla's production cloud instance where you have been provided a user account, but by managing environment settings you will be able to connect to any environment you have a Nexla UI account at.

Setup Environment

Run the command below to add a new envionment to your CLI instance. Note that this needs to be run only once per environment on your machine after installation of CLI.

Configure New Environment
-> nexla env configure

When executed, this command lists the environments you've already already configured and you will be prompted for the entering the new environment Name. This is simply the URL to your Nexla UI instance without the domain protocol. So if you access Nexla at https://dataops.nexla.io the Enironment Name will be dataops.nexla.io

Configure New Environment
-> nexla env configure
Available Environments:
- beta.nexla.com *
NEXLA Environment (ex:dataops.nexla.io): dataops.nexla.io
If your browser didn't open, please go to the following link:
https://dataops.nexla.io/token
Enter ACCESS TOKEN:

If the environment is succesfully configured then the message, "Environment Configured Successfully", is displayed. Otherwise the message, "Configuration Error: NEXLA Environment/NEXLA API Key is not valid", is displayed.

Switch Environment

Use this command to switch from one environment to another. This also lists the available environments and the current environment.

Swith Environment
-> nexla env switch
Current Environment: beta.nexla.com
Available Environments:
- test.nexla.com
- beta.nexla.com *
Choose from available environments (ex:test.nexla.com):

If the environment is succesfully changed then the message, "Environment changed to {new env}" Successfully", is displayed. Otherwise the message, "Enter Valid Environment Name !!", is displayed.