chore: Test, ignore this

.github/workflows/test.yml

@@ -26,13 +26,13 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
           cache: "pip"
-          cache-dependency-path: "requirements/dev.txt"
+          cache-dependency-path: "requirements/test.txt"
           check-latest: true
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
           pip install flake8
-          pip install -r requirements/dev.txt
+          pip install -r requirements/test.txt
       - name: Setup cache
         id: cache-pytest
         uses: actions/cache@v3
@@ -47,8 +47,7 @@ jobs:
           flake8 . --count --exit-zero --max-complexity=10 --max-line-length=120 --statistics
       - name: Run code coverage with pytest
         run: |
-          coverage run -m pytest
-          coverage xml
+          pytest
       - name: Upload code coverage to codecov.io
         uses: codecov/codecov-action@v3
         with:

.gitignore

@@ -184,5 +184,10 @@ __pycache__
 test.py
 node_modules/*
 
+# Tests
+!discord/ext/testing/mock_responses/*.json
+!tests/assets/*.png
+!tests/assets/*.json
+
 # changelog is autogenerated from CHANGELOG.md
 docs/changelog.md

README.rst

@@ -16,6 +16,9 @@ Pycord
 .. image:: https://img.shields.io/github/v/release/Pycord-Development/pycord?include_prereleases&label=Latest%20Release&logo=github&sort=semver&style=for-the-badge&logoColor=white
    :target: https://github.com/Pycord-Development/pycord/releases
    :alt: Latest release
+.. image:: https://img.shields.io/codecov/c/github/Pycord-Development/pycord?style=for-the-badge&token=15RRquov0F
+   :target: https://codecov.io/gh/Pycord-Development/pycord
+   :alt: Codecov
 
 A fork of discord.py. Pycord is a modern, easy to use, feature-rich, and async ready API wrapper for Discord written in Python.
 

codecov.yml

@@ -6,20 +6,22 @@ coverage:
   status:
     project:
       default:
-        target: 0%
+        target: auto
+        threshold: 1%
+        paths:
+          - discord
       http:
-        target: 0%
-        flags:
-          - http
+        target: 55%
+        paths:
+          - tests/http
+          - discord/http.py
     patch:
       default:
-        target: 0%
+        target: 90%
+        paths:
+          - discord
       http:
-        target: 0%
-        flags:
-          - http
-
-flags:
-  http:
-    paths:
-      - discord/http.py
+        target: 100%
+        paths:
+          - tests/http
+          - discord/http.py

tests/helpers.py → discord/ext/testing/__init__.py

@@ -1,7 +1,6 @@
 """
 The MIT License (MIT)
 
-Copyright (c) 2015-2021 Rapptz
 Copyright (c) 2021-present Pycord Development
 
 Permission is hereby granted, free of charge, to any person obtaining a
@@ -22,10 +21,5 @@
 FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
 DEALINGS IN THE SOFTWARE.
 """
-from typing import TypeVar
 
-V = TypeVar("V")
-
-
-async def coroutine(val: V) -> V:
-    return val
+from .core import *

discord/ext/testing/core.py

@@ -0,0 +1,153 @@
+"""
+The MIT License (MIT)
+
+Copyright (c) 2021-present Pycord Development
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+"""
+from __future__ import annotations
+
+import inspect
+import json
+import os
+from typing import Any, Callable, Iterable, Literal, Sequence
+from unittest.mock import AsyncMock, MagicMock, patch
+
+from ... import MISSING, File
+from ...client import Client
+from ...http import HTTPClient, Route
+
+__all__ = (
+    "Test",
+    "Mocked",
+    "get_mock_response",
+)
+
+
+def get_mock_response(name: str) -> dict[str, Any]:
+    with open(
+        os.path.join(os.path.dirname(__file__), "mock_responses", f"{name}.json")
+    ) as f:
+        return json.load(f)
+
+
+class Mocked:
+    def __init__(
+        self,
+        name: str,
+        return_value: Any | Callable[[...], Any] | None = None,
+        approach: Literal["merge", "replace"] = "replace",
+    ):
+        self.name = name
+        self.mock: MagicMock | AsyncMock | None = None
+
+        if callable(return_value):
+
+            async def wrapped(*args, **kwargs):
+                inner = return_value(*args, **kwargs)
+                if inspect.isawaitable(inner):
+                    inner = await inner
+                if approach == "merge":
+                    inner = dict(**get_mock_response(self.name), **inner)
+                return inner
+
+            self.patcher = patch.object(HTTPClient, self.name, wrapped)
+            self.return_value = None
+        else:
+            if return_value is None:
+                return_value = {}
+                approach = "merge"
+            if approach == "merge":
+                return_value = dict(**get_mock_response(self.name), **return_value)
+            self.patcher = patch.object(HTTPClient, self.name, autospec=True)
+            self.return_value = return_value
+
+    def __enter__(self) -> MagicMock | AsyncMock:
+        self.mock = self.patcher.start()
+        if self.return_value is not None:
+
+            async def _coro():
+                return self.return_value
+
+            self.mock.return_value = _coro()
+        return self.mock
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.patcher.stop()
+
+
+class Test:
+    http: HTTPClient
+
+    def __init__(self, client: Client):
+        self.__client = client
+
+    def patch(
+        self,
+        name: str,
+        return_value: Any | Callable[[...], Any] | None = None,
+        approach: Literal["merge", "replace"] = "replace",
+    ) -> Mocked:
+        return Mocked(name, return_value, approach)
+
+    def makes_request(
+        self,
+        route: Route,
+        *,
+        files: Sequence[File] | None | MISSING = MISSING,
+        form: Iterable[dict[str, Any]] | None | MISSING = MISSING,
+        side_effect: Any | Callable[[...], Any] | None = None,
+        **kwargs: Any,
+    ):
+        class _Request:
+            def __init__(
+                self, client: Client, route, files, form, *, side_effect, **kwargs
+            ):
+                if side_effect is None:
+                    self.patcher = patch.object(client.http, "request", autospec=True)
+                else:
+                    self.patcher = patch.object(
+                        client.http, "request", side_effect=side_effect
+                    )
+                self.route = route
+                self.files = files
+                self.form = form
+                self.kwargs = kwargs
+
+            def __enter__(self):
+                self.mock = self.patcher.start()
+                return self
+
+            def __exit__(self, exc_type, exc_val, exc_tb):
+                self.patcher.stop()
+                if self.form is not MISSING:
+                    self.kwargs["form"] = self.form
+                if self.files is not MISSING:
+                    self.kwargs["files"] = self.files
+                self.mock.assert_called_once_with(
+                    self.route,
+                    **self.kwargs,
+                )
+
+        return _Request(
+            self.__client, route, files, form, side_effect=side_effect, **kwargs
+        )
+
+    def __getattr__(self, name: str) -> Any:
+        return getattr(self.__client, name)

discord/ext/testing/fixtures/__init__.py

@@ -0,0 +1,25 @@
+"""
+The MIT License (MIT)
+
+Copyright (c) 2021-present Pycord Development
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+"""
+from .core import *
+from .http import *