Package flumotion :: Package common :: Module common
[show private | hide private]
[frames | no frames]

Module flumotion.common.common

small common functions used by all processes
Function Summary
  addressGetHost(a)
Get the host name of an IPv4 address.
  addressGetPort(a)
Get the port number of an IPv4 address.
  argRepr(args, kwargs, max)
Return a string representing the given args.
  checkPidRunning(pid)
Check if the given pid is currently running.
boolean checkPortFree(port)
Check if the given local port is free to accept on.
boolean checkRemotePort(host, port)
Check if the given remote host/port is accepting connections.
  componentPath(componentName, parentName)
Create a path string out of the name of a component and its parent.
  daemonize(stdin, stdout, stderr)
This forks the current process into a daemon.
  deletePidFile(type, name)
Delete the pid file in the run directory, using the given process type and process name for the filename.
  ensureDir(dir, description)
Ensure the given directory exists, creating it if not.
string formatStorage(units, precision)
Nicely formats a storage size using SI units.
string formatTime(seconds)
Nicely format time in a human-readable format.
int getFirstFreePort(startPort)
Get the first free port, starting from the given port.
  getLL()
Return the (at most) two-letter language code set for message translation.
  getPid(type, name)
Get the pid from the pid file in the run directory, using the given process type and process name for the filename.
  getPidPath(type, name)
Get the full path to the pid file for the given process type and name.
  gettexter(domain)
Returns a method you can use as _ to translate strings for the given domain.
  killPid(pid)
Send the given process a KILL signal.
  mergeImplements(*classes)
Merge the __implements__ tuples of the given classes into one tuple.
  objRepr(object)
Return a string giving the fully qualified class of the given object.
  pathToModuleName(path)
Convert the given (relative) path to the python module it would have to be imported as.
  termPid(pid)
Send the given process a TERM signal.
  version(binary)
Print a version block for the flumotion binaries.
  waitForTerm()
Wait until we get killed by a TERM signal (from someone else).
  waitPidFile(type, name)
Wait for the given process type and name to have started and created a pid file.
  writePidFile(type, name)
Write a pid file in the run directory, using the given process type and process name for the filename.

Function Details

addressGetHost(a)

Get the host name of an IPv4 address.
Parameters:
a
           (type=twisted.internet.address.IPv4Address)

addressGetPort(a)

Get the port number of an IPv4 address.
Parameters:
a
           (type=twisted.internet.address.IPv4Address)

argRepr(args=(), kwargs={}, max=-1)

Return a string representing the given args.

checkPidRunning(pid)

Check if the given pid is currently running.
Returns:
whether or not a process with that pid is active.

checkPortFree(port)

Check if the given local port is free to accept on.
Parameters:
port
           (type=int)
Returns:
boolean

checkRemotePort(host, port)

Check if the given remote host/port is accepting connections.
Parameters:
port
           (type=int)
Returns:
boolean

componentPath(componentName, parentName)

Create a path string out of the name of a component and its parent.

daemonize(stdin='/dev/null', stdout='/dev/null', stderr='/dev/null')

This forks the current process into a daemon. The stdin, stdout, and stderr arguments are file names that will be opened and be used to replace the standard file descriptors in sys.stdin, sys.stdout, and sys.stderr. These arguments are optional and default to /dev/null. Note that stderr is opened unbuffered, so if it shares a file with stdout then interleaved output may not appear in the order that you expect.

deletePidFile(type, name)

Delete the pid file in the run directory, using the given process type and process name for the filename.

ensureDir(dir, description)

Ensure the given directory exists, creating it if not. Raises a SystemError if this fails, including the given description.

formatStorage(units, precision=2)

Nicely formats a storage size using SI units. See Wikipedia and other sources for rationale. Prefixes are k, M, G, ... Sizes are powers of 10. Actual result should be suffixed with bit or byte, not b or B.
Parameters:
units - the unit size to format
           (type=int or float)
precision - the number of floating point digits to use
           (type=int)
Returns:
value of units, formatted using SI scale and the given precision
           (type=string)

formatTime(seconds)

Nicely format time in a human-readable format. Will chunks weeks, days, hours and minutes.
Parameters:
seconds - the time in seconds to format.
           (type=int or float)
Returns:
a nicely formatted time string.
           (type=string)

getFirstFreePort(startPort)

Get the first free port, starting from the given port.
Parameters:
startPort
           (type=int)
Returns:
int

getLL()

Return the (at most) two-letter language code set for message translation.

getPid(type, name)

Get the pid from the pid file in the run directory, using the given process type and process name for the filename.
Returns:
pid of the process, or None if not running or file not found.

getPidPath(type, name)

Get the full path to the pid file for the given process type and name.

gettexter(domain)

Returns a method you can use as _ to translate strings for the given domain.

killPid(pid)

Send the given process a KILL signal.
Returns:
whether or not the process with the given pid was running

mergeImplements(*classes)

Merge the __implements__ tuples of the given classes into one tuple.

objRepr(object)

Return a string giving the fully qualified class of the given object.

pathToModuleName(path)

Convert the given (relative) path to the python module it would have to be imported as.

Return None if the path is not a valid python module

termPid(pid)

Send the given process a TERM signal.
Returns:
whether or not the process with the given pid was running

version(binary)

Print a version block for the flumotion binaries.
Parameters:
binary - name of the binary
           (type=string)

waitForTerm()

Wait until we get killed by a TERM signal (from someone else).

waitPidFile(type, name)

Wait for the given process type and name to have started and created a pid file.

Return the pid.

writePidFile(type, name)

Write a pid file in the run directory, using the given process type and process name for the filename.

Generated by Epydoc 2.1 on Tue Dec 20 15:33:10 2005 http://epydoc.sf.net