U
|
H=®d3e ã @ s d Z dZedd e d¡D ZddlZddlZejd dkZerFe Z
|
ej d¡rddl Z e ¡ d d Ze d ¡rzd
|
Zq°e d ¡rd Zq°d Zn ej dkrªejdkrªd
|
Znej Zd:ddZd;ddZd<ddZd=ddZd>ddZd?d d Zd@d d ZG d d! d!eZd"d# Zd$d% Zd&d' Z d(d) Z ed
|
krzdd*l m Z e Z W nB e!k
|
r zddl"Z#e Z W n e!k
|
r eZ Y nX Y nX d+d, Z$e%d-krd.Z&d/Z'd0Z(e)d1e e)d2 ee&e'd3d4Z*e(D ] Z+e)d5e+e,e*e+f qÌe)d6 ee&e'Z*e(D ] Z+e)d5e+e,e*e+f q e)d7 ee&Z*e(D ] Z+e)d5e+e,e*e+f q2e)d8 ee&dd9Z*e(D ] Z+e)d5e+e,e*e+f qhdS )AzyUtilities for determining application-specific dirs.
|
|
See <http://github.com/ActiveState/appdirs> for details and usage.
|
z1.4.4c c s | ]}t |V qd S ©N)Úint)Ú.0Úsegment© r úJD:\z\workplace\VsCode\pyvenv\venv\Lib\site-packages\pip/_vendor/appdirs.pyÚ <genexpr> s r Ú.é Né ÚjavaÚWindowsÚwin32ZMacÚdarwinZlinux2ÚcliÚntFc C sÆ t dkr^|dkr| }|r dp d}tj t|¡}| r¬|dk rNtj ||| ¡}q¬tj || ¡}nNt dkrtj d¡}| r¬tj || ¡}n&t dtj d ¡¡}| r¬tj || ¡}| rÂ|rÂtj ||¡}|S )
|
a 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.
|
"appauthor" (only used on Windows) is the name of the
|
appauthor or distributing body for this application. Typically
|
it is the owning company name. This falls back to appname. You may
|
pass False to disable it.
|
"version" is an optional version path element to append to the
|
path. You might want to use this if you want multiple versions
|
of your app to be able to run independently. If used, this
|
would typically be "<major>.<minor>".
|
Only applied when appname is present.
|
"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:
|
Mac OS X: ~/Library/Application Support/<AppName> # or ~/.config/<AppName>, if the other does not exist
|
Unix: ~/.local/share/<AppName> # or in $XDG_DATA_HOME, if defined
|
Win XP (not roaming): C:\Documents and Settings\<username>\Application Data\<AppAuthor>\<AppName>
|
Win XP (roaming): C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>
|
Win 7 (not roaming): C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>
|
Win 7 (roaming): C:\Users\<username>\AppData\Roaming\<AppAuthor>\<AppName>
|
|
For Unix, we follow the XDG spec and support $XDG_DATA_HOME.
|
That means, by default "~/.local/share/<AppName>".
|
r NÚ CSIDL_APPDATAÚCSIDL_LOCAL_APPDATAFr z ~/Library/Application Support/Ú XDG_DATA_HOMEz~/.local/share)ÚsystemÚosÚpathÚnormpathÚ_get_win_folderÚjoinÚ
|
expanduserÚgetenv)ÚappnameÚ appauthorÚversionÚroamingÚconstr r r r Ú user_data_dir1 s& r! c s t dkrR|dkr }tj td¡} rî|dk rBtj || ¡}qîtj | ¡}nt dkrztj d¡} rîtj | ¡}ntt dtj dd g¡¡}d
|
d | tj¡D } rÐ|r¾tj |¡ fd d |D }|râtj |¡}n|d }|S r|rtj ||¡}|S )ai Return full path to the user-shared data dir for this application.
|
|
"appname" is the name of application.
|
If None, just the system directory is returned.
|
"appauthor" (only used on Windows) is the name of the
|
appauthor or distributing body for this application. Typically
|
it is the owning company name. This falls back to appname. You may
|
pass False to disable it.
|
"version" is an optional version path element to append to the
|
path. You might want to use this if you want multiple versions
|
of your app to be able to run independently. If used, this
|
would typically be "<major>.<minor>".
|
Only applied when appname is present.
|
"multipath" is an optional parameter only applicable to *nix
|
which indicates that the entire list of data dirs should be
|
returned. By default, the first item from XDG_DATA_DIRS is
|
returned, or '/usr/local/share/<AppName>',
|
if XDG_DATA_DIRS is not set
|
|
Typical site data directories are:
|
Mac OS X: /Library/Application Support/<AppName>
|
Unix: /usr/local/share/<AppName> or /usr/share/<AppName>
|
Win XP: C:\Documents and Settings\All Users\Application Data\<AppAuthor>\<AppName>
|
Vista: (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.)
|
Win 7: C:\ProgramData\<AppAuthor>\<AppName> # Hidden, but writeable on Win 7.
|
|
For Unix, this is using the $XDG_DATA_DIRS[0] default.
|
|
WARNING: Do not use this on Windows. See the Vista-Fail note above for why.
|
r NÚCSIDL_COMMON_APPDATAFr z /Library/Application SupportÚ XDG_DATA_DIRSz/usr/local/sharez
|
/usr/sharec S s g | ]}t j | t j¡¡qS r ©r r r ÚrstripÚsep©r Úxr r r Ú
|
<listcomp> s z!site_data_dir.<locals>.<listcomp>c s g | ]}t j | ¡qS r ©r r r r' ©r r r r) s r )
|
r r r r r r r r ÚpathsepÚsplit©r r r Ú multipathr Úpathlistr r+ r Ú site_data_dirh s6 ÿ r1 c C sX t dkrt| |d|}n&t dtj d¡¡}| r>tj || ¡}| rT|rTtj ||¡}|S )aÔ Return 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.
|
"appauthor" (only used on Windows) is the name of the
|
appauthor or distributing body for this application. Typically
|
it is the owning company name. This falls back to appname. You may
|
pass False to disable it.
|
"version" is an optional version path element to append to the
|
path. You might want to use this if you want multiple versions
|
of your app to be able to run independently. If used, this
|
would typically be "<major>.<minor>".
|
Only applied when appname is present.
|
"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 config directories are:
|
Mac OS X: same as user_data_dir
|
Unix: ~/.config/<AppName> # or in $XDG_CONFIG_HOME, if defined
|
Win *: same as user_data_dir
|
|
For Unix, we follow the XDG spec and support $XDG_CONFIG_HOME.
|
That means, by default "~/.config/<AppName>".
|
©r r NÚXDG_CONFIG_HOMEz ~/.config©r r! r r r r r ©r r r r r r r r Úuser_config_dirª s r6 c s t dkr*t |} r|rtj ||¡}nft d¡p6d}dd | tj¡D } rv|rdtj |¡ fdd|D }|rtj |¡}n|d }|S )a Return full path to the user-shared data dir for this application.
|
|
"appname" is the name of application.
|
If None, just the system directory is returned.
|
"appauthor" (only used on Windows) is the name of the
|
appauthor or distributing body for this application. Typically
|
it is the owning company name. This falls back to appname. You may
|
pass False to disable it.
|
"version" is an optional version path element to append to the
|
path. You might want to use this if you want multiple versions
|
of your app to be able to run independently. If used, this
|
would typically be "<major>.<minor>".
|
Only applied when appname is present.
|
"multipath" is an optional parameter only applicable to *nix
|
which indicates that the entire list of config dirs should be
|
returned. By default, the first item from XDG_CONFIG_DIRS is
|
returned, or '/etc/xdg/<AppName>', if XDG_CONFIG_DIRS is not set
|
|
Typical site config directories are:
|
Mac OS X: same as site_data_dir
|
Unix: /etc/xdg/<AppName> or $XDG_CONFIG_DIRS[i]/<AppName> for each value in
|
$XDG_CONFIG_DIRS
|
Win *: same as site_data_dir
|
Vista: (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.)
|
|
For Unix, this is using the $XDG_CONFIG_DIRS[0] default, if multipath=False
|
|
WARNING: Do not use this on Windows. See the Vista-Fail note above for why.
|
r2 ÚXDG_CONFIG_DIRSz/etc/xdgc S s$ g | ] }|rt j | t j¡¡qS r r$ r' r r r r) û s z#site_config_dir.<locals>.<listcomp>c s g | ]}t j | ¡qS r r* r' r+ r r r) ÿ s r )r r1 r r r r r- r, r. r r+ r Úsite_config_dirÔ s
|
r8 Tc C sâ t dkrz|dkr| }tj td¡}ts:t|tr:t|}| rÈ|dk rXtj ||| ¡}ntj || ¡}|rÈtj |d¡}nNt dkr¢tj
|
d¡}| rÈtj || ¡}n&t dtj
|
d ¡¡}| rÈtj || ¡}| rÞ|rÞtj ||¡}|S )
|
a Return full path to the user-specific cache dir for this application.
|
|
"appname" is the name of application.
|
If None, just the system directory is returned.
|
"appauthor" (only used on Windows) is the name of the
|
appauthor or distributing body for this application. Typically
|
it is the owning company name. This falls back to appname. You may
|
pass False to disable it.
|
"version" is an optional version path element to append to the
|
path. You might want to use this if you want multiple versions
|
of your app to be able to run independently. If used, this
|
would typically be "<major>.<minor>".
|
Only applied when appname is present.
|
"opinion" (boolean) can be False to disable the appending of
|
"Cache" to the base app data dir for Windows. See
|
discussion below.
|
|
Typical user cache directories are:
|
Mac OS X: ~/Library/Caches/<AppName>
|
Unix: ~/.cache/<AppName> (XDG default)
|
Win XP: C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>\Cache
|
Vista: C:\Users\<username>\AppData\Local\<AppAuthor>\<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` above). 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.
|
This can be disabled with the `opinion=False` option.
|
r Nr FÚCacher z~/Library/CachesÚXDG_CACHE_HOMEz~/.cache) r r r r r ÚPY3Ú
|
isinstanceÚunicodeÚ_win_path_to_bytesr r r ©r r r Úopinionr r r r Úuser_cache_dir s, ! rA c C sX t dkrt| |d|}n&t dtj d¡¡}| r>tj || ¡}| rT|rTtj ||¡}|S )a Return full path to the user-specific state dir for this application.
|
|
"appname" is the name of application.
|
If None, just the system directory is returned.
|
"appauthor" (only used on Windows) is the name of the
|
appauthor or distributing body for this application. Typically
|
it is the owning company name. This falls back to appname. You may
|
pass False to disable it.
|
"version" is an optional version path element to append to the
|
path. You might want to use this if you want multiple versions
|
of your app to be able to run independently. If used, this
|
would typically be "<major>.<minor>".
|
Only applied when appname is present.
|
"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 state directories are:
|
Mac OS X: same as user_data_dir
|
Unix: ~/.local/state/<AppName> # or in $XDG_STATE_HOME, if defined
|
Win *: same as user_data_dir
|
|
For Unix, we follow this Debian proposal <https://wiki.debian.org/XDGBaseDirectorySpecification#state>
|
to extend the XDG spec and support $XDG_STATE_HOME.
|
|
That means, by default "~/.local/state/<AppName>".
|
r2 NÚXDG_STATE_HOMEz~/.local/stater4 r5 r r r Úuser_state_dirE s rC c C s t dkr tj tj d¡| ¡}nNt dkrLt| ||}d}|rntj |d¡}n"t| ||}d}|rntj |d¡}| r|rtj ||¡}|S )a½ Return full path to the user-specific log dir for this application.
|
|
"appname" is the name of application.
|
If None, just the system directory is returned.
|
"appauthor" (only used on Windows) is the name of the
|
appauthor or distributing body for this application. Typically
|
it is the owning company name. This falls back to appname. You may
|
pass False to disable it.
|
"version" is an optional version path element to append to the
|
path. You might want to use this if you want multiple versions
|
of your app to be able to run independently. If used, this
|
would typically be "<major>.<minor>".
|
Only applied when appname is present.
|
"opinion" (boolean) can be False to disable the appending of
|
"Logs" to the base app data dir for Windows, and "log" to the
|
base cache dir for Unix. See discussion below.
|
|
Typical user log directories are:
|
Mac OS X: ~/Library/Logs/<AppName>
|
Unix: ~/.cache/<AppName>/log # or under $XDG_CACHE_HOME if defined
|
Win XP: C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>\Logs
|
Vista: C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>\Logs
|
|
On Windows the only suggestion in the MSDN docs is that local settings
|
go in the `CSIDL_LOCAL_APPDATA` directory. (Note: I'm interested in
|
examples of what some windows apps use for a logs dir.)
|
|
OPINION: This function appends "Logs" to the `CSIDL_LOCAL_APPDATA`
|
value for Windows and appends "log" to the user cache dir for Unix.
|
This can be disabled with the `opinion=False` option.
|
r z~/Library/Logsr FÚLogsÚlog)r r r r r r! rA r? r r r Ú user_log_diro s"
|
þ rF c @ sn e Zd ZdZdddZedd Zedd Zed
|
d Zed d Z edd Z
|
edd Z edd Z dS )ÚAppDirsz1Convenience wrapper for getting application dirs.NFc C s" || _ || _|| _|| _|| _d S r )r r r r r/ )Úselfr r r r r/ r r r Ú__init__¤ s
|
zAppDirs.__init__c C s t | j| j| j| jdS ©N)r r )r! r r r r ©rH r r r r! ¬ s
|
ÿzAppDirs.user_data_dirc C s t | j| j| j| jdS ©N)r r/ )r1 r r r r/ rK r r r r1 ± s
|
ÿzAppDirs.site_data_dirc C s t | j| j| j| jdS rJ )r6 r r r r rK r r r r6 ¶ s
|
ÿzAppDirs.user_config_dirc C s t | j| j| j| jdS rL )r8 r r r r/ rK r r r r8 » s
|
ÿzAppDirs.site_config_dirc C s t | j| j| jdS ©N©r )rA r r r rK r r r rA À s
|
ÿzAppDirs.user_cache_dirc C s t | j| j| jdS rM )rC r r r rK r r r rC Å s
|
ÿzAppDirs.user_state_dirc C s t | j| j| jdS rM )rF r r r rK r r r rF Ê s
|
ÿzAppDirs.user_log_dir)NNNFF) Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__rI Úpropertyr! r1 r6 r8 rA rC rF r r r r rG ¢ s& ÿ
|
|
|
|
|
|
|
rG c C sH t rddl}nddl}dddd| }| |jd¡}| ||¡\}}|S )zThis 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.
|
r NÚAppDatazCommon AppDataz Local AppData©r r" r z@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders)r; ÚwinregÚ_winregÚOpenKeyÚHKEY_CURRENT_USERÚ QueryValueEx)Ú
|
csidl_namerW Úshell_folder_nameÚkeyÚdirÚtyper r r Ú _get_win_folder_from_registryÒ s
|
ýüþr` c C s ddl m}m} | dt|| dd¡}z^t|}d}|D ]}t|dkr8d} qRq8|rzdd l}| |¡}W n t k
|
r Y nX W n t
|
k
|
r Y nX |S )Nr )ÚshellconÚshellFéÿ T) Úwin32com.shellra rb ÚSHGetFolderPathÚgetattrr= ÚordÚwin32apiÚGetShortPathNameÚ ImportErrorÚ UnicodeError)r[ ra rb r^ Ú has_high_charÚcrh r r r Ú _get_win_folder_with_pywin32ê s$
|
rn c C s dd l }dddd| }| d¡}|jj d |d d|¡ d}|D ]}t|dkr@d } qZq@|r| d¡}|jj |j|d¡r|}|jS )
|
Nr é é# é rU i Frc T) ÚctypesÚcreate_unicode_bufferÚwindllÚshell32ÚSHGetFolderPathWrg Úkernel32ÚGetShortPathNameWÚvalue)r[ rr Ú csidl_constÚbufrl rm Úbuf2r r r Ú_get_win_folder_with_ctypes s& ýü
|
|
r} c C sÖ dd l }ddlm} ddlm} |jjd }| d|¡}|jj }|
|
d t |j | d |j j |¡ |j | ¡ ¡ d¡}d}|D ]} t| dkr|d } qq||rÒ| d|¡}|jj }
|
|
|
|||¡rÒ|j | ¡ ¡ d¡}|S )
|
Nr )Újna)r é rm ú Frc T)ÚarrayÚcom.sunr~ Úcom.sun.jna.platformr ÚWinDefÚMAX_PATHÚzerosÚShell32ÚINSTANCEre rf ÚShlObjÚSHGFP_TYPE_CURRENTÚNativeÚtoStringÚtostringr% rg ÚKernel32ri ) r[ r r~ r Úbuf_sizer{ rb r^ rl rm Úkernelr r r Ú_get_win_folder_with_jna s& r )rt c
|
C s8 dD ].}z| |¡W S ttfk
|
r0 Y qX q| 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)ÚencodeÚUnicodeEncodeErrorÚ LookupError)r Úencodingr r r r> E s
|
r> Ú__main__ZMyAppZ MyCompany)r! r6 rA rC rF r1 r8 z-- app dirs %s --z%-- app dirs (with optional 'version')z1.0rN z%s: %sz)
|
-- app dirs (without optional 'version')z+
|
-- app dirs (without optional 'appauthor')z(
|
-- app dirs (with disabled 'appauthor'))r )NNNF)NNNF)NNNF)NNNF)NNNT)NNNF)NNNT)-rR Ú __version__Útupler- Ú__version_info__Úsysr Ú version_infor; Ústrr= ÚplatformÚ
|
startswithÚjava_verÚos_namer Únamer! r1 r6 r8 rA rC rF ÚobjectrG r` rn r} r rr rt r rj Z com.sun.jnaÚcomr> rO r r ÚpropsÚprintÚdirsÚproprf r r r r Ú<module> s|
|
|
|
|
7
|
B
|
*
|
4
|
=
|
*
|
30
|
|
|
|
