wrtc 0.0.0.dev8__tar.gz → 0.0.1__tar.gz

wrtc-0.0.1/.clang-format

@@ -0,0 +1,23 @@
+---
+BasedOnStyle: LLVM
+Standard: c++20
+ColumnLimit: 120
+IndentWidth: 2
+ContinuationIndentWidth: 4
+NamespaceIndentation: All
+AccessModifierOffset: -2
+PointerAlignment: Right
+QualifierAlignment: Left
+ReferenceAlignment: Right
+AllowShortFunctionsOnASingleLine: Inline
+AllowShortLambdasOnASingleLine: All
+AllowShortIfStatementsOnASingleLine: Never
+AllowShortLoopsOnASingleLine: false
+AlwaysBreakTemplateDeclarations: Yes
+BreakBeforeBraces: Attach
+InsertBraces: true
+IncludeBlocks: Preserve
+SortIncludes: CaseSensitive
+FixNamespaceComments: true
+SpaceAfterTemplateKeyword: true
+...

wrtc-0.0.1/.clang-tidy

@@ -0,0 +1,48 @@
+---
+# Every disabled check has a reason; everything else is fixed, or NOLINT(check) with a reason where it can't be.
+Checks: >
+  -*,
+  bugprone-*,
+  cert-*,
+  clang-analyzer-*,
+  concurrency-*,
+  cppcoreguidelines-*,
+  misc-*,
+  modernize-*,
+  performance-*,
+  portability-*,
+  readability-*,
+  -modernize-use-trailing-return-type,
+  -misc-include-cleaner,
+  -misc-multiple-inheritance,
+  -cppcoreguidelines-owning-memory,
+  -cppcoreguidelines-pro-bounds-pointer-arithmetic,
+  -cppcoreguidelines-pro-bounds-constant-array-index,
+  -cppcoreguidelines-pro-bounds-avoid-unchecked-container-access,
+  -cppcoreguidelines-pro-type-static-cast-downcast
+
+# modernize-use-trailing-return-type: libwebrtc and pybind11 APIs, which we override and mirror, use leading returns
+# misc-include-cleaner: pybind11 and libwebrtc are used through umbrella headers the check maps to internal ones
+# misc-multiple-inheritance: libwebrtc observer interfaces (not pure virtual) are implemented next to our bases
+# cppcoreguidelines-owning-memory: libwebrtc takes raw `new` into its refcounting, and there's no GSL owner<>
+# cppcoreguidelines-pro-bounds-*: libwebrtc frames and audio are raw planes with strides, indexed per sample
+# cppcoreguidelines-pro-type-static-cast-downcast: libwebrtc has no RTTI, tracks are downcast by kind() as it does
+
+WarningsAsErrors: '*'
+HeaderFilterRegex: '.*/python-webrtc/cpp/src/.*'
+FormatStyle: file
+
+CheckOptions:
+  # running out of memory terminates anyway, and so does calling an empty std::function, a bug
+  bugprone-exception-escape.IgnoredExceptions: 'bad_alloc,bad_array_new_length,length_error,bad_function_call'
+  # pybind11 dataclass-like models (def_readwrite) are plain structs
+  misc-non-private-member-variables-in-classes.IgnoreClassesWithAllMemberVariablesBeingPublic: true
+  # `m` for the pybind11 module, `pc` for a peer connection, coordinates and iterators
+  readability-identifier-length.IgnoredVariableNames: '^(m|pc|id|it|x|y|u|v|uv|i|j)$'
+  readability-identifier-length.IgnoredParameterNames: '^(m|pc|id|it|x|y|u|v|uv|i|j)$'
+  readability-identifier-length.IgnoredLoopCounterNames: '^[ijkxy_]$'
+  # a width and a height, in the order everything takes them
+  bugprone-easily-swappable-parameters.IgnoredParameterNames: '"";iterator;Iterator;begin;Begin;end;End;first;First;last;Last;lhs;LHS;rhs;RHS;width;height'
+  cppcoreguidelines-special-member-functions.AllowSoleDefaultDtor: true
+  cppcoreguidelines-special-member-functions.AllowMissingMoveFunctionsWhenCopyIsDeleted: true
+...

wrtc-0.0.1/.gitignore

