|
Server : Apache System : Linux iad1-shared-b8-43 6.6.49-grsec-jammy+ #10 SMP Thu Sep 12 23:23:08 UTC 2024 x86_64 User : dh_edsupp ( 6597262) PHP Version : 8.2.26 Disable Function : NONE Directory : /lib/python3/dist-packages/django/utils/__pycache__/ |
Upload File : |
o
3�a$E � @ s� d dl Z d dlZd dlZd dlZd dlZd dlZd dlmZ d dl m
Z
d dl m Z m
Z
mZmZmZmZmZmZmZmZmZmZ d dlmZ d dlm Z d dl m Z d dl m Z e d ej!�Z"d
�#� Z$d Z%d Z&d
Z'dZ(dZ)dZ*e de%e'e(e*f �Z+e de%e'e)e*f �Z,e de'e&e*e(f �Z-dZ.dZ/e dIdd��Z0e dJdd��Z1e d d � �Z2e d d � �Z3dKd!d"�ZdLd#d$�Z4d%d&� Z5d'd(� Z6d)d*� Z7d+d,� Z8d-d.� Z9d/d0� Z:d1d2� Z;d3d4� Z<d5d6� Z=dKd7d8�Z>dKd9d:�Z?dMd<d=�Z@dMd>d?�ZAdKd@dA�ZB B DdNdEdF�ZCdGdH� ZDdS )O� N)�Error��
formatdate) � ParseResult� SplitResult� _coerce_args� _splitnetloc� _splitparams�quote�
quote_plus� scheme_chars�unquote� unquote_plus� urlencode� uses_params)�MultiValueDict)�RemovedInDjango40Warning)�keep_lazy_text)�_lazy_re_compilez�
\A( # start of string and capture group
(?:W/)? # optional weak indicator
" # opening quote
[^"]* # any sequence of non-quote characters
" # end quote
)\Z # end of string and capture group
z/jan feb mar apr may jun jul aug sep oct nov decz(?P<day>\d{2})z(?P<day>[ \d]\d)z(?P<mon>\w{3})z(?P<year>\d{4})z(?P<year>\d{2})z-(?P<hour>\d{2}):(?P<min>\d{2}):(?P<sec>\d{2})z^\w{3}, %s %s %s %s GMT$z^\w{6,9}, %s-%s-%s %s GMT$z^\w{3} %s %s %s %s$z:/?#[]@z !$&'()*+,;=�/c C � t jdtdd� t| |�S )z�
A legacy compatibility wrapper to Python's urllib.parse.quote() function.
(was used for unicode handling on Python 2)
zLdjango.utils.http.urlquote() is deprecated in favor of urllib.parse.quote().� ��
stacklevel)�warnings�warnr r
��url�safe� r �3/usr/lib/python3/dist-packages/django/utils/http.py�urlquote- �
�
r! � c C r )z�
A legacy compatibility wrapper to Python's urllib.parse.quote_plus()
function. (was used for unicode handling on Python 2)
zVdjango.utils.http.urlquote_plus() is deprecated in favor of urllib.parse.quote_plus(),r r )r r r r r r r r �
urlquote_plus; r" r$ c C � t jdtdd� t| �S )z�
A legacy compatibility wrapper to Python's urllib.parse.unquote() function.
(was used for unicode handling on Python 2)
zPdjango.utils.http.urlunquote() is deprecated in favor of urllib.parse.unquote().r r )r r r r
��
quoted_urlr r r �
urlunquoteI �
�r( c C r% )z�
A legacy compatibility wrapper to Python's urllib.parse.unquote_plus()
function. (was used for unicode handling on Python 2)
zZdjango.utils.http.urlunquote_plus() is deprecated in favor of urllib.parse.unquote_plus().r r )r r r r r& r r r �urlunquote_plusW r) r* Fc C s� t | t�r
| �� } n t| d�r| �� } g }| D ]R\}}|du r%td| ��|r.t |ttf�r1|}n1zt|�}W n tyB |}Y n w g }|D ]}|du rStd| ��t |t�s\t|�}|� |� qG|� ||f� qt
||�S )z
A version of Python's urllib.parse.urlencode() function that can operate on
MultiValueDict and non-string values.
�itemsNzjCannot encode None for key '%s' in a query string. Did you mean to pass an empty string or omit the value?) �
isinstancer �lists�hasattrr+ � TypeError�str�bytes�iter�append�original_urlencode)�query�doseq� query_params�key�value� query_val�itr�itemr r r r e s@
�� ���
r c C s t | dd�S )ao
Format the time to match the RFC1123 date format as specified by HTTP
RFC7231 section 7.1.1.1.
`epoch_seconds` is a floating point number expressed in seconds since the
epoch, in UTC - such as that outputted by time.time(). If set to None, it
defaults to the current time.
Output a string in the format 'Wdy, DD Mon YYYY HH:MM:SS GMT'.
T)�usegmtr )�
epoch_secondsr r r � http_date� s r? c
C s t ttfD ]
}|�| �}|dur nqtd| ��z^t|d �}|dk rCtj�� j}||d }||d dkr?||d 7 }n||7 }t �
|d � � �d }t|d �}t|d �}t|d
�} t|d �}
t�||||| |
�} t �
| �� �W S ty� } ztd | �| �d} ~ ww )
a
Parse a date format as specified by HTTP RFC7231 section 7.1.1.1.
The three formats allowed by the RFC are accepted, even if only the first
one is still in widespread use.
Return an integer expressed in seconds since the epoch, in UTC.
Nz%%r is not in a valid HTTP date format�year�d �2 �mon� �day�hour�min�secz%r is not a valid date)� RFC1123_DATE� RFC850_DATE� ASCTIME_DATE�match�
ValueError�int�datetime�utcnowr@ �MONTHS�index�lower�calendar�timegm� utctimetuple� Exception)
�date�regex�mr@ � current_year�current_century�monthrE rF rG rH �result�excr r r �parse_http_date� s2
� ��r` c C s zt | �W S ty Y dS w )zK
Same as parse_http_date, but return None if the input is invalid.
N)r` rW )rX r r r �parse_http_date_safe� s
�ra c C s t | �dkr
td��t| d�S )zf
Convert a base 36 string to an int. Raise ValueError if the input won't fit
into an int.
�
zBase36 input too large�$ )�lenrM rN ��sr r r �
base36_to_int� s
rg c C sV d}| dk r
t d��| dk r|| S d}| dkr)t| d�\} }|| | }| dks|S )z&Convert an integer to a base36 string.�$0123456789abcdefghijklmnopqrstuvwxyzr z!Negative base36 conversion input.rc r# )rM �divmod)�i�char_set�b36�nr r r �
int_to_base36� s �rn c C s t �| ��d��d�S )ze
Encode a bytestring to a base64 string for use in URLs. Strip any trailing
equal signs.
s
=�ascii)�base64�urlsafe_b64encode�rstrip�decodere r r r �urlsafe_base64_encode� s rt c
C sR | � � } zt�| �t| �t| �d d��W S ttfy( } zt|��d}~ww )zn
Decode a base64 encoded string. Add back any trailing equal signs that
might have been stripped.
� � =N)�encoderp �urlsafe_b64decode�ljustrd � LookupError�
BinasciiErrorrM )rf �er r r �urlsafe_base64_decode� s $��r} c C s4 | � � dkr dgS dd� | �d�D �}dd� |D �S )z�
Parse a string of ETags given in an If-None-Match or If-Match header as
defined by RFC 7232. Return a list of quoted ETags, or ['*'] if all ETags
should be matched.
�*c s s � | ]
}t �|�� �V qd S �N)�
ETAG_MATCHrL �strip)�.0�etagr r r � <genexpr> s � z parse_etags.<locals>.<genexpr>�,c S s g | ]}|r|d �qS )rD r )r� rL r r r �
<listcomp>
s z parse_etags.<locals>.<listcomp>)r� �split)�etag_str� etag_matchesr r r � parse_etags� s r� c C s t �| �r| S d| S )z�
If the provided string is already a quoted ETag, return it. Otherwise, wrap
the string in quotes, making it a strong ETag.
z"%s")r� rL )r� r r r �
quote_etag
s
r� c C s> |sdS |� � }|d dkr| �|�p | |dd� kp || kS )a4
Return ``True`` if the host is either an exact match or a match
to the wildcard pattern.
Any pattern beginning with a period matches a domain and all of its
subdomains. (e.g. ``.example.com`` matches ``example.com`` and
``foo.example.com``). Anything else is an exact string match.
Fr �.rD N)rS �endswith)�host�patternr r r �is_same_domain s &�r� c C s\ | dur| � � } | s dS |du rt� }nt|t�r |h}t| ||d�o-t| �dd�||d�S )a�
Return ``True`` if the url uses an allowed host and a safe scheme.
Always return ``False`` on an empty url.
If ``require_https`` is ``True``, only 'https' will be considered a valid
scheme, as opposed to 'http' and 'https' with the default, ``False``.
Note: "True" doesn't entail that a URL is "safe". It may still be e.g.
quoted incorrectly. Ensure to also use django.utils.encoding.iri_to_uri()
on the path component of untrusted URLs.
NF)�
require_https�\r )r� �setr, r0 � _url_has_allowed_host_and_scheme�replace�r �
allowed_hostsr� r r r � url_has_allowed_host_and_scheme+ s
�r� c C s t jdtdd� t| ||�S )Nz\django.utils.http.is_safe_url() is deprecated in favor of url_has_allowed_host_and_scheme().r r )r r r r� r� r r r � is_safe_urlH s
� r� Tc
C sf t | |�\} }}t| ||�}|\}}} }}|tv r$d| v r$t| �\} }nd}t||| |||�} || �S )a# Parse a URL into 6 components:
<scheme>://<netloc>/<path>;<params>?<query>#<fragment>
Return a 6-tuple: (scheme, netloc, path, params, query, fragment).
Note that we don't break the components up in smaller bits
(e.g. netloc is a single string) and we don't expand % escapes.�;r# )r � _urlsplitr r r )
r �scheme�allow_fragments�_coerce_result� splitresult�netlocr5 �fragment�paramsr^ r r r � _urlparseR s r� c
C s t | |�\} }}d } }}| �d�}|dkr7| d|� D ]}|tvr% nq | d|� �� | |d d� }} | dd� dkrZt| d�\}} d|v rNd |vsVd |v rZd|vrZtd
��|rhd | v rh| �d d�\} }d | v rt| �d d�\} }t||| ||�} || �S )
a Parse a URL into 5 components:
<scheme>://<netloc>/<path>?<query>#<fragment>
Return a 5-tuple: (scheme, netloc, path, query, fragment).
Note that we don't break the components up in smaller bits
(e.g. netloc is a single string) and we don't expand % escapes.r# �:r NrD r �//�[�]zInvalid IPv6 URL�#�?)r �findr rS r rM r� r )
r r� r� r� r� r5 r� rj �c�vr r r r� e s(
�" r� c C s� | � d�rdS zt| �}W n
ty Y dS w |js |jr dS t�| d �d dkr-dS |j}|js8|jr8d}|r=dgnddg}|j sJ|j|v oP| pP||v S )Nz///Fr �C�http�https)�
startswithr� rM r� r� � unicodedata�category)r r� r� �url_infor� �
valid_schemesr r r r� � s$
� �r� �utf-8r� �&c C s" t | �\} }|rt|ttf�std��|dur&d| �|� }||k r&td��dd� | �|�D �} g }
| D ]Z} | s;|s;q4| �dd�} t| �dkrY|rPtd | f ��|rX| �d
� nq4t| d �sa|r�| d � d d
�}
t
|
||d�}
||
�}
| d � d d
�}t
|||d�}||�}|
�|
|f� q4|
S )a�
Return a list of key/value tuples parsed from query string.
Backport of urllib.parse.parse_qsl() from Python 3.8.8.
Copyright (C) 2021 Python Software Foundation (see LICENSE.python).
----
Parse a query given as a string argument.
Arguments:
qs: percent-encoded query string to be parsed
keep_blank_values: flag indicating whether blank values in
percent-encoded queries should be treated as blank strings. A
true value indicates that blanks should be retained as blank
strings. The default false value indicates that blank values
are to be ignored and treated as if they were not included.
strict_parsing: flag indicating what to do with parsing errors. If false
(the default), errors are silently ignored. If true, errors raise a
ValueError exception.
encoding and errors: specify how to decode percent-encoded sequences
into Unicode characters, as accepted by the bytes.decode() method.
max_num_fields: int. If set, then throws a ValueError if there are more
than n fields read by parse_qsl().
separator: str. The symbol to use for separating the query arguments.
Defaults to &.
Returns a list, as G-d intended.
z*Separator must be of type string or bytes.NrD z Max number of fields exceededc S s g | ]}|�qS r r )r� �s1r r r r� � s z parse_qsl.<locals>.<listcomp>�=r zbad query field: %rr# r �+� )�encoding�errors) r r, r0 r1 rM �countr� rd r3 r� r
)�qs�keep_blank_values�strict_parsingr� r� �max_num_fields� separatorr� �
num_fields�pairs�r�
name_value�nv�namer9 r r r � parse_qsl� s: ' �r� c C s | � d�rd�| dd� �} | S )z�
If redirecting to an absolute path (two leading slashes), a slash must be
escaped to prevent browsers from handling the path as schemaless and
redirecting to another host.
r� z/%2F{}r N)r� �format)r r r r �escape_leading_slashes� s
r� )r )r# )Fr )r# T)FFr� r� Nr� )Erp rT rO �rer� r �binasciir r{ � email.utilsr � urllib.parser r r r r r
r r r
r r r4 r �django.utils.datastructuresr �django.utils.deprecationr �django.utils.functionalr �django.utils.regex_helperr �Xr� r� rQ �__D�__D2�__M�__Y�__Y2�__TrI rJ rK �RFC3986_GENDELIMS�RFC3986_SUBDELIMSr! r$ r( r* r? r` ra rg rn rt r} r� r� r� r� r� r� r� r� r� r� r r r r �<module> sp 8 �
)(
� M