rf: Factor TemplateFlow into Cache and Client classes

.circleci/config.yml

@@ -109,7 +109,7 @@ jobs:
             export TEMPLATEFLOW_USE_DATALAD=on
             python -m pytest \
                    --junit-xml=~/tests/datalad.xml --cov templateflow --doctest-modules \
-                   templateflow/api.py
+                   templateflow/client.py
 
             coverage run --append -m templateflow.cli config
             coverage run --append -m templateflow.cli ls MNI152NLin2009cAsym --suffix T1w

docs/api.rst

@@ -5,5 +5,6 @@ Information on specific functions, classes, and methods.
 .. toctree::
 
    api/templateflow.cli
+   api/templateflow.client
    api/templateflow.api
    api/templateflow.conf

docs/environment.yml

@@ -202,6 +202,7 @@ dependencies:
     - nibabel==3.2.2
     - nipreps-versions==1.0.3
     - pandas==1.4.2
+    - platformdirs
     - pybids==0.15.2
     - sqlalchemy==1.3.24
     - hatchling

pyproject.toml

@@ -22,6 +22,7 @@ license = {file = "LICENSE"}
 requires-python = ">=3.9"
 dependencies = [
     "acres >= 0.5.0",
+    "platformdirs >= 4.0",
     "pybids >= 0.15.2",
     "requests",
     "tqdm",

templateflow/__init__.py

@@ -40,12 +40,14 @@
     del PackageNotFoundError
 
 from templateflow import api
+from templateflow.client import TemplateFlowClient
 from templateflow.conf import update
 
 __all__ = [
     '__copyright__',
     '__packagename__',
     '__version__',
+    'TemplateFlowClient',
     'api',
     'update',
 ]