FM / site-packages

/opt/imh-python/lib/python3.9/site-packages/

/opt/imh-python/lib/python3.9/site-packages

Name	Size	Mode	Actions
amqp/	-	0755	rm
amqp-5.3.1.dist-info/	-	0755	rm
apache_libcloud-3.1.0.dist-info/	-	0755	rm
appdirs-1.4.4.dist-info/	-	0755	rm
apscheduler/	-	0755	rm
APScheduler-3.11.0.dist-info/	-	0755	rm
arrow/	-	0755	rm
arrow-1.2.3.dist-info/	-	0755	rm
astroid/	-	0755	rm
astroid-3.3.9.dist-info/	-	0755	rm
asttokens/	-	0755	rm
asttokens-3.0.0.dist-info/	-	0755	rm
attr/	-	0755	rm
attrs/	-	0755	rm
attrs-25.3.0.dist-info/	-	0755	rm
autocommand/	-	0755	rm
autocommand-2.2.2.dist-info/	-	0755	rm
automat/	-	0755	rm
automat-25.4.16.dist-info/	-	0755	rm
backports/	-	0755	rm
backports.tarfile-1.2.0.dist-info/	-	0755	rm
bakauth/	-	0755	rm
bakauth-1.6.2.dist-info/	-	0755	rm
bcrypt/	-	0755	rm
bcrypt-3.2.2.dist-info/	-	0755	rm
billiard/	-	0755	rm
billiard-4.2.1.dist-info/	-	0755	rm
blessings/	-	0755	rm
blessings-1.7.dist-info/	-	0755	rm
boto3/	-	0755	rm
boto3-1.16.63.dist-info/	-	0755	rm
botocore/	-	0755	rm
botocore-1.19.63.dist-info/	-	0755	rm
celery/	-	0755	rm
celery-5.4.0.dist-info/	-	0755	rm
certifi/	-	0755	rm
certifi-2025.4.26.dist-info/	-	0755	rm
cffi/	-	0755	rm
cffi-1.17.1.dist-info/	-	0755	rm
chardet/	-	0755	rm
chardet-3.0.4.dist-info/	-	0755	rm
cheroot/	-	0755	rm
cheroot-10.0.1.dist-info/	-	0755	rm
cherrypy/	-	0755	rm
CherryPy-18.6.1.dist-info/	-	0755	rm
cinderclient/	-	0755	rm
click/	-	0755	rm
click-8.1.8.dist-info/	-	0755	rm
click_didyoumean/	-	0755	rm
click_didyoumean-0.3.1.dist-info/	-	0755	rm
click_plugins/	-	0755	rm
click_plugins-1.1.1.dist-info/	-	0755	rm
click_repl/	-	0755	rm
click_repl-0.3.0.dist-info/	-	0755	rm
constantly/	-	0755	rm
constantly-23.10.4.dist-info/	-	0755	rm
construct/	-	0755	rm
construct-2.10.70.dist-info/	-	0755	rm
cpapis/	-	0755	rm
cpapis-1.0.dist-info/	-	0755	rm
cproc/	-	0755	rm
cproc-1.0.dist-info/	-	0755	rm
croniter/	-	0755	rm
croniter-2.0.1.dist-info/	-	0755	rm
crossplane/	-	0755	rm
crossplane-0.5.8.dist-info/	-	0755	rm
Crypto/	-	0755	rm
Cryptodome/	-	0755	rm
cryptography/	-	0755	rm
cryptography-36.0.2.dist-info/	-	0755	rm
cwp/	-	0755	rm
cwp-0.1.2.dist-info/	-	0755	rm
dateutil/	-	0755	rm
debtcollector/	-	0755	rm
debtcollector-3.0.0.dist-info/	-	0755	rm
decorator-5.2.1.dist-info/	-	0755	rm
dill/	-	0755	rm
dill-0.4.0.dist-info/	-	0755	rm
distro/	-	0755	rm
distro-1.9.0.dist-info/	-	0755	rm
dns/	-	0755	rm
dnspython-2.7.0.dist-info/	-	0755	rm
dogpile/	-	0755	rm
dogpile_cache-1.4.0.dist-info/	-	0755	rm
exceptiongroup/	-	0755	rm
exceptiongroup-1.2.2.dist-info/	-	0755	rm
executing/	-	0755	rm
executing-2.2.0.dist-info/	-	0755	rm
fabric/	-	0755	rm
fab_classic-1.19.1.dist-info/	-	0755	rm
flask/	-	0755	rm
Flask-1.1.2.dist-info/	-	0755	rm
flask_apscheduler/	-	0755	rm
Flask_APScheduler-1.11.0.dist-info/	-	0755	rm
flask_redis/	-	0755	rm
flask_redis-0.4.0.dist-info/	-	0755	rm
flask_sqlalchemy/	-	0755	rm
Flask_SQLAlchemy-2.4.4.dist-info/	-	0755	rm
future/	-	0755	rm
future-1.0.0.dist-info/	-	0755	rm
gunicorn/	-	0755	rm
gunicorn-20.0.4.dist-info/	-	0755	rm
hyperlink/	-	0755	rm
hyperlink-21.0.0.dist-info/	-	0755	rm
idna/	-	0755	rm
idna-2.10.dist-info/	-	0755	rm
importlib_metadata/	-	0755	rm
importlib_metadata-4.13.0.dist-info/	-	0755	rm
incremental/	-	0755	rm
incremental-22.10.0.dist-info/	-	0755	rm
influxdb/	-	0755	rm
influxdb-5.3.2.dist-info/	-	0755	rm
IPython/	-	0755	rm
ipython-8.18.1.dist-info/	-	0755	rm
iso8601/	-	0755	rm
iso8601-2.1.0.dist-info/	-	0755	rm
isort/	-	0755	rm
isort-6.0.1.dist-info/	-	0755	rm
itsdangerous/	-	0755	rm
itsdangerous-1.1.0.dist-info/	-	0755	rm
jaraco/	-	0755	rm
jaraco.collections-5.1.0.dist-info/	-	0755	rm
jaraco.context-6.0.1.dist-info/	-	0755	rm
jaraco.functools-4.1.0.dist-info/	-	0755	rm
jaraco.text-4.0.0.dist-info/	-	0755	rm
jedi/	-	0755	rm
jedi-0.19.2.dist-info/	-	0755	rm
jinja2/	-	0755	rm
Jinja2-2.11.3.dist-info/	-	0755	rm
jmespath/	-	0755	rm
jmespath-0.10.0.dist-info/	-	0755	rm
jsonpatch-1.33.dist-info/	-	0755	rm
jsonpointer-3.0.0.dist-info/	-	0755	rm
keystoneauth1/	-	0755	rm
keystoneauth1-5.10.0.dist-info/	-	0755	rm
kombu/	-	0755	rm
kombu-5.5.3.dist-info/	-	0755	rm
ldap/	-	0755	rm
libcloud/	-	0755	rm
libfuturize/	-	0755	rm
libpasteurize/	-	0755	rm
markupsafe/	-	0755	rm
MarkupSafe-1.1.1.dist-info/	-	0755	rm
matplotlib_inline/	-	0755	rm
matplotlib_inline-0.1.7.dist-info/	-	0755	rm
mccabe-0.7.0.dist-info/	-	0755	rm
mdstat/	-	0755	rm
mdstat-1.0.4.dist-info/	-	0755	rm
meld3/	-	0755	rm
meld3-2.0.1.dist-info/	-	0755	rm
more_itertools/	-	0755	rm
more_itertools-10.7.0.dist-info/	-	0755	rm
msgpack/	-	0755	rm
msgpack-0.6.1.dist-info/	-	0755	rm
mtrlib/	-	0755	rm
mtrlib-1.2.0.dist-info/	-	0755	rm
munch/	-	0755	rm
munch-4.0.0.dist-info/	-	0755	rm
nacl/	-	0755	rm
netaddr/	-	0755	rm
netaddr-0.8.0.dist-info/	-	0755	rm
netifaces-0.10.9.dist-info/	-	0755	rm
netmiko/	-	0755	rm
netmiko-3.4.0.dist-info/	-	0755	rm
ntc_templates/	-	0755	rm
ntc_templates-7.8.0.dist-info/	-	0755	rm
numpy/	-	0755	rm
numpy-1.26.0.dist-info/	-	0755	rm
numpy.libs/	-	0755	rm
OpenSSL/	-	0755	rm
openstack/	-	0755	rm
openstacksdk-0.49.0.dist-info/	-	0755	rm
oslo.i18n-6.5.1.dist-info/	-	0755	rm
oslo.utils-7.1.0.dist-info/	-	0755	rm
oslo_i18n/	-	0755	rm
oslo_utils/	-	0755	rm
os_client_config/	-	0755	rm
os_client_config-2.1.0.dist-info/	-	0755	rm
os_service_types/	-	0755	rm
os_service_types-1.7.0.dist-info/	-	0755	rm
packaging/	-	0755	rm
packaging-25.0.dist-info/	-	0755	rm
paramiko/	-	0755	rm
paramiko-3.5.1.dist-info/	-	0755	rm
parso/	-	0755	rm
parso-0.8.4.dist-info/	-	0755	rm
past/	-	0755	rm
pbr/	-	0755	rm
pbr-6.1.1.dist-info/	-	0755	rm
pem/	-	0755	rm
pem-20.1.0.dist-info/	-	0755	rm
pexpect/	-	0755	rm
pexpect-4.9.0.dist-info/	-	0755	rm
picotui/	-	0755	rm
picotui-1.2.dist-info/	-	0755	rm
pip/	-	0755	rm
pip-25.1.1.dist-info/	-	0755	rm
pkg_resources/	-	0755	rm
platformdirs/	-	0755	rm
platformdirs-4.3.7.dist-info/	-	0755	rm
portend-3.2.0.dist-info/	-	0755	rm
pp_api/	-	0755	rm
pp_api-1.3.1.dist-info/	-	0755	rm
pr2modules/	-	0755	rm
prettytable-0.7.2.dist-info/	-	0755	rm
prometheus_client/	-	0755	rm
prometheus_client-0.14.1.dist-info/	-	0755	rm
prompt_toolkit/	-	0755	rm
prompt_toolkit-3.0.51.dist-info/	-	0755	rm
psutil/	-	0755	rm
psutil-5.7.3.dist-info/	-	0755	rm
psycopg2/	-	0755	rm
psycopg2-2.8.6.dist-info/	-	0755	rm
ptyprocess/	-	0755	rm
ptyprocess-0.7.0.dist-info/	-	0755	rm
pure_eval/	-	0755	rm
pure_eval-0.2.3.dist-info/	-	0755	rm
pyasn1/	-	0755	rm
pyasn1-0.6.1.dist-info/	-	0755	rm
pyasn1_modules/	-	0755	rm
pyasn1_modules-0.4.2.dist-info/	-	0755	rm
pycparser/	-	0755	rm
pycparser-2.22.dist-info/	-	0755	rm
pycryptodome-3.9.9.dist-info/	-	0755	rm
pycryptodomex-3.9.9.dist-info/	-	0755	rm
pyeapi/	-	0755	rm
pyeapi-0.8.4.dist-info/	-	0755	rm
pygit2/	-	0755	rm
pygit2-1.6.1.dist-info/	-	0755	rm
pygit2.libs/	-	0755	rm
pygments/	-	0755	rm
pygments-2.19.1.dist-info/	-	0755	rm
pygraph/	-	0755	rm
PyGraph-0.3.0.dist-info/	-	0755	rm
pyipmi/	-	0755	rm
pylint/	-	0755	rm
pylint-3.3.7.dist-info/	-	0755	rm
pymysql/	-	0755	rm
PyMySQL-1.0.3.dist-info/	-	0755	rm
PyNaCl-1.5.0.dist-info/	-	0755	rm
pynetbox/	-	0755	rm
pynetbox-6.5.0.dist-info/	-	0755	rm
pyOpenSSL-19.1.0.dist-info/	-	0755	rm
pyparsing/	-	0755	rm
pyparsing-3.2.3.dist-info/	-	0755	rm
pyroute2/	-	0755	rm
pyroute2-0.7.12.dist-info/	-	0755	rm
pyserial-3.5.dist-info/	-	0755	rm
pysparklines-1.4.dist-info/	-	0755	rm
python_cinderclient-7.1.0.dist-info/	-	0755	rm
python_crontab-2.7.1.dist-info/	-	0755	rm
python_dateutil-2.9.0.post0.dist-info/	-	0755	rm
python_ipmi-0.5.7.dist-info/	-	0755	rm
python_ldap-3.3.1.dist-info/	-	0755	rm
python_whois-0.7.3.dist-info/	-	0755	rm
pytz/	-	0755	rm
pytz-2025.2.dist-info/	-	0755	rm
pyudev/	-	0755	rm
pyudev-0.23.2.dist-info/	-	0755	rm
PyYAML-5.4.1.dist-info/	-	0755	rm
pyzmq-19.0.2.dist-info/	-	0755	rm
pyzmq.libs/	-	0755	rm
rads/	-	0755	rm
rads-4.1.0.dist-info/	-	0755	rm
redis/	-	0755	rm
redis-3.5.3.dist-info/	-	0755	rm
requests/	-	0755	rm
requests-2.24.0.dist-info/	-	0755	rm
requestsexceptions/	-	0755	rm
requestsexceptions-1.4.0.dist-info/	-	0755	rm
restic/	-	0755	rm
restic-1.3.5.dist-info/	-	0755	rm
s3transfer/	-	0755	rm
s3transfer-0.3.7.dist-info/	-	0755	rm
scp-0.15.0.dist-info/	-	0755	rm
serial/	-	0755	rm
service_identity/	-	0755	rm
service_identity-23.1.0.dist-info/	-	0755	rm
setproctitle-1.1.10.dist-info/	-	0755	rm
setuptools/	-	0755	rm
setuptools-57.0.0.dist-info/	-	0755	rm
simplejson/	-	0755	rm
simplejson-3.20.1.dist-info/	-	0755	rm
six-1.17.0.dist-info/	-	0755	rm
slapdtest/	-	0755	rm
sparkline/	-	0755	rm
sqlalchemy/	-	0755	rm
SQLAlchemy-1.3.24.dist-info/	-	0755	rm
stack_data/	-	0755	rm
stack_data-0.6.3.dist-info/	-	0755	rm
stevedore/	-	0755	rm
stevedore-5.4.1.dist-info/	-	0755	rm
tabulate-0.8.10.dist-info/	-	0755	rm
tailer/	-	0755	rm
tailer-0.4.1.dist-info/	-	0755	rm
tempora/	-	0755	rm
tempora-5.8.0.dist-info/	-	0755	rm
tenacity/	-	0755	rm
tenacity-9.1.2.dist-info/	-	0755	rm
test/	-	0755	rm
testdata/	-	0755	rm
tests/	-	0755	rm
textfsm/	-	0755	rm
textfsm-1.1.3.dist-info/	-	0755	rm
toml/	-	0755	rm
toml-0.10.2.dist-info/	-	0755	rm
tomli/	-	0755	rm
tomli-2.2.1.dist-info/	-	0755	rm
tomlkit/	-	0755	rm
tomlkit-0.13.2.dist-info/	-	0755	rm
tornado/	-	0755	rm
tornado-6.0.4.dist-info/	-	0755	rm
traitlets/	-	0755	rm
traitlets-5.14.3.dist-info/	-	0755	rm
twisted/	-	0755	rm
Twisted-22.4.0.dist-info/	-	0755	rm
typing_extensions-4.13.2.dist-info/	-	0755	rm
tzdata/	-	0755	rm
tzdata-2025.2.dist-info/	-	0755	rm
tzlocal/	-	0755	rm
tzlocal-5.3.1.dist-info/	-	0755	rm
untangle-1.1.1.dist-info/	-	0755	rm
urllib3/	-	0755	rm
urllib3-1.25.11.dist-info/	-	0755	rm
uWSGI-2.0.19.1.dist-info/	-	0755	rm
version_utils/	-	0755	rm
version_utils-0.3.2.dist-info/	-	0755	rm
vine/	-	0755	rm
vine-5.1.0.dist-info/	-	0755	rm
wcwidth/	-	0755	rm
wcwidth-0.2.13.dist-info/	-	0755	rm
werkzeug/	-	0755	rm
Werkzeug-2.0.3.dist-info/	-	0755	rm
wheel/	-	0755	rm
wheel-0.45.1.dist-info/	-	0755	rm
whois/	-	0755	rm
wrapt/	-	0755	rm
wrapt-1.17.2.dist-info/	-	0755	rm
yaml/	-	0755	rm
zc/	-	0755	rm
zc.lockfile-3.0.post1.dist-info/	-	0755	rm
zipp/	-	0755	rm
zipp-3.21.0.dist-info/	-	0755	rm
zmq/	-	0755	rm
zope/	-	0755	rm
zope.interface-7.2.dist-info/	-	0755	rm
_distutils_hack/	-	0755	rm
_yaml/	-	0755	rm
__pycache__/	-	0755	rm
appdirs.py	24720	0644	edit dl rm
cronlog.py	3773	0644	edit dl rm
crontab.py	46862	0644	edit dl rm
crontabs.py	4438	0644	edit dl rm
decorator.py	17067	0644	edit dl rm
distutils-precedence.pth	152	0644	edit dl rm
jsonpatch.py	29778	0644	edit dl rm
jsonpointer.py	10601	0644	edit dl rm
ldapurl.py	12525	0644	edit dl rm
ldif.py	20278	0644	edit dl rm
LICENSE	601	0644	edit dl rm
mccabe.py	10654	0644	edit dl rm
netifaces.cpython-39-x86_64-linux-gnu.so	24584	0755	edit dl rm
portend.py	6488	0644	edit dl rm
prettytable.py	54204	0644	edit dl rm
README.md	3180	0644	edit dl rm
README.txt	119	0644	edit dl rm
scp.py	22393	0644	edit dl rm
setproctitle.cpython-39-x86_64-linux-gnu.so	23952	0755	edit dl rm
six.py	34703	0644	edit dl rm
tabulate.py	73889	0644	edit dl rm
typing_extensions.py	172654	0644	edit dl rm
untangle.py	5535	0644	edit dl rm
uwsgidecorators.py	10392	0644	edit dl rm
zc.lockfile-3.0.post1-py3.9-nspkg.pth	519	0644	edit dl rm
zope.interface-7.2-py3.9-nspkg.pth	457	0644	edit dl rm
_cffi_backend.cpython-39-x86_64-linux-gnu.so	274096	0755	edit dl rm
_ldap.cpython-39-x86_64-linux-gnu.so	95632	0755	edit dl rm

