1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
|
"""WebRTC models."""
from dataclasses import dataclass, field
from warnings import warn
from mashumaro import field_options
from mashumaro.config import BaseConfig
from mashumaro.mixins.orjson import DataClassORJSONMixin
__all__ = [
"RTCConfiguration",
"RTCIceCandidate",
"RTCIceServer",
]
class _RTCBaseModel(DataClassORJSONMixin):
"""Base class for RTC models."""
class Config(BaseConfig):
"""Mashumaro config."""
# Serialize to spec conform names and omit default values
omit_default = True
serialize_by_alias = True
@dataclass
class RTCIceServer(_RTCBaseModel):
"""RTC Ice Server.
See https://www.w3.org/TR/webrtc/#rtciceserver-dictionary
"""
urls: str | list[str]
username: str | None = None
credential: str | None = None
@dataclass
class RTCConfiguration(_RTCBaseModel):
"""RTC Configuration.
See https://www.w3.org/TR/webrtc/#rtcconfiguration-dictionary
"""
ice_servers: list[RTCIceServer] = field(
metadata=field_options(alias="iceServers"), default_factory=list
)
@dataclass(frozen=True)
class RTCIceCandidate(_RTCBaseModel):
"""RTC Ice Candidate.
See https://www.w3.org/TR/webrtc/#rtcicecandidate-interface
"""
candidate: str
def __post_init__(self) -> None:
"""Initialize class."""
msg = "Using RTCIceCandidate is deprecated. Use RTCIceCandidateInit instead"
warn(msg, DeprecationWarning, stacklevel=2)
@dataclass(frozen=True)
class RTCIceCandidateInit(RTCIceCandidate):
"""RTC Ice Candidate Init.
If neither sdp_mid nor sdp_m_line_index are provided and candidate is not an empty
string, sdp_m_line_index is set to 0.
See https://www.w3.org/TR/webrtc/#dom-rtcicecandidateinit
"""
candidate: str
sdp_mid: str | None = field(
metadata=field_options(alias="sdpMid"), default=None, kw_only=True
)
sdp_m_line_index: int | None = field(
metadata=field_options(alias="sdpMLineIndex"), default=None, kw_only=True
)
user_fragment: str | None = field(
metadata=field_options(alias="userFragment"), default=None, kw_only=True
)
def __post_init__(self) -> None:
"""Initialize class."""
if not self.candidate:
# An empty string represents an end-of-candidates indication
# or a peer reflexive remote candidate
return
if self.sdp_mid is None and self.sdp_m_line_index is None:
object.__setattr__(self, "sdp_m_line_index", 0)
elif (sdp := self.sdp_m_line_index) is not None and sdp < 0:
msg = "sdpMLineIndex must be greater than or equal to 0"
raise ValueError(msg)
|
