117 lines
3.8 KiB
Python
117 lines
3.8 KiB
Python
# -*- coding: utf-8 -*-
|
|
|
|
import inspect
|
|
import platform
|
|
import os
|
|
import subprocess
|
|
import sys
|
|
import string
|
|
import unicodedata
|
|
|
|
|
|
def app_data_path(app_name=None):
|
|
"""Cross-platform method for determining where to put application data."""
|
|
"""Requires the name of the application"""
|
|
plat = platform.system()
|
|
if plat == 'Windows':
|
|
import winpaths
|
|
path = winpaths.get_appdata()
|
|
elif plat == 'Darwin':
|
|
path = os.path.join(os.path.expanduser('~'), 'Library', 'Application Support')
|
|
elif plat == 'Linux':
|
|
path = os.path.expanduser('~')
|
|
app_name = '.%s' % app_name.replace(' ', '_')
|
|
return os.path.join(path, app_name)
|
|
|
|
def prepare_app_data_path(app_name):
|
|
"""Creates the application's data directory, given its name."""
|
|
dir = app_data_path(app_name)
|
|
return ensure_path(dir)
|
|
|
|
def embedded_data_path():
|
|
if platform.system() == 'Darwin' and is_frozen():
|
|
return os.path.abspath(os.path.join(executable_directory(), '..', 'Resources'))
|
|
return app_path()
|
|
|
|
def is_frozen():
|
|
"""Return a bool indicating if application is compressed"""
|
|
import imp
|
|
return hasattr(sys, 'frozen') or imp.is_frozen("__main__")
|
|
|
|
def get_executable():
|
|
"""Returns the full executable path/name if frozen, or the full path/name of the main module if not."""
|
|
if is_frozen():
|
|
if platform.system() != 'Darwin':
|
|
return sys.executable
|
|
#On darwin, sys.executable points to python. We want the full path to the exe we ran.
|
|
exedir = os.path.abspath(os.path.dirname(sys.executable))
|
|
items = os.listdir(exedir)
|
|
items.remove('python')
|
|
return os.path.join(exedir, items[0])
|
|
#Not frozen
|
|
try:
|
|
import __main__
|
|
return os.path.abspath(__main__.__file__)
|
|
except AttributeError:
|
|
return sys.argv[0]
|
|
|
|
def get_module(level=2):
|
|
"""Hacky method for deriving the caller of this function's module."""
|
|
return inspect.getmodule(inspect.stack()[level][0]).__file__
|
|
|
|
def executable_directory():
|
|
"""Always determine the directory of the executable, even when run with py2exe or otherwise frozen"""
|
|
executable = get_executable()
|
|
path = os.path.abspath(os.path.dirname(executable))
|
|
return path
|
|
|
|
def app_path():
|
|
"""Return the root of the application's directory"""
|
|
path = executable_directory()
|
|
if is_frozen() and platform.system() == 'Darwin':
|
|
path = os.path.abspath(os.path.join(path, '..', '..'))
|
|
return path
|
|
|
|
def module_path(level=2):
|
|
return os.path.abspath(os.path.dirname(get_module(level)))
|
|
|
|
def documents_path():
|
|
"""On windows, returns the path to My Documents. On OSX, returns the user's Documents folder. For anything else, returns the user's home directory."""
|
|
plat = platform.system()
|
|
if plat == 'Windows':
|
|
import winpaths
|
|
path = winpaths.get_my_documents()
|
|
elif plat == 'Darwin':
|
|
path = os.path.join(os.path.expanduser('~'), 'Documents')
|
|
else:
|
|
path = os.path.expanduser('~')
|
|
return path
|
|
|
|
def safe_filename(filename):
|
|
"""Given a filename, returns a safe version with no characters that would not work on different platforms."""
|
|
SAFE_FILE_CHARS = "'-_.()[]{}!@#$%^&+=`~ "
|
|
filename = unicode(filename)
|
|
new_filename = ''.join(c for c in filename if c in SAFE_FILE_CHARS or c.isalnum())
|
|
#Windows doesn't like directory names ending in space, macs consider filenames beginning with a dot as hidden, and windows removes dots at the ends of filenames.
|
|
return new_filename.strip(' .')
|
|
|
|
def ensure_path(path):
|
|
if not os.path.exists(path):
|
|
os.makedirs(path)
|
|
return path
|
|
|
|
def start_file(path):
|
|
if platform.system() == 'Windows':
|
|
os.startfile(path)
|
|
else:
|
|
subprocess.Popen(['open', path])
|
|
|
|
def get_applications_path():
|
|
"""Return the directory where applications are commonly installed on the system."""
|
|
plat = platform.system()
|
|
if plat == 'Windows':
|
|
import winpaths
|
|
return winpaths.get_program_files()
|
|
elif plat == 'Darwin':
|
|
return '/Applications'
|