Edit: /opt/imh-python/lib/python3.9/site-packages/appdirs.py (24720B)

#!/usr/bin/env python
# -*- coding: utf-8 -*-
# Copyright (c) 2005-2010 ActiveState Software Inc.
# Copyright (c) 2013 Eddy Petrișor

"""Utilities for determining application-specific dirs.

See <http://github.com/ActiveState/appdirs> for details and usage.
"""
# Dev Notes:
# - MSDN on where to store app data files:
#   http://support.microsoft.com/default.aspx?scid=kb;en-us;310294#XSLTH3194121123120121120120
# - Mac OS X: http://developer.apple.com/documentation/MacOSX/Conceptual/BPFileSystem/index.html
# - XDG spec for Un*x: http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html

__version__ = "1.4.4"
__version_info__ = tuple(int(segment) for segment in __version__.split("."))

import sys
import os

PY3 = sys.version_info[0] == 3

if PY3:
    unicode = str

if sys.platform.startswith('java'):
    import platform
    os_name = platform.java_ver()[3][0]
    if os_name.startswith('Windows'): # "Windows XP", "Windows 7", etc.
        system = 'win32'
    elif os_name.startswith('Mac'): # "Mac OS X", etc.
        system = 'darwin'
    else: # "Linux", "SunOS", "FreeBSD", etc.
        # Setting this to "linux2" is not ideal, but only Windows or Mac
        # are actually checked for and the rest of the module expects
        # *sys.platform* style strings.
        system = 'linux2'
