Module Gnumed.gnumed
." ======================================================== ." SPDX-License-Identifier: GPL-2.0-or-later ." ========================================================
.TH GNUmed 1 "%(today)s" "Manual for GNUmed"
.SH NAME .B GNUmed - an electronic medical record software for GP offices
Use at your own risk. You have been warned.
.SH SYNOPSIS .B gnumed %(options)s
.SH DESCRIPTION .B GNUmed is a solution for keeping safe and medically sound electronic records on a patient's health. It primarily focuses on GP offices. It is released under the GPL.
GNUmed is written in Python with wxPython/wxWindows. Data is stored in a PostgreSQL database. Multiple clients can work with the same database at the same time.
.SH OPTIONS .PP .TP .B --debug Pre-set the [debug mode] checkbox in the login dialog which controls increased verbosity in the log file.
Useful for, well, debugging :-) Slower, too. .TP .B --slave Pre-set the [enable remote control] checkbox in the login dialog to enable the XML-RPC remote control feature. .TP .B --hipaa Enable HIPAA features with user workflow impact.
Those features which do not affect the workflow of the user are permanently enabled. .TP .B --log-file=FILE Use this to change the name of the log file. At startup GNUmed will tell you the name of the log file in use. .TP .B --conf-file=FILE Use configuration file FILE instead of searching for it in standard locations. .TP .B --profile=FILE Activate profiling and write profile data to file FILE. .TP .B --lang-gettext=LANGUAGE Explicitly set the language to use in gettext translation. The very same effect can be achieved by setting the environment variable $LANG from a launcher script. .TP .B --text-domain=TEXTDOMAIN Set this to change the name of the language file to be loaded. Note, this does not change the directory the file is searched in, only the name of the file where messages are loaded from. The standard textdomain is, of course, "gnumed.mo". You need only specify the base name of the file without the .mo extension. .TP .B --tool=TOOL Run the named TOOL instead of a GUI.
Currently implemented tools:
%(tools)s .TP .B --override-schema-check Continue loading the client even if the database schema version and the client software version cannot be verified to be compatible. .TP .B --skip-update-check Skip checking for client updates. This is useful during development or when the update check URL is unavailable. .TP .B --local-import At startup adjust the PYTHONPATH such that the GNUmed client is run from a local copy of the source tree (say an unpacked tarball or a GIT repo) rather than from a proper system-wide installation. .TP .B --special=SPECIAL Used for debugging. .TP .B --version, -V Show version information about the GNUmed client and the database it needs. .TP .B --help, -h, or -? Show this help.
.SH CONFIGURATION
GNUmed uses scripts and configuration files to customize interaction with the system at startup and runtime.
.PP .TP .B Shell level startup
A shell script /usr/bin/gnumed is used to startup the client. It checks whether the systemwide configuration file
/etc/gnumed/gnumed-client.conf
exists. It then executes the following scripts (in that order) if found:
/etc/gnumed/gnumed-startup-local.sh
~/.config/gnumed/scripts/gnumed-startup-local.sh
When the client terminates it will execute the following scripts in order if they exist:
/etc/gnumed/gnumed-shutdown-local.sh
~/.config/gnumed/scripts/gnumed-shutdown-local.sh
.PP .TP .B Application level startup
The gnumed.py script checks for INI style configuration files and fails if it does not find any. The files are searched for in the following order and extend/overwrite each others options:
in the current working directory (cwd)
./gumed.conf
in the systemwide configuration directory
/etc/gnumed/gnumed-client.conf
in the home directory
~/.config/gnumed/gnumed.conf
in a local git tree or unpacked tarball
.../gnumed/client/gnumed.conf
explicitly given by CLI option
--conf-file=<CONF FILE>
.PP .TP .B Runtime interaction
These scripts must be found in the PATH for the client to be able to use them. When attempting to run a script the client will store API information into the log file (at DEBUG level).
.B gm-print_doc(.bat)
Called to print documents if other methods fail.
.B gm-mail_doc(.bat)
Called to e-mail documents if other methods fail.
.B gm-fax_doc(.bat)
Called to fax documents if other methods fail.
.B gm-burn_doc(.bat)
Called to burn a directory onto CD/DVD if other methods fail.
.B gm-describe_file
Called to retrieve metadata about a file.
.B gm-convert_file
Called to convert files among formats if other methods fail.
.B gm-create_datamatrix
Called to create a datamatrix.
.B gm-create_dicomdir
Called to generate a DICOMDIR file for a range of DICOM images.
.B gm-unicode2clipboard
Called to help the user enter non-native characters if other methods fail.
.B ~/.config/gnumed/gnumed-xsanerc.conf
(requires XSane > v0.992)
When GNUmed invokes XSane for scanning it passes along this file (via =–xsane-rc=). This way a custom XSane configuration can be used with GNUmed. If the file doesn't exist it will be created from ~/.sane/xsane/xsanerc on the first call to XSane.
When you configure XSane after calling it from GNUmed your changes will be stored in the GNUmed-specific XSane configuration file and will not affect your usual XSane settings.
.B mime_type2file_extension.conf
(searched for in ~/.config/gnumed/ and /etc/gnumed/, in that order)
GNUmed will use these files to map mime types to file extensions if need be.
The file must contain a group [extensions] under which there can be one option per mime type specifying the extension to use on files of said type, like this:
.nf [extensions] image/x-bmp = bmp
.SH EXIT STATUS .TP
0: an error occurred while running the GUI client .TP 0: normal termination of the client .TP < 0: an error occurred while trying to run a console tool .TP -1: an unknown console tool was requested .TP < -1: an error occurred while running a known console tool .TP -999: hard abort of the client
.SH ENVIRONMENT .TP .B LANG, LC_MESSAGES, etc. See gettext(1) for how the various locale related environment variables work.
.SH OTHER FILES AND DIRECTORIES .PP .TP .B ~/.local/gnumed/gnumed.log The default log file. .TP .B gnumed-client.tmpfiles.d.conf Integration with systemd-tmpfiles(8). .TP .B gnumed-completion.bash Integration with BASH completions. .TP .B ~/gnumed/auto-incoming/ Directory from which files are auto-imported for archival as patient documents. This directory is meant for the user to manually drop files into.
It will also contain a README listing another auto-import directory meant for programmatic dropping of files. Under Linux this path will likely be ~/.local/gnumed/auto-incoming/
.SH SEE ALSO .PP .TP .B https://www.gnumed.de Online documenation. .TP .B https://savannah.gnu.org/projects/gnumed Mailing list home .TP .B https://github.org/ncqgm/gnumed Source code repository (Git) .TP .B /usr/share/doc/gnumed/ Local documentation .TP .B man -k gm- List man pages on gm- commands. .TP .B gettext(1)
.SH BUGS
A lot of functionality is still missing. To make up for that, there's bugs here and there for you to report :-)
Use at your own risk. You have been warned. Take proper backups !
Functions
def generate_man_page(fname=None)
-
Expand source code
def generate_man_page(fname=None): if fname is None: handle, fname = tempfile.mkstemp(text = True, suffix = '.1') man_page_file = open(fname, mode = 'wt', encoding = 'utf8') opts = [ '.RB [-%s]' % o for o in _known_short_options ] for long_opt in _known_long_options: if long_opt.endswith('='): opts.append('.RB [--%s%s]' % (long_opt, long_opt.upper()[:-1])) continue opts.append('.RB [--%s]' % long_opt) args = { 'today': datetime.date.today().strftime('%x'), 'tools': '\t\t\t\n\n'.join([ '%s: %s' % (tool, desc) for tool, desc in _known_tools.items() ]), 'options': '\n'.join(opts) } man_page_file.write(__doc__ % args) man_page_file.close() return fname
def handle_help_request()
-
Expand source code
def handle_help_request(): src = [('cli', 'return')] help_requested = ( _cfg.get(option = '--help', source_order = src) or _cfg.get(option = '-h', source_order = src) or _cfg.get(option = '-?', source_order = src) ) if help_requested: input('\nHit <ENTER> to display commandline help\n') if platform.system() == 'Windows': for line in __doc__.split('\n'): print(regex.sub('^\.\w+\s*', '', line, count = 1)) sys.exit(0) man_page_fname = generate_man_page() os.system('man %s' % man_page_fname) sys.exit(0)
def handle_sig_term(signum, frame)
-
Expand source code
def handle_sig_term(signum, frame): _log.critical('SIGTERM (SIG%s) received, shutting down ...' % signum) gmLog2.flush() print('GNUmed: SIGTERM (SIG%s) received, shutting down ...' % signum) if frame is not None: print('%s::%s@%s' % (frame.f_code.co_filename, frame.f_code.co_name, frame.f_lineno)) # FIXME: need to do something useful here if _old_sig_term in [None, signal.SIG_IGN]: sys.exit(1) else: _old_sig_term(signum, frame)
def handle_version_request()
-
Expand source code
def handle_version_request(): gmTools._client_version = current_client_version src = [('cli', 'return')] version_requested = ( _cfg.get(option = '--version', source_order = src) or _cfg.get(option = '-V', source_order = src) ) if version_requested: from Gnumed.pycommon.gmPG2 import map_client_branch2required_db_version, known_schema_hashes print('GNUmed version information') print('--------------------------') print('client : %s on branch [%s]' % (current_client_version, current_client_branch)) print('database : %s' % map_client_branch2required_db_version[current_client_branch]) print('schema hash: %s' % known_schema_hashes[map_client_branch2required_db_version[current_client_branch]]) sys.exit(0)
def log_startup_info()
-
Expand source code
def log_startup_info(): global _pre_log_buffer if len(_pre_log_buffer) > 0: _log.info('early startup log buffer:') for line in _pre_log_buffer: _log.info(' ' + line) del _pre_log_buffer _log.info('GNUmed client version [%s] on branch [%s]', current_client_version, current_client_branch) _log.info('Platform: %s', platform.uname()) _log.info(('Python %s on %s (%s)' % (sys.version, sys.platform, os.name)).replace('\n', '<\\n>')) try: import lsb_release _log.info('lsb_release: %s', lsb_release.get_distro_information()) except ImportError: pass __log_module_sys() __log_module_platform() __log_module_os() __log_module_sysconfig() #for f in [ mod.__spec__ for mod in sys.modules.values() ]: # print(f.origin)
def run_gui()
-
Expand source code
def run_gui(): """Startup wxPython GUI.""" from Gnumed.wxpython import gmGuiMain profile_file = _cfg.get(option = '--profile', source_order = [('cli', 'return')]) if profile_file is None: gmGuiMain.main() else: _log.info('writing profiling data into %s', profile_file) import profile profile.run('gmGuiMain.main()', profile_file) return 0
Startup wxPython GUI.
def run_tool()
-
Expand source code
def run_tool(): """Run a console tool. Exit codes as per man page: 0: normal termination of the client < 0: some error occurred while trying to run a console tool -1: an unknown console tool was requested < -1: an error occurred while a console tool was run -999: hard abort of the client One of these needs to be returned from this function (and, by extension from the tool having been run, if any). """ tool = _cfg.get(option = '--tool', source_order = [('cli', 'return')]) if tool is None: # not running a tool return None if tool not in _known_tools: _log.error('unknown tool requested: %s', tool) print('GNUmed startup: Unknown tool [%s] requested.' % tool) print('GNUmed startup: Known tools: %s' % list(_known_tools.keys())) return -1 print('') print('==============================================') print('Running tool: %s' % tool) print('----------------------------------------------') print('') if tool == 'generate_man_page': man_page_fname = generate_man_page(fname = os.path.abspath(os.path.join('.', 'gnumed.1'))) print('MAN page saved as:', man_page_fname) return 0 if tool == 'update_collations': return gmPG2.run_collations_tool() login, creds = gmPG2.request_login_params() gmConnectionPool._VERBOSE_PG_LOG = _cfg.get(option = 'debug') pool = gmConnectionPool.gmConnectionPool() pool.credentials = creds print('') if tool == 'read_all_rows_of_table': result = gmPG2.read_all_rows_of_table() if result in [None, True]: print('Success.') return 0 print('Failed. Check the log for details.') return -2 if tool == 'get_object_passphrases': return __run_get_object_passphrases_tool() if tool == 'check_mimetypes_in_archive': from Gnumed.business import gmDocuments return gmDocuments.check_mimetypes_in_archive() if tool == 'check_enc_epi_xref': return gmPG2.check_fk_encounter_fk_episode_x_ref() if tool == 'fingerprint_db': return gmPG2.run_fingerprint_tool() if tool == 'export_pat_emr_structure': return __run_emr_export_tool() # tool export_patient_as (vcf, gdt, ...) #if tool == 'export_pat_demographics': # should not happen (because checked against _known_tools) return -1
Run a console tool.
Exit codes as per man page: 0: normal termination of the client < 0: some error occurred while trying to run a console tool -1: an unknown console tool was requested < -1: an error occurred while a console tool was run -999: hard abort of the client
One of these needs to be returned from this function (and, by extension from the tool having been run, if any).
def run_tui()
-
Expand source code
def run_tui(): try: #import urwid pass except ModuleNotFoundError: _log.exception('cannot import <urwid>') return 1 from Gnumed.urwid import gmTuiMain gmTuiMain.main() return 0
def run_ui()
-
Expand source code
def run_ui(): """Startup a user interface.""" gmHooks.run_hook_script(hook = 'startup-before-GUI') _use_tui = _cfg.get(option = '--tui', source_order = [('cli', 'return')]) if _use_tui: return run_tui() run_gui() gmHooks.run_hook_script(hook = 'shutdown-post-GUI') return 0
Startup a user interface.
def setup_backend_environment()
-
Expand source code
def setup_backend_environment(): db_version = gmPG2.map_client_branch2required_db_version[current_client_branch] _log.info('client expects database version [%s]', db_version) _cfg.set_option ( option = 'database_version', value = db_version )
def setup_cfg()
-
Expand source code
def setup_cfg(): """Detect and setup access to GNUmed config file. Parts of this will have limited value due to wxPython not yet being available. """ enc = gmI18N.get_encoding() paths = gmTools.gmPaths(app_name = 'gnumed') candidates = [ # the current working dir ['workbase', os.path.join(paths.working_dir, 'gnumed.conf')], # /etc/gnumed/ ['system', os.path.join(paths.system_config_dir, 'gnumed-client.conf')], # ~/.config/gnumed/ ['user', os.path.join(paths.user_config_dir, 'gnumed.conf')], # CVS/tgz tree .../gnumed/client/ (IOW a local installation) ['local', os.path.join(paths.local_base_dir, 'gnumed.conf')] ] # --conf-file= explicit_fname = _cfg.get(option = '--conf-file', source_order = [('cli', 'return')]) if explicit_fname is None: candidates.append(['explicit', None]) else: candidates.append(['explicit', explicit_fname]) for candidate in candidates: _cfg.add_file_source ( source = candidate[0], file = candidate[1], encoding = enc ) # --conf-file given but does not actually exist ? if explicit_fname is not None: if _cfg.source_files['explicit'] is None: _log.error('--conf-file argument does not exist') print(missing_cli_config_file % explicit_fname) sys.exit(1) # any config file found at all ? found_any_file = False for f in _cfg.source_files.values(): if f is not None: found_any_file = True break if not found_any_file: _log.error('no config file found at all') print(no_config_files % '\n '.join(candidates)) sys.exit(1) # mime type handling sources fname = 'mime_type2file_extension.conf' user_mime = os.path.join(paths.user_config_dir, fname) _old_user_mime = os.path.join(paths.home_dir, '.gnumed', fname) try: open(_old_user_mime, 'r') print('obsolete: [%s]' % _old_user_mime) _log.error('obsolete: [%s], use [%s]', _old_user_mime, user_mime) except FileNotFoundError: pass except Exception: _log.exception('error checking for [%s]', _old_user_mime) _cfg.add_file_source ( source = 'user-mime', file = user_mime, encoding = enc ) _cfg.add_file_source ( source = 'system-mime', file = os.path.join(paths.system_config_dir, fname), encoding = enc )
Detect and setup access to GNUmed config file.
Parts of this will have limited value due to wxPython not yet being available.
def setup_cli()
-
Expand source code
def setup_cli(): from Gnumed.pycommon import gmCfgINI global _cfg _cfg = gmCfgINI.gmCfgData() _cfg.add_cli ( short_options = _known_short_options, long_options = _known_long_options ) val = _cfg.get(option = '--debug', source_order = [('cli', 'return')]) if val is None: val = False _cfg.set_option ( option = 'debug', value = val ) val = _cfg.get(option = '--slave', source_order = [('cli', 'return')]) if val is None: val = False _cfg.set_option ( option = 'slave', value = val ) val = _cfg.get(option = '--skip-update-check', source_order = [('cli', 'return')]) if val is None: val = False _cfg.set_option ( option = 'skip-update-check', value = val ) val = _cfg.get(option = '--hipaa', source_order = [('cli', 'return')]) if val is None: val = False _cfg.set_option ( option = 'hipaa', value = val ) val = _cfg.get(option = '--local-import', source_order = [('cli', 'return')]) if val is None: val = False _cfg.set_option ( option = 'local-import', value = val ) value = _cfg.get(option = '--special', source_order = [('cli', 'return')]) if value: value = value.split(',') print('GNUmed startup: --special:', value) else: value = [] _cfg.set_option(option = 'special', value = value) _cfg.set_option ( option = 'client_version', value = current_client_version ) _cfg.set_option ( option = 'client_branch', value = current_client_branch )
def setup_console_encoding()
-
Expand source code
def setup_console_encoding(): print_lines = [] try: sys.stdout.reconfigure(errors = 'surrogateescape') sys.stderr.reconfigure(errors = 'surrogateescape') _pre_log_buffer.append('stdout/stderr reconfigured to use <surrogateescape> for encoding errors') return except AttributeError: line = 'cannot reconfigure sys.stdout/stderr to use <errors="surrogateescape"> (needs Python 3.7+)' _pre_log_buffer.append(line) print_lines.append(line) try: _pre_log_buffer.append('sys.stdout/stderr default to "${PYTHONIOENCODING}=%s"' % os.environ['PYTHONIOENCODING']) return except KeyError: lines = [ '${PYTHONIOENCODING} is not set up, use <PYTHONIOENCODING=utf-8:surrogateescape> in the shell (for Python < 3.7)', 'console encoding errors may occur' ] for line in lines: print_lines.append(line) _pre_log_buffer.append(line) for line in print_lines: print('GNUmed startup:', line)
def setup_console_exception_handler()
-
Expand source code
def setup_console_exception_handler(): from Gnumed.pycommon.gmTools import handle_uncaught_exception_console sys.excepthook = handle_uncaught_exception_console
def setup_date_time()
-
Expand source code
def setup_date_time(): gmDateTime.init()
def setup_fault_handler(target=None)
-
Expand source code
def setup_fault_handler(target=None): if target is None: faulthandler.enable() _pre_log_buffer.append('<faulthandler> enabled, target = [console]: %s' % faulthandler) return _pre_log_buffer.append('<faulthandler> enabled, target = [%s]: %s' % (target, faulthandler)) faulthandler.enable(file = target)
def setup_local_repo_path()
-
Expand source code
def setup_local_repo_path(): local_repo_path = os.path.expanduser(os.path.join ( '~', '.local', 'gnumed', 'local_code', str(current_client_branch) )) local_wxGladeWidgets_path = os.path.join(local_repo_path, 'Gnumed', 'wxGladeWidgets') if not os.path.exists(local_wxGladeWidgets_path): _log.debug('[%s] not found', local_wxGladeWidgets_path) _log.info('local wxGlade widgets repository not available') return _log.info('local wxGlade widgets repository found:') _log.info(local_wxGladeWidgets_path) if not os.access(local_wxGladeWidgets_path, os.R_OK): _log.error('invalid repo: no read access') return all_entries = os.listdir(os.path.join(local_repo_path, 'Gnumed')) _log.debug('repo base contains: %s', all_entries) all_entries.remove('wxGladeWidgets') try: all_entries.remove('__init__.py') except ValueError: _log.error('invalid repo: lacking __init__.py') return try: all_entries.remove('__init__.pyc') except ValueError: pass if len(all_entries) > 0: _log.error('insecure repo: additional files or directories found') return # repo must be 0700 (rwx------) stat_val = os.stat(local_wxGladeWidgets_path) _log.debug('repo stat(): %s', stat_val) perms = stat.S_IMODE(stat_val.st_mode) _log.debug('repo permissions: %s (octal: %s)', perms, oct(perms)) if perms != 448: # octal 0700 if os.name in ['nt']: _log.warning('this platform does not support os.stat() permission checking') else: _log.error('insecure repo: permissions not 0600') return print("Activating local wxGlade widgets repository (%s) ..." % local_wxGladeWidgets_path) sys.path.insert(0, local_repo_path) _log.debug('sys.path with repo:') _log.debug(sys.path)
def setup_locale()
-
Expand source code
def setup_locale(): gmI18N.activate_locale() td = _cfg.get(option = '--text-domain', source_order = [('cli', 'return')]) l = _cfg.get(option = '--lang-gettext', source_order = [('cli', 'return')]) gmI18N.install_domain(domain = td, language = l, prefer_local_catalog = _cfg.get(option = 'local-import'))
def setup_logging()
-
Expand source code
def setup_logging(): try: from Gnumed.pycommon import gmLog2 as _gmLog2 except ImportError: print(import_error_sermon % '\n '.join(sys.path)) sys.exit(1) setup_fault_handler(target = _gmLog2._logfile) global gmLog2 gmLog2 = _gmLog2 gmLog2.print_logfile_name() global _log _log = logging.getLogger('gm.launcher')
def setup_paths_and_files()
-
Expand source code
def setup_paths_and_files(): """Create needed paths in user home directory.""" paths = gmTools.gmPaths(app_name = 'gnumed') # wxPython not available yet print("Temp dir:", paths.tmp_dir) # user work dir readme = """GNUmed Electronic Medical Record %s/ This directory should only ever contain files which the user will come into direct contact with while using the application (say, by selecting a file from the file system, such as when importing files as document parts). You can create subdirectories here as you see fit for the purpose. This directory will also serve as the default directory when GNUmed asks the user to select a directory for storing a file. Any files which are NOT intended for direct user interaction but must be configured to live at a known location (say, inter-application data exchange files) should be put under the directory: %s/ """ % (paths.user_work_dir, paths.user_appdata_dir) gmTools.mkdir(paths.user_work_dir) gmTools.create_directory_description_file(directory = paths.user_work_dir, readme = readme) gmTools.remove_file(os.path.join(paths.user_work_dir, '00_README')) # user app data dir gmTools.mkdir(paths.user_appdata_dir) readme = """This directory should be used for files not intended for user interaction at the file system level (file selection dialogs, file browsers) such as inter-application data exchange files which need to live at a known location.""" gmTools.create_directory_description_file(directory = paths.user_appdata_dir, readme = readme) # error logs dir err_dir = os.path.expanduser(os.path.join(paths.user_appdata_dir, 'error_logs')) gmTools.mkdir(err_dir) readme = 'Whenever an unhandled exception is detected a copy of the log file is placed here.\n\nThis directory is subject to systemd-tmpfiles cleaning.' gmTools.create_directory_description_file(directory = err_dir, readme = readme) # mark dir as old old_dot_gmd_dir = os.path.expanduser(os.path.join(paths.home_dir, '.gnumed')) readme = '[%s]: This directory is not used by GNUmed anymore.' % old_dot_gmd_dir gmTools.create_directory_description_file(directory = old_dot_gmd_dir, readme = readme) # directory for patient specific subdirs for storing data pats_dir = os.path.expanduser(os.path.join(paths.user_work_dir, 'patients')) gmTools.mkdir(pats_dir) readme = '\t[%s]\n\nIn this directory GNUmed will create subdirectories for patient data export.\n\nIt should be cleaned up from time to time.' % pats_dir gmTools.create_directory_description_file(directory = pats_dir, readme = readme) __migrate_old_user_gnumed_conf() # symlink log file into temporary directory for easier debugging (everything in one place) logfile_link = os.path.join(paths.tmp_dir, 'zzz-gnumed.log') gmTools.mklink (gmLog2._logfile.name, logfile_link, overwrite = False)
Create needed paths in user home directory.
def setup_python_path()
-
Expand source code
def setup_python_path(): if not '--local-import' in sys.argv: _pre_log_buffer.append('running against systemwide install') return local_python_import_dir = os.path.dirname ( os.path.abspath(os.path.join(sys.argv[0], '..')) ) print("Running from local source tree (%s) ..." % local_python_import_dir) _pre_log_buffer.append("running from local source tree: %s" % local_python_import_dir) # does the path exist at all, physically ? # (*broken* links are reported as False) link_name = os.path.join(local_python_import_dir, 'Gnumed') if os.path.exists(link_name): _pre_log_buffer.append('local module import dir symlink exists: %s' % link_name) else: real_dir = os.path.join(local_python_import_dir, 'client') print('Creating local module import symlink ...') print(' real dir:', real_dir) print(' link:', link_name) try: os.symlink(real_dir, link_name) except AttributeError: _pre_log_buffer.append('Windows does not have os.symlink(), resorting to ctypes') result = _symlink_windows(real_dir, link_name) _pre_log_buffer.append('ctypes.windll.kernel32.CreateSymbolicLinkW() exit code: %s', result) _pre_log_buffer.append('created local module import dir symlink: link [%s] => dir [%s]' % (link_name, real_dir)) sys.path.insert(0, local_python_import_dir) _pre_log_buffer.append('sys.path with local module import base dir prepended: %s' % sys.path)
def setup_signal_handlers()
-
Expand source code
def setup_signal_handlers(): global _old_sig_term old_sig_term = signal.signal(signal.SIGTERM, handle_sig_term)
def shutdown_backend()
-
Expand source code
def shutdown_backend(): gmPG2.shutdown()
def shutdown_logging()
-
Expand source code
def shutdown_logging(): # if _cfg.get(option = u'debug'): # import types # def get_refcounts(): # refcount = {} # # collect all classes # for module in sys.modules.values(): # for sym in dir(module): # obj = getattr(module, sym) # if type(obj) is types.ClassType: # refcount[obj] = sys.getrefcount(obj) # # sort by refcount # pairs = map(lambda x: (x[1],x[0]), refcount.items()) # pairs.sort() # pairs.reverse() # return pairs # rcfile = open('./gm-refcount.lst', 'wt', encoding = 'utf8') # for refcount, class_ in get_refcounts(): # if not class_.__name__.startswith('wx'): # rcfile.write(u'%10d %s\n' % (refcount, class_.__name__)) # rcfile.close() # do not choke on Windows logging.raiseExceptions = False
def shutdown_tmp_dir()
-
Expand source code
def shutdown_tmp_dir(): tmp_dir = gmTools.gmPaths().tmp_dir if _cfg.get(option = 'debug'): _log.debug('not removing tmp dir (--debug mode): %s', tmp_dir) return _log.warning('removing tmp dir: %s', tmp_dir) shutil.rmtree(tmp_dir, True)