|
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
��IhL> � @ s� d dl Zd dlZd dlZd dlZd dlZd dlmZ d dlm Z d dl
m Z d dl m
Z
d dlmZmZmZ d dlmZ d dlmZmZmZ ed d
� �Zed ej�Zed ej�Z G d
d� d�Z G dd� d�Z e Z edej�Z edej�Z!ed�Z"ed�Z#edd� �Z$G dd� de�Z%edd� �Z&eed�fd d ��Z'ed d � �Z(ed d!� �Z)d"d#� Z*G d$d%� d%e �Z+d&d'� Z,ed(ej-�Z.d)d*� Z/d+d,� Z0ed-�Z1ed.d/� �Z2ed0d1� �Z3ed9d3d4��Z4d5d6� Z5d7d8� Z6ee6e7�Z8dS ):� N)�GzipFile)�BytesIO)�SuspiciousFileOperation)�RemovedInDjango40Warning)�SimpleLazyObject�keep_lazy_text�lazy)�_lazy_re_compile)�gettext� gettext_lazy�pgettextc C s$ | ot | �d �� t | �dd� S )z(Capitalize the first letter of a string.r � N)�str�upper)�x� r �3/usr/lib/python3/dist-packages/django/utils/text.py�capfirst s $r z
([^<>\s]+)z <|([^<>\s]+)c @ s e Zd Zedd� �ZdS )�
WordsRegexc C sn t �| |�}|d u s|d d ur|S | �d|�d��}|dk r't�| |d �S |d7 }t| |�d�|� |�S )Nr
�>r )�re_prt�search�find�end�re_notag� FakeMatch�start)�text�pos�partialr r r r r & s zWordsRegex.searchN)�__name__�
__module__� __qualname__� staticmethodr r r r r r % s r c @ s. e Zd ZddgZd dd�Zdd� Zdd � Zd
S ) r �_text�_endr c C s |dksJ d��| j S )Nr z'This specific object takes only group=0)r% ��self�groupr r r r ; s z
FakeMatch.endc C s" |dkrd S |dksJ d��| j S )Nr
r z.This specific object takes only group in {0,1})r$ r& r r r � __getitem__? s zFakeMatch.__getitem__c C s ||| _ | _d S �N)r$ r% )r' r r r r r �__init__E s zFakeMatch.__init__N)r )r r! r" � __slots__r r) r+ r r r r r 8 s
r z <[^>]+?>|(.)z <(/)?(\S+?)(?:(\s*/)|\s.*?)?>z\r\n|\rz&(((?<=[a-z])[A-Z])|([A-Z](?![A-Z]|$)))c C s> t j|ddd�}g }| �d�D ]
}|�|�|�� qd�|�S )aC
A word-wrap function that preserves existing line breaks. Expects that
existing line breaks are posix newlines.
Preserve all white space except added line breaks consume the space on
which they break the line.
Don't wrap long words, thus the output text may have lines longer than
``width``.
F)�width�break_long_words�break_on_hyphensT�
)�textwrap� TextWrapper�
splitlines�extend�wrap�join)r r- �wrapper�result�liner r r r5 S s �
r5 c sZ e Zd ZdZdZ� fdd�Zddd�Zdd d
�Zd d � Zdd
d�Z dd� Z
dd� Z � Z S )� Truncatorz�
An object used to truncate text, either by characters or words.
When truncating HTML text (either chars or words), input will be limited to
at most `MAX_LENGTH_HTML` characters.
i@KL c s t � �� fdd�� d S )Nc s t � �S r* �r r �r r r �<lambda>v s z$Truncator.__init__.<locals>.<lambda>)�superr+ )r' r �� __class__r< r r+ u s zTruncator.__init__Nc C s@ |d u r t dd�}d|v r|d|i S |�|�r|S d||f S )Nz%String to return when truncating textu %(truncated_text)s…z%(truncated_text)s�truncated_textz%s%s)r �endswith)r' r �truncater r r �add_truncation_textx s �
z Truncator.add_truncation_textFc C sx | � � t|�}t�d| j�}|}| �d|�D ]}t�|�s(|d8 }|dkr( nq|r4| �||||d�S | �||||�S )a
Return the text truncated to be no longer than the specified number
of characters.
`truncate` specifies what should be used to notify that the string has
been truncated, defaulting to a translatable string of an ellipsis.
�NFC� r
r F) �_setup�int� unicodedata� normalize�_wrappedrD � combining�_truncate_html� _text_chars)r' �numrC �html�lengthr � truncate_len�charr r r �chars� s
�zTruncator.charsc C sj d}d}t |�D ]*\}}t�|�rq|d7 }|du r ||kr |}||kr2| �|d|p+d� |� S q|S )z2Truncate a string after a certain number of chars.r Nr
)� enumeraterI rL rD ) r' rQ rC r rR �s_len� end_index�irS r r r rN � s
��zTruncator._text_charsc C s4 | � � t|�}|r| �||| j|d�S | �||�S )z�
Truncate a string after a certain number of words. `truncate` specifies
what should be used to notify that the string has been truncated,
defaulting to ellipsis.
T)rG rH rM rK � _text_words)r' rO rC rP rQ r r r �words� s
zTruncator.wordsc C s> | j �� }t|�|kr|d|� }| �d�|�|�S d�|�S )zk
Truncate a string after a certain number of words.
Strip newlines in the string.
N� )rK �split�lenrD r6 )r' rQ rC rZ r r r rY � s
zTruncator._text_wordsc C s| |r|dkrdS d}t |�| jkr|d| j� }d}d}d}d} d}
g } |r(tnt} |
|kr�| �||�}
|
s7nZ|
�d�}|
d rK|
d7 }
|
|krJ|} q*t�|
d �}|rX|
|krYq*|�� \}}}|� � }|sj||v rkn"|r�z| �
|�}W n t y} Y nw | |d d� } n| � d|� |
|ks.| �
d|�}|
|kr�|r�|r�||7 }|S |d| � }|r�||7 }| D ]}|d| 7 }q�|S ) a
Truncate HTML to a certain number of chars (not counting tags and
comments), or, if words is True, then to a certain number of words.
Close opened tags if they were correctly closed in the given HTML.
Preserve newlines in the HTML.
r rF FNT) �br�col�link�base�img�param�area�hr�inputr
z</%s>)r] �MAX_LENGTH_HTML�re_words�re_charsr r �re_tag�match�groups�lower�index�
ValueError�insertrD )r' rQ rC r rR rZ � size_limited�html4_singletsr � end_text_pos� current_len� open_tags�regex�m�tag� closing_tag�tagname� self_closingrX �
truncate_text�outr r r rM � sb
� � $ zTruncator._truncate_htmlr* )NF)
r r! r" �__doc__rg r+ rD rT rN rZ rY rM �
__classcell__r r r? r r: j s
r: c C s: t | ��� �dd�}t�dd|�}|dv rtd| ��|S )aY
Return the given string converted to a string that can be used for a clean
filename. Remove leading and trailing spaces; convert other spaces to
underscores; and remove anything that is not an alphanumeric, dash,
underscore, or dot.
>>> get_valid_filename("john's portrait in 2004.jpg")
'johns_portrait_in_2004.jpg'
r[ �_z (?u)[^-\w.]rF > �..rF �.z$Could not derive file name from '%s')r �strip�replace�re�subr )�name�sr r r �get_valid_filename s
r� �orc C sV | sdS t | �dkrt| d �S dtd��dd� | dd � D ��t|�t| d �f S )
a
>>> get_text_list(['a', 'b', 'c', 'd'])
'a, b, c or d'
>>> get_text_list(['a', 'b', 'c'], 'and')
'a, b and c'
>>> get_text_list(['a', 'b'], 'and')
'a and b'
>>> get_text_list(['a'])
'a'
>>> get_text_list([])
''
rF r
r z%s %s %sz, c s s � | ]}t |�V qd S r* r; )�.0rX r r r � <genexpr>A s � z get_text_list.<locals>.<genexpr>N���)r] r r� r6 )�list_� last_wordr r r �
get_text_list- s .�r� c C s t �dt| ��S )z*Normalize CRLF and CR newlines to just LF.r0 )� re_newlinesr� r r< r r r �normalize_newlinesE s r� c s� i dd�dd�dd�dd�dd�dd�d d
�d d
�d d
�d
d�dd�dd�dd�dd�dd�dd�dd�dddddddddd� �� d� � fd d �| �� D ��S ) z@Convert a phone number with letters into its numeric equivalent.�a�2�b�c�d�3�e�f�g�4�hrX �j�5�k�lrw �6�n�o�p�7�q�8�9) �rr� �t�u�v�wr �y�zrF c 3 s � | ] }� � ||�V qd S r* )�get)r� r� �� char2numberr r r� T s � z phone2numeric.<locals>.<genexpr>)r6 rm )�phoner r� r �
phone2numericK sN �����������������
� r� c C sN t � }tdd|dd��}|�| � W d � |�� S 1 s w Y |�� S �N�wb� r )�mode�
compresslevel�fileobj�mtime)r r �write�getvalue)r� �zbuf�zfiler r r �compress_stringY s
��r� c @ s e Zd Zdd� ZdS )�StreamingBufferc C s | � � }| �d� | �� |S )Nr )r� �seekrC )r' �retr r r �reada s
zStreamingBuffer.readN)r r! r" r� r r r r r� ` s r� c c sv � t � }tdd|dd�� }|�� V | D ]}|�|� |�� }|r$|V qW d � n1 s/w Y |�� V d S r� )r� r r� r� )�sequence�bufr� �item�datar r r �compress_sequencei s �
�� �r� z�
((?:
[^\s'"]*
(?:
(?:"(?:[^"\\]|\\.)*" | '(?:[^'\\]|\\.)*')
[^\s'"]*
)+
) | \S+)
c c s$ � t �t| ��D ]}|d V qdS )a�
Generator that splits a string by spaces, leaving quoted phrases together.
Supports both single and double quotes, and supports escaping quotes with
backslashes. In the output, strings will keep their initial and trailing
quote marks and escaped quotes will remain escaped (the results can then
be further processed with unescape_string_literal()).
>>> list(smart_split(r'This is "a person\'s" test.'))
['This', 'is', '"a person\\\'s"', 'test.']
>>> list(smart_split(r"Another 'person\'s' test."))
['Another', "'person\\'s'", 'test.']
>>> list(smart_split(r'A "\"funky\" style" test.'))
['A', '"\\"funky\\" style"', 'test.']
r N)�smart_split_re�finditerr )r �bitr r r � smart_split� s � �r� c C s� | d }|d dkr7|dd � }z|d dv r!t |dd � d�}nt |�}t|�W S ty6 | d Y S w z ttjj| �W S tyM | d Y S w )Nr
r �#�xX� )rH �chrro rP �entities�name2codepoint�KeyError)rk r r� r r r �_replace_entity� s
� �r� z#&(#?[xX]?(?:[0-9a-fA-F]+|\w{1,8}));c C s t jdtdd� t�tt| ��S )NzPdjango.utils.text.unescape_entities() is deprecated in favor of html.unescape().� )�
stacklevel)�warnings�warnr �
_entity_rer� r� r r< r r r �unescape_entities� s
�r� c C sP | d dvs| d | d krt d| ��| d }| dd� �d| |��dd�S ) al
Convert quoted string literals to unquoted strings with escaped quotes and
backslashes unquoted::
>>> unescape_string_literal('"abc"')
'abc'
>>> unescape_string_literal("'abc'")
'abc'
>>> unescape_string_literal('"a \"bc\""')
'a "bc"'
>>> unescape_string_literal("'\'ab\' c'")
"'ab' c"
r z"'r� zNot a string literal: %rr
z\%sz\\�\)ro r� )r� �quoter r r �unescape_string_literal� s r� Fc C sZ t | �} |r
t�d| �} n
t�d| ��dd��d�} t�dd| �� �} t�dd| ��d �S )
a
Convert to ASCII if 'allow_unicode' is False. Convert spaces or repeated
dashes to single dashes. Remove characters that aren't alphanumerics,
underscores, or hyphens. Convert to lowercase. Also strip leading and
trailing whitespace, dashes, and underscores.
�NFKC�NFKD�ascii�ignorez[^\w\s-]rF z[-\s]+�-z-_) r rI rJ �encode�decoder� r� rm r� )�value�
allow_unicoder r r �slugify� s r� c C s t �d| ��� �� S )zQ
Split CamelCase and convert to lowercase. Strip surrounding whitespace.
z \1)�
re_camel_caser� r� rm )r� r r r �camel_case_to_spaces� s r� c O s | j |i |��S )zk
Apply str.format() on 'format_string' where format_string, args,
and/or kwargs might be lazy.
)�format)�
format_string�args�kwargsr r r � _format_lazy� s r� )F)9�
html.entitiesrP r� r1 rI r� �gzipr �ior �django.core.exceptionsr �django.utils.deprecationr �django.utils.functionalr r r �django.utils.regex_helperr �django.utils.translationr
r� r r r �Sr r r r rh ri rj r� r� r5 r: r� r� r� r� r� r� r� �VERBOSEr� r� r� r� r� r� r� r� r� r � format_lazyr r r r �<module> sj
3
