From 08104d83d753a32d1438b79d7a100e10895ab79c Mon Sep 17 00:00:00 2001
From: "Augusto W. Andreoli" <andreoliwa@gmail.com>
Date: Tue, 16 Mar 2021 22:10:05 +0100
Subject: [PATCH] feat: cache remote styles to avoid HTTP requests (#312)

* feat: option to cache styles forever, never and with a time unit
* test: fixture: project with a remote style (loaded from a URL)
* feat: read cache config from [tool.nitpick]cache
* feat: default cache is 1 hour
* test: cache option with pytest instead of doctest
* docs: document cache options and default
---
 .bumpversion.cfg                              |   8 +-
 ..._nitpick_section.rst => configuration.rst} |  79 +++++++++-
 docs/index.rst                                |   2 +-
 docs/styles.rst                               |   4 +-
 package.json                                  |   2 +-
 poetry.lock                                   | 106 +++++++++++---
 pyproject.toml                                |   4 +-
 src/nitpick/enums.py                          |  17 ++-
 src/nitpick/project.py                        |  10 +-
 src/nitpick/style.py                          | 132 +++++++++++------
 tasks.py                                      |   8 +-
 tests/conftest.py                             |  35 ++++-
 tests/helpers.py                              |  22 ++-
 tests/test_cache.py                           | 136 ++++++++++++++++++
 tests/test_ini.py                             |   4 +-
 tests/test_style.py                           |   2 +-
 tox.ini                                       |   2 +
 17 files changed, 485 insertions(+), 88 deletions(-)
 rename docs/{tool_nitpick_section.rst => configuration.rst} (51%)
 create mode 100644 tests/test_cache.py

diff --git a/.bumpversion.cfg b/.bumpversion.cfg
index 466cfa6e..f082fac9 100644
--- a/.bumpversion.cfg
+++ b/.bumpversion.cfg
@@ -11,19 +11,19 @@ replace = {new_version}
 search = version = "{current_version}"
 replace = version = "{new_version}"
 
-[bumpversion:file:docs/examples.rst]
+[bumpversion:file:docs/configuration.rst]
 search = {current_version}
 replace = {new_version}
 
-[bumpversion:file:docs/quickstart.rst]
+[bumpversion:file:docs/examples.rst]
 search = {current_version}
 replace = {new_version}
 
-[bumpversion:file:docs/targets.rst]
+[bumpversion:file:docs/quickstart.rst]
 search = {current_version}
 replace = {new_version}
 
-[bumpversion:file:docs/tool_nitpick_section.rst]
+[bumpversion:file:docs/targets.rst]
 search = {current_version}
 replace = {new_version}
 
diff --git a/docs/tool_nitpick_section.rst b/docs/configuration.rst
similarity index 51%
rename from docs/tool_nitpick_section.rst
rename to docs/configuration.rst
index d2748bea..1da120e7 100644
--- a/docs/tool_nitpick_section.rst
+++ b/docs/configuration.rst
@@ -1,7 +1,7 @@
-.. _tool_nitpick:
+.. _configuration:
 
-The [tool.nitpick] section
-==========================
+Configuration
+=============
 
 :ref:`the-style-file` for your project should be configured in the ``[tool.nitpick]`` section of your ``pyproject.toml`` file.
 
@@ -31,6 +31,72 @@ You can also use the raw URL of a `GitHub Gist <https://gist.github.com>`_:
     [tool.nitpick]
     style = "https://gist.githubusercontent.com/andreoliwa/f4fccf4e3e83a3228e8422c01a48be61/raw/ff3447bddfc5a8665538ddf9c250734e7a38eabb/remote-style.toml"
 
