pyfordpass 0.0.1__tar.gz

pyfordpass-0.0.1/.gitignore

@@ -0,0 +1,36 @@
+*.kate-swp
+*.log
+*~
+.*.swp
+.*_cache/
+.DS_Store*
+.coverage
+.cspellcache
+.directory
+.pnp.*
+.venv/
+/.bash_profile
+/.bashrc
+/.claude/commands
+/.claude/settings.local.json
+/.gitconfig
+/.gitmodules
+/.idea
+/.mcp.json
+/.profile
+/.ripgreprc
+/.wiswa-ci/
+/.yarn/install-state.gz
+/.zprofile
+/.zshrc
+/build/
+/dist/
+/docs/_build/
+/man/_static/
+/mypy-report*/
+__pycache__/
+cobertura.xml
+coverage.xml
+htmlcov/
+mypy-report.xml
+node_modules/

pyfordpass-0.0.1/LICENSE.txt

@@ -0,0 +1,18 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 pyfordpass authors
+
+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.

pyfordpass-0.0.1/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: pyfordpass
+Version: 0.0.1
+Summary: FordPass client and CLI.
+Project-URL: Issues, https://github.com/Tatsh/pyfordpass/issues
+Project-URL: documentation, https://pyfordpass.readthedocs.org
+Project-URL: homepage, https://tatsh.github.io/pyfordpass/
+Project-URL: repository, https://github.com/Tatsh/pyfordpass
+Author-email: Andrew Udvare <audvare@gmail.com>
+License-Expression: MIT
+License-File: LICENSE.txt
+Keywords: command line,ford,fordpass
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: <4.0,>=3.10
+Requires-Dist: bascom>=0.1.3
+Requires-Dist: click>=8.4.1
+Requires-Dist: curl-cffi>=0.15.0
+Requires-Dist: niquests>=3.18.8
+Requires-Dist: platformdirs>=4.9.6
+Requires-Dist: rich>=15.0.0
+Requires-Dist: tomlkit>=0.15.0
+Requires-Dist: typing-extensions>=4.15.0
+Description-Content-Type: text/markdown
+
+# pyfordpass
+
+<!-- WISWA-GENERATED-README:START -->
+
+[![Python versions](https://img.shields.io/pypi/pyversions/pyfordpass.svg?color=blue&logo=python&logoColor=white)](https://www.python.org/)
+[![PyPI - Version](https://img.shields.io/pypi/v/pyfordpass)](https://pypi.org/project/pyfordpass/)
+[![GitHub tag (with filter)](https://img.shields.io/github/v/tag/Tatsh/pyfordpass)](https://github.com/Tatsh/pyfordpass/tags)
+[![License](https://img.shields.io/github/license/Tatsh/pyfordpass)](https://github.com/Tatsh/pyfordpass/blob/master/LICENSE.txt)
+[![GitHub commits since latest release (by SemVer including pre-releases)](https://img.shields.io/github/commits-since/Tatsh/pyfordpass/v0.0.1/master)](https://github.com/Tatsh/pyfordpass/compare/v0.0.1...master)
+[![CodeQL](https://github.com/Tatsh/pyfordpass/actions/workflows/codeql.yml/badge.svg)](https://github.com/Tatsh/pyfordpass/actions/workflows/codeql.yml)
+[![QA](https://github.com/Tatsh/pyfordpass/actions/workflows/qa.yml/badge.svg)](https://github.com/Tatsh/pyfordpass/actions/workflows/qa.yml)
+[![Tests](https://github.com/Tatsh/pyfordpass/actions/workflows/tests.yml/badge.svg)](https://github.com/Tatsh/pyfordpass/actions/workflows/tests.yml)
+[![Coverage Status](https://coveralls.io/repos/github/Tatsh/pyfordpass/badge.svg?branch=master)](https://coveralls.io/github/Tatsh/pyfordpass?branch=master)
+[![Dependabot](https://img.shields.io/badge/Dependabot-enabled-blue?logo=dependabot)](https://github.com/dependabot)
+[![Documentation Status](https://readthedocs.org/projects/pyfordpass/badge/?version=latest)](https://pyfordpass.readthedocs.org/?badge=latest)
+[![mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://mypy-lang.org/)
+[![uv](https://img.shields.io/badge/uv-261230?logo=astral)](https://docs.astral.sh/uv/)
+[![pytest](https://img.shields.io/badge/pytest-zz?logo=Pytest&labelColor=black&color=black)](https://docs.pytest.org/en/stable/)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Downloads](https://static.pepy.tech/badge/pyfordpass/month)](https://pepy.tech/project/pyfordpass)
+[![Stargazers](https://img.shields.io/github/stars/Tatsh/pyfordpass?logo=github&style=flat)](https://github.com/Tatsh/pyfordpass/stargazers)
+[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit)
+[![Prettier](https://img.shields.io/badge/Prettier-black?logo=prettier)](https://prettier.io/)
+
+[![@Tatsh](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fpublic.api.bsky.app%2Fxrpc%2Fapp.bsky.actor.getProfile%2F%3Factor=did%3Aplc%3Auq42idtvuccnmtl57nsucz72&query=%24.followersCount&label=Follow+%40Tatsh&logo=bluesky&style=social)](https://bsky.app/profile/Tatsh.bsky.social)
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Tatsh-black?logo=buymeacoffee)](https://buymeacoffee.com/Tatsh)
+[![Libera.Chat](https://img.shields.io/badge/Libera.Chat-Tatsh-black?logo=liberadotchat)](irc://irc.libera.chat/Tatsh)
+[![Mastodon Follow](https://img.shields.io/mastodon/follow/109370961877277568?domain=hostux.social&style=social)](https://hostux.social/@Tatsh)
+[![Patreon](https://img.shields.io/badge/Patreon-Tatsh2-F96854?logo=patreon)](https://www.patreon.com/Tatsh2)
+
+<!-- WISWA-GENERATED-README:STOP -->
+
+FordPass client and CLI. A third-party reverse-engineered client for the same private mobile-app
+endpoints the FordPass™ app uses, packaged as a Python library plus a `fordpass` command-line
+tool.
+
+## Disclaimer
+
+This project is **not** an official Ford product. It is **not** affiliated with, endorsed by,
+sponsored by, or otherwise connected to Ford Motor Company or any of its subsidiaries.
+"FordPass", "The Lincoln Way", "Ford", and "Lincoln" are trademarks of Ford Motor Company.
+
+Because this client speaks to private endpoints rather than a documented public API, Ford may
+change, throttle, or revoke access without notice - and the maintainer cannot guarantee that any
+particular feature will keep working.
+
+> **Use of this software may cause your FordPass™ / The Lincoln Way™ account to be (temporarily)
+> locked or suspended.** Traffic from any unofficial client can look anomalous to Ford's fraud
+> and abuse detection. **Use at your own risk.**
+
+It is **strongly recommended** to use a **separate, secondary FordPass™ account** for this
+software rather than your primary account:
+
+1. In the FordPass app on a phone (signed in as the primary owner), invite a secondary email
+   address as an additional driver for the vehicle. The invited address must be reachable from
+   that phone for verification.
+2. Sign up for a new FordPass account using that secondary email and accept the driver
+   invitation.
+3. Configure `pyfordpass` (`fordpass auth login`) with the secondary account's credentials.
+
+If the secondary account is later suspended, your primary account, warranty records, and
+roadside-assistance enrolment remain unaffected.
+
+See the [ha-fordpass project's general disclaimer and account-setup
+guidance](https://github.com/marq24/ha-fordpass#general-disclaimer) for the same procedure
+written up from the Home Assistant integration's perspective - the steps are identical
+regardless of which third-party client consumes the credentials.
+
+## Installation
+
+```shell
+pip install pyfordpass
+```
+
+## Usage
+
+Add `-d` to show debug logs. Run with no arguments to see the top-level command list:
+
+```shell
+fordpass
+```
+
+A typical first-time flow:
+
+```shell
+fordpass auth login       # Interactive sign-in against the secondary account.
+fordpass vehicle list     # See what's in the garage.
+fordpass vehicle show VIN # Detailed view for one vehicle.
+fordpass remote start VIN # Remote-start command.
+```
+
+Every subcommand supports `--help` and most data-returning subcommands support `--json` for
+machine-readable output.
+
+## Configuration
+
+`pyfordpass` has two sets of optional settings, each managed with its own subcommand rather than
+by editing files by hand. Both live under `~/.config/pyfordpass` on Linux (the platform-specific
+equivalent elsewhere).
+
+**User preferences** are managed with `fordpass config`. The most useful is a default VIN, so you
+need not pass it to every command:
+
+```shell
+# Set a default VIN, used whenever a command's VIN argument is omitted.
+fordpass config set vehicle.default_vin VIN
+# Distance ("mi"/"km") and temperature ("F"/"C"); both default from your locale.
+fordpass config set units.distance mi
+fordpass config set units.temperature C
+# Default output format: "pretty" (Rich tables) or "json".
+fordpass config set output.format json
+# Show the effective configuration (defaults included), drop a key, or start over.
+fordpass config dump
+fordpass config delete units.distance
+fordpass config reset
+```
+
+**API constants** are managed with `fordpass api-config`. The built-in defaults target Ford in the
+USA, so most users never need to touch them. When Ford rotates a host or client ID you can patch
+individual values without waiting for a new release; anything you set is merged over the defaults,
+so only the changed keys are required:
+
+```shell
+# Override a single value; everything else falls back to the built-in defaults.
+fordpass api-config set hosts.login https://login.ford.com
+# Show the effective constants (defaults merged with overrides), or discard all overrides.
+fordpass api-config dump
+fordpass api-config reset
+```
+
+Values for other regions and for Lincoln can be copied from
+[ha-fordpass `const.py`](https://github.com/marq24/ha-fordpass/blob/main/custom_components/fordpass/const.py).

pyfordpass-0.0.1/README.md

@@ -0,0 +1,132 @@
+# pyfordpass
+
+<!-- WISWA-GENERATED-README:START -->
+
+[![Python versions](https://img.shields.io/pypi/pyversions/pyfordpass.svg?color=blue&logo=python&logoColor=white)](https://www.python.org/)
+[![PyPI - Version](https://img.shields.io/pypi/v/pyfordpass)](https://pypi.org/project/pyfordpass/)
+[![GitHub tag (with filter)](https://img.shields.io/github/v/tag/Tatsh/pyfordpass)](https://github.com/Tatsh/pyfordpass/tags)
+[![License](https://img.shields.io/github/license/Tatsh/pyfordpass)](https://github.com/Tatsh/pyfordpass/blob/master/LICENSE.txt)
+[![GitHub commits since latest release (by SemVer including pre-releases)](https://img.shields.io/github/commits-since/Tatsh/pyfordpass/v0.0.1/master)](https://github.com/Tatsh/pyfordpass/compare/v0.0.1...master)
+[![CodeQL](https://github.com/Tatsh/pyfordpass/actions/workflows/codeql.yml/badge.svg)](https://github.com/Tatsh/pyfordpass/actions/workflows/codeql.yml)
+[![QA](https://github.com/Tatsh/pyfordpass/actions/workflows/qa.yml/badge.svg)](https://github.com/Tatsh/pyfordpass/actions/workflows/qa.yml)
+[![Tests](https://github.com/Tatsh/pyfordpass/actions/workflows/tests.yml/badge.svg)](https://github.com/Tatsh/pyfordpass/actions/workflows/tests.yml)
+[![Coverage Status](https://coveralls.io/repos/github/Tatsh/pyfordpass/badge.svg?branch=master)](https://coveralls.io/github/Tatsh/pyfordpass?branch=master)
+[![Dependabot](https://img.shields.io/badge/Dependabot-enabled-blue?logo=dependabot)](https://github.com/dependabot)
+[![Documentation Status](https://readthedocs.org/projects/pyfordpass/badge/?version=latest)](https://pyfordpass.readthedocs.org/?badge=latest)
+[![mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://mypy-lang.org/)
+[![uv](https://img.shields.io/badge/uv-261230?logo=astral)](https://docs.astral.sh/uv/)
+[![pytest](https://img.shields.io/badge/pytest-zz?logo=Pytest&labelColor=black&color=black)](https://docs.pytest.org/en/stable/)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Downloads](https://static.pepy.tech/badge/pyfordpass/month)](https://pepy.tech/project/pyfordpass)
+[![Stargazers](https://img.shields.io/github/stars/Tatsh/pyfordpass?logo=github&style=flat)](https://github.com/Tatsh/pyfordpass/stargazers)
+[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit)
+[![Prettier](https://img.shields.io/badge/Prettier-black?logo=prettier)](https://prettier.io/)
+
+[![@Tatsh](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fpublic.api.bsky.app%2Fxrpc%2Fapp.bsky.actor.getProfile%2F%3Factor=did%3Aplc%3Auq42idtvuccnmtl57nsucz72&query=%24.followersCount&label=Follow+%40Tatsh&logo=bluesky&style=social)](https://bsky.app/profile/Tatsh.bsky.social)
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Tatsh-black?logo=buymeacoffee)](https://buymeacoffee.com/Tatsh)
+[![Libera.Chat](https://img.shields.io/badge/Libera.Chat-Tatsh-black?logo=liberadotchat)](irc://irc.libera.chat/Tatsh)
+[![Mastodon Follow](https://img.shields.io/mastodon/follow/109370961877277568?domain=hostux.social&style=social)](https://hostux.social/@Tatsh)
+[![Patreon](https://img.shields.io/badge/Patreon-Tatsh2-F96854?logo=patreon)](https://www.patreon.com/Tatsh2)
+
+<!-- WISWA-GENERATED-README:STOP -->
+
+FordPass client and CLI. A third-party reverse-engineered client for the same private mobile-app
+endpoints the FordPass™ app uses, packaged as a Python library plus a `fordpass` command-line
+tool.
+
+## Disclaimer
+
+This project is **not** an official Ford product. It is **not** affiliated with, endorsed by,
+sponsored by, or otherwise connected to Ford Motor Company or any of its subsidiaries.
+"FordPass", "The Lincoln Way", "Ford", and "Lincoln" are trademarks of Ford Motor Company.
+
+Because this client speaks to private endpoints rather than a documented public API, Ford may
+change, throttle, or revoke access without notice - and the maintainer cannot guarantee that any
+particular feature will keep working.
+
+> **Use of this software may cause your FordPass™ / The Lincoln Way™ account to be (temporarily)
+> locked or suspended.** Traffic from any unofficial client can look anomalous to Ford's fraud
+> and abuse detection. **Use at your own risk.**
+
+It is **strongly recommended** to use a **separate, secondary FordPass™ account** for this
+software rather than your primary account:
+
+1. In the FordPass app on a phone (signed in as the primary owner), invite a secondary email
+   address as an additional driver for the vehicle. The invited address must be reachable from
+   that phone for verification.
+2. Sign up for a new FordPass account using that secondary email and accept the driver
+   invitation.
+3. Configure `pyfordpass` (`fordpass auth login`) with the secondary account's credentials.
+
+If the secondary account is later suspended, your primary account, warranty records, and
+roadside-assistance enrolment remain unaffected.
+
+See the [ha-fordpass project's general disclaimer and account-setup
+guidance](https://github.com/marq24/ha-fordpass#general-disclaimer) for the same procedure
+written up from the Home Assistant integration's perspective - the steps are identical
+regardless of which third-party client consumes the credentials.
+
+## Installation
+
+```shell
+pip install pyfordpass
+```
+
+## Usage
+
+Add `-d` to show debug logs. Run with no arguments to see the top-level command list:
+
+```shell
+fordpass
+```
+
+A typical first-time flow:
+
+```shell
+fordpass auth login       # Interactive sign-in against the secondary account.
+fordpass vehicle list     # See what's in the garage.
+fordpass vehicle show VIN # Detailed view for one vehicle.
+fordpass remote start VIN # Remote-start command.
+```
+
+Every subcommand supports `--help` and most data-returning subcommands support `--json` for
+machine-readable output.
+
+## Configuration
+
+`pyfordpass` has two sets of optional settings, each managed with its own subcommand rather than
+by editing files by hand. Both live under `~/.config/pyfordpass` on Linux (the platform-specific
+equivalent elsewhere).
+
+**User preferences** are managed with `fordpass config`. The most useful is a default VIN, so you
+need not pass it to every command:
+
+```shell
+# Set a default VIN, used whenever a command's VIN argument is omitted.
+fordpass config set vehicle.default_vin VIN
+# Distance ("mi"/"km") and temperature ("F"/"C"); both default from your locale.
+fordpass config set units.distance mi
+fordpass config set units.temperature C
+# Default output format: "pretty" (Rich tables) or "json".
+fordpass config set output.format json
+# Show the effective configuration (defaults included), drop a key, or start over.
+fordpass config dump
+fordpass config delete units.distance
+fordpass config reset
+```
+
+**API constants** are managed with `fordpass api-config`. The built-in defaults target Ford in the
+USA, so most users never need to touch them. When Ford rotates a host or client ID you can patch
+individual values without waiting for a new release; anything you set is merged over the defaults,
+so only the changed keys are required:
+
+```shell
+# Override a single value; everything else falls back to the built-in defaults.
+fordpass api-config set hosts.login https://login.ford.com
+# Show the effective constants (defaults merged with overrides), or discard all overrides.
+fordpass api-config dump
+fordpass api-config reset
+```
+
+Values for other regions and for Lincoln can be copied from
+[ha-fordpass `const.py`](https://github.com/marq24/ha-fordpass/blob/main/custom_components/fordpass/const.py).

pyfordpass-0.0.1/fordpass/__init__.py

@@ -0,0 +1,17 @@
+"""
+FordPass client.
+
+Public surface:
+
+- :class:`fordpass.sansio.FordPassClient` - sans-I/O protocol core that builds
+  :class:`fordpass.sansio.RequestDict` descriptors.
+- :class:`fordpass.client.AsyncFordPassClient` - fully-async niquests wrapper.
+- ``fordpass`` command-line tool exposed via :mod:`fordpass.commands`.
+"""
+from __future__ import annotations
+
+from .client import AsyncFordPassClient
+from .sansio import FordPassClient, RequestDict
+
+__all__ = ('AsyncFordPassClient', 'FordPassClient', 'RequestDict')
+__version__ = '0.0.1'

pyfordpass-0.0.1/fordpass/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for ``python -m fordpass`` invocation."""
+from __future__ import annotations
+
+from fordpass.main import main
+
+main()

pyfordpass-0.0.1/fordpass/api_config.py

@@ -0,0 +1,105 @@
+"""Loader for FordPass API constants."""
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import TYPE_CHECKING, Any, cast
+import copy
+import functools
+
+from fordpass.config import CONFIG_DIR
+import tomlkit
+
+if TYPE_CHECKING:
+    from .typing.api_config import APIConfig
+
+__all__ = ('API_CONFIG_FILE', 'DEFAULT_API_CONFIG', 'load_api_config')
+
+API_CONFIG_FILE = CONFIG_DIR / 'api.toml'
+"""
+Path to the optional constants-override TOML file.
+
+When present, its contents are merged over :data:`DEFAULT_API_CONFIG`, letting a user patch
+individual values (for example a rotated host or client ID) without waiting for a new release.
+
+:meta hide-value:
+"""
+
+DEFAULT_API_CONFIG: APIConfig = {
+    'application_id': 'BFE8C5ED-D687-4C19-A5DD-F92CDFC4503A',
+    'user_agent': 'okhttp/4.12.0',
+    'profile_groups_default': ('names,address,phoneNumbers,emails,country,languages,'
+                               'unitsOfMeasure,namesExtensions'),
+    'hosts': {
+        'foundational': 'https://api.foundational.ford.com',
+        'login': 'https://login.ford.com',
+        'tmc': 'https://api.autonomic.ai',
+        'tmc_accounts': 'https://accounts.autonomic.ai',
+        'vehicle': 'https://api.vehicle.ford.com'
+    },
+    'auth': {
+        'b2c': {
+            'client_id': '09852200-05fd-41f6-8c21-d36d3497dc64',
+            'policy_template': 'B2C_1A_SignInSignUp_{locale}',
+            'redirect_uri': 'fordapp://userauthorized',
+            'tenant_id': '4566605f-43a7-400a-946e-89cc9fdb0bd7'
+        },
+        'tmc': {
+            'client_id': 'fordpass-prod'
+        }
+    },
+    'roadside': {
+        'x_source': {
+            'ford': 'FORD',
+            'lincoln': 'LINCOLN'
+        }
+    }
+}
+"""
+Built-in FordPass API constants captured from the official mobile app.
+
+These serve as the default bundle when :data:`API_CONFIG_FILE` is absent.
+
+:meta hide-value:
+"""
+
+
+def _merge_into(base: dict[str, Any], override: Mapping[str, Any]) -> None:
+    """
+    Recursively overlay ``override`` onto ``base`` in place.
+
+    Nested mappings are merged key by key; any other value (scalar, list, ...) replaces the value in
+    ``base`` wholesale.
+
+    Parameters
+    ----------
+    base : dict[str, Any]
+        The mapping to mutate. Typically a deep copy of :data:`DEFAULT_API_CONFIG`.
+    override : Mapping[str, Any]
+        The values to layer on top, such as a parsed override file.
+    """
+    for key, value in override.items():
+        existing = base.get(key)
+        if isinstance(existing, dict) and isinstance(value, Mapping):
+            _merge_into(existing, value)
+        else:
+            base[key] = value
+
+
+@functools.cache
+def load_api_config() -> APIConfig:
+    """
+    Return the FordPass API constants, merging any override file over the defaults.
+
+    The result starts from a copy of :data:`DEFAULT_API_CONFIG`. When :data:`API_CONFIG_FILE`
+    exists, its parsed contents are deep-merged on top, so an override may patch as few or as many
+    values as it likes.
+
+    Returns
+    -------
+    APIConfig
+        The effective constants bundle.
+    """
+    merged = cast('dict[str, Any]', copy.deepcopy(DEFAULT_API_CONFIG))
+    if API_CONFIG_FILE.exists():
+        _merge_into(merged, tomlkit.loads(API_CONFIG_FILE.read_text()).unwrap())
+    return cast('APIConfig', merged)