U cc)@sddlmZddlZddlZddlZddlZddlZddlZddl m Z ddl m Z ddl mZejr~ddlmZddlmZGd d d Zd d d d dZGdddeZdS)) annotationsN)date) http_date)request)Flask)Responsec@seZdZdZdddddZdddd d d Zdd ddd ddZddddddZddddddZddddddZ ddddddZ d S)! JSONProvideraA standard set of JSON operations for an application. Subclasses of this can be used to customize JSON behavior or use different JSON libraries. To implement a provider for a specific library, subclass this base class and implement at least :meth:`dumps` and :meth:`loads`. All other methods have default implementations. To use a different provider, either subclass ``Flask`` and set :attr:`~flask.Flask.json_provider_class` to a provider class, or set :attr:`app.json ` to an instance of the class. :param app: An application instance. This will be stored as a :class:`weakref.proxy` on the :attr:`_app` attribute. .. versionadded:: 2.2 rNone)appreturncCst||_dS)N)weakrefproxy_app)selfr r7/tmp/pip-unpacked-wheel-9gn0lhzs/flask/json/provider.py__init__'szJSONProvider.__init__t.Anystrobjkwargsr cKstdS)zSerialize data as JSON. :param obj: The data to serialize. :param kwargs: May be passed to the underlying JSON library. NNotImplementedError)rrrrrrdumps*szJSONProvider.dumpsz t.IO[str])rfprr cKs||j|f|dS)aSerialize data as JSON and write to a file. :param obj: The data to serialize. :param fp: A file opened for writing text. Should use the UTF-8 encoding to be valid JSON. :param kwargs: May be passed to the underlying JSON library. N)writer)rrrrrrrdump2szJSONProvider.dump str | bytessrr cKstdS)zDeserialize data as JSON. :param s: Text or UTF-8 bytes. :param kwargs: May be passed to the underlying JSON library. Nr)rr!rrrrloads<szJSONProvider.loadszt.IO[t.AnyStr])rrr cKs|j|f|S)zDeserialize data as JSON read from a file. :param fp: A file opened for reading text or UTF-8 bytes. :param kwargs: May be passed to the underlying JSON library. )r"read)rrrrrrloadDszJSONProvider.loadzt.Tuple[t.Any, ...]zt.Dict[str, t.Any]argsrr cCs8|r|rtd|s|sdSt|dkr0|dS|p6|S)Nz9app.json.response() takes either args or kwargs, not bothr) TypeErrorlen)rr&rrrr_prepare_response_objLs z"JSONProvider._prepare_response_objrcOs"|||}|jj||ddS)a(Serialize the given arguments as JSON, and return a :class:`~flask.Response` object with the ``application/json`` mimetype. The :func:`~flask.json.jsonify` function calls this method for the current application. Either positional or keyword arguments can be given, not both. If no arguments are given, ``None`` is serialized. :param args: A single value to serialize, or multiple values to treat as a list to serialize. :param kwargs: Treat as a dict to serialize. application/jsonmimetype)r*rresponse_classr)rr&rrrrrresponseZs zJSONProvider.responseN) __name__ __module__ __qualname____doc__rrrr"r$r*r/rrrrr s r r)or cCstt|trt|St|tjtjfr,t|StrDt |rDt |St |drZt| St dt|jddS)N__html__zObject of type z is not JSON serializable) isinstancerrdecimalDecimaluuidUUIDr dataclassesZ is_dataclassZasdicthasattrr5r(typer0)r4rrr_defaultms    r>c@speZdZUdZeeZded<dZdZ dZ ded<dZ d d d d d d Z dd d dddZ d d ddddZdS)DefaultJSONProvidera4Provide JSON operations using Python's built-in :mod:`json` library. Serializes the following additional data types: - :class:`datetime.datetime` and :class:`datetime.date` are serialized to :rfc:`822` strings. This is the same as the HTTP date format. - :class:`uuid.UUID` is serialized to a string. - :class:`dataclasses.dataclass` is passed to :func:`dataclasses.asdict`. - :class:`~markupsafe.Markup` (or any object with a ``__html__`` method) will call the ``__html__`` method to get a string. zt.Callable[[t.Any], t.Any]defaultTNz bool | Nonecompactr+rrrcKs|jj}tr|jjtjnd}|dk r8|jdk r8|j}|dk rzddl}|dt| d|d|j kr| d|j n| d|j |jj d}|jj d}|dk rddl}|dtn|j }|dk rddl}|d tn|j}| d || d |tj|f|S) aISerialize data as JSON to a string. Keyword arguments are passed to :func:`json.dumps`. Sets some parameter defaults from the :attr:`default`, :attr:`ensure_ascii`, and :attr:`sort_keys` attributes. :param obj: The data to serialize. :param kwargs: Passed to :func:`json.dumps`. Nrz~Setting 'json_encoder' on the app or a blueprint is deprecated and will be removed in Flask 2.3. Customize 'app.json' instead.clsr@Z JSON_AS_ASCIIZJSON_SORT_KEYSzsThe 'JSON_AS_ASCII' config key is deprecated and will be removed in Flask 2.3. Set 'app.json.ensure_ascii' instead.zqThe 'JSON_SORT_KEYS' config key is deprecated and will be removed in Flask 2.3. Set 'app.json.sort_keys' instead. ensure_ascii sort_keys)rZ _json_encoderr blueprintsget blueprintwarningswarnDeprecationWarning setdefault__dict__r@configrCrDjsonr)rrrrBbprHrCrDrrrrsB       zDefaultJSONProvider.dumpsrr cKsn|jj}tr|jjtjnd}|dk r8|jdk r8|j}|dk r`ddl}|dt| d|t j |f|S)zDeserialize data as JSON from a string or bytes. :param s: Text or UTF-8 bytes. :param kwargs: Passed to :func:`json.loads`. Nrz~Setting 'json_decoder' on the app or a blueprint is deprecated and will be removed in Flask 2.3. Customize 'app.json' instead.rB) rZ _json_decoderrrErFrGrHrIrJrKrNr")rr!rrBrOrHrrrr"s zDefaultJSONProvider.loadsrr%c Os|||}i}|jjd}|jjd}|dk rLddl}|dt| }n|j}|dkrb|jjsj|dkrx|ddn |d d |dk rddl}|d tn|j }|jj |j |f|d |d S)aSerialize the given arguments as JSON, and return a :class:`~flask.Response` object with it. The response mimetype will be "application/json" and can be changed with :attr:`mimetype`. If :attr:`compact` is ``False`` or debug mode is enabled, the output will be formatted to be easier to read. Either positional or keyword arguments can be given, not both. If no arguments are given, ``None`` is serialized. :param args: A single value to serialize, or multiple values to treat as a list to serialize. :param kwargs: Treat as a dict to serialize. ZJSONIFY_PRETTYPRINT_REGULARZJSONIFY_MIMETYPENrz|The 'JSONIFY_PRETTYPRINT_REGULAR' config key is deprecated and will be removed in Flask 2.3. Set 'app.json.compact' instead.Findentr separators),:zrThe 'JSONIFY_MIMETYPE' config key is deprecated and will be removed in Flask 2.3. Set 'app.json.mimetype' instead. r,) r*rrMrHrIrJrAdebugrKr-r.r) rr&rrZ dump_argsprettyr-rHrArrrr/s4    zDefaultJSONProvider.response)r0r1r2r3 staticmethodr>r@__annotations__rCrDrAr-rr"r/rrrrr?}s    ?r?) __future__rr;r7rNtypingtr9r datetimerZ werkzeug.httprglobalsr TYPE_CHECKINGr rwrappersrr r>r?rrrrs      Y