/snap/core22/2411/usr/lib/python3.10/__pycache__
Edit: /snap/core22/2411/usr/lib/python3.10/__pycache__/cgi.cpython-310.pyc (26723B)
o
`wi3 @ s` d Z dZddlmZmZmZ ddlmZ ddlZddl Z ddl
Z ddl m
Z
ddlmZ ddlZddlZddlZddlZg dZd adad
d Zd d
Zdd Zdd Zeada de j dddfddZ d2ddZ dd Z dd Z!G d d d Z"G d d d Z#e j fd!d"Z$d3d#d$Z%e j fd%d&Z&d'd( Z'd)d* Z(d+d, Z)d-d. Z*d/d0 Z+e,d1kre$ dS dS )4zSupport module for CGI (Common Gateway Interface) scripts.
This module defines a number of utilities for use by CGI scripts
written in Python.
z2.6 )StringIOBytesIO
TextIOWrapper)MappingN)
FeedParser)Message) MiniFieldStorage FieldStorageparseparse_multipart parse_headertestprint_exception
print_environ
print_formprint_directoryprint_argumentsprint_environ_usage c G sX t jdtdd tr ts z ttdddaW n ty Y nw ts$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 )
stacklevelalocale)encodingN)
warningswarnDeprecationWarninglogfilelogfpopenOSErrornologlogdologallargs r& /usr/lib/python3.10/cgi.pyinitlog9 s r( c G s t | | d dS )z=Write a log message to the log file. See initlog() for docs.
N)r write)fmtargsr& r& r' r# ^ s r# c G s dS )z9Dummy function, assigned to log when logging is disabled.Nr& r$ r& r& r' r! b s r! c C s da tr
t datadS )zClose the log file.r N)r r closer( r" r& r& r& r' closelogf s
r. &c
C sV | du rt j} t| dr| j}nd}t| tr| j} d|vr"d|d< |d dkrt|d \}}|dkr;t| ||d S |d
krXt |d }t
rO|t
krOt d | |
|} nd
} d|v rk| rd| d } | |d } nt jdd r| rx| d } | t jd } | |d< n d|v r|d } nt jdd rt jd } nd
} | |d< tjj| ||||dS )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 &.
Nr zlatin-1REQUEST_METHODGETPOST CONTENT_TYPEzmultipart/form-data) separator!application/x-www-form-urlencodedCONTENT_LENGTH Maximum content length exceededr QUERY_STRINGr/ )r r4 )sysstdinhasattrr
isinstancer bufferr r intmaxlen
ValueErrorreaddecodeargvurllibr
parse_qs)
fpenvironkeep_blank_valuesstrict_parsingr4 r ctypepdictclengthqsr& r& r' r
y sF
r
utf-8replacec sv |d d}d|}t }|| z|d |d< W n ty% Y nw t| |||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.
boundaryasciiz multipart/form-data; boundary={}zCONTENT-LENGTHzContent-Lengthr0 r2 )headersr errorsrH r4 c s i | ]}| |qS r& )getlist).0kfsr& r'
s z#parse_multipart..)rC formatr set_typeKeyErrorr )rG rL r rT r4 rQ rK rS r& rX r' r s
r c c s | d d dkrg| dd } | d}|dkrD| dd|| dd| d rD| d|d }|dkrD| dd|| dd| d s(|dk rLt| }| d | }| V | |d } | d d dks d S d S )Nr9 ;r "\"r )findcountlenstrip)sendfr& r& r' _parseparam s
((
rh c C s t d| }| }i }|D ]I}|d}|dkrW|d| }||d d }t|dkrS|d |d krAdkrSn n|dd }|d d
d d}|||< q||fS ) zfParse a Content-type like header.
Return the main content-type and a dictionary of options.
r^ =r Nr9 r r_ z\\\r` )rh __next__ra rd lowerrc rP )linepartskeyrL pinamevaluer& r& r' r s
, r c @ s@ e Zd ZdZdZdZdZdZi ZdZ i Z
i Z dd Z dd Z
dS )r z=Like FieldStorage, for use when no file uploads are possible.Nc C s || _ || _dS )z&Constructor from field name and value.Nrs rt selfrs rt r& r& r' __init__ s
zMiniFieldStorage.__init__c C s d| j | jf S )z Return printable representation.zMiniFieldStorage(%r, %r)ru rw r& r& r' __repr__ s zMiniFieldStorage.__repr__)__name__
__module__ __qualname____doc__filenamelisttypefile type_options dispositiondisposition_optionsrS rx rz r& r& r& r' r s r c @ s e Zd ZdZdddejdddddddf dd Zd
d Zd d
Zdd Z dd Z
dd Z dd Z dd Z
d;ddZd;ddZd d Zd d Zd d! Zd"d# Zd$d% Zd&d' ZdZd(d) Zd*d+ Zd,Zd-d. Zd/d0 Zd1d2 Z d3d4 Z d5d6 Z d7d8 Z d9d: Z dS ) rG r r< r rT bytesr r{
outerboundary
bytes_readlimitr r r rs r _binary_filer
innerboundaryr? rA r@ lengthr r doneread_urlencoded
read_multi read_single)rw rG rS r rH rI rJ r r rT r r4 methodrN cdisprL rK clenr& r& r' rx B s /
zFieldStorage.__init__c C s& z| j W d S ty Y d S w N)r r- AttributeErrorry r& r& r' __del__ s
zFieldStorage.__del__c C s | S r r& ry r& r& r' __enter__ s zFieldStorage.__enter__c G s | j d S r )r r- )rw r, r& r& r' __exit__ s zFieldStorage.__exit__c C s d| j | j| jf S )z"Return a printable representation.zFieldStorage(%r, %r, %r))rs r rt ry r& r& r' rz s zFieldStorage.__repr__c C t | S r )iterkeysry r& r& r' __iter__ zFieldStorage.__iter__c C sX |dkrt || jr | jd | j }| jd |S | jd ur(| j}|S d }|S )Nrt r )r r seekrB r rv r& r& r' __getattr__ s
zFieldStorage.__getattr__c C sZ | j du r tdg }| j D ] }|j|kr|| q|s!t|t|dkr+|d S |S )zDictionary style indexing.N
not indexabler9 r )r r rs appendr] rc )rw rp founditemr& r& r' __getitem__ s
zFieldStorage.__getitem__c C s2 || v r| | }t |trdd |D S |jS |S )z8Dictionary style get() method, including 'value' lookup.c S g | ]}|j qS r& rt rV xr& r& r'
z)FieldStorage.getvalue..r= r rt rw rp defaultrt r& r& r' getvalue s
zFieldStorage.getvaluec C s. || v r| | }t |tr|d jS |jS |S )z! Return the first value received.r r r r& r& r' getfirst! s
zFieldStorage.getfirstc C s4 || v r| | }t |trdd |D S |jgS g S )z Return list of received values.c S r r& r r r& r& r' r 1 r z(FieldStorage.getlist..r )rw rp rt r& r& r' rU , s
zFieldStorage.getlistc C s* | j du r tdt tdd | j D S )z Dictionary style keys() method.Nr c s s | ]}|j V qd S r rs rV r r& r& r' ; s z$FieldStorage.keys..)r r setry r& r& r' r 7
zFieldStorage.keysc s* | j du r tdt fdd| j D S )z%Dictionary style __contains__ method.Nr c 3 s | ]}|j kV qd S r r r rp r& r' r A s z,FieldStorage.__contains__..)r r any)rw rp r& r r' __contains__= r zFieldStorage.__contains__c C r )z Dictionary style len(x) support.)rc r ry r& r& r' __len__C zFieldStorage.__len__c C s | j d u r tdt| j S )Nz Cannot be converted to bool.)r r boolry r& r& r' __bool__G s
zFieldStorage.__bool__c C s | j | j}t|tstd| j t|jf || j | j
}| j r*|d| j 7 }t j
j|| j| j| j | j
| j| jd}dd |D | _| dS )z+Internal: read data in query string format. %s should return bytes, got %sr/ r rT r r4 c S s g | ] \}}t ||qS r& r rV rp rt r& r& r' r Y s z0FieldStorage.read_urlencoded..N)rG rB r r= r rA r r{ rC r rT r rE r
parse_qslrI rJ r r4 r
skip_lines)rw rN queryr& r& r' r L s
z FieldStorage.read_urlencodedc C sJ | j }t|std|f g | _| jr3tjj| j| j| j | j
| j | j | j
d}| jdd |D | jp8| j}| j }t|tsOtd| jt|jf | jt|7 _| d| j kr||r|| j }| jt|7 _| d| j kr||sc| j }|dur|t| j8 } t } d }
| j } |
| 7 }
| snq|
sn|| jt|
7 _| |
| j
| j | } d
| v r| d
= | j du rdn| j | j }
|| j| |||||
| j
| j || j
}|dur|d 8 }|jr|t|j8 }|d k rtd
| j|j7 _| j | |j s | j| j! krd kr n nnq| " dS )z/Internal: read a part that is itself multipart.z&Invalid boundary in multipart form: %rr c s s | ]
\}}t ||V qd S r r r r& r& r' r i s z*FieldStorage.read_multi..r --NTr r r9 r z Max number of fields exceeded)#r valid_boundaryrA r r rE r
r rI rJ r rT r r4 extendFieldStorageClass __class__rG r r= r r r{ r rc rd r feedrC r- r r r r r )rw rH rI rJ ibr klass
first_liner parserhdr_textdatarS r partr& r& r' r ^ s
( $zFieldStorage.read_multic C s4 | j dkr| | n| | jd dS )z Internal: read an atomic part.r N)r read_binaryr
read_linesr r ry r& r& r' r s
zFieldStorage.read_singlei c C s | | _| j}|dkrM|dkrO| jt|| j}t|ts+t d| jt
|j f | j t
|7 _ |s;d| _dS | j| |t
| }|dksdS dS dS )zInternal: read binary data.r r rj N) make_filer r rG rB minbufsizer= r rA r r{ r rc r r* )rw todor r& r& r' r s$
zFieldStorage.read_binaryc C sB | j r t | _| _nt | _| _| jr| dS | dS )z0Internal: read lines until EOF or outerboundary.N)r r r _FieldStorage__filer r read_lines_to_outerboundaryread_lines_to_eofry r& r& r' r s zFieldStorage.read_linesc C sx | j dur#| j t| dkr#| | _| j }| j| d| _ | jr.| j| dS | j|| j | j
dS )z line is always bytes, not stringNi ) r tellrc r r r r* r rC r rT )rw rn r r& r& r' __write s
zFieldStorage.__writec C s: | j d}| jt|7 _|sd| _dS | | q)z Internal: read lines until EOF.r9 rj N)rG r r rc r _FieldStorage__write)rw rn r& r& r' r s
z FieldStorage.read_lines_to_eofc C s@ d| j }|d }d}d}d} | jdur"d| j kr!|kr"dS | jd}| jt|7 _|t|7 }|s>d| _dS |d krH|| }d}|drb|rb| }||krYdS ||krbd| _dS |}| d
rtd
}|dd }d}n$| d rd }|dd }d}n| d rd }|dd }d
}nd}d
}|
|| q)zInternal: read lines until outerboundary.
Data is read as bytes: boundaries and line ends must be converted
to bytes for comparisons.
r r Tr r9 Nr rj
s
F) r r rG r r rc r
startswithrstripendswithr ) rw
next_boundary
last_boundarydelimlast_line_lfend_readrn strippedlineodelimr& r& r' r sT
z(FieldStorage.read_lines_to_outerboundaryc C s | j r| jrdS d| j }|d }d} | jd}| jt|7 _|s*d| _dS |drD|rD| }||kr;dS ||krDd| _dS |d}q)z5Internal: skip lines until outer boundary if defined.Nr Tr rj r9 r )r r rG r r rc r rd )rw r r r rn r r& r& r' r s(
zFieldStorage.skip_linesc C s" | j rtdS tjd| jddS )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
TemporaryFiler ry r& r& r' r + s
zFieldStorage.make_filer )!r{ r| r} r~ osrH rx r r r rz r r r r r rU r r r r r r r r r r r r r r r r r& r& r& r' r sD )
&
E
2 r c C s t d t tjt_z't }t t t| t| t dd }|fdd}t d | W n t
Y t d da zt }t t t| t| W d S t
Y d S )
zRobust 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/htmlc S s t d d S )Nz,testing print_exception() -- italics?)execr& r& r& r' rg ^ r ztest..fc S s
| d S r r& )rg r& r& r' g` s
ztest..gz9What follows is a test, not an actual exception:
z*Second try with a small maxlen...
2 N) printr: stdoutstderrr r r r r r r r@ )rH formrg r r& r& r' r
M s4
r
c C sx | d u r t \} }}dd l}t td ||||| | }tdtd|d d t|d f ~d S )Nr z+Traceback (most recent call last):
z%s%s
r rj ) r: exc_info tracebackr format_tbformat_exception_onlyhtmlescapejoin)r rt tbr r r r& r& r' r t s
r c C s\ t | }t td td |D ]}tdt|dt| | qtd t dS )z#Dump the shell environment as HTML.zShell Environment:
N)sortedr r r r )rH r rp r& r& r' r s
r c C s t | }t td |std td |D ]-}tdt| d dd | | }tdttt| d td
tt| qtd t d S )
z$Dump the contents of a form as HTML.zForm Contents:
zNo form fields.r r
: )rf zzr r N)r
r r r r reprr )r r rp rt r& r& r' r s
r c
C sl t t d zt } W n ty) } zt dtt| W Y d}~n d}~ww t t| t dS )z#Dump the current directory as HTML.z#
Current Working Directory:
zOSError:N)r r getcwdr r r str)pwdmsgr& r& r' r s
r c C s( t t d t t tj t d S )Nz Command Line Arguments:
)r r: rD r& r& r& r' r s
r c C s t d dS )z9Dump a list of environment variables used by CGI as HTML.a
These environment variables could have been set:
- AUTH_TYPE
- CONTENT_LENGTH
- CONTENT_TYPE
- DATE_GMT
- DATE_LOCAL
- DOCUMENT_NAME
- DOCUMENT_ROOT
- DOCUMENT_URI
- GATEWAY_INTERFACE
- LAST_MODIFIED
- PATH
- PATH_INFO
- PATH_TRANSLATED
- QUERY_STRING
- REMOTE_ADDR
- REMOTE_HOST
- REMOTE_IDENT
- REMOTE_USER
- REQUEST_METHOD
- SCRIPT_NAME
- SERVER_NAME
- SERVER_PORT
- SERVER_PROTOCOL
- SERVER_ROOT
- SERVER_SOFTWARE
In addition, HTTP headers sent by the server may be passed in the
environment as well. Here are some common variable names:
- HTTP_ACCEPT
- HTTP_CONNECTION
- HTTP_HOST
- HTTP_PRAGMA
- HTTP_REFERER
- HTTP_USER_AGENT
N)r r& r& r& r' r r r c C s( dd l }t| tr d}nd}||| S )Nr s ^[ -~]{0,200}[!-~]$z^[ -~]{0,200}[!-~]$)rer= r match)re r _vb_patternr& r& r' r s
r __main__)rO rP r/ )NNNN)-r~ __version__ior r r collections.abcr r: r urllib.parserE email.parserr
email.messager r r r r __all__r r r( r# r! r. r" r@ rH r
r rh r r r r
r r r r r r r r{ r& r& r& r' sZ %
F :
' /