Pooch

Documentation fixes:

* Fix formatting error in pooch.Decompress docstring. (81)
* Fix wrong imports in the usage guide for post-processing hooks. (84)
* Add section to the usage guide explaining when to use pooch.Decompress. (85)

This release contains contributions from:

* Santiago Soler
* Leonardo Uieda

New features:

* New processor pooch.Decompress saves a decompressed version of the downloaded file. Supports gzip, lzma/xz, and bzip2 compression. Note: Under Python 2.7, lzma and bzip2 require the backports.lzma and bz2file packages as well. These are soft dependencies and not required to use Pooch. See Installing. (78)
* New processor pooch.Untar unpacks files contained in a downloaded tar archive (with or without compression). (77)

This release contains contributions from:

* Matthew Turk
* Leonardo Uieda

New features:

* Add customizable downloaders. Delegate file download into separate classes that can be passed to Pooch.fetch. Created the HTTPDownloader class (used by default) which can also be used to download files that require authentication/login. (66)
* Add post-download processor hooks to Pooch.fetch. Allows users to pass in a function that is executed right before returning and can overwrite the file path that is returned by fetch. Use this, for example, to perform unpacking/decompression operations on larger files that can be time consuming and we only want to do once. (59)
* Add the Unzip post-download processor to extract files from a downloaded zip archive. Unpacks files into a directory in the local store and returns a list of all unzipped files. (72)
* Make the check_version function public. It’s used internally but will be useful in examples that want to download things from the pooch repository. (69)

Maintenance:

* Pin sphinx to version 1.8.5. New versions of Sphinx (`2.0.*`) are messing up the numpydoc style docstrings. (64)

This release contains contributions from:

* Santiago Soler
* Leonardo Uieda

Minor patches:

* Add a project logo (57)
* Replace http with https in the README.rst to avoid mixed content warnings in some browsers (56)

New features:

* Use the appdirs library to get the cache directory. Could change the default data location on all platforms. Locations are compatible with the XDG Base Directory Specification (45)
* Add method Pooch.is_available to check remote file availability (50)
* Add Pooch.registry_files property to get a name of all files in the registry (42)
* Make Pooch.get_url a public method to get the download URL for a given file (55)

Maintenance:

* Drop support for Python 3.5. Pooch now requires Python >= 3.6. (52)
* Add a private method to check if a file is in the registry (49)
* Fix typo in the Pooch.load_registry docstring (41)

This release contains contributions from:

* Santiago Soler
* Rémi Rampin
* Leonardo Uieda

Bug fixes:

* Fix unwanted `~` directory creation when not using a version in `pooch.create` (37)