HEX

File: //lib/python3.10/__pycache__/cgi.cpython-310.pyc
o

E�h3��@s`dZdZddlmZmZmZddlmZddlZddl	Z	ddl
Zddlm
Z
ddlmZddlZddlZddlZddlZgd�Zd	adad
d�Zdd
�Zdd�Zdd�Zeadade	jdddfdd�Zd2dd�Zdd�Z dd�Z!Gdd�d�Z"Gdd �d �Z#e	jfd!d"�Z$d3d#d$�Z%e	jfd%d&�Z&d'd(�Z'd)d*�Z(d+d,�Z)d-d.�Z*d/d0�Z+e,d1kr�e$�dSdS)4z�Support module for CGI (Common Gateway Interface) scripts.

This module defines a number of utilities for use by CGI scripts
written in Python.
z2.6�)�StringIO�BytesIO�
TextIOWrapper)�MappingN)�
FeedParser)�Message)�MiniFieldStorage�FieldStorage�parse�parse_multipart�parse_header�test�print_exception�
print_environ�
print_form�print_directory�print_arguments�print_environ_usage�cGsXtjdtdd�trtsz	ttddd�aWn	tyYnwts$tant	at|�dS)a�Write a log message, if there is a log file.

    Even though this function is called initlog(), you should always
    use log(); log is a variable that is set either to initlog
    (initially), to dolog (once the log file has been opened), or to
    nolog (when logging is disabled).

    The first argument is a format string; the remaining arguments (if
    any) are arguments to the % operator, so e.g.
        log("%s: %s", "a", "b")
    will write "a: b" to the log file, followed by a newline.

    If the global logfp is not None, it should be a file object to
    which log data is written.

    If the global logfp is None, the global logfile may be a string
    giving a filename to open, in append mode.  This file should be
    world writable!!!  If the file can't be opened, logging is
    silently disabled (since there is no safe place where we could
    send an error message).

    z7cgi.log() is deprecated as of 3.10. Use logging instead�)�
stacklevel�a�locale)�encodingN)
�warnings�warn�DeprecationWarning�logfile�logfp�open�OSError�nolog�log�dolog��allargs�r&�/usr/lib/python3.10/cgi.py�initlog9s��r(cGst�||d�dS)z=Write a log message to the log file.  See initlog() for docs.�
N)r�write)�fmt�argsr&r&r'r#^sr#cGsdS)z9Dummy function, assigned to log when logging is disabled.Nr&r$r&r&r'r!bsr!cCsdatr
t��datadS)zClose the log file.rN)rr�closer(r"r&r&r&r'�closelogfs
r.�&c
CsV|durtj}t|d�r|j}nd}t|t�r|j}d|vr"d|d<|ddkr�t|d�\}}|dkr;t|||d	�S|d
krXt	|d�}t
rO|t
krOtd��|�|��
|�}	nd
}	d|vrk|	rd|	d}	|	|d}	ntjdd�r|	rx|	d}	|	tjd}	|	|d<nd|vr�|d}	ntjdd�r�tjd}	nd
}	|	|d<tjj|	||||d�S)a�Parse a query in the environment or from a file (default stdin)

        Arguments, all optional:

        fp              : file pointer; default: sys.stdin.buffer

        environ         : environment dictionary; default: os.environ

        keep_blank_values: flag indicating whether blank values in
            percent-encoded forms 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.

        separator: str. The symbol to use for separating the query arguments.
            Defaults to &.
    Nrzlatin-1�REQUEST_METHOD�GET�POST�CONTENT_TYPEzmultipart/form-data)�	separator�!application/x-www-form-urlencoded�CONTENT_LENGTH�Maximum content length exceededr�QUERY_STRINGr/�)rr4)�sys�stdin�hasattrr�
isinstancer�bufferrr�int�maxlen�
ValueError�read�decode�argv�urllibr
�parse_qs)
�fp�environ�keep_blank_values�strict_parsingr4r�ctype�pdict�clength�qsr&r&r'r
ysF



�r
�utf-8�replacecsv|d�d�}d�|�}t�}|�|�z|d|d<Wn	ty%Ynwt||||ddi|d���fd	d
��D�S)a�Parse multipart input.

    Arguments:
    fp   : input file
    pdict: dictionary containing other parameters of content-type header
    encoding, errors: request encoding and error handler, passed to
        FieldStorage

    Returns a dictionary just like parse_qs(): keys are the field names, each
    value is a list of values for that field. For non-file fields, the value
    is a list of strings.
    �boundary�asciiz multipart/form-data; boundary={}zCONTENT-LENGTHzContent-Lengthr0r2)�headersr�errorsrHr4csi|]}|��|��qSr&)�getlist)�.0�k��fsr&r'�
<dictcomp>�sz#parse_multipart.<locals>.<dictcomp>)rC�formatr�set_type�KeyErrorr	)rGrLrrTr4rQrKrSr&rXr'r�s

�
�rccs��|dd�dkrg|dd�}|�d�}|dkrD|�dd|�|�dd|�drD|�d|d�}|dkrD|�dd|�|�dd|�ds(|dkrLt|�}|d|�}|��V||d�}|dd�dks	dSdS)Nr9�;r�"�\"r)�find�count�len�strip)�s�end�fr&r&r'�_parseparam�s�
((�
�rhcCs�td|�}|��}i}|D]I}|�d�}|dkrW|d|�����}||dd���}t|�dkrS|d|dkrAdkrSnn|dd�}|�d	d
��dd�}|||<q||fS)zfParse a Content-type like header.

    Return the main content-type and a dictionary of options.

    r^�=rNr9r���r_z\\�\r`)rh�__next__rard�lowerrcrP)�line�parts�keyrL�p�i�name�valuer&r&r'r�s
