Tutorial 5: Data and package updates¶
The datasets that cptac
distributes are still being actively worked on by the teams that generated them. Additionally, we periodically make improvements to the cptac
package itself. Thus, we regularly release new versions of the data and the package. This tutorial will go over how to access both those data and package updates.
Note: In this tutorial, we intentionally get cptac
to generate the various errors and warnings it gives when your data or package is out of date. We do this on purpose, so you can see what it looks like; the tutorial is not broken.
Updating the package¶
Each time you import cptac
into a Python environment, it automatically checks whether you have the most recent release of the package. If you don't, it will print a warning like this:
import cptac
cptac warning: Your version of cptac (1.5.1) is out-of-date. Latest is 1.5.0. Please run 'pip install --upgrade cptac' to update it. (C:\Users\sabme\anaconda3\lib\threading.py, line 910)
As the warning directs, simply run pip install --upgrade cptac
to get the latest version of the package. This will ensure that you have all the latest functionality of the package, and that you're able to access the latest versions of all the datasets.
Watching the repository for new releases¶
Each time there's a new version of the package, we release the new version on PyPI, and also post a release page on GitHub. You can use GitHub's "Watch" feature to get an email sent to you every time we do this. Simply log in to GitHub, browse to the main page for our repository, click on the "Watch" button in the upper right corner of the page, and select the "Releases only" option from the drop-down box, as shown below. You will then get an email every time we release another version of the package.