Skip to content

Latest commit

 

History

History
65 lines (53 loc) · 3.9 KB

README.md

File metadata and controls

65 lines (53 loc) · 3.9 KB
Raw

vsc-base

Build Status

  • Python 2.6 : Build Status
  • Python 2.7 : Build Status

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 Hercules foundation and the Department of Economy, and the Department of Economy, Science and Innovation (EWI).