# DeviceAtlas Cloud API Upgrade #
This document is intended for users of API versions 1.4.1 and below. It has two main sections:
1. Why upgrade?
2. Upgrading from 1.4.1 to 2.0.0
## Why upgrade? ##
Version 2.0.0 and higher of the API provides support for Unicode input. In addition, the pip Python package manager now
handles the package installation.
## Upgrading to 2.0.0 ##
The DeviceAtlas Cloud API version 2.0.0 is shipped with a different interface than previous versions.
This shows the steps to upgrade a system which is currently using a DeviceAtlas Cloud API prior to version 2.0.0.
1. Replace the previous DeviceAtlas Cloud API "Client.py" file with installation of the source distribution package:
* deviceatlas-cloud-2.0.0.zip
This package contains the new namespace "deviceatlas.cloud.device".
2. Install the API using the pip package installer.
```shell
$ pip install deviceatlas-cloud-python-2.0.0.0/Api/deviceatlas-cloud-2.0.0.zip
```
3. References to the API change. The previous import must be replace with the one shown below.
```python
# Previously
sys.path.append('/path/to/the/Api')
from Client import Client
# Now
from deviceatlas.cloud.device import Client
```
4. Creating an instance and set the licence key.
```python
client = Client()
client.LICENCE_KEY = 'ENTER-YOUR-LICENCE-KEY'
```
You can also change the default API behavior:
```python
client.USE_FILE_CACHE = False
# Check out the documentation for further details.
```
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
_ Copyright (c) DeviceAtlas Limited 2021. All Rights Reserved. _
https://deviceatlas.com