openm3u8 7.0.0__cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

openm3u8/protocol.py

@@ -0,0 +1,47 @@
+# Copyright 2014 Globo.com Player authors. All rights reserved.
+# Modifications Copyright (c) 2026 Wurl.
+# Use of this source code is governed by a MIT License
+# license that can be found in the LICENSE file.
+
+ext_m3u = "#EXTM3U"
+ext_x_targetduration = "#EXT-X-TARGETDURATION"
+ext_x_media_sequence = "#EXT-X-MEDIA-SEQUENCE"
+ext_x_discontinuity_sequence = "#EXT-X-DISCONTINUITY-SEQUENCE"
+ext_x_program_date_time = "#EXT-X-PROGRAM-DATE-TIME"
+ext_x_media = "#EXT-X-MEDIA"
+ext_x_playlist_type = "#EXT-X-PLAYLIST-TYPE"
+ext_x_key = "#EXT-X-KEY"
+ext_x_stream_inf = "#EXT-X-STREAM-INF"
+ext_x_version = "#EXT-X-VERSION"
+ext_x_allow_cache = "#EXT-X-ALLOW-CACHE"
+ext_x_endlist = "#EXT-X-ENDLIST"
+extinf = "#EXTINF"
+ext_i_frames_only = "#EXT-X-I-FRAMES-ONLY"
+ext_x_asset = "#EXT-X-ASSET"
+ext_x_bitrate = "#EXT-X-BITRATE"
+ext_x_byterange = "#EXT-X-BYTERANGE"
+ext_x_i_frame_stream_inf = "#EXT-X-I-FRAME-STREAM-INF"
+ext_x_discontinuity = "#EXT-X-DISCONTINUITY"
+ext_x_cue_out = "#EXT-X-CUE-OUT"
+ext_x_cue_out_cont = "#EXT-X-CUE-OUT-CONT"
+ext_x_cue_in = "#EXT-X-CUE-IN"
+ext_x_cue_span = "#EXT-X-CUE-SPAN"
+ext_oatcls_scte35 = "#EXT-OATCLS-SCTE35"
+ext_is_independent_segments = "#EXT-X-INDEPENDENT-SEGMENTS"
+ext_x_map = "#EXT-X-MAP"
+ext_x_start = "#EXT-X-START"
+ext_x_server_control = "#EXT-X-SERVER-CONTROL"
+ext_x_part_inf = "#EXT-X-PART-INF"
+ext_x_part = "#EXT-X-PART"
+ext_x_rendition_report = "#EXT-X-RENDITION-REPORT"
+ext_x_skip = "#EXT-X-SKIP"
+ext_x_session_data = "#EXT-X-SESSION-DATA"
+ext_x_session_key = "#EXT-X-SESSION-KEY"
+ext_x_preload_hint = "#EXT-X-PRELOAD-HINT"
+ext_x_daterange = "#EXT-X-DATERANGE"
+ext_x_gap = "#EXT-X-GAP"
+ext_x_content_steering = "#EXT-X-CONTENT-STEERING"
+ext_x_image_stream_inf = "#EXT-X-IMAGE-STREAM-INF"
+ext_x_images_only = "#EXT-X-IMAGES-ONLY"
+ext_x_tiles = "#EXT-X-TILES"
+ext_x_blackout = "#EXT-X-BLACKOUT"

openm3u8/version_matching.py

@@ -0,0 +1,37 @@
+from openm3u8 import protocol
+from openm3u8.version_matching_rules import VersionMatchingError, available_rules
+
+
+def get_version(file_lines: list[str]):
+    for line in file_lines:
+        if line.startswith(protocol.ext_x_version):
+            version = line.split(":")[1]
+            return float(version)
+
+    return None
+
+
+def valid_in_all_rules(
+    line_number: int, line: str, version: float
+) -> list[VersionMatchingError]:
+    errors = []
+    for rule in available_rules:
+        validator = rule(version, line_number, line)
+
+        if not validator.validate():
+            errors.append(validator.get_error())
+
+    return errors
+
+
+def validate(file_lines: list[str]) -> list[VersionMatchingError]:
+    found_version = get_version(file_lines)
+    if found_version is None:
+        return []
+
+    errors = []
+    for number, line in enumerate(file_lines):
+        errors_in_line = valid_in_all_rules(number, line, found_version)
+        errors.extend(errors_in_line)
+
+    return errors

openm3u8/version_matching_rules.py

