1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
3

Q'íck"ã@s®dZddlmZddlZddlZddlmZmZddlm	Z	m
Z
dd„Zdd	d
„Zddd
„Z
dd„Zdd„Zdd„Zer¢yddlZeZWnek
r eZYnXdd„ZdS)zd
This code was taken from https://github.com/ActiveState/appdirs and modified
to suit our purposes.
é)Úabsolute_importN)ÚWINDOWSÚ
expanduser)ÚPY2Ú	text_typecCs€tr<tjjtdƒƒ}tr*t|tƒr*t|ƒ}tjj	||dƒ}n@t
jdkr^tdƒ}tjj	||ƒ}ntj
dtdƒƒ}tjj	||ƒ}|S)a5
    Return full path to the user-specific cache dir for this application.

        "appname" is the name of application.

    Typical user cache directories are:
        macOS:      ~/Library/Caches/<AppName>
        Unix:       ~/.cache/<AppName> (XDG default)
        Windows:    C:\Users\<username>\AppData\Local\<AppName>\Cache

    On Windows the only suggestion in the MSDN docs is that local settings go
    in the `CSIDL_LOCAL_APPDATA` directory. This is identical to the
    non-roaming app data dir (the default returned by `user_data_dir`). Apps
    typically put cache data somewhere *under* the given dir here. Some
    examples:
        ...\Mozilla\Firefox\Profiles\<ProfileName>\Cache
        ...\Acme\SuperApp\Cache\1.0

    OPINION: This function appends "Cache" to the `CSIDL_LOCAL_APPDATA` value.
    ÚCSIDL_LOCAL_APPDATAÚCacheÚdarwinz~/Library/CachesÚXDG_CACHE_HOMEz~/.cache)rÚosÚpathÚnormpathÚ_get_win_folderrÚ
isinstancerÚ_win_path_to_bytesÚjoinÚsysÚplatformrÚgetenv)Úappnamer©rú0/tmp/pip-build-l_bcah40/pip/pip/utils/appdirs.pyÚuser_cache_dirs
rFcCshtr,|rdpd}tjjtjjt|ƒƒ|ƒ}n8tjdkrJtjjtdƒ|ƒ}ntjjtj	dtdƒƒ|ƒ}|S)aS
    Return full path to the user-specific data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user data directories are:
        macOS:                  ~/Library/Application Support/<AppName>
        Unix:                   ~/.local/share/<AppName>    # or in
                                $XDG_DATA_HOME, if defined
        Win XP (not roaming):   C:\Documents and Settings\<username>\ ...
                                ...Application Data\<AppName>
        Win XP (roaming):       C:\Documents and Settings\<username>\Local ...
                                ...Settings\Application Data\<AppName>
        Win 7  (not roaming):   C:\Users\<username>\AppData\Local\<AppName>
        Win 7  (roaming):       C:\Users\<username>\AppData\Roaming\<AppName>

    For Unix, we follow the XDG spec and support $XDG_DATA_HOME.
    That means, by default "~/.local/share/<AppName>".
    Ú
CSIDL_APPDATArr	z~/Library/Application Support/Ú
XDG_DATA_HOMEz~/.local/share)
rrrrr
rrrrr)rÚroamingÚconstrrrrÚ
user_data_dir>s
rTcCsHtrt||d}n2tjdkr&t|ƒ}ntjdtdƒƒ}tjj||ƒ}|S)arReturn full path to the user-specific config dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "roaming" (boolean, default True) can be set False to not use the
            Windows roaming appdata directory. That means that for users on a
            Windows network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user data directories are:
        macOS:                  same as user_data_dir
        Unix:                   ~/.config/<AppName>
        Win *:                  same as user_data_dir

    For Unix, we follow the XDG spec and support $XDG_CONFIG_HOME.
    That means, by default "~/.config/<AppName>".
    )rr	ÚXDG_CONFIG_HOMEz	~/.config)	rrrrrrrrr)rrrrrrÚuser_config_dirjs

rcs€tr&tjjtdƒƒ}tjj|ˆƒg}nVtjdkrBtjjdˆƒg}n:tjddƒ}|rn‡fdd„|j	tj
ƒDƒ}ng}|jdƒ|S)	a‹Return a list of potential user-shared config dirs for this application.

        "appname" is the name of application.

    Typical user config directories are:
        macOS:      /Library/Application Support/<AppName>/
        Unix:       /etc or $XDG_CONFIG_DIRS[i]/<AppName>/ for each value in
                    $XDG_CONFIG_DIRS
        Win XP:     C:\Documents and Settings\All Users\Application ...
                    ...Data\<AppName>        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory
                    on Vista.)
        Win 7:      Hidden, but writeable on Win 7:
                    C:\ProgramData\<AppName>    ÚCSIDL_COMMON_APPDATAr	z/Library/Application SupportÚXDG_CONFIG_DIRSz/etc/xdgcsg|]}tjjt|ƒˆƒ‘qSr)rrrr)Ú.0Úx)rrrú
<listcomp>¥sz$site_config_dirs.<locals>.<listcomp>z/etc)rrrr
rrrrrÚsplitÚpathsepÚappend)rrÚpathlistÚxdg_config_dirsr)rrÚsite_config_dirs‹s


r*cCs:ddl}ddddœ|}|j|jdƒ}|j||ƒ\}}|S)z›
    This is a fallback technique at best. I'm not sure if using the
    registry for this guarantees us the correct answer for all CSIDL_*
    names.
    rNÚAppDatazCommon AppDataz
Local AppData)rr rz@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders)Ú_winregÚOpenKeyÚHKEY_CURRENT_USERÚQueryValueEx)Ú
csidl_namer,Úshell_folder_nameÚkeyÚ	directoryÚ_typerrrÚ_get_win_folder_from_registry³sr5cCs€ddddœ|}tjdƒ}tjjjd|dd|ƒd}x|D]}t|ƒdkr:d	}Pq:W|rztjdƒ}tjjj|j|dƒrz|}|jS)
Néé#é)rr rirFéÿT)	ÚctypesÚcreate_unicode_bufferÚwindllÚshell32ÚSHGetFolderPathWÚordÚkernel32ÚGetShortPathNameWÚvalue)r0Úcsidl_constÚbufÚ
has_high_charÚcÚbuf2rrrÚ_get_win_folder_with_ctypesÉs 


rHc
Cs6x0dD](}y
|j|ƒSttfk
r,YqXqW|S)a–Encode Windows paths to bytes. Only used on Python 2.

    Motivation is to be consistent with other operating systems where paths
    are also returned as bytes. This avoids problems mixing bytes and Unicode
    elsewhere in the codebase. For more details and discussion see
    <https://github.com/pypa/pip/issues/3463>.

    If encoding using ASCII and MBCS fails, return the original Unicode path.
    ÚASCIIÚMBCS)rIrJ)ÚencodeÚUnicodeEncodeErrorÚLookupError)rÚencodingrrrrés



r)F)T)Ú__doc__Ú
__future__rrrÚ
pip.compatrrZpip._vendor.sixrrrrrr*r5rHr:rÚImportErrorrrrrrÚ<module>s$0
,
!(