vsc-base

Build Status

• Python 2.6 :
• Python 2.7 :

Description

Common tools used within our organization. Originally created by the HPC team of Ghent University (http://ugent.be/hpc).

Documentation

https://jenkins1.ugent.be/job/vsc-base-python26/Documentation/

Namespaces and tools

lib/utils

python utilities to be used as libraries

• fancylogger: an extention of the default python logger designed to be easy to use and have a couple of fancy features.
• custom specifiers for mpi loggin (the mpirank) with autodetection of mpi
• custom specifier for always showing the calling function's name
• rotating file handler
• a default formatter.
• logging to an UDP server (logdaemon.py f.ex.)
• easily setting loglevel
• daemon.py : Daemon class written by Sander Marechal (http://www.jejik.com) to start a python script as a daemon.
• missing.py: Small functions and tools that are commonly used but not available in the Python (2.x) API.
• cache.py : File cache to store pickled data identified by a key accompanied by a timestamp. (moved to vsc-utils)
• generaloption.py : A general option parser for python. It will fetch options (in this order) from config files, from environment variables and from the command line and parse them in a way compatible with the default python optionparser. Thus allowing a very flexible way to configure your scripts. It also adds a few other useful extras.
• affinity.py : Linux cpu affinity.
• Based on sched.h and bits/sched.h,
• see man pages for sched_getaffinity and sched_setaffinity
• also provides a cpuset class to convert between human readable cpusets and the bit version Linux priority
• Based on sys/resources.h and bits/resources.h see man pages for getpriority and setpriority
• asyncprocess.py : Module to allow Asynchronous subprocess use on Windows and Posix platforms
• Based on a python recipe by Josiah Carlson
• added STDOUT handle and recv_some
• daemon.py : A generic daemon class by Sander Marechal
• dateandtime.py : A module with various convenience functions and classes to deal with date, time and timezone.
• nagios.py : This module provides functionality to cache and report results of script executions that can readily be interpreted by nagios/icinga.
• run.py : Python module to execute a command, can make use of asyncprocess, answer questions based on a dictionary
• supports a whole lot of ways to input, process and output the command. (filehandles, PIPE, pty, stdout, logging...)
• mail.py : Wrapper around the standard Python mail library.
• Send a plain text message
• Send an HTML message, with a plain text alternative

bin

A collection of python scripts, these are examples of how you could use fancylogger to log to a daemon, but should not be used directly.

• logdaemon.py: A daemon that listens on a port for udp packets and logs them to file, works toghether with fancylogger.
• startlogdaemon.py : Script that will start the logdaemon for you and set environment variables for fancylogger.

License

vsc-base is made available under the GNU Library General Public License (LGPL) version 2 or any later version.

Acknowledgements

vsc-base was created with support of Ghent University, the Flemish Supercomputer Centre (VSC), the Flemish Research Foundation (FWO), and the Department of Economy, Science and Innovation (EWI).