,�rc@s@eZdZdZdZdZdZdZiZdZ	iZ
iZdd�Zdd�Z
dS)rz=Like FieldStorage, for use when no file uploads are possible.NcCs||_||_dS)z&Constructor from field name and value.N�rsrt��selfrsrtr&r&r'�__init__s
zMiniFieldStorage.__init__cCsd|j|jfS)z Return printable representation.zMiniFieldStorage(%r, %r)ru�rwr&r&r'�__repr__szMiniFieldStorage.__repr__)�__name__�
__module__�__qualname__�__doc__�filename�list�type�file�type_options�disposition�disposition_optionsrSrxrzr&r&r&r'r�src@s�eZdZdZdddejdddddddfdd	�Zd
d�Zdd
�Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
d;dd�Zd;dd�Zdd�Zdd�Zd d!�Zd"d#�Zd$d%�Zd&d'�ZdZd(d)�Zd*d+�Zd,Zd-d.�Zd/d0�Zd1d2�Zd3d4�Zd5d6�Zd7d8�Zd9d:�Z dS)<r	a�Store a sequence of fields, reading multipart/form-data.

    This class provides naming, typing, files stored on disk, and
    more.  At the top level, it is accessible like a dictionary, whose
    keys are the field names.  (Note: None can occur as a field name.)
    The items are either a Python list (if there's multiple values) or
    another FieldStorage or MiniFieldStorage object.  If it's a single
    object, it has the following attributes:

    name: the field name, if specified; otherwise None

    filename: the filename, if specified; otherwise None; this is the
        client side filename, *not* the file name on which it is
        stored (that's a temporary file you don't deal with)

    value: the value as a *string*; for file uploads, this
        transparently reads the file every time you request the value
        and returns *bytes*

    file: the file(-like) object from which you can read the data *as
        bytes* ; None if the data is stored a simple string

    type: the content-type, or None if not specified

    type_options: dictionary of options specified on the content-type
        line

    disposition: content-disposition, or None if not specified

    disposition_options: dictionary of corresponding options

    headers: a dictionary(-like) object (sometimes email.message.Message or a
        subclass thereof) containing *all* headers

    The class is subclassable, mostly for the purpose of overriding
    the make_file() method, which is called internally to come up with
    a file open for reading and writing.  This makes it possible to
    override the default choice of storing all files in a temporary
    directory and unlinking them as soon as they have been opened.

    N�rrOrPr/cCsJd}||_||_|