else:
    system = sys.platform

def user_data_dir(appname=None, appauthor=None, version=None, roaming=False):
    r"""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>
        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>".
    """
    if system == "win32":
        if appauthor is None:
            appauthor = appname
        const = roaming and "CSIDL_APPDATA" or "CSIDL_LOCAL_APPDATA"
        path = os.path.normpath(_get_win_folder(const))
        if appname:
            if appauthor is not False:
                path = os.path.join(path, appauthor, appname)
            else:
                path = os.path.join(path, appname)
    elif system == 'darwin':
        path = os.path.expanduser('~/Library/Application Support/')
        if appname:
            path = os.path.join(path, appname)
    else:
        path = os.getenv('XDG_DATA_HOME', os.path.expanduser("~/.local/share"))
        if appname:
            path = os.path.join(path, appname)
    if appname and version:
        path = os.path.join(path, version)
    return path

def site_data_dir(appname=None, appauthor=None, version=None, multipath=False):
    r"""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.
    """
    if system == "win32":
        if appauthor is None:
            appauthor = appname
        path = os.path.normpath(_get_win_folder("CSIDL_COMMON_APPDATA"))
        if appname:
            if appauthor is not False:
                path = os.path.join(path, appauthor, appname)
            else:
                path = os.path.join(path, appname)
    elif system == 'darwin':
        path = os.path.expanduser('/Library/Application Support')
        if appname:
            path = os.path.join(path, appname)
    else:
        # XDG default for $XDG_DATA_DIRS
        # only first, if multipath is False
        path = os.getenv('XDG_DATA_DIRS',
                         os.pathsep.join(['/usr/local/share', '/usr/share']))
        pathlist = [os.path.expanduser(x.rstrip(os.sep)) for x in path.split(os.pathsep)]
        if appname:
            if version:
                appname = os.path.join(appname, version)
            pathlist = [os.sep.join([x, appname]) for x in pathlist]

