1j f d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl
Z
ddl Z ddl m
Z
ddlmZmZ ddlmZ ddlmZ ddlmZmZmZmZ dd lmZmZm Z m Z m Z m Z dd
lm Z! dd lm"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z( dd l)m*Z* dd
l+m,Z,m-Z-m.Z.m/Z/ ddl0m1Z1 dZ2 ej3 Z4dddZ5d6 ej7 d ed d Z8ej9 dk rd Z:d Z"d Z;d Zd Z?ej@ d! ZAd" ZBd# ZCd$ ZDd% ZEdJd&ZFd' ZGd( ZHd) ZId* ZJd+ ZKd, ZLd- ZMd. ZN eOd/ ZPd0 ZQd1 ZRd2 ZSd3 ZTd4 ZUd5 ZVej@ d6 ZWd7 ZXdKd8ZYd9 ZZdLd:Z[dMd<Z\d= Z]d> Z^d?_ d@ Z`e`dAz Zae`dBz ZbdC ZcdD ZddE ZedF ZfdG ZgdH ZhdI ZidS )Nz
requests.utils
~~~~~~~~~~~~~~
This module provides utility functions that are used within Requests
that are also useful for external consumption.
N) OrderedDict) make_headers parse_url )certs __version__)_HEADER_VALIDATORS_BYTE_HEADER_VALIDATORS_STRHEADER_VALIDATORSto_native_string)Mapping
basestringbytes
getproxiesgetproxies_environment
integer_types)parse_http_list) proxy_bypassproxy_bypass_environmentquotestrunquoteurlparse
urlunparsecookiejar_from_dict)FileModeWarning
InvalidHeader
InvalidURLUnrewindableBodyError)CaseInsensitiveDict)z.netrc_netrcP i )httphttpsz, z,\s*T)accept_encodingzaccept-encodingwin32c L dd l }n# t $ r Y dS w xY w | |j d }t | |d d }| |d d }n# t t f$ r Y dS w xY w|r|sdS | d }|D ]t}|dk rd| vr d S | dd
}| d d }| d
d }t j || t j r d S udS )Nr Fz;Software\Microsoft\Windows\CurrentVersion\Internet Settings ProxyEnable
ProxyOverride;z.Tz\.*z.*?)
winreg ImportErrorOpenKeyHKEY_CURRENT_USERint QueryValueExOSError
ValueErrorsplitreplacerematchI)hostr0 internetSettings proxyEnable
proxyOverridetests E/opt/cloudlinux/venv/lib64/python3.11/site-packages/requests/utils.pyproxy_bypass_registryrC L sv MMMM 55
%~~(N
f 1 12BM R RST UVVK " / /0@/ R RST UMM$ 55 - 5
&++C00
! Dy d?? 44<<U++D<<U++D<<T**DxdBD))
tt
us
A A: :BBc Z t rt | S t | S )zReturn True, if the host should be bypassed.
Checks proxy settings gathered from the environment, if specified,
or the registry.
)r r rC )r= s rB r r p s. " # # /+D11 1(.. . c N t | d r| } | S )z/Returns an internal sequence dictionary update.items)hasattrrG )ds rB dict_to_sequencerJ | s( q'
GGII HrE c d }d}t | d rt | }nt | d r| j }n~t | d rn | }t j | j }d| j vrt j dt n # t j t f$ r Y nw xY wt | d r |
}t | d rW|U | dd |
}| |pd n'# t $ r d}Y nw xY wn# t $ r ||}Y nw xY w|d}t! d||z
S )
Nr __len__lenfilenoba% Requests has determined the content-length for this request using the binary size of the file: however, the file has been opened in text mode (i.e. without the 'b' flag in the mode). This may lead to an incorrect content-length. In Requests 3.0, support will be removed for files in text mode.tellseek )rH rM rN osfstatst_sizemodewarningswarnr ioUnsupportedOperationAttributeErrorrP rQ r6 max)o total_lengthcurrent_positionrN s rB super_lenr` s Lq) 1vv E u H XXZZF 8F++3L !&
2 $
' 8
D . q& % % vvxx q&!!
%l&: %FF1aLLL#$6688L FF+0q1111 % % %#$LLL%% 0 0 0
'#/
0* q,!11 2 22s7 B B87B8 E 3AD5 5 EEEEFc t j d }||f}nd t D } ddlm}m} d}|D ]X} t j | }n# t $ r Y dS w xY wt j | r|} nY|dS t | } d}
t | t r|
d }
| j |
d } || | } | r | d rdnd}
| |
| d fS dS # |t" f$ r |r Y dS w xY w# t$ t& f$ r Y dS w xY w)
z;Returns the Requests tuple auth for a given url from netrc.NETRCNc 3 K | ] }d | V
dS )z~/N ).0fs rB z!get_netrc_auth.. s( 99888999999rE r )NetrcParseErrornetrc :asciir rR )rS environget NETRC_FILESri rh path
expanduserKeyErrorexistsr
isinstancer decodenetlocr8 authenticatorsr6 r1 r[ )url raise_errors
netrc_filenetrc_locationsrh ri
netrc_pathrf locrisplitstrr= r# login_is rB get_netrc_authr s ((J %-99[999-
00000000
A
g((++
w~~c""
F
c]] c3 0 w//Hyx((+
U:&&55d;;F
4 %ay/!!a w33
4
4 )
(
sZ E A'&E '
A61E 5A66)E !AE =;D; ;E
E
EE E&%E&c t | dd }|rLt |t r9|d dk r/|d dk r%t j | S dS dS dS dS )z0Tries to guess the filename of the given object.nameNr <>)getattrrs r rS ro basename)objr s rB guess_filenamer sw 3 % %D &
4,, &aC DHPSOOw %%%& & & & OOrE c t j | r| S t j | \ }}|r|t j | s]t j | \ }}|sn8d ||g }|r t j | ]t j | s| S t j | }|| vr| S t j
}t j || d d }t j | sOt | 5 }| |
| ddd n # 1 swxY w Y |S )zReplace nonexistent paths that look like they refer to a member of a zip
archive with the location of an extracted copy of the target, or else
just return the provided path unchanged.
/r N)rS ro rr r8 joinzipfile
is_zipfileZipFilenamelisttempfile
gettempdir atomic_openwriteread)ro archivememberprefixzip_filetmpextracted_path file_handlers rB extract_zipped_pathsr s
w~~d gmmD))OGV
,"'..11 , '--00
66*++
,"'..11 , g & & w''H
X&&((((
CW\\#v||C'8'8'<==N
7>>. ) ) 6
(
( 6L x}}V 4 4 5 5 5 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 s >)F33F7:F7c # H K t j t j | \ }} t j |d 5 }|V ddd n # 1 swxY w Y t j || dS # t $ r t j | w xY w)z-Write a file to the disk in an atomic fashion)dirwbN) r mkstemprS ro dirnamefdopenr9
BaseExceptionremove)filenametmp_descriptortmp_name tmp_handlers rB r r , s ( /BGOOH4M4M N N N NH
Y~t
,
,
8X&&&&&
(
s/ B A B A##B &A#'B B!c | dS t | t t t t f rt d t
| S )a Take an object and test to see if it can be represented as a
dictionary. Unless it can not be represented as such, return an
OrderedDict, e.g.,
::
>>> from_key_val_list([('key', 'val')])
OrderedDict([('key', 'val')])
>>> from_key_val_list('string')
Traceback (most recent call last):
...
ValueError: cannot encode objects that are not 2-tuples
>>> from_key_val_list({'key': 'val'})
OrderedDict([('key', 'val')])
:rtype: OrderedDict
N+cannot encode objects that are not 2-tuples)rs r r boolr4 r7 r values rB from_key_val_listr 9 sG $
}t%#udC011 HFGGG u rE c | dS t | t t t t f rt d t | t r| } t | S )a Take an object and test to see if it can be represented as a
dictionary. If it can be, return a list of tuples, e.g.,
::
>>> to_key_val_list([('key', 'val')])
[('key', 'val')]
>>> to_key_val_list({'key': 'val'})
[('key', 'val')]
>>> to_key_val_list('string')
Traceback (most recent call last):
...
ValueError: cannot encode objects that are not 2-tuples
:rtype: list
Nr ) rs r r r r4 r7 r rG listr s rB to_key_val_listr T sd "
}t%#udC011 HFGGG%!!
;;rE c g }t | D ]N}|dd |dd cxk rdk rn nt |dd }| | O|S )a Parse lists as described by RFC 2068 Section 2.
In particular, parse comma-separated lists where the elements of
the list may include quoted-strings. A quoted-string could
contain a comma. A non-quoted string could have quotes in the
middle. Quotes are removed automatically after parsing.
It basically works like :func:`parse_set_header` just that items
may appear multiple times and case sensitivity is preserved.
The return value is a standard :class:`list`:
>>> parse_list_header('token, "quoted value"')
['token', 'quoted value']
To create a header from the :class:`list` again, use the
:func:`dump_header` function.
:param value: a string with a list header.
:return: :class:`list`
:rtype: list
Nr r ")_parse_list_headerunquote_header_valueappend)r resultitems rB parse_list_headerr r s . F"5)) 8tBCCy ' ' ' 'C ' ' ' ' ''QrT
33D
d MrE c i }t | D ]a}d|vrd||< | dd \ }} | dd | dd cxk rdk rn nt | dd } | ||< b|S )a^ Parse lists of key, value pairs as described by RFC 2068 Section 2 and
convert them into a python dict:
>>> d = parse_dict_header('foo="is a fish", bar="as well"')
>>> type(d) is dict
True
>>> sorted(d.items())
[('bar', 'as well'), ('foo', 'is a fish')]
If there is no value for a key it will be `None`:
>>> parse_dict_header('key_without_value')
{'key_without_value': None}
To create a header from the :class:`dict` again, use the
:func:`dump_header` function.
:param value: a string with a dict header.
:return: :class:`dict`
:rtype: dict
=Nr r r )r r8 r )r r r r s rB parse_dict_headerr s , F"5)) d?? F4L jja(( e !9bcc
) ) ) )c ) ) ) ) )(qt55E t MrE c | r`| d | d cxk rdk rGn nD| dd } |r| dd dk r*| dd d d S | S )
zUnquotes a header value. (Reversal of :func:`quote_header_value`).
This does not use the real unquoting but what browsers are actually
using for quoting.
:param value: the header value to unquote.
:rtype: str
r r r r NrR z\\\z\")r9 )r is_filenames rB r r s
CqU2Y----#-----
ad CeBQBi6 1 1==..66ucBB B LrE c 2 i }| D ]}|j ||j < |S )zReturns a key/value dictionary from a CookieJar.
:param cj: CookieJar object to extract cookies from.
:rtype: dict
)r r )cj cookie_dictcookies rB dict_from_cookiejarr s/ K 0 0#)< FK rE c " t || S )zReturns a CookieJar from a key/value dictionary.
:param cj: CookieJar to insert cookies into.
:param cookie_dict: Dict of key/values to insert into CookieJar.
:rtype: CookieJar
r )r r s rB add_dict_to_cookiejarr s {B / //rE c ` t j dt t j dt j }t j dt j }t j d }| | | | z | | z S )zlReturns encodings from given content string.
:param content: bytestring to extract encodings from.
zIn requests 3.0, get_encodings_from_content will be removed. For more information, please see the discussion on issue #2266. (This warning should only appear once.)z!])flagsz+]z$^<\?xml.*?encoding=["\']*(.+?)["\'>])rW rX DeprecationWarningr: compiler< findall)content
charset_re pragma_rexml_res rB get_encodings_from_contentr s
M
1
@MMMJ
IQSQUVVVI
Z?
@
@F 7##
G
$
$ %
..
!
! "rE c | d }|d |dd }}i }d}|D ]}| }|rs|d}}| d } | dk r=|d| | }|| dz d | }||| < ||fS ) zReturns content type and parameters from given header
:param header: string
:return: tuple containing content type and dictionary of
parameters
r, r r Nz"' Tr r )r8 stripfindlower)
headertokens content_typeparams params_dictitems_to_stripparamkeyr index_of_equalss
rB _parse_content_type_headerr s \\#
F!!9??,,fQRRj&LKN - -
- C #jjooO "$$ ,_ ,-33NCC o 1 3 34::>JJ',K $ $$rE c | d }|sdS t | \ }}d|v r|d d S d|v rdS d|v rdS dS ) z}Returns encodings from given HTTP Header Dict.
:param headers: dictionary to extract encoding from.
:rtype: str
z content-typeNcharsetz'"textz
ISO-8859-1zapplication/jsonutf-8)rm r r )headersr r s rB get_encoding_from_headersr s ;;~..L t5lCCL&Fi &&u---
|\))w *)rE c # K |j
| E d{V dS t j |j d }| D ] }| | }|r|V | dd }|r|V dS dS )zStream decodes an iterator.Nr9 errorsrE T)final)encodingcodecsgetincrementaldecoderrt )iteratorrdecoderchunkrvs rB stream_decode_response_unicoder 3 s z6f*1:66iHHHG
^^E
"
"
HHH 4 ( (B rE c # K d}||dk rt | }|t | k r)| |||z V ||z
}|t | k 'dS dS )z Iterate over slices of a string.r N)rM )string slice_lengthposs rB iter_slicesr D s{
C|q 0 06{{
F
S3 --.... | F
rE c : t j dt g }t | j }|r; t | j | S # t $ r | | Y nw xY w t | j |d S # t $ r
| j cY S w xY w)zReturns the requested content back in unicode.
:param r: Response object to get unicode content from.
Tried:
1. charset from content-type
2. fall back and replace all unicode characters
:rtype: str
zIn requests 3.0, get_unicode_from_response will be removed. For more information, please see the discussion on issue #2266. (This warning should only appear once.)r9 r )
rW rX r r r r r UnicodeErrorr TypeError)r tried_encodingsr s rB get_unicode_from_responser N s
M
1
O )33H - -qy(++ + - - - " "8 , , , , , -19hy9999 ys# A A+*A+/B BBzBABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~c | d }t dt | D ]}|| dd }t | dk r| ro t t |d }n!# t $ r t d| d w xY w|t v r||| dd z ||< d|| ||< d|| ||< d | S )
zUn-escape any percent-escape sequences in a URI that are unreserved
characters. This leaves all reserved, illegal and non-ASCII bytes encoded.
:rtype: str
%r r rR z"Invalid percent-escape sequence: ''N )
r8 rangerM isalnumchrr4 r7 r UNRESERVED_SETr )uripartsihcs rB unquote_unreservedr { s
IIcNNE
1c%jj
!
!
&
& !HQqSM q66Q;;199;;;
LAr
OO
L
L
L !Ja!J!J!JKKK
L N"" uQx|+a)uQx>>a%58~~E!HH
775>>s - B B)c d}d} t t | | S # t $ r t | | cY S w xY w)zRe-quote the given URI.
This function passes the given URI through an unquote/quote cycle to
ensure that it is fully and consistently quoted.
:rtype: str
z!#$%&'()*+,/:;=?@[]~z!#$&'()*+,/:;=?@[]~)safe)r r r )r safe_with_percentsafe_without_percents rB requote_urir sk /0 5 ',,3DEEEE 5 5 5 S 3444444 5s $ AAc
t j dt j | d }| d \ }}t j dt j t t
| d }t j dt j | d |z }||z ||z k S )zThis function allows you to check if an IP belongs to a network subnet
Example: returns True if ip = 192.168.1.1 and net = 192.168.1.0/24
returns False if ip = 192.168.1.1 and net = 192.168.100.0/24
:rtype: bool
z=Lr r )structunpacksocket inet_atonr8 dotted_netmaskr4 )ipnetipaddrnetaddrbitsnetmasknetworks rB address_in_networkr s ]4!1"!5!5
6
6q
9FIIcNNMGTmD&"2>#d))3L3L"M"MNNqQGmD&"27";";<I)r inet_ntoar pack)maskr s rB r r s8 b4i 1, ,D FKd 3 3 4 44rE c T t j | n# t $ r Y dS w xY wdS )z
:rtype: bool
FT)r r r6 ) string_ips rB is_ipv4_addressr& sB #### uu 4s
%%c N | d dk r t | d d }n# t $ r Y dS w xY w|dk s|dk rdS t j | d d n# t $ r Y dS w xY wdS dS )zV
Very simple check of the cidr format in no_proxy variable.
:rtype: bool
r r Fr r T)countr4 r8 r7 r r r6 )string_networkr# s rB
is_valid_cidrr* s C A%% ~++C00344DD 55 !88tbyy5 ^ 1 1# 6 6q 9 : : : : 55 u 4s# (A
AA$-B
B B c # K |du}|r.t j | }|t j | < dV |r"|t j | = dS |t j | < dS dS # |r |t j | = n|t j | < w xY w)zSet the environment variable 'env_name' to 'value'
Save previous value, yield, and then restore the previous value stored in
the environment variable 'env_name'.
If 'value' is None, do nothingN)rS rl rm )env_namer
value_changed old_values rB set_environr/ s %M %JNN8,, $
8 1
1 Jx((('0
8$$$ 1 1= 1 Jx(('0
8$0000s A" "#Bc d }|}| |d }t | }|j dS |rd | dd d D }t |j r<|D ]8}t | rt
|j | r dS *|j |k r dS 9nR|j }|j r
|d |j z
}|D ]4}|j | s| | r dS 5t d| 5 t |j }n # t t j
f$ r d
}Y nw xY wddd n # 1 swxY w Y |rdS d
S ) zL
Returns whether we should bypass proxies or not.
:rtype: bool
c t j | p0t j | S N)rS rl rm upper)r s rB get_proxyz(should_bypass_proxies..get_proxy s1 z~~c""AbjnnSYY[[&A&AArE Nno_proxyTc 3 K | ]}||V d S r2 rd )re r= s rB rg z(should_bypass_proxies.. s' RRTTRDRRRRRRrE r ,:F)r hostnamer9 r8 r& r* r portendswithr/ r r r gaierror) rw r5 r4 no_proxy_argparsedproxy_iphost_with_portr= bypasss rB should_bypass_proxiesrC s# B B B
L 9Z((
c]]F
t SRX%5%5c2%>%>%D%DS%I%IRRR 6? + + $
** )&/8DD $ #tt$_00 44 1
$_N{
4 "3fk"3"33
?++D11 ^5L5LT5R5R 44
Z . . !&/22FF6?+ FFF t 5s6 ED)(E)EEEEEEc D t | | ri S t S )zA
Return a dict of environment proxies.
:rtype: dict
r5 )rC r )rw r5 s rB get_environ_proxiesrF 8 s( S8444 ||rE c |pi }t | }|j .| |j | d S |j dz |j z |j d|j z dg}d}|D ]}||v r
|| } n|S )zSelect a proxy for the url, if applicable.
:param url: The url being for the request
:param proxies: A dictionary of schemes or schemes and hosts to proxy URLs
Nallz://zall://)r r: rm scheme)rw proxiesurlparts
proxy_keysproxy proxy_keys rB select_proxyrO D s mG}}H {{8?GKK,>,>??? % ("338$$
J
E I&E E LrE c d ||ni }| j }t | j }| d }| }|rct || sRt
|| }| || d }|r| || |S )a This method takes proxy information from a request and configuration
input to resolve a mapping of target proxies. This will consider settings
such a NO_PROXY to strip proxy configurations.
:param request: Request or PreparedRequest
:param proxies: A dictionary of schemes or schemes and hosts to proxy URLs
:param trust_env: Boolean declaring whether to trust environment configs
:rtype: dict
Nr5 rE rH )rw r rI rm copyrC rF
setdefault) requestrJ trust_envrw rI r5 new_proxiesenviron_proxiesrM s rB resolve_proxiesrW ^ s !,gg"G
+C
c]]
!F{{:&&H,,..K 2.sXFFF 2-cHEEE ##FO,?,?,F,FGG 2 " "65 1 1 1 rE python-requestsc | dt S )zO
Return a string representing the default user agent.
:rtype: str
r r )r s rB default_user_agentrZ y s " "[ " ""rE c L t t t ddd S )z9
:rtype: requests.structures.CaseInsensitiveDict
z*/*z
keep-alive)z
User-AgentzAccept-EncodingAccept
Connection)r" rZ DEFAULT_ACCEPT_ENCODINGrd rE rB default_headersr_ s2 ,.. 6&
rE c g }d}| | } | s|S t j d| D ]} | dd \ }}n# t $ r |d}}Y nw xY wd| d i}| d D ]X} | d \ }} n# t $ r Y n0w xY w| | || | < Y| | |S ) zReturn a list of parsed link headers proxies.
i.e. Link: ; rel=front; type="image/jpeg",; rel=back;type="image/jpeg"
:rtype: list
z '"z, * '"r )r r: r8 r7 r ) r links
replace_charsvalrw r linkr r s rB parse_header_linksre sA
EM KK
& &E x&& " ))C++KC " " " rCCC " syy**+\\#&& H HE
"[[ - -
UU
.3[[ -G-GD=)) * *
T Ls# AA! A!B,,
B:9B: rk rR c | dd }|t j t j fv rdS |dd t j k rdS |dd t j t j fv rdS | t }|dk rd S |dk r,|ddd t k rd
S |d dd t k rd S |dk r*|dd t k rd
S |d d t k rdS dS )z
:rtype: str
N zutf-32rg z utf-8-sigrR zutf-16r r z utf-16-ber z utf-16-lez utf-32-bez utf-32-le)
r BOM_UTF32_LE BOM_UTF32_BEBOM_UTF8 BOM_UTF16_LE BOM_UTF16_BEr( _null_null2_null3)datasample nullcounts rB guess_json_utfru s "1"XF
&%v':;;;x
bqbzV_$${
bqbzf)6+>???x U##IA~~wA~~ ##A#;& ; !$Q$<6 ! ! ;A~~ "1": ; !"": ; 4rE c t | }|\ }}}}}}} |j }
|
s||
}}
|rd ||
g }
||}|d}t ||
|d|| f S )zGiven a URL that may or may not have a scheme, prepend the given scheme.
Does not replace a present scheme with the one provided as an argument.
:rtype: str
@Nr )r ru r r ) rw
new_schemer? rI authr= r; ro queryfragmentru s rB prepend_scheme_if_neededr| s s^^F6<3FD$dE8 ]F $V * 4.))
~ | vvtRA B BBrE c t | } t |j t |j f}n# t t
f$ r d}Y nw xY w|S )z{Given a url with authentication components, extract them into a tuple of
username,password.
:rtype: (str,str)
)r r )r r usernamepasswordr[ r )rw r? ry s rB get_auth_from_urlr sd c]]F(('&/*B*BC I & Ks (: AAc T | \ }}t | |d t | |d dS )zVerifies that header parts don't contain leading whitespace
reserved characters, or return characters.
:param header: tuple, in the format (name, value).
r r N)_validate_header_part)r r r s rB check_header_validityr s7 KD%&$***&%+++++rE c
D t |t rt | }nHt |t rt | }n%t d|d| dt
| | | s |dk rdnd}t d| d| d S ) Nz
Header part (z) from z# must be of type str or bytes, not r r r zSInvalid leading whitespace, reserved character(s), or returncharacter(s) in header z: )rs r r r r
r typer; )r header_partheader_validator_index validator header_kinds rB r r s +s##
*+AB K ' '
+,BC
EK
E
E&
E
E15k1B1B
E
E
??; ' '
6! ; ;ff
E&1
E
E5@
E
E
rE c t | \ }}}}}}|s||}}| dd d }t |||||df S )zW
Given a url remove the fragment and the authentication part.
:rtype: str
rw r r r )r rsplitr )rw rI ru ro r rz r{ s rB
urldefragauthr & sb 5=SMM1FFD&% $V
]]3
"
"2
&F vvtVUB? @ @@rE c t | j dd }|Jt | j t r0 || j dS # t
$ r t
d w xY wt
d )zfMove file pointer back to its recorded starting position
so it can be read again on redirect.
rQ Nz;An error occurred when rewinding request body for redirect.z+Unable to rewind request body for redirect.)r bodyrs _body_positionr r6 r! )prepared_request body_seeks rB rewind_bodyr 7 s (-vt<r s
# # # # # # 0 0 0 0 0 0 0 0 $ $ $ $ $ $ : 9 9 9 9 9 ) ( ( ( ( ( , + + + + +" $ c**
)) BHWll48889JKLL
<7" " "H / / /
?3 ?3 ?3D6
6
6
6
r& & &" " "J 6 < @ F 2 0 0 0 2% % %2 2 " $ $ $P M
05 5 5, 5 5 5 5 5 5 0 1 1 1*9 9 9x 4 6# # # # " " "L
g @C C C:
, , ,
&A A A"S S S S SrE