File: //proc/self/root/usr/lib/python2.7/site.pyc
, bc @ sp d Z d d l Z d d l Z d d l Z d d l Z e j e j g Z d a d a
d a d Z d Z
d Z d Z d Z d d Z d Z d
Z d Z d Z d
Z d Z d Z d Z d e f d YZ d Z d e f d YZ d Z d Z d Z d Z! d Z" d Z# e# d Z$ e% d k rle$ n d S( s
Append module search paths for third-party packages to sys.path.
****************************************************************
* This module is automatically imported during initialization. *
****************************************************************
In earlier versions of Python (up to 1.5a3), scripts or modules that
needed to use site-specific modules would place ``import site''
somewhere near the top of their code. Because of the automatic
import, this is no longer necessary (but code that does it still
works).
This will append site-specific paths to the module search path. On
Unix (including Mac OSX), it starts with sys.prefix and
sys.exec_prefix (if different) and appends
lib/python<version>/site-packages as well as lib/site-python.
On other platforms (such as Windows), it tries each of the
prefixes directly, as well as with lib/site-packages appended. The
resulting directories, if they exist, are appended to sys.path, and
also inspected for path configuration files.
For Debian and derivatives, this sys.path is augmented with directories
for packages distributed within the distribution. Local addons go
into /usr/local/lib/python<version>/dist-packages, Debian addons
install into /usr/{lib,share}/python<version>/dist-packages.
/usr/lib/python<version>/site-packages is not used.
A path configuration file is a file whose name has the form
<package>.pth; its contents are additional directories (one per line)
to be added to sys.path. Non-existing directories (or
non-directories) are never added to sys.path; no directory is added to
sys.path more than once. Blank lines and lines beginning with
'#' are skipped. Lines starting with 'import' are executed.
For example, suppose sys.prefix and sys.exec_prefix are set to
/usr/local and there is a directory /usr/local/lib/python2.5/site-packages
with three subdirectories, foo, bar and spam, and two path
configuration files, foo.pth and bar.pth. Assume foo.pth contains the
following:
# foo package configuration
foo
bar
bletch
and bar.pth contains:
# bar package configuration
bar
Then the following directories are added to sys.path, in this order:
/usr/local/lib/python2.5/site-packages/bar
/usr/local/lib/python2.5/site-packages/foo
Note that bletch is omitted because it doesn't exist; bar precedes foo
because bar.pth comes alphabetically before foo.pth; and spam is
omitted because it is not mentioned in either path configuration file.
After these path manipulations, an attempt is made to import a module
named sitecustomize, which can perform arbitrary additional
site-specific customizations. If this import fails with an
ImportError exception, it is silently ignored.
iNc G sR t j j | } y t j j | } Wn t k
r; n X| t j j | f S( N( t ost patht joint abspatht OSErrort normcase( t pathst dir( ( s /usr/lib/python2.7/site.pyt makepathU s
c C si xb t j j D]Q } t | d r+ q n y t j j | j | _ Wq t t f k
r` q Xq Wd S( s6 Set all module' __file__ attribute to an absolute patht
__loader__N(
t syst modulest valuest hasattrR R R t __file__t AttributeErrorR ( t m( ( s /usr/lib/python2.7/site.pyt abs__file__^ s c C sl g } t } xL t j D]A } t | \ } } | | k r | j | | j | q q W| t j (| S( sK Remove duplicate entries from sys.path along with making them
absolute( t setR
R R t appendt add( t Lt known_pathsR t dircase( ( s /usr/lib/python2.7/site.pyt removeduppathsi s
c C sp t } x` t j D]U } y8 t j j | rP t | \ } } | j | n Wq t k
rg q q Xq W| S( sD Return a set containing all existing directory entries from sys.path( R R
R R t isdirR R t TypeError( t dR R ( ( s /usr/lib/python2.7/site.pyt _init_pathinfo| s
c B s | d k r e d } n d } e j j | | } y e | d } Wn e k
r^ d SX| @x8e | D]*\ } } | j d r qs n y | j d r | d Uws n | j } e
| | \ } } | | k re j j | re j j
| | j | n Wqs e k
r}
e j d j | d | IJxE e j e j D]. } x% | j D] } e j d | IJqlWqYWe j d
IJPqs Xqs WWd QX| rd } n | S( s Process a .pth file within the site-packages directory:
For each line in the file, either combine it with sitedir to a path
and add that to known_paths, or execute it if it starts with 'import '.
i i t rUNt #s import s import s" Error processing line {:d} of {}:
s s
Remainder of file ignored( s import s import ( t NoneR R R R t opent IOErrort enumeratet
startswitht rstripR t existsR
R R t Exceptiont stderrt formatt tracebackt format_exceptiont exc_infot
splitlines( t sitedirt nameR t resett fullnamet ft nt lineR R t errt record( ( s /usr/lib/python2.7/site.pyt
addpackage sB
c C s | d k r t } d } n d } t | \ } } | | k rU t j j | n y t j | } Wn t j k
r d SXt j d } g | D] } | j
| r | ^ q } x$ t | D] } t | | | q W| r d } n | S( sT Add 'sitedir' argument to sys.path if missing and handle .pth files in
'sitedir'i i Nt pth(
R R R R
R R R t listdirt errort extsept endswitht sortedR6 ( R- R R/ t sitedircaset namest dotpthR. ( ( s /usr/lib/python2.7/site.pyt
addsitedir s$
( c C s t j j r t St t d rM t t d rM t j t j k rM d Sn t t d r t t d r t j t j
k r d Sn t S( s, Check if user site directory is safe for inclusion
The function tests for the command line flag (including environment var),
process uid/gid equal to effective uid/gid.
None: Disabled for security reasons
False: Disabled by user (command line option)
True: Safe and enabled
t getuidt geteuidt getgidt getegidN( R
t flagst no_user_sitet FalseR
R RB RA R RD RC t True( ( ( s /usr/lib/python2.7/site.pyt check_enableusersite s
c C s0 t d k r t Sd d l m } | d a t S( s Returns the `user base` directory path.
The `user base` directory can be used to store data. If the global
variable ``USER_BASE`` is not initialized yet, this function will also set
it.
i( t get_config_vart userbaseN( t USER_BASER t sysconfigRJ ( RJ ( ( s /usr/lib/python2.7/site.pyt getuserbase s
c C s t } t d k r t Sd d l m } d d l } t j d k rv d d l m } | d rv | d d a t Sn | d d | j a t S(
s Returns the user-specific site-packages directory path.
If the global variable ``USER_SITE`` is not initialized yet, this
function will also set it.
i( t get_pathNt darwin( RJ t PYTHONFRAMEWORKt purelibt osx_framework_users %s_user(
RN t USER_SITER RM RO R R
t platformRJ R. ( t user_baseRO R RJ ( ( s /usr/lib/python2.7/site.pyt getusersitepackages s c C s t } t r1 t j j | r1 t | | n t r xY d D]N } t j j t | d t j d d } t j j | r> t | | q> q> Wn | S( s Add a per user site-package to sys.path
Each user has its own python directory with site-packages in the
home directory.
s local/libt libt pythoni s
dist-packages( s local/libRX (
RW t ENABLE_USER_SITER R R R@ R RL R
t version( R t user_sitet dist_libdir( ( s /usr/lib/python2.7/site.pyt addusersitepackages s
c C s g } t } x t D] } | s | | k r5 q n | j | t j d k rs | j t j j | d d q t j d k r | j t j j | d d t j
d d | j t j j | d
d t j
d d q | j | | j t j j | d
d q W| S( s+ Returns a list containing all global site-packages directories
(and possibly site-python).
For each directory present in the global ``PREFIXES``, this function
will find its `site-packages` subdirectory depending on the system
environment, and will return a list of full paths.
t os2emxt riscost Libs
site-packagest /s local/libRY i s
dist-packagesRX ( R_ R` ( R t PREFIXESR R
RU R R R R t sepR[ ( t sitepackagest seent prefix( ( s /usr/lib/python2.7/site.pyt getsitepackages s$
"
#c C s: x3 t D]( } t j j | r
t | | q
q
W| S( s8 Add site-packages (and possibly site-python) to sys.path( Rh R R R R@ ( R R- ( ( s /usr/lib/python2.7/site.pyt addsitepackages; s c C so t j j t j d d } t j d j d } | d rK | j | n
| | d <d j | t j d <d S( sE The OS/2 EMX port has optional extension modules that do double duty
as DLLs (and must use the .DLL file extension) for other extensions.
The library search path needs to be amended so these will be found
during module import. Use BEGINLIBPATH so that these are at the start
of the library search path.
Ra s lib-dynloadt BEGINLIBPATHt ;iN( R R R R
Rg t environt splitR ( t dllpatht libpath( ( s /usr/lib/python2.7/site.pyt setBEGINLIBPATHC s
c st t j d k r d n t j d k r0 d n d d t f f d Y} | d t _ | d t _ d
S( s Define new builtins 'quit' and 'exit'.
These are objects which make the interpreter exit when called.
The repr of each object contains a hint at how it works.
t :s Cmd-Qs \s Ctrl-Z plus Returns Ctrl-D (i.e. EOF)t Quitterc s, e Z d Z f d Z d d Z RS( c S s
| | _ d S( N( R. ( t selfR. ( ( s /usr/lib/python2.7/site.pyt __init__c s c s d | j f S( Ns Use %s() or %s to exit( R. ( Rs ( t eof( s /usr/lib/python2.7/site.pyt __repr__e s c S s+ y t j j Wn n Xt | d S( N( R
t stdint closet
SystemExit( Rs t code( ( s /usr/lib/python2.7/site.pyt __call__g s
N( t __name__t
__module__Rt Rv R R{ ( ( Ru ( s /usr/lib/python2.7/site.pyRr b s t quitt exitN( R Rd t objectt __builtin__R~ R ( Rr ( ( Ru s /usr/lib/python2.7/site.pyt setquitT s
t _Printerc B s> e Z d Z d Z d d d Z d Z d Z d Z RS( sn interactive prompt objects for printing the license text, a list of
contributors and the copyright notice.i c C s1 | | _ | | _ | | _ | | _ d | _ d S( N( t _Printer__namet _Printer__datat _Printer__filest _Printer__dirsR t _Printer__lines( Rs R. t datat filest dirs( ( s /usr/lib/python2.7/site.pyRt y s
c C s | j r
d Sd } x | j D]w } xd | j D]Y } t j j | | } y* t | d } | j } | j PWq- t
k
r q- Xq- W| r Pq q W| s | j } n | j d | _ t
| j | _ d S( NR s
( R R R R R R R t filet readRx R! R Rm t lent _Printer__linecnt( Rs R R t filenamet fp( ( s /usr/lib/python2.7/site.pyt __setup s&
c C sH | j t | j | j k r2 d j | j Sd | j f d Sd S( Ns
s! Type %s() to see the full %s texti ( t _Printer__setupR R t MAXLINESR R ( Rs ( ( s /usr/lib/python2.7/site.pyRv s
c C s | j d } d } x y1 x* t | | | j D] } | j | GHq3 WWn t k
r^ Pq X| | j 7} d } x1 | d k r t | } | d k ru d } qu qu W| d k r Pq q Wd S( Ns0 Hit Return for more, or q (and Return) to quit: i t t q( R R ( R t rangeR R t
IndexErrorR t raw_input( Rs t promptt linenot it key( ( s /usr/lib/python2.7/site.pyR{ s"
( ( ( R| R} t __doc__R Rt R Rv R{ ( ( ( s /usr/lib/python2.7/site.pyR s s c C s t d t j t _ t j d d k r= t d d t _ n t d d t _ t j j t j } t d d d d
g t j j
| t j | t j g t _
d S( s, Set 'copyright' and 'credits' in __builtin__t copyrighti t javat creditss? Jython is maintained by the Jython developers (www.jython.org).s Thanks to CWI, CNRI, BeOpen.com, Zope Corporation and a cast of thousands
for supporting Python development. See www.python.org for more information.t licenses' See https://www.python.org/psf/license/s LICENSE.txtt LICENSEN( R R
R R RU R R R t dirnameR R t pardirt curdirR ( t here( ( s /usr/lib/python2.7/site.pyt setcopyright s t _Helperc B s e Z d Z d Z d Z RS( sX Define the builtin 'help'.
This is a wrapper around pydoc.help (with a twist).
c C s d S( NsH Type help() for interactive help, or help(object) for help about object.( ( Rs ( ( s /usr/lib/python2.7/site.pyRv s c O s d d l } | j | | S( Ni( t pydoct help( Rs t argst kwdsR ( ( s /usr/lib/python2.7/site.pyR{ s ( R| R} R Rv R{ ( ( ( s /usr/lib/python2.7/site.pyR s c C s t t _ d S( N( R R R ( ( ( s /usr/lib/python2.7/site.pyt sethelper s c C s t j d k r d d l } d d l } | j d } | j d r y | j | Wq t k
r d d l } | j | j
| <d | j j | <q Xq n d S( s On Windows, some default encodings are not provided by Python,
while they are always available as "mbcs" in each locale. Make
them usable by aliasing to "mbcs" in such a case.t win32iNi t cpt mbcs( R
RU t localet codecst getdefaultlocaleR# t lookupt LookupErrort encodingst _unknownt _cachet aliases( R R t encR ( ( s /usr/lib/python2.7/site.pyt aliasmbcs s
c C s& d } | d k r" t j | n d S( s Set the string encoding used by the Unicode implementation. The
default is 'ascii', but if you're willing to experiment, you can
change this.t asciiN( R
t setdefaultencoding( t encoding( ( s /usr/lib/python2.7/site.pyt setencoding s c C sg y d d l } WnP t k
r# n@ t k
rb t j j rR t j t j qc t j d IJn Xd S( s, Run custom site specific code, if available.iNs3 'import sitecustomize' failed; use -v for traceback( t
sitecustomizet ImportErrorR& R
RE t verboset
excepthookR+ R' ( R ( ( s /usr/lib/python2.7/site.pyt execsitecustomize s
c C sg y d d l } WnP t k
r# n@ t k
rb t j j rR t j t j qc t j d IJn Xd S( s, Run custom user specific code, if available.iNs3 'import usercustomize' failed; use -v for traceback( t
usercustomizeR R& R
RE R R R+ R' ( R ( ( s /usr/lib/python2.7/site.pyt execusercustomize s
c C s t t } t d k r( t a n t | } t | } t j d k rY t n t
t t t
t t t r t n t t d r t ` n d S( NR_ R ( R R RZ R RI R^ Ri R
RU Rp R R R R R R R R
R ( R ( ( s /usr/lib/python2.7/site.pyt main s$
c C s d } t j d } | s d GHx t j D] } d | f GHq( Wd GHd t t j j t ra d n d f GHd t t j j t r d n d f GHd
t GHt j d n g } d | k r | j t n d
| k r | j t n | r]t j
j | GHt rt j d qt t k r1t j d qt d k rMt j d qt j d n; d d l } | j | t j d t j
f GHt j d d S( Ns %s [--user-base] [--user-site]
Without arguments print some useful information
With arguments print the value of USER_BASE and/or USER_SITE separated
by '%s'.
Exit codes with --user-base or --user-site:
0 - user site directory is enabled
1 - user site directory is disabled by user
2 - uses site directory is disabled by super user
or for security reasons
>2 - unknown error
i s sys.path = [s %r,t ]s USER_BASE: %r (%s)R% s
doesn't exists USER_SITE: %r (%s)s ENABLE_USER_SITE: %ri s --user-bases --user-sitei i ii
( R
t argvR RL R R RT RZ R R t pathsepR RG R t textwrapt dedent( R R R t bufferR ( ( s /usr/lib/python2.7/site.pyt _script, s<
!! "t __main__(& R R
R R R) Rg t exec_prefixRc R RZ RT RL R R R R R6 R@ RI RN RW R^ Rh Ri Rp R R R R R R R R R R R R R| ( ( ( s /usr/lib/python2.7/site.pyt <module>A sF
) =
1