PHP 8.0.30
Preview: formdata.py Size: 5.98 KB
/opt/alt/python37/lib64/python3.7/site-packages/aiohttp/formdata.py

import io
from typing import Any, Iterable, List, Optional
from urllib.parse import urlencode

from multidict import MultiDict, MultiDictProxy

from . import hdrs, multipart, payload
from .helpers import guess_filename
from .payload import Payload

__all__ = ("FormData",)


class FormData:
    """Helper class for form body generation.

    Supports multipart/form-data and application/x-www-form-urlencoded.
    """

    def __init__(
        self,
        fields: Iterable[Any] = (),
        quote_fields: bool = True,
        charset: Optional[str] = None,
    ) -> None:
        self._writer = multipart.MultipartWriter("form-data")
        self._fields = []  # type: List[Any]
        self._is_multipart = False
        self._is_processed = False
        self._quote_fields = quote_fields
        self._charset = charset

        if isinstance(fields, dict):
            fields = list(fields.items())
        elif not isinstance(fields, (list, tuple)):
            fields = (fields,)
        self.add_fields(*fields)

    @property
    def is_multipart(self) -> bool:
        return self._is_multipart

    def add_field(
        self,
        name: str,
        value: Any,
        *,
        content_type: Optional[str] = None,
        filename: Optional[str] = None,
        content_transfer_encoding: Optional[str] = None,
    ) -> None:

        if isinstance(value, io.IOBase):
            self._is_multipart = True
        elif isinstance(value, (bytes, bytearray, memoryview)):
            if filename is None and content_transfer_encoding is None:
                filename = name

        type_options = MultiDict({"name": name})  # type: MultiDict[str]
        if filename is not None and not isinstance(filename, str):
            raise TypeError(
                "filename must be an instance of str. " "Got: %s" % filename
            )
        if filename is None and isinstance(value, io.IOBase):
            filename = guess_filename(value, name)
        if filename is not None:
            type_options["filename"] = filename
            self._is_multipart = True

        headers = {}
        if content_type is not None:
            if not isinstance(content_type, str):
                raise TypeError(
                    "content_type must be an instance of str. " "Got: %s" % content_type
                )
            headers[hdrs.CONTENT_TYPE] = content_type
            self._is_multipart = True
        if content_transfer_encoding is not None:
            if not isinstance(content_transfer_encoding, str):
                raise TypeError(
                    "content_transfer_encoding must be an instance"
                    " of str. Got: %s" % content_transfer_encoding
                )
            headers[hdrs.CONTENT_TRANSFER_ENCODING] = content_transfer_encoding
            self._is_multipart = True

        self._fields.append((type_options, headers, value))

    def add_fields(self, *fields: Any) -> None:
        to_add = list(fields)

        while to_add:
            rec = to_add.pop(0)

            if isinstance(rec, io.IOBase):
                k = guess_filename(rec, "unknown")
                self.add_field(k, rec)  # type: ignore[arg-type]

            elif isinstance(rec, (MultiDictProxy, MultiDict)):
                to_add.extend(rec.items())

            elif isinstance(rec, (list, tuple)) and len(rec) == 2:
                k, fp = rec
                self.add_field(k, fp)  # type: ignore[arg-type]

            else:
                raise TypeError(
                    "Only io.IOBase, multidict and (name, file) "
                    "pairs allowed, use .add_field() for passing "
                    "more complex parameters, got {!r}".format(rec)
                )

    def _gen_form_urlencoded(self) -> payload.BytesPayload:
        # form data (x-www-form-urlencoded)
        data = []
        for type_options, _, value in self._fields:
            data.append((type_options["name"], value))

        charset = self._charset if self._charset is not None else "utf-8"

        if charset == "utf-8":
            content_type = "application/x-www-form-urlencoded"
        else:
            content_type = "application/x-www-form-urlencoded; " "charset=%s" % charset

        return payload.BytesPayload(
            urlencode(data, doseq=True, encoding=charset).encode(),
            content_type=content_type,
        )

    def _gen_form_data(self) -> multipart.MultipartWriter:
        """Encode a list of fields using the multipart/form-data MIME format"""
        if self._is_processed:
            raise RuntimeError("Form data has been processed already")
        for dispparams, headers, value in self._fields:
            try:
                if hdrs.CONTENT_TYPE in headers:
                    part = payload.get_payload(
                        value,
                        content_type=headers[hdrs.CONTENT_TYPE],
                        headers=headers,
                        encoding=self._charset,
                    )
                else:
                    part = payload.get_payload(
                        value, headers=headers, encoding=self._charset
                    )
            except Exception as exc:
                raise TypeError(
                    "Can not serialize value type: %r\n "
                    "headers: %r\n value: %r" % (type(value), headers, value)
                ) from exc

            if dispparams:
                part.set_content_disposition(
                    "form-data", quote_fields=self._quote_fields, **dispparams
                )
                # FIXME cgi.FieldStorage doesn't likes body parts with
                # Content-Length which were sent via chunked transfer encoding
                assert part.headers is not None
                part.headers.popall(hdrs.CONTENT_LENGTH, None)

            self._writer.append_payload(part)

        self._is_processed = True
        return self._writer

    def __call__(self) -> Payload:
        if self._is_multipart:
            return self._gen_form_data()
        else:
            return self._gen_form_urlencoded()