if multipath:
            path = os.pathsep.join(pathlist)
        else:
            path = pathlist[0]
        return path

if appname and version:
        path = os.path.join(path, version)
    return path

def user_config_dir(appname=None, appauthor=None, version=None, roaming=False):
    r"""Return full path to the user-specific config dir for this application.

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>".
    """
    if system in ["win32", "darwin"]:
        path = user_data_dir(appname, appauthor, None, roaming)
    else:
        path = os.getenv('XDG_CONFIG_HOME', os.path.expanduser("~/.config"))
        if appname:
            path = os.path.join(path, appname)
    if appname and version:
        path = os.path.join(path, version)
    return path

def site_config_dir(appname=None, appauthor=None, version=None, multipath=False):
    r"""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.
    """
    if system in ["win32", "darwin"]:
        path = site_data_dir(appname, appauthor)
        if appname and version:
            path = os.path.join(path, version)
    else:
        # XDG default for $XDG_CONFIG_DIRS
        # only first, if multipath is False
        path = os.getenv('XDG_CONFIG_DIRS', '/etc/xdg')
        pathlist = [os.path.expanduser(x.rstrip(os.sep)) for x in path.split(os.pathsep)]
        if appname:
            if version:
                appname = os.path.join(appname, version)
            pathlist = [os.sep.join([x, appname]) for x in pathlist]