@@ -0,0 +1,108 @@
+from dataclasses import dataclass
+
+from openm3u8 import protocol
+
+
+@dataclass
+class VersionMatchingError(Exception):
+    line_number: int
+    line: str
+    how_to_fix: str = "Please fix the version matching error."
+    description: str = "There is a version matching error in the file."
+
+    def __str__(self):
+        return (
+            "Version matching error found in the file when parsing in strict mode.\n"
+            f"Line {self.line_number}: {self.description}\n"
+            f"Line content: {self.line}\n"
+            f"How to fix: {self.how_to_fix}"
+            "\n"
+        )
+
+
+class VersionMatchRuleBase:
+    description: str = ""
+    how_to_fix: str = ""
+    version: float
+    line_number: int
+    line: str
+
+    def __init__(self, version: float, line_number: int, line: str) -> None:
+        self.version = version
+        self.line_number = line_number
+        self.line = line
+
+    def validate(self):
+        raise NotImplementedError
+
+    def get_error(self):
+        return VersionMatchingError(
+            line_number=self.line_number,
+            line=self.line,
+            description=self.description,
+            how_to_fix=self.how_to_fix,
+        )
+
+
+class ValidIVInEXTXKEY(VersionMatchRuleBase):
+    description = (
+        "You must use at least protocol version 2 if you have IV in EXT-X-KEY."
+    )
+    how_to_fix = "Change the protocol version to 2 or higher."
+
+    def validate(self):
+        if protocol.ext_x_key not in self.line:
+            return True
+
+        if "IV" in self.line:
+            return self.version >= 2
+
+        return True
+
+
+class ValidFloatingPointEXTINF(VersionMatchRuleBase):
+    description = "You must use at least protocol version 3 if you have floating point EXTINF duration values."
+    how_to_fix = "Change the protocol version to 3 or higher."
+
+    def validate(self):
+        if protocol.extinf not in self.line:
+            return True
+
+        chunks = self.line.replace(protocol.extinf + ":", "").split(",", 1)
+        duration = chunks[0]
+
+        def is_number(value: str):
+            try:
+                float(value)
+                return True
+            except ValueError:
+                return False
+
+        def is_floating_number(value: str):
+            return is_number(value) and "." in value
+
+        if is_floating_number(duration):
+            return self.version >= 3
+
+        return is_number(duration)
+
+
+class ValidEXTXBYTERANGEOrEXTXIFRAMESONLY(VersionMatchRuleBase):
+    description = "You must use at least protocol version 4 if you have EXT-X-BYTERANGE or EXT-X-IFRAME-ONLY."
+    how_to_fix = "Change the protocol version to 4 or higher."
+
+    def validate(self):
+        if (
+            protocol.ext_x_byterange not in self.line
+            and protocol.ext_i_frames_only not in self.line
+        ):
+            return True
+
+        return self.version >= 4
+
+
+available_rules: list[type[VersionMatchRuleBase]] = [
+    ValidIVInEXTXKEY,
+    ValidFloatingPointEXTINF,
+    ValidEXTXBYTERANGEOrEXTXIFRAMESONLY,
+]

