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'