<![CDATA[
# DeviceAtlas Cloud Client 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.2.1
## 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.2.1 ##
The DeviceAtlas Cloud API version 2.2.1 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.2.1.
1. Replace the previous DeviceAtlas Cloud API "Client.py" file with installation of the source distribution package:
* deviceatlas-cloud-2.2.1.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.2.1/Api/deviceatlas-cloud-2.2.1.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 2025. All Rights Reserved. _
https://deviceatlas.com
<!-- HTML+JS for document formatting when opened in browser -->
<div class="btn-group" id="main-menu" style="float:right"><a class="btn dropdown-toggle" data-toggle="dropdown" href="#">Menu<span class="caret"></span></a><ul class="dropdown-menu"><li><a href="README.html">Cloud Client API</a></li><li><a href="README.Installation.html">Cloud Client API Installation</a></li><li class="disabled"><a href="README.Upgrade.html">Cloud Client API Upgrade</a></li><li><a href="README.Config.html">Cloud Client API Configuration</a></li><li><a href="./ApiDocs/index.html">DeviceAtlas Cloud Client API doc</a></li></ul></div>]]>