aiolibdatachannel 2026.4.21__tar.gz

aiolibdatachannel-2026.4.21/.github/workflows/ci.yml

@@ -0,0 +1,76 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint + typecheck
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install system deps
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y ninja-build libssl-dev
+      - name: Install package
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+      - name: ruff
+        run: |
+          ruff check aiolibdatachannel tests
+          ruff format --check aiolibdatachannel tests
+      - name: mypy
+        run: mypy aiolibdatachannel
+
+  test:
+    name: Test (${{ matrix.os }}, Python ${{ matrix.python }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        # Windows isn't covered — bundling OpenSSL DLLs + DLL search-path
+        # setup for editable installs is a separate investment and we
+        # don't currently publish Windows wheels either.
+        os: [ubuntu-latest, macos-latest]
+        python: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+
+      - name: Install system deps (Ubuntu)
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y ninja-build libssl-dev
+
+      - name: Install system deps (macOS)
+        if: runner.os == 'macOS'
+        run: brew install ninja openssl@3
+
+      - name: Install package
+        shell: bash
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest -v

aiolibdatachannel-2026.4.21/.github/workflows/release.yml

@@ -0,0 +1,128 @@
+name: Release
+
+on:
+  # Fires on any git tag push — we use CalVer (e.g. 2026.4.21), but this
+  # also covers plain v* tags or anything else someone pushes. The
+  # setuptools-scm integration in pyproject.toml reads whatever tag you
+  # pushed and bakes it into the built wheel.
+  push:
+    tags: ["*"]
+  workflow_dispatch:
+
+jobs:
+  build_sdist:
+    name: Build source distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+          # setuptools-scm needs the full git history to resolve the
+          # current tag into a version string.
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build sdist
+        # Forwarding the tag name as SETUPTOOLS_SCM_PRETEND_VERSION means
+        # `python -m build` doesn't have to shell out to git to discover
+        # the version. Leaving it unset lets setuptools-scm fall back to
+        # the dev-stamped version on workflow_dispatch runs.
+        env:
+          SETUPTOOLS_SCM_PRETEND_VERSION: ${{ github.ref_type == 'tag' && github.ref_name || '' }}
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build --sdist
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+
+  build_wheels:
+    name: Build wheels on ${{ matrix.os }} (${{ matrix.arch }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          # Linux amd64 + arm64.
+          - os: ubuntu-latest
+            arch: x86_64
+          - os: ubuntu-24.04-arm
+            arch: aarch64
+          # macOS arm64 only. Intel Mac (x86_64) is skipped — modern
+          # Macs are all Apple Silicon. The deployment target is 14.0
+          # because that's the minimum macOS the Homebrew openssl@3
+          # bottle ships with; delocate refuses to downgrade it.
+          - os: macos-14
+            arch: arm64
+          # Windows support is deferred — the bundled libdatachannel
+          # dynamically links OpenSSL's DLLs and we haven't wired up the
+          # delvewheel / os.add_dll_directory dance needed to make that
+          # work on end-user machines.
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+          # setuptools-scm needs the full git history to resolve the
+          # current tag into a version string.
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - uses: pypa/cibuildwheel@v2.21
+        env:
+          # cibuildwheel tars the project and runs pip inside a manylinux
+          # container — git history isn't available there, so we forward
+          # the tag name directly and ask setuptools-scm to use it.
+          SETUPTOOLS_SCM_PRETEND_VERSION: ${{ github.ref_type == 'tag' && github.ref_name || '' }}
+          CIBW_ENVIRONMENT_PASS_LINUX: "SETUPTOOLS_SCM_PRETEND_VERSION"
+          CIBW_ARCHS: ${{ matrix.arch }}
+          # Our wheel is Python-version-independent (py3-none-<platform>)
+          # because cffi dispatches to the bundled shared library at
+          # runtime. requires-python = ">=3.12" in pyproject.toml gates
+          # installation to 3.12+. cibuildwheel still needs a concrete
+          # Python to drive the build, so we pick 3.12 and emit one wheel
+          # per (os, arch).
+          CIBW_BUILD: "cp312-*"
+          CIBW_SKIP: "*-musllinux_*"
+          CIBW_MANYLINUX_X86_64_IMAGE: manylinux_2_28
+          CIBW_MANYLINUX_AARCH64_IMAGE: manylinux_2_28
+          CIBW_BEFORE_ALL_LINUX: "yum install -y openssl-devel"
+          CIBW_BEFORE_ALL_MACOS: "brew install openssl@3"
+          CIBW_ENVIRONMENT_MACOS: >-
+            OPENSSL_ROOT_DIR=$(brew --prefix openssl@3)
+            MACOSX_DEPLOYMENT_TARGET=14.0
+          CIBW_TEST_REQUIRES: "pytest pytest-asyncio"
+          CIBW_TEST_COMMAND: "pytest {project}/tests -q"
+          # Skip tests on macOS runners — loopback UDP perms aren't
+          # reliable on hosted macOS. Linux wheel tests run the full suite.
+          CIBW_TEST_SKIP: "*-macosx_*"
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}-${{ matrix.arch }}
+          path: wheelhouse/*.whl
+
+  publish:
+    name: Publish to PyPI
+    needs: [build_sdist, build_wheels]
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
+    environment:
+      name: pypi
+      url: https://pypi.org/p/aiolibdatachannel
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: dist
+          merge-multiple: true
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

aiolibdatachannel-2026.4.21/.gitignore

@@ -0,0 +1,43 @@
+# Build / Python
+build/
+dist/
+*.egg-info/
+__pycache__/
+*.pyc
+*.pyo
+.venv/
+venv/
+.tox/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+
+# Native build artefacts
+*.so
+*.dylib
+*.pyd
+*.o
+*.a
+CMakeCache.txt
+CMakeFiles/
+cmake_install.cmake
+compile_commands.json
+
+# Editors
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Wheels
+wheelhouse/
+
+# Claude Code state
+.claude/
+
+# setuptools-scm writes the resolved version here at build time.
+aiolibdatachannel/_version.py

aiolibdatachannel-2026.4.21/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "vendor/libdatachannel"]
+	path = vendor/libdatachannel
+	url = https://github.com/paullouisageneau/libdatachannel.git

aiolibdatachannel-2026.4.21/CMakeLists.txt

@@ -0,0 +1,45 @@
+cmake_minimum_required(VERSION 3.24)
+project(aiolibdatachannel LANGUAGES C CXX)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+set(CMAKE_POSITION_INDEPENDENT_CODE ON)
+
+# --- libdatachannel configuration -------------------------------------------
+# Build libdatachannel as a shared library that cffi loads at runtime.
+# Dependencies (usrsctp, libjuice, openssl) link statically into it so the
+# wheel ships a single self-contained `.so` / `.dylib` / `.dll`.
+set(BUILD_SHARED_LIBS ON CACHE BOOL "" FORCE)
+set(NO_EXAMPLES ON CACHE BOOL "" FORCE)
+set(NO_TESTS ON CACHE BOOL "" FORCE)
+set(NO_WEBSOCKET ON CACHE BOOL "" FORCE)
+set(NO_MEDIA ON CACHE BOOL "" FORCE)
+set(PREFER_SYSTEM_LIB OFF CACHE BOOL "" FORCE)
+set(USE_NICE OFF CACHE BOOL "" FORCE)
+
+# Default TLS backend: OpenSSL. Override with -DUSE_MBEDTLS=ON or -DUSE_GNUTLS=ON.
+if(NOT DEFINED USE_MBEDTLS AND NOT DEFINED USE_GNUTLS)
+    set(USE_MBEDTLS OFF CACHE BOOL "" FORCE)
+    set(USE_GNUTLS OFF CACHE BOOL "" FORCE)
+endif()
+
+add_subdirectory(vendor/libdatachannel)
+
+# --- Ship the shared library inside the Python package ----------------------
+# The LibDataChannel shared target already encodes the correct versioned
+# soname. scikit-build-core will place the installed files under the package
+# directory in the built wheel.
+install(TARGETS datachannel
+    LIBRARY DESTINATION aiolibdatachannel/_lib
+    RUNTIME DESTINATION aiolibdatachannel/_lib)
+
+# Set rpath so the shared lib can find its transitive deps (none in our
+# static-deps layout, but future-proofing in case we ever flip one to shared).
+if(APPLE)
+    set_target_properties(datachannel PROPERTIES
+        INSTALL_RPATH "@loader_path")
+elseif(UNIX)
+    set_target_properties(datachannel PROPERTIES
+        INSTALL_RPATH "$ORIGIN")
+endif()

aiolibdatachannel-2026.4.21/LICENSE

@@ -0,0 +1,97 @@
+Mozilla Public License Version 2.0
+==================================
+
+1. Definitions
+--------------
+
+1.1. "Contributor"
+    means each individual or legal entity that creates, contributes to
+    the creation of, or owns Covered Software.
+
+1.2. "Contributor Version"
+    means the combination of the Contributions of others (if any) used
+    by a Contributor and that particular Contributor's Contribution.
+
+1.3. "Contribution"
+    means Covered Software of a particular Contributor.
+
+1.4. "Covered Software"
+    means Source Code Form to which the initial Contributor has attached
+    the notice in Exhibit A, the Executable Form of such Source Code
+    Form, and Modifications of such Source Code Form, in each case
+    including portions thereof.
+
+1.5. "Incompatible With Secondary Licenses"
+    means
+
+    (a) that the initial Contributor has attached the notice described
+        in Exhibit B to the Covered Software; or
+
+    (b) that the Covered Software was made available under the terms of
+        version 1.1 or earlier of the License, but not also under the
+        terms of a Secondary License.
+
+1.6. "Executable Form"
+    means any form of the work other than Source Code Form.
+
+1.7. "Larger Work"
+    means a work that combines Covered Software with other material, in
+    a separate file or files, that is not Covered Software.
+
+1.8. "License"
+    means this document.
+
+1.9. "Licensable"
+    means having the right to grant, to the maximum extent possible,
+    whether at the time of the initial grant or subsequently, any and
+    all of the rights conveyed by this License.
+
+1.10. "Modifications"
+    means any of the following:
+
+    (a) any file in Source Code Form that results from an addition to,
+        deletion from, or modification of the contents of Covered
+        Software; or
+
+    (b) any new file in Source Code Form that contains any Covered
+        Software.
+
+1.11. "Patent Claims" of a Contributor
+    means any patent claim(s), including without limitation, method,
+    process, and apparatus claims, in any patent Licensable by such
+    Contributor that would be infringed, but for the grant of the
+    License, by the making, using, selling, offering for sale, having
+    made, import, or transfer of either its Contributions or its
+    Contributor Version.
+
+1.12. "Secondary License"
+    means either the GNU General Public License, Version 2.0, the GNU
+    Lesser General Public License, Version 2.1, the GNU Affero General
+    Public License, Version 3.0, or any later versions of those
+    licenses.
+
+1.13. "Source Code Form"
+    means the form of the work preferred for making modifications.
+
+1.14. "You" (or "Your")
+    means an individual or a legal entity exercising rights under this
+    License. For legal entities, "You" includes any entity that
+    controls, is controlled by, or is under common control with You. For
+    purposes of this definition, "control" means (a) the power, direct
+    or indirect, to cause the direction or management of such entity,
+    whether by contract or otherwise, or (b) ownership of more than
+    fifty percent (50%) of the outstanding shares or beneficial
+    ownership of such entity.
+
+The full text of the Mozilla Public License 2.0 is available at:
+https://mozilla.org/MPL/2.0/
+
+This package bundles libdatachannel (also MPL-2.0) as a statically linked
+dependency. See vendor/libdatachannel/LICENSE for its full license text.
+
+Exhibit A - Source Code Form License Notice
+-------------------------------------------
+
+  This Source Code Form is subject to the terms of the Mozilla Public
+  License, v. 2.0. If a copy of the MPL was not distributed with this
+  file, You can obtain one at https://mozilla.org/MPL/2.0/.

aiolibdatachannel-2026.4.21/MANIFEST.in

@@ -0,0 +1,18 @@
+graft aiolibdatachannel
+graft vendor/libdatachannel/cmake
+graft vendor/libdatachannel/include
+graft vendor/libdatachannel/src
+graft vendor/libdatachannel/deps
+include vendor/libdatachannel/CMakeLists.txt
+include vendor/libdatachannel/LICENSE
+include CMakeLists.txt
+include LICENSE
+include README.md
+include pyproject.toml
+prune vendor/libdatachannel/.git
+prune vendor/libdatachannel/.github
+prune vendor/libdatachannel/examples
+prune vendor/libdatachannel/test
+prune vendor/libdatachannel/pages
+global-exclude __pycache__
+global-exclude *.py[cod]

aiolibdatachannel-2026.4.21/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 2.1
+Name: aiolibdatachannel
+Version: 2026.4.21
+Summary: asyncio-friendly Python wrapper for libdatachannel (WebRTC Data Channels)
+Keywords: webrtc,datachannel,libdatachannel,asyncio,p2p
+Author-Email: Pascal Vizeli <pascal.vizeli@nabucasa.com>
+License: MPL-2.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications
+Classifier: Topic :: Internet
+Classifier: Typing :: Typed
+Project-URL: Homepage, https://github.com/social-home-io/aiolibdatachannel
+Project-URL: Issues, https://github.com/social-home-io/aiolibdatachannel/issues
+Project-URL: libdatachannel, https://github.com/paullouisageneau/libdatachannel
+Requires-Python: >=3.12
+Requires-Dist: cffi>=1.16
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Description-Content-Type: text/markdown
+
+# aiolibdatachannel
+
+An `asyncio`-friendly Python wrapper around
+[libdatachannel](https://github.com/paullouisageneau/libdatachannel) — a
+lightweight C/C++ WebRTC stack. `aiolibdatachannel` exposes WebRTC
+**Peer Connections** and **Data Channels** through idiomatic `async/await`
+Python.
+
+> **Scope (v0.1):** PeerConnection + DataChannel only. WebSocket and
+> Media/RTP transport are deliberately disabled in this build to keep the
+> wheel small. See the "Roadmap" section below.
+
+## Install
+
+```bash
+pip install aiolibdatachannel
+```
+
+Wheels are published for Linux (`manylinux_2_28` x86_64 / aarch64) and
+macOS (arm64, 14.0+). Intel Macs and Windows aren't currently covered —
+Intel Mac because Apple Silicon is the modern target, Windows because
+libdatachannel dynamically links OpenSSL and the wheel packaging for
+that on Windows is still open. libdatachannel is bundled as a shared library inside the
+wheel and loaded via [`cffi`](https://cffi.readthedocs.io/) — no native
+Python extension, no per-Python-version build, one
+`py3-none-<platform>` wheel covers every supported interpreter.
+
+## Quickstart
+
+```python
+import asyncio
+from aiolibdatachannel import PeerConnection, RTCConfiguration
+
+async def main() -> None:
+    config = RTCConfiguration(ice_servers=["stun:stun.l.google.com:19302"])
+
+    async with PeerConnection(config) as pc:
+        dc = await pc.create_data_channel("chat")
+
+        offer = await pc.create_offer()
+        # ... ship `offer` to the peer via your signalling channel ...
+        answer_sdp = await receive_answer_from_peer()
+        await pc.set_remote_description(answer_sdp, "answer")
+
+        await dc.wait_open()
+        await dc.send(b"hello")
+
+        async for message in dc:
+            print("got", message)
+
+asyncio.run(main())
+```
+
+See `examples/offerer.py` and `examples/answerer.py` for a runnable pair of
+scripts that negotiate over stdin/stdout.
+
+## Development
+
+```bash
+git clone --recursive https://github.com/social-home-io/aiolibdatachannel.git
+cd aiolibdatachannel
+pip install -e .[dev]
+pytest
+```
+
+See [docs/BUILDING.md](docs/BUILDING.md) for detailed build instructions,
+including how to switch TLS backends and how to bump the bundled
+libdatachannel version.
+
+## Roadmap
+
+- [ ] WebSocket client + server support (`NO_WEBSOCKET=OFF`)
+- [ ] Media / RTP tracks (`NO_MEDIA=OFF`)
+- [ ] First-class `logging` integration with `rtcInitLogger`
+- [ ] Trio / AnyIO variant
+
+## License
+
+This project is licensed under the Mozilla Public License 2.0, matching
+the license of libdatachannel which it bundles and statically links.
+See [LICENSE](LICENSE) and [vendor/libdatachannel/LICENSE](vendor/libdatachannel/LICENSE).

aiolibdatachannel-2026.4.21/README.md

@@ -0,0 +1,81 @@
+# aiolibdatachannel
+
+An `asyncio`-friendly Python wrapper around
+[libdatachannel](https://github.com/paullouisageneau/libdatachannel) — a
+lightweight C/C++ WebRTC stack. `aiolibdatachannel` exposes WebRTC
+**Peer Connections** and **Data Channels** through idiomatic `async/await`
+Python.
+
+> **Scope (v0.1):** PeerConnection + DataChannel only. WebSocket and
+> Media/RTP transport are deliberately disabled in this build to keep the
+> wheel small. See the "Roadmap" section below.
+
+## Install
+
+```bash
+pip install aiolibdatachannel
+```
+
+Wheels are published for Linux (`manylinux_2_28` x86_64 / aarch64) and
+macOS (arm64, 14.0+). Intel Macs and Windows aren't currently covered —
+Intel Mac because Apple Silicon is the modern target, Windows because
+libdatachannel dynamically links OpenSSL and the wheel packaging for
+that on Windows is still open. libdatachannel is bundled as a shared library inside the
+wheel and loaded via [`cffi`](https://cffi.readthedocs.io/) — no native
+Python extension, no per-Python-version build, one
+`py3-none-<platform>` wheel covers every supported interpreter.
+
+## Quickstart
+
+```python
+import asyncio
+from aiolibdatachannel import PeerConnection, RTCConfiguration
+
+async def main() -> None:
+    config = RTCConfiguration(ice_servers=["stun:stun.l.google.com:19302"])
+
+    async with PeerConnection(config) as pc:
+        dc = await pc.create_data_channel("chat")
+
+        offer = await pc.create_offer()
+        # ... ship `offer` to the peer via your signalling channel ...
+        answer_sdp = await receive_answer_from_peer()
+        await pc.set_remote_description(answer_sdp, "answer")
+
+        await dc.wait_open()
+        await dc.send(b"hello")
+
+        async for message in dc:
+            print("got", message)
+
+asyncio.run(main())
+```
+
+See `examples/offerer.py` and `examples/answerer.py` for a runnable pair of
+scripts that negotiate over stdin/stdout.
+
+## Development
+
+```bash
+git clone --recursive https://github.com/social-home-io/aiolibdatachannel.git
+cd aiolibdatachannel
+pip install -e .[dev]
+pytest
+```
+
+See [docs/BUILDING.md](docs/BUILDING.md) for detailed build instructions,
+including how to switch TLS backends and how to bump the bundled
+libdatachannel version.
+
+## Roadmap
+
+- [ ] WebSocket client + server support (`NO_WEBSOCKET=OFF`)
+- [ ] Media / RTP tracks (`NO_MEDIA=OFF`)
+- [ ] First-class `logging` integration with `rtcInitLogger`
+- [ ] Trio / AnyIO variant
+
+## License
+
+This project is licensed under the Mozilla Public License 2.0, matching
+the license of libdatachannel which it bundles and statically links.
+See [LICENSE](LICENSE) and [vendor/libdatachannel/LICENSE](vendor/libdatachannel/LICENSE).

aiolibdatachannel-2026.4.21/aiolibdatachannel/__init__.py

@@ -0,0 +1,73 @@
+"""asyncio-friendly Python wrapper for libdatachannel.
+
+See :class:`PeerConnection` for the primary entry point.
+"""
+
+from __future__ import annotations
+
+from importlib.metadata import PackageNotFoundError, version
+
+from . import _core
+from .config import DataChannelOptions, RTCConfiguration
+from .data_channel import DataChannel
+from .enums import (
+    CertificateType,
+    GatheringState,
+    ICEState,
+    LogLevel,
+    RTCState,
+    SignalingState,
+    TransportPolicy,
+)
+from .exceptions import ConnectionClosedError, RTCError
+from .peer_connection import IceCandidate, LocalDescription, PeerConnection
+
+try:
+    __version__ = version("aiolibdatachannel")
+except PackageNotFoundError:  # pragma: no cover - running from a source tree
+    __version__ = "0.0.0+unknown"
+
+__all__ = [
+    "CertificateType",
+    "ConnectionClosedError",
+    "DataChannel",
+    "DataChannelOptions",
+    "GatheringState",
+    "ICEState",
+    "IceCandidate",
+    "LocalDescription",
+    "LogLevel",
+    "PeerConnection",
+    "RTCConfiguration",
+    "RTCError",
+    "RTCState",
+    "SignalingState",
+    "TransportPolicy",
+    "__version__",
+    "init_logger",
+    "preload",
+    "set_thread_pool_size",
+]
+
+
+def init_logger(level: LogLevel | int = LogLevel.WARNING, callback=None) -> None:  # type: ignore[no-untyped-def]
+    """Initialise libdatachannel's logger.
+
+    If ``callback`` is provided it is invoked with ``(level, message)`` for
+    every log line; otherwise libdatachannel logs to stdout at the chosen
+    level.
+    """
+
+    _core.init_logger(int(level), callback)
+
+
+def preload() -> None:
+    """Eagerly initialise libdatachannel's global state (optional)."""
+
+    _core.preload()
+
+
+def set_thread_pool_size(count: int) -> None:
+    """Set libdatachannel's internal thread-pool size (applied to new threads)."""
+
+    _core.set_thread_pool_size(count)