if multipath:
            path = os.pathsep.join(pathlist)
        else:
            path = pathlist[0]
    return path

def user_cache_dir(appname=None, appauthor=None, version=None, opinion=True):
    r"""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.
    """
    if system == "win32":
        if appauthor is None:
            appauthor = appname
        path = os.path.normpath(_get_win_folder("CSIDL_LOCAL_APPDATA"))
        if appname:
            if appauthor is not False:
                path = os.path.join(path, appauthor, appname)
            else:
                path = os.path.join(path, appname)
            if opinion:
                path = os.path.join(path, "Cache")
    elif system == 'darwin':
        path = os.path.expanduser('~/Library/Caches')
        if appname:
            path = os.path.join(path, appname)
    else:
        path = os.getenv('XDG_CACHE_HOME', os.path.expanduser('~/.cache'))
        if appname:
            path = os.path.join(path, appname)
    if appname and version:
        path = os.path.join(path, version)
    return path

def user_state_dir(appname=None, appauthor=None, version=None, roaming=False):
    r"""Return full path to the user-specific state dir for this application.

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>".
    """
    if system in ["win32", "darwin"]:
        path = user_data_dir(appname, appauthor, None, roaming)
    else:
        path = os.getenv('XDG_STATE_HOME', os.path.expanduser("~/.local/state"))
        if appname:
            path = os.path.join(path, appname)
    if appname and version:
        path = os.path.join(path, version)
    return path