|_||_d|vr|d��}d|_|dks#|dkrOd|vr,|d}
ntjdd�r9tjd}
nd}
|
�t	�
�d�}
t|
�}|durOd	d
i}|dur{i}|dkr]d
|d	<d|vrg|d|d	<d|vrp|d|_d
|vrz|d
|d<nt|t
tf�s�td��||_|dur�tjj|_nt|t�r�|j|_nt|d�r�t|d�s�td��||_||_|	|_t|t�s�tdt|�j��||_d|_||_di}}d|jvr�t|jd�\}}||_||_ d|_!d|vr�|d|_!d|_"d|vr�|d|_"|j"du|_#d	|jv�rt|jd	�\}}n|j�s|dk�r!di}}nd
i}}||_||_$d|v�r=|d�|j|j�|_%nd|_%d}d|jv�rhz	t&|jd�}Wn
t'�y[Ynwt(�rh|t(k�rht'd��||_)|jdu�ry|dk�ry||_d|_*|_+d|_,|d
k�r�|�-�dS|dd�dk�r�|�.|||�dS|�/�dS)a$Constructor.  Read multipart/* until last part.

        Arguments, all optional:

        fp              : file pointer; default: sys.stdin.buffer
            (not used when the request method is GET)
            Can be :
            1. a TextIOWrapper object
            2. an object whose read() and readline() methods return bytes

        headers         : header dictionary-like object; default:
            taken from environ as per CGI spec

        outerboundary   : terminating multipart boundary
            (for internal use only)

        environ         : environment dictionary; default: os.environ

        keep_blank_values: flag indicating whether blank values in
            percent-encoded forms 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.

        limit : used internally to read parts of multipart/form-data forms,
            to exit from the reading loop when reached. It is the difference
            between the form content-length and the number of bytes already
            read

        encoding, errors : the encoding and error handler used to decode the
            binary stream to strings. Must be the same as the charset defined
            for the page sending the form (content-type : meta http-equiv or
            header)

        max_num_fields: int. If set, then __init__ throws a ValueError
            if there are more than n fields read by parse_qsl().

        r1r0N�HEADr8r9r�surrogateescapezcontent-typer5r2r3r6�content-lengthz?headers must be mapping or an instance of email.message.MessagerB�readlinezfp must be file pointerz#outerboundary must be bytes, not %srzcontent-dispositionrsrz
text/plainrQr�rjr7�
z
multipart/)0rIrJ�max_num_fieldsr4�upper�
qs_on_postr:rD�encoder�getpreferredencodingrr=rr�	TypeErrorrSr;r>rGrr<rrT�bytesr�r{�
outerboundary�
bytes_read�limitrr�r�rsr�_binary_filer��
innerboundaryr?rAr@�lengthr�r��done�read_urlencoded�
read_multi�read_single)rwrGrSr�rHrIrJr�rrTr�r4�methodrN�cdisprLrK�clenr&r&r'rxBs�/
�
�


�





��
zFieldStorage.__init__cCs&z|j��WdStyYdSw�N)r�r-�AttributeErrorryr&r&r'�__del__�s
�zFieldStorage.__del__cCs|Sr�r&ryr&r&r'�	__enter__�szFieldStorage.__enter__cGs|j��dSr�)r�r-)rwr,r&r&r'�__exit__�szFieldStorage.__exit__cCsd|j|j|jfS)z"Return a printable representation.zFieldStorage(%r, %r, %r))rsrrtryr&r&r'rz�s�zFieldStorage.__repr__cC�t|���Sr�)�iter�keysryr&r&r'�__iter__��zFieldStorage.__iter__cCsX|dkrt|��|jr|j�d�|j��}|j�d�|S|jdur(|j}|Sd}|S)Nrtr)r�r��seekrBr�rvr&r&r'�__getattr__�s

��zFieldStorage.__getattr__cCsZ|jdur	td��g}|jD]}|j|kr|�|�q|s!t|��t|�dkr+|dS|S)zDictionary style indexing.N�
not indexabler9r)r�r�rs�appendr]rc)rwrp�found�itemr&r&r'�__getitem__s

�zFieldStorage.__getitem__cCs2||vr||}t|t�rdd�|D�S|jS|S)z8Dictionary style get() method, including 'value' lookup.cS�g|]}|j�qSr&�rt�rV�xr&r&r'�
<listcomp>�z)FieldStorage.getvalue.<locals>.<listcomp>�r=r�rt�rwrp�defaultrtr&r&r'�getvalues
zFieldStorage.getvaluecCs.||vr||}t|t�r|djS|jS|S)z! Return the first value received.rr�r�r&r&r'�getfirst!s

zFieldStorage.getfirstcCs4||vr||}t|t�rdd�|D�S|jgSgS)z  Return list of received values.cSr�r&r�r�r&r&r'r�1r�z(FieldStorage.getlist.<locals>.<listcomp>r�)rwrprtr&r&r'rU,s
zFieldStorage.getlistcCs*|jdur	td��ttdd�|jD���S)zDictionary style keys() method.Nr�css�|]}|jVqdSr��rs�rVr�r&r&r'�	<genexpr>;s�z$FieldStorage.keys.<locals>.<genexpr>)r�r��setryr&r&r'r�7�
zFieldStorage.keyscs*|jdur	td��t�fdd�|jD��S)z%Dictionary style __contains__ method.Nr�c3s�|]}|j�kVqdSr�r�r��rpr&r'r�As�z,FieldStorage.__contains__.<locals>.<genexpr>)r�r��any)rwrpr&r�r'�__contains__=r�zFieldStorage.__contains__cCr�)z Dictionary style len(x) support.)rcr�ryr&r&r'�__len__C�zFieldStorage.__len__cCs|jdur	td��t|j�S)NzCannot be converted to bool.)r�r��boolryr&r&r'�__bool__Gs

zFieldStorage.__bool__c	Cs�|j�|j�}t|t�std|jt|�jf��|�|j	|j
�}|jr*|d|j7}tj
j||j|j|j	|j
|j|jd�}dd�|D�|_|��dS)z+Internal: read data in query string format.�%s should return bytes, got %sr/�rrTr�r4cSsg|]	\}}t||��qSr&�r�rVrprtr&r&r'r�Ysz0FieldStorage.read_urlencoded.<locals>.<listcomp>N)rGrBr�r=r�rAr�r{rCrrTr�rEr
�	parse_qslrIrJr�r4r��
skip_lines)rwrN�queryr&r&r'r�Ls
�
�zFieldStorage.read_urlencodedcCsJ|j}t|�std|f��g|_|jr3tjj|j|j|j	|j
|j|j|j
d�}|j�dd�|D��|jp8|j}|j��}t|t�sOtd|jt|�jf��|jt|�7_|��d|jkr||r||j��}|jt|�7_|��d|jkr||sc|j}|dur�|t|j�8}	t�}	d	}
	|j��}|
|7}
|��s�nq�|
s�n||jt|
�7_|	�|
�|j
|j��|	��}d
|vr�|d
=|jdur�dn|j|j}
||j||||||
|j
|j||j
�}|dur�|d8}|jr�|t|j�8}|dkr�td
��|j|j7_|j�|�|j �s|j|j!k�rdk�rnnnq�|�"�dS)z/Internal: read a part that is itself multipart.z&Invalid boundary in multipart form: %rr�css�|]
\}}t||�VqdSr�r�r�r&r&r'r�is�z*FieldStorage.read_multi.<locals>.<genexpr>r��--NTr�r�r9rzMax number of fields exceeded)#r��valid_boundaryrAr�r�rEr
r�rIrJrrTr�r4�extend�FieldStorageClass�	__class__rGr�r=r�r�r{r�rcrdr�feedrCr-r�r�r�r�r�)rwrHrIrJ�ibr��klass�
first_liner��parser�hdr_text�datarSr��partr&r&r'r�^s��

��
��
�
��(�$zFieldStorage.read_multicCs4|jdkr|��|��n|��|j�d�dS)zInternal: read an atomic part.rN)r��read_binaryr��
read_linesr�r�ryr&r&r'r��s


zFieldStorage.read_singlei cCs�|��|_|j}|dkrM|dkrO|j�t||j��}t|t�s+t	d|jt
|�jf��|jt
|�7_|s;d|_dS|j�|�|t
|�}|dksdSdSdS)zInternal: read binary data.rr�rjN)�	make_filer�r�rGrB�min�bufsizer=r�rAr�r{r�rcr�r*)rw�todor�r&r&r'r��s$

���zFieldStorage.read_binarycCsB|jrt�|_|_nt�|_|_|jr|��dS|��dS)z0Internal: read lines until EOF or outerboundary.N)r�rr��_FieldStorage__filerr��read_lines_to_outerboundary�read_lines_to_eofryr&r&r'r��szFieldStorage.read_linescCsx|jdur#|j��t|�dkr#|��|_|j��}|j�|�d|_|jr.|j�|�dS|j�|�|j	|j
��dS)z line is always bytes, not stringNi�)r��tellrcr�r�r�r*r�rCrrT)rwrnr�r&r&r'�__write�s


zFieldStorage.__writecCs:	|j�d�}|jt|�7_|sd|_dS|�|�q)zInternal: read lines until EOF.r9�rjN)rGr�r�rcr��_FieldStorage__write)rwrnr&r&r'r��s
�zFieldStorage.read_lines_to_eofc	Cs@d|j}|d}d}d}d}	|jdur"d|jkr!|kr"dS|j�d�}|jt|�7_|t|�7}|s>d|_dS|d	krH||}d}|�d�rb|rb|��}||krYdS||krbd|_dS|}|�	d
�rtd
}|dd�}d}n$|�	d�r�d}|dd�}d}n|�	d	�r�d	}|dd�}d
}nd}d
}|�
||�q)z�Internal: read lines until outerboundary.
        Data is read as bytes: boundaries and line ends must be converted
        to bytes for comparisons.
        r�r�Trr9Nr�rj�
s
����
F)r�r�rGr�r�rcr��
startswith�rstrip�endswithr�)	rw�
next_boundary�
last_boundary�delim�last_line_lfend�_readrn�strippedline�odelimr&r&r'r��sT
�


�z(FieldStorage.read_lines_to_outerboundarycCs�|jr|jrdSd|j}|d}d}	|j�d�}|jt|�7_|s*d|_dS|�d�rD|rD|��}||kr;dS||krDd|_dS|�d�}q)z5Internal: skip lines until outer boundary if defined.Nr�Tr�rjr9r�)r�r�rGr�r�rcr�rd)rwr�r�r�rnr�r&r&r'r�s(

�zFieldStorage.skip_linescCs"|jrt�d�Stjd|jdd�S)a�Overridable: return a readable & writable file.

        The file will be used as follows:
        - data is written to it
        - seek(0)
        - data is read from it

        The file is opened in binary mode for files, in text mode
        for other fields

        This version opens a temporary file for reading and writing,
        and immediately deletes (unlinks) it.  The trick (on Unix!) is
        that the file can still be used, but it can't be opened by
        another process, and it will automatically be deleted when it
        is closed or when the current process terminates.

        If you want a more permanent file, you derive a class which
        overrides this method.  If you want a visible temporary file
        that is nevertheless automatically deleted when the script
        terminates, try defining a __del__ method in a derived class
        which unlinks the temporary files you have created.

        zwb+zw+r))r�newline)r��tempfile�
TemporaryFilerryr&r&r'r�+s

�zFieldStorage.make_filer�)!r{r|r}r~�osrHrxr�r�r�rzr�r�r�r�r�rUr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r&r&r&r'r	sD)
�&

E	
2r	cCs�td�t�tjt_z't�}t�t�t|�t|�t	�dd�}|fdd�}td�|�Wnt
�Ytd�dazt�}t�t�t|�t|�Wd	St
�Yd	S)
z�Robust test CGI script, usable as main program.

    Write minimal HTTP headers and dump all information provided to
    the script in HTML form.

    zContent-type: text/htmlcSstd�dS)Nz,testing print_exception() -- <I>italics?</I>)�execr&r&r&r'rg^r�ztest.<locals>.fcSs
|�dSr�r&)rgr&r&r'�g`s
ztest.<locals>.gz9<H3>What follows is a test, not an actual exception:</H3>z*<H1>Second try with a small maxlen...</H1>�2N)�printr:�stdout�stderrr	rrrrrrr@)rH�formrgr�r&r&r'r
Ms4
r
c	Csx|durt��\}}}ddl}t�td�|�||�|�||�}tdt�d�|dd���t�|d�f�~dS)Nrz+<H3>Traceback (most recent call last):</H3>z<PRE>%s<B>%s</B></PRE>rrj)	r:�exc_info�	tracebackr��	format_tb�format_exception_only�html�escape�join)r�rt�tbr�rr�r&r&r'rts

��rc	Cs\t|���}t�td�td�|D]}tdt�|�dt�||��qtd�t�dS)z#Dump the shell environment as HTML.z<H3>Shell Environment:</H3>�<DL>�<DT>�<DD>�</DL>N)�sortedr�r�rr)rHr�rpr&r&r'r�s 
rcCs�t|���}t�td�|std�td�|D]-}tdt�|�ddd�||}tdt�tt|���d	�td
t�t|���qtd�t�dS)
z$Dump the contents of a form as HTML.z<H3>Form Contents:</H3>z<P>No form fields.r	r
�:� )rfz<i>z</i>rrN)r
r�r�rr�reprr�)rr�rprtr&r&r'r�s
rc
Cslt�td�zt��}Wnty)}ztdt�t|���WYd}~nd}~wwtt�|��t�dS)z#Dump the current directory as HTML.z#<H3>Current Working Directory:</H3>zOSError:N)r�r��getcwdr rr�str)�pwd�msgr&r&r'r�s ��
rcCs(t�td�t�ttj�t�dS)Nz <H3>Command Line Arguments:</H3>)r�r:rDr&r&r&r'r�s


rcCstd�dS)z9Dump a list of environment variables used by CGI as HTML.a�
<H3>These environment variables could have been set:</H3>
<UL>
<LI>AUTH_TYPE
<LI>CONTENT_LENGTH
<LI>CONTENT_TYPE
<LI>DATE_GMT
<LI>DATE_LOCAL
<LI>DOCUMENT_NAME
<LI>DOCUMENT_ROOT
<LI>DOCUMENT_URI
<LI>GATEWAY_INTERFACE
<LI>LAST_MODIFIED
<LI>PATH
<LI>PATH_INFO
<LI>PATH_TRANSLATED
<LI>QUERY_STRING
<LI>REMOTE_ADDR
<LI>REMOTE_HOST
<LI>REMOTE_IDENT
<LI>REMOTE_USER
<LI>REQUEST_METHOD
<LI>SCRIPT_NAME
<LI>SERVER_NAME
<LI>SERVER_PORT
<LI>SERVER_PROTOCOL
<LI>SERVER_ROOT
<LI>SERVER_SOFTWARE
</UL>
In addition, HTTP headers sent by the server may be passed in the
environment as well.  Here are some common variable names:
<UL>
<LI>HTTP_ACCEPT
<LI>HTTP_CONNECTION
<LI>HTTP_HOST
<LI>HTTP_PRAGMA
<LI>HTTP_REFERER
<LI>HTTP_USER_AGENT
</UL>
N)r�r&r&r&r'r�r�rcCs(ddl}t|t�rd}nd}|�||�S)Nrs^[ -~]{0,200}[!-~]$z^[ -~]{0,200}[!-~]$)�rer=r��match)rer�_vb_patternr&r&r'r��s

r��__main__)rOrPr/)NNNN)-r~�__version__�iorrr�collections.abcrr:r��urllib.parserE�email.parserr�
email.messagerrrr�r�__all__rrr(r#r!r.r"r@rHr
rrhrrr	r
rrrrrrr�r{r&r&r&r'�<module>sZ%	
�
F:
'/
