longwei 1.0.0.dev0__tar.gz → 1.1.1__tar.gz

{longwei-1.0.0.dev0 → longwei-1.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: longwei
-Version: 1.0.0.dev0
+Version: 1.1.1
 Summary: Python client library for ActivityPub-compatible servers
 Author: marvin8
 Author-email: marvin8 <marvin8@tuta.io>
@@ -16,17 +16,16 @@ Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Dist: httpx[http2,zstd]~=0.28.1
 Requires-Dist: pydantic~=2.12.5
-Requires-Dist: pytz~=2026.1.post1
-Requires-Dist: whenever~=0.9.5
 Requires-Python: >=3.11, <3.15
-Project-URL: Changelog, https://codeberg.org/MarvinsMastodonTools/longwei/src/branch/main/CHANGELOG.md
-Project-URL: Documentation, https://marvinsmastodontools.codeberg.page/longwei/
+Project-URL: Documentation, https://marvinsmastodontools.codeberg.page/longwei/latest/
 Project-URL: Issues, https://codeberg.org/MarvinsMastodonTools/longwei/issues
 Project-URL: Source, https://codeberg.org/MarvinsMastodonTools/longwei
+Project-URL: Changelog, https://codeberg.org/MarvinsMastodonTools/longwei/src/branch/main/CHANGELOG.md
 Description-Content-Type: text/markdown
 
 # longwei
 
+[![Docs](https://img.shields.io/badge/docs-latest-blue)](https://marvinsmastodontools.codeberg.page/longwei/latest/ "Latest documentation")
 [![Repo](https://img.shields.io/badge/repo-Codeberg.org-blue)](https://codeberg.org/MarvinsMastodonTools/longwei "Repo at Codeberg.org")
 [![CI](https://ci.codeberg.org/api/badges/MarvinsMastodonTools/longwei/status.svg)](https://ci.codeberg.org/MarvinsMastodonTools/longwei "CI / Woodpecker")
 [![Downloads](https://pepy.tech/badge/longwei)](https://pepy.tech/project/longwei "Download count")
@@ -39,25 +38,48 @@ Description-Content-Type: text/markdown
 [![Wheel](https://img.shields.io/pypi/wheel/longwei)](https://pypi.org/project/longwei "PyPI – Wheel")
 [![License: AGPL-3.0-or-later](https://img.shields.io/badge/License-AGPL--3.0--or--later-blue.svg)](https://spdx.org/licenses/AGPL-3.0-or-later.html "AGPL 3 or later")
 
-Longwei is a minimal Python implementation of the ActivityPub REST API used by [Mastodon](https://joinmastodon.org/), [Pleroma](https://pleroma.social/), [GotoSocial](https://gotosocial.org/), and [Takahe](https://jointakahe.org/). This implementation makes use of asyncio where appropriate. It is intended to be used as a library by other applications. No standalone functionality is provided.
+Longwei is a minimal Python implementation of the ActivityPub client REST API used by [Mastodon](https://joinmastodon.org/), [Pleroma](https://pleroma.social/), and [GotoSocial](https://gotosocial.org/). This implementation makes use of asyncio where appropriate. It is intended to be used as a library by other applications. No standalone functionality is provided.
 
-So far Longwei only implements the activtiy pub API calls I need for my other projects [Fedinesia](https://codeberg.org/MarvinsMastodonTools/fedinesia), [Feed2Fedi](https://codeberg.org/marvinsmastodontools/feed2fedi), [FenLiu and Zhongli](https://codeberg.org/marvinsmastodontools/dujiangyan).
+So far Longwei only implements the ActivityPub API calls I need for my other projects [Fedinesia](https://codeberg.org/MarvinsMastodonTools/fedinesia), [Feed2Fedi](https://codeberg.org/marvinsmastodontools/feed2fedi), [FenLiu and Zhongli](https://codeberg.org/marvinsmastodontools/dujiangyan).
 
 **DO NOT** expect a full or complete implementation of all [ActivityPub API](https://activitypub.rocks/) functionality.
 
+## Quick start
+
+```bash
+pip install longwei
+```
+
+```python
+import asyncio
+import httpx
+from longwei import APClient
+
+async def main():
+    async with httpx.AsyncClient() as client:
+        ap = await APClient.create(
+            instance="mastodon.social",
+            client=client,
+            access_token="your_token",
+        )
+        status = await ap.post_status("Hello, fediverse!")
+        print(status.url)
+
+asyncio.run(main())
+```
+
 ## API References
 
 - [Mastodon API](https://docs.joinmastodon.org/api/)
 - [Pleroma API](https://api.pleroma.social)
 - [GotoSocial API](https://docs.gotosocial.org/en/stable/api/swagger/)
 
-## Heavy Development / Breaking Changes
-
-I have only just forked this from minimal_activitypub and am still working on it. Expect some major changes still and some breaking changes.
-It is **not** a drop in replacement and will need some adjustments, even when I am done with the rework.
+## Status
 
-I advise not to use this at until at least version 1.0.0 (non dev)
+longwei is a fork of `minimal_activitypub`. The main breaking change from that package is the
+class rename: `ActivityPub` → `APClient`. See the [Upgrading guide](https://marvinsmastodontools.codeberg.page/longwei/latest/upgrading/) for migration instructions.
 
+It is **not** a drop-in replacement. See the upgrading guide for migration instructions.
 
 ## Contributing
 
@@ -67,26 +89,15 @@ longwei is using [pre-commit](https://pre-commit.com/) for code quality checks a
 
 ## Documentation
 
-The documentation is built using [MkDocs](https://www.mkdocs.org/) with the [Material theme](https://squidfunk.github.io/mkdocs-material/).
+The live documentation is at **https://marvinsmastodontools.codeberg.page/longwei/latest/**
 
-### Building Documentation Locally
+Built with [MkDocs](https://www.mkdocs.org/) and the [Material theme](https://squidfunk.github.io/mkdocs-material/). To build and serve locally:
 
 ```bash
-# Install documentation dependencies (using the docs group from pyproject.toml)
 uv sync --group docs
-
-# Build documentation
-mkdocs build
-
-# Serve documentation locally
 mkdocs serve
 ```
 
-### Documentation Structure
-
-- `docs/` - Markdown source files
-- `mkdocs.yml` - MkDocs configuration
-
 ## Development
 
 This project uses [uv](https://docs.astral.sh/uv/) for dependency management and virtual environments. To set up the development environment:

{longwei-1.0.0.dev0 → longwei-1.1.1}/README.md

@@ -1,5 +1,6 @@
 # longwei
 
+[![Docs](https://img.shields.io/badge/docs-latest-blue)](https://marvinsmastodontools.codeberg.page/longwei/latest/ "Latest documentation")
 [![Repo](https://img.shields.io/badge/repo-Codeberg.org-blue)](https://codeberg.org/MarvinsMastodonTools/longwei "Repo at Codeberg.org")
 [![CI](https://ci.codeberg.org/api/badges/MarvinsMastodonTools/longwei/status.svg)](https://ci.codeberg.org/MarvinsMastodonTools/longwei "CI / Woodpecker")
 [![Downloads](https://pepy.tech/badge/longwei)](https://pepy.tech/project/longwei "Download count")
@@ -12,25 +13,48 @@
 [![Wheel](https://img.shields.io/pypi/wheel/longwei)](https://pypi.org/project/longwei "PyPI – Wheel")
 [![License: AGPL-3.0-or-later](https://img.shields.io/badge/License-AGPL--3.0--or--later-blue.svg)](https://spdx.org/licenses/AGPL-3.0-or-later.html "AGPL 3 or later")
 
-Longwei is a minimal Python implementation of the ActivityPub REST API used by [Mastodon](https://joinmastodon.org/), [Pleroma](https://pleroma.social/), [GotoSocial](https://gotosocial.org/), and [Takahe](https://jointakahe.org/). This implementation makes use of asyncio where appropriate. It is intended to be used as a library by other applications. No standalone functionality is provided.
+Longwei is a minimal Python implementation of the ActivityPub client REST API used by [Mastodon](https://joinmastodon.org/), [Pleroma](https://pleroma.social/), and [GotoSocial](https://gotosocial.org/). This implementation makes use of asyncio where appropriate. It is intended to be used as a library by other applications. No standalone functionality is provided.
 
-So far Longwei only implements the activtiy pub API calls I need for my other projects [Fedinesia](https://codeberg.org/MarvinsMastodonTools/fedinesia), [Feed2Fedi](https://codeberg.org/marvinsmastodontools/feed2fedi), [FenLiu and Zhongli](https://codeberg.org/marvinsmastodontools/dujiangyan).
+So far Longwei only implements the ActivityPub API calls I need for my other projects [Fedinesia](https://codeberg.org/MarvinsMastodonTools/fedinesia), [Feed2Fedi](https://codeberg.org/marvinsmastodontools/feed2fedi), [FenLiu and Zhongli](https://codeberg.org/marvinsmastodontools/dujiangyan).
 
 **DO NOT** expect a full or complete implementation of all [ActivityPub API](https://activitypub.rocks/) functionality.
 
+## Quick start
+
+```bash
+pip install longwei
+```
+
+```python
+import asyncio
+import httpx
+from longwei import APClient
+
+async def main():
+    async with httpx.AsyncClient() as client:
+        ap = await APClient.create(
+            instance="mastodon.social",
+            client=client,
+            access_token="your_token",
+        )
+        status = await ap.post_status("Hello, fediverse!")
+        print(status.url)
+
+asyncio.run(main())
+```
+
 ## API References
 
 - [Mastodon API](https://docs.joinmastodon.org/api/)
 - [Pleroma API](https://api.pleroma.social)
 - [GotoSocial API](https://docs.gotosocial.org/en/stable/api/swagger/)
 
-## Heavy Development / Breaking Changes
+## Status
 
-I have only just forked this from minimal_activitypub and am still working on it. Expect some major changes still and some breaking changes.
-It is **not** a drop in replacement and will need some adjustments, even when I am done with the rework.
-
-I advise not to use this at until at least version 1.0.0 (non dev)
+longwei is a fork of `minimal_activitypub`. The main breaking change from that package is the
+class rename: `ActivityPub` → `APClient`. See the [Upgrading guide](https://marvinsmastodontools.codeberg.page/longwei/latest/upgrading/) for migration instructions.
 
+It is **not** a drop-in replacement. See the upgrading guide for migration instructions.
 
 ## Contributing
 
@@ -40,26 +64,15 @@ longwei is using [pre-commit](https://pre-commit.com/) for code quality checks a
 
 ## Documentation
 
-The documentation is built using [MkDocs](https://www.mkdocs.org/) with the [Material theme](https://squidfunk.github.io/mkdocs-material/).
+The live documentation is at **https://marvinsmastodontools.codeberg.page/longwei/latest/**
 
-### Building Documentation Locally
+Built with [MkDocs](https://www.mkdocs.org/) and the [Material theme](https://squidfunk.github.io/mkdocs-material/). To build and serve locally:
 
 ```bash
-# Install documentation dependencies (using the docs group from pyproject.toml)
 uv sync --group docs
-
-# Build documentation
-mkdocs build
-
-# Serve documentation locally
 mkdocs serve
 ```
 
-### Documentation Structure
-
-- `docs/` - Markdown source files
-- `mkdocs.yml` - MkDocs configuration
-
 ## Development
 
 This project uses [uv](https://docs.astral.sh/uv/) for dependency management and virtual environments. To set up the development environment:

{longwei-1.0.0.dev0 → longwei-1.1.1}/pyproject.toml

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["uv_build>=0.8.7,<0.9.0"]
+requires = ["uv_build>=0.11.3,<0.12.0"]
 build-backend = "uv_build"
 
 [project]
 name = "longwei"
-version = "1.0.0dev0"
+version = "1.1.1"
 authors = [
   { name = "marvin8", email = "marvin8@tuta.io" },
 ]
@@ -26,8 +26,6 @@ requires-python = ">=3.11, <3.15"
 dependencies = [
     "httpx[http2,zstd]~=0.28.1",
     "pydantic~=2.12.5",
-    "pytz~=2026.1.post1",
-    "whenever~=0.9.5",
 ]
 [dependency-groups]
 dev = [
@@ -35,15 +33,16 @@ dev = [
     "complexipy~=5.2.0",
     "git-cliff~=2.12.0",
     "prek~=0.3.8",
-    "ruff~=0.15.8",
-    "ty~=0.0.27",
-    "uv~=0.11.2",
+    "ruff~=0.15.9",
+    "ty~=0.0.29",
+    "uv~=0.11.3",
 ]
 docs = [
-    "mike~=2.1.4",
     "mkdocs~=1.6.1",
     "mkdocs-material~=9.7.6",
+    "mkdocstrings~=1.0.3",
     "mkdocstrings-python~=2.0.3",
+    "mike~=2.1.4",
 ]
 nox = [
     "nox-uv~=0.7.1",
@@ -61,7 +60,7 @@ constraint-dependencies = [
 ]
 
 [project.urls]
-Documentation = "https://marvinsmastodontools.codeberg.page/longwei/"
+Documentation = "https://marvinsmastodontools.codeberg.page/longwei/latest/"
 Issues = "https://codeberg.org/MarvinsMastodonTools/longwei/issues"
 Source = "https://codeberg.org/MarvinsMastodonTools/longwei"
 Changelog = "https://codeberg.org/MarvinsMastodonTools/longwei/src/branch/main/CHANGELOG.md"

longwei-1.0.0.dev0/src/longwei/client_2_server.py → longwei-1.1.1/src/longwei/__init__.py

@@ -1,49 +1,45 @@
-"""Simplifies interacting with an ActivityPub server / instance.
-
-This is a minimal implementation only implementing some API calls. API
-calls supported will likely be expanded over time. However, do not
-expect a full or complete implementation of the ActivityPub API.
-"""
+"""Package 'longwei' level definitions."""
 
 import logging
+from datetime import UTC
+from datetime import datetime
 
 from httpx import AsyncClient
-from whenever import Instant
 
-from longwei import SearchType  # noqa: F401
-from longwei import Visibility  # noqa: F401
-from longwei import __display_name__
-from longwei import __version__
+from longwei._base import USER_AGENT
+from longwei._base import __display_name__
+from longwei._base import __version__
 from longwei._mixin_auth import _AuthMixin
 from longwei._mixin_credentials import _CredentialsMixin
 from longwei._mixin_request_helpers import _RequestHelpersMixin
 from longwei._mixin_statuses import _StatusesMixin
 from longwei._mixin_timelines import _TimelinesMixin
 from longwei.constants import INSTANCE_TYPE_MASTODON
-from longwei.constants import INSTANCE_TYPE_PLEROMA  # noqa: F401
-from longwei.constants import INSTANCE_TYPE_TAKAHE  # noqa: F401
+from longwei.constants import INSTANCE_TYPE_PLEROMA
 from longwei.constants import MAX_ATTACHMENTS_MASTODON
-from longwei.constants import MAX_ATTACHMENTS_PLEROMA  # noqa: F401
-from longwei.constants import MAX_ATTACHMENTS_TAKAHE  # noqa: F401
-from longwei.exceptions import ActivityPubError  # noqa: F401
-from longwei.exceptions import ApiError  # noqa: F401
-from longwei.exceptions import ClientError  # noqa: F401
-from longwei.exceptions import ConflictError  # noqa: F401
-from longwei.exceptions import ForbiddenError  # noqa: F401
-from longwei.exceptions import GoneError  # noqa: F401
-from longwei.exceptions import NetworkError  # noqa: F401
-from longwei.exceptions import NotFoundError  # noqa: F401
-from longwei.exceptions import RatelimitError  # noqa: F401
-from longwei.exceptions import ServerError  # noqa: F401
-from longwei.exceptions import UnauthorizedError  # noqa: F401
-from longwei.exceptions import UnprocessedError  # noqa: F401
-from longwei.types import ActivityPubClass
-from longwei.types import Status  # noqa: F401
+from longwei.enums import SearchType
+from longwei.enums import Visibility
+from longwei.exceptions import ActivityPubError
+from longwei.exceptions import ApiError
+from longwei.exceptions import ClientError
+from longwei.exceptions import ConflictError
+from longwei.exceptions import ForbiddenError
+from longwei.exceptions import GoneError
+from longwei.exceptions import NetworkError
+from longwei.exceptions import NotFoundError
+from longwei.exceptions import RatelimitError
+from longwei.exceptions import ServerError
+from longwei.exceptions import UnauthorizedError
+from longwei.exceptions import UnprocessedError
+from longwei.models import Account
+from longwei.models import SearchResults
+from longwei.types import APClientClass
+from longwei.types import Status
 
 logger = logging.getLogger(__display_name__)
 
 
-class ActivityPub(_RequestHelpersMixin, _CredentialsMixin, _TimelinesMixin, _StatusesMixin, _AuthMixin):
+class APClient(_RequestHelpersMixin, _CredentialsMixin, _TimelinesMixin, _StatusesMixin, _AuthMixin):
     """Simplifies interacting with an ActivityPub server / instance.
 
     This is a minimal implementation only implementing methods needed
@@ -51,13 +47,13 @@ class ActivityPub(_RequestHelpersMixin, _CredentialsMixin, _TimelinesMixin, _Sta
     """
 
     def __init__(
-        self: ActivityPubClass,
+        self: APClientClass,
         instance: str,
         client: AsyncClient,
         access_token: str | None = None,
         timeout: int | None = None,
     ) -> None:
-        """Initialise ActivityPub instance with reasonable default values.
+        """Initialise APClient instance with reasonable default values.
 
         :param instance: domain name or url to instance to connect to
         :param client: httpx AsyncClient to use for communicating with instance
@@ -83,13 +79,13 @@ class ActivityPub(_RequestHelpersMixin, _CredentialsMixin, _TimelinesMixin, _Sta
         self.max_status_len = 500
         self.ratelimit_limit = 300
         self.ratelimit_remaining = 300
-        self.ratelimit_reset = Instant.now().py_datetime()
+        self.ratelimit_reset = datetime.now(UTC)
         logger.debug(
-            "client_2_server.ActivityPub(instance=%s, client=%s, access_token=<redacted>)",
+            "APClient(instance=%s, client=%s, access_token=<redacted>)",
             instance,
             client,
         )
-        logger.debug("client_2_server.ActivityPub() ... version=%s", __version__)
+        logger.debug("APClient() ... version=%s", __version__)
 
     @classmethod
     async def create(
@@ -98,8 +94,8 @@ class ActivityPub(_RequestHelpersMixin, _CredentialsMixin, _TimelinesMixin, _Sta
         client: AsyncClient,
         access_token: str | None = None,
         timeout: int | None = None,
-    ) -> "ActivityPub":
-        """Create and initialise an ActivityPub instance, auto-detecting the instance type.
+    ) -> "APClient":
+        """Create and initialise an APClient instance, auto-detecting the instance type.
 
         This is the recommended entry point. Unlike direct instantiation, this factory
         automatically calls :meth:`determine_instance_type` to configure server-specific
@@ -109,9 +105,37 @@ class ActivityPub(_RequestHelpersMixin, _CredentialsMixin, _TimelinesMixin, _Sta
         :param client: httpx AsyncClient to use for communicating with instance
         :param access_token: authentication token
         :param timeout: optional seconds to wait for a response (default: 120)
-        :returns: Fully initialised :class:`ActivityPub` instance
+        :returns: Fully initialised :class:`APClient` instance
         :raises NetworkError: if the instance cannot be reached during type detection
         """
         ap = cls(instance=instance, client=client, access_token=access_token, timeout=timeout)
         await ap.determine_instance_type()
         return ap
+
+
+__all__ = [  # noqa: RUF022
+    "Account",
+    "APClient",
+    "APClientClass",
+    "ActivityPubError",
+    "ApiError",
+    "ClientError",
+    "ConflictError",
+    "__display_name__",
+    "ForbiddenError",
+    "GoneError",
+    "INSTANCE_TYPE_MASTODON",
+    "INSTANCE_TYPE_PLEROMA",
+    "NetworkError",
+    "NotFoundError",
+    "RatelimitError",
+    "SearchResults",
+    "SearchType",
+    "ServerError",
+    "Status",
+    "UnauthorizedError",
+    "UnprocessedError",
+    "USER_AGENT",
+    "__version__",
+    "Visibility",
+]

longwei-1.1.1/src/longwei/_base.py

@@ -0,0 +1,16 @@
+"""Internal base definitions shared across mixin modules.
+
+This module exists to break the circular import that would arise if mixins
+imported directly from the ``longwei`` package: package-level constants live
+here so that ``__init__.py`` can import both this module and the mixins
+without a cycle.
+"""
+
+import sys
+from importlib.metadata import version
+from typing import Final
+
+__display_name__: Final[str] = "Longwei"
+__version__: Final[str] = version("longwei")
+
+USER_AGENT: Final[str] = f"{__display_name__}_v{__version__}_Python_{sys.version.split()[0]}"

{longwei-1.0.0.dev0 → longwei-1.1.1}/src/longwei/_mixin_auth.py

@@ -7,8 +7,8 @@ from urllib.parse import urlencode
 from httpx import AsyncClient
 from httpx import HTTPError
 
-from longwei import USER_AGENT
-from longwei import __display_name__
+from longwei._base import USER_AGENT
+from longwei._base import __display_name__
 from longwei.constants import REDIRECT_URI
 from longwei.exceptions import NetworkError
 from longwei.utils import _check_exception
@@ -32,9 +32,14 @@ class _AuthMixin:
         :param user_agent: User agent identifier to use. Defaults to longwei related one.
 
         :returns: String containing URL to visit to get access token interactively from instance.
+
+        Note:
+            Constructs a URL for ``GET /oauth/authorize``
+            (Mastodon, Pleroma, GotoSocial). No HTTP request is made by this method.
+
         """
         logger.debug(
-            "ActivityPub.get_auth_token_interactive(instance_url=%s, client=...,client_id=%s, user_agent=%s)",
+            "APClient.get_auth_token_interactive(instance_url=%s, client=...,client_id=%s, user_agent=%s)",
             instance_url,
             client_id,
             user_agent,
@@ -52,7 +57,7 @@ class _AuthMixin:
         )
         auth_url = f"{instance_url}/oauth/authorize?{url_params}"
         logger.debug(
-            "ActivityPub.get_auth_token_interactive(...) -> %s",
+            "APClient.get_auth_token_interactive(...) -> %s",
             auth_url,
         )
 
@@ -75,9 +80,14 @@ class _AuthMixin:
         :param client_secret: client secret as returned by create_app method
 
         :returns: access token
+
+        Note:
+            Implements ``POST /oauth/token`` with ``grant_type=authorization_code``
+            (Mastodon, Pleroma, GotoSocial).
+
         """
         logger.debug(
-            "ActivityPub.validate_authorization_code(authorization_code=%s, client_id=%s, client_secret=<redacted>)",
+            "APClient.validate_authorization_code(authorization_code=%s, client_id=%s, client_secret=<redacted>)",
             authorization_code,
             client_id,
         )
@@ -95,7 +105,7 @@ class _AuthMixin:
         try:
             response = await client.post(url=f"{instance_url}/oauth/token", data=data)
             logger.debug(
-                "ActivityPub.validate_authorization_code - response:\n%s",
+                "APClient.validate_authorization_code - response:\n%s",
                 response,
             )
             await _check_exception(response)
@@ -104,7 +114,7 @@ class _AuthMixin:
             raise NetworkError from error
 
         logger.debug(
-            "ActivityPub.validate_authorization_code - response.json: \n%s",
+            "APClient.validate_authorization_code - response.json: \n%s",
             json.dumps(response_dict, indent=4),
         )
         return str(response_dict["access_token"])
@@ -128,9 +138,15 @@ class _AuthMixin:
         :param client_website: Link to site for user_agent. Defaults to link to longwei on Pypi.org
 
         :returns: The access token is being returned.
+
+        Note:
+            Implements ``POST /oauth/token`` with ``grant_type=password``
+            (Pleroma, GotoSocial). The password grant is not supported by most
+            Mastodon instances by default.
+
         """
         logger.debug(
-            "ActivityPub.get_auth_token(instance_url=%s, username=%s, password=<redacted>, client=..., "
+            "APClient.get_auth_token(instance_url=%s, username=%s, password=<redacted>, client=..., "
             "user_agent=%s, client_website=%s)",
             instance_url,
             username,
@@ -159,14 +175,14 @@ class _AuthMixin:
 
         try:
             response = await client.post(url=f"{instance_url}/oauth/token", data=data)
-            logger.debug("ActivityPub.get_auth_token - response:\n%s", response)
+            logger.debug("APClient.get_auth_token - response:\n%s", response)
             await _check_exception(response)
             response_dict = response.json()
         except HTTPError as error:
             raise NetworkError from error
 
         logger.debug(
-            "ActivityPub.get_auth_token - response.json: \n%s",
+            "APClient.get_auth_token - response.json: \n%s",
             json.dumps(response_dict, indent=4),
         )
         return str(response_dict["access_token"])
@@ -186,9 +202,13 @@ class _AuthMixin:
         :param client_website: Link to site for user_agent. Defaults to link to longwei on Pypi.org
 
         :returns: tuple(client_id, client_secret)
+
+        Note:
+            Implements ``POST /api/v1/apps`` (Mastodon, Pleroma, GotoSocial).
+
         """
         logger.debug(
-            "ActivityPub.create_app(instance_url=%s, client=..., user_agent=%s, client_website=%s)",
+            "APClient.create_app(instance_url=%s, client=..., user_agent=%s, client_website=%s)",
             instance_url,
             user_agent,
             client_website,
@@ -205,14 +225,14 @@ class _AuthMixin:
         }
         try:
             response = await client.post(url=f"{instance_url}/api/v1/apps", data=data)
-            logger.debug("ActivityPub.create_app response: \n%s", response)
+            logger.debug("APClient.create_app response: \n%s", response)
             await _check_exception(response)
             response_dict = response.json()
         except HTTPError as error:
             raise NetworkError from error
 
         logger.debug(
-            "ActivityPub.create_app response.json: \n%s",
+            "APClient.create_app response.json: \n%s",
             json.dumps(response_dict, indent=4),
         )
         return (response_dict["client_id"]), (response_dict["client_secret"])