def user_log_dir(appname=None, appauthor=None, version=None, opinion=True):
    r"""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.
    """
    if system == "darwin":
        path = os.path.join(
            os.path.expanduser('~/Library/Logs'),
            appname)
    elif system == "win32":
        path = user_data_dir(appname, appauthor, version)
        version = False
        if opinion:
            path = os.path.join(path, "Logs")
    else:
        path = user_cache_dir(appname, appauthor, version)
        version = False
        if opinion:
            path = os.path.join(path, "log")
    if appname and version:
        path = os.path.join(path, version)
    return path

class AppDirs(object):
    """Convenience wrapper for getting application dirs."""
    def __init__(self, appname=None, appauthor=None, version=None,
            roaming=False, multipath=False):
        self.appname = appname
        self.appauthor = appauthor
        self.version = version
        self.roaming = roaming
        self.multipath = multipath

@property
    def user_data_dir(self):
        return user_data_dir(self.appname, self.appauthor,
                             version=self.version, roaming=self.roaming)

@property
    def site_data_dir(self):
        return site_data_dir(self.appname, self.appauthor,
                             version=self.version, multipath=self.multipath)

@property
    def user_config_dir(self):
        return user_config_dir(self.appname, self.appauthor,
                               version=self.version, roaming=self.roaming)

