You only need to go through this procedure once, before you can use the CDS API on macOS.
- Have a CDS account. If you don't have an account, please self register at the CDS registration page.
Option 1: use Python 2.Test Python 2 and install pip
- If you want to use Python 2, then it should come with your macOS. Open a Terminal and type command 'python'. You should see something like 'Python 2.7.10 (default, Feb 22 2019, 21:17:52)'. Type 'Control + D' to quit.
- For Python 2, run commands below to install pip:
- python get-pip.py
Option 2: use Python 3. You are recommended to follow instructions here using Homebrew.Install Python3 through Homebrew
- xcode-select --install
- /usr/bin/ruby -e "$(curl -fsSL w/install/master/install)"
- brew install python3
Option 2: use Python 3. You are recommended to follow instructions here using Homebrew.
Optional: you are recommended to set up a virtual environment. Python 3 comes up with this feature. For Python 2, you may want to use Virtualenv. This is out of the scope of this knowledge base article.
- Login to CDS and copy the 2 line code displayed on this page. The code shows a url and your own uid:API key.
- Run 'touch ~/.cdsapirc' in your Terminal to create your key file and copy the two lines you see in 1 to the file.
- Install the CDS API client using pip: 'pip install cdsapi'. You should run this under a Terminal.
If you are getting connection issues, we recommend that in the first instance you check your proxy settings with your local IT team.