New features:
- New function
pooch.retrieve
to fetch single files This is much more convenient than setting up aPooch
while retaining the hash checks and use of downloaders and processors. It automatically selects a unique file name and saves files to a cache folder. (#152) - Allow to use of different hashing algorithms (other than SHA256). Optionally specify the hash as
alg:hash
and allowpooch.Pooch
to recognize the algorithm when comparing hashes. Setting an algorithsm is optional and omiting it defaults to SHA256. This is particularly useful when data are coming from external sources and published hashes are already available. (#133)
Documentation:
- Add example for fetching datasets that change on the server, for which the hash check would always fail. (#144)
- Fix path examples in docstring of
pooch.os_cache
. The docstring mentioned the data path as examples instead of the cache path. (#140) - Add example of creating a registry when you don't have the data files locally and would have to download them manually. The example uses the
pooch.retrieve
function to automate the process. The example covers two cases: when all remote files share the same base URL and when every file has its own URL. (#161)
Maintenance:
- A lot of general refactoring of the internals of Pooch to facilitate development of the new
pooch.retrieve
function (#159 #157 #156 #151 #149)
This release contains contributions from:
- Leonardo Uieda
- Santiago Soler
- Kacper Kowalik
- Lucas Martin-King
- Zac Flamig