@property
    def site_config_dir(self):
        return site_config_dir(self.appname, self.appauthor,
                             version=self.version, multipath=self.multipath)

@property
    def user_cache_dir(self):
        return user_cache_dir(self.appname, self.appauthor,
                              version=self.version)

@property
    def user_state_dir(self):
        return user_state_dir(self.appname, self.appauthor,
                              version=self.version)

@property
    def user_log_dir(self):
        return user_log_dir(self.appname, self.appauthor,
                            version=self.version)

#---- internal support stuff

def _get_win_folder_from_registry(csidl_name):
    """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.
    """
    if PY3:
      import winreg as _winreg
    else:
      import _winreg

shell_folder_name = {
        "CSIDL_APPDATA": "AppData",
        "CSIDL_COMMON_APPDATA": "Common AppData",
        "CSIDL_LOCAL_APPDATA": "Local AppData",
    }[csidl_name]

key = _winreg.OpenKey(
        _winreg.HKEY_CURRENT_USER,
        r"Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders"
    )
    dir, type = _winreg.QueryValueEx(key, shell_folder_name)
    return dir

def _get_win_folder_with_pywin32(csidl_name):
    from win32com.shell import shellcon, shell
    dir = shell.SHGetFolderPath(0, getattr(shellcon, csidl_name), 0, 0)
    # Try to make this a unicode path because SHGetFolderPath does
    # not return unicode strings when there is unicode data in the
    # path.
    try:
        dir = unicode(dir)