@@ -0,0 +1,31 @@
+.idea/
+.vscode/
+.DS_Store
+
+# build artifacts
+build/
+dist/
+wheelhouse/
+cmake-build-*/
+*.so
+*.pyd
+
+# python
+.venv/
+__pycache__/
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+
+*.env
+*.log
+
+docs/build
+
+# local reference checkouts and experiments
+/wpt/
+
+# fuzzing (tests/fuzz): crashes and the corpora libFuzzer grows
+/tests/fuzz/crashes/
+/tests/fuzz/corpus/

wrtc-0.0.1/.mailmap

@@ -0,0 +1,2 @@
+Ilya (Marshal) <ilya@marshal.dev>
+Ilya (Marshal) <ilya@marshal.dev> <ilya@marshal.by>

wrtc-0.0.1/.readthedocs.yaml

@@ -0,0 +1,23 @@
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+version: 2
+
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.13"
+  jobs:
+    pre_create_environment:
+      - asdf plugin add uv
+      - asdf install uv latest
+      - asdf global uv latest
+    create_environment:
+      - uv venv "${READTHEDOCS_VIRTUALENV_PATH}"
+    # the native module is mocked: the docs need no build of libwebrtc
+    install:
+      - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv sync --frozen --only-group docs
+
+sphinx:
+  configuration: docs/source/conf.py
+  builder: dirhtml

wrtc-0.0.1/CHANGES.md

