~WT | d Z ddlmZmZmZ ddlZddlZddlZddlZddl Z ddl
Z
ddl Z ej d Z
ej ej Z ej Ze e e
e e
ej ddlmZmZ eg d Zddd d
d d d
ddddddd
Z e ee ee z dk sJ g dZ G d de Z! G d de Z"er= e ee eej# z dk sJ d Z$d Z%d Z& G d d e Z'd Z(d Z)d! Z*d" Z+d/d$Z,d% Z-d& Z. e/ed' si e_0 d( Z1d/d)Z2d* Z3 G d+ d,e Z4g d-Z5d. Z6dS )0a
Python 3 reorganized the standard library (PEP 3108). This module exposes
several standard library modules to Python 2 under their new Python 3
names.
It is designed to be used as follows::
from future import standard_library
standard_library.install_aliases()
And then these normal Py3 imports work on both Py3 and Py2::
import builtins
import copyreg
import queue
import reprlib
import socketserver
import winreg # on Windows only
import test.support
import html, html.parser, html.entites
import http, http.client, http.server
import http.cookies, http.cookiejar
import urllib.parse, urllib.request, urllib.response, urllib.error, urllib.robotparser
import xmlrpc.client, xmlrpc.server
import _thread
import _dummy_thread
import _markupbase
from itertools import filterfalse, zip_longest
from sys import intern
from collections import UserDict, UserList, UserString
from collections import OrderedDict, Counter, ChainMap # even on Py2.6
from subprocess import getoutput, getstatusoutput
from subprocess import check_output # even on Py2.6
(The renamed modules and functions are still available under their old
names on Python 2.)
This is a cleaner alternative to this idiom (see
http://docs.pythonsprints.com/python3_porting/py-porting.html)::
try:
import queue
except ImportError:
import Queue as queue
Limitations
-----------
We don't currently support these modules, but would like to::
import dbm
import dbm.dumb
import dbm.gnu
import collections.abc # on Py33
import pickle # should (optionally) bring in cPickle on Python 2
)absolute_importdivisionprint_functionN
future_stdlib)PY2PY3)testurllibpickledbmbuiltinscopyregqueue socketserver configparserreprlibwinreg_thread
_dummy_threadxmlrpchtmlhttp _markupbase)
__builtin__copy_regQueuezfuture.moves.socketserver ConfigParserrepr_winregthread dummy_threadzfuture.moves.xmlrpczfuture.moves.htmlzfuture.moves.httpzfuture.moves._markupbase)) collectionsUserListr# r# )r" UserDictr$ r$ )r"
UserStringr% r% r" ChainMapfuture.backports.miscr' ) itertools filterfalser) ifilterfalse)r) zip_longestr) izip_longest)sysinternr r/ )reASCIIstatST_MODE)base64 encodebytesr4 encodestring)r4 decodebytesr4 decodestring)
subprocess getoutputcommandsr: )r9 getstatusoutputr; r< )r9 check_outputr( r= )mathceilr( r? )r" OrderedDictr( r@ )r" Counterr( rA r& )r) countr( rB )r recursive_reprr( rC ) functools
cmp_to_keyr( rE c 2 e Zd ZdZdZd ZddZd ZddZdS ) RenameImportzX
A class for import hooks mapping Py3 module names etc. to the Py2 equivalents.
Tc || _ t | t | z }t | dk rQt t | t | k s
J d t d | D | _ dS )z
Pass in a dictionary-like object mapping from old names to new
names. E.g. {'ConfigParser': 'configparser', 'cPickle': 'pickle'}
r z/Ambiguity in renaming (handler not implemented)c 3 $ K | ] \ }}||fV d S N ).0oldnews r/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib/python3.11/site-packages/future/standard_library/__init__.py z(RenameImport.__init__.. s* O OjsCSz O O O O O O N)
old_to_newsetkeysvalueslendictitems
new_to_old)selfrR boths rO __init__zRenameImport.__init__ s
%:??$$%%J,=,=,?,?(@(@@D QC
))++,,--Z5F5F5H5H1I1IIII@ JIJ O OJz,RenameImport.find_module.. s& G G G!aggcll1o G G GrQ )rS rY )rZ fullnamepathnew_base_namess rO find_modulezRenameImport.find_module s5 G Gt G G GHH ~ % %KtrQ c d }|t j v rt j | S || j v r#| j | }| | }n| | }|t j |< |S rJ )r. modulesrY _find_and_load_module)rZ namerd oldnamemodules rO load_modulezRenameImport.load_module su 3; ;t$ $
T_
$
$od+G//88FF //55F " D
rQ c 0 | d }t | dk r| d }| || } |j }ny# t
$ rl t d | |t j
v rt j
| cY S t d Y nw xY wt | dk |d }t j || }t j
|g|R S )zb
Finds and loads it. But if there's a . in the name, handles it
properly.
r_ r z Package {0} has no __path__.zWhat to do here?)r` rV popri __path__AttributeErrorflogdebugformatr. rh imprf rm )rZ rj rd bits packagenamepackage module_infos rO ri z"RenameImport._find_and_load_module s
zz#$ii!mm ((1++K00dCCG
/ '!
/
/
/
9@@IIJJJ3;&& ;t,,,,
-.....
/
$ii!mm AwodD11 t2k2222s A AC6CCrJ ) __name__
__module__ __qualname____doc__RENAMERr\ rf rm ri rK rQ rO rG rG sn G
P
P
P
3 3 3 3 3 3rQ rG c e Zd ZdZd Zd ZdS )hooksa
Acts as a context manager. Saves the state of sys.modules and restores it
after the 'with' block.
Use like this:
>>> from future import standard_library
>>> with standard_library.hooks():
... import http.client
>>> import requests
For this to work, http.client will be scrubbed from sys.modules after the
'with' block. That way the modules imported in the 'with' block will
continue to be accessible in the current namespace but not from any
imported modules (like requests).
c t j t j | _ t | _ t
| S rJ )copyr. rh old_sys_modules detect_hookshooks_were_installed
install_hooksrZ s rO __enter__zhooks.__enter__A s0 #y 5 5 $0NN! rQ c 4 | j st d S d S rJ )r remove_hooksrZ argss rO __exit__zhooks.__exit__I s& ( NNNNN rQ Nr{ r| r} r~ r r rK rQ rO r r 0 s< rQ r c $ t rdS dt j vr~t j t
j t j g}d |D }t t | dk s t
d|z |d t _ | j t j v rdS t | d rUt
j | j }|d t j r d |d vrdS dS )
z
Tries to infer whether the module m is from the Python 2 standard library.
This may not be reliable on all systems.
F stdlib_pathc X g | ]'}t j | d (S )r )osrd r` )rL fs rO rb z(is_py2_stdlib_module.._ s+ BBB
a((+BBBrQ ro z>> from future import standard_library
>>> standard_library.install_hooks()
>>> import http.client
>>> # ...
>>> with standard_library.suspend_hooks():
>>> import requests # incompatible with ``future``'s standard library hooks
If the hooks were disabled before the context, they are not installed when
the context is left.
c H t | _ t | S rJ )r r r r s rO r zsuspend_hooks.__enter__ s $0NN! rQ c 4 | j rt d S d S rJ )r r r s rO r zsuspend_hooks.__exit__ s$ $ OOOOO rQ Nr rK rQ rO r r s< rQ r c * t t j t | z }t | dk r7t | d }t d | t j | dS )zp
Add any previously scrubbed modules back to the sys.modules cache,
but only if it's safe to do so.
r z(future module {} clashes with Py2 moduleN)rS r. rh rV list ImportErrorru update)r clashfirsts rO restore_sys_modulesr sx
s8}} ,E
5zzQU AD!6%==* * *Kx rQ c t rdS t D ]j\ } }}}t | t j | }t | t j | }t || }t
||| kddl}ddlm } ddlm
} ddlm }
ddlm } ddlm
} ||_ | |_
|
|_ | |_ | |_
|t j d< | t j d < |
t j d
< | t j d < | t j d < ddl}
n# t $ r Y nw xY w dd
lm} ||
_ |t j d< n# t $ r Y nw xY w ddl}ddlm} ||_ |t j d< ddlm} ||_ |t j d< n# t $ r Y nw xY w ddlm} ||_ |t j d< dS # t $ r Y dS w xY w# t $ r Y dS w xY w)zm
Monkey-patches the standard library in Py2.6/7 to provide
aliases for better Py3 compatibility.
Nr )request)response)parse)error) robotparserzurllib.requestzurllib.responsez urllib.parsez urllib.errorzurllib.robotparser)supportz test.support)dumbzdbm.dumb)gnuzdbm.gnu)ndbmzdbm.ndbm)r MOVES
__import__r. rh getattrsetattrr
future.backports.urllibr r r r r r r future.moves.testr r future.moves.dbmr r r )
newmodname
newobjname
oldmodname
oldobjnamenewmodoldmodobjr
r r r r r r r r r r r s rO install_aliasesr s
=B ) )8ZZ: Z( : Z(fj))
C(((( MMM//////000000------------333333 FN FOFLFL$F$+CK !%-CK!""'CK "'CK (3CK$%
.------ &- N##
+
*)))))"& J ) , , , , , , CG%(CK " " D
+ - - - - - - CH&*CK
# # # DD
sZ
D
D D #E
E
E
G 2F
F F F> >
G G
G G c t rdS t t d t
j t d t t } t s t
j
| t d t
j dS )z`
This function installs the future.standard_library import hook into
sys.meta_path.
Nzsys.meta_path was: {0}zInstalling hooks ...zsys.meta_path is now: {0}) r r rs rt ru r. meta_pathrG r r append)newhooks rO r r s
JJ'..s}==>>>JJ%&&& 7##G >> &
W%%%JJ*11#-@@AAAAArQ c " t dS )z_
Deprecated. Use install_hooks() instead. This will be removed by
``future`` v1.0.
N)r rK rQ rO enable_hooksr s
OOOOOrQ Fc t rdS t d t t t
j ddd D ]"\ }}t |d r
t
j |= #| rt dS dS )zC
This function removes the import hook from sys.meta_path.
NzUninstalling hooks ...r ) r rs rt r enumerater. r r r )scrub_sys_modulesihooks rO r r ' s JJ'((( #-0011$$B$7 ! !4 4 # # !
a # """""# #rQ c " t dS )z^
Deprecated. Use remove_hooks() instead. This will be removed by
``future`` v1.0.
N)r rK rQ rO
disable_hooksr ; s
NNNNNrQ c t d t d t j D } | rt d nt d | S )zG
Returns True if the import hooks are installed, False if not.
zDetecting hooks ...c . g | ]}t |d S )r )r )rL r s rO rb z detect_hooks..H s" FFF74++FFFrQ z Detected.z
Not detected.)rs rt anyr. r )presents rO r r C si JJ$%%%FF
FFFGGG $
;
?### NrQ py2_modulesc t t j dk rdS t rJ ddl} | t j d< ddl}|t j d< ddl}|t j d< dS )z
Currently this function is unneeded, as we are not attempting to provide import hooks
for modules with ambiguous names: email, urllib, pickle.
r Nr
emailr )rV r. r r r
r r )r
r r s rO cache_py2_modulesr X ss
3?q ~~ MMM &COH LLL $COG MMM &COH rQ c ddl }t rt | S |rd}nd}| d | d z }g }t | D ]M\ }}d |d|dz }| | | Nt t t | D ]-\ }}|dk r n!t ||dz
||| .|d S )a
Pass a (potentially dotted) module name of a Python 3 standard library
module. This function imports the module compatibly on Py2 and Py3 and
returns the top-level module.
Example use:
>>> http = import_('http.client')
>>> http = import_('http.server')
>>> urllib = import_('urllib.request')
Then:
>>> conn = http.client.HTTPConnection(...)
>>> response = urllib.request.urlopen('http://mywebsite.com')
>>> # etc.
Use as follows:
>>> package_name = import_(module_name)
On Py3, equivalent to this:
>>> import module_name
On Py2, equivalent to this if backport=False:
>>> from future.moves import module_name
or to this if backport=True:
>>> from future.backports import module_name
except that it also handles dotted module names such as ``http.client``
The effect then is like this:
>>> from future.backports import module
>>> from future.backports.module import submodule
>>> module.submodule = submodule
Note that this would be a SyntaxError in Python:
>>> from future.backports import http.client
r Nfuture.backports future.movesr_ ro ) importlibr r r` r joinr
import_modulereversedr r ) module_namebackportr prefixpartsrh r partsofars rO import_r t s' \
+&&&
$'FF#F S!!K$5$5c$:$:: '' ; ;GAtHHU4AaC4[))E NN922599 : : : : Yu%5%5 6 677 4 4GAtAvv GAaCL$
3 3 3 3 qzrQ c X t rt | S d|v rt |d rd}nd}| d | d z }t |dz | z fd|D }t
| dk r|d S |S )aa
Example use:
>>> HTTPConnection = from_import('http.client', 'HTTPConnection')
>>> HTTPServer = from_import('http.server', 'HTTPServer')
>>> urlopen, urlparse = from_import('urllib.request', 'urlopen', 'urlparse')
Equivalent to this on Py3:
>>> from module_name import symbol_names[0], symbol_names[1], ...
and this on Py2:
>>> from future.moves.module_name import symbol_names[0], ...
or:
>>> from future.backports.module_name import symbol_names[0], ...
except that it also handles dotted module names such as ``http.client``.
r r r r_ c 0 g | ]}t | S rK )r )rL rj rl s rO rb z from_import.. s# AAAD'&$''AAArQ ro r )r r boolr` r r rV )r symbol_nameskwargsr r outputrl s @rO from_importr s ,
+&&& D
);$<$< 'FF#F S!!K$5$5c$:$::((# )CDDAAAALAAA v;;! !9 MrQ c $ e Zd ZdZd Zd Zd ZdS ) exclude_local_folder_importsaZ
A context-manager that prevents standard library modules like configparser
from being imported from the local python-future source folder on Py3.
(This was need prior to v0.16.0 because the presence of a configparser
folder would otherwise have prevented setuptools from running on Py3. Maybe
it's not needed any more?)
c t | dk sJ || _ t d | j D rt d d S )Nr c g | ]}d |v S )r_ rK )rL r s rO rb z9exclude_local_folder_imports.__init__.. s 444Qq444rQ z%Dotted module names are not supported)rV module_namesr NotImplementedErrorr s rO r\ z%exclude_local_folder_imports.__init__ s[ 4yy1}}}} 44$"3444 5 5 O%&MNN N O OrQ c t j t j | _ t j t j | _ t j d dk rd S g d}| j D ]<t fd|D r t j =| j D ]$} t |d }# t $ r Y !w xY wd S )Nr )futurepast libfuturize
libpasteurizer
c g | ]?}t j t j | @S rK )r rd existsr )rL subfolderfolders rO rb z:exclude_local_folder_imports.__enter__.. sG ? ? ?! GNN27<< #B#BCC ? ? ?rQ )level) r r. rd old_sys_pathrh r version_infoallremover r r )rZ FUTURE_SOURCE_SUBFOLDERSr rl r s @rO r z&exclude_local_folder_imports.__enter__ s Ich / / #y 5 5 A " " F $b#a#a ' ( (F ? ? ? ?%=? ? ? @ @
( ''' "
A
#AQ///
s 2C
CCc | j t _ t | j t t j z
D ] }| j | t j |< d S rJ )r
r. rd rS r rT rh )rZ r r s rO r z%exclude_local_folder_imports.__exit__ sl $T)..0011C 8H8H8J8J4K4KK 5 5A ! 1! 4CKNN 5 5rQ N)r{ r| r} r~ r\ r r rK rQ rO r r sO O O O @5 5 5 5 5rQ r )r
r r r r r r r tkinterr r r r r c t t 5 t D ]"} t | # t $ r Y w xY w d d d d S # 1 swxY w Y d S rJ )r TOP_LEVEL_MODULESr r )r s rO import_top_level_modulesr ) s %'8 9 " A
1
s,
A*A
7A7AA A )F)7r~
__future__r r r r. loggingrv r typesr r getLoggerrs Formatter BASIC_FORMAT
_formatter
StreamHandler_handler setFormatter
addHandlersetLevelWARN future.utilsr r rS r r rV rU r objectrG r r r r r r r r r r r r r r r r r r r r r rK rQ rO r# s : :x A @ @ @ @ @ @ @ @ @
w ))
W
w 3
4
4
7 " " j ! ! !
gl ! ! ! ! ! ! ! ! 3:::;; % (6) * #+& !' & (5w< < F s33w~~ 33'7#8#8 899Q>>>>
lC3 C3 C3 C3 C36 C3 C3 C3L F D K 3ss7>>##$$ss3+C'D'DD E E J J J J < 2 F 4 ! ! ! K+ K+ K+`B B B( # # # #(
$ wsM"" CO' ' '8F F F FR# # #L45 45 45 45 456 45 45 45l rQ