Some fixes for readthedocs build and CI config

.github/workflows/build.yml

@@ -2,10 +2,10 @@ name: Build
 
 on:
   push:
-    branches: [master, dev]
+    branches: [main, dev]
     tags: ['v*']
   pull_request:
-    branches: [master, dev]
+    branches: [main, dev]
   workflow_dispatch:
 
 jobs:
@@ -59,8 +59,8 @@ jobs:
         run: mypy .
       - name: Run linter
         run: flake8 aiohttp_client_cache
-#      - name: Generate code coverage report
-#        run: pytest --cov --cov-report=term --cov-report=html
+      - name: Generate code coverage report
+        run: pytest --cov --cov-report=term --cov-report=html
 #      - name: Send code coverage report to Coveralls
 #        env:
 #          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.readthedocs.yml

@@ -13,3 +13,4 @@ python:
       path: .
       extra_requirements:
         - docs
+        - backends

README.md

@@ -107,7 +107,7 @@ Caching behavior can be customized by defining various conditions:
 * Specific request parameters
 * Custom filter function
 
-See [CacheBackend](https://aiohttp-client-cache.readthedocs.io/en/latest/modules/aiohttp_client_cache.backends.base.html)
+See [CacheBackend](https://aiohttp-client-cache.readthedocs.io/en/latest/modules/aiohttp_client_cache.backends.base.html#aiohttp_client_cache.backends.base.CacheBackend)
 docs for details.
 
 ## Credits

aiohttp_client_cache/backends/base.py

@@ -17,7 +17,7 @@
 
 class CacheBackend:
     """Base class for cache backends. This manages higher-level cache operations,
-     including cache expiration, generating cache keys, and managing redirect history.
+    including cache expiration, generating cache keys, and managing redirect history.
 
     If instantiated directly, ``CacheBackend`` will use a non-persistent in-memory cache.
 

aiohttp_client_cache/backends/dynamodb.py

@@ -15,6 +15,8 @@ class DynamoDBBackend(CacheBackend):
     See `DynamoDB Service Resource
     <https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/dynamodb.html#service-resource>`_
     for more usage details.
+
+    See :py:class:`.CacheBackend` for args.
     """
 
     @extend_signature(CacheBackend.__init__)

aiohttp_client_cache/backends/gridfs.py

@@ -12,6 +12,11 @@
 class GridFSBackend(CacheBackend):
     """An async-compatible interface for caching objects in MongoDB GridFS.
     Use this if you need to support documents greater than 16MB.
+
+    Args:
+        connection: Optional client object to use instead of creating a new one
+
+    See :py:class:`.CacheBackend` for additional args.
     """
 
     @extend_signature(CacheBackend.__init__)

aiohttp_client_cache/backends/mongo.py

@@ -8,7 +8,13 @@
 
 
 class MongoDBBackend(CacheBackend):
-    """MongoDB cache backend"""
+    """MongoDB cache backend
+
+    Args:
+        connection: Optional client object to use instead of creating a new one
+
+    See :py:class:`.CacheBackend` for additional args.
+    """
 
     @extend_signature(CacheBackend.__init__)
     def __init__(self, cache_name: str = 'http-cache', connection: MongoClient = None, **kwargs):

aiohttp_client_cache/backends/redis.py

@@ -8,7 +8,10 @@
 
 
 class RedisBackend(CacheBackend):
-    """Redis cache backend"""
+    """Redis cache backend.
+
+    See :py:class:`.CacheBackend` for args.
+    """
 
     @extend_signature(CacheBackend.__init__)
     def __init__(self, cache_name: str = 'http-cache', **kwargs):

aiohttp_client_cache/backends/sqlite.py

@@ -20,6 +20,8 @@ class SQLiteBackend(CacheBackend):
 
     Args:
         cache_name: Database filename
+
+    See :py:class:`.CacheBackend` for additional args.
     """
 
     @extend_signature(CacheBackend.__init__)

test/test_session.py

@@ -1,9 +1,17 @@
 import pytest
-from unittest.mock import AsyncMock, MagicMock, patch
+import sys
+from unittest.mock import MagicMock, patch
 
 from aiohttp_client_cache.backends import CacheBackend
 from aiohttp_client_cache.session import CachedSession, ClientSession
 
+# AsyncMock was added in python 3.8
+try:
+    from unittest.mock import AsyncMock
+except ImportError:
+    pass
+pytestmark = pytest.mark.skipif(sys.version_info < (3, 8), reason="requires python 3.8 or higher")
+
 
 @pytest.mark.asyncio
 @patch.object(ClientSession, '_request')