@@ -0,0 +1,151 @@
+# Change Log
+
+## Version 0.0.1
+
+**12.10.2026**
+
+**🔌 The whole WebRTC API is bound. Every interface, every method, every dictionary: all 154 binding issues of the [tracker](https://github.com/users/MarshalX/projects/1/views/1) are done, and the API goes beyond them**
+
+**🎞 Media processing that not every browser ships yet: `MediaStreamTrackProcessor`, `VideoTrackGenerator` and `MediaStreamTrackGenerator`, with the `VideoFrame` and `AudioData` of WebCodecs**
+
+**🔐 WebRTC Encoded Transform: the encoded frames of senders and receivers in Python with `RTCRtpScriptTransform`, and end-to-end encryption with SFrame**
+
+**🎥 H.264 without bundling it: VideoToolbox on macOS, offered by default, and Cisco's OpenH264 binary on request elsewhere**
+
+**🚀 Field trials and WARP: DTLS 1.3, SNAP and SPED cut round trips off connection setup**
+
+**⚡ libwebrtc M152, pre-built wheels for Linux (x86_64 and aarch64), macOS and Windows, CPython 3.9 – 3.15, free-threaded 3.14t and 3.15t too**
+
+**🧪 The public API follows the WebIDL of the specifications and runs the original web-platform-tests**
+
+**📚 Fully reworked [docs website](https://wrtc.marshal.dev): a new theme, guides, examples and the full API reference**
+
+What is bound, by specification:
+
+* [WebRTC](https://w3c.github.io/webrtc-pc/): `RTCPeerConnection`, `RTCDataChannel`, `RTCRtpTransceiver`, `RTCRtpSender`, `RTCRtpReceiver`, `RTCDtlsTransport`, `RTCIceTransport`, `RTCSctpTransport`, `RTCDTMFSender`, `RTCCertificate`, `RTCIceCandidate`, `RTCSessionDescription`, with every method, attribute, event and dictionary
+* [WebRTC Extensions](https://w3c.github.io/webrtc-extensions/): standalone `RTCIceTransport`, RTP header encryption, and more
+* [WebRTC Statistics](https://w3c.github.io/webrtc-stats/): 19 typed stats objects in `RTCStatsReport`
+* [WebRTC Encoded Transform](https://w3c.github.io/webrtc-encoded-transform/): `RTCRtpScriptTransform`, `RTCEncodedVideoFrame`, `RTCEncodedAudioFrame`, and SFrame (RFC 9605)
+* [Media Capture and Streams](https://w3c.github.io/mediacapture-main/): `MediaStream`, `MediaStreamTrack` with constraints, settings and capabilities, and `MediaDevices` with a synthetic camera and microphone
+* [MediaStreamTrack Insertable Media Processing](https://w3c.github.io/mediacapture-transform/): `MediaStreamTrackProcessor`, `VideoTrackGenerator`, and `MediaStreamTrackGenerator`
+* [WebCodecs](https://w3c.github.io/webcodecs/): `VideoFrame` and `AudioData`
+* [Streams](https://streams.spec.whatwg.org/): `ReadableStream`, `WritableStream` and `TransformStream`, with piping and async iteration
+
+In numbers: 229 public classes, 50 enums with the string values of the specifications, 18 exceptions named after their `DOMException`, and the camelCase names of the specifications next to the snake_case ones.
+
+* Migrate to prebuilt libwebrtc M152, scikit-build-core and single cibuildwheel CI by [@MarshalX](https://github.com/MarshalX) in [#191](https://github.com/MarshalX/python-webrtc/pull/191)
+* Split wheel builds per Python version and cache libwebrtc by [@MarshalX](https://github.com/MarshalX) in [#196](https://github.com/MarshalX/python-webrtc/pull/196)
+* Add Linux aarch64 wheels by [@MarshalX](https://github.com/MarshalX) in [#207](https://github.com/MarshalX/python-webrtc/pull/207)
+* Support free-threaded Python with `cp314t` and `cp315t` wheels, add CPython 3.15 by [@MarshalX](https://github.com/MarshalX) in [#232](https://github.com/MarshalX/python-webrtc/pull/232)
+* Implement WebRTC spec APIs and event ordering for WPT by [@MarshalX](https://github.com/MarshalX) in [#195](https://github.com/MarshalX/python-webrtc/pull/195)
+* Add MediaStreamTrackProcessor, track generators and WebCodecs frames by [@MarshalX](https://github.com/MarshalX) in [#197](https://github.com/MarshalX/python-webrtc/pull/197)
+* Align WebIDL dictionaries with the spec as typed models by [@MarshalX](https://github.com/MarshalX) in [#212](https://github.com/MarshalX/python-webrtc/pull/212)
+* Align the public API with the WPT WebIDL by [@MarshalX](https://github.com/MarshalX) in [#214](https://github.com/MarshalX/python-webrtc/pull/214)
+* Type event handlers per event, add listener management methods by [@MarshalX](https://github.com/MarshalX) in [#215](https://github.com/MarshalX/python-webrtc/pull/215)
+* Add H.264 through Cisco's OpenH264 binary, downloaded on request by [@MarshalX](https://github.com/MarshalX) in [#218](https://github.com/MarshalX/python-webrtc/pull/218)
+* Add H.264 on macOS through VideoToolbox, offered by default by [@MarshalX](https://github.com/MarshalX) in [#219](https://github.com/MarshalX/python-webrtc/pull/219)
+* Encode H.264 with our own VideoToolbox session: AutoLevel, no rate freeze, High for Chrome by [@MarshalX](https://github.com/MarshalX) in [#233](https://github.com/MarshalX/python-webrtc/pull/233)
+* Match browsers on SDP munging, connection states, `setParameters` and close by [@MarshalX](https://github.com/MarshalX) in [#227](https://github.com/MarshalX/python-webrtc/pull/227)
+* Replace `to_async` with `call_native`, drop its timeout by [@MarshalX](https://github.com/MarshalX) in [#206](https://github.com/MarshalX/python-webrtc/pull/206)
+* Add the OpenAI GPT-Live voice chat example by [@MarshalX](https://github.com/MarshalX) in [#198](https://github.com/MarshalX/python-webrtc/pull/198)
+* Add field trials, connect the GPT-Live example with WARP, skip loopback candidates by [@MarshalX](https://github.com/MarshalX) in [#225](https://github.com/MarshalX/python-webrtc/pull/225)
+* Add the Janus streaming example by [@MarshalX](https://github.com/MarshalX) in [#205](https://github.com/MarshalX/python-webrtc/pull/205)
+* Play Janus streams in stereo by munging the Opus answer by [@MarshalX](https://github.com/MarshalX) in [#234](https://github.com/MarshalX/python-webrtc/pull/234)
+* Rework the docs website with guides, examples and the API reference by [@MarshalX](https://github.com/MarshalX) in [#217](https://github.com/MarshalX/python-webrtc/pull/217)
+* Rewrite the API docs with MDN links by [@MarshalX](https://github.com/MarshalX) in [#221](https://github.com/MarshalX/python-webrtc/pull/221)
+* Run original web-platform-tests through a PythonMonkey shim by [@MarshalX](https://github.com/MarshalX) in [#193](https://github.com/MarshalX/python-webrtc/pull/193)
+* Sync tests with web-platform-tests by [@MarshalX](https://github.com/MarshalX) in [#192](https://github.com/MarshalX/python-webrtc/pull/192)
+* Compare the public API with the WPT WebIDL by [@MarshalX](https://github.com/MarshalX) in [#211](https://github.com/MarshalX/python-webrtc/pull/211)
+* Add Atheris fuzz targets, fix findings by [@MarshalX](https://github.com/MarshalX) in [#204](https://github.com/MarshalX/python-webrtc/pull/204)
+* Add strict clang-format and clang-tidy, fix all findings by [@MarshalX](https://github.com/MarshalX) in [#203](https://github.com/MarshalX/python-webrtc/pull/203)
+* Enable all ruff rules, fix findings by [@MarshalX](https://github.com/MarshalX) in [#210](https://github.com/MarshalX/python-webrtc/pull/210)
+* Type check with Pyrefly at full strictness, fix findings by [@MarshalX](https://github.com/MarshalX) in [#213](https://github.com/MarshalX/python-webrtc/pull/213)
+* Run tests on GitHub Actions by [@MarshalX](https://github.com/MarshalX) in [#187](https://github.com/MarshalX/python-webrtc/pull/187)
+* Build on Ubuntu 22.04 in CI by [@MarshalX](https://github.com/MarshalX) in [#189](https://github.com/MarshalX/python-webrtc/pull/189)
+* Make CI wheel builds and PyPI publish safe to retry by [@MarshalX](https://github.com/MarshalX) in [#226](https://github.com/MarshalX/python-webrtc/pull/226)
+* Retry and cache CI downloads, build the sdist in each wheel job by [@MarshalX](https://github.com/MarshalX) in [#230](https://github.com/MarshalX/python-webrtc/pull/230)
+* Run isolated tests as functions instead of code strings by [@MarshalX](https://github.com/MarshalX) in [#228](https://github.com/MarshalX/python-webrtc/pull/228)
+* Add an unattended bug hunt with stacks, crash triage and C++/Python coverage by [@MarshalX](https://github.com/MarshalX) in [#231](https://github.com/MarshalX/python-webrtc/pull/231)
+* Update the licence holder and headers, rebuild third-party licences for M152 by [@MarshalX](https://github.com/MarshalX) in [#220](https://github.com/MarshalX/python-webrtc/pull/220)
+* Fix wrapper ownership: shared_ptr lifetimes, no factory leaks or dangling observers by [@MarshalX](https://github.com/MarshalX) in [#194](https://github.com/MarshalX/python-webrtc/pull/194)
+* Fix the GC deadlock by releasing wrappers off libwebrtc threads by [@MarshalX](https://github.com/MarshalX) in [#199](https://github.com/MarshalX/python-webrtc/pull/199)
+* Fix deadlocks, leaks and crashes found by sanitizers and chaos tests by [@MarshalX](https://github.com/MarshalX) in [#200](https://github.com/MarshalX/python-webrtc/pull/200)
+* Fix `set_parameters` hanging when libwebrtc drops the callback by [@MarshalX](https://github.com/MarshalX) in [#208](https://github.com/MarshalX/python-webrtc/pull/208)
+* Fix sender and receiver leaks by releasing handlers of ended tracks by [@MarshalX](https://github.com/MarshalX) in [#216](https://github.com/MarshalX/python-webrtc/pull/216)
+* Fix spec bugs found by a stricter WPT by [@MarshalX](https://github.com/MarshalX) in [#222](https://github.com/MarshalX/python-webrtc/pull/222)
+* Fix callback crashes, exit hangs and thread churn in the native layer by [@MarshalX](https://github.com/MarshalX) in [#223](https://github.com/MarshalX/python-webrtc/pull/223)
+* Fix stream, track and event-loop bugs, and a wrapper deadlock by [@MarshalX](https://github.com/MarshalX) in [#224](https://github.com/MarshalX/python-webrtc/pull/224)
+* Release tasks stranded by a closed test loop by [@MarshalX](https://github.com/MarshalX) in [#229](https://github.com/MarshalX/python-webrtc/pull/229)
+* Rebuild object lifetime: unreferenced connections, channels and live tracks stay alive while they have handlers or pending work, native threads never run Python, wrappers take no attributes by [@MarshalX](https://github.com/MarshalX) in [#232](https://github.com/MarshalX/python-webrtc/pull/232)
+* Fire `ended` on remote tracks when a connection closes, keep a failed `RTCIceTransport` for an ICE restart by [@MarshalX](https://github.com/MarshalX) in [#232](https://github.com/MarshalX/python-webrtc/pull/232)
+* Fix a cancelled operation of a connection breaking the operations queued before and after it by [@MarshalX](https://github.com/MarshalX) in [#217](https://github.com/MarshalX/python-webrtc/pull/217)
+* Fix the docs build with the current `sphinx-favicon` by [@MarshalX](https://github.com/MarshalX) in [#217](https://github.com/MarshalX/python-webrtc/pull/217), closes [#186](https://github.com/MarshalX/python-webrtc/issues/186)
+
+## Version 0.0.0.dev9
+
+**03.03.2022**
+
+* Add `RTCDtlsTransport` and `RTCPeerConnection.add_transceiver`, with `RtpEncodingParameters`, `RtpTransceiverInit` and `MediaType`
+* `transport` of `RTCRtpSender` and `RTCRtpReceiver`
+* `MediaStreamTrack.kind` is a `MediaType`
+
+## Version 0.0.0.dev8
+
+**02.03.2022**
+
+* Add `RTCRtpTransceiver`, `RTCRtpReceiver` and `RTCIceTransport`
+* `get_transceivers`, `get_senders` and `get_receivers` of `RTCPeerConnection`
+* Unified Plan is the default SDP semantics
+
+## Version 0.0.0.dev7
+
+**26.02.2022**
+
+* Fix a segfault of the `MediaStream` from `get_user_media`
+* Compare Python wrappers by their native objects
+* Add the test suite with pytest
+
+## Version 0.0.0.dev6
+
+**10.02.2022**
+
+* Bind `RTCError`, `SdpParseError` and the common exceptions; failed async calls raise them
+* Fix a segfault in `RTCPeerConnection.close`
+* Add the security policy
+
+## Version 0.0.0.dev5
+
+**09.02.2022**
+
+* Fix a segfault of `RTCSessionDescription` (double destruction)
+* Publish the sdist, include third-party licences in the package
+
+## Version 0.0.0.dev4
+
+**06.02.2022**
+
+* Keep one Python wrapper per native object, which fixes many segfaults and bus errors
+* Fix `MediaStream` pointers and the creation of `RTCRtpSender`
+* Docs: favicons, OpenGraph, keyboard navigation and mobile layout
+
+## Version 0.0.0.dev3
+
+**03.02.2022**
+
+* Docs on Read the Docs, a README with the logo
+
+## Version 0.0.0.dev2
+
+**03.02.2022**
+
+* `RTCPeerConnection` with `create_offer`, `create_answer`, `set_local_description`, `set_remote_description`, `add_track` and `close`
+* `MediaStream`, `MediaStreamTrack` and `get_user_media`
+* `RTCRtpSender`, and `RTCAudioSource` to send PCM from Python
+* The pure Python `webrtc` module over the native `wrtc`, with docs
+* Wheels for Linux, macOS (Intel and Apple Silicon) and Windows
+
+## Version 0.0.0.dev1
+
+**03.01.2022**
+
+* The first upload: the package skeleton

wrtc-0.0.1/CMakeLists.txt

@@ -0,0 +1,37 @@
+cmake_minimum_required(VERSION 3.26)
+
+if(NOT DEFINED SKBUILD_PROJECT_VERSION)
+  set(SKBUILD_PROJECT_VERSION 0.0.0)
+  set(SKBUILD_PROJECT_VERSION_FULL 0.0.0.dev0)
+endif()
+
+project(python_webrtc
+    LANGUAGES C CXX
+    DESCRIPTION "a Python extension that provides bindings to WebRTC"
+    HOMEPAGE_URL "https://github.com/MarshalX/python-webrtc"
+    VERSION ${SKBUILD_PROJECT_VERSION}
+)
+
+set(CMAKE_CXX_STANDARD 20)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+if(APPLE)
+  # glue to libwebrtc's ObjC VideoToolbox codecs
+  enable_language(OBJCXX)
+  set(CMAKE_OBJCXX_STANDARD 20)
+endif()
+# for clang-tidy (make tidy) and editors
+set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
+if(MSVC)
+  # libwebrtc is linked against the static release CRT
+  set(CMAKE_MSVC_RUNTIME_LIBRARY MultiThreaded)
+endif()
+
+include(cmake/libwebrtc.cmake)
+
+find_package(Python 3.9 REQUIRED COMPONENTS Interpreter Development.Module)
+find_package(pybind11 CONFIG REQUIRED)
+
+include(cmake/openh264.cmake)
+
+add_subdirectory(python-webrtc/cpp)

wrtc-0.0.1/CONTRIBUTING.md

@@ -0,0 +1,46 @@
+# Contributing
+
+Contributions of any size are welcome. For bugs and features, [open an issue](https://github.com/MarshalX/python-webrtc/issues/new);
+for questions, [start a discussion](https://github.com/MarshalX/python-webrtc/discussions/new).
+
+## Development
+
+Requires [uv](https://docs.astral.sh/uv/).
+
+``` bash
+make dev     # editable install into .venv, C++ is rebuilt on import when changed
+make test    # run the test suite
+make lint    # ruff
+make stub    # regenerate type stubs of the native module
+make wheels  # build wheels for the current platform the same way CI does
+```
+
+## Building from sources (sdist)
+
+- CMake 3.26 or higher
+- A C++20 compiler: Clang on Linux (libwebrtc there is built against Chromium's libc++), Apple Clang on macOS, MSVC on Windows
+- ~150 MB of free disk space
+
+Nothing else has to be installed or configured manually: a prebuilt static libwebrtc for the target platform
+(from [libwebrtc-bin](https://github.com/crow-misia/libwebrtc-bin)) is downloaded once, verified and unpacked
+into a shared cache (`~/.cache/python-webrtc`, `%LOCALAPPDATA%\python-webrtc` on Windows or `$WRTC_CACHE_DIR`).
+Only the headers in use are extracted and debug info is stripped, so it takes ~60 MB per platform.
+Pass `-Ccmake.define.LIBWEBRTC_ROOT=/path/to/libwebrtc` to use your own libwebrtc build instead.
+
+## Releasing
+
+1. Bump `version` in `pyproject.toml` and run `uv lock`.
+2. Push a `v<version>` tag. CI builds the sdist and wheels for every platform and publishes them to PyPI.
+
+Publishing uses [trusted publishing](https://docs.pypi.org/trusted-publishers/): the PyPI project needs a
+trusted publisher for this repository's `ci.yml` workflow, and the repository a `pypi` environment. No tokens needed.
+
+## Updating WebRTC
+
+The libwebrtc version and archive hashes are pinned in `cmake/libwebrtc.cmake`:
+
+1. Set `LIBWEBRTC_VERSION` to a [libwebrtc-bin release](https://github.com/crow-misia/libwebrtc-bin/releases)
+   and update the `LIBWEBRTC_SHA256_*` values (the release page lists a SHA256 digest per asset).
+2. Refresh the Linux libc++ pins as described in [`cmake/libcxx/README.md`](cmake/libcxx/README.md).
+3. Build and run the tests. On Linux, check whether `cmake/libwebrtc_linux_fixups.cpp` is still needed:
+   remove it and see whether the module imports (it is linked with `-z now`, so missing symbols fail on import).

{wrtc-0.0.0.dev8 → wrtc-0.0.1}/LICENSE.md

@@ -1,12 +1,10 @@
 ## BSD 3-Clause License
 
-This project is inspired by [node-webrtc](https://github.com/node-webrtc/node-webrtc). License: [LICENSE](https://github.com/node-webrtc/node-webrtc/blob/develop/LICENSE.md).
-
 The following license applies to all parts of this software except as documented
 below.
 
 ```
-Copyright (c) 2022, The Python WebRTC project authors. All rights reserved.
+Copyright (c) 2022-2026 Ilya Siamionau. All rights reserved.
 
 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions are met:

wrtc-0.0.1/Makefile

@@ -0,0 +1,86 @@
+.PHONY: dev test asan tsan ft fuzz hunt hunt-report coverage coverage-report stacks lint typecheck format format-check tidy stub wheels doc clean
+
+# pinned to the clang-tidy of .github/scripts/tidy.sh
+CLANG_FORMAT := uvx clang-format==22.1.8
+CPP_SRC = $(shell find python-webrtc/cpp/src -name '*.cpp' -o -name '*.h' -o -name '*.mm')
+
+# editable install; the extension is rebuilt automatically on import after C++ changes
+dev:
+	uv sync --group dev --no-install-project
+	uv pip install --no-build-isolation -e . \
+		-Ceditable.rebuild=true -Cbuild-dir=build/editable
+
+test:
+	uv run --no-sync pytest tests $(O)
+
+# the tests against an ASan+UBSan build, natively on macOS (on Linux: .github/scripts/sanitizers.sh)
+asan:
+	.github/scripts/sanitizers-macos.sh $(O)
+
+tsan:
+	SANITIZE=thread .github/scripts/sanitizers-macos.sh $(O)
+
+# the tests against a plain build with another interpreter, kept in build/ft: make ft [PY=3.15t] [B=build/ft] [O=...]
+ft:
+	SANITIZE=none PYTHON="$$(uv python find $(or $(PY),3.15t))" WRTC_SANITIZERS_BUILD_DIR="$(or $(B),build/ft)" \
+		.github/scripts/sanitizers-macos.sh $(O)
+
+# a target of tests/fuzz with Atheris in the Linux image, the build kept in build/fuzz: make fuzz T=video_frame O=-max_total_time=600
+fuzz:
+	docker run --rm -it --platform linux/amd64 -v "$(CURDIR):/src" -v "$(CURDIR)/build/fuzz:/tmp/wrtc-fuzz" \
+		-e WRTC_CACHE_DIR=/tmp/wrtc-fuzz/cache -w /src \
+		quay.io/pypa/manylinux_2_28_x86_64 .github/scripts/fuzz.sh $(T) $(O)
+
+# the unattended bug hunt of scripts/debug/hunt.py, results in build/hunt/REPORT.md: make hunt H=8 [O='--until 07:30']
+hunt:
+	CMAKE_BUILD_PARALLEL_LEVEL=4 uv run --no-sync python -m scripts.debug.hunt --hours $(or $(H),8) $(O)
+
+hunt-report:
+	@cat build/hunt/REPORT.md
+
+# make coverage [O='-k stats'], results in build/coverage
+coverage:
+	CMAKE_BUILD_PARALLEL_LEVEL=4 uv run --no-sync python -m scripts.debug.cover run $(O)
+
+coverage-report:
+	uv run --no-sync python -m scripts.debug.cover report
+
+# native stacks of a process and its children: make stacks PID=1234 [O=--signal]
+stacks:
+	uv run --no-sync python -m scripts.debug.stacks $(PID) $(O)
+
+lint: format-check
+	uvx ruff check
+	uvx ruff format --check
+
+typecheck:
+	uvx pyrefly check
+
+format:
+	uvx ruff check --fix
+	uvx ruff format
+	$(CLANG_FORMAT) -i $(CPP_SRC)
+
+format-check:
+	@$(CLANG_FORMAT) --dry-run --Werror $(CPP_SRC)
+
+# clang-tidy over the extension, see .clang-tidy
+tidy:
+	.github/scripts/tidy.sh $(O)
+
+stub:
+	uv run --no-sync pybind11-stubgen wrtc -o build/stubs
+	cp build/stubs/wrtc.pyi stubs/wrtc/__init__.pyi
+	# collections.abc.Buffer is 3.12+
+	perl -pi -e 's/collections\.abc\.Buffer/typing_extensions.Buffer/g; s/^import typing$$/import typing\nimport typing_extensions/' stubs/wrtc/__init__.pyi
+
+# wheels for the current platform, exactly as CI builds them
+wheels:
+	uvx cibuildwheel==4.2.1 --output-dir wheelhouse
+
+doc:
+	UV_PROJECT_ENVIRONMENT=build/docs-venv uv sync --frozen --only-group docs --python 3.13
+	cd docs && make gen && make html SPHINXBUILD=../build/docs-venv/bin/sphinx-build
+
+clean:
+	rm -rf build dist wheelhouse