Method _upload

praw/models/media.py:253–279

Upload the media to Reddit. :param subreddit: The subreddit the stylesheet image is associated with. :param additional_data: Additional data to include in the upload request. :returns: A dictionary containing a link to the uploaded image under the key ``img_src`

(  # pyright: ignore[reportIncompatibleMethodOverride]  # stylesheet image upload returns the raw response dict
        self, subreddit: models.Subreddit, /, **additional_data: str
    )

        return "jpg" if self._data.startswith(JPEG_HEADER) else "png"

    def _upload(  # pyright: ignore[reportIncompatibleMethodOverride]  # stylesheet image upload returns the raw response dict
        self, subreddit: models.Subreddit, /, **additional_data: str
    ) -> dict[str, Any]:
        """Upload the media to Reddit.

        :param subreddit: The subreddit the stylesheet image is associated with.
        :param additional_data: Additional data to include in the upload request.

        :returns: A dictionary containing a link to the uploaded image under the key
            ``img_src``.

        """
        data = {"img_type": self._image_type, **additional_data}
        url = self.UPLOAD_API_PATH.format(subreddit=subreddit)
        # ``requests`` accepts ``(filename, content)`` tuples for file uploads, but
        # ``Reddit.post`` types ``files`` as ``dict[str, IO]``.
        files = cast("dict[str, IO[Any]]", {"file": (self.name, self._data)})
        response = subreddit._reddit.post(url, data=data, files=files)
        if response["errors"]:
            error_type = response["errors"][0]
            error_value = response.get("errors_values", [""])[0]
            assert error_type in {
                "BAD_CSS_NAME",
                "IMAGE_ERROR",
            }, "Please file a bug with PRAW."
            raise RedditAPIException([RedditErrorItem(error_type=error_type, field="", message=error_value or "")])
        return response


class WidgetMedia(Media):