video-stream-data 0.1.3__tar.gz

video_stream_data-0.1.3/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Andreas Bresser
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

video_stream_data-0.1.3/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: video_stream_data
+Version: 0.1.3
+Summary: Unified data format for video streams (devices, server, ...)
+Home-page: https://github.com/brean/video_stream_data
+Author: Andreas Bresser
+Author-email: Andreas.Bresser@dfki.de
+License: BSD-3
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Video Stream Data
+Dependency-free data structures for video streaming.
+
+## Installation
+Use **pip** to install. Its recommended to install in a virtual environment
+
+```bash
+python3 -m venv video-streaming-pipeline
+# install using system-site-packages (like opencv and pyudev)
+source video-streaming-pipeline/bin/activate --system-site-packages
+pip3 install video_stream_data
+```
+
+Although not recommended a user installation with `--break-system-packages` would also be okay as it does not have any dependencies.
+
+## Usage
+Simply import the data classes you want to have, you can use the parser to load the video stream settings from a file (see `test/`-folder).
+
+You can use the data structure to manually create any kind of video stream.
+
+
+```mermaid
+classDiagram
+    direction LR
+
+    class StreamControlType {
+        <<enumeration>>
+        +INT: str = 'int'
+        +BOOL: str = 'bool'
+        +MENU: str = 'menu'
+    }
+
+    class Encoding {
+        <<enumeration>>
+        +PASSTHROUGH: str = 'passthrough'
+        +BGR: str = 'bgr'
+        +GREY: str = 'grey'
+        +GREY16: str = 'grey16'
+        +GRB: str = 'rbg'
+        +BGRA: str = 'bgra'
+        +RGBA: str = 'rgba'
+
+    }
+
+    class Codec {
+        <<enumeration>>
+        +MJPEG: str = 'MJPEG'  # Motion-JPEG
+        +YUYV: str = 'YUYV'  # e.g. YUYV 4:2:2
+        +XVID: str = 'XVID'  # e.g. mp4 files
+        +UNKNOWN: str = 'unknown'
+    }
+
+    class StreamControl {
+        +type: StreamControlType
+        +name: str
+        +writable: bool = False
+        +min: float = 0
+        +max: float = 0
+        +step: int = 1
+        +value: float | bool | None = None
+        +options: list = []
+    }
+
+    class StreamValue {
+        # desired video resolution
+        +resolution: list[int]
+        +fps: float  # desired FPS by user
+        # desired configuration
+        +controls: dict[str, int | float | bool | None]
+        +encoding: Encoding = Encoding.PASSTHROUGH
+        +codec: Codec = Codec.UNKNOWN
+    }
+
+    class StreamInfo {
+        +name: str
+        +stream_path: str
+        +driver: str
+        +codec: list[str]
+        +controls: list[StreamControl]
+        +resolutions: list[int, int]
+        +max_fps: float
+        +values: StreamValue
+        +backend: str = 'v4l2'
+    }
+
+    StreamControlType <|-- StreamControl
+    Encoding <|-- StreamValue
+    Codec <|-- StreamValue
+    StreamControl --> StreamInfo : controls
+    StreamValue --> StreamInfo : values
+
+```
+*Fig. 1: Data Model for the StreamInfo generated from any device*

video_stream_data-0.1.3/README.md

@@ -0,0 +1,93 @@
+# Video Stream Data
+Dependency-free data structures for video streaming.
+
+## Installation
+Use **pip** to install. Its recommended to install in a virtual environment
+
+```bash
+python3 -m venv video-streaming-pipeline
+# install using system-site-packages (like opencv and pyudev)
+source video-streaming-pipeline/bin/activate --system-site-packages
+pip3 install video_stream_data
+```
+
+Although not recommended a user installation with `--break-system-packages` would also be okay as it does not have any dependencies.
+
+## Usage
+Simply import the data classes you want to have, you can use the parser to load the video stream settings from a file (see `test/`-folder).
+
+You can use the data structure to manually create any kind of video stream.
+
+
+```mermaid
+classDiagram
+    direction LR
+
+    class StreamControlType {
+        <<enumeration>>
+        +INT: str = 'int'
+        +BOOL: str = 'bool'
+        +MENU: str = 'menu'
+    }
+
+    class Encoding {
+        <<enumeration>>
+        +PASSTHROUGH: str = 'passthrough'
+        +BGR: str = 'bgr'
+        +GREY: str = 'grey'
+        +GREY16: str = 'grey16'
+        +GRB: str = 'rbg'
+        +BGRA: str = 'bgra'
+        +RGBA: str = 'rgba'
+
+    }
+
+    class Codec {
+        <<enumeration>>
+        +MJPEG: str = 'MJPEG'  # Motion-JPEG
+        +YUYV: str = 'YUYV'  # e.g. YUYV 4:2:2
+        +XVID: str = 'XVID'  # e.g. mp4 files
+        +UNKNOWN: str = 'unknown'
+    }
+
+    class StreamControl {
+        +type: StreamControlType
+        +name: str
+        +writable: bool = False
+        +min: float = 0
+        +max: float = 0
+        +step: int = 1
+        +value: float | bool | None = None
+        +options: list = []
+    }
+
+    class StreamValue {
+        # desired video resolution
+        +resolution: list[int]
+        +fps: float  # desired FPS by user
+        # desired configuration
+        +controls: dict[str, int | float | bool | None]
+        +encoding: Encoding = Encoding.PASSTHROUGH
+        +codec: Codec = Codec.UNKNOWN
+    }
+
+    class StreamInfo {
+        +name: str
+        +stream_path: str
+        +driver: str
+        +codec: list[str]
+        +controls: list[StreamControl]
+        +resolutions: list[int, int]
+        +max_fps: float
+        +values: StreamValue
+        +backend: str = 'v4l2'
+    }
+
+    StreamControlType <|-- StreamControl
+    Encoding <|-- StreamValue
+    Codec <|-- StreamValue
+    StreamControl --> StreamInfo : controls
+    StreamValue --> StreamInfo : values
+
+```
+*Fig. 1: Data Model for the StreamInfo generated from any device*