Directory Contents

Dirs: 2 × Files: 64

Name Size Perms Modified Actions
.hash DIR
- drwxr-xr-x 2023-12-06 03:19:40
Edit Download
- drwxr-xr-x 2023-12-06 03:19:40
Edit Download
5.38 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
2.64 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
43.87 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
9.06 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
8.00 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
36.02 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
10.29 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
49.66 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
13.25 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
5.98 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
4.61 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
25.63 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
1.78 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
2.53 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
31.83 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
24.76 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
5.84 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
1.13 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
325 B lrw-r--r-- 2021-11-14 20:05:00
Edit Download
31.68 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
13.38 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
2.06 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
7 B lrw-r--r-- 2021-11-14 20:05:00
Edit Download
11.50 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
4.97 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
20.35 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
962 B lrw-r--r-- 2021-11-14 20:05:00
Edit Download
20.72 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
14.95 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
1.72 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
17.51 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
16.86 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
9.87 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
10.53 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
7.39 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
4.04 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
22.02 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
27.23 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
26.92 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
5.90 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
10.93 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
2.01 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
38.62 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
16.85 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
8.57 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
4.88 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
183.17 KB lrw-r--r-- 2021-11-14 20:05:14
Edit Download
170 B lrw-r--r-- 2021-11-14 20:05:00
Edit Download
68 B lrw-r--r-- 2021-11-14 20:05:00
Edit Download
1.96 KB lrw-r--r-- 2021-11-14 20:05:14
Edit Download
207.99 KB lrw-r--r-- 2021-11-14 20:05:15
Edit Download
66.12 KB lrwxr-xr-x 2023-11-14 11:36:54
Edit Download
202 B lrw-r--r-- 2021-11-14 20:05:00
Edit Download
1.02 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
955.26 KB lrw-r--r-- 2021-11-14 20:05:16
Edit Download
523.54 KB lrwxr-xr-x 2023-11-14 11:36:54
Edit Download
25.95 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
216.08 KB lrw-r--r-- 2021-11-14 20:05:14
Edit Download
61.20 KB lrwxr-xr-x 2023-11-14 11:36:54
Edit Download
4.47 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
135.18 KB lrw-r--r-- 2021-11-14 20:05:15
Edit Download
37.37 KB lrwxr-xr-x 2023-11-14 11:36:54
Edit Download
1.52 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download
6.71 KB lrw-r--r-- 2021-11-14 20:05:00
Edit Download

If ZipArchive is unavailable, a .tar will be created (no compression).