Common utility functions for the PNU project
Project description
Installation
pip install pnu-libpnu
LIBPNU(3)
NAME
libpnu — Common utility functions for the PNU project
SYNOPSIS
import libpnu
libpnu.initialize_debugging(String program_name)
libpnu.handle_interrupt_signals(Function handler_function)
String libpnu.get_home_directory()
List libpnu.locate_directory(String directory)
DESCRIPTION
The initialize_debugging() function sets up the Python logging module with a syslog style kind of console log using program_name as the program name. By default, the logging level is set at WARNING or more, but can be lowered by calling logging.disable(), for example with the logging.NOTSET parameter to get DEBUG or more logging level.
The handle_interrupt_signals() function calls the specified handler_function to process the SIGINT and SIGPIPE signals, usually to avoid an ugly trace dump to the console in case of interrupt (Control-C pressed or broken pipe).
The get_home_directory() function returns the location of the user's home directory in a string depending on the operating system used (Unix, Windows).
The locate_directory() function searches the specified directory in a variety of possible other directories, depending on the operating system used (Unix, Windows) and the fact that a package can be user or system installed. It is intended to be used when the directory can't be directly found, and returns a list of paths where the directory searched has been found.
For example, if the argument is "/usr/local/etc/man.d", we'll search for "usr/local/etc/man.d", "local/etc/man.d", "etc/man.d" (more likely) and "man.d" in a list of user's local Python package directories ("$HOME/.local" on Unix, "$APPDATA/python", "$HOMEPATH/appdata/roaming/python", "$USERPROFILE/appdata/roaming/python" on Windows) and system wide Python package base directories (given by sys.base_prefix: "/usr/local" on Unix, "C:/Program Files/Python3x" on Windows).
ENVIRONMENT
The following environment variables can be used to identify the user identity and home directory.
On Unix: HOME, LOGNAME, USER, LNAME and USERNAME.
On Windows: APPDATA, HOME, HOMEPATH and USERPROFILE.
STANDARDS
The libpnu library is not a standard UNIX one.
It tries to follow the PEP 8 style guide for Python code.
PORTABILITY
To be tested under Windows.
HISTORY
This library was made for the PNU project.
LICENSE
It is available under the 3-clause BSD license.
AUTHORS
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pnu_libpnu-1.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3d3fed2c1e085b8a5b51e277b99a6b4dab23dda385c56238972b4fc017a0f0e3 |
|
MD5 | fded04caebcbb6e76262ef324e7c8476 |
|
BLAKE2b-256 | 0a81507034112c4b5566cba9b6a6fe1bdaa276bf3ad4fda2f285704804402f0f |