video_stream_data-0.1.3/setup.cfg

@@ -0,0 +1,41 @@
+[metadata]
+name = video_stream_data
+version = 0.1.3
+author = Andreas Bresser
+author_email = Andreas.Bresser@dfki.de
+license = BSD-3
+description = Unified data format for video streams (devices, server, ...)
+url = https://github.com/brean/video_stream_data
+long_description = file: README.md
+long_description_content_type = text/markdown
+
+[options]
+packages = find:
+install_requires = 
+
+[bumpversion]
+current_version = 0.1.3
+commit = True
+tag = True
+
+[bumpversion:file:setup.py]
+search = version='{current_version}'
+replace = version='{new_version}'
+
+[bumpversion:file:video_stream_data/__init__.py]
+search = __version__ = '{current_version}'
+replace = __version__ = '{new_version}'
+
+[bdist_wheel]
+universal = 1
+
+[flake8]
+exclude = docs
+
+[aliases]
+test = pytest
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

video_stream_data-0.1.3/setup.py

@@ -0,0 +1,6 @@
+#!/usr/bin/env python3
+"""Use setuptools to install video_stream_data."""
+from setuptools import setup
+
+# read from setup.cfg
+setup()

video_stream_data-0.1.3/test/test_utils.py

@@ -0,0 +1,46 @@
+"""Test loading/saving data."""
+from pathlib import Path
+import tempfile
+
+from video_stream_data import Codec, Encoding, StreamInfo, StreamValue
+from video_stream_data.utils import load, save
+
+BASE_PATH = Path(__file__).absolute().parent
+LOCAL_VIDEO_DEVICE = BASE_PATH / 'data' / 'local_video_device.yml'
+
+
+def test_load_stream_info():
+    """Test loading data from yaml."""
+    stream_info = load(LOCAL_VIDEO_DEVICE)
+    assert len(stream_info) == 1
+    stream = stream_info[0]
+    assert isinstance(stream, StreamInfo)
+    assert stream.name == 'Dummy Camera'
+    assert isinstance(stream.values, StreamValue)
+    assert stream.values.codec == Codec.MJPEG
+    assert stream.values.encoding == Encoding.PASSTHROUGH
+    assert stream.values.controls['Power Line Frequency'] == 2
+    assert stream.controls
+    power_line_freq = False
+    for ctrl in stream.controls:
+        if ctrl.name == 'Power Line Frequency':
+            power_line_freq = True
+            break
+    assert power_line_freq
+
+
+def test_save_stream_info():
+    """Test saving data to temp file."""
+    stream_info = load(LOCAL_VIDEO_DEVICE)
+    tmp = tempfile.NamedTemporaryFile()
+    save(stream_info, tmp.name)
+
+    # check file by string compare
+    saved_data = ''
+    with open(tmp.name, 'r') as data:
+        saved_data = data.read()
+    assert 'Dummy Camera' in saved_data
+
+    # check full structure by reloading
+    reloaded_stream_info = load(tmp.name)
+    assert reloaded_stream_info == stream_info

video_stream_data-0.1.3/video_stream_data/__init__.py

@@ -0,0 +1,166 @@
+"""Provide unified meta data definition for video streaming."""
+from dataclasses import asdict, dataclass, field
+from enum import Enum
+
+
+class StreamControlType(str, Enum):
+    """Different configuration types for the stream.
+
+    Taken from opencv2 device controls.
+    """
+
+    INT = 'int'
+    BOOL = 'bool'
+    MENU = 'menu'
+
+
+class Encoding(str, Enum):
+    """Defines how the video stream gets encodied.
+
+    Should default to 'passthrough'.
+    Normally BGR in ROS, RGB in h264.
+    """
+
+    PASSTHROUGH = 'passthrough'
+    BGR = 'bgr'
+    GREY = 'grey'
+    GREY16 = 'grey16'
+    RGB = 'rgb'
+    BGRA = 'bgra'
+    RGBA = 'rgba'
+
+    def to_ros_bridge(self) -> str:
+        """Create string to use with the ROS2 CvBridge."""
+        if self.value == Encoding.BGR:
+            return 'bgr8'
+        elif self.value == Encoding.RGB:
+            return 'rgb8'
+        elif self.value == Encoding.BGR:
+            return 'bgra8'
+        elif self.value == Encoding.RGB:
+            return 'rgba8'
+        elif self.value == Encoding.GREY:
+            return 'mono8'
+        elif self.value == Encoding.GREY16:
+            return 'mono16'
+        else:
+            return str(self.value)
+
+
+class Codec(str, Enum):
+    """Codec type/Pixel format as fourcc."""
+
+    # see linuxpy/video/raw.py
+
+    MJPEG = 'MJPEG'  # Motion-JPEG
+    YUYV = 'YUYV'
+    XVID = 'XVID'  # MP4 files
+    UNKNOWN = 'unknown'
+
+    def to_text(self) -> str:
+        """Create human readable text."""
+        if self.value == Encoding.MJPEG:
+            return 'Motion-JPEG'
+        elif self.value == Encoding.YUYV:
+            return 'YUYV'
+        elif self.value == Encoding.XVID:
+            return 'XVID/MP4'
+
+    def to_fourcc(self) -> str:
+        """Create FourCC-Text for configuration of OpenCV2 VideoWriter."""
+        if self.value == Encoding.MJPEG:
+            return 'MJPG'
+        return str(self)
+
+
+@dataclass
+class StreamControl:
+    """Provide a value the user can configure."""
+
+    type: StreamControlType  # noqa: A003
+    name: str
+    writable: bool = False
+    min: float = 0  # noqa: A003
+    max: float = 0  # noqa: A003
+    step: int = 1
+    value: int | float | bool | None = None
+    options: list[(str, str)] = field(default_factory=list)
+
+    def __post_init__(self):
+        if self.type:
+            self.type = StreamControlType(self.type)
+
+@dataclass
+class StreamValue:
+    """Values requested by the user."""
+
+    # selected resolution
+    resolution: list[int]
+    # current fps
+    fps: float
+    # selected control configurations
+    controls: dict[str, int | float | bool | None]
+    # selected encoding, e.g. bgr
+    encoding: Encoding = Encoding.PASSTHROUGH
+    # selected codec e.g. MJPEG for "Motion-JPEG" or YUYV for "YUYV 4:2:2"
+    codec: Codec = Codec.UNKNOWN
+
+    def __post_init__(self):
+        if self.encoding:
+            self.encoding = Encoding(self.encoding)
+
+
+@dataclass
+class StreamInfo:
+    """Stream information provided by the device/host."""
+
+    name: str
+    # unique stream path
+    stream_path: str
+    # driver for example "uvcvideo" for a local OpenCV webcam or
+    # "webrtc" for a WebRTC Video Stream
+    driver: str
+    # available codec
+    codec: list[Codec]
+    # all available controls from linuxpy
+    controls: list[StreamControl]
+    # all available resolutions, starting with the default resolution
+    resolutions: list[int, int]
+    # max. possible fps (at default resolution)
+    max_fps: float
+    # current configuration as own data structure so it can easily be handed
+    # over as dict from any service
+    values: StreamValue
+    backend: str = 'v4l2'  # (optional) OpenCV2 Backend (only if cv2 is used)
+
+    def __post_init__(self):
+        if self.codec:
+            self.codec = [Codec(c) for c in self.codec]
+        if self.values and isinstance(self.values, dict):
+            self.values = StreamValue(**self.values)
+        if self.controls:
+            self.controls = [
+                StreamControl(**c) if isinstance(c, dict) else c
+                for c in self.controls
+            ]
+
+
+def _dict_factory(data):
+    def convert_value(obj):
+        if isinstance(obj, Enum):
+            return obj.value
+        elif isinstance(obj, list):
+            return [convert_value(x) for x in obj]
+        elif isinstance(obj, set):
+            return {convert_value(x) for x in obj}
+        elif isinstance(obj, tuple):
+            return tuple(convert_value(x) for x in obj)
+        return obj
+    return {k: convert_value(v) for k, v in data}
+
+
+def stream_as_dict(stream_obj):
+    """Serialize stream information as dict."""
+    return asdict(
+        stream_obj,
+        dict_factory=_dict_factory)

video_stream_data-0.1.3/video_stream_data/utils.py

@@ -0,0 +1,21 @@
+"""Utility functions like saving and loading YAML files."""
+from pathlib import Path
+
+import yaml
+
+from . import stream_as_dict, StreamInfo
+
+
+def load(filename: Path | str) -> None | list[StreamInfo]:
+    """Load the yaml file and return it as list of StreamInfo."""
+    with open(filename, 'r') as data:
+        yaml_data = yaml.safe_load(data)
+        return [StreamInfo(**stream) for stream in yaml_data]
+    return None
+
+
+def save(data: list[StreamInfo], filename: Path | str) -> None:
+    """Save list of StreamInfo to yaml file."""
+    yaml_data = [stream_as_dict(s) for s in data]
+    with open(filename, 'w') as data:
+        data.write(yaml.safe_dump(yaml_data))

video_stream_data-0.1.3/video_stream_data.egg-info/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: video_stream_data
+Version: 0.1.3
+Summary: Unified data format for video streams (devices, server, ...)
+Home-page: https://github.com/brean/video_stream_data
+Author: Andreas Bresser
+Author-email: Andreas.Bresser@dfki.de
+License: BSD-3
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Video Stream Data
+Dependency-free data structures for video streaming.
+
+## Installation
+Use **pip** to install. Its recommended to install in a virtual environment
+
+```bash
+python3 -m venv video-streaming-pipeline
+# install using system-site-packages (like opencv and pyudev)
+source video-streaming-pipeline/bin/activate --system-site-packages
+pip3 install video_stream_data
+```
+
+Although not recommended a user installation with `--break-system-packages` would also be okay as it does not have any dependencies.
+
+## Usage
+Simply import the data classes you want to have, you can use the parser to load the video stream settings from a file (see `test/`-folder).
+
+You can use the data structure to manually create any kind of video stream.
+
+
+```mermaid
+classDiagram
+    direction LR
+
+    class StreamControlType {
+        <<enumeration>>
+        +INT: str = 'int'
+        +BOOL: str = 'bool'
+        +MENU: str = 'menu'
+    }
+
+    class Encoding {
+        <<enumeration>>
+        +PASSTHROUGH: str = 'passthrough'
+        +BGR: str = 'bgr'
+        +GREY: str = 'grey'
+        +GREY16: str = 'grey16'
+        +GRB: str = 'rbg'
+        +BGRA: str = 'bgra'
+        +RGBA: str = 'rgba'
+
+    }
+
+    class Codec {
+        <<enumeration>>
+        +MJPEG: str = 'MJPEG'  # Motion-JPEG
+        +YUYV: str = 'YUYV'  # e.g. YUYV 4:2:2
+        +XVID: str = 'XVID'  # e.g. mp4 files
+        +UNKNOWN: str = 'unknown'
+    }
+
+    class StreamControl {
+        +type: StreamControlType
+        +name: str
+        +writable: bool = False
+        +min: float = 0
+        +max: float = 0
+        +step: int = 1
+        +value: float | bool | None = None
+        +options: list = []
+    }
+
+    class StreamValue {
+        # desired video resolution
+        +resolution: list[int]
+        +fps: float  # desired FPS by user
+        # desired configuration
+        +controls: dict[str, int | float | bool | None]
+        +encoding: Encoding = Encoding.PASSTHROUGH
+        +codec: Codec = Codec.UNKNOWN
+    }
+
+    class StreamInfo {
+        +name: str
+        +stream_path: str
+        +driver: str
+        +codec: list[str]
+        +controls: list[StreamControl]
+        +resolutions: list[int, int]
+        +max_fps: float
+        +values: StreamValue
+        +backend: str = 'v4l2'
+    }
+
+    StreamControlType <|-- StreamControl
+    Encoding <|-- StreamValue
+    Codec <|-- StreamValue
+    StreamControl --> StreamInfo : controls
+    StreamValue --> StreamInfo : values
+
+```
+*Fig. 1: Data Model for the StreamInfo generated from any device*

video_stream_data-0.1.3/video_stream_data.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+setup.cfg
+setup.py
+test/test_utils.py
+video_stream_data/__init__.py
+video_stream_data/utils.py
+video_stream_data.egg-info/PKG-INFO
+video_stream_data.egg-info/SOURCES.txt
+video_stream_data.egg-info/dependency_links.txt
+video_stream_data.egg-info/top_level.txt

video_stream_data-0.1.3/video_stream_data.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

video_stream_data-0.1.3/video_stream_data.egg-info/top_level.txt

@@ -0,0 +1 @@
+video_stream_data