openm3u8-7.0.0.dist-info/METADATA

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: openm3u8
+Version: 7.0.0
+Summary: Python m3u8 parser
+Author: wurl.com
+License: MIT
+Project-URL: Homepage, https://github.com/openwurl/openm3u8
+Project-URL: Repository, https://github.com/openwurl/openm3u8
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: backports-datetime-fromisoformat; python_version < "3.11"
+Provides-Extra: dev
+Requires-Dist: bottle; extra == "dev"
+Requires-Dist: pytest>=9.0.1; extra == "dev"
+Requires-Dist: pytest-cov>=7.0.0; extra == "dev"
+Dynamic: license-file
+
+# openm3u8
+
+`openm3u8` is a Python library for parsing .m3u8 files, which are used as [HTTP Live Streaming (HLS)](https://tools.ietf.org/html/rfc8216) playlists.
+
+This project is a fork of [m3u8](https://github.com/globocom/m3u8/) and is maintained by [Wurl](https://www.wurl.com/).
+
+# Documentation
+
+## Loading a playlist
+
+To load a playlist into an object from uri, file path or directly from
+string, use the `load/loads` functions:
+
+```python
+import openm3u8
+
+playlist = openm3u8.load('http://videoserver.com/playlist.m3u8')
+print(playlist.segments)
+print(playlist.target_duration)
+
+# if you already have the content as string, use
+
+playlist = openm3u8.loads('#EXTM3U8 ... etc ... ')
+```
+
+## Dumping a playlist
+
+To dump a playlist from an object to the console or a file, use the
+`dump/dumps` functions:
+
+``` python
+import openm3u8
+
+playlist = openm3u8.load('http://videoserver.com/playlist.m3u8')
+print(playlist.dumps())
+
+# if you want to write a file from its content
+
+playlist.dump('playlist.m3u8')
+```
+
+# Supported tags
+
+-   [\#EXT-X-TARGETDURATION](https://tools.ietf.org/html/rfc8216#section-4.3.3.1)
+-   [\#EXT-X-MEDIA-SEQUENCE](https://tools.ietf.org/html/rfc8216#section-4.3.3.2)
+-   [\#EXT-X-DISCONTINUITY-SEQUENCE](https://tools.ietf.org/html/rfc8216#section-4.3.3.3)
+-   [\#EXT-X-PROGRAM-DATE-TIME](https://tools.ietf.org/html/rfc8216#section-4.3.2.6)
+-   [\#EXT-X-MEDIA](https://tools.ietf.org/html/rfc8216#section-4.3.4.1)
+-   [\#EXT-X-PLAYLIST-TYPE](https://tools.ietf.org/html/rfc8216#section-4.3.3.5)
+-   [\#EXT-X-KEY](https://tools.ietf.org/html/rfc8216#section-4.3.2.4)
+-   [\#EXT-X-STREAM-INF](https://tools.ietf.org/html/rfc8216#section-4.3.4.2)
+-   [\#EXT-X-VERSION](https://tools.ietf.org/html/rfc8216#section-4.3.1.2)
+-   [\#EXT-X-ALLOW-CACHE](https://datatracker.ietf.org/doc/html/draft-pantos-http-live-streaming-07#section-3.3.6)
+-   [\#EXT-X-ENDLIST](https://tools.ietf.org/html/rfc8216#section-4.3.3.4)
+-   [\#EXTINF](https://tools.ietf.org/html/rfc8216#section-4.3.2.1)
+-   [\#EXT-X-I-FRAMES-ONLY](https://tools.ietf.org/html/rfc8216#section-4.3.3.6)
+-   [\#EXT-X-BITRATE](https://datatracker.ietf.org/doc/html/draft-pantos-hls-rfc8216bis#section-4.4.4.8)
+-   [\#EXT-X-BYTERANGE](https://tools.ietf.org/html/rfc8216#section-4.3.2.2)
+-   [\#EXT-X-I-FRAME-STREAM-INF](https://tools.ietf.org/html/rfc8216#section-4.3.4.3)
+-   [\#EXT-X-IMAGES-ONLY](https://github.com/image-media-playlist/spec/blob/master/image_media_playlist_v0_4.pdf)
+-   [\#EXT-X-IMAGE-STREAM-INF](https://github.com/image-media-playlist/spec/blob/master/image_media_playlist_v0_4.pdf)
+-   [\#EXT-X-TILES](https://github.com/image-media-playlist/spec/blob/master/image_media_playlist_v0_4.pdf)
+-   [\#EXT-X-DISCONTINUITY](https://tools.ietf.org/html/rfc8216#section-4.3.2.3)
+-   \#EXT-X-CUE-OUT
+-   \#EXT-X-CUE-OUT-CONT
+-   \#EXT-X-CUE-IN
+-   \#EXT-X-CUE-SPAN
+-   \#EXT-OATCLS-SCTE35
+-   [\#EXT-X-INDEPENDENT-SEGMENTS](https://tools.ietf.org/html/rfc8216#section-4.3.5.1)
+-   [\#EXT-X-MAP](https://tools.ietf.org/html/rfc8216#section-4.3.2.5)
+-   [\#EXT-X-START](https://tools.ietf.org/html/rfc8216#section-4.3.5.2)
+-   [\#EXT-X-SERVER-CONTROL](https://datatracker.ietf.org/doc/html/draft-pantos-hls-rfc8216bis#section-4.4.3.8)
+-   [\#EXT-X-PART-INF](https://datatracker.ietf.org/doc/html/draft-pantos-hls-rfc8216bis#section-4.4.3.7)
+-   [\#EXT-X-PART](https://datatracker.ietf.org/doc/html/draft-pantos-hls-rfc8216bis#section-4.4.4.9)
+-   [\#EXT-X-RENDITION-REPORT](https://datatracker.ietf.org/doc/html/draft-pantos-hls-rfc8216bis#section-4.4.5.4)
+-   [\#EXT-X-SKIP](https://datatracker.ietf.org/doc/html/draft-pantos-hls-rfc8216bis#section-4.4.5.2)
+-   [\#EXT-X-SESSION-DATA](https://tools.ietf.org/html/rfc8216#section-4.3.4.4)
+-   [\#EXT-X-PRELOAD-HINT](https://datatracker.ietf.org/doc/html/draft-pantos-hls-rfc8216bis-09#section-4.4.5.3)
+-   [\#EXT-X-SESSION-KEY](https://tools.ietf.org/html/rfc8216#section-4.3.4.5)
+-   [\#EXT-X-DATERANGE](https://tools.ietf.org/html/rfc8216#section-4.3.2.7)
+-   [\#EXT-X-GAP](https://tools.ietf.org/html/draft-pantos-hls-rfc8216bis-05#section-4.4.2.7)
+-   [\#EXT-X-CONTENT-STEERING](https://tools.ietf.org/html/draft-pantos-hls-rfc8216bis-10#section-4.4.6.64)
+
+# Running Tests
+
+``` bash
+$ ./runtests
+```
+
+# Contributing
+
+All contributions are welcome, but we will merge a pull request if, and
+only if, it
+
+- Has tests
+- Follows the code conventions
+
+If you plan to implement a new feature or something that will take more
+than a few minutes, please open an issue to make sure we don't work on
+the same thing.

openm3u8-7.0.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+openm3u8/__init__.py,sha256=v4GY4sr6ufBdoGjFYbdIoDoHkXlNplxno2iPSHCpBXk,2860
+openm3u8/_m3u8_parser.abi3.so,sha256=xyYMgcu3EVgm8uKnlavwZ9Tf2UMvcwKJAkEYcWWleDo,325128
+openm3u8/_m3u8_parser.c,sha256=KwU4azWqDVq_SpScj73IVRaVNABeFRDgLBewjgfRIgk,106559
+openm3u8/httpclient.py,sha256=0RIbdGTfcV-KHAxgG8ltTryz-glLDO9nNKdgYulBeCA,1270
+openm3u8/mixins.py,sha256=a-RYcXjHnBPOUQJtCcpwDCb8jYS0TdEm8Xw2OeLih5k,1461
+openm3u8/model.py,sha256=4D0CwTCC-fyLn-x1UHta7lD87VWWXpgZlX_j2GaR_Vs,56023
+openm3u8/parser.py,sha256=kLIqa5OFIqoQDLRLLffaDRG3u2rYDYGTnS6qaN7vzkw,23963
+openm3u8/protocol.py,sha256=QfMsRc08oHmfzlU8vGhYmIQrRkC0bhSq5y6I8O7AjGo,1826
+openm3u8/version_matching.py,sha256=oHfB1xpzUJy8aWJHM1H0deKbNMloRONAWOe1RYYc4DM,996
+openm3u8/version_matching_rules.py,sha256=rRbZbGQVlCLbkfuEm_MMWAXB4X3CaU2JEQgkbLjkq-0,3012
+openm3u8-7.0.0.dist-info/METADATA,sha256=W8r_Hz-txJkg0UIdP6_pvYulHHeyYZ4aymY-bplnIJI,5312
+openm3u8-7.0.0.dist-info/WHEEL,sha256=aSgG0F4rGPZtV0iTEIfy6dtHq6g67Lze3uLfk0vWn88,151
+openm3u8-7.0.0.dist-info/top_level.txt,sha256=P-N4OU6emEeHAOPxyhnugxA3SCm_wy7OyMs3-19K1s4,9
+openm3u8-7.0.0.dist-info/RECORD,,
+openm3u8-7.0.0.dist-info/licenses/LICENSE,sha256=BOqZtQXlr2aLgBsu-ZvorKCFd6gnLvTmYm_wxe06Dxk,1199

openm3u8-7.0.0.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: false
+Tag: cp312-cp312-manylinux_2_17_x86_64
+Tag: cp312-cp312-manylinux2014_x86_64
+

openm3u8-7.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,13 @@
+openm3u8 is licensed under the MIT License:
+
+The MIT License
+
+Copyright (c) 2012 globo.com webmedia@corp.globo.com
+
+Modifications Copyright (c) 2026 Wurl (solutions@wurl.com)
+
+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.

openm3u8-7.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+openm3u8