# Downgrade to short path name if have highbit chars. See
        # <http://bugs.activestate.com/show_bug.cgi?id=85099>.
        has_high_char = False
        for c in dir:
            if ord(c) > 255:
                has_high_char = True
                break
        if has_high_char:
            try:
                import win32api
                dir = win32api.GetShortPathName(dir)
            except ImportError:
                pass
    except UnicodeError:
        pass
    return dir

def _get_win_folder_with_ctypes(csidl_name):
    import ctypes

csidl_const = {
        "CSIDL_APPDATA": 26,
        "CSIDL_COMMON_APPDATA": 35,
        "CSIDL_LOCAL_APPDATA": 28,
    }[csidl_name]

buf = ctypes.create_unicode_buffer(1024)
    ctypes.windll.shell32.SHGetFolderPathW(None, csidl_const, None, 0, buf)

# Downgrade to short path name if have highbit chars. See
    # <http://bugs.activestate.com/show_bug.cgi?id=85099>.
    has_high_char = False
    for c in buf:
        if ord(c) > 255:
            has_high_char = True
            break
    if has_high_char:
        buf2 = ctypes.create_unicode_buffer(1024)
        if ctypes.windll.kernel32.GetShortPathNameW(buf.value, buf2, 1024):
            buf = buf2

return buf.value

def _get_win_folder_with_jna(csidl_name):
    import array
    from com.sun import jna
    from com.sun.jna.platform import win32

buf_size = win32.WinDef.MAX_PATH * 2
    buf = array.zeros('c', buf_size)
    shell = win32.Shell32.INSTANCE
    shell.SHGetFolderPath(None, getattr(win32.ShlObj, csidl_name), None, win32.ShlObj.SHGFP_TYPE_CURRENT, buf)
    dir = jna.Native.toString(buf.tostring()).rstrip("\0")

# Downgrade to short path name if have highbit chars. See
    # <http://bugs.activestate.com/show_bug.cgi?id=85099>.
    has_high_char = False
    for c in dir:
        if ord(c) > 255:
            has_high_char = True
            break
    if has_high_char:
        buf = array.zeros('c', buf_size)
        kernel = win32.Kernel32.INSTANCE
        if kernel.GetShortPathName(dir, buf, buf_size):
            dir = jna.Native.toString(buf.tostring()).rstrip("\0")

return dir

if system == "win32":
    try:
        import win32com.shell
        _get_win_folder = _get_win_folder_with_pywin32
    except ImportError:
        try:
            from ctypes import windll
            _get_win_folder = _get_win_folder_with_ctypes
        except ImportError:
            try:
                import com.sun.jna
                _get_win_folder = _get_win_folder_with_jna
            except ImportError:
                _get_win_folder = _get_win_folder_from_registry

#---- self test code

if __name__ == "__main__":
    appname = "MyApp"
    appauthor = "MyCompany"

props = ("user_data_dir",
             "user_config_dir",
             "user_cache_dir",
             "user_state_dir",
             "user_log_dir",
             "site_data_dir",
             "site_config_dir")

print("-- app dirs %s --" % __version__)

print("-- app dirs (with optional 'version')")
    dirs = AppDirs(appname, appauthor, version="1.0")
    for prop in props:
        print("%s: %s" % (prop, getattr(dirs, prop)))

print("\n-- app dirs (without optional 'version')")
    dirs = AppDirs(appname, appauthor)
    for prop in props:
        print("%s: %s" % (prop, getattr(dirs, prop)))

print("\n-- app dirs (without optional 'appauthor')")
    dirs = AppDirs(appname)
    for prop in props:
        print("%s: %s" % (prop, getattr(dirs, prop)))

print("\n-- app dirs (with disabled 'appauthor')")
    dirs = AppDirs(appname, appauthor=False)
    for prop in props:
        print("%s: %s" % (prop, getattr(dirs, prop)))

cmd: