Class Video

src/pptx/media.py:14–99

Immutable value object representing a video such as MP4.

class Video(object):
    """Immutable value object representing a video such as MP4."""

    def __init__(self, blob: bytes, mime_type: str | None, filename: str | None):
        super(Video, self).__init__()
        self._blob = blob
        self._mime_type = mime_type
        self._filename = filename

    @classmethod
    def from_blob(cls, blob: bytes, mime_type: str | None, filename: str | None = None):
        """Return a new |Video| object loaded from image binary in *blob*."""
        return cls(blob, mime_type, filename)

    @classmethod
    def from_path_or_file_like(cls, movie_file: str | IO[bytes], mime_type: str | None) -> Video:
        """Return a new |Video| object containing video in *movie_file*.

        *movie_file* can be either a path (string) or a file-like
        (e.g. StringIO) object.
        """
        if isinstance(movie_file, str):
            # treat movie_file as a path
            with open(movie_file, "rb") as f:
                blob = f.read()
            filename = os.path.basename(movie_file)
        else:
            # assume movie_file is a file-like object
            blob = movie_file.read()
            filename = None

        return cls.from_blob(blob, mime_type, filename)

    @property
    def blob(self):
        """The bytestream of the media "file"."""
        return self._blob

    @property
    def content_type(self):
        """MIME-type of this media, e.g. `'video/mp4'`."""
        return self._mime_type

    @property
    def ext(self):
        """Return the file extension for this video, e.g. 'mp4'.

        The extension is that from the actual filename if known. Otherwise
        it is the lowercase canonical extension for the video's MIME type.
        'vid' is used if the MIME type is 'video/unknown'.
        """
        if self._filename:
            return os.path.splitext(self._filename)[1].lstrip(".")
        return {
            CT.ASF: "asf",
            CT.AVI: "avi",
            CT.MOV: "mov",
            CT.MP4: "mp4",