🔐 Sid Gifari File Manager Pro
v8.0.5 | 2026-06-14 15:43:36 | PHP 8.1.34
📂
/ (Root)
/
usr
/
lib
/
python3.9
/
site-packages
/
josepy
/
__pycache__
📍 /usr/lib/python3.9/site-packages/josepy/__pycache__
🔄 Refresh
✏️
Editing: json_util.cpython-39.pyc
Read Only
a �BgtH � @ s� d Z ddlZddlZddlZddlmZmZmZmZm Z m Z m Z m Z m Z ddlmZ ddlmZmZmZmZ e�e�Zd/eeee eegef e eegef ed�dd �ZG d d � d �ZG d d � d e�Z G dd� dej �Z e ddd�Z G dd� dej ej!e d�Z"e#ed�dd�Z$d0ee e% ee#d�dd�Z&e#ed�d d �Z'd1ee e% ee#d �d d �Z(ej)ed!�d"d#�Z*eej)d$�d%d&�Z+ej)ed'�d(d)�Z,eej)d$�d*d+�Z-e d,d-d�Z.G d.d-� d-e"�Z/dS )2z�JSON (de)serialization framework. The framework presented here is somewhat based on `Go's "json" package`_ (especially the ``omitempty`` functionality). .. _`Go's "json" package`: http://golang.org/pkg/encoding/json/ � N) �Any�Callable�Dict�Iterable�List�Mapping�Optional�Type�TypeVar)�crypto)�b64�errors� interfaces�utilF�� json_name�default� omitempty�decoder�encoder�returnc C s t | ||||d�S )a4 Convenient function to declare a :class:`Field` with proper type annotations. This function allows to write the following code: import josepy class JSON(josepy.JSONObjectWithFields): typ: str = josepy.field('type') def other_type(self) -> str: return self.typ �r r r r r )� _TypedFieldr � r �4/usr/lib/python3.9/site-packages/josepy/json_util.py�field s �r c @ s� e Zd ZdZdZd eeeee egef ee egef dd�dd�Z e eed�d d ��Z eed�d d �Z ed d �dd�Ze egef d d�dd�Ze egef d d�dd�Zeed�dd�Zeed�dd�Ze eed�dd��Ze eed�d d ��ZdS ) �Fielda� JSON object field. :class:`Field` is meant to be used together with :class:`JSONObjectWithFields`. ``encoder`` (``decoder``) is a callable that accepts a single parameter, i.e. a value to be encoded (decoded), and returns the serialized (deserialized) value. In case of errors it should raise :class:`~josepy.errors.SerializationError` (:class:`~josepy.errors.DeserializationError`). Note, that ``decoder`` should perform partial serialization only. :ivar str json_name: Name of the field when encoded to JSON. :ivar default: Default value (used when not present in JSON object). :ivar bool omitempty: If ``True`` and the field value is empty, then it will not be included in the serialized JSON object, and ``default`` will be used for deserialization. Otherwise, if ``False``, field is considered as required, value will always be included in the serialized JSON objected, and it must also be present when deserializing. )r r r �fdec�fencNFr c C s> || _ || _|| _|d u r | jn|| _|d u r4| jn|| _d S �N)r r r �default_decoderr �default_encoderr )�selfr r r r r r r r �__init__R s zField.__init__��valuer c C s t |t� o| S )z�Is the provided value considered "empty" for this field? This is useful for subclasses that might want to override the definition of being empty, e.g. for some more exotic data types. )� isinstance�bool��clsr% r r r �_emptya s z Field._emptyc C s | � |�o| jS )zOmit the value in output?)r* r �r" r% r r r �omitk s z Field.omit��kwargsr c K s0 | j | j| j| j| jd�|�}t| �f i |��S )Nr )r r r r r �type)r" r. �currentr r r �_update_paramso s ��zField._update_params)r r c C s | j |d�S )z6Descriptor to change the decoder on JSON object field.)r �r1 )r" r r r r r z s z Field.decoder)r r c C s | j |d�S )z6Descriptor to change the encoder on JSON object field.)r r2 )r" r r r r r ~ s z Field.encoderc C s | � |�S )z4Decode a value, optionally with context JSON object.)r r+ r r r �decode� s z Field.decodec C s | � |�S )z4Encode a value, optionally with context JSON object.)r r+ r r r �encode� s z Field.encodec sN t |t�r t� fdd�|D ��S t |t�rFt�� fdd�|�� D ��S |S dS )z�Default decoder. Recursively deserialize into immutable types ( :class:`josepy.util.frozendict` instead of :func:`dict`, :func:`tuple` instead of :func:`list`). c 3 s | ]}� � |�V qd S r �r )�.0Zsubvalue�r) r r � <genexpr>� � z(Field.default_decoder.<locals>.<genexpr>c s" i | ]\}}� � |�� � |��qS r r5 )r6 �keyr% r7 r r � <dictcomp>� s �z)Field.default_decoder.<locals>.<dictcomp>N)r& �list�tuple�dictr Z frozendict�itemsr( r r7 r r � s ��zField.default_decoderc C s |S )z Default (passthrough) encoder.r r( r r r r! � s zField.default_encoder)NFNN)�__name__� __module__� __qualname__�__doc__� __slots__�strr r' r r r# � classmethodr* r, r1 r r r3 r4 r r! r r r r r 7 s4 �� r c @ s e Zd ZdZdS )r a Specialized class to mark a JSON object field with typed annotations. This class is kept private because fields are supposed to be declared using the :function:`field` in this situation. In the future the :class:`Field` may be removed in favor of this one.N)r@ rA rB rC r r r r r � s r c @ sR e Zd ZU dZi Zeeef ed< e e ed< ee e eee f d d�dd�Z dS )�JSONObjectWithFieldsMetaa� Metaclass for :class:`JSONObjectWithFields` and its subclasses. It makes sure that, for any class ``cls`` with ``__metaclass__`` set to ``JSONObjectWithFieldsMeta``: 1. All fields (attributes of type :class:`Field`) in the class definition are moved to the ``cls._fields`` dictionary, where keys are field attribute names and values are fields themselves. 2. ``cls.__slots__`` is extended by all field attribute names (i.e. not :attr:`Field.json_name`). Original ``cls.__slots__`` are stored in ``cls._orig_slots``. In a consequence, for a field attribute name ``some_field``, ``cls.some_field`` will be a slot descriptor and not an instance of :class:`Field`. For example:: some_field = Field('someField', default=()) class Foo: __metaclass__ = JSONObjectWithFieldsMeta __slots__ = ('baz',) some_field = some_field assert Foo.__slots__ == ('some_field', 'baz') assert Foo._orig_slots == () assert Foo.some_field is not Field assert Foo._fields.keys() == ['some_field'] assert Foo._fields['some_field'] is some_field As an implementation note, this metaclass inherits from :class:`abc.ABCMeta` (and not the usual :class:`type`) to mitigate the metaclass conflict (:class:`ImmutableMap` and :class:`JSONDeSerializable`, parents of :class:`JSONObjectWithFields`, use :class:`abc.ABCMeta` as its metaclass). �_fields� _orig_slots)�name�bases� namespacer c C s� i }|D ]}|� t|di �� q|�� �� D ]P\}}t|t�r,t|t�rn||�di �vrntd|� d|� d���|� |�||< q,|�dd�|d< t t |d �t |� � � �|d< ||d< t j�| |||�S ) NrH �__annotations__zField `z` in JSONObject `z` has no type annotation.rD r rI )�update�getattr�copyr? r& r r �get� ValueError�popr= r< �keys�abc�ABCMeta�__new__)ZmcsrJ rK rL �fields�baser: r% r r r rW � s � z JSONObjectWithFieldsMeta.__new__N) r@ rA rB rC rH r rE r rM r r r rW r r r r rG � s ' �rG �GenericJSONObjectWithFields�JSONObjectWithFields)�boundc s� e Zd ZdZeeeef d�dd��Zedd�� fdd� Z eed �d d �Z eeef d�d d �Z eeef d�dd�Z ee eef dd�dd��Zee eef ed�dd��Zeee e eef ed�dd��Z� ZS )r[ a� JSON object with fields. Example:: class Foo(JSONObjectWithFields): bar = Field('Bar') empty = Field('Empty', omitempty=True) @bar.encoder def bar(value): return value + 'bar' @bar.decoder def bar(value): if not value.endswith('bar'): raise errors.DeserializationError('No bar suffix!') return value[:-3] assert Foo(bar='baz').to_partial_json() == {'Bar': 'bazbar'} assert Foo.from_json({'Bar': 'bazbar'}) == Foo(bar='baz') assert (Foo.from_json({'Bar': 'bazbar', 'Empty': '!'}) == Foo(bar='baz', empty='!')) assert Foo(bar='baz').bar == 'baz' �r c C s dd� | j �� D �S )zGet default fields values.c S s i | ]\}}||j �qS r )r )r6 �slotr r r r r; r9 z2JSONObjectWithFields._defaults.<locals>.<dictcomp>)rH r? r7 r r r � _defaults s z JSONObjectWithFields._defaultsNr- c s" t � jf i i | �� �|��� d S r )�superr# r_ )r" r. �� __class__r r r# s z JSONObjectWithFields.__init__)rJ r c C sB z| j | }W n" ty0 t�d�|���Y n0 |�t| |��S )z�Encode a single field. :param str name: Name of the field to be encoded. :raises errors.SerializationError: if field cannot be serialized :raises errors.Error: if field could not be found zField not found: {0})rH �KeyErrorr �Error�formatr4 rO )r" rJ r r r r r4 s zJSONObjectWithFields.encodec C s� i }t � }| j�� D ]|\}}t| |�}|�|�r@|�||f� qz|�|�||j< W q tj y� } z t� d� |||���W Y d}~qd}~0 0 q|S )zSerialize fields to JSON.z Could not encode {0} ({1}): {2}N) �setrH r? rO r, �addr4 r r ZSerializationErrorre )r" �jobjZomittedr^ r r% �errorr r r �fields_to_partial_json/ s � z+JSONObjectWithFields.fields_to_partial_jsonc C s | � � S r )rj )r" r r r �to_partial_jsonA s z$JSONObjectWithFields.to_partial_json�rh r c C sT t � }| j�� D ]$\}}|js|j|vr|�|j� q|rPt�d�d� |����d S )Nz&The following fields are required: {0}�,) rf rH r? r r rg r �DeserializationErrorre �join)r) rh �missing�_r r r r �_check_requiredD s �z$JSONObjectWithFields._check_requiredc C s� | � |� i }| j�� D ]|\}}|j|vr<|jr<|j||< q||j }z|�|�||< W q tjy� } z t�d� |||���W Y d}~qd}~0 0 q|S )z Deserialize fields from JSON.z#Could not decode {0!r} ({1!r}): {2}N) rr rH r? r r r r3 r rn re )r) rh rX r^ r r% ri r r r �fields_from_jsonP s � z%JSONObjectWithFields.fields_from_json)r) rh r c C s | f i | � |���S r )rs )r) rh r r r � from_jsonb s z JSONObjectWithFields.from_json)r@ rA rB rC rF r rE r r_ r# r4 rj rk r rr rs r rZ rt � __classcell__r r ra r r[ � s �)� metaclass)�datar c C s t �| ��d�S )zJEncode JOSE Base-64 field. :param bytes data: :rtype: `str` �ascii)r Z b64encoder3 )rw r r r �encode_b64josei s ry )rw �size�minimumr c C s� zt �| �� �}W n0 tjyB } zt�|��W Y d}~n d}~0 0 |dur||s\t|�|ksl|r|t|�|k r|t�d�|���|S )a Decode JOSE Base-64 field. :param unicode data: :param int size: Required length (after decoding). :param bool minimum: If ``True``, then `size` will be treated as minimum required length, as opposed to exact equality. :rtype: bytes Nz&Expected at least or exactly {0} bytes) r Z b64decoder4 �binasciird r rn �lenre )rw rz r{ Zdecodedri r r r �decode_b64joset s � �� �r~ r$ c C s t �| ��� S )z;Hexlify. :param bytes value: :rtype: unicode )r| Zhexlifyr3 )r% r r r � encode_hex16� s r )r% rz r{ r c C s� | � � }|dur@|s$t|�|d ks8|r@t|�|d k r@t�� �z t�|�W S tjy| } zt�|��W Y d}~n d}~0 0 dS )a Decode hexlified field. :param unicode value: :param int size: Required length (after decoding). :param bool minimum: If ``True``, then `size` will be treated as minimum required length, as opposed to exact equality. :rtype: bytes N� )r4 r} r rn r| Z unhexlifyrd )r% rz r{ Zvalue_bri r r r � decode_hex16� s ���� r� )�certr c C s* t | jtj�rtd��tt�tj| j��S )z�Encode certificate as JOSE Base-64 DER. :type cert: `OpenSSL.crypto.X509` wrapped in `.ComparableX509` :rtype: unicode z.Error input is actually a certificate request.)r& �wrappedr ZX509ReqrR ry Zdump_certificate� FILETYPE_ASN1)r� r r r � encode_cert� s r� )�b64derr c C sP zt �t�tjt| ���W S tjyJ } zt�|��W Y d}~n d}~0 0 dS )z�Decode JOSE Base-64 DER-encoded certificate. :param unicode b64der: :rtype: `OpenSSL.crypto.X509` wrapped in `.ComparableX509` N) r �ComparableX509r Zload_certificater� r~ rd r rn �r� ri r r r � decode_cert� s �r� )�csrr c C s* t | jtj�rtd��tt�tj| j��S )zEncode CSR as JOSE Base-64 DER. :type csr: `OpenSSL.crypto.X509Req` wrapped in `.ComparableX509` :rtype: unicode z&Error input is actually a certificate.)r& r� r ZX509rR ry Zdump_certificate_requestr� )r� r r r � encode_csr� s r� c C sP zt �t�tjt| ���W S tjyJ } zt�|��W Y d}~n d}~0 0 dS )z�Decode JOSE Base-64 DER-encoded CSR. :param unicode b64der: :rtype: `OpenSSL.crypto.X509Req` wrapped in `.ComparableX509` N) r r� r Zload_certificate_requestr� r~ rd r rn r� r r r � decode_csr� s �r� � GenericTypedJSONObjectWithFields�TypedJSONObjectWithFieldsc @ s� e Zd ZU dZeZeed< dZeed< eZ e ee f ed< e de e ee e e d�dd ��Ze eeef e d d �d d ��Ze eef d �dd�Ze eeef d d �dd��ZdS )r� zJSON object with type.�typr/ �type_field_name�TYPESN)�type_clsr� r c C s |du r|j n|}|| j|< |S )z(Register class for JSON deserialization.N)r� r� )r) r� r� r r r �register� s z"TypedJSONObjectWithFields.registerrl c C s� | | j �� v r.| j|vr*t�d�| j���| S t|t�sHt�d�|���z|| j }W n tyr t�d��Y n0 z | j | W S ty� t� ||��Y n0 dS )z&Get the registered class for ``jobj``.zMissing type field ({0})z {0} is not a dictionary objectzmissing type fieldN) r� �valuesr� r rn re r& r> rc ZUnrecognizedTypeError)r) rh r� r r r � get_type_cls s � z&TypedJSONObjectWithFields.get_type_clsr] c C s | � � }| j|| j< |S )a Get JSON serializable object. :returns: Serializable JSON object representing ACME typed object. :meth:`validate` will almost certainly not work, due to reasons explained in :class:`josepy.interfaces.IJSONSerializable`. :rtype: dict )rj r� r� )r" rh r r r rk s z)TypedJSONObjectWithFields.to_partial_jsonc C s | � |�}|f i |�|���S )z�Deserialize ACME object from valid JSON object. :raises josepy.errors.UnrecognizedTypeError: if type of the ACME object has not been registered. )r� rs )r) rh r� r r r rt ( s z#TypedJSONObjectWithFields.from_json)N)r@ rA rB rC �NotImplementedr� rE rM r� r� r r rF r� r r� r r r� rk rt r r r r r� � s � � )NFNN)NF)NF)0rC rU r| Zlogging�typingr r r r r r r r r ZOpenSSLr Zjosepyr r r r Z getLoggerr@ �loggerrE r' r r r rV rG rZ Z ImmutableMapZJSONDeSerializabler[ �bytesry �intr~ r r� r� r� r� r� r� r� r� r r r r �<module> sL , �� q F �o �
💾 Save Changes
❌ Cancel