+Cache
+-----
+
+Remote styles can be cached to avoid unnecessary HTTP requests.
+The cache can be configured with the ``cache`` key; see the examples below.
+
+By default, remote styles will be cached for **one hour**.
+This default will also be used if the ``cache`` key has an invalid value.
+
+Expiring after a predefined time
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The cache can be set to expire after a defined time unit.
+Use the format ``cache = "<integer> <time unit>"``.
+*Time unit* can be one of these (plural or singular, it doesn't matter):
+
+- ``minutes`` / ``minute``
+- ``hours`` / ``hour``
+- ``days`` / ``day``
+- ``weeks`` / ``week``
+
+To cache for 15 minutes:
+
+.. code-block:: toml
+
+    [tool.nitpick]
+    style = "https://example.com/remote-style.toml"
+    cache = "15 minutes"
+
+To cache for 1 day:
+
+.. code-block:: toml
+
+    [tool.nitpick]
+    style = "https://example.com/remote-style.toml"
+    cache = "1 day"
+
+Forever
+~~~~~~~
+
+With this option, once the style(s) are cached, they never expire.
+
+.. code-block:: toml
+
+    [tool.nitpick]
+    style = "https://example.com/remote-style.toml"
+    cache = "forever"
+
+Never
+~~~~~
+
+With this option, the cache is never used.
+The remote style file(s) are always looked-up and a HTTP request is always executed.
+
+.. code-block:: toml
+
+    [tool.nitpick]
+    style = "https://example.com/remote-style.toml"
+    cache = "never"
+
+Clearing
+~~~~~~~~
+
+The cache files live in a subdirectory of your project: ``/path/to/your/project/.cache/nitpick/``.
+To clear the cache, simply remove this directory.
+
 Local style
 -----------
 
@@ -41,6 +107,13 @@ Using a file in your home directory:
     [tool.nitpick]
     style = "~/some/path/to/another-style.toml"
 
+Using a relative path from another project in your hard drive:
+
+.. code-block:: toml
+
+    [tool.nitpick]
+    style = "../another-project/another-style.toml"
+
 .. _multiple_styles:
 
 Multiple styles
diff --git a/docs/index.rst b/docs/index.rst
index 174584f1..5b13f0d3 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -54,9 +54,9 @@ Useful if you maintain multiple projects and want to use the same configs in all
 
    quickstart
    styles
+   configuration
    examples
    auto_detection
-   tool_nitpick_section
    nitpick_section
    cli
    plugins
diff --git a/docs/styles.rst b/docs/styles.rst
index 699f33bf..16425a36 100644
--- a/docs/styles.rst
+++ b/docs/styles.rst
@@ -43,14 +43,14 @@ This example style will assert that:
 Configure your own style
 ------------------------
 
-After creating your own TOML_ file with your style, add it to your ``pyproject.toml`` file. See :ref:`the [tool.nitpick] section <tool_nitpick>` for details.
+After creating your own TOML_ file with your style, add it to your ``pyproject.toml`` file. See :ref:`configuration` for details.
 
 You can also check :ref:`some pre-configured examples <examples>`, and copy/paste/change configuration from them.
 
 Default search order for a style
 --------------------------------
 
-1. A file or URL configured in the ``pyproject.toml`` file, ``[tool.nitpick]`` section, ``style`` key, as described in :ref:`tool_nitpick`.
+1. A file or URL configured in the ``pyproject.toml`` file, ``[tool.nitpick]`` section, ``style`` key, as described in :ref:`configuration`.
 
 2. Any `nitpick-style.toml`_ file found in the current directory (the one in which flake8_ runs from) or above.
 
diff --git a/package.json b/package.json
index 631f4ea6..b06cd4b8 100644
--- a/package.json
+++ b/package.json
@@ -31,10 +31,10 @@
             "CHANGELOG.md",
             "README.md",
             "docs/conf.py",
+            "docs/configuration.rst",
             "docs/examples.rst",
             "docs/quickstart.rst",
             "docs/targets.rst",
-            "docs/tool_nitpick_section.rst",
             "nitpick-style.toml",
             "package.json",
             "pyproject.toml",
diff --git a/poetry.lock b/poetry.lock
index 7e8859d1..4acef122 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -101,6 +101,19 @@ category = "dev"
 optional = false
 python-versions = "*"
 
+[[package]]
+name = "cachy"
+version = "0.3.0"
+description = "Cachy provides a simple yet effective caching library."
+category = "main"
+optional = false
+python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
+
+[package.extras]
+redis = ["redis (>=3.3.6,<4.0.0)"]
+memcached = ["python-memcached (>=1.59,<2.0)"]
+msgpack = ["msgpack-python (>=0.5,<0.6)"]
+
 [[package]]
 name = "certifi"
 version = "2020.12.5"
@@ -229,6 +242,17 @@ mccabe = ">=0.6.0,<0.7.0"
 pycodestyle = ">=2.7.0,<2.8.0"
 pyflakes = ">=2.3.0,<2.4.0"
 
+[[package]]
+name = "freezegun"
+version = "1.1.0"
+description = "Let your Python tests travel through time"
+category = "main"
+optional = true
+python-versions = ">=3.5"
+
+[package.dependencies]
+python-dateutil = ">=2.7"
+
 [[package]]
 name = "fuzzywuzzy"
 version = "0.18.0"
@@ -294,7 +318,7 @@ test = ["flake8 (>=3.8.4,<3.9.0)", "pycodestyle (>=2.6.0,<2.7.0)"]
 
 [[package]]
 name = "importlib-metadata"
-version = "3.7.0"
+version = "3.7.2"
 description = "Read metadata from Python packages"
 category = "main"
 optional = false
@@ -327,6 +351,29 @@ python-versions = ">=2.7"
 [package.dependencies]
 ipython = {version = ">=5.1.0", markers = "python_version >= \"3.4\""}
 
+[[package]]
+name = "ipdb"
+version = "0.13.5"
+description = "IPython-enabled pdb"
+category = "dev"
+optional = false
+python-versions = ">=2.7"
+
+[package.dependencies]
+ipython = {version = ">=7.10.0,<7.17.0", markers = "python_version == \"3.6\""}
+
+[[package]]
+name = "ipdb"
+version = "0.13.6"
+description = "IPython-enabled pdb"
+category = "dev"
+optional = false
+python-versions = ">=2.7"
+
+[package.dependencies]
+ipython = {version = ">=7.10.0,<7.17.0", markers = "python_version == \"3.6\""}
+toml = {version = ">=0.10.2", markers = "python_version == \"3.6\" or python_version > \"3.6\""}
+
 [[package]]
 name = "ipython"
 version = "7.16.1"
@@ -623,7 +670,7 @@ python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 
 [[package]]
 name = "pygments"
-version = "2.8.0"
+version = "2.8.1"
 description = "Pygments is a syntax highlighting package written in Python."
 category = "main"
 optional = false
@@ -700,6 +747,17 @@ pytest = ">=4.6"
 [package.extras]
 testing = ["fields", "hunter", "process-tests (==2.0.2)", "six", "pytest-xdist", "virtualenv"]
 
+[[package]]
+name = "python-dateutil"
+version = "2.8.1"
+description = "Extensions to the standard Python datetime module"
+category = "main"
+optional = true
+python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,>=2.7"
+
+[package.dependencies]
+six = ">=1.5"
+
 [[package]]
 name = "python-slugify"
 version = "4.0.1"
@@ -758,14 +816,14 @@ tests = ["coverage (>=3.7.1,<6.0.0)", "pytest-cov", "pytest-localserver", "flake
 
 [[package]]
 name = "ruamel.yaml"
-version = "0.16.12"
+version = "0.16.13"
 description = "ruamel.yaml is a YAML parser/emitter that supports roundtrip preservation of comments, seq/map flow style, and map key order"
 category = "main"
 optional = false
 python-versions = "*"
 
 [package.dependencies]
-"ruamel.yaml.clib" = {version = ">=0.1.2", markers = "platform_python_implementation == \"CPython\" and python_version < \"3.9\""}
+"ruamel.yaml.clib" = {version = ">=0.1.2", markers = "platform_python_implementation == \"CPython\" and python_version < \"3.10\""}
 
 [package.extras]
 docs = ["ryd"]
@@ -1044,25 +1102,25 @@ python-versions = "*"
 
 [[package]]
 name = "zipp"
-version = "3.4.0"
+version = "3.4.1"
 description = "Backport of pathlib-compatible object wrapper for zip files"
 category = "main"
 optional = false
 python-versions = ">=3.6"
 
 [package.extras]
-docs = ["sphinx", "jaraco.packaging (>=3.2)", "rst.linker (>=1.9)"]
-testing = ["pytest (>=3.5,!=3.7.3)", "pytest-checkdocs (>=1.2.3)", "pytest-flake8", "pytest-cov", "jaraco.test (>=3.2.0)", "jaraco.itertools", "func-timeout", "pytest-black (>=0.3.7)", "pytest-mypy"]
+docs = ["sphinx", "jaraco.packaging (>=8.2)", "rst.linker (>=1.9)"]
+testing = ["pytest (>=4.6)", "pytest-checkdocs (>=1.2.3)", "pytest-flake8", "pytest-cov", "pytest-enabler", "jaraco.itertools", "func-timeout", "pytest-black (>=0.3.7)", "pytest-mypy"]
 
 [extras]
 doc = ["sphinx", "sphinx_rtd_theme", "sphobjinv"]
 lint = ["pylint"]
-test = ["pytest", "pytest-cov", "testfixtures", "responses"]
+test = ["pytest", "pytest-cov", "testfixtures", "responses", "freezegun"]
 
 [metadata]
 lock-version = "1.1"
 python-versions = "^3.6"
-content-hash = "94608ab50ed5bdb3116ace06938b98ed8b7b084e44f1ea808750cdadf364fa58"
+content-hash = "2dbbb6ab3e37571269c71557f8ba6430411d6983056ce420418d133bdde617c6"
 
 [metadata.files]
 aiocontextvars = [
@@ -1106,6 +1164,10 @@ backcall = [
     {file = "backcall-0.2.0-py2.py3-none-any.whl", hash = "sha256:fbbce6a29f263178a1f7915c1940bde0ec2b2a967566fe1c65c1dfb7422bd255"},
     {file = "backcall-0.2.0.tar.gz", hash = "sha256:5cbdbf27be5e7cfadb448baf0aa95508f91f2bbc6c6437cd9cd06e2a4c215e1e"},
 ]
+cachy = [
+    {file = "cachy-0.3.0-py2.py3-none-any.whl", hash = "sha256:338ca09c8860e76b275aff52374330efedc4d5a5e45dc1c5b539c1ead0786fe7"},
+    {file = "cachy-0.3.0.tar.gz", hash = "sha256:186581f4ceb42a0bbe040c407da73c14092379b1e4c0e327fdb72ae4a9b269b1"},
+]
 certifi = [
     {file = "certifi-2020.12.5-py2.py3-none-any.whl", hash = "sha256:719a74fb9e33b9bd44cc7f3a8d94bc35e4049deebe19ba7d8e108280cfd59830"},
     {file = "certifi-2020.12.5.tar.gz", hash = "sha256:1a4995114262bffbc2413b159f2a1a480c969de6e6eb13ee966d470af86af59c"},
@@ -1207,6 +1269,10 @@ flake8 = [
     {file = "flake8-3.9.0-py2.py3-none-any.whl", hash = "sha256:12d05ab02614b6aee8df7c36b97d1a3b2372761222b19b58621355e82acddcff"},
     {file = "flake8-3.9.0.tar.gz", hash = "sha256:78873e372b12b093da7b5e5ed302e8ad9e988b38b063b61ad937f26ca58fc5f0"},
 ]
+freezegun = [
+    {file = "freezegun-1.1.0-py2.py3-none-any.whl", hash = "sha256:2ae695f7eb96c62529f03a038461afe3c692db3465e215355e1bb4b0ab408712"},
+    {file = "freezegun-1.1.0.tar.gz", hash = "sha256:177f9dd59861d871e27a484c3332f35a6e3f5d14626f2bf91be37891f18927f3"},
+]
 fuzzywuzzy = [
     {file = "fuzzywuzzy-0.18.0-py2.py3-none-any.whl", hash = "sha256:928244b28db720d1e0ee7587acf660ea49d7e4c632569cad4f1cd7e68a5f0993"},
     {file = "fuzzywuzzy-0.18.0.tar.gz", hash = "sha256:45016e92264780e58972dca1b3d939ac864b78437422beecebb3095f8efd00e8"},
@@ -1245,8 +1311,8 @@ immutables = [
     {file = "immutables-0.15.tar.gz", hash = "sha256:3713ab1ebbb6946b7ce1387bb9d1d7f5e09c45add58c2a2ee65f963c171e746b"},
 ]
 importlib-metadata = [
-    {file = "importlib_metadata-3.7.0-py3-none-any.whl", hash = "sha256:c6af5dbf1126cd959c4a8d8efd61d4d3c83bddb0459a17e554284a077574b614"},
-    {file = "importlib_metadata-3.7.0.tar.gz", hash = "sha256:24499ffde1b80be08284100393955842be4a59c7c16bbf2738aad0e464a8e0aa"},
+    {file = "importlib_metadata-3.7.2-py3-none-any.whl", hash = "sha256:407d13f55dc6f2a844e62325d18ad7019a436c4bfcaee34cda35f2be6e7c3e34"},
+    {file = "importlib_metadata-3.7.2.tar.gz", hash = "sha256:18d5ff601069f98d5d605b6a4b50c18a34811d655c55548adc833e687289acde"},
 ]
 iniconfig = [
     {file = "iniconfig-1.1.1-py2.py3-none-any.whl", hash = "sha256:011e24c64b7f47f6ebd835bb12a743f2fbe9a26d4cecaa7f53bc4f35ee9da8b3"},
@@ -1254,6 +1320,8 @@ iniconfig = [
 ]
 ipdb = [
     {file = "ipdb-0.13.4.tar.gz", hash = "sha256:c85398b5fb82f82399fc38c44fe3532c0dde1754abee727d8f5cfcc74547b334"},
+    {file = "ipdb-0.13.5.tar.gz", hash = "sha256:521e55ade3d3f5e459df6474cfb1d1ef6d44ab4155f829695c7c3dc2a8ce5b2b"},
+    {file = "ipdb-0.13.6.tar.gz", hash = "sha256:1aa37e19e5b3b96c930fe7fe97193a54202c23a8d1b1c7763f76553f5b275731"},
 ]
 ipython = [
     {file = "ipython-7.16.1-py3-none-any.whl", hash = "sha256:2dbcc8c27ca7d3cfe4fcdff7f45b27f9a8d3edfa70ff8024a71c7a8eb5f09d64"},
@@ -1448,8 +1516,8 @@ pyflakes = [
     {file = "pyflakes-2.3.0.tar.gz", hash = "sha256:e59fd8e750e588358f1b8885e5a4751203a0516e0ee6d34811089ac294c8806f"},
 ]
 pygments = [
-    {file = "Pygments-2.8.0-py3-none-any.whl", hash = "sha256:b21b072d0ccdf29297a82a2363359d99623597b8a265b8081760e4d0f7153c88"},
-    {file = "Pygments-2.8.0.tar.gz", hash = "sha256:37a13ba168a02ac54cc5891a42b1caec333e59b66addb7fa633ea8a6d73445c0"},
+    {file = "Pygments-2.8.1-py3-none-any.whl", hash = "sha256:534ef71d539ae97d4c3a4cf7d6f110f214b0e687e92f9cb9d2a3b0d3101289c8"},
+    {file = "Pygments-2.8.1.tar.gz", hash = "sha256:2656e1a6edcdabf4275f9a3640db59fd5de107d88e8663c5d4e9a0fa62f77f94"},
 ]
 pylint = [
     {file = "pylint-2.7.2-py3-none-any.whl", hash = "sha256:d09b0b07ba06bcdff463958f53f23df25e740ecd81895f7d2699ec04bbd8dc3b"},
@@ -1470,6 +1538,10 @@ pytest-cov = [
     {file = "pytest-cov-2.11.1.tar.gz", hash = "sha256:359952d9d39b9f822d9d29324483e7ba04a3a17dd7d05aa6beb7ea01e359e5f7"},
     {file = "pytest_cov-2.11.1-py2.py3-none-any.whl", hash = "sha256:bdb9fdb0b85a7cc825269a4c56b48ccaa5c7e365054b6038772c32ddcdc969da"},
 ]
+python-dateutil = [
+    {file = "python-dateutil-2.8.1.tar.gz", hash = "sha256:73ebfe9dbf22e832286dafa60473e4cd239f8592f699aa5adaf10050e6e1823c"},
+    {file = "python_dateutil-2.8.1-py2.py3-none-any.whl", hash = "sha256:75bb3f31ea686f1197762692a9ee6a7550b59fc6ca3a1f4b5d7e32fb98e2da2a"},
+]
 python-slugify = [
     {file = "python-slugify-4.0.1.tar.gz", hash = "sha256:69a517766e00c1268e5bbfc0d010a0a8508de0b18d30ad5a1ff357f8ae724270"},
 ]
@@ -1486,8 +1558,8 @@ responses = [
     {file = "responses-0.12.1.tar.gz", hash = "sha256:2e5764325c6b624e42b428688f2111fea166af46623cb0127c05f6afb14d3457"},
 ]
 "ruamel.yaml" = [
-    {file = "ruamel.yaml-0.16.12-py2.py3-none-any.whl", hash = "sha256:012b9470a0ea06e4e44e99e7920277edf6b46eee0232a04487ea73a7386340a5"},
-    {file = "ruamel.yaml-0.16.12.tar.gz", hash = "sha256:076cc0bc34f1966d920a49f18b52b6ad559fbe656a0748e3535cf7b3f29ebf9e"},
+    {file = "ruamel.yaml-0.16.13-py2.py3-none-any.whl", hash = "sha256:64b06e7873eb8e1125525ecef7345447d786368cadca92a7cd9b59eae62e95a3"},
+    {file = "ruamel.yaml-0.16.13.tar.gz", hash = "sha256:bb48c514222702878759a05af96f4b7ecdba9b33cd4efcf25c86b882cef3a942"},
 ]
 "ruamel.yaml.clib" = [
     {file = "ruamel.yaml.clib-0.2.2-cp27-cp27m-macosx_10_9_x86_64.whl", hash = "sha256:28116f204103cb3a108dfd37668f20abe6e3cafd0d3fd40dba126c732457b3cc"},
@@ -1643,6 +1715,6 @@ wrapt = [
     {file = "wrapt-1.12.1.tar.gz", hash = "sha256:b62ffa81fb85f4332a4f609cab4ac40709470da05643a082ec1eb88e6d9b97d7"},
 ]
 zipp = [
-    {file = "zipp-3.4.0-py3-none-any.whl", hash = "sha256:102c24ef8f171fd729d46599845e95c7ab894a4cf45f5de11a44cc7444fb1108"},
-    {file = "zipp-3.4.0.tar.gz", hash = "sha256:ed5eee1974372595f9e416cc7bbeeb12335201d8081ca8a0743c954d4446e5cb"},
+    {file = "zipp-3.4.1-py3-none-any.whl", hash = "sha256:51cb66cc54621609dd593d1787f286ee42a5c0adbb4b29abea5a63edc3e03098"},
+    {file = "zipp-3.4.1.tar.gz", hash = "sha256:3607921face881ba3e026887d8150cca609d517579abe052ac81fc5aeffdbd76"},
 ]
diff --git a/pyproject.toml b/pyproject.toml
index cd5a888b..ca1bfb9a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -68,6 +68,7 @@ pylint = {version = "*", optional = true}
 pytest = {version = "*", optional = true}
 pytest-cov = {version = "*", optional = true}
 testfixtures = {version = "*", optional = true}
+freezegun = {version = "*", optional = true}
 responses = {version = "*", optional = true}
 sphinx = {version = "*", optional = true}
 sphinx_rtd_theme = {version = "*", optional = true}
@@ -76,10 +77,11 @@ pydantic = "*"
 autorepr = "*"
 loguru = "*"
 ConfigUpdater = "*"
+cachy = "*"
 
 [tool.poetry.extras]
 lint = ["pylint"]
-test = ["pytest", "pytest-cov", "testfixtures", "responses"]
+test = ["pytest", "pytest-cov", "testfixtures", "responses", "freezegun"]
 doc = ["sphinx", "sphinx_rtd_theme", "sphobjinv"]
 
 [tool.poetry.dev-dependencies]
diff --git a/src/nitpick/enums.py b/src/nitpick/enums.py
index 23ade224..50983586 100644
--- a/src/nitpick/enums.py
+++ b/src/nitpick/enums.py
@@ -1,8 +1,8 @@
 """Enums."""
 import os
-from enum import Enum
+from enum import Enum, IntEnum, auto
 
-from nitpick import PROJECT_NAME
+from nitpick.constants import PROJECT_NAME
 
 
 class _OptionMixin:
@@ -28,3 +28,16 @@ class OptionEnum(_OptionMixin, Enum):
     """Options to be used with the CLI."""
 
     OFFLINE = "Offline mode: no style will be downloaded (no HTTP requests at all)"
+
+
+class CachingEnum(IntEnum):
+    """Caching modes for styles."""
+
+    #: Never cache, the style file(s) are always looked-up.
+    NEVER = auto()
+
+    #: Once the style(s) are cached, they never expire.
+    FOREVER = auto()
+
+    #: The cache expires after the configured amount of time (minutes/hours/days).
+    EXPIRES = auto()
diff --git a/src/nitpick/project.py b/src/nitpick/project.py
index 40d9150c..5e9cc6ef 100644
--- a/src/nitpick/project.py
+++ b/src/nitpick/project.py
@@ -101,9 +101,10 @@ def find_root(current_dir: Optional[PathOrStr] = None) -> Path:
 class ToolNitpickSectionSchema(BaseNitpickSchema):
     """Validation schema for the ``[tool.nitpick]`` section on ``pyproject.toml``."""
 
-    error_messages = {"unknown": help_message("Unknown configuration", "tool_nitpick_section.html")}
+    error_messages = {"unknown": help_message("Unknown configuration", "configuration.html")}
 
     style = PolyField(deserialization_schema_selector=fields.string_or_list_field)
+    cache = fields.NonEmptyString()
 
 
 class Project:
@@ -159,7 +160,7 @@ def plugin_manager(self) -> PluginManager:
         plugin_manager.load_setuptools_entrypoints(PROJECT_NAME)
         return plugin_manager
 
-    def validate_pyproject_tool_nitpick(self) -> None:
+    def validate_configuration(self) -> None:
         """Validate the ``pyroject.toml``'s ``[tool.nitpick]`` section against a Marshmallow schema."""
         # pylint: disable=import-outside-toplevel
         pyproject_path: Path = self.root / PYPROJECT_TOML
@@ -184,13 +185,14 @@ def validate_pyproject_tool_nitpick(self) -> None:
 
     def merge_styles(self, offline: bool) -> Iterator[Fuss]:
         """Merge one or multiple style files."""
-        self.validate_pyproject_tool_nitpick()
+        self.validate_configuration()
 
         # pylint: disable=import-outside-toplevel
         from nitpick.style import Style
 
         configured_styles: StrOrList = self.tool_nitpick_dict.get("style", "")
-        style = Style(self, self.plugin_manager, offline)
+        cache_option = self.tool_nitpick_dict.get("cache", "")
+        style = Style(self, offline, cache_option)
         style_errors = list(style.find_initial_styles(configured_styles))
         if style_errors:
             raise QuitComplainingError(style_errors)
diff --git a/src/nitpick/style.py b/src/nitpick/style.py
index 200189e5..cc8313a2 100644
--- a/src/nitpick/style.py
+++ b/src/nitpick/style.py
@@ -1,17 +1,18 @@
 """Style files."""
+import re
 from collections import OrderedDict
+from datetime import datetime, timedelta
 from functools import lru_cache
 from pathlib import Path
-from shutil import rmtree
 from typing import Dict, Iterator, List, Optional, Set, Tuple, Type
 from urllib.parse import urlparse, urlunparse
 
 import click
 import requests
+from cachy import CacheManager, Repository
 from identify import identify
 from loguru import logger
 from marshmallow import Schema
-from pluggy import PluginManager
 from slugify import slugify
 from toml import TomlDecodeError
 
@@ -27,7 +28,7 @@
     RAW_GITHUB_CONTENT_BASE_URL,
     TOML_EXTENSION,
 )
-from nitpick.enums import OptionEnum
+from nitpick.enums import CachingEnum, OptionEnum
 from nitpick.exceptions import Deprecation, QuitComplainingError, pretty_exception
 from nitpick.formats import TOMLFormat
 from nitpick.generic import MergeDict, is_url, search_dict
@@ -40,22 +41,42 @@
 
 Plugins = Set[Type[NitpickPlugin]]
 
+REGEX_CACHE_UNIT = re.compile(r"(?P<number>\d+)\s+(?P<unit>(minute|hour|day|week))", re.IGNORECASE)
 
-def clear_cache_dir(project_root: Path) -> Path:  # TODO: add unit tests
-    """Clear the cache directory (on the project root or on the current directory)."""
-    cache_root: Path = project_root / CACHE_DIR_NAME
-    project_cache_dir = cache_root / PROJECT_NAME
-    rmtree(str(project_cache_dir), ignore_errors=True)
-    return project_cache_dir
 
+def parse_cache_option(cache_option: str) -> Tuple[CachingEnum, timedelta]:
+    """Parse the cache option provided on pyproject.toml.
 
-class Style:
+    If no cache if provided or is invalid, the default is *one hour*.
+    """
+    clean_cache_option = cache_option.strip().lower() if cache_option else ""
+    mapping = {CachingEnum.NEVER.name.lower(): CachingEnum.NEVER, CachingEnum.FOREVER.name.lower(): CachingEnum.FOREVER}
+    simple_cache = mapping.get(clean_cache_option)
+    if simple_cache:
+        logger.info(f"Simple cache option: {simple_cache.name}")
+        return simple_cache, timedelta()
+
+    default = CachingEnum.EXPIRES, timedelta(hours=1)
+    if not clean_cache_option:
+        return default
+
+    for match in REGEX_CACHE_UNIT.finditer(clean_cache_option):
+        plural_unit = match.group("unit") + "s"
+        number = int(match.group("number"))
+        logger.info(f"Cache option with unit: {number} {plural_unit}")
+        return CachingEnum.EXPIRES, timedelta(**{plural_unit: number})
+
+    logger.warning(f"Invalid cache option: {clean_cache_option}. Defaulting to 1 hour")
+    return default
+
+
+class Style:  # pylint: disable=too-many-instance-attributes
     """Include styles recursively from one another."""
 
-    def __init__(self, project: Project, plugin_manager: PluginManager, offline: bool) -> None:
+    def __init__(self, project: Project, offline: bool, cache_option: str) -> None:
         self.project: Project = project
-        self.plugin_manager: PluginManager = plugin_manager
         self.offline = offline
+        self.cache_option = cache_option
 
         self._all_styles = MergeDict()
         self._already_included: Set[str] = set()
@@ -68,7 +89,20 @@ def __init__(self, project: Project, plugin_manager: PluginManager, offline: boo
     @lru_cache()
     def cache_dir(self) -> Path:
         """Clear the cache directory (on the project root or on the current directory)."""
-        return clear_cache_dir(self.project.root)
+        path: Path = self.project.root / CACHE_DIR_NAME / PROJECT_NAME
+
+        # TODO: check if the merged style file is still needed; if not, this line can be removed
+        path.mkdir(parents=True, exist_ok=True)
+
+        return path
+
+    @property
+    def cache_manager(self) -> Repository:
+        """Return a cache manager for the cache directory.
+
+        `File store <https://cachy.readthedocs.io/en/latest/configuration.html#file>`_.
+        """
+        return CacheManager({"stores": {"file": {"driver": "file", "path": self.cache_dir}}}).store()
 
     @staticmethod
     def get_default_style_url():
@@ -88,7 +122,7 @@ def find_initial_styles(self, configured_styles: StrOrList) -> Iterator[Fuss]:
             else:
                 chosen_styles = self.get_default_style_url()
                 log_message = "Loading default Nitpick style"
-        logger.info(log_message + ": {}", chosen_styles)
+        logger.info(f"{log_message}: {chosen_styles}")
 
         yield from self.include_multiple_styles(chosen_styles)
 
@@ -109,11 +143,11 @@ def include_multiple_styles(self, chosen_styles: StrOrList) -> Iterator[Fuss]:
         """Include a list of styles (or just one) into this style tree."""
         style_uris: List[str] = [chosen_styles] if isinstance(chosen_styles, str) else chosen_styles
         for style_uri in style_uris:
-            style_path: Optional[Path] = self.get_style_path(style_uri)
+            style_path, file_contents = self.get_style_path(style_uri)
             if not style_path:
                 continue
 
-            toml = TOMLFormat(path=style_path)
+            toml = TOMLFormat(string=file_contents)
             try:
                 read_toml_dict = toml.as_data
             except TomlDecodeError as err:
@@ -153,7 +187,9 @@ def _validate_config(self, config_dict: Dict) -> Tuple[Dict, Dict]:
             else:
                 schemas = [
                     plugin_class.validation_schema
-                    for plugin_class in self.plugin_manager.hook.can_handle(info=info)  # pylint: disable=no-member
+                    for plugin_class in self.project.plugin_manager.hook.can_handle(
+                        info=info
+                    )  # pylint: disable=no-member
                 ]
                 if not schemas:
                     validation_errors[key] = [BaseStyleSchema.error_messages["unknown"]]
@@ -173,7 +209,7 @@ def _validate_config(self, config_dict: Dict) -> Tuple[Dict, Dict]:
                 validation_errors.update(all_errors)
         return toml_dict, validation_errors
 
-    def get_style_path(self, style_uri: str) -> Optional[Path]:
+    def get_style_path(self, style_uri: str) -> Tuple[Optional[Path], str]:
         """Get the style path from the URI. Add the .toml extension if it's missing."""
         clean_style_uri = style_uri.strip()
 
@@ -187,11 +223,11 @@ def get_style_path(self, style_uri: str) -> Optional[Path]:
             return self.fetch_style_from_url(clean_style_uri)
         return self.fetch_style_from_local_path(clean_style_uri)
 
-    def fetch_style_from_url(self, url: str) -> Optional[Path]:
+    def fetch_style_from_url(self, url: str) -> Tuple[Optional[Path], str]:
         """Fetch a style file from a URL, saving the contents in the cache dir."""
         if self.offline:
             # No style will be fetched in offline mode
-            return None
+            return None, ""
 
         if self._first_full_path and not is_url(url):
             prefix, rest = self._first_full_path.split(":/")
@@ -206,13 +242,10 @@ def fetch_style_from_url(self, url: str) -> Optional[Path]:
         new_url = urlunparse(parsed_url)
 
         if new_url in self._already_included:
-            return None
-
-        if not self.cache_dir:
-            raise FileNotFoundError("Cache dir does not exist")
+            return None, ""
 
         try:
-            response = requests.get(new_url)
+            contents = self.fetch_from_url_or_cache(new_url)
         except requests.ConnectionError:
             click.secho(
                 "Your network is unreachable. Fix your connection or use"
@@ -220,25 +253,45 @@ def fetch_style_from_url(self, url: str) -> Optional[Path]:
                 fg="red",
                 err=True,
             )
-            return None
-        if not response.ok:
-            raise FileNotFoundError(f"Error {response} fetching style URL {new_url}")
+            return None, ""
 
         # Save the first full path to be used by the next files without parent.
         if not self._first_full_path:
             self._first_full_path = new_url.rsplit("/", 1)[0]
 
+        self._already_included.add(new_url)
+        return Path(f"{slugify(new_url)}.toml"), contents
+
+    def fetch_from_url_or_cache(self, new_url: str) -> str:
+        """Fetch data from a remote URL, or read from the local cache.
+
+        `Storing Items In The Cache <https://cachy.readthedocs.io/en/latest/usage.html#storing-items-in-the-cache>`_.
+        """
+        caching, caching_delta = parse_cache_option(self.cache_option)
+        if caching != CachingEnum.NEVER:
+            cached_value = self.cache_manager.get(new_url)
+            if cached_value is not None:
+                logger.debug(f"Using cached value for URL {new_url}")
+                return cached_value
+
+        response = requests.get(new_url)
+        logger.debug(f"Requesting style from URL {new_url}")
+        if not response.ok:
+            raise FileNotFoundError(f"Error {response} fetching style URL {new_url}")
+
         contents = response.text
-        style_path = self.cache_dir / f"{slugify(new_url)}.toml"
-        self.cache_dir.mkdir(parents=True, exist_ok=True)
-        style_path.write_text(contents)
 
-        logger.debug("Loading style from URL {} into {}", new_url, style_path)
-        self._already_included.add(new_url)
+        if caching == CachingEnum.FOREVER:
+            logger.debug(f"Caching forever the contents of {new_url}")
+            self.cache_manager.forever(new_url, contents)
+        elif caching == CachingEnum.EXPIRES:
+            future = datetime.now() + caching_delta
+            logger.debug(f"Caching the contents of {new_url} to expire in {future}")
+            self.cache_manager.put(new_url, contents, future)
 
-        return style_path
+        return contents
 
-    def fetch_style_from_local_path(self, partial_filename: str) -> Optional[Path]:
+    def fetch_style_from_local_path(self, partial_filename: str) -> Tuple[Optional[Path], str]:
         """Fetch a style file from a local path."""
         if partial_filename and not partial_filename.endswith(TOML_EXTENSION):
             partial_filename += TOML_EXTENSION
@@ -256,19 +309,17 @@ def fetch_style_from_local_path(self, partial_filename: str) -> Optional[Path]:
             self._first_full_path = str(style_path.resolve().parent)
 
         if str(style_path) in self._already_included:
-            return None
+            return None, ""
 
         if not style_path.exists():
             raise FileNotFoundError(f"Local style file does not exist: {style_path}")
 
         logger.debug(f"Loading style from {style_path}")
         self._already_included.add(str(style_path))
-        return style_path
+        return style_path, style_path.read_text()
 
     def merge_toml_dict(self) -> JsonDict:
         """Merge all included styles into a TOML (actually JSON) dictionary."""
-        if not self.cache_dir:
-            return {}
         merged_dict = self._all_styles.merge()
         # TODO: check if the merged style file is still needed
         merged_style_path: Path = self.cache_dir / MERGED_STYLE_TOML
@@ -277,7 +328,6 @@ def merge_toml_dict(self) -> JsonDict:
         attempt = 1
         while attempt < 5:
             try:
-                self.cache_dir.mkdir(parents=True, exist_ok=True)
                 merged_style_path.write_text(toml.reformatted)
                 break
             except OSError:
@@ -305,7 +355,7 @@ def load_fixed_dynamic_classes(self) -> Tuple[Plugins, Plugins]:
         """Separate classes with fixed file names from classes with dynamic files names."""
         fixed_name_classes: Plugins = set()
         dynamic_name_classes: Plugins = set()
-        for plugin_class in self.plugin_manager.hook.plugin_class():  # pylint: disable=no-member
+        for plugin_class in self.project.plugin_manager.hook.plugin_class():  # pylint: disable=no-member
             if plugin_class.filename:
                 fixed_name_classes.add(plugin_class)
             else:
diff --git a/tasks.py b/tasks.py
index e26a898c..55472668 100644
--- a/tasks.py
+++ b/tasks.py
@@ -126,10 +126,10 @@ def pylint(c):
     c.run("poetry run pylint src/")
 
 
-@task
-def pre_commit(c):
+@task(help={"hook": "Specific hook to run"})
+def pre_commit(c, hook=""):
     """Run pre-commit for all files."""
-    c.run("pre-commit run --all-files")
+    c.run(f"pre-commit run --all-files {hook}")
 
 
 @task(
@@ -149,7 +149,7 @@ def doc(c, full=False, recreate=False, links=False, open=False, debug=False):
         recreate = links = True
     if recreate:
         c.run("mkdir -p docs/_static")
-        c.run("rm -rf docs/source")
+        c.run(f"rm -rf {DOCS_BUILD_PATH} docs/source")
 
     c.run(f"poetry run {tox.generate_rst}")
     c.run(f"poetry run {tox.api}")
diff --git a/tests/conftest.py b/tests/conftest.py
index ae4ea83c..5a622b27 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -1,11 +1,13 @@
 """Pytest fixtures."""
 from pathlib import Path
+from textwrap import dedent
 
 import pytest
+from responses import RequestsMock
 
 
 @pytest.fixture()
-def project_with_default_style(tmp_path):
+def project_default(tmp_path):
     """Project with the default Nitpick style.
 
     These imports below have to be here within the fixture, otherwise they raise an error on tox:
@@ -26,3 +28,34 @@ def project_with_default_style(tmp_path):
         style = "{nitpick_style}"
         """
     )
+
+
+@pytest.fixture()
+def project_remote(request, tmp_path):
+    """Project with a remote style (loaded from a URL)."""
+    from tests.helpers import ProjectMock
+
+    remote_url = "https://example.com/remote-style.toml"
+    remote_style = """
+        ["pyproject.toml".tool.black]
+        line-length = 100
+    """
+    # https://docs.pytest.org/en/stable/fixture.html#using-markers-to-pass-data-to-fixtures
+    marker = request.node.get_closest_marker("tool_nitpick")
+    tool_nitpick = marker.args[0] if marker else ""
+
+    with RequestsMock() as mocked_response:
+        mocked_response.add(mocked_response.GET, remote_url, dedent(remote_style), status=200)
+
+        project = ProjectMock(tmp_path)
+        project.pyproject_toml(
+            f"""
+            [tool.nitpick]
+            style = "{remote_url}"
+            {tool_nitpick}
+
+            [tool.black]
+            line-length = 100
+            """
+        ).remote(mocked_response, remote_url)
+        yield project
diff --git a/tests/helpers.py b/tests/helpers.py
index 915a4a8c..f643d079 100644
--- a/tests/helpers.py
+++ b/tests/helpers.py
@@ -9,6 +9,7 @@
 import pytest
 from click.testing import CliRunner
 from more_itertools.more import always_iterable, windowed
+from responses import RequestsMock
 from testfixtures import compare
 
 from nitpick.cli import nitpick_cli
@@ -59,6 +60,8 @@ def __init__(self, tmp_path: Path, **kwargs) -> None:
 
         self.root_dir: Path = tmp_path
         self.cache_dir = self.root_dir / CACHE_DIR_NAME / PROJECT_NAME
+        self._mocked_response: Optional[RequestsMock] = None
+        self._remote_url: Optional[str] = None
         self.files_to_lint: List[Path] = []
 
         if kwargs.get("setup_py", True):
@@ -114,11 +117,11 @@ def flake8(self, offline=False):
 
     def api_check(self, *partial_names: str):
         """Test only the API in check mode, no flake8 plugin."""
-        return self._simulate_run(*partial_names, flake8=False, apply=False)
+        return self._simulate_run(*partial_names, api=True, flake8=False, apply=False)
 
     def api_apply(self, *partial_names: str):
         """Test only the API in apply mode, no flake8 plugin."""
-        return self._simulate_run(*partial_names, flake8=False, apply=True)
+        return self._simulate_run(*partial_names, api=True, flake8=False, apply=True)
 
     def api_check_then_apply(
         self, *expected_violations_when_applying: Fuss, partial_names: Optional[Iterable[str]] = None
@@ -340,8 +343,8 @@ def cli_run(self, str_or_lines: StrOrList = None, apply=False, violations=0) ->
 
     def cli_ls(self, str_or_lines: StrOrList):
         """Run the ls command and assert the output."""
-        _, actual, expected = self._simulate_cli("ls", str_or_lines)
-        compare(actual=actual, expected=expected)
+        result, actual, expected = self._simulate_cli("ls", str_or_lines)
+        compare(actual=actual, expected=expected, prefix=f"Result: {result}")
 
     def assert_file_contents(self, *name_contents: Union[PathOrStr, str]):
         """Assert the file has the expected contents."""
@@ -350,3 +353,14 @@ def assert_file_contents(self, *name_contents: Union[PathOrStr, str]):
             actual = self.read_file(filename)
             expected = dedent(file_contents).strip()
             compare(actual=actual, expected=expected, prefix=f"Filename: {filename}")
+
+    def remote(self, mocked_response: RequestsMock, remote_url: str) -> "ProjectMock":
+        """Set the mocked response and the remote URL."""
+        self._mocked_response = mocked_response
+        self._remote_url = remote_url
+        return self
+
+    def assert_call_count(self, expected_count: int) -> "ProjectMock":
+        """Assert the expected request count on the mocked response object."""
+        assert self._mocked_response and self._mocked_response.assert_call_count(self._remote_url, expected_count)
+        return self
diff --git a/tests/test_cache.py b/tests/test_cache.py
new file mode 100644
index 00000000..51929a3f
--- /dev/null
+++ b/tests/test_cache.py
@@ -0,0 +1,136 @@
+"""Test cache."""
+from datetime import timedelta
+
+import pytest
+from freezegun import freeze_time
+
+from nitpick.enums import CachingEnum
+from nitpick.style import parse_cache_option
+
+
+@pytest.mark.tool_nitpick("cache = 'forever'")
+def test_forever(project_remote):
+    """Test cache being stored forever."""
+    project_remote.assert_call_count(0)
+    for _ in range(3):
+        project_remote.api_check().assert_violations()
+    project_remote.assert_call_count(1)
+
+    with freeze_time("2021-03-15 10:00") as frozen_datetime:
+        project_remote.api_check().assert_violations().assert_call_count(1)
+
+        # Next year, still cached
+        frozen_datetime.move_to("2022-01-20 22:13")
+        project_remote.api_check().assert_violations().assert_call_count(1)
+
+        # Flake8
+        project_remote.flake8(offline=False).assert_no_errors().assert_call_count(1)
+        project_remote.flake8(offline=True).assert_no_errors().assert_call_count(1)
+
+        # CLI
+        project_remote.cli_run().assert_call_count(1)
+
+
+@pytest.mark.tool_nitpick("cache = 'never'")
+def test_never(project_remote):
+    """Test cache being never stored."""
+    project_remote.assert_call_count(0)
+    for _ in range(3):
+        project_remote.api_check().assert_violations()
+    project_remote.assert_call_count(3)
+
+    # Flake8 online
+    project_remote.flake8(offline=False).assert_no_errors().assert_call_count(4)
+
+    # Flake8 offline (number of requests unchanged)
+    project_remote.flake8(offline=True).assert_no_errors().assert_call_count(4)
+
+    # CLI
+    project_remote.cli_run().assert_call_count(5)
+
+
+@pytest.mark.parametrize(
+    "cache_option,expected_enum,expected_timedelta",
+    [
+        ("never", CachingEnum.NEVER, timedelta()),
+        (" NEVER\n ", CachingEnum.NEVER, timedelta()),
+        ("forever", CachingEnum.FOREVER, timedelta()),
+        ("\t  Forever \n", CachingEnum.FOREVER, timedelta()),
+        (" 15 minutes garbage", CachingEnum.EXPIRES, timedelta(minutes=15)),
+        (" 20 minute ", CachingEnum.EXPIRES, timedelta(minutes=20)),
+        (" 3 hours ", CachingEnum.EXPIRES, timedelta(hours=3)),
+        (" 2 hour ", CachingEnum.EXPIRES, timedelta(hours=2)),
+        (" 4 hourly whatever ", CachingEnum.EXPIRES, timedelta(hours=4)),
+        (" 2 days ", CachingEnum.EXPIRES, timedelta(days=2)),
+        (" 3 dayly bread ", CachingEnum.EXPIRES, timedelta(days=3)),
+        (" 1 week ", CachingEnum.EXPIRES, timedelta(weeks=1)),
+        (" 2 weeks ", CachingEnum.EXPIRES, timedelta(weeks=2)),
+        ("", CachingEnum.EXPIRES, timedelta(hours=1)),
+        ("   ", CachingEnum.EXPIRES, timedelta(hours=1)),
+        (" 1 second ", CachingEnum.EXPIRES, timedelta(hours=1)),
+        (" 2 bananas ", CachingEnum.EXPIRES, timedelta(hours=1)),
+    ],
+)
+def test_parse_cache_option(cache_option, expected_enum, expected_timedelta):
+    """Test the cache option provided on pyproject.toml.
+
+    doctest-style failed on the GitHub Workflow because the timedelta output is different on Python 3.6 and 3.7:
+
+    064     >>> parse_cache_option(" 15 minutes garbage")
+    Expected:
+      (<CachingEnum.EXPIRES: 3>, datetime.timedelta(0, 900))
+    Got:
+      (<CachingEnum.EXPIRES: 3>, datetime.timedelta(seconds=900))
+
+    /home/runner/work/nitpick/nitpick/src/nitpick/style.py:64: DocTestFailure
+    """
+    assert parse_cache_option(cache_option) == (expected_enum, expected_timedelta)
+
+
+@pytest.mark.tool_nitpick("cache = '15 minutes'")
+def test_expiration(project_remote):
+    """Test cache expiring after some time."""
+    with freeze_time("2021-03-10 22:00") as frozen_datetime:
+        project_remote.assert_call_count(0)
+
+        # One HTTP request
+        project_remote.api_check().assert_violations().assert_call_count(1)
+
+        # Still one request
+        frozen_datetime.move_to("2021-03-10 22:13")
+        project_remote.api_check().assert_violations().assert_call_count(1)
+
+        # Flake8 online
+        project_remote.flake8(offline=False).assert_no_errors().assert_call_count(1)
+        # Flake8 offline (number of requests unchanged)
+        project_remote.flake8(offline=True).assert_no_errors().assert_call_count(1)
+        # CLI
+        project_remote.cli_run().assert_call_count(1)
+
+        # Time's up: another HTTP request
+        frozen_datetime.move_to("2021-03-10 22:16")
+        project_remote.api_check().assert_violations().assert_call_count(2)
+
+        # Flake8 online
+        project_remote.flake8(offline=False).assert_no_errors().assert_call_count(2)
+        # Flake8 offline (number of requests unchanged)
+        project_remote.flake8(offline=True).assert_no_errors().assert_call_count(2)
+        # CLI
+        project_remote.cli_run().assert_call_count(2)
+
+
+def test_default_cache_when_nothing_provided(project_remote):
+    """Test the default cache option when nothing is provided: 1 hour."""
+    with freeze_time("2021-03-16 11:00") as frozen_datetime:
+        project_remote.assert_call_count(0)
+
+        # One HTTP request
+        project_remote.api_check().assert_violations().assert_call_count(1)
+
+        # Still one request
+        frozen_datetime.move_to("2021-03-16 11:30")
+        project_remote.api_check().assert_violations().assert_call_count(1)
+
+        # Time's up: another HTTP request
+        frozen_datetime.move_to("2021-03-16 12:01")
+        project_remote.api_check().assert_violations().assert_call_count(2)
diff --git a/tests/test_ini.py b/tests/test_ini.py
index 9b0c19c2..d6cfb46c 100644
--- a/tests/test_ini.py
+++ b/tests/test_ini.py
@@ -16,7 +16,7 @@ def test_setup_cfg_has_no_configuration(tmp_path):
 
 
 @XFAIL_ON_WINDOWS
-def test_default_style_is_applied(project_with_default_style):
+def test_default_style_is_applied(project_default):
     """Test if the default style is applied on an empty project."""
     expected_setup_cfg = """
         [flake8]
@@ -111,7 +111,7 @@ def test_default_style_is_applied(project_with_default_style):
         [VARIABLES]
         dummy-variables-rgx = _$|dummy
     """
-    project_with_default_style.api_check_then_apply(
+    project_default.api_check_then_apply(
         Fuss(True, SETUP_CFG, 321, " was not found. Create it with this content:", expected_setup_cfg),
         Fuss(True, EDITOR_CONFIG, 321, " was not found. Create it with this content:", expected_editor_config),
         Fuss(True, TOX_INI, 321, " was not found. Create it with this content:", expected_tox_ini),
diff --git a/tests/test_style.py b/tests/test_style.py
index e814a44b..76c28045 100644
--- a/tests/test_style.py
+++ b/tests/test_style.py
@@ -558,7 +558,7 @@ def test_invalid_tool_nitpick_on_pyproject_toml(offline, tmp_path):
     for style, error_message in [
         (
             'style = [""]\nextra_values = "also raise warnings"',
-            f"extra_values: Unknown configuration. See {READ_THE_DOCS_URL}tool_nitpick_section.html."
+            f"extra_values: Unknown configuration. See {READ_THE_DOCS_URL}configuration.html."
             + "\nstyle.0: Shorter than minimum length 1.",
         ),
         ('style = ""', "style: Shorter than minimum length 1."),
diff --git a/tox.ini b/tox.ini
index 2759bb47..3c9ea1ec 100644
--- a/tox.ini
+++ b/tox.ini
@@ -86,6 +86,8 @@ addopts = -v
 norecursedirs = .* build dist CVS _darcs {arch} *.egg venv var docs
 # https://docs.pytest.org/en/stable/reference.html#confval-testpaths
 testpaths = src tests
+markers =
+    tool_nitpick: options to add to the [tool.nitpick] section on remote styles (see project_remote)
 
 [coverage:run]
 # https://coverage.readthedocs.io/en/latest/config.html#run