pax_global_header 0000666 0000000 0000000 00000000064 14630363143 0014515 g ustar 00root root 0000000 0000000 52 comment=dfc69386753e3793b6960301a00c90b71656bf6f
pooch-1.8.2/ 0000775 0000000 0000000 00000000000 14630363143 0012635 5 ustar 00root root 0000000 0000000 pooch-1.8.2/.codecov.yml 0000664 0000000 0000000 00000000331 14630363143 0015055 0 ustar 00root root 0000000 0000000 codecov:
notify:
require_ci_to_pass: no
coverage:
status:
patch:
default:
target: '80'
if_no_uploads: error
if_not_found: success
if_ci_failed: failure
comment: off
pooch-1.8.2/.coveragerc 0000664 0000000 0000000 00000000077 14630363143 0014762 0 ustar 00root root 0000000 0000000 [run]
omit =
*/tests/*
*/_version.py
*/__init__.py
pooch-1.8.2/.flake8 0000664 0000000 0000000 00000000136 14630363143 0014010 0 ustar 00root root 0000000 0000000 [flake8]
ignore = E203, E266, E501, W503, F401, E741
max-line-length = 88
max-doc-length = 79
pooch-1.8.2/.gitattributes 0000664 0000000 0000000 00000000325 14630363143 0015530 0 ustar 00root root 0000000 0000000 # Set the default behavior, in case people don't have core.autocrlf set.
* text=auto
# Declare test data files that will always have LF line endings on checkout (even on Windows).
pooch/tests/data/** text eol=lf
pooch-1.8.2/.github/ 0000775 0000000 0000000 00000000000 14630363143 0014175 5 ustar 00root root 0000000 0000000 pooch-1.8.2/.github/dependabot.yml 0000664 0000000 0000000 00000000672 14630363143 0017032 0 ustar 00root root 0000000 0000000 # To get started with Dependabot version updates, you'll need to specify which
# package ecosystems to update and where the package manifests are located.
# Please see the documentation for all configuration options:
# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
version: 2
updates:
- package-ecosystem: "github-actions"
directory: "/"
schedule:
interval: "weekly"
pooch-1.8.2/.github/workflows/ 0000775 0000000 0000000 00000000000 14630363143 0016232 5 ustar 00root root 0000000 0000000 pooch-1.8.2/.github/workflows/docs.yml 0000664 0000000 0000000 00000015567 14630363143 0017723 0 ustar 00root root 0000000 0000000 # Build the documentation and deploy to GitHub Pages using GitHub Actions.
#
# NOTE: Pin actions to a specific commit to avoid having the authentication
# token stolen if the Action is compromised. See the comments and links here:
# https://github.com/pypa/gh-action-pypi-publish/issues/27
#
name: documentation
# Only build PRs, the main branch, and releases. Pushes to branches will only
# be built when a PR is opened. This avoids duplicated buids in PRs comming
# from branches in the origin repository (1 for PR and 1 for push).
on:
pull_request:
push:
branches:
- main
release:
types:
- published
# Use bash by default in all jobs
defaults:
run:
shell: bash
jobs:
#############################################################################
# Build the docs
build:
runs-on: ubuntu-latest
env:
REQUIREMENTS: env/requirements-build.txt env/requirements-docs.txt
steps:
# Cancel any previous run of the test job
# We pin the commit hash corresponding to v0.5.0, and not pinning the tag
# because we are giving full access through the github.token.
- name: Cancel Previous Runs
uses: styfle/cancel-workflow-action@0.12.1
with:
access_token: ${{ github.token }}
# Checks-out your repository under $GITHUB_WORKSPACE
- name: Checkout
uses: actions/checkout@v4
with:
# Need to fetch more than the last commit so that setuptools-scm can
# create the correct version string. If the number of commits since
# the last release is greater than this, the version still be wrong.
# Increase if necessary.
fetch-depth: 100
# The GitHub token is preserved by default but this job doesn't need
# to be able to push to GitHub.
persist-credentials: false
# Need the tags so that setuptools-scm can form a valid version number
- name: Fetch git tags
run: git fetch origin 'refs/tags/*:refs/tags/*'
- name: Setup Python
uses: actions/setup-python@v5
with:
python-version: "3.x"
- name: Collect requirements
run: |
echo "Install Dependente to capture dependencies:"
python -m pip install dependente==0.3.0
echo ""
echo "Capturing run-time dependencies:"
dependente --source install,extras > requirements-full.txt
echo ""
echo "Capturing dependencies from:"
for requirement in $REQUIREMENTS
do
echo " $requirement"
cat $requirement >> requirements-full.txt
done
echo ""
echo "Collected dependencies:"
cat requirements-full.txt
- name: Get the pip cache folder
id: pip-cache
run: |
echo "::set-output name=dir::$(pip cache dir)"
- name: Setup caching for pip packages
uses: actions/cache@v4
with:
path: ${{ steps.pip-cache.outputs.dir }}
key: ${{ runner.os }}-pip-${{ hashFiles('requirements-full.txt') }}
- name: Install requirements
run: |
python -m pip install --requirement requirements-full.txt
- name: List installed packages
run: python -m pip freeze
- name: Build source and wheel distributions
run: |
make build
echo ""
echo "Generated files:"
ls -lh dist/
- name: Install the package
run: python -m pip install dist/*.whl
- name: Build the documentation
run: make -C doc clean all
# Store the docs as a build artifact so we can deploy it later
- name: Upload HTML documentation as an artifact
uses: actions/upload-artifact@v4
with:
name: docs-${{ github.sha }}
path: doc/_build/html
#############################################################################
# Publish the documentation to gh-pages
publish:
runs-on: ubuntu-latest
needs: build
if: github.event_name == 'release' || github.event_name == 'push'
steps:
- name: Checkout
uses: actions/checkout@v4
# Fetch the built docs from the "build" job
- name: Download HTML documentation artifact
uses: actions/download-artifact@v4
with:
name: docs-${{ github.sha }}
path: doc/_build/html
- name: Checkout the gh-pages branch in a separate folder
uses: actions/checkout@v4
with:
ref: gh-pages
# Checkout to this folder instead of the current one
path: deploy
# Download the entire history
fetch-depth: 0
- name: Push the built HTML to gh-pages
run: |
# Detect if this is a release or from the main branch
if [[ "${{ github.event_name }}" == "release" ]]; then
# Get the tag name without the "refs/tags/" part
version="${GITHUB_REF#refs/*/}"
else
version=dev
fi
echo "Deploying version: $version"
# Make the new commit message. Needs to happen before cd into deploy
# to get the right commit hash.
message="Deploy $version from $(git rev-parse --short HEAD)"
cd deploy
# Need to have this file so that Github doesn't try to run Jekyll
touch .nojekyll
# Delete all the files and replace with our new set
echo -e "\nRemoving old files from previous builds of ${version}:"
rm -rvf ${version}
echo -e "\nCopying HTML files to ${version}:"
cp -Rvf ../doc/_build/html/ ${version}/
# If this is a new release, update the link from /latest to it
if [[ "${version}" != "dev" ]]; then
echo -e "\nSetup link from ${version} to 'latest'."
rm -f latest
ln -sf ${version} latest
fi
# Stage the commit
git add -A .
echo -e "\nChanges to be applied:"
git status
# Configure git to be the GitHub Actions account
git config user.email "github-actions[bot]@users.noreply.github.com"
git config user.name "github-actions[bot]"
# If this is a dev build and the last commit was from a dev build
# (detect if "dev" was in the previous commit message), reuse the
# same commit
if [[ "${version}" == "dev" && `git log -1 --format='%s'` == *"dev"* ]]; then
echo -e "\nAmending last commit:"
git commit --amend --reset-author -m "$message"
else
echo -e "\nMaking a new commit:"
git commit -m "$message"
fi
# Make the push quiet just in case there is anything that could leak
# sensitive information.
echo -e "\nPushing changes to gh-pages."
git push -fq origin gh-pages 2>&1 >/dev/null
echo -e "\nFinished uploading generated files."
pooch-1.8.2/.github/workflows/pypi.yml 0000664 0000000 0000000 00000010233 14630363143 0017735 0 ustar 00root root 0000000 0000000 # Publish archives to PyPI and TestPyPI using GitHub Actions.
#
# NOTE: Pin actions to a specific commit to avoid having the authentication
# token stolen if the Action is compromised. See the comments and links here:
# https://github.com/pypa/gh-action-pypi-publish/issues/27
#
name: pypi
on:
pull_request:
push:
branches:
- main
release:
types:
- published
# Use bash by default in all jobs
defaults:
run:
shell: bash
jobs:
#############################################################################
# Build and check wheels and source distrubutions
build:
runs-on: ubuntu-latest
steps:
# Checks-out your repository under $GITHUB_WORKSPACE
- name: Checkout
uses: actions/checkout@v4
with:
# Need to fetch more than the last commit so that setuptools_scm can
# create the correct version string. If the number of commits since
# the last release is greater than this, the version will still be
# wrong. Increase if necessary.
fetch-depth: 100
# The GitHub token is preserved by default but this job doesn't need
# to be able to push to GitHub.
persist-credentials: false
# Need the tags so that setuptools-scm can form a valid version number
- name: Fetch git tags
run: git fetch origin 'refs/tags/*:refs/tags/*'
- name: Setup Python
uses: actions/setup-python@v5
with:
python-version: "3.x"
- name: Install requirements
run: |
python -m pip install -r env/requirements-build.txt
python -m pip install twine
- name: List installed packages
run: python -m pip freeze
- name: Don't use local version numbers for TestPyPI uploads
if: github.event_name != 'release'
run: |
# Change setuptools-scm local_scheme to "no-local-version" so the
# local part of the version isn't included, making the version string
# compatible with Test PyPI.
sed --in-place "s/node-and-date/no-local-version/g" pyproject.toml
- name: Build source and wheel distributions
run: |
make build
echo ""
echo "Generated files:"
ls -lh dist/
- name: Check the archives
run: twine check dist/*
# Store the archives as a build artifact so we can deploy them later
- name: Upload archives as artifacts
# Only if not a pull request
if: success() && github.event_name != 'pull_request'
uses: actions/upload-artifact@v4
with:
name: pypi-${{ github.sha }}
path: dist
#############################################################################
# Publish built wheels and source archives to PyPI and test PyPI
publish:
runs-on: ubuntu-latest
needs: build
# Only publish from the origin repository, not forks
if: github.repository_owner == 'fatiando' && github.event_name != 'pull_request'
environment: pypi
permissions:
# This permission allows trusted publishing to PyPI (without an API token)
id-token: write
steps:
- name: Checkout
uses: actions/checkout@v4
with:
# The GitHub token is preserved by default but this job doesn't need
# to be able to push to GitHub.
persist-credentials: false
# Fetch the built archives from the "build" job
- name: Download built archives artifact
uses: actions/download-artifact@v4
with:
name: pypi-${{ github.sha }}
path: dist
- name: Publish to Test PyPI
# Only publish to TestPyPI when a PR is merged (pushed to main)
if: success() && github.event_name == 'push'
uses: pypa/gh-action-pypi-publish@v1.8.14
with:
repository_url: https://test.pypi.org/legacy/
# Allow existing releases on test PyPI without errors.
# NOT TO BE USED in PyPI!
skip_existing: true
- name: Publish to PyPI
# Only publish to PyPI when a release triggers the build
if: success() && github.event_name == 'release'
uses: pypa/gh-action-pypi-publish@v1.8.14
pooch-1.8.2/.github/workflows/style.yml 0000664 0000000 0000000 00000003000 14630363143 0020106 0 ustar 00root root 0000000 0000000 # Linting and style checks with GitHub Actions
#
# NOTE: Pin actions to a specific commit to avoid having the authentication
# token stolen if the Action is compromised. See the comments and links here:
# https://github.com/pypa/gh-action-pypi-publish/issues/27
#
name: checks
# Only build PRs and the main branch. Pushes to branches will only be built
# when a PR is opened.
on:
pull_request:
push:
branches:
- main
###############################################################################
jobs:
format:
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4
with:
persist-credentials: false
- name: Setup Python
uses: actions/setup-python@v5
with:
python-version: "3.10"
- name: Install requirements
run: python -m pip install -r env/requirements-style.txt
- name: List installed packages
run: python -m pip freeze
- name: Check code format
run: make check-format
style:
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4
with:
persist-credentials: false
- name: Setup Python
uses: actions/setup-python@v5
with:
python-version: "3.10"
- name: Install requirements
run: python -m pip install -r env/requirements-style.txt
- name: List installed packages
run: python -m pip freeze
- name: Check code style
run: make check-style lint
pooch-1.8.2/.github/workflows/test.yml 0000664 0000000 0000000 00000013103 14630363143 0017732 0 ustar 00root root 0000000 0000000 # Run tests and upload to Codecov with GitHub Actions
#
# NOTE: Pin actions to a specific commit to avoid having the authentication
# token stolen if the Action is compromised. See the comments and links here:
# https://github.com/pypa/gh-action-pypi-publish/issues/27
#
name: test
# Only build PRs, the main branch, and releases. Pushes to branches will only
# be built when a PR is opened. This avoids duplicated buids in PRs comming
# from branches in the origin repository (1 for PR and 1 for push).
on:
pull_request:
push:
branches:
- main
release:
types:
- published
# Use bash by default in all jobs
defaults:
run:
shell: bash
jobs:
#############################################################################
# Run tests and upload to codecov
test:
name: ${{ matrix.os }} python=${{ matrix.python }} dependencies=${{ matrix.dependencies }}
if: ${{ github.repository_owner == 'fatiando' || github.event_name != 'schedule' }}
runs-on: ${{ matrix.os }}
strategy:
# Otherwise, the workflow would stop if a single job fails. We want to
# run all of them to catch failures in different combinations.
fail-fast: false
matrix:
os:
- ubuntu-latest
- macos-latest
- windows-latest
dependencies:
- oldest
- latest
- optional
include:
- dependencies: oldest
python: "3.7"
- dependencies: latest
python: "3.11"
- dependencies: optional
python: "3.11"
# test on macos-13 (x86) using oldest dependencies and python 3.7
- os: macos-13
dependencies: oldest
python: "3.7"
exclude:
# don't test on macos-latest (arm64) with oldest dependencies
- os: macos-latest
dependencies: oldest
env:
REQUIREMENTS: env/requirements-build.txt env/requirements-test.txt
# Used to tag codecov submissions
OS: ${{ matrix.os }}
PYTHON: ${{ matrix.python }}
DEPENDENCIES: ${{ matrix.dependencies }}
steps:
# Cancel any previous run of the test job
# We pin the commit hash corresponding to v0.5.0, and not pinning the tag
# because we are giving full access through the github.token.
- name: Cancel Previous Runs
uses: styfle/cancel-workflow-action@0.12.1
with:
access_token: ${{ github.token }}
# Checks-out your repository under $GITHUB_WORKSPACE
- name: Checkout
uses: actions/checkout@v4
with:
# Need to fetch more than the last commit so that setuptools-scm can
# create the correct version string. If the number of commits since
# the last release is greater than this, the version still be wrong.
# Increase if necessary.
fetch-depth: 100
# The GitHub token is preserved by default but this job doesn't need
# to be able to push to GitHub.
persist-credentials: false
# Need the tags so that setuptools-scm can form a valid version number
- name: Fetch git tags
run: git fetch origin 'refs/tags/*:refs/tags/*'
- name: Setup Python
uses: actions/setup-python@v5
with:
python-version: ${{ matrix.python }}
- name: Collect requirements
run: |
echo "Install Dependente to capture dependencies:"
python -m pip install dependente==0.3.0
echo ""
dependente_args="--source install"
if [[ "${{ matrix.dependencies }}" == "oldest" ]]; then
dependente_args="--oldest --source install,extras"
fi
if [[ "${{ matrix.dependencies }}" == "optional" ]]; then
dependente_args="--source install,extras"
fi
echo "Capturing run-time dependencies:"
dependente $dependente_args > requirements-full.txt
echo ""
echo "Capturing dependencies from:"
for requirement in $REQUIREMENTS
do
echo " $requirement"
cat $requirement >> requirements-full.txt
done
echo ""
echo "Collected dependencies:"
cat requirements-full.txt
- name: Get the pip cache folder
id: pip-cache
run: |
echo "::set-output name=dir::$(pip cache dir)"
- name: Setup caching for pip packages
uses: actions/cache@v4
with:
path: ${{ steps.pip-cache.outputs.dir }}
key: ${{ runner.os }}-pip-${{ hashFiles('requirements-full.txt') }}
- name: Install requirements
run: |
python -m pip install --requirement requirements-full.txt
- name: Build source and wheel distributions
run: |
make build
echo ""
echo "Generated files:"
ls -lh dist/
- name: Install the package
run: python -m pip install --no-deps dist/*.whl
- name: List installed packages
run: python -m pip freeze
- name: Run the tests
run: make test
- name: Convert coverage report to XML for codecov
run: coverage xml
- name: Upload coverage to Codecov
uses: codecov/codecov-action@v4
with:
files: ./coverage.xml
env_vars: OS,PYTHON,DEPENDENCIES
# Don't mark the job as failed if the upload fails for some reason.
# It does sometimes but shouldn't be the reason for running
# everything again unless something else is broken.
fail_ci_if_error: false
env:
CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
pooch-1.8.2/.gitignore 0000664 0000000 0000000 00000000252 14630363143 0014624 0 ustar 00root root 0000000 0000000 *.pyc
*~
*.so
*.pyd
.pytest_cache/
build/
dist/
.*.swp
.coverage
.cache
doc/_build
doc/api/generated
.ipynb_checkpoints
*.egg-info
MANIFEST
.coverage.*
pooch/_version.py
pooch-1.8.2/.pylintrc 0000664 0000000 0000000 00000030450 14630363143 0014504 0 ustar 00root root 0000000 0000000 [MASTER]
# A comma-separated list of package or module names from where C extensions may
# be loaded. Extensions are loading into the active Python interpreter and may
# run arbitrary code
extension-pkg-whitelist=
# Add files or directories to the blacklist. They should be base names, not
# paths.
ignore=CVS,_version.py
# Add files or directories matching the regex patterns to the blacklist. The
# regex matches against base names, not paths.
ignore-patterns=
# Python code to execute, usually for sys.path manipulation such as
# pygtk.require().
#init-hook=
# Use multiple processes to speed up Pylint.
jobs=1
# List of plugins (as comma separated values of python modules names) to load,
# usually to register additional checkers.
load-plugins=
# Pickle collected data for later comparisons.
persistent=yes
# Specify a configuration file.
#rcfile=
# Allow loading of arbitrary C extensions. Extensions are imported into the
# active Python interpreter and may run arbitrary code.
unsafe-load-any-extension=no
[MESSAGES CONTROL]
# Only show warnings with the listed confidence levels. Leave empty to show
# all. Valid levels: HIGH, INFERENCE, INFERENCE_FAILURE, UNDEFINED
confidence=
# Disable the message, report, category or checker with the given id(s). You
# can either give multiple identifiers separated by comma (,) or put this
# option multiple times (only on the command line, not in the configuration
# file where it should appear only once).You can also use "--disable=all" to
# disable everything first and then reenable specific checks. For example, if
# you want to run only the similarities checker, you can use "--disable=all
# --enable=similarities". If you want to run only the classes checker, but have
# no Warning level messages displayed, use"--disable=all --enable=classes
# --disable=W"
disable=raw-checker-failed,bad-inline-option,locally-disabled,file-ignored,suppressed-message,deprecated-pragma,attribute-defined-outside-init,similarities,,import-error
# Enable the message, report, category or checker with the given id(s). You can
# either give multiple identifier separated by comma (,) or put this option
# multiple time (only on the command line, not in the configuration file where
# it should appear only once). See also the "--disable" option for examples.
enable=
[REPORTS]
# Python expression which should return a note less than 10 (10 is the highest
# note). You have access to the variables errors warning, statement which
# respectively contain the number of errors / warnings messages and the total
# number of statements analyzed. This is used by the global evaluation report
# (RP0004).
evaluation=10.0 - ((float(5 * error + warning + refactor + convention) / statement) * 10)
# Template used to display messages. This is a python new-style format string
# used to format the message information. See doc for all details
#msg-template=
# Set the output format. Available formats are text, parseable, colorized, json
# and msvs (visual studio).You can also give a reporter class, eg
# mypackage.mymodule.MyReporterClass.
output-format=text
# Tells whether to display a full report or only the messages
reports=no
# Activate the evaluation score.
score=yes
[REFACTORING]
# Maximum number of nested blocks for function / method body
max-nested-blocks=5
[FORMAT]
# Expected format of line ending, e.g. empty (any line ending), LF or CRLF.
expected-line-ending-format=
# Regexp for a line that is allowed to be longer than the limit.
ignore-long-lines=^\s*(# )??$
# Number of spaces of indent required inside a hanging or continued line.
indent-after-paren=4
# String used as indentation unit. This is usually " " (4 spaces) or "\t" (1
# tab).
indent-string=' '
# Maximum number of characters on a single line.
max-line-length=100
# Maximum number of lines in a module
max-module-lines=2000
# Allow the body of a class to be on the same line as the declaration if body
# contains single statement.
single-line-class-stmt=no
# Allow the body of an if to be on the same line as the test if there is no
# else.
single-line-if-stmt=no
[VARIABLES]
# List of additional names supposed to be defined in builtins. Remember that
# you should avoid to define new builtins when possible.
additional-builtins=
# Tells whether unused global variables should be treated as a violation.
allow-global-unused-variables=yes
# List of strings which can identify a callback function by name. A callback
# name must start or end with one of those strings.
callbacks=cb_,_cb
# A regular expression matching the name of dummy variables (i.e. expectedly
# not used).
dummy-variables-rgx=_+$|(_[a-zA-Z0-9_]*[a-zA-Z0-9]+?$)|dummy|^ignored_|^unused_
# Argument names that match this expression will be ignored. Default to name
# with leading underscore
ignored-argument-names=_.*|^ignored_|^unused_
# Tells whether we should check for unused import in __init__ files.
init-import=no
# List of qualified module names which can have objects that can redefine
# builtins.
redefining-builtins-modules=six.moves,future.builtins
[SIMILARITIES]
# Ignore comments when computing similarities.
ignore-comments=yes
# Ignore docstrings when computing similarities.
ignore-docstrings=yes
# Ignore imports when computing similarities.
ignore-imports=yes
# Minimum lines number of a similarity.
min-similarity-lines=3
[LOGGING]
# Logging modules to check that the string format arguments are in logging
# function parameter format
logging-modules=logging
[SPELLING]
# Spelling dictionary name. Available dictionaries: none. To make it working
# install python-enchant package.
spelling-dict=
# List of comma separated words that should not be checked.
spelling-ignore-words=
# A path to a file that contains private dictionary; one word per line.
spelling-private-dict-file=
# Tells whether to store unknown words to indicated private dictionary in
# --spelling-private-dict-file option instead of raising a message.
spelling-store-unknown-words=no
[BASIC]
# Regular expression matching correct argument names
argument-rgx=(([a-z][a-z0-9_]{2,30})|(_[a-z0-9_]*))$
# Regular expression matching correct attribute names
attr-rgx=(([a-z][a-z0-9_]{2,30})|(_[a-z0-9_]*))$
# Bad variable names which should always be refused, separated by a comma
bad-names=foo,bar,baz,toto,tutu,tata
# Regular expression matching correct class attribute names
class-attribute-rgx=([A-Za-z_][A-Za-z0-9_]{2,30}|(__.*__))$
# Regular expression matching correct class names
class-rgx=[A-Z_][a-zA-Z0-9]+$
# Regular expression matching correct constant names
const-rgx=(([A-Z_][A-Z0-9_]*)|(__.*__))$
# Minimum line length for functions/classes that require docstrings, shorter
# ones are exempt.
docstring-min-length=-1
# Regular expression matching correct function names
function-rgx=(([a-z][a-z0-9_]{2,50})|(_[a-z0-9_]*))$
# Good variable names which should always be accepted, separated by a comma
good-names=i,j,k,w,e,s,n,x,y,z,cv,ax
# Include a hint for the correct naming format with invalid-name
include-naming-hint=no
# Regular expression matching correct inline iteration names
inlinevar-rgx=[A-Za-z_][A-Za-z0-9_]*$
# Regular expression matching correct method names
method-rgx=(([a-z][a-z0-9_]{2,30})|(_[a-z0-9_]*))$
# Regular expression matching correct module names
module-rgx=(([a-z_][a-z0-9_]*)|([A-Z][a-zA-Z0-9]+))$
# Colon-delimited sets of names that determine each other's naming style when
# the name regexes allow several styles.
name-group=
# Regular expression which should only match function or class names that do
# not require a docstring.
no-docstring-rgx=^_
# List of decorators that produce properties, such as abc.abstractproperty. Add
# to this list to register other decorators that produce valid properties.
property-classes=abc.abstractproperty
# Regular expression matching correct variable names
variable-rgx=(([a-z][a-z0-9_]{2,30})|(_[a-z0-9_]*))$
[TYPECHECK]
# List of decorators that produce context managers, such as
# contextlib.contextmanager. Add to this list to register other decorators that
# produce valid context managers.
contextmanager-decorators=contextlib.contextmanager
# List of members which are set dynamically and missed by pylint inference
# system, and so shouldn't trigger E1101 when accessed. Python regular
# expressions are accepted.
generated-members=
# Tells whether missing members accessed in mixin class should be ignored. A
# mixin class is detected if its name ends with "mixin" (case insensitive).
ignore-mixin-members=yes
# This flag controls whether pylint should warn about no-member and similar
# checks whenever an opaque object is returned when inferring. The inference
# can return multiple potential results while evaluating a Python object, but
# some branches might not be evaluated, which results in partial inference. In
# that case, it might be useful to still emit no-member and other checks for
# the rest of the inferred objects.
ignore-on-opaque-inference=yes
# List of class names for which member attributes should not be checked (useful
# for classes with dynamically set attributes). This supports the use of
# qualified names.
ignored-classes=optparse.Values,thread._local,_thread._local
# List of module names for which member attributes should not be checked
# (useful for modules/projects where namespaces are manipulated during runtime
# and thus existing member attributes cannot be deduced by static analysis. It
# supports qualified module names, as well as Unix pattern matching.
ignored-modules=
# Show a hint with possible names when a member name was not found. The aspect
# of finding the hint is based on edit distance.
missing-member-hint=yes
# The minimum edit distance a name should have in order to be considered a
# similar match for a missing member name.
missing-member-hint-distance=1
# The total number of similar names that should be taken in consideration when
# showing a hint for a missing member.
missing-member-max-choices=1
[MISCELLANEOUS]
# List of note tags to take in consideration, separated by a comma.
notes=FIXME,XXX,TODO
[DESIGN]
# Maximum number of arguments for function / method
max-args=10
# Maximum number of attributes for a class (see R0902).
max-attributes=10
# Maximum number of boolean expressions in a if statement
max-bool-expr=5
# Maximum number of branch for function / method body
max-branches=12
# Maximum number of locals for function / method body
max-locals=15
# Maximum number of parents for a class (see R0901).
max-parents=7
# Maximum number of public methods for a class (see R0904).
max-public-methods=20
# Maximum number of return / yield for function / method body
max-returns=6
# Maximum number of statements in function / method body
max-statements=50
# Minimum number of public methods for a class (see R0903).
min-public-methods=2
[IMPORTS]
# Allow wildcard imports from modules that define __all__.
allow-wildcard-with-all=no
# Analyse import fallback blocks. This can be used to support both Python 2 and
# 3 compatible code, which means that the block might have code that exists
# only in one or another interpreter, leading to false positives when analysed.
analyse-fallback-blocks=no
# Deprecated modules which should not be used, separated by a comma
deprecated-modules=optparse,tkinter.tix
# Create a graph of external dependencies in the given file (report RP0402 must
# not be disabled)
ext-import-graph=
# Create a graph of every (i.e. internal and external) dependencies in the
# given file (report RP0402 must not be disabled)
import-graph=
# Create a graph of internal dependencies in the given file (report RP0402 must
# not be disabled)
int-import-graph=
# Force import order to recognize a module as part of the standard
# compatibility libraries.
known-standard-library=
# Force import order to recognize a module as part of a third party library.
known-third-party=enchant
[CLASSES]
# List of method names used to declare (i.e. assign) instance attributes.
defining-attr-methods=__init__,__new__,setUp
# List of member names, which should be excluded from the protected access
# warning.
exclude-protected=_asdict,_fields,_replace,_source,_make
# List of valid names for the first argument in a class method.
valid-classmethod-first-arg=cls
# List of valid names for the first argument in a metaclass class method.
valid-metaclass-classmethod-first-arg=mcs
[EXCEPTIONS]
# Exceptions that will emit a warning when being caught. Defaults to
# "Exception"
overgeneral-exceptions=Exception
pooch-1.8.2/AUTHORS.md 0000664 0000000 0000000 00000006335 14630363143 0014313 0 ustar 00root root 0000000 0000000 # Project Authors
The following people have made contributions to the project (in alphabetical
order by last name) and are considered "The Pooch Developers":
* [Anderson Banihirwe](https://github.com/andersy005) - The US National Center for Atmospheric Research, USA (ORCID: [0000-0001-6583-571X](https://orcid.org/0000-0001-6583-571X))
* [Genevieve Buckley](https://github.com/GenevieveBuckley) - Monash University, Australia - (ORCID: [0000-0003-2763-492X](https://orcid.org/0000-0003-2763-492X))
* [Luke Gregor](https://github.com/lukegre) - Environmental Physics, ETH Zurich, Zurich, Switzerland (ORCID: [0000-0001-6071-1857](https://orcid.org/0000-0001-6071-1857))
* [Mathias Hauser](https://github.com/mathause) - Institute for Atmospheric and Climate Science, ETH Zurich, Zurich, Switzerland (ORCID: [0000-0002-0057-4878](https://orcid.org/0000-0002-0057-4878))
* [Mark Harfouche](https://github.com/hmaarrfk) - Ramona Optics Inc. - [0000-0002-4657-4603](https://orcid.org/0000-0002-4657-4603)
* [Danilo Horta](https://github.com/horta) - EMBL-EBI, UK
* [Hugo van Kemenade](https://github.com/hugovk) - Independent (Non-affiliated) (ORCID: [0000-0001-5715-8632](https://www.orcid.org/0000-0001-5715-8632))
* [Dominic Kempf](https://github.com/dokempf) - Scientific Software Center, Heidelberg University, Germany (ORCID: [0000-0002-6140-2332](https://www.orcid.org/0000-0002-6140-2332))
* [Kacper Kowalik](https://github.com/Xarthisius) - National Center for Supercomputing Applications, University of Illinois at Urbana-Champaign, USA (ORCID: [0000-0003-1709-3744](https://www.orcid.org/0000-0003-1709-3744))
* [John Leeman](https://github.com/jrleeman)
* [Björn Ludwig](https://github.com/BjoernLudwigPTB) - Physikalisch-Technische Bundesanstalt, Germany (ORCID: [0000-0002-5910-9137](https://www.orcid.org/0000-0002-5910-9137))
* [Daniel McCloy](https://github.com/drammock) - University of Washington, USA (ORCID: [0000-0002-7572-3241](https://orcid.org/0000-0002-7572-3241))
* [Juan Nunez-Iglesias](https://github.com/jni) - Monash University, Australia (ORCID: [0000-0002-7239-5828](https://orcid.org/0000-0002-7239-5828))
* [Rémi Rampin](https://github.com/remram44) - New York University, USA (ORCID: [0000-0002-0524-2282](https://www.orcid.org/0000-0002-0524-2282))
* [Clément Robert](https://github.com/neutrinoceros) - Institut de Planétologie et d'Astrophysique de Grenoble, France (ORCID: [0000-0001-8629-7068](https://orcid.org/0000-0001-8629-7068))
* [Daniel Shapero](https://github.com/danshapero) - Polar Science Center, University of Washington Applied Physics Lab, USA (ORCID: [0000-0002-3651-0649](https://www.orcid.org/0000-0002-3651-0649))
* [Santiago Soler](https://github.com/santisoler) - CONICET, Argentina; Instituto Geofísico Sismológico Volponi, Universidad Nacional de San Juan, Argentina (ORCID: [0000-0001-9202-5317](https://www.orcid.org/0000-0001-9202-5317))
* [Matthew Turk](https://github.com/matthewturk) - University of Illinois at Urbana-Champaign, USA (ORCID: [0000-0002-5294-0198](https://www.orcid.org/0000-0002-5294-0198))
* [Leonardo Uieda](https://github.com/leouieda) - Universidade de São Paulo, Brazil (ORCID: [0000-0001-6123-9515](https://www.orcid.org/0000-0001-6123-9515))
* [Antonio Valentino](https://github.com/avalentino)
pooch-1.8.2/CITATION.cff 0000664 0000000 0000000 00000003405 14630363143 0014531 0 ustar 00root root 0000000 0000000 cff-version: 1.2.0
title: 'Pooch: A friend to fetch your data files'
message: >-
If you use this software, please cite it using the
information in this file.
type: software
url: 'https://www.fatiando.org/pooch/'
repository-code: 'https://github.com/fatiando/pooch'
repository-artifact: 'https://pypi.org/project/pooch/'
license: BSD-3-Clause
preferred-citation:
type: article
title: 'Pooch: A friend to fetch your data files'
journal: Journal of Open Source Software
year: 2020
doi: 10.21105/joss.01943
volume: 5
issue: 45
start: 1943
license: CC-BY-4.0
authors:
- given-names: Leonardo
family-names: Uieda
affiliation: University of Liverpool
orcid: 'https://orcid.org/0000-0001-6123-9515'
- given-names: Santiago Rubén
family-names: Soler
affiliation: Universidad Nacional de San Juan
orcid: 'https://orcid.org/0000-0001-9202-5317'
- given-names: Rémi
family-names: Rampin
affiliation: New York University
orcid: 'https://orcid.org/0000-0002-0524-2282'
- given-names: Hugo
name-particle: van
family-names: Kemenade
orcid: 'https://orcid.org/0000-0001-5715-8632'
- given-names: Matthew
family-names: Turk
affiliation: School of Information Sciences
orcid: 'https://orcid.org/0000-0002-5294-0198'
- given-names: Daniel
family-names: Shapero
affiliation: University of Washington
orcid: 'https://orcid.org/0000-0002-3651-0649'
- given-names: Anderson
family-names: Banihirwe
affiliation: National Center for Atmospheric Research
orcid: 'https://orcid.org/0000-0001-6583-571X'
- given-names: John
family-names: Leeman
affiliation: Leeman Geophysical
orcid: 'https://orcid.org/0000-0002-3624-1821'
pooch-1.8.2/CITATION.rst 0000664 0000000 0000000 00000002352 14630363143 0014603 0 ustar 00root root 0000000 0000000 Citing Pooch
============
This is research software **made by scientists**. Citations help us justify the
effort that goes into building and maintaining this project.
If you used Pooch in your research, please consider citing our paper:
Uieda, L., Soler, S.R., Rampin, R., van Kemenade, H., Turk, M., Shapero,
D., Banihirwe, A., and Leeman, J. (2020). Pooch: A friend to fetch your
data files. Journal of Open Source Software, 5(45), 1943.
doi:10.21105/joss.01943
This is an open-access publication. The paper and the associated software
review can be freely accessed at: https://doi.org/10.21105/joss.01943
Here is a Bibtex entry to make things easier if you’re using Latex:
.. code:: bibtex
@article{uieda2020,
title = {{Pooch}: {A} friend to fetch your data files},
author = {Leonardo Uieda and Santiago Soler and R{\'{e}}mi Rampin and Hugo van Kemenade and Matthew Turk and Daniel Shapero and Anderson Banihirwe and John Leeman},
year = {2020},
doi = {10.21105/joss.01943},
url = {https://doi.org/10.21105/joss.01943},
month = jan,
publisher = {The Open Journal},
volume = {5},
number = {45},
pages = {1943},
journal = {Journal of Open Source Software}
}
pooch-1.8.2/CODE_OF_CONDUCT.md 0000664 0000000 0000000 00000000234 14630363143 0015433 0 ustar 00root root 0000000 0000000 # Contributor Code of Conduct
Please refer to our organization-wide
[Code of Conduct](https://github.com/fatiando/community/blob/main/CODE_OF_CONDUCT.md).
pooch-1.8.2/CONTRIBUTING.md 0000664 0000000 0000000 00000003056 14630363143 0015072 0 ustar 00root root 0000000 0000000 # Contributing Guidelines
:tada: **First off, thank you for considering contributing to our project!** :tada:
This is a community-driven project, so it's people like you that make it useful
and successful.
These are some of the many ways to contribute:
* :bug: Submitting bug reports and feature requests
* :memo: Writing tutorials or examples
* :mag: Fixing typos and improving to the documentation
* :bulb: Writing code for everyone to use
**Please refer to our [organization-wide guidelines][contrib]**
for general instructions on how to contribute to Fatiando projects.
## Ground Rules
The goal is to maintain a diverse community that's pleasant for everyone.
**Please be considerate and respectful of others**.
Everyone must abide by our [Code of Conduct][coc] and we encourage all to read
it carefully.
## Authorship and credit
We strive to adequately reward and credit all those who contribute to our
project in any way.
This can vary from an acknowledgment in the release notes to authorship in
scientific publications.
**Please refer to our [Authorship Guidelines][authorship]** for more
information.
## For maintainers
You'll find more information about project maintenance (releases, reviews, etc)
in our organization-wide [Maintainers Guide][maintenance].
[coc]: https://github.com/fatiando/community/blob/main/CODE_OF_CONDUCT.md
[contrib]: https://github.com/fatiando/community/blob/main/CONTRIBUTING.md
[maintenance]: https://github.com/fatiando/community/blob/main/MAINTENANCE.md
[authorship]: https://github.com/fatiando/community/blob/main/AUTHORSHIP.md
pooch-1.8.2/LICENSE.txt 0000664 0000000 0000000 00000002730 14630363143 0014462 0 ustar 00root root 0000000 0000000 Copyright (c) 2018 The Pooch Developers
All rights reserved.
Redistribution and use in source and binary forms, with or without modification,
are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
* Neither the name of the copyright holders nor the names of any contributors
may be used to endorse or promote products derived from this software
without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
pooch-1.8.2/MANIFEST.in 0000664 0000000 0000000 00000000464 14630363143 0014377 0 ustar 00root root 0000000 0000000 # Exclude these files from source distributions.
# setuptools_scm includes everything else by default.
prune .github
prune data
prune doc
prune env
prune paper
prune tools
exclude .*.yml
exclude .*rc
exclude Makefile
exclude .gitignore
exclude .gitattributes
exclude environment.yml
include pooch/tests/data
pooch-1.8.2/Makefile 0000664 0000000 0000000 00000003004 14630363143 0014272 0 ustar 00root root 0000000 0000000 # Build, package, test, and clean
PROJECT=pooch
TESTDIR=tmp-test-dir-with-unique-name
PYTEST_ARGS=--cov-config=../.coveragerc --cov-report=term-missing --cov=$(PROJECT) --doctest-modules -v --pyargs
LINT_FILES=$(PROJECT)
CHECK_STYLE=$(PROJECT) doc
help:
@echo "Commands:"
@echo ""
@echo " install install in editable mode"
@echo " test run the test suite (including doctests) and report coverage"
@echo " format automatically format the code"
@echo " check run code style and quality checks"
@echo " lint run pylint for a deeper (and slower) quality check"
@echo " build build source and wheel distributions"
@echo " clean clean up build and generated files"
@echo ""
build:
python -m build .
install:
python -m pip install --no-deps -e .
test:
# Run a tmp folder to make sure the tests are run on the installed version
mkdir -p $(TESTDIR)
cd $(TESTDIR); pytest $(PYTEST_ARGS) $(PROJECT)
cp $(TESTDIR)/.coverage* .
rm -r $(TESTDIR)
format:
black $(CHECK_STYLE)
burocrata --extension=py $(CHECK_STYLE)
check: check-format check-style
check-format:
black --check $(CHECK_STYLE)
burocrata --check --extension=py $(CHECK_STYLE)
check-style:
flake8 $(CHECK_STYLE)
lint:
pylint --jobs=0 $(LINT_FILES)
clean:
find . -name "*.pyc" -exec rm -v {} \;
find . -name "*.orig" -exec rm -v {} \;
find . -name ".coverage.*" -exec rm -v {} \;
rm -rvf build dist MANIFEST *.egg-info __pycache__ .coverage .cache .pytest_cache $(PROJECT)/_version.py
rm -rvf $(TESTDIR) dask-worker-space
pooch-1.8.2/README.md 0000664 0000000 0000000 00000021117 14630363143 0014116 0 ustar 00root root 0000000 0000000
## About
> Just want to download a file without messing with `requests` and `urllib`?
> Trying to add sample datasets to your Python package?
> **Pooch is here to help!**
*Pooch* is a **Python library** that can manage data by **downloading files**
from a server (only when needed) and storing them locally in a data **cache**
(a folder on your computer).
* Pure Python and minimal dependencies.
* Download files over HTTP, FTP, and from data repositories like Zenodo and figshare.
* Built-in post-processors to unzip/decompress the data after download.
* Designed to be extended: create custom downloaders and post-processors.
Are you a **scientist** or researcher? Pooch can help you too!
* Host your data on a repository and download using the DOI.
* Automatically download data using code instead of telling colleagues to do it themselves.
* Make sure everyone running the code has the same version of the data files.
## Projects using Pooch
[SciPy](https://github.com/scipy/scipy),
[scikit-image](https://github.com/scikit-image/scikit-image),
[xarray](https://github.com/pydata/xarray),
[Ensaio](https://github.com/fatiando/ensaio),
[GemPy](https://github.com/cgre-aachen/gempy),
[MetPy](https://github.com/Unidata/MetPy),
[napari](https://github.com/napari/napari),
[Satpy](https://github.com/pytroll/satpy),
[yt](https://github.com/yt-project/yt),
[PyVista](https://github.com/pyvista/pyvista),
[icepack](https://github.com/icepack/icepack),
[histolab](https://github.com/histolab/histolab),
[seaborn-image](https://github.com/SarthakJariwala/seaborn-image),
[Open AR-Sandbox](https://github.com/cgre-aachen/open_AR_Sandbox),
[climlab](https://github.com/climlab/climlab),
[mne-python](https://github.com/mne-tools/mne-python),
[GemGIS](https://github.com/cgre-aachen/gemgis),
[SHTOOLS](https://github.com/SHTOOLS/SHTOOLS),
[MOABB](https://github.com/NeuroTechX/moabb),
[GeoViews](https://github.com/holoviz/geoviews),
[ScopeSim](https://github.com/AstarVienna/ScopeSim),
[Brainrender](https://github.com/brainglobe/brainrender),
[pyxem](https://github.com/pyxem/pyxem),
[cellfinder](https://github.com/brainglobe/cellfinder),
[PVGeo](https://github.com/OpenGeoVis/PVGeo),
[geosnap](https://github.com/oturns/geosnap),
[BioCypher](https://github.com/biocypher/biocypher),
[cf-xarray](https://github.com/xarray-contrib/cf-xarray),
[Scirpy](https://github.com/scverse/scirpy),
[rembg](https://github.com/danielgatis/rembg),
[DASCore](https://github.com/DASDAE/dascore),
[scikit-mobility](https://github.com/scikit-mobility/scikit-mobility),
[Py-ART](https://github.com/ARM-DOE/pyart),
[HyperSpy](https://github.com/hyperspy/hyperspy),
[RosettaSciIO](https://github.com/hyperspy/rosettasciio),
[eXSpy](https://github.com/hyperspy/exspy)
> If you're using Pooch, **send us a pull request** adding your project to the list.
## Example
For a **scientist downloading a data file** for analysis:
```python
import pooch
import pandas as pd
# Download a file and save it locally, returning the path to it.
# Running this again will not cause a download. Pooch will check the hash
# (checksum) of the downloaded file against the given value to make sure
# it's the right file (not corrupted or outdated).
fname_bathymetry = pooch.retrieve(
url="https://github.com/fatiando-data/caribbean-bathymetry/releases/download/v1/caribbean-bathymetry.csv.xz",
known_hash="md5:a7332aa6e69c77d49d7fb54b764caa82",
)
# Pooch can also download based on a DOI from certain providers.
fname_gravity = pooch.retrieve(
url="doi:10.5281/zenodo.5882430/southern-africa-gravity.csv.xz",
known_hash="md5:1dee324a14e647855366d6eb01a1ef35",
)
# Load the data with Pandas
data_bathymetry = pd.read_csv(fname_bathymetry)
data_gravity = pd.read_csv(fname_gravity)
```
For **package developers** including sample data in their projects:
```python
"""
Module mypackage/datasets.py
"""
import pkg_resources
import pandas
import pooch
# Get the version string from your project. You have one of these, right?
from . import version
# Create a new friend to manage your sample data storage
GOODBOY = pooch.create(
# Folder where the data will be stored. For a sensible default, use the
# default cache folder for your OS.
path=pooch.os_cache("mypackage"),
# Base URL of the remote data store. Will call .format on this string
# to insert the version (see below).
base_url="https://github.com/myproject/mypackage/raw/{version}/data/",
# Pooches are versioned so that you can use multiple versions of a
# package simultaneously. Use PEP440 compliant version number. The
# version will be appended to the path.
version=version,
# If a version as a "+XX.XXXXX" suffix, we'll assume that this is a dev
# version and replace the version with this string.
version_dev="main",
# An environment variable that overwrites the path.
env="MYPACKAGE_DATA_DIR",
# The cache file registry. A dictionary with all files managed by this
# pooch. Keys are the file names (relative to *base_url*) and values
# are their respective SHA256 hashes. Files will be downloaded
# automatically when needed (see fetch_gravity_data).
registry={"gravity-data.csv": "89y10phsdwhs09whljwc09whcowsdhcwodcydw"}
)
# You can also load the registry from a file. Each line contains a file
# name and it's sha256 hash separated by a space. This makes it easier to
# manage large numbers of data files. The registry file should be packaged
# and distributed with your software.
GOODBOY.load_registry(
pkg_resources.resource_stream("mypackage", "registry.txt")
)
# Define functions that your users can call to get back the data in memory
def fetch_gravity_data():
"""
Load some sample gravity data to use in your docs.
"""
# Fetch the path to a file in the local storage. If it's not there,
# we'll download it.
fname = GOODBOY.fetch("gravity-data.csv")
# Load it with numpy/pandas/etc
data = pandas.read_csv(fname)
return data
```
## Getting involved
🗨️ **Contact us:**
Find out more about how to reach us at
[fatiando.org/contact](https://www.fatiando.org/contact/).
👩🏾💻 **Contributing to project development:**
Please read our
[Contributing Guide](https://github.com/fatiando/pooch/blob/main/CONTRIBUTING.md)
to see how you can help and give feedback.
🧑🏾🤝🧑🏼 **Code of conduct:**
This project is released with a
[Code of Conduct](https://github.com/fatiando/community/blob/main/CODE_OF_CONDUCT.md).
By participating in this project you agree to abide by its terms.
> **Imposter syndrome disclaimer:**
> We want your help. **No, really.** There may be a little voice inside your
> head that is telling you that you're not ready, that you aren't skilled
> enough to contribute. We assure you that the little voice in your head is
> wrong. Most importantly, **there are many valuable ways to contribute besides
> writing code**.
>
> *This disclaimer was adapted from the*
> [MetPy project](https://github.com/Unidata/MetPy).
## License
This is free software: you can redistribute it and/or modify it under the terms
of the **BSD 3-clause License**. A copy of this license is provided in
[`LICENSE.txt`](https://github.com/fatiando/pooch/blob/main/LICENSE.txt).
pooch-1.8.2/data/ 0000775 0000000 0000000 00000000000 14630363143 0013546 5 ustar 00root root 0000000 0000000 pooch-1.8.2/data/store.zip 0000664 0000000 0000000 00000001414 14630363143 0015426 0 ustar 00root root 0000000 0000000 PK
M store/UT |{[|{[ux PK
M
store/subdir/UT |{[|{[ux PK
Mm; ; store/subdir/tiny-data.txtUT |{[|{[ux # A tiny data file for test purposes only
1 2 3 4 5 6
PK
Mm; ; store/tiny-data.txtUT |{[|{[ux # A tiny data file for test purposes only
1 2 3 4 5 6
PK
M A store/UT |{[ux PK
M
A@ store/subdir/UT |{[ux PK
Mm; ; store/subdir/tiny-data.txtUT |{[ux PK
Mm; ; store/tiny-data.txtUT |{[ux PK X pooch-1.8.2/data/subdir/ 0000775 0000000 0000000 00000000000 14630363143 0015036 5 ustar 00root root 0000000 0000000 pooch-1.8.2/data/subdir/tiny-data.txt 0000664 0000000 0000000 00000000073 14630363143 0017471 0 ustar 00root root 0000000 0000000 # A tiny data file for test purposes only
1 2 3 4 5 6
pooch-1.8.2/data/tiny-data.txt 0000664 0000000 0000000 00000000073 14630363143 0016201 0 ustar 00root root 0000000 0000000 # A tiny data file for test purposes only
1 2 3 4 5 6
pooch-1.8.2/doc/ 0000775 0000000 0000000 00000000000 14630363143 0013402 5 ustar 00root root 0000000 0000000 pooch-1.8.2/doc/Makefile 0000664 0000000 0000000 00000003141 14630363143 0015041 0 ustar 00root root 0000000 0000000 # Makefile for Sphinx documentation
# You can set these variables from the command line.
SPHINXOPTS =
SPHINXBUILD = sphinx-build
SPHINXAUTOGEN = sphinx-autogen
BUILDDIR = _build
# Internal variables.
ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(SPHINXOPTS) .
.PHONY: help clean html linkcheck doctest api
all: html
help:
@echo "Please use \`make ' where is one of"
@echo " all generate the complete webpage"
@echo " html make only the HTML files from the existing rst sources"
@echo " linkcheck check all external links for integrity"
@echo " doctest run all doctests embedded in the documentation (if enabled)"
clean:
rm -rf $(BUILDDIR)/html/*
rm -rf $(BUILDDIR)/doctrees
rm -rf $(BUILDDIR)/linkcheck
rm -rf api/generated
rm -rf gallery
rm -rf tutorials
rm -rf sample_data
rm -rf .ipynb_checkpoints
api:
@echo
@echo "Building API docs."
@echo
$(SPHINXAUTOGEN) -i -t _templates -o api/generated api/index.rst
html: api
@echo
@echo "Building HTML files."
@echo
$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
@echo
@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
linkcheck: api
$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
@echo
@echo "Link check complete; look for any errors in the above output " \
"or in $(BUILDDIR)/linkcheck/output.txt."
doctest:
$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
@echo "Testing of doctests in the sources finished, look at the " \
"results in $(BUILDDIR)/doctest/output.txt."
serve:
cd $(BUILDDIR)/html && python -m http.server 8001
pooch-1.8.2/doc/_static/ 0000775 0000000 0000000 00000000000 14630363143 0015030 5 ustar 00root root 0000000 0000000 pooch-1.8.2/doc/_static/banner.svg 0000664 0000000 0000000 00000037063 14630363143 0017027 0 ustar 00root root 0000000 0000000
pooch-1.8.2/doc/_static/favicon.png 0000664 0000000 0000000 00000012216 14630363143 0017165 0 ustar 00root root 0000000 0000000 PNG
IHDR szz zTXtRaw profile type exif xmP
0g;x ҦR7ņDIۓzmE[o
ҥyi ʴ: ysڲC yTOBzOb]R_# ) )S)ka뺜WX7B0kΉ7ům\2K nXΊ ߝv84Y\L iCCPICC profile x}=H@ߦ";dNv"
EjV L.&
IZpg⬫ 8;8)H%1q{r 4*L…f:Ui0&3˘|=|,?G0m
MO f%Y%>'4ď\W<~\tYa3'V:L8F Q5*-ZZ/ eEX
j(QuR,< qrȱ*4Ȯ ~*LOyI8 @.Ь;4O3p0IzEm⺭){0dȦJAZB 7倡[o[ @z"eoִgr s
xiTXtXML:com.adobe.xmp
* bKGD pHYs + tIME4, 6IDATXýkh\E솸5iVFP6],DiMj+RXJTPbU8F$~!MDMPsh*kkԸͣcI\7x>͜{gΜgYHXGcvbd)*C"Y`;P aDFo1Y;֑%NI04*nKs3 I`W f|;#F #C0 89 ڀbF1`A _*kƯjiC*``b jgc
ɛFї'|`$^Վ7ہ,Ճvu
xX?Yy 0@\Y Pa;>)8ВfZ5aiYksR hMj"[
7Yw& /8p*Y t
@
L4y[{|)BњY%) * Ywg^x U(D_E`G`dS!
;,]su -IqgJCuVI P(`b@ (M;v2l8j| |
JJe|[r <{ԯ阵'T_FP|DJs*9@[=$6zΌb
6 {5Ul:
.W;/:E:χ%z_ Tp~ IQOh||k[:} BM0aԘpKMׁ=yhYU&8ʎ:zK(/a]IC=\}3mXG c])u^$or~JnP'ٳpar |lW|gT 2تeSDV2
%
|jg>1Ɓe|oeF|'& IENDB` pooch-1.8.2/doc/_static/pooch-logo.png 0000664 0000000 0000000 00000064760 14630363143 0017621 0 ustar 00root root 0000000 0000000 PNG
IHDR ߊ sBIT|d pHYs + tEXtSoftware www.inkscape.org< IDATxy|U$쨸!$A!E!h+Km
Nwm2t.ppNLe]VimQB V%$!n`$"*9~Ϲ|,x -sgeܲnJpdiZ!}nNdȵ+
]Իٟu&[MѨt&W'bLA*3Vdg
)~W3\g1&. =ta?{.0XC7%'xWrŘk5䳆n
TI
WֳӘc_L)!kܘH4/:0f싞IW.N:19
#
6% _$VU2K9 HcLXn?k0杬ĩ~ꥂcL
,TͮØ>MbW*
J]1ƀ@"7,7c,A)J\ vSiz0:ကky1!ϫ2bNSLةP2PKPy1Yy 7FmuՅgwS 8ↇG Eoct\=M5t\0L/\:1&z(rmށ"kƙjax) *0u cL^,WKͺuBc
]hhF|^T.Fc??=,ɛjA 1c!/':LYC79WwR}qg(w;/|ɟ +>{Mݺ4xiP:1&/ Wxu$n9r
0u cLlA $Mt\p8ƘDkO_>wF Ia
D֯8ucL
Ws];u SHԾA4D2_>k];k&2<:1 U{ToƘ5tcLΔ*̫uȇbfL:XA{ "U^LѻgX>CQA#6
CPƂƀN9obKkg]:EДE1oTym"dw6N_z'##iE5e
DkgY`u ^Rl ˉ: =29B;\H* :y35 C@ ^ Xmx瀒1qM@d%lJ噭=Z<ჼL-MSi4`"u
ѯ5͛ 1°89R/_O,l #|cbOϛ39 RTrp20qbn7dzd9 yRkyQџ6wPl[ fbrGs
k9R?͡ }y:z/Ιu Oz!+'nq Pǿwd zoAr mYMsgue
=G_r:G ( ?
wm֯ph&6-g]),Hzr>!uKq|3s doXCϑjAYE~ZUhQ^ƨr@fJ 4)T8c^T'P0x]SaN ](^*S&?8
ӽNl)2Psjۣfz o7F/:Ћf/XZ̾L$DR=[yJ(+oW^@&HzK?")L?&s,> r )zsVz\kyv5K.Acj\S^;o i~CA%# Zu0"NW݇2XOk'D|l{,Osb D_8}+XwI?-~X]>Vom[O uM\:ٳ1.fc+~yY?tcO@ kyٟ~j;sȩ|yތ]1{ў . <9is dwaN! erҚy']0S֚y25^v~]Tb ME@] kmݴR"U 5͝ђHkH xySp yrF#&\1k4o
L n K?:XCwdg|pwh:zmʔ e:sYK\0柵ɟyGp$ v4 Ň#kݺTU-
I]xuڽ<ś473?3[g;7)MݭJ]ٞ5t7;p^#ȯ S vO5e`@7'W []牑7^:9<
쿛pd3 q)PE(ƹ3 s ĸWwU_
gxzj\NfgS\r ^&fNoW[rJ2
ox\ϸu
/S/.duMi:5o_{]>l&(R7{ Aq/ND8o?s$K[嗊u~wWon
+y+5wL߳OYNaZNsg=͋7ܘ
eTy/PM:BoFͮd2~(?oq1YuYƊ4 ޱtDbFP՝xv,x,yYЍq`uW3^A6W8\`D~-MXܸxX߂:Kɟyv>11S7RUvd*"XG ֟鎲1۫
b;fΒO*y3nLl^u:^ˤzW|N V=yA/p%Vu:_0[C7@cc a@slWB_*~5 r$_TynLx^Uȫf:)N~Uske:KgYC7wSe1f^vn1)~WIKqT3x,n1h3$yP71g-OX'Shc3Ls
QS>ʥaXC7UGmht#j@? m,c1&QKjYa鯟is6B7(YiAos#b*0cI -+MsDI/1ƘiWE QRe{5tc1$@ e{5tc1蟳Y
991ƘjہsDhT)Bkc]Lj~,9tcL"hہ Jo?T TS{1Ch/ "'6@_C5ztL{as>~}&Z Y/(2zgKrcJGѫyP (c1d EgD 4]ŶF d
D2lL\յWpCDdlc
x4OcPpQ2 ;{m~
FB8t銗@'H;*2 =3ke/MĖ74]L[ʿ]̧ޭ9P}}Ѝ1yZ ЏRD#0Ȕ6ׁr֯XΙG m1&DP} odS$#2 x銵(R"ptS"2[тh< m z+Թ@,Ej,?#Z/t75]Yn];9vO 1&4]Y 0u=}xRX;WNK]O5ӫlnqJjQPA ~@ Nԏ)WRw0zOnqN&w+]0TU29" =gEЍ1P> 7cЕU>. Dt !"{nЍ1+FT' O*uT~)tecRz:X(Y{ثW!n>x>O 4. GI$cv!eӣ؝L[Ɩ# YjBȤ5r #~Is{Z 1EN(a# C: =[o>6L^۩ dMM~CDOc@۪M 8CjҾW攚Fm- _e"m%-%.}&|gW)wc
.C'Cr*EQtu DQ˄NZiisɟqN ųnLжQމ' &RrT?* wA.<#5GN~:GX Q.N)wcJӕQNP GQG?1ɴօ)$Bm[?Nf-3衺aQ,Lg 촡ݘeu Zw,I HL]JgɴƞЕZ HӕBw,6BRi>
|.:|ha4w n^x(\^]')ohkQT) QV y- 'Iw5tc@WT i|!GVQxT~-cL(j> IDATG]gMw5t[gNhۡ
N
Fuq2酎Ն.@$$p ͊Ѝm.Ӗs4]L ћmhԻ[[ z+ԇ $#t䯽n̎F[ʿGf CssE~~CW!`s̮&?柽 hs#I= n>`MWt r!?`͡(
IM{#vz^!l|!ZF$
=UZ:k&Odm)_D5!IH.S%=HVOk! įto씗H1MWt#xn"v:W|7BRݹ}뢨W44H D?x0XC79- tE 'd
֗Q# 'z!S=.M.Mk
_53" ܢ#)u(j}uy!RZC7QG#/o] $Iȯ]j:~DMQ(I(#hw! дm4+*kqFIxV?
Hj=^v! EqKWV
ҖRMW|+F(<lLHCPՕ-$sНr { !s0zѶ2m"[V!#xZI^y
)!lLZ>D׃PTK|l-=;m8#RS_zx _L
} =7]gC l=Nu܉ @ Bٚݔn
Y *c#SA&u<9$D"H}tDAl=CkhY] )p:'c?嘎'@o++M7e6BwM[ Ŧ=՟&,7bPI QIkg)g?b
%m<蔈Kg㑪Mb1̐;a{: LEJ{c
m:t_m
[d5tSDl/aTդjGU/a*teUb~盦K*ӊ9|G=tSd_= ]K᭭?㘈C7}ѐ;4obNb6&k7ik")5 EX ED/
=Eq@>`w"z3P70=tS/*/: )zդ2wʪAQ)kf/EQ/&D`nI Nk,D` Tt Ց293עce7vHk
>y82 u q])wc!]IMg+$~n%t{%M ]Qy=5H)w6Jdi#@wT5cG{ k4]q9u z1&S[+?U13'įd>VB5bY@$ h" k y7AgQm< 5 A>FA6uI{@o aYCϒ. oǒLv
Ħۍٹ*ʓ* ;i"3)Ϡ,KjD +qdů/βSAY]굆n̮
?ꊱ*(5 ?G_)cWv bo$} XCKV>]K9=ٍ35tcvo ^m:Ш
ʤΟ rqTbA{7힂3^' BF @l-z-Y]YC7f Ɛ (T&D=I [C (m@o(0u=n tc
]mt| nH)M^C@h븣P8us0r7fw=Qm 5W"\U=gT\G[ )w鲆\~ < ueB4t;Ř":=-bdRe(߉Mt ao~3[; [re4Ĕ.qda+* eA5_z. :^Q>CiSxJqjn
ݘl(_;a1:Ry pu5#+#9W>_Mm6ZC m8ջ!5!T-yf%k: $ʚy#Lp aox !mm)? ?fXC7& ^[+eEioDY3/M}tItCW4]>D" hSmݘД5]yA%erWIҎrBV+$zQzk4]A?fi#t,tc" 埈hMM;%kF Zbhk@w
uzWy *?זFYoG9$ 蒰$R:R9ntibFD)pTeQ
ѫ2>I0u0){:DD?^)w)Θ"[m (>lnʘxhQ7 hTkK{@d{1Bd5BJE C,cGYTj:zOZI%d=:`]Q6tm Wȟ wFRMm_iy!=:(5K(F&)I vpmK Qإ,Gllp486ʢ2yH)@gu#eDC\gC7UCCGv%gJK~J}ȘI_m(Juw**ʺ {@.To&z]IQdяz>$>1EAt:[jE^uo0C4*䟾|$k븣@@Jf Eq=){d͘+{X#?!L>Ljtg=R' M#! R6t}t{wks[w^ Y3&yF}Z$eRgqiN3xR<1
]O/bȑ'ݘBm8e q@oJj
I
MӞi謨1+,vݘ "2`&s-[
rŋ
m Ws!fQ0Ƹr銜`JMǃtg R3\gKyǏžk˘#Pdu,IkDHNꟂ?*={uqIIgcnj$=ў{$!nTnL!O#?=?e] l.8_w#Qyu/%koO +?>{\KE51l<Ǯs$Ѝ)vQ, :\t8zIobе^ B\mЍ)]wNԴ :
r5#m;Dl.+E{*\gI$ hS
}lOn}T/'"( i蔽r^1[u{81 bLk>Xzʽo82C$DSi:Bm XC7PnwFi힂oUW9R꽣]}.6
]? :GBIkFJLw$_~K&w^$9S
NCz7 uOR~A`#tc
G,kW.9:GX@ŪKQuđϠ^ 0^HAԩnoMǪa.q
1BWS( > W
%l9"d~w/]C /~ud 3^tb |k dJ{ /f}b) w|u(IJKΑ rkmݘBU 7q#
ܵIJ>w1A/)v 2&=(
]ۺ
4{^nS@l{Z0nwmۆ@M @uScEq0 u#
y bE@/q#JMS89m yu9g bϠ}ustkY]YUrcA\uDsDsd7t qr#611I}=m ɝ\爥0Ϡ{ ack]dSsDdÛx:
^P"܍)$=` Y³4tlt#vB\] YcL {b8ԓ;i dt v$MSXJUu=B7 >
ݛ /+x HО6B7Ь>un]V*7\爎>d@IJ`
td76 ƘXXу_? :GT2)~$K :G|x!:c"a\e7]爊c+f<%
1bl.ӕU#AGD Ut
]_Y
d>r{6W%ԗ^sF9r]vlvc
QWT
4aR3D6t 2%7 myZ8nWnL!J=Md.*]爊/9lMlCVqjύ)HR<']~̽s ?VwAjMתЍ)HAaO^ | Y").m Αgoj w]@
S)DR؏z/]爒)@?:F Y4lXC7PAA6~ O53Zek
]9, Ƙ8)eECZz_XA5t j9煘rS
gz-zvkv!r 9#6B7Piar 'p 9GS?`5t j: -cTِ
] ;]cLrA H5oFY WΑCUP[ q cLl]TΑz~uтl t u c))Kg
\:G.ȷ C7tΑ#!Vsc
ZEqS}Q)٣o\
7m2} 9t3XFt#'otA7>MJSЧ_i࣮sȺn~ХCsDJC=go#tc
& d|uܑrq|o}KeXYMS$kn\tgߤhL+ IDATiu?BܠN^O _\K4t $5uм+E
w:MbF]d -0uM%xj2iͣ_\'Ĕ{anhyMDCuYiO yכUCc.cdI)LmnU
W2/~ p 9㦹3vPX5t9 ?ΑN9r]V; p?*< T 42 8gC/W\ȱezE>߰$oo ^wHI[WǎE',I/ Hywk^ MW̥2UD$3W.}ZǼ/>oX
]iҖ>:^g}zՉ$VT "2Wv| 8 u. Rhv dGS(]@,$4Ϣl璨لp/*'R 'Z* Ī^ݳu SΙmC +4]q'1Y7>F&JPSH^y9KefƝpӣCn|Y&.h: AyIÛL|.EN~kP.Y2lG v\e vVuBjܭq]{kz~]`kYWLop q;-TU } TJ^qMVGk ]Gy']"wNۂdJ&aClA8PdnI~RчHNhcoBH~WȬZ#;\gyVތ1 5gְu%;1 㶶3n[t*^F@'Mm ĥЧYTF\b'B?UP~: *{ږ)j-H~e0 :GZPn[|M9__uB?ȤnG^^8 v7JA4|UD4` 1BưUfW;GBmq DЏC.'a{5BSLßI+*i)&a.{S6î u{7;;jkՈ1ѥQYUcNK0u4SB 7{![p}ż9Usti>YPF2 ]U005y_u $f^͛
q #-Ht YE'g\4LZ9o\*+q>k3MB\rrVs5v=~В&FF`}& V] kߓb&Iic Z r]27ǘ~U@w
G V]ⷰ/{r)j\Wt͘ :G!Sz{EBaHmn?*B%1?ڬлH&o"n'^: S<0&&) I1҂|}̚ Z|?q(Y*yuBȝ@s δ_ADP:L&n?iuA_ar{=.N7k))9S&IڅsлAf5'Z$Ix2Ѥa ޥk
~5Su^+YݓUYO%:]a]cCXMs4iDj:/>@rn]R$J*
"kBu7лIv %H[{Ɨڨ Ğp.Z+Lw "(Cuw_^&K'|:TۜYĺZQ5lAefT$Gۼ) Q?:Hmt 7f r}%ϟ `r9Ի16gaL HQ"T㛘kt!]"ĕ :_ Ѝ\9Njxe f08NKuhJ
{KNH5C~5Gx>IuLD/qBV.)[c;IbX-s6#eV1WyNjp!wNdn6B)ܺu.s )- XӳDVYgϟ- n/vi T+sBGn궧@[7`4KZA"j7z'bTݶ|]2*.]g+^&Ψ #n3-;7~ς 9MdIRMiNj｣OcOO wvD,4uXI/3NԕE%OIafDsY>v(dWO3ʛZxQF
_ fJTT/yuXBRnm'k^7\FFp֜T b'MO/ʔ'L-W)|r~ ]5+(ºǠϐ ~iEWvy)D Ԫ<s?%Ӿ}B1'"TcУ)=eٲ(qsHMLBdVG|Ov-VKO j x5ɼjOXGّo"ֹ g
LbZ1vlNaeIcl, kg]'7+Xh~ խd֭1L-RTp &&xY+ f6!.#yjyo/[]q
=dVY_+[* br
q Ă E&h UkSyLsl/ 1QYGVǪo XLjL-EO CnS6{]g11;.Ҥ|~gVd6gͷkr %%/&`q."S^_i*P7$qZSZ1vPe!I 3iGz -;wwCa]cR.$ys+^
=Qā}9YVGXk 8[|OGG/.)N9"˴`n^z@h2LY#$es.ZltzD@{ [{KmsZ]_-ps;rx"1v<+wB)lXw8&Aⷵq&Zk]=3/tٴF2]pNЧ|&T|uDc /.|i
p ă\CEZ>rX
= > Q.YsZ\'IDVq"5A#]$S$U9ʌ7vK8`
)|wҚaPlٲ\}c\pqBAxI!u wDtV]tqyÛ縎"? Yz {סwYz,'`&n"VxuknS縎ί t5LKamҮf$lڏ'j4 Ѫj͔wc-:."_|udanMN]=s8HyIrlٲ@^n?"(_kA[
\Ґv꼩
dNʞ; -]Lj=
?'!N&VGMmx@,&Ƃ,Go|<~b1L9]'IFV*8Z&.p "=S{[r #^>*Tudenzgj K]0&\ 8\\ p$
ʑ
\
\'FsB v$ى &5P~:1ɮޕ ͽuTa#t2sØdwCU ̣
DO $<_\Lj/jMȬݨmbLO3DR~ACś\gIEV&qnLQ
p #Vҏ}faRUu o@2?r$$Cl1pCP ,F&h!"r1]roͧRu"/ie V&&dZm)aL+}G6:F ?l[/xutanb}<`$[}5ZKDnR_ _)YdV城ە˘wX4Qi'g+B% ]IG6B71%Eu"|ucͽk.O2Șfe~1IO֞˃/r #Z&Snw &%wv::RSK7S;ByAM-Puc\ڴ?Wܐ*e"3)#sB|4s ::gЇ]1oK&:aLh~C]G魭xy%+\1enN\:1px(_.#\G%}pNyI̱Y':KQucbeu tqNkdi~䣮 NBV&at/ >:1] n_W~^b_ UշY:9+tPM2Y\ WR4ujAF
$Ήr, Ks{?~'xKwUyx &:MB%G3H ^] qzYEWjO |aLXu䑶 Wbۡ :o{Zw@'3 _^u˅uB7 M5Swpn2Clqz +9bb
$#ލM `Q, AV&IU7Yr#]1ԟ&hU
ރ-YlPGw)^p_ב@WBծB7IE
@,&yE4}T9;jdXѲGEoҏI:b|@N2q u<65rϩ; I}OX ?ͤ6MRWG{NrŜp_eg71(ʊĜIkZ7/b_q ܇+ug^c72O:@l?4hfO]F5f M٦^ugW?Şv>'7S4d#e$p[1=B7imݥ RK/=fw ͙殊+(Z<Ĭk5l=EC6rkW]r7YgMZ9`: >-|q|zsdz Nr?33af k8cZ&܆ -,<ӣ/[MJz "r+py?"g/WN|O]Ku^#9oT%g [Kv=f乻vpk
? V5+tR>Z8o R"0 &='ƼR }vn :N:ѫ9odo- ]>/l4(M:?$"_ٞʹ
s!:\6~16~1C {s{_ r>}A(ѫ
Ha]X4&M@h0;8GY8t%\2l{leZ9p_;ΥzI#ڤA( F"S;ɥc'M@hȈ @ȹ }\*O)s
>4e6;nF t'FƔт:1f)y7+tw3: gD?KTƸMv0sz]!cZL};ݓXc*$H<'ѫxL)Cw:eʮnUo;^ YGr\犧!L?9dy]{}
xh(a_5QwpDdžL)$o}-# E2IA9+tUǹ=uD7A lA9lx"ǔrqD/Ha]0xM]`A`ú<L8&%BI\26j+ŏ}؇dV- c7GޞLgɽ!\\/bd=T%E
6:3 IIDATs"V=; *L7/OFަOx p_f˴Ay?<"/.;(Ld*= 鮊<|SͮDC6X`#73DN$2G&2I`D9o\2n),v 'Z@/bLWYCK<=YT' W7^cyDCNKƾ&>}DS;eRT tz 3*y@!Y:NiHNO+N}ݤ8Z2)A.+tξgyNã:`Ĩ䝱~"P>.Eu/bLOXe 6,Bdx #P &(E
ap ט5u&n.?&nq %V^(k\1лhf>a
H=RЌT! %0\a80 ؚN~+'>:NT ~\&o:1Vs=sZ `nЏxz**
3lff'gߛʣr ~6[1 a }^
#+~$GU$WTrU4W lEsr@ 9
Y 5& `muXQлZ]Խ`Kpm>-*VB5 CP !G##\
:_C_ @[;WȓW(GuޣQ+'>eR
s Ęh
ܩc}W
{o][ժG{5V$Dq/+ IamJ,eg+tc;(UOo@ΔeIk7+ !
ugIam8ēM3 ӳgoy坓3/#r}'Ja rlny]"||a=xtTCH
#,A2ԍ)\2 ZB1iK>\ƲB j͔L bb`{Z#BY2Y9!%}3'5cғ)]ొܵ]yLi? 8!C"SPN)@G
du3!`'} uD6Ra܌9>+tca* G.qW el6Mʠ!aZˬýdL
v]1=#[yOmm#q,㶶tޗ7ĐЍI-`%"| {t˘4anL-D'y2Tu cLAz1% ,W9!\Kˏ7+> 1I@a3BDʾuALƘb܍IL@V '*C%]zЍI Y}?/;\2$ nG_FkxQM袽3cЍ.H)@0[.s:Ѝ]/,x,7u cLB7&z䋾k`Qu{VNWD(<1ƕ `7y╖+.1&Qݘz{[=VƘDen
R_*Tu&c*+t@52)1
ݤ LҁJ_e1bnRWo-Yg1fp@(aY0C=scL<$ (S2O
{cM{7BY5cy/+tH} Rj~cLYAV9{2Tu(cIFV&^U@@`eyxP*bM4=\+=N{×_ qcRUO^P- T+Bu9yU*1Ƥ (Z6ZJ&T|u0c1vݼnF7#&Wn9SlDt/ߺ,ta1tz lݤxݔ۲z v=956f͞ uˡw cL;'*['=@B
_+J!o߭+vNc]r`h#.dC{}6]vɽwZA@KeF.5{vh]fc]M@BSg1k Mh$M~Sh5>uxc1#~
4V}(
$ЪB|h9,MyM"5na>GcL*J粝
f v ~ E[=Z |8h@
pooch-1.8.2/doc/_static/readme-banner.png 0000664 0000000 0000000 00000176653 14630363143 0020260 0 ustar 00root root 0000000 0000000 PNG
IHDR )y sBIT|d pHYs + tEXtSoftware www.inkscape.org< IDATxy|}$! K$." mbΌu;_tZ] [VGmSqBYTJسB(T>Ix>`>uY#F -ئ H
B P i H# @ ! F( 4BA
B P i H# @ ! F( 4BA
B P i H# @ ! F( 4BA
B P i H# @ ! F( 4BA
B P i H# @ ! F( 4BA
B P i H# @ ! F( 4BA
B P i H# @ ! F( 4BA
B P i H# @ ! F( 4BA
B P i H# @ ! F( 4BA
B P +5 Et RS2Tq. .?S|o FO9 8]\؋>u-\= ɣ CNqB*T6S;v ( i.(Sdr*&Hǹ
{ymL 삁wx⫟Tf$> H} cWԹrOeݲ۰^ѕo- @P( i-R<ۊ#vyZ%ݾ6 t
B @gUx\)Y_ ~[V7-%Y p( SP,-9;[}Q;W'u. |
B @ce)\=Kd9aY VGG VF#g+4\Y8 }7rk5 ( =s ~B'%,WϿ |儥HɑdE"!َ,;$+ks;qɍKN6Ѷ \lg)\up4]WG6?2d.U_3segJCE`$' /?&EEۤh}hk/yf p\( =TjճdEL9~xRyRw-KVv_}+Ov^"0g+ v;[6}m 4 #py} ?ؤĎUJ'+TrBc%;W~s;w G I@A HyV( 9GVf8k%wy{7ۻE^KT @CA H]p4̓o:
;[$q7 ( vz".45ɭ_D;vH xQ Re+T9E)2)o߯DrkߕLG z
B y%b2],+tDvwu=M R! RhD̓ݧ4%%Tb
- ) `PGϗݷtRmxO_ 8 TH:AMo(e EA H
".]t(Hc~S-_Ǐ mQ RdEK 'bJl^Ɨ3 H*
B @ JE^$(_繊oYQ AA VNF]PQ.hGaw $EVVf̘>}W^Ѯ]LG IBA vA/b= kWsM 1tP]z饚7orss%I| @: `"ɩ Y8@Zw+Ǖ[k:
-"f̘/\Ǐ?3ow 駟ysQNNNKA @z twt e})VݧxUq 91ch֬Y:UXX3( H/ .[(#Y2&!Nӑ ЋD"M4I3g9眣@mڴ) @j twt %N$h:_' 8)G)xg+777)sښY 5P oo 2 H9V^2'Ŗ?Dq Ѓh1c EA 2@J1d3~5L @
,K3gԼy4ydE"y GA 2m+2劽Dt$ P( :묳LG9lݦ# $ tj@N$;H #MA/8}X}Uaa233 E"eff ޑѡx<.&IFFPSS @5gΜ*%i]# $ tGAt]\7՟oh1)77W>> GY"<
r G999=
ԧO}ׂo߾,2 jnnU[[ ;v ~پ} @o5qDBA @ tRo:У5PIrlS =Zӄ 4x`nYMsss/8***RQQ
vڴchڵZfn*u
讯M{MG IFA K 5tDZr9C%aK87߬n? #Gjȑ袋$IZn֬YuwUkk @FqyJ |[i7 h:_ZCo[1pD"իW7В%KT[[k:
6L>hJ,0}tuvv z˶r
de+Y|ϕwkuA hY
%g()qŧHG[Gʏ zKM{DR g
g ~Q(SdɊd*U eIʏ$ ¨QߦcSlٲEK,믿k G e]o#'["Д)SL IFA 9}%+r4;e^$[)ԿZ
E>sykiQށF -ݸ,',+HN)rߍo%߾_^nm,}}RG +#G̗W,+RYy3)X#vB!=S0`( ;v詧?} @jʔ)0a9 HhƌFf s(p/Y9EGR/]*\9K z YMr4o%uDtfEeV;HN){4W oncƌ=ܣlQEx\~i[DS *))<vVZk6 Pav~GΖ]:BvNqyWN .,[";DvnQwh o;>0cW4Vu9̲䔎Px虲+rR ?x] 3 #kȑ8qOnlX|0p@M6Ms6Nwy^ >\>222b
}k_ l} ( " SX&OeK c "?zYl *%]z\xmۦJ:B .TGG֯_R) Aٰa.TSSŋ6 H] ,ewsޕY2}Ȳ ~H|ˊ=" ߒ.(e;c}٤=YkzTQQ6+hƌ߿VXqx M"5lذn_{ݺuZ 5 t "/ԟ{kn^b ܖz.W߶t^okRtxyML9)(T>t P H+VHW_}53ݻo}KrKǀ.X@/ @, {A` @z c hQWlRA@=VmXo:F5mWKW =|n:wݺuIŋ몫͛3zh= OR"uX >
B H1Y o5}[+I%jܥnF=o:FJlz] 2Xʘ }\jow^w}IF{ Ν;/~Q/rsJKK__: ۻ}] HKA )&<م DTo\w u,6y{ȭ[J^Rbr6۷]c,[
eJhQ? >Q;WkWhH Nt\bɍ+tͦM`egg>zLDB/ ٳn:6 &Mn]wʕ+uM B >۳YNǿይ{A~~Cwz u)W*;TVn_~&{SO=\86wj7mSԫ2 D^$n<4Soկ~5Y/u* lNffNp
ZjU`s Hm۶u =Q@}NVf 9'ɲ,k*Ꮶc<ϕߺ[nC˖WV^y% Zzh?]yZ1Қ߾_XᑳwdmG3T qo
xgtuqz_RXL7K?9 $SG
)AYd + {,KVv C+XV^
E8uk߰t H+%yv(̯1K
%&ۚm:HCG (;0StCJƍ|;uLK[+td
nrk9sf`3JKK Pwh;` =[{{{y^ R ! g۷Cڷ㨣K̼ Uz䱥y%R$;lnBKMQ^~u.SӾ$|8
g*cߨs}˗knMr jx B ! ;[wۻWF?, [j yaf^̏qy#$%.O3Tr4ɩ lܺ5 ;vE
C)/{> _~[s3
b!! 鉂 bkvԫ,',+DVG _Zrל"ɲ>sUJlz=n)6G6 3eL7܄(i}{6-KbΝ~oہι[zj555: tvvv '
B >w-U("ãJ|1Z]1$VSS <9ַ-! Hu {߰tO);tWR4.쪪*͜93 2
B c~Rmoَ"cNRSS^|1]_Wd|; HO|G pLb+ w 3tYMHKڷo?,QYYӧ: TEA Wn\7~!-E RƨS6zm۶iҥϹ @* ~ENe(+ti:B>cʔ)*++ | 3xw*a1ɲmg,{e˖=m .t ;V)u*+t`EѤ 3:k֬g j( (o e:ќՔ FA_~9Æ
ӠA @* DLe܄$G ;KVFi#F?I>gʔ) P wG Ef:EZ#zڴiSs8g J( S| 5כqа$2 #mo:BZXvm3&L ; 4BA p TAA pܽ[Yb:QB2 V(%iȑI @* 8Awj:DŽ.0 6 |Neee3 H 'ȏw*91>βz@}_)++ | $$j;|yqDA @ TY +7(/U^jCI[-; 8ڸ͒CĎp7Տoi:uٌL%F )m:pR"H3s/ MP =\H,ix k;f]8HVV 1 ́ UP `HNӪ=]1'ۄ2s kF>5-}7.n YNd lii | $AiC}
-4ӨJOe#RO3pOHߋ }RE?t%R3Lǐ$9زt ddd> N( F!G!OU5S)?s T?=7Z"zcΤ$ TAA I()5fQNv5SIltjvZzmˏٸ?$ ؎t9ss>\UvBSe[,+P~~Q㖌.
B ݁= zaݻ=Ͷ }3j ]o
wknP$ݔ(%)Tb*1㖗
B @: (-u(OG z9SNXv{o֮[>Ұ
OtL׳ fU&7*s%; <. *QӧO3 @ C#]Mv5qSx m>+/u?tm'ߗ}OD; 6`Q/ewݻENpIp!zu]W P VQIz)Q jOvMLgˏƤEտ(1Oa}JVAHX(q),, tm۶): TBA Hy4y3Nu5<5ʣOs W&){~K_AD UF^ipI.6 Cm."a(q8p` @ j+|;մ&ةQ [FKo vkjlO#[l HV};
b DA %##CEEEΠ
B @RkhOƺ:tO=$ǖ~.'K.?{*k/%PnTRk~-/wOBN3C MG KeL7> УٶtOgOpui tC1>wkZۻ kX¥2O{w}ePR*e# %E֮] R
! GXiѬNw vr_wuߍə'Oz;F J6m@_+יN!y{ IrKe"1Q. |TaÆ\SIIBaeee)
) + } \Ç\ Iڿz-z x˲4fM>]SLQuul,UW]͛7'?n @Oe1"E~j _ (53{
Whݖf^߽V?Q *9st}ݩ@ . uV=3_ 8ptWXX .KbHpXSLє)Sڪ_|QO>6md:Zr Gw>kUPHgym۶v2335g ͛7OvZ w}<]\r~ jҥƲ `! lsE< cLWKD Ѯê(tqmKxz{ Wt:$Iv^@TUU믿 A,K{/hܸq !Cn5\~Zh:V2dj͞= Z^^-Z/\+VЃ>
NeKuWt|,t%hٲezt^/77WW_q>\w}^x:;;MG ( ƌ 9 -8UVT9 7~n~ c߉iĠ( +|Wy%ϕlY}d")zj`kGQ-[,pgkQuu('-++KW\q-Z^xAw EaTTTk߭|`YNSjݺu{rJӱzP(?_^{ h:Im[ӧOӵf} +_һ% /TUUnfܹt TkdO{aBLr*hsڢ~?]aFu(?p)̓wryde-\o6&O گ[;M8Q74j(Q](҂ 4g =czuAӱzb]7o^Q F {G˖-ӏcmt^e馛cK/{G|mt 믿^gQ o _W~zq HA @'GՏoQv.kޙq=n~?C{V
-OkSl:4|[WGE=ӺKzT8
=Z`Aa6m~c:NW\\o]w}w,?bY?|wW_ Kw|M7ݤ'xBs/~S @R tQBʈN{YcZ[~ ma}qY]X3,
:ic+U@rM4) .655QhѢE딛{ڵK;wT}}Рh46% *??_PHyyy0`t):GuE6mڔٽu-hذa'V[[mۦC---bߗ"T\\rkȑ***ꆷk e]3f [9t0[hկ*''tu͘1C~{ZD=ϷpX]vZuc*3twfJ @w ~a\)deHOQ]~K6w/7B,_0Y ؇_4;tI[b:N?="瞓fE>p@~?~ Q__Kw;Ｃ]NN(ȑ#5yd͘1C#F8ᵎرc#G siݽD"]wup»:::d;zwy7SQQ &hƌt CA 6%755*44}tPGca
1=EFD*/u~[ ReY:묳Yu]w duEo> ; ZfMJ$Zv֮]_4h.-\0"ꫯɓ//ڶmck???윝6mذ˵o\bDCr+¢ HR䞒{
M}ggOr= ~;>;>[h>_ Szu:سg[رVURSSu!88۷Gbb"dq3M4ʕ+cƍYBBƌS픔 ;v 'NK.!//yyy(..FXXʕ+իiӦhڴVf =1115kOzڴ\2ƍӍ䠠 ӧ.H6L~@ H1g=lx~p ̨\jfsz 4ޙwE N5h BboݺUs70qD< 1>c Ο?sbҥ y+WNhڵkcŊx7fG / ^rwwUdbnn. |hѢ $s=xPXX(4ޘL& =>1N8[b֭HMMfff"33)))شi Fҥ :v쨩#qe|Gj"Ma???t Æ
StZ"""o`ljCDD$;cxxjADDhqg{挴kkʪ]]S=COݟ; ? XJN7 8aQz[&Ihݺ5jԨ!$v~~>>c!wIII|ވ;JU˅/F®]qiqQ| uz ~~~{{͇Ya61~x9r$V\W
.\
gϞEݺuOV^ {/ك\|;w.Zn <$̛7 BNNWq233{n\ΝCjU,5m6m&@[֘鷝mذ!z-tYTPصkڥNwɈHo˺0 ;aBbDGpjP{ =\~U7QX{GWdM3~M)`0m۶Bb :tG l2{WbԨQxב%:cի ;&<_nݰh" ϥ*Tﾋ.]x:˅UVo߾HNNTl=>#իc>]kذǯ=s
Aadٰa&LPdvF#.Cț/.]WG heɮ|/224uΜ9}gA=syQF1tۮ2e5kܹs=}Ř1cdmjbyؿ?L IDAT" ~'OƆ
Ѳ-[b̙u+VŋQT r:شilق<쳷lbVvmr+zꈍתU SNB? r
aZQXXٌrhРbOؿf&I!VxY>dS ԛ `Ѹ"<6 i7 3bJF=Y,:eUr` N ` $ѣO?$$'$I0p@_?bرZ*+9Áŋѣxׄ؍ҥK1|pI&y&233GƑ#GUoN6lѻwo<Ӫ}r`o ԩ.\i^zaȐ!0<_% =zG ũSpY5 V7o z5k9cĈHJJR"""9\ -"ԅ}B+<^U(¼mxo?|w%
*jd ˪'
K +{[ Ӄ~~~xWjnܸGlszwF>} w}WhI:tyy ?Я_?M7|2
M6 #I^x<3BhI1egϞE߾}m^jbɒ%ڵ+6oެx0ܣG!**
.Ĉ#nb˖-2e
:vN:a̘1X|9qs9+W'O>5kn{ K.]tAƍUODD$7cxxjADD)° v\.\ .Hcq(s0b\ؼϳl@xFkVRq+C"aH2|sj[[F5 ,$
4ȫng˖-OFL2>ǯݵkƍóseՔ-[e˖BWE]vػw/\",Vo SN
opCHH&pf`Zqayc$> >|C XAAmۆ_5BH2;8wNѻwo#..Æ
CժUoEEEؾ};z-L> [l'/{m_;w͛jժy|-$I_h^"""Q8AHD#رe_~
`c<+=lGBI5v`hwV:{ӌC'}#C|e
,!?K.ٳe ш$t&''c̘1j^#99Yh ̝;11*RBBN
ѳ}V+y\pAPe\.̚5 ˖-kBރ"!!&LrI<TwكD| /^]v ͡{mCgggc HHHg E:<ƌgyNR,5wq7ox^"""|n Q)f0 w9-+F*Fp_{~oe\ [X1G1KÎx!6&!]Vd; S}E@@q.\tڼvǎ Cl2yk֬Ν;eGǏ Gxb]8 ,[ ={ 5jz)H6t(4)lXjj;,eml̟ x͌"A)
UrC a҆#FԱZxU۷/wkWXC\z1b'
4/,4{| 9s .P:\.NcX0{l ̞ͣ=OJJZڢ"̜9SXzc 0@RSSѧO E DDTzAHD#d [[㖍|{] m\$epLBx#0fN y*( Sw9:lq h۶qMs ] :tWMIIEdH}Νøq7m;vD9#(ioÁ'z=v ;Vx***ʫ;-ǜ9skW^_~O<9rF&Sega̘1x/),,رc|rE%$$YNDD$6t"&҅&0m:b}+SlقdҖ˗ ?l6#)) Eh QƎ 5jxl,[L抴%%%o< @
[vZorniիѧO 9sƭ8 ,^cǎ-}aԩp`fϞ?\xVZ ADD$DD'S0e
9@}~#<Ɓ n
6hjaŨds
ڵÃ>(k̴4}W+9\.!4O\\ F!4>(:w/_|7ֱ5k`˖-BsFL:UWk+W97oeH]NB^jժ[\rr2ŋ)&Wbĉ=~ך{e˖^KDDliT]|wQF$}r:晱W}}>.%?6I äId{NxV -Zx7zn222;6l(<\ԩQFy6B|ӅW\
C.'OBݯ"̚5 Ν;bb4hzcǎ]&( N'&Nta9ʔ)F ODD$e\1܆l=kf {
F%IkClhQ߳&a > '#Eu40AD
9sdȱZx"[LO5lذD9N,]TƊoǎ ضm ƍѨwłSz VXQV#(jgϞ8211fʕ+qe+Җ~ #GD6mp]wk4i S+"=z.Av?3>3ak-,6htKDT
Ç?hb
_eWƅ !CbI peHRSSN]3dX,;m۶hWX| ݻWüy._ @!""6TªH|@3\1ZF{7H#Vwa6xI4&.ha9F! cܹ
-nrr2z)8qBØ1cJٺuk:7l6ܹ&ϑׯ_999ljݒ%K#4GO )ɄaÆy]v!--MƊH 8v BmذAص +$.h#DDF5"ԋIWލʠ@
4IHr`bu;jp8{&a7\.At31xO۶mC.[Lo=VZ2To۷oǩS0xTll,zU8wͦs'|"{?JI?k- Y"m$ ZBt:\ ?? yyyGaans5_`` !..Y&ʕ+'d$%%!99YXo
4HFe+[ > !!!B$&&bBsߏuӃwUl۶
;v | y3Oá̃5^: x ?~\Xjbڵxꩧy0{l݈`ekV\)AXlYn7nFKXP_;cvAv&:I>ǏGdde~)uy2
*m۶;yl|Ijj* 9"<#<"<ǍSxl_-<ǝwމXyG -q 799934r8 $"vU'VO/B(uVɭ!yJ +jM&|QX(W5p(M][._cǎ9s&._vIգGͭ_^x5kJ*\VZNi͛7n $I vǝwމի(Fzz:.]$SE DhMiZJDDt+lɬ^'NV 1TX
f uzuAj
R.zɯ[ծq\l6v1cƠK.uܰX,֭1SRRdKl٢D/
B""Ԯćm
V˕MPT
FU&,L3;\3*o
Bt VT|gxЦM 2_~noSNǼx1}͝u",,Lx С,1&~8 yn9 UV(ǏP
DD2Uʼn' B6ȋn}Kf,ыOoY+i5A( Qs] r cǎŁtӱsN,^?<ڷo]7?BaҨ(Yύ ÁtYc^ u w!45;w=&̷_~Ex;Sx h߾,qΝ;'K """"7uz5i9 -!(.
"
B%&>{^Go> >\hp
k֬K=55 %"ZN,{W^( c\ &?䇗aWhZ+F1A]j"77/^ ?es:QQQYq9} 'KVZj%{LÁL'O"++Kx э-[!""""c M/ 9 *ݞds۽z;xv?
OB `L\U"ͻ{ 9rvwh4jժ⇅^z~F/p:8tފѐ2 !0"ю{{7qxقWݻU
BCpsވ+
B[v> ;;r "͚5ڙt{G Zjb7nXXW~"""" DDn2 ^* \7 ]1O1$/|R%s5 +Wo.JZ`Xf}ǎ #22RXl9;5~M:
*@Îׯ/[,N5lA!6HA vscYp%l6xaE ǁcb>( 4A
,lpf.݊/O(b4"B稨(DGG V ,$vݺue B""""
B""7SGs][_1 )+f /'T|({]>O\^S̙v DרQ#a <4pY_˗W5dZE)))sF#j֬)[<>@DDDDװAHDtCt'PSCN{?Z19bŷ͘$kM+;lhq\R"ͫU> <%ĕObӧO !:Ry5lBHח\7e8AHts^(À.0o &-6g
2VR6M8r.H,Ր o{ B '$.&O9D\G111{]!M4A6-l+FBt Z:0"X~f#O7!Z\(\PDzPjU98Mv~hKb߳! 'AFg 5f5 DD7ۣaS Bҋ6MX6傽ňG#BoV,`lEr݊+%i控D$ fO܄)TNz&-M<'HO $"`li#Ө O-AwǶ^+Ne~ PHL Ҵ6 j{022R*=Q2KyFna:~FQŨTd\1J_مӊPwMB 0c
\^*Uu2DHr+O|#RJxx.o߰Jl9^!k5䙂MU;˗dML""""'6KE}>UWADQ &[s%k0rEOD),3jAz^4Oěp }
L&}HD0,,Lxn6khb<|7a'IclxMow3R/y$,_ 1DTS&m83S.HDO}ޝ1Y&bszkF=DDDDt
DD : n@N?3I<{ɂ{ݟ /ư*%i^2bas3VUh|_!???}QQQr_GʕlLDDDD_lQW/Ή׆ woU0 &2q}1M|`,3g͍PSX`P3eiGF%{L=QHHDDDDD DTE ^L,a`NYS}+,8wֿ'p+'
.D@tsGč_&sUcA="V^OHĤg~AHD3,sA;f]fyNK?{A1J
Bg)K tA=N^#ks ߎBvv1E/_^DDDDOlQ5
)pAle 0Vj$.\Yp?%CD7w5د}nbAٲe5"'E\C"TZUH# $RbyX؇U'"W)ET N`?t{ .ld! rv DQTt}2gDO?^ ͞y 2`JWs{[!Ouz*ՀZz p%]n
I
z r spHmP$$ISqH $Re
yV \qgC $3NOLXYT_fBzÙv\tիBF6w<`Xžte!{V DuticZu\~}!qH_ $RJ:/z5&;b@g1sfA"df}W }'D76=UL!q N:%{ܜ 7P&M%""""}aJq%K*䗙[UDrRA() `C $_s@aŬ_VAXzu9|ӰZQFB)H $R*a>ylg W+ $˗?cǎ {E!qWJ F)B!Gٌƍ
B"*Vmùu,< $=0 ?UxcymLv68/P "]9{ uօ$QD5NaNN)BIPn]9|)~MXlQSm۶
B"*U5E
F?#P&@p1D21~eq":w !!!\<@Ԕɓ'5` ezq֭֕-[VX &$n֭a4I,""""*16vGS|m03۽FDhK+= k ծ .Hw\|y4i"6T? :NۮD$;xTK;8. ljAKGo7o NXX1V+ ;a믿
6GD5#$5"~a/DDDD}&JDMpPgu
H>z 4TCXeyOarPV-yNݻaZe{SNHh 뮻;QM]v z"'ХKaH $R6, .HFf?+v;KN?]n)1 [V$^IHn߾]T\\dyx
^TT1كB^(( 11EX|"""".6 eyadKRoj(
J
. (_2t+== O];
=XA*TaٰsNYcތ3 &&Yll1m&{r:B ODDDD!S%|SS9
ܛ
WÅJ7&M $~`?#4۽{ G*W,{]v!?_( m[Er_GVU&o&4SO=Y? $"L(]w.^q!Q z:P
.cl8.HT(IHHP$ ڵkey3ǎ Cff<> $
=%eʔ -[(d>pQQQxDž """"aH6}N^Frt짟տC he?w p"
_'۷o'**
͚5Gjժ%kupv6nܨHN:)Goԩ#k3gȑ#ƼB =zTh@Lx xѲeKyHs'H#yjWᙋMr( Ț0VvcO٩v TBF>W^_~iiiXdp Ʉx}駰ZsWjj*N<)AW.«] ݦvTB75?&wkG/4|]v!%%ExJIITڴi#<^4h fYXVW%7nݪHs`rY'g{+FC$3-7%ںyr:a?C2J
s''ddd("2((={G/7o.K ˅K$V\H !௳doC\/"֭H.""""R1GMuKl $QSÇ!YB.ov$QOYٳgO ϣuZ,oߎG$vڅg
֭[ ϣr5sss [/_Ʈ]eX0g DEE)!M )obDAHb5k }j/.Tkë́hMɓ'w { ϣu-Z%neUR. K,Q$נAJ␐ԫWOX>rrrdU_~b[oZh~ :ty
B"[XވlKWX 4bT2I@(Gz
WN]FRlY+V(4>ywUdߓO>Y'wڷo/K/ĒÖ-[p)yЭ[7yM64IT={zwƹsWzu;l2e`ڴiX` ^{
/v"""MںED1E[KusDr(錿-< cXe=y%:bvM6 cX0l0y*,, ͚5+q ,\Pt:iȐ!r뚄Y̚5 EEE*)Ӊ>HќkƼy|I ŋᄦMC*UEDDD$DD[?\Y6+ww}6:I`Q2ř쩇.T1VZBy XVy:t&MϣEڵeb7Dnn ~ Ѣ;,qm۶aǎ %/HF6l@ZZ9ׯ{g'x3=V1mـk5֥4<HS+F
Fn q%U\Bsԯ__h|^ZZ-Z$<$IxaXIеkٽ{76o,CEbL6MݻQFhM]a0G^^ |M*n |x8> Kll,.]*UgHlӭ~H#B$٤#0FTSqf {/jQԬYSxJ*!2oZrJ$'' ϣ%-[D5J#77ӦM"1RSSi L0f pb +qٳg2T$kɓP{=tY"4lK.dV"""`
E6`ڛ"ʕ B]f?m\0nv7d; pi4Qb$I!8 $%%n ջwoq hE^J cԩ`G }]xRueǎ Q\شi֭['SEs8 M7Z,0aTA?0-Z)
B""7}.kk X ZX1*YBi@?ӃhѢ"yڴiH Nrr"FF#"<6l͛(ի}v*ǏWL˞={UV +Q .h~ M;_Nxo " qI:`@"nq$ vR]e0X>ĤIAc[n[ׯQPTT$cUw 7|Ex.5DGGN˅)SjdVVx
Uk0 ڵ+K(V\
:Á s˗= r[wAHDxsGT.Yš]cD ̍W\M⢣ѱcGEsv $\|/0` ڶ晨%#FxzՊ#Gq\4iRRR]6^y$g-Y7n*el۶MUcȑꫯгgO4k֬ `ܸq _ɓ*NJtSe+[[gYi
DD Z
6^2Of:P FUߎpfSR瞃kR )СCxׄ$ SLݙ_燤$oغ\.L:ǎ 2eիWСF -> ͛g$ ͚55& $"é)" ŦF, $}R B?3,? )0TrZ(:tvکSNhժ*}|
>yoVZs)^@ƍz51=%/bܸqls%&&⩧G ͚5СC~Ν;1qDt|oaa!Ə AAA֭VZ z~bA 0{l[ݺu_fgg dZn-{HԬYSZt=ۡC!qD2vDDz:t z5 CjQԩSfR|zz{/vڅ jۻw/*V(*oT IDATFlF6m~]_O>gƹ\./dJ]'RRRжm[ bm9pQyD^:ϟ:ݻw+"X \|ڥ$ID˖-OC^:ʔ)Ӊ
6Dǎ ѷo_3 :t@*UJcժU^^
O>BbaBbkEʕ1a!ﭱ to2>R͚5yǘ w90woF~<M딮ƒ*a ?|gJvtb xĮreΓмrט?S]>*o^Fwqf̘rʩ]
2220b8qBRF#^u!S aÆ~Kn=^|EnԺ\.̜9WP6t "k,X>@x wֽ{bԨQnΝŋ,**BAA $IBPPaXP|yTX+VDDD# !C44$ |ׯ/$j#<+W6I0k,w}r 9r
ܵCDDt3ly` (B4^{߄eܛd|2S$lkF\ ^+ JWHB'iUk([ qg(5F#{L\7{Uٌӧ yMAA&N ;v%~aȐ!^طx_ L[v튱c* 駟bΜ90RÆ
1g -J-[`ҤIsU$IHJJC/ᩧBffڥ1p@9~p8 Baذa¦/zj̘1Cx """9p(\.riZHMPـ ~1`^^dª~5ŀ|3iLs >KA_ ZvFoCWy X,8|O۶mCJPF
L& x>GbW_EϞ=jbԨQؾ}'99ϟ}'~h֬كJꡇ o2exO>ӦMM3;wD͚5QJKэ, 2/^T$ }Ő!CR
ʕ+={hOH!C_~W BCC}|DD%pOZ5v"*\.0C35DyX+
&,2cw~8~ 7Is[j: Rيh3IU sQBԮlƍàAv97%I7nܹsjD7r#$$DJk]͛7Ç-47֭yiӦ^ʕ+xgqP:5%%Ǐ G֭N:!--
O4iy* ̙%K{Ӊ۷N:U СC￫]aƌxYn]4o ?3rrr+Bpp0&Oݻ+^z]6 <.tQ"ｬ%${ֽfFvjΓ}GGUmfOI%=!@
CBG(E *EP|(z@EP6**
ґBI]H HǼ i03{~kLc_=ǤwB@ SGk3u,"`lm_oAVd= s.jҤ N˗/cʕHHHꂑ#GbڴivRb͚5Rz/cĈ5O8wyήe͛cѢEكEv_e$ )Sx<̙3G ru .D].a`ʔ)pإ4nǏEsh~zP*PS}Ō3D=KTbҥ?t2^ yĶ_w#RLYOفy&B O
=`|5:tσRL²zuI}6`$ 5;h/Ƃ l0ul-hժ:w#22R쒬 ۷o{qI r0111X`AL |Wعs(R=z4F
mh4bXd ç~ :e*
֭ʕ+E A@1n8hѢ9{,fϞ,+VW{r̝;
ɓ'#55UR ~3⼤6mڵk.v90a#gX[VVVZ͛7XrLYAt |h./.PN-/XC] ba)N]`c.
R(l;i!-MXփk x٧ ƌFZ V]vh ڶm͛|L#P*8y$N>3gŋPTbBBB }vիW~zlٲ.ρ-Z'^ᣏ>BBBr9^}U ;nR 6ߟ? z
5v ֮]K:D7$ x
;VR ƥK0}tQcL 0 {hT`0ɓ?g
BBB0l0<v벮 JDܹ^FDDc@HDd%߿A9.sBR8
n.||N} G 0 mOsderl˺Aނ۵{9A2jAЦMo m۶E۶m(vYAʕ+8{,Μ9dܽ{W천T*K/TujJTbϞ=ؽ{7 ;fڵC]ѧOG
tKHH \+TX7u]z={nݻVٮD"AӦMѹsg :txƭ[0o<Z>9s ?%rW}3g(̂j03
`ԨQ4hPקr6N¯ݻws|ڵkw}M4KJJpY>}.]Bzz:+<@
!,, ለ@XX4i:۷[e{uM HIIӧqYܼy+RFF n/**jS K p@-pBJEaƍv߷L&СC /qv߿XhN8agȑ#Q^=rssdlYR0 $"34ŶX3r$E}~Ź)YKR]IRlM9z;NmqqmsLlW]q+J ^47gУt`Ƚ.v%رckAzƬ9+Lcb puݖJJJRPZZ
T
xxxؼ3C`Æ
DY뮶ٳҽj54
[~lkIIIXx1oW f͚]ݜ9s |oL%K &&шUVa6O߾}1oc˨RSS1fv$$$ {Z7&QFڵ _}.Vsqq1c /ԙK/Dbbإ:ĬYsFTbҥظq# Qg2n89sfߺu+l}GG ~ ""r]ԇ])`K On ɿ-?hضsv= }߽nb;̌Dۦ -:?
Iq0p7
gaÆ]BѤIlΝ9s ~ĉѯ_?H1\$:{ʕ+qE˩j5VXcĈ7n <<<.˦.]kb\L
فN
աyLVPի5kZh{LVwVTT?kH[)))ʕ+i&<3xgڬXj ?.v9uBaa!.\~
'OF|||p4E*v~
CAإQ-mۢM6h """ iYUt: ӑ/ܹs8О,vDDDDV ԫW DJZ
^R|T*%"""r> %"tzr,#p~gurtkg@&مV]R9㴈jd)DF
\eww~Wd}̋Н"vDDDD6Q\\b\蛈 3Gڒ(kv{ek>Hf-Cبz|^ 5wnc, e
2 4*JF{""""""""?DD6f0 |m8~QR^)jӭ,PI8!alk
?% Eۡp
$jS(4%()""""""""rR 9)-e 2 =WDgbĆپaDDtހuzp5Cj ¨""""""""rb ӟjݣ{0+9lX67# uvgT#|7TlgD߅4+ Ϻ$vDDDDDDDDt ٨' :#Gx8# ;N_Bhb-E[=~o@-JM֠ +.!=}^|e"- ΦZz^) њO}_
ovŴrހ` %rWE Iڢ~ S. B""*,`ٯkA{\#' :0OhaP":,:b{Oifp d;\գg]yca@HDdgɐic}SJ0+G`j~ o8|V )m¥TH<.3>
`pЗ B"";dYF+;xJϻ9jQtSFꬺ]g_0Z ͆H5Ṹ*a1RK!""""""""2SRH:_u@wť` 39jQH$Z|:EuEz 7
إ<2Cq J,PR`@HD$~A_EXNj>D%KU@UKsy1|
J%v̨RB%w.\ Dr5+ 5j4 m;hٸS\@V5 ＋CNGfT/`(""""""""
1 $"+9 d gSq`
!F
OlLhL+ /7J7e<Mɽ +!""""""""*ymMm}zýQ*]vW()yNj&BeԘQS҄/Ͻ!v)DDDDDDDDDUb@HD$M8z< 4m@- >[]~PI' 75psqN_.4%PŮ" Df4At ki Gcz^WA
sAQNbQ#Fuѽ5sQ#DDMEfug0 3Tؾd]:Ҁ_?Q}T݁1N=/#4^bQm bBDDDDDDDDT-
2Ε@o v%ɪ~
Ε`. 5bj=A""""""""sQ_7eP 6(O]Fb,qK!"""""""":DDT6Hq
?2:~<Y=h(̂jrR.&x7H0k*ؕPmwW /?.vg]BPtGRl!Yj Wq(=OόEM22{T{!"""""""")DDdUdR*vTK j]b.,90ŮŌF`29
%bBL ea(B8!v)DDDDDDDDDvÀvsq(UG^@W2@S
.ȮQ8"ŖD%|C5 Оվ¨) """""""""c@HDD57
dp(U(,:3F2L"- bCDDDDDDDD$
DDT#*`dBU 1MYPg^"""""""""Q1 $"K<-?dbA([W@إ _X/v5DDDDDDDDDQ]""z$VfijbB"OW@zqإP͡""""""""" NTubC"Qൃqإ@w(k FR
B""zdF#7rx1;; U!& ۥ~aT)IZݭ3ADDDDDDDDU
H
1$t62I(ҹZ>ԇ@: B""n.ĐR,`!Vͩߡ Q:jIfxJ.>S]eʆ .j s$8W:&ZjX4m(,,իWqܸqCRr ݺuC||˼
+W"Vn?7ѣѦMdrrr
QЦMx{{=7' & 44oƟ "$$ݺu3{HӫW/ |eSO!..en˳BDDT1 $""$ZOfHX[
#_Z%y [ݭ3AuSpp0 =z ?C ;＃pl?3zZWWW<0` @ӦMѱcGH$R\sٳ-[`tfquuȑ#1h #""& @ ʽY.88]vT*-vZm(..&M XWZ֭/2.7 { ,%""} "h hqSYW
cWFgi+h.- `Ȼ%^ Tgbܹp/8<ܹ#na3gDTT~w_q:NBAAڷoo
õ @JJ
L&M_~q1"M-Z`XfM't:>}fanBBӌ~: ]#GTQ岳sNueNعsgԩN
ш?III~wIJJBpp05jdv[^^ vQ1{Avv6:t An;tӭ $""3yʑ+ZT(A"3% 7R
ˎ!&4C*v)T /ڿ qIhyf mZVOhh(LAj*\t ,_ h_{\a߾}رcnߙb n*Cv'i!!"R
Bq.7'4M,3M9xȆڴiS溘upկ_ Æ
lڴ))) IIIV%<< s5okݺ5b
:t, M O> kѼ9~8 ?n Zqq1 ?ݻcMšCDL4 ...Ν;-zV 1~xxyy!99ݻcƌ1ߙb Ȯ~#ŝ|`4-\ 렻#:yz >"!-RRxJ.3_[CkT"zq9>,
]'OU?NTsWUJ!'2!**
/_ 9r :'N}Y۩_~Xf
v\FJ꾑#GBP`0رcbSdgg]4\% #{߿{۫ubAqq1/^\t ?O*ƀn )^+w4bHXY1kPbb7+ ] @CTt[LLC ܺu %%%A j*..66ѥK @FFDvy=:*R`0֧\ۓJ:t({ G >B*&T}""";".8o ~iAcI ԇ~j z
8rnjv[ll٘*Ǜ:E8uT._B[F! yJ @ff& 9 %""dݕ.;;5n$N{i=%]Z2 !j֬BBB 8r@DDDU^m۶5# d;t6l"z9sK,,
="u333EDD$R50 1wRy",<,֥3MMK Į;wҥK0 HKK3 cccqU*?r ͚53]VT~6n܈7Bj+DdoR͛77]TDD#ڵkg̑DDD DDb(,vQ~Ts7" <-IZpD₮] 8`
w?F#ArtAAAffjZ!"Q^=eDDD!96G9h_{EvU߹߹
Ϡ> ,!B.]
ш8 Fƍ]^5k^z]Ֆא|Ind2d.j4h`v!Q""r(w$xq?ÌPccouŇ'kw> '5ɑDRRRuzz:ѰaCuqk|P``UV9s&o>˱{ｇ߿ bDD6&J1e ?? bdf \㙈 ;na;.HY7G
|tE4ΆƢP %[> 0 $G -Z _vG 3hDG81rl͛7nj3P("rPz"$$bDD6&^}U @z/ڶAնGDDD0 $""uvŏʠ7ԝ\^<j K cq.Fɖz0r]2r<={D"F#Gp@ZfT"̙3Ѯݣ8ԩS1m4+Tf nnnx1|pKLf.-[̙3 ˳/y
'ٜ Сϟ Te @"qOr+3]W/ aaa;w.^z%kEDDDQ""rh*
rG^!^jLmP໋O˃7::!wzBcs)@=E w\ȏi=qw
Ew=
={ ?~ e;w t].]qF DEE]
Gv!''0rH `ǎ r9ѧO B"ٳPPPPf[ >> FN8QO&!::qqqhҤ |}}!HPTTWرcؿ?Zر#ƍY6\VZsh֬
J˗/c8uTkh95j///d2#777n@jjU;-2h S رcѦM ##=<GVn jOO?bYH#@lEtv~)w-{AzL:0gs3Bsi7t) }3 Io >>}=xMoݺ3gڥ0|pӧ f/فP}v{~UС^xCڵkG`` L!֝;w_"%%m VZaȐ!h߾
pgrTO?80iԨFN:wŔ)Sj؊rL8ݻwc{>'..GF`` Z-rrrV^y_{T6l z k۷Nj/Xyp%Kpʕrѿ⋐Jŋq
oH$ٳ'F m>V͛ q
3d ;ty߾}X|9{!C0pJ5ϝ;EAVWYSuDEEaԩUu: >2'6 ؿo=z4uDHy'Xjǎ Xre >}gpYYY7o^m }A߾}05 (--EII F#AU}dÆ
gsիW-v튱c jW^RDѨQ#k == /2kذ!Njz*ヨ(i00sLO!""vÑ#
4(
pHd
.I|3m RV2_} . (DW U>Mƈm
2 ۡƎA]z
ٳg+߱cPH̝;ڡ}j*
oVaZF||<&LPayhuAرc1h Flݺ7o6;`^x{ｇ `#FWJJJ7|0AAAR)BBB 4hJeF% #F@&!''vɓ'
gϞ֭[5SpVwwwL8òeːd1h zR&L@\\ ,YRY*yAPZ%%%f 1c hĶm۰iӦJs~ϛmjTYI&!::ظq#N>
RF.5j9s/(3f"O4ٳ'y:a۴iɓ'>j0|눋øqV>;v͛
/^ݻcرeGVVVĉcӦM4~kԨQ ;:voҠ7//垸Hjj*ׯ2 {·y{{c֬Y +vF1c`СnCw.]`@QQÇ#332MڧO ug0 Gj5233PuثW/={ p[/RA}DD^y`0 ++ ...5_pp0ƍ?F5T$88 .x ot;d2Kիz=~7l۶,DnРƍVZaÆ7o >C\vmރ
d\pt/^~ekaDDDb@HDD⓹@i`SM
l
H+*ѹbX2/6ۊ{ .(,Oaq_ h㗊!t-| H `\=].- Ri
8Phfv͛?777DFF'N_~ ze}Ν1l0 (
[՚!MNNل IDAT,[&H0i$ .Ĺs/''}&L{C.㭷oY核N0j۶-&M|,_ N2 td2t{?dCaA0a {nOf/?ɓi em۶pww7ݦVM#w;[RRRa`PYgJnn.VZǏc M67o ϟoյoݺ͛7nnn@HH$''WyN"`ĉٳ'Z--Z3gΔyѧO r6m루?36l2Й3grzyya Í7pBܹst{ff&>3>;J6m0}tn ĩS|x
ѽ{w >Ǐ ǢE|\.ܹs˄1~V{;...x^Yf!==ǵl٘4̝;f=3okÇǨQ _uᖋ kӁצM;˹4r 3gά0ׯ ^z% ={wU}TٳgUV >s ?~ǎ ;C 1]VT7n\Y7_|J o_ ? mZ
AкukO?7oZ\_Uzꅗ_~Ϝ9s,P|WѣG2W5bo66m,L> O[\\ &TY\./ZO:+2rH< w}n2)t6[Ӹqп?ׯq2'+|7ػwoɈc-Xܓ? ュKիWc˖-f ^/VxbZDD>CX!""Z)HO"B;nCO}@1M ) '{(n_G^ÁΩ
lgß7= )n
>>
?cz8h0 %|YC~ ]+1{!!!ZtR]*'N: ] ~+_jUZWq?aGU p +)...e˰{*go.DGG[42::X iZ|6 *p'Fec
+3~xkb]fӦMfׅ l:(xg εyVg*bzSVGf͚wAe ~_>ڀ:-t?7n,j~m߾k}Uu6nXߢI&? {%potRH~JnnnΒ={qF`0u}GV
v-[fڡD")Sдu+ w.[fpyA}/ׯ) PzG )ӵg׀ׂ|eUa˖-1p@ :
{٦彿?
(H*]+ڵkػw/
ENB""*
P
^ "M!x 6G _1zM 9>KBe µ6%%ŢߗL&3 *=@5jdQ*eB\t WV.6lP&w|[U,YN'MzK !fwNv.<2lXfiC 6 $z|%%Vtu$_ ){ B{nKۢ$ɷ]0v]}BB}}۷] [ yyyNْRSS-MSPFYYYϣkѢEu
}Zzd6U^^h0==2iօQӿkN >Uc_`vg}S B @bޡĞ2:WM6
f\]!H ]rEU2G+Uqb[btNtTٶ LC7Z]i\+~^:K<M`f*ԩr.L
E((YYYꆘˠoc}uVsx^UUU]g_zo?qDgϞ
HoS]
ȕ_JUof fffZ[˥|kTеx_!Ikꀽ
=5k4o<@~߾}էO:/ҥRSSe-[Vqke)SVRRm۶Y 233|NK&Llf܀GuVӿ\A(sqaV~S^w2%^7{ֿի~__nw hB @P6wSd$H)[\nV)Dn:`IPsԬޫv ?ҒoX{WI&wRŜVvvbcc}Fu.gs~...?3g΄tHkmIIIiO>ݤs%G0S65ɓ'-aV =tرfKJJχwnvĈr
>\뢢"mڴI}&M
T]
lٴe˖:իwn֭Ӟe@r}vl61·ߤR
eg R.W~ɀusVAf8$??_/BHR.ڳgΜ9c{oO>D }e_ UesޔOhXZ1gWr 6+\an,**ҋ/L.\ЬY|YYYziFJϞ=}? 8p U߾}-eMilUKhN{-T].a 8p@ h翶U8NQVVXa nj~;5 Ccǎ$-].jje={ %''}PwZlibogQQQwբ;i^~3Lv]gVvv?3h? h D(vekQFNw-%ʰpehRMZp
I
A- wNyL[7ȑ#$z]PAIڱc% LNN5\AA2 R.G6`~8U7[5y[v7x-0 u@zxRΝ; ;J"v̘1S4H :tٳg}:W}M\z jcZ~[Z~,ٳ* ÕƭzgOvʕ+[oo ! \M Deu-nR+MWhNbu $m+vsNs6m4ϛ6mj1߯RF" ATTe611
[r+2Z.9xjW BQPP!@K3 2\sA]5iZjΝ7y䀀pܸqvGGG7R%%%@)C/}l>}t
7L N[||&Mn!wd^NQQ!^~C=}Z~g4i$O/B f hM p%GɈMbd&U(;鯡`d(dN{n\wE >]RkXͮ SW! rݻwWzzꊚ]v58 Gvȑ#}[o]5pRip
ZB $45(,rKԽ{wܹ
[^uV1·oɾ0;;[NS+VPqqqǪo9:uIǹZ:uvESLve6mڤoF]v7m[111;vL[;ԩSZrN<'x:CٖJKKUYY)!5M |-[h :t蠇 zHկZ ZMrj'ծ:s]eKQM.WBziG[7%GW7J
pp\;vo{:^5 CpY^G֟6lQwMnߕZU%wMzRzyyykv;[ʙ3g,1c aXژŋaϊ+,avv-Zb
^{ڽ{wm2 #x! jvI˶aӧOȯSS͙ؔ3G2 C^W˗/g}sI b̋Ռ34c _{iΝ*̲2Kfiܹs00 5Q@s >|X? @999_iiiڻwo Ph٢EEh--9bes挕9be @mM PY%={g _
p3fe൩Ӌ ;effjѢE?MWc߿7T]dɒ+z7a9rV^ q: Mԑ#Gg :>lZe8po{ڴiZtiNjӉ', W^:vXK7튵uV7өcjǎ ߿ר+X05|p!)11 z1J]R5JQQΜ9]egg_p}S _0RP}?dI>䓀)K& 3gj͚5*/ou***ꫯIJVT .FÝ$E%[}u]͈j< r6_JGI٢\=J6G%C6+ࡀpUzy p0}ѩ-XWfp9wΟ? ܷ鍊nڵkC ܁aX~% +Bò|њmۦٳg۵kO/R=fk:n߾]&Lml6}zgX'LԪU,SAN6M{$-YQٹs,>[ݺu yj$}!U)**AaܹsHm ׯY|'N'|F #XZ_?{u鮻mWVV_ԡCn 52/!!@LLx K 룏>
nX?6+}ҤIN:i ЬCݺu뼍բE={'$$4 !zE Z)Uyr ζ-u%5j(˾믿ݫgϪK.}ڵkWHМ9sm6 QQQ4hnڨ5jT]rXbnF_ x@/B`a`}ՔU][nol76z5'''7z QFYA4 Py5۲e,)S{zý rJE999sz_ǣo6 & xۺ@+>;*^ & Uvnkck4tVy
:xyꦛnjj0 {ｚ3gNXUEm۶-`ʹ3gj鍺LLϟoPђ߿HU l6-X !++W}SZZn}/?0`w߭Yf5꼽{t-l9rdX^^/"`3QsNN~iM8я{ӎ @X"jO?4 ###>ah̘1>
.}sMq\s=h8 IDATQ^^-[f7tP{ｍojރf5j_"ؿ4 o~^zYv7v~4hl=zt/X/-==]wqGvu뭷JZr=Ӿ}Fwݺu!pMO?niӦuV ymYٷo_
0O?
Z}9yd= z.'$$׃>(ͦu}LIg
C+VX= O^tI%l2{l_߰{n{
ާ\G ӧ |zÞ!C藿eӧQ?wj{9:{eɓ]aÍz
)**Ҙ1c,]vMYףG
>\G߮qiժUjƍJOOW |k ݷo_Y||~ӟgϞxI&ilڽ{^|ŀizuuYCYYYnWrrRRR[nESAA^|EM~kUanTkN:zeYˮJvT KSjĈJLLTBB3gSΝ+##r̴4W&Lս{wEqqqt*==]'NPqq:tI& $T.KSIIz衛oYw}>Ӏe%,:tteeeiʔ)xqFIԩS-UPP+::ZÆ
C=~V
4H.]RRRrrrww:|&jOzAN74j
ѣG[ kIyyvQiڵkF wv7]#4zhM>]WNN┛^zN&LXhÆ
A ?99Y?}5
-ʌ~ 3c AM^ cC P,-C4J/pY$''n]PPPuiٲe:w\۷)---**۷O6m=0
4\0MSwuQmڴ)[M@:a˚WUVVjÆ
Z|yk6FGGSffӮiڵꫯ\KK.zԭ[: _AA}ـ*X5J4hP
oڵkuE ȑ#5m4aaV^%K5e ۿmtC~~~ߩ[nZpaۘ'N7Ծ}uO~oW\\W^y%Z}ݧq 쳠zQ7o+bYrzW\\7xC /P'OE>
&==]&MҨQNZVVJK,
u]ɓ'kȐ!A_TT,ϗT}aRvvNZgUj*-[,tR>hHk;wNoߣ+Ç֞={|Aazz~uYG wmc B\̢3!ϩ VԌѦnш4
/*݆(}Pi9:=c1bD~cFLL PeeV^u ;PNNxuYd|͆H#G#<.//WYYerr, t
{GӦMmL G ?suAӬY|%%%*++SUUbbbr|Ǫ_`Ҝ9s4mڴz 3MS˖-ӻ4} R4Mnرcz'JKK 7))IϯsTڴix
iƌ;}?y֭[}ό3|ULԺu?? 2DsQ kqy-^XK.m6l0=!0hs_x?{\˥ٳgk
˗/ۨ*EG Z?f։'6۵hѢNϞ=skr\J-\\;v쨗^z?&&7 `>ĉf ]v5k&N|~ԼUUUڼy>C ;ִ%\.kN y1O}3<}~~kٳG
N~_| *,,ls
7߬iӦ; :y ߝ?^֭ݻu]RR )?_itw=[YY_}Y%裏ך5k~g.g|*\R }!C ۼy^}f222TVV'Ly7[nmY\^^ G*//;EEEZpa8͛7R_|>:?uw*;;w%?^ ;vUc={VoS !X G
g^̂ڡc{
hFyum S=TRԡ:sئs6έ614rHWҥKtQ}Jɓ'[nѺu_K՚:v쨱cǪo߾х t!_IkvUÆ
SϞ=(PNҾ}tСmf5=TPPPn233.]|[7oVm ˥ +!!A%%%:}6msVrr UXXjky/kt:WvtҥKMkO~,!?Xh
:T\svXy< ܹs:zvb!h =z(66=qℶm0Udzz ymٲEkΝ;=vU\\\gW7]֩brȑ߿t:UVVǏk˖-ˀkƍ/gϞF LCRڶmvfx =zTK.mT?ZS>tPuQi*77W[nնm2 +**~Q|kw % Rw_:u}~?^vҖ-[}'%%iJMMU|| .^SNiϞ=ڽ{w?w hi
!XU:O :]Sׄ%%*W^
m*| ! ]v] .ld~&; @00 '=2OT]xlsTVI] Z_ffn-[qL$?w ` WoU'C! иqp8tUTT fɓ'wn" 6 a[Y&QZ%xPTu fϟ3gݲe P V%Ձ,:#1 =:2}嗗5 @x# Vl,BY =(3̂2 Ou pق[?Wi)S .oi @! "! A B@ DB @! "! A B@ DB @! "! A B@ DB @! "! A B@ DB @! "! A B@ DB @! "! A B@ DB @! "! A B@ DB @! "! A B@ DB @! "! A B@ DB @ By IENDB` pooch-1.8.2/doc/_static/readme-banner.svg 0000664 0000000 0000000 00000041031 14630363143 0020250 0 ustar 00root root 0000000 0000000
pooch-1.8.2/doc/_static/style.css 0000664 0000000 0000000 00000000742 14630363143 0016705 0 ustar 00root root 0000000 0000000 span.project-version {
color: #999999;
font-size: 0.8em;
font-weight: 600;
margin-left: 5px;
}
.table td {
padding: 0.5rem;
}
.table td p {
margin-bottom: 0 !important;
}
.py-obj {
margin-right: 0.15rem;
}
.lead {
font-size: 1.5rem;
}
.front-page-callout {
margin-bottom: 4rem;
}
.text-large {
font-size: 1.35rem;
}
/* Overwrite the main link definition in the book-theme for button links */
main.bd-content #main-content a.btn:hover {
color: white;
}
pooch-1.8.2/doc/_templates/ 0000775 0000000 0000000 00000000000 14630363143 0015537 5 ustar 00root root 0000000 0000000 pooch-1.8.2/doc/_templates/autosummary/ 0000775 0000000 0000000 00000000000 14630363143 0020125 5 ustar 00root root 0000000 0000000 pooch-1.8.2/doc/_templates/autosummary/base.rst 0000664 0000000 0000000 00000000240 14630363143 0021565 0 ustar 00root root 0000000 0000000 {{ fullname | escape | underline }}
.. currentmodule:: {{ module }}
.. auto{{ objtype }}:: {{ objname }}
.. raw:: html
pooch-1.8.2/doc/_templates/autosummary/class.rst 0000664 0000000 0000000 00000001312 14630363143 0021761 0 ustar 00root root 0000000 0000000 {{ fullname | escape | underline }}
.. currentmodule:: {{ module }}
.. autoclass:: {{ objname }}
.. rubric:: Methods Summary
.. autosummary::
{% for item in members %}
{% if item in ['__call__'] %}
{{ objname }}.{{ item }}
{% endif %}
{% endfor %}
{% for item in methods %}
{% if item != '__init__' %}
{{ objname }}.{{ item }}
{% endif %}
{% endfor %}
----
{% for item in members %}
{% if item in ['__call__'] %}
.. automethod:: {{ objname }}.{{ item }}
{% endif %}
{% endfor %}
{% for item in methods %}
{% if item != '__init__' %}
.. automethod:: {{ objname }}.{{ item }}
{% endif %}
{% endfor %}
.. raw:: html
pooch-1.8.2/doc/_templates/autosummary/exception.rst 0000664 0000000 0000000 00000000235 14630363143 0022655 0 ustar 00root root 0000000 0000000 {{ fullname | escape | underline }}
.. currentmodule:: {{ module }}
.. autoexception:: {{ objname }}
.. raw:: html
pooch-1.8.2/doc/_templates/autosummary/function.rst 0000664 0000000 0000000 00000000233 14630363143 0022502 0 ustar 00root root 0000000 0000000 {{ fullname | escape | underline }}
.. currentmodule:: {{ module }}
.. autofunction:: {{ objname }}
.. raw:: html
pooch-1.8.2/doc/_templates/autosummary/module.rst 0000664 0000000 0000000 00000001415 14630363143 0022145 0 ustar 00root root 0000000 0000000 .. raw:: html
``{{ fullname }}``
{% for i in range(fullname|length + 15) %}-{% endfor %}
.. raw:: html
.. automodule:: {{ fullname }}
{% block classes %}
{% if classes %}
.. rubric:: Classes
.. autosummary::
:toctree: ./
{% for item in classes %}
{{ fullname }}.{{ item }}
{% endfor %}
{% endif %}
{% endblock %}
{% block functions %}
{% if functions %}
.. rubric:: Functions
.. autosummary::
:toctree: ./
{% for item in functions %}
{{ fullname }}.{{ item }}
{% endfor %}
{% endif %}
{% endblock %}
{% block exceptions %}
{% if exceptions %}
.. rubric:: Exceptions
.. autosummary::
:toctree: ./
{% for item in exceptions %}
{{ fullname }}.{{ item }}
{% endfor %}
{% endif %}
{% endblock %}
.. raw:: html
pooch-1.8.2/doc/_templates/layout.html 0000664 0000000 0000000 00000001017 14630363143 0017741 0 ustar 00root root 0000000 0000000 {# Import the theme's layout. #}
{% extends "!layout.html" %}
{% block extrahead %}
{% endblock %}
{% block htmltitle %}
{% if title == '' or 'no title' in title or title == 'Home' %}
{{ docstitle|striptags|e }}
{% else %}
{{ title|striptags|e }} | {{ docstitle|striptags|e }}
{% endif %}
{% endblock %}
pooch-1.8.2/doc/about.rst 0000664 0000000 0000000 00000004144 14630363143 0015251 0 ustar 00root root 0000000 0000000 .. _about:
Why use Pooch?
==============
Use cases
---------
.. tab-set::
.. tab-item:: Just download a file
**Who**: Scientists/researchers/developers looking to simply download a
file.
Pooch makes it easy to download a file (one function call).
On top of that, it also comes with some bonus features:
* Download and cache your data files locally (so it's only downloaded
once).
* Make sure everyone running the code has the same version of the data
files by verifying cryptographic hashes.
* Multiple download protocols HTTP/FTP/SFTP and basic authentication.
* Download from Digital Object Identifiers (DOIs) issued by repositories
like figshare and Zenodo.
* Built-in utilities to unzip/decompress files upon download
**Start here:** :ref:`retrieve`
.. tab-item:: Manage sample data for a Python program
**Who**: Package developers wanting to include sample data for use in
tutorials and tests.
Pooch was designed for this! It offers:
* Pure Python and :ref:`minimal dependencies `.
* Download a file only if necessary.
* Verification of download integrity through cryptographic hashes.
* Extensible design: plug in custom download and post-processing functions.
* Built-in utilities to unzip/decompress files upon download
* Multiple download protocols HTTP/FTP/SFTP and basic authentication.
* User control of data cache location through environment variables.
**Start here:** :ref:`intermediate`
History
-------
Pooch was born out of shared need between the
`Fatiando a Terra `__ libraries and
`MetPy `__.
During the
`Scipy Conference 2018 `__
sprints, developers from both projects got together and, realizing the shared
necessity, devised a package that would combine the best of the existing
functionality already present in each project and extend it's capabilities.
pooch-1.8.2/doc/api/ 0000775 0000000 0000000 00000000000 14630363143 0014153 5 ustar 00root root 0000000 0000000 pooch-1.8.2/doc/api/index.rst 0000664 0000000 0000000 00000002061 14630363143 0016013 0 ustar 00root root 0000000 0000000 .. _api:
List of functions and classes (API)
===================================
.. note::
**All functions and classes should be accessed from the** :mod:`pooch`
**top-level namespace.**
Modules inside of the :mod:`pooch` package are meant mostly for internal
organization. Please **avoid importing** directly from submodules since
functions/classes may be moved around.
.. automodule:: pooch
Core
----
.. autosummary::
:toctree: generated/
pooch.create
pooch.Pooch
pooch.retrieve
Utilities
---------
.. autosummary::
:toctree: generated/
pooch.os_cache
pooch.make_registry
pooch.file_hash
pooch.check_version
pooch.get_logger
Downloaders
-----------
.. autosummary::
:toctree: generated/
pooch.HTTPDownloader
pooch.FTPDownloader
pooch.SFTPDownloader
pooch.DOIDownloader
Processors
----------
.. autosummary::
:toctree: generated/
pooch.Unzip
pooch.Untar
pooch.Decompress
Miscellaneous
-------------
.. autosummary::
:toctree: generated/
pooch.test
pooch-1.8.2/doc/authentication.rst 0000664 0000000 0000000 00000004724 14630363143 0017162 0 ustar 00root root 0000000 0000000 .. _authentication:
Authentication
==============
HTTP authentication
-------------------
Use the :class:`~pooch.HTTPDownloader` class directly to provide login
credentials to HTTP servers that require basic authentication. For example:
.. code:: python
from pooch import HTTPDownloader
def fetch_protected_data():
"""
Fetch a file from a server that requires authentication
"""
# Let the downloader know the login credentials
download_auth = HTTPDownloader(auth=("my_username", "my_password"))
fname = GOODBOY.fetch("some-data.csv", downloader=download_auth)
data = pandas.read_csv(fname)
return data
It's probably not a good idea to hard-code credentials in your code. One way
around this is to ask users to set their own credentials through environment
variables. The download code could look something like so:
.. code:: python
import os
def fetch_protected_data():
"""
Fetch a file from a server that requires authentication
"""
# Get the credentials from the user's environment
username = os.environ.get("SOMESITE_USERNAME")
password = os.environ.get("SOMESITE_PASSWORD")
# Let the downloader know the login credentials
download_auth = HTTPDownloader(auth=(username, password))
fname = GOODBOY.fetch("some-data.csv", downloader=download_auth)
data = pandas.read_csv(fname)
return data
FTP/SFTP with authentication
----------------------------
Pooch also comes with the :class:`~pooch.FTPDownloader` and
:class:`~pooch.SFTPDownloader` downloaders that can be used
when files are distributed over FTP or SFTP (secure FTP).
.. note::
To download files over SFTP,
`paramiko `__ needs to be installed.
Sometimes the FTP server doesn't support anonymous FTP and needs authentication
or uses a non-default port.
In these cases, pass in the downloader class explicitly (works with both FTP
and SFTP):
.. code:: python
import os
def fetch_c137():
"""
Load the C-137 sample data as a pandas.DataFrame (over FTP this time).
"""
username = os.environ.get("MYDATASERVER_USERNAME")
password = os.environ.get("MYDATASERVER_PASSWORD")
download_ftp = pooch.FTPDownloader(username=username, password=password)
fname = GOODBOY.fetch("c137.csv", downloader=download_ftp)
data = pandas.read_csv(fname)
return data
pooch-1.8.2/doc/changes.rst 0000664 0000000 0000000 00000077004 14630363143 0015554 0 ustar 00root root 0000000 0000000 .. _changes:
Changelog
=========
Version 1.8.2
-------------
Released on: 2024/06/06
DOI: https://doi.org/10.5281/zenodo.11493461
Bug fixes:
* Use a variable to set the default request timeout (`#418 `__)
Documentation:
* Add HyperSpy, RosettaSciIO, eXSpy to projects using pooch (`#408 `__)
* Add more packages using Pooch (`#403 `__)
Maintenance:
* Add optional dependencies to environment.yml (`#413 `__)
* Run tests with oldest dependencies on x86 macos (`#414 `__)
* Mark additional tests requiring network (`#412 `__)
* Fix package description in pyproject.toml (`#407 `__)
* Setup Trusted Publisher deployment to PyPI (`#406 `__)
* Use Burocrata to check and add license notices (`#402 `__)
* Use pyproject.toml instead of setup.cfg (`#401 `__)
This release contains contributions from:
* Sandro
* Jonas Lähnemann
* Santiago Soler
* Leonardo Uieda
Version 1.8.1
-------------
Released on: 2024/02/19
DOI: https://doi.org/10.5281/zenodo.10680982
Bug fixes:
* Use the ID instead of persistentID for Dataverse downloads since some repositories don't issue persistentIDs but all issue normal IDs (`#355 `__)
* Ensure all archive members are unpacked in subsequent uses of ``Untar``/``Unzip`` if the first call only asked for a few members (`#365 `__)
Documentation:
* Move "Projects using Pooch" further up the README (`#386 `__)
* Update the versions of sphinx and its plugins (`#385 `__)
Maintenance:
* Remove many deprecated pylint options (`#329 `__)
* Use Dependabot to manage GitHub Actions (`#387 `__)
* Simplify the test GitHub Actions workflow (`#384 `__)
* Update format for Black 24.1.1 (`#383 `__)
This release contains contributions from:
* Mark Harfouche
* Juan Nunez-Iglesias
* Santiago Soler
* Leonardo Uieda
Version 1.8.0
-------------
Released on: 2023/10/24
DOI: https://doi.org/10.5281/zenodo.10037888
Bug fixes:
* Fix bug: add support for old and new Zenodo APIs (`#375 `__)
New features:
* Only create local data directories if necessary (`#370 `__)
* Speed up import time by lazy loading requests (`#328 `__)
Maintenance:
* Add support for Python 3.11 (`#348 `__)
* Only run CI cron job for the upstream repository (`#361 `__)
Documentation:
* Add GemGIS to list of projects using Pooch (`#349 `__)
* Fix spelling of Dataverse (`#353 `__)
* Fix grammar on retrieve documentation (`#359 `__)
This release contains contributions from:
* Hugo van Kemenade
* AlexanderJuestel
* Mark Harfouche
* Philip Durbin
* Rob Luke
* Santiago Soler
* Stephan Hoyer
Version 1.7.0
-------------
Released on: 2023/02/27
DOI: https://doi.org/10.5281/zenodo.7678844
Bug fixes:
* Make archive extraction always take members into account (`#316 `__)
* Figshare downloaders fetch the correct version, instead of always the latest one. (`#343 `__)
New features:
* Allow spaces in filenames in registry files (`#315 `__)
* Refactor ``Pooch.is_available`` to use downloaders (`#322 `__)
* Add support for downloading files from Dataverse DOIs (`#318 `__)
* Add a new ``Pooch.load_registry_from_doi`` method that populates the Pooch registry using DOI-based data repositories (`#325 `__)
* Support urls for Zenodo repositories created through the GitHub integration service, which include slashes in the filename of the main zip files (`#340 `__)
* Automatically add a trailing slash to ``base_url`` on ``pooch.create`` (`#344 `__)
Maintenance:
* Drop support for Python 3.6 (`#299 `__)
* Port from deprecated ``appdirs`` to ``platformdirs`` (`#339 `__)
* Update version of Codecov's Action to v3 (`#345 `__)
Documentation:
* Update sphinx, theme, and sphinx-panels (`#300 `__)
* Add CITATION.cff for the JOSS article (`#308 `__)
* Use Markdown for the README (`#311 `__)
* Improve docstring of `known_hash` in `retrieve` function (`#333 `__)
* Replace link to Pooch's citation with a BibTeX code snippet (`#335 `__)
Projects that started using Pooch:
* Open AR-Sandbox (`#305 `__)
* ``climlab`` (`#312 `__)
* SciPy (`#320 `__)
* ``napari`` (`#321 `__)
* ``mne-python`` (`#323 `__)
This release contains contributions from:
* Alex Fikl
* Anirudh Dagar
* Björn Ludwig
* Brian Rose
* Dominic Kempf
* Florian Wellmann
* Gabriel Fu
* Kyle I S Harrington
* Leonardo Uieda
* myd7349
* Rowan Cockett
* Santiago Soler
Version 1.6.0
-------------
Released on: 2022/01/24
DOI: https://doi.org/10.5281/zenodo.5793074
.. warning::
**Pooch v1.6.0 is the last release that is compatible with Python 3.6.**
Important notes:
* Pooch now specifies version bounds for our required dependencies and a plan for dropping support for older versions. Please revise it if you depend on Pooch.
Enhancements:
* Add option to disable updates on hash mismatch (`#291 `__ and `#292 `__)
* Allow enabling progress bars with an argument in ``Pooch.fetch`` and ``retrieve`` (`#277 `__)
Documentation:
* Use real data URLs in the README example code (`#295 `__)
* Tell users to import from the top-level namespace (`#288 `__)
* Update the contact link to `fatiando.org/contact `__ (`#282 `__)
* Refer the community guides to `fatiando/community `__ (`#281 `__)
* Mention in docs that figshare collections aren't supported (`#275 `__)
Maintenance:
* Replace Google Analytics for `Plausible `__ to make our docs more privacy-friendly (`#293 `__)
* Use `Dependente `__ to capture dependencies on CI (`#289 `__)
* Use ``build`` instead of setup.py (`#287 `__)
* Run the tests weekly on GitHub Actions (`#286 `__)
* Set minimum required version of dependencies (`#280 `__)
* Rename "master" to "main" throughout the project (`#278 `__)
* Remove trailing slash from GitHub handle in ``AUTHORS.md`` (`#279 `__)
This release contains contributions from:
* Santiago Soler
* Genevieve Buckley
* Ryan Abernathey
* Ryan May
* Leonardo Uieda
Version 1.5.2
-------------
Released on: 2021/10/11
DOI: https://doi.org/10.5281/zenodo.5560923
Bug fixes:
* Fix bug when unpacking an entire subfolder from an archive. Now both unpacking processors (``Untar`` and ``Unzip``) handle ``members`` that are folders (not files) correctly. (`#266 `__)
Enhancements:
* Add support for Python 3.10 (`#260 `__)
* Point to the user's code for the file_hash warning instead of our internal code (which isn't very useful) (`#259 `__)
Documentation:
* Fix typo in a variable name of the examples in the documentation (`#268 `__)
* Fix typo when specifying the SFTP protocol in the about page (`#267 `__)
Maintenance:
* Remove old testing checks if running on TravisCI (`#265 `__)
This release contains contributions from:
* Santiago Soler
* Hugo van Kemenade
* Mark Harfouche
* Leonardo Uieda
Version 1.5.1
-------------
Released on: 2021/08/24
DOI: https://doi.org/10.5281/zenodo.5242882
.. warning::
**Please use** ``from pooch import file_hash`` **instead of** ``from
pooch.utils import file_hash``. This is backwards compatible with all
previous versions of Pooch. We recommend importing all functions and
classes from the top-level namespace.
Bug fixes:
* Make ``file_hash`` accessible from the ``pooch.utils`` module again. Moving
this function to ``pooch.hashes`` caused crashes downstream. To prevent these
crashes, add a wrapper back to utils that issues a warning that users should
import from the top-level namespace instead.
(`#257 `__)
* Use a mirror of the test data directory in tests that write to it.
(`#255 `__)
* Add a pytest mark for tests accessing the network so that they can easily
excluded when testing offline. (`#254 `__)
This release contains contributions from:
* Antonio Valentino
* Leonardo Uieda
Version 1.5.0
-------------
Released on: 2021/08/23
DOI: https://doi.org/10.5281/zenodo.5235242
New features:
* Add support for non-cryptographic hashes from the xxhash package. They aren't
as safe (but safe enough) and compute in fractions of the time from SHA or
MD5. This makes it feasible to use hash checking on large datasets. (`#242
`__)
* Add support for using figshare and Zenodo DOIs as URLs (with the protocol
``doi:{DOI}/{file name}``, which works out-of-the-box with ``Pooch.fetch``
and ``retrieve``). Can only download 1 file from the archive (not the full
archive) and the file name must be specified in the URL. (`#241
`__)
Maintenance:
* Move hash functions to their own private module. No changes to the public
API. (`#244 `__)
* Run CI jobs on Python version extremes instead of all supported versions
(`#243 `__)
This release contains contributions from:
* Mark Harfouche
* Leonardo Uieda
Version 1.4.0
-------------
Released on: 2021/06/08
DOI: https://doi.org/10.5281/zenodo.4914758
Bug fixes:
* Fix bug in ``Untar`` and ``Unzip`` when the archive contains subfolders
(`#224 `__)
Documentation:
* New theme (``sphinx-book-theme``) and layout of the documentation (`#236
`__ `#237
`__ `#238
`__)
Enhancements:
* Add support for non-tqdm progress bars on HTTPDownloader (`#228
`__)
* Allow custom unpack locations in ``Untar`` and ``Unzip`` (`#224
`__)
Maintenance:
* Replace versioneer with setuptools-scm (`#235
`__)
* Automatically check license notice on code files (`#231
`__)
* Don't store documentation HTML as CI build artifacts (`#221
`__)
This release contains contributions from:
* Leonardo Uieda
* Agustina Pesce
* Clément Robert
* Daniel McCloy
Version 1.3.0
-------------
Released on: 2020/11/27
DOI: https://doi.org/10.5281/zenodo.4293216
Bug fixes:
* Properly handle capitalized hashes. On Windows, users might sometimes get
capitalized hashes from the system. To avoid false hash mismatches, convert
stored and computed hashes to lowercase before doing comparisons. Convert
hashes to lowercase when reading from the registry to make sure stored hashes
are always lowercase. (`#214 `__)
New features:
* Add option to retry downloads if they fail. The new ``retry_if_failed``
option to ``pooch.create`` and ``pooch.Pooch`` allows retrying the download
the specified number of times in case of failures due to hash mismatches
(coming from Pooch) or network issues (coming from ``requests``). This is
useful for running downloads on CI that tend to fail sporadically. Waits a
period of time between consecutive downloads starting with 1s and increasing
up to 10s in 1s increments. (`#215
`__)
* Allow user defined decompressed file names. Introduce new ``name`` argument
to ``pooch.Decompress`` to allow user defined file names. Defaults to the
previous naming convention for backward compatibility. (`#203
`__)
Documentation:
* Add seaborn-image to list of packages using Pooch (`#218
`__)
Maintenance:
* Add support for Python 3.9. (`#220
`__)
* Drop support for Python 3.5. (`#204
`__)
* Use pip instead of conda to speed up Actions (`#216
`__)
* Add license and copyright notice to every .py file (`#213
`__)
This release contains contributions from:
* Leonardo Uieda
* Danilo Horta
* Hugo van Kemenade
* SarthakJariwala
Version 1.2.0
-------------
Released on: 2020/09/10
DOI: https://doi.org/10.5281/zenodo.4022246
.. warning::
**Pooch v1.2.0 is the last release that is compatible with Python 3.5.**
Bug fixes:
* Fix FTP availability check when the file is in a directory. If the data file
is not in the base directory, the ``Pooch.is_available`` test was broken
since we were checking for the full path in ``ftp.nlst`` instead of just the
file name. (`#191 `__)
New features:
* Add the SFTPDownloader class for secure FTP downloads (`#165
`__)
* Expose Pooch version as ``pooch.__version__`` (`#179
`__)
* Allow line comments in registry files with ``#`` (`#180
`__)
Enhancements:
* Point to Unzip/tar from Decompress docs and errors (`#200
`__)
Documentation:
* Re-factor the documentation into separate pages (`#202
`__)
* Add warning to the docs about dropping Python 3.5 (`#201
`__)
* Add `histolab `__ to the Pooch-powered
projects (`#189 `__)
Maintenance:
* Push documentation to GitHub Pages using Actions (`#198
`__)
* Add GitHub Actions workflow for publishing to PyPI (`#196
`__)
* Set up GitHub Actions for testing and linting (`#194
`__)
* Test FTP downloads using a local test server (`#192
`__)
This release contains contributions from:
* Leonardo Uieda
* Hugo van Kemenade
* Alessia Marcolini
* Luke Gregor
* Mathias Hauser
Version 1.1.1
-------------
Released on: 2020/05/14
DOI: https://doi.org/10.5281/zenodo.3826458
Bug fixes:
* Delay data cache folder creation until the first download is attempted. As
seen in `recent issues in scikit-image
`__, creating the
data folder in ``pooch.create`` can cause problems since this function is
called at import time. This means that importing the package in parallel can
cause race conditions and crashes. To prevent that from happening, delay the
creation of the cache folder until ``Pooch.fetch`` or ``retrieve`` are
called.
(`#173 `__)
* Allow the data folder to already exist when creating it. This is can help
cope with parallel execution as well.
(`#171 `__)
Documentation:
* Added scikit-image to list of Pooch users.
(`#168 `__)
* Fix typo in README and front page contributing section.
(`#166 `__)
This release contains contributions from:
* Leonardo Uieda
* Egor Panfilov
* Rowan Cockett
Version 1.1.0
-------------
Released on: 2020/04/13
DOI: https://doi.org/10.5281/zenodo.3747184
New features:
* New function ``pooch.retrieve`` to fetch single files This is much more
convenient than setting up a ``Pooch`` 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 allow ``pooch.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
Version 1.0.0
-------------
Released on: 2020/01/28
DOI: https://doi.org/10.5281/zenodo.3629329
This release marks the stabilization of the Pooch API. Further changes to the
1.* line will be fully backwards compatible (meaning that updating Pooch should
not break existing code). If there is great need to make backwards incompatible
changes, we will release a 2.* line. In that case, bug fixes will still be
ported to the 1.* line for a period of time.
Improvements:
* Allow blank lines in registry files. Previously, they would cause an error.
(`#138 `__)
**Backwards incompatible changes**:
* Using Python's ``logging`` module to instead of ``warnings`` to inform users
of download, update, and decompression/unpacking actions. This allows
messages to be logged with different priorities and the user filter out log
messages or silence Pooch entirely. Introduces the function
``pooch.get_logger`` to access the ``logging`` object used by Pooch. **Users
who relied on Pooch issuing warnings will need to update to capturing logs
instead.** All other parts of the API remain unchanged.
(`#115 `__)
This release contains contributions from:
* Daniel Shapero
Version 0.7.2
-------------
Released on: 2020/01/17
🚨 **Announcement:** 🚨
We now have a `JOSS paper about Pooch `__!
Please :ref:`cite it ` when you use Pooch for your research.
(`#116 `__ with reviews in
`#132 `__ and
`#134 `__)
This is minor release which only updates the citation information to
the new JOSS paper. No DOI was issued for this release since there are
no code or documentation changes.
Version 0.7.1
-------------
Released on: 2020/01/17
DOI: https://doi.org/10.5281/zenodo.3611376
Improvements:
* Better error messages when hashes don't match. Include the file name in the
exception for a hash mismatch between a downloaded file and the registry.
Before, we included the name of temporary file, which wasn't very
informative.
(`#128 `__)
* Better error message for malformed registry files. When loading a registry
file, inform the name of the file and include the offending content in the
error message instead of just the line number.
(`#129 `__)
Maintenance:
* Change development status flag in ``setup.py`` to "stable" instead of
"alpha".
(`#127 `__)
This release was reviewed at the `Journal of Open Source Software
`__. The code and
software paper contain contributions from:
* Anderson Banihirwe
* Martin Durant
* Mark Harfouche
* Hugo van Kemenade
* John Leeman
* Rémi Rampin
* Daniel Shapero
* Santiago Rubén Soler
* Matthew Turk
* Leonardo Uieda
Version 0.7.0
-------------
Released on: 2019/11/19
DOI: https://doi.org/10.5281/zenodo.3547640
New features:
* New ``pooch.FTPDownloader`` class for downloading files over FTP. Uses the
standard library ``ftplib``. The appropriate downloader is automatically
selected by ``pooch.Pooch.fetch`` based on the URL (for anonymous FTP only),
so no configuration is required.
If authentication is required, ``pooch.FTPDownloader`` provides the need
support. Ported from
`NCAR/aletheia-data `__ by the author.
(`#118 `__)
* Support for file-like objects to ``Pooch.load_registry`` (opened either in
binary or text mode).
(`#117 `__)
Maintenance:
* Testing and official support for Python 3.8.
(`#113 `__)
* 🚨 **Drop support for Python 2.7.** 🚨 Remove conditional dependencies and CI
jobs.
(`#100 `__)
Documentation:
* In the tutorial, use ``pkg_resources.resource_stream()`` from setuptools to
load the ``registry.txt`` file. It's less error-prone than using ``os.path``
and ``__file__`` and allows the package to work from zip files.
(`#120 `__)
* Docstrings formatted to 79 characters (instead of 88) for better rendering in
Jupyter notebooks and IPython. These displays are limited to 80 chars so the
longer lines made the docstring unreadable.
(`#123 `__)
This release contains contributions from:
* Anderson Banihirwe
* Hugo van Kemenade
* Remi Rampin
* Leonardo Uieda
Version 0.6.0
-------------
Released on: 2019/10/22
DOI: https://doi.org/10.5281/zenodo.3515031
🚨 **Pooch v0.6.0 is the last release to support Python 2.7** 🚨
New features:
* Add optional download progress bar to ``pooch.HTTPDownloader``
(`#97 `__)
Maintenance:
* Warn that 0.6.0 is the last version to support Python 2.7
(`#108 `__)
Documentation:
* Update contact information to point to our Slack channel
(`#107 `__)
* Add icepack to list of projects using Pooch
(`#98 `__)
This release contains contributions from:
* Daniel Shapero
* Leonardo Uieda
Version 0.5.2
-------------
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 `__)
This release contains contributions from:
* Leonardo Uieda
Version 0.5.1
-------------
Released on: 2019/05/21
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
Version 0.5.0
-------------
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
