Pooch

-------------

Released on: 2019/06/24

Maintenance:

* Add back support for Python 3.5 with continuous integration tests. No code changes
were needed, only removing the restriction from ``setup.py``.
(`93 <https://github.com/fatiando/pooch/pull/93>`__)

This release contains contributions from:

* Leonardo Uieda

-------------

Released on: 2019/05/21

Documentation fixes:

* Fix formatting error in ``pooch.Decompress`` docstring.
(`81 <https://github.com/fatiando/pooch/pull/81>`__)
* Fix wrong imports in the usage guide for post-processing hooks.
(`84 <https://github.com/fatiando/pooch/pull/84>`__)
* Add section to the usage guide explaining when to use ``pooch.Decompress``.
(`85 <https://github.com/fatiando/pooch/pull/85>`__)

This release contains contributions from:

* Santiago Soler
* Leonardo Uieda

-------------

Released on: 2019/05/20

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 :ref:`install`. (`78
<https://github.com/fatiando/pooch/pull/78>`__)
* New processor ``pooch.Untar`` unpacks files contained in a downloaded tar archive
(with or without compression). (`77 <https://github.com/fatiando/pooch/pull/77>`__)

This release contains contributions from:

* Matthew Turk
* Leonardo Uieda

-------------

Released on: 2019/05/01

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
<https://github.com/fatiando/pooch/pull/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 <https://github.com/fatiando/pooch/pull/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 <https://github.com/fatiando/pooch/pull/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
<https://github.com/fatiando/pooch/pull/69>`__)

Maintenance:

* Pin sphinx to version 1.8.5. New versions of Sphinx (2.0.*) are messing up the
numpydoc style docstrings. (`64 <https://github.com/fatiando/pooch/pull/64>`__)

This release contains contributions from:

* Santiago Soler
* Leonardo Uieda

-------------

Released on: 2019/03/28

Minor patches:

* Add a project logo (`57 <https://github.com/fatiando/pooch/pull/57>`__)
* Replace ``http`` with ``https`` in the ``README.rst`` to avoid mixed content warnings
in some browsers (`56 <https://github.com/fatiando/pooch/pull/56>`__)

-------------

Released on: 2019/03/27

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 <https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html>`__
(`45 <https://github.com/fatiando/pooch/pull/45>`__)
* Add method ``Pooch.is_available`` to check remote file availability
(`50 <https://github.com/fatiando/pooch/pull/50>`__)
* Add ``Pooch.registry_files`` property to get a name of all files in the registry
(`42 <https://github.com/fatiando/pooch/pull/42>`__)
* Make ``Pooch.get_url`` a public method to get the download URL for a given file
(`55 <https://github.com/fatiando/pooch/pull/55>`__)

Maintenance:

* **Drop support for Python 3.5**. Pooch now requires Python >= 3.6.
(`52 <https://github.com/fatiando/pooch/pull/52>`__)
* Add a private method to check if a file is in the registry (`49 <https://github.com/fatiando/pooch/pull/49>`__)
* Fix typo in the ``Pooch.load_registry`` docstring (`41 <https://github.com/fatiando/pooch/pull/41>`__)

This release contains contributions from:

* Santiago Soler
* Rémi Rampin
* Leonardo Uieda