IN THIS ARTICLE
Describes how to update your Python SDK
- Qumulo cluster
With Python 2.7's end of life now more than a year behind us, Qumulo has made the decision to discontinue support for Python 2.7 in our Python SDK and qq command line utility. Qumulo Core 4.0.0 is the final release for which we published a new Python 2.7 SDK. Starting with Qumulo Core 4.0.1, the Python SDK will only support Python 3.6+.
What does this mean for you? The Qumulo Core 4.0.0 Python 2.7 SDK will continue to be compatible with the Qumulo Core REST API in releases up until Qumulo Core 4.1.0, which should ship some time in May 2021. However, any new REST APIs published after Qumulo Core 4.0.0 is released will be unavailable in the Qumulo Core 4.0.0 Python 2.7 SDK. Any REST APIs marked as deprecated in Qumulo Core 4.0.0 and later will cease to work in the Python 2.7 SDK after Qumulo Core 4.1.0.
Note also that, starting with Qumulo Core 4.0.1, the standalone qq command line utility available via the API & Tools page in the cluster Web UI will require Python 3.6+ to be installed in order to run.
Upgrading to the Python 3.6 SDK
The Qumulo Python SDK has had support for Python 3.6+ since version 3.1.0, so even if your cluster isn't on the latest and greatest Qumulo Core version, you can likely start the process of transitioning your applications that leverage the Qumulo SDK to Python 3 now.
To install the Python 3.6 version of the Qumulo Python SDK, you can simply run the following command:
pip3 install qumulo_api==x.x.x
Replace "x.x.x" is the version of the SDK you wish to install. Qumulo recommends keeping the version of the SDK that you're using in sync with the version of your cluster.
We at Qumulo have undergone our own journey of converting our 4000+ file Python codebase from Python 2.7 to Python 3 and highly recommend the following tools:
- The future package, which aids in transitioning code from Python 2.7 to Python 3.
- mypy, which allows enforcement of static type checking in both Python 2.7 and Python 3 and is essential in ensuring that your refactoring is safe.
You should now be able to successfully upgrade your Python SDK
Like what you see? Share this article with your network!