Rearrange Host attributes from vpn service (closes #33)

The attribute names are named after the tinc configuration variables to
avoid confusion and the name of the host is now the HostHandler key.

Add an example of regular attributes usage with a ValidatedClass

ValidatedClass were only used with Field instances as attributes.
Sometimes regular (not validated) attributes are needed.

Call ComposedSubHandler._attr() with cont parameter (closes #31)

Convert serializer data to unicode in PyminDaemon (closes #28).

Remove invalid TODO comment in proxy host subhandler (closes #8).

DictSubHandler fits just fine for proxy host management.

Split proxy handler in submodules (refs #2).

Split vpn handler in submodules (refs #2).

Split qos handler in submodules (refs #2).

Split ppp handler in submodules (refs #2).

Split ip handler in submodules (refs #2).

Split nat handler in submodules (refs #2).

Split firewall handler in submodules (refs #2).

Split dns handler in submodules (refs #2).

Split dhcp handler in submodules (refs #2).

vrrp service code cleanup.

Use standard Item*Error and Container*Error exceptions in QoS handler.

Fix example configuration file for development.

ppp configuration was broken because the name of the service were used
twice in the path where to store the configuration files.

Add example configuration files for initialization logging (refs #7).

Includes both development and production examples.

Add initialization logging configuration customization (refs #7).

Before user logging configuration can be loaded, pymin already can emit a
lot of logging information. This patch provides a way to customize the
logging configuration before the standard configuration framework take
place.

By default, it tries to read /etc/pymind/log.init.ini configuration file,
unless PYMIND_LOGINITCONF environment variable is set, in which case the
file specified by that variable it readed. If it fails to load the
configuration file, it use a reasonble default.

This is mostly useful for debugging/development purposes.

Add an example production logging configuration file (refs #7).

Add an example development logging configuration file (refs #7).

Hack to overcome Python's bug 3136 in logging system (refs #7).

logging.config.fileConfig() disables all existing loggers that are not
configured using the config file. This hack re-enable the loggers so
everything works as expected even when you don't specify *all* the loggers
in the configuration files (and child loggers really inherits their parent
configuration).

Add logging configuration capabilities (closes #7).

Add an option (log-config-files) to specify logging (standard Python's)
configuration files to use to configure the logging system.

Shutdown logging properly when exiting pymind.

Add die() function to pymind for fatal errors.

Use critical as the log level for fatal errors in pymind.

Move ip_forward activation to a function.

This has to go away, but for now put it in a function and evaluate it just
before we start serving requests.

Remove configuration examples.

Add configuration and command-line option framework.

The new pymin.config module integrates both ConfigParser and optparse
Python modules, adding variables validation throw formencode library and
hooks for plug-ins to add options in run-time.

This closes #3, closes #4 and closes #6.

Move logging module setup to pymind.

logging module setup should go in a configuration file, but for now we
keep it in the pymind program to leave things functional until then.

Move ip_forward activation from config to pymind.

This should go away anyways (either documenting that that feature should
be enabled before pymind starts or by moving it to the IP service).

Use logging module to report errors in pymind.

Use a nice name for exit status.

Remove plug-in code from handler module in services (refs #27).

Cosmetic changes to service's imports.

Split plug-in code from handler code for services (refs #27).

Add logging to pymin.service module (refs #27).

Move services outside the "static" pymin modules structure (refs #27).

Use a plug-in architecture for services (refs #27).

Service modules are loaded dinamically using the imp module. The config.py
file is simplified to avoid the need of defining pymind command handlers
"tree" in the configuration file.

Fix a typo in a log message format in VrrpHandler (closes #26).

Fix procman.ProcessInfo.__repr__() (refs #11).

Callback could be "dereferenced" even being None.

Make procman.ProcessManager accept a ProcessInfo as argument (refs #11).

Methods register(), unregister(), once(), start(), stop(), restart() and
kill() now accept a ProcessInfo as the *name* argument.

Make procman.ProcessManager return True is an action could be taken (refs #11).

For start(), stop(), restart() and kill(), return True if the action could
be taken. That is True if the process wasn't already running for start(),
and for stop(), restart() and kill(), True if the process was already
running.

Make procman.ProcessInfo.error_count a read-only property.

Make procman.ProcessManager.restart(p) update pidmap when p was running.

pidmap was not updated, so extrange things could happen. A testcase was
added too.

procman.ProcessManager.restart(p) call start(p) when p was not running.

Otherwise, the namemap and pidmap are not updated.

Make some procman.ProcessManager's methods return the ProcessInfo instance.

Now registar(), unregister() and once() procman.ProcessManager's methods
returns the ProcessInfo instance just created/removed.

Make magic methods of procman.ProcessManager aliases of normal methods.

Add a simple testcase too.

Make procman.ProcessInfo.process a read-only property.

Mark procman.ProcessInfo.signal as private.

Mark procman.ProcessInfo.dont_run as private.

Make procman.ProcessInfo.name a read-only property.

Rename procman.ProcessManager.call to once.

call made not very clear that the process didn't remain registered.

Check for name uniqueness when a new process is added to ProcessManager.

This check is against both current running processes (namemap) and the
registered processes (services) to ensure that the name is unique and so
process gets overriden.

Change ProcessInfo.running to a read-only property.

It's dumb to duplicate that state when it can be more reliably obtained
using Popen.poll().

Add some checks to the testcase too.

Add an example of process waiting to testcase.

This provides an example on how to access to the subprocess.Popen
associated to a procman.ProcessInfo object.

Call wait() on the Popen object instead of the ProcessInfo object.

This should fix ProcessManager.restart() method, so we add it as a global
function too.

Improve procman testcase.

Tidy procman.ProcessInfo constructor related arguments.

Catch exception when trying to write /proc/.../ip_forward in the config file.

This way pymind can be used by non-root users.

Fix ConfigWriter class documentation.

Remove imports for unused modules.

Use the "virual deletion" facilities from XxxSubHandler (fixes #23).

Give a nice error if a VPN key can't be readed (refs #22).

Remove duplicated code.

Use os.makedirs to create directories instead of exec mkdir (refs #22).

Also check for errors creating the new diretory.

Convert to unicode before encoding to UTF-8 in firewall template (fixes #16).

Don't override the ListSubHandler.delete() method in HopHandler (fixes #19).

Use the ContainerSubHandler._attr method as a method (fixes #18).

Convert HopHandler to a ListSubHandler (fixes #15, fixes #12).

HopHandler was doing all the dirty job in the old fashion. Now it inherits
from ListSubHandler, adding code only for the custom checks.

Remove TODO list (moved to issues tracker).

Convert Rule to Item for validation in firewall service handler.

Bugfix: use index/key to report ItemAlreadyExistsError.

Remove unused formencode validators imports.

Add __all__ to pymin.item.

Bugfix: replace __ALL__ with the correct __all__.

Merge branch 'master' of git.llucax.com.ar:/var/lib/git/software/pymin

* 'master' of git.llucax.com.ar:/var/lib/git/software/pymin:
  Improve detection of bad arguments errors in dispatcher handlers.

Prepare pymindaemon to handle formencode.Invalid exceptions.

Now the pymindaemon can handle 2 kind of exceptions as "expected":
dispatcher.Error and formencode.Invalid.

The documentation and testcases has been improved.

Improve  description parsing again the TypeError.

Now the parsing is done in the WrongArgumentsError class, improving the
encapsulation. The parsing is improved too, to detect more errors.

Improve detection of bad arguments errors in dispatcher handlers.

The previos scheme was based on parsing TypeError messages, so it was very
poor because spourious errors could have been raised (is a subcall inside
a handler made a wrong function call). The new scheme involves a wrapper
with a dummy function with the same signature as the original handler.
The wrapper then call the dummy function to check the arguments and catches
any TypeError in that NOP call. If an error is catched, it's translated to
a WrongArgumentError, if not, the real hanlder is called with that (now
knonw to be right) arguments.

Testcases were updated and extended too.

Improve detection of bad arguments errors in dispatcher handlers.

The previos scheme was based on parsing TypeError messages, so it was very
poor because spourious errors could have been raised (is a subcall inside
a handler made a wrong function call). The new scheme involves a wrapper
with a dummy function with the same signature as the original handler.
The wrapper then call the dummy function to check the arguments and catches
any TypeError in that NOP call. If an error is catched, it's translated to
a WrongArgumentError, if not, the real hanlder is called with that (now
knonw to be right) arguments.

Testcases were updated and extended too.

Bugfix: don't call the handler twice.

Merge branch 'master' of git.llucax.com.ar:/var/lib/git/software/pymin

* 'master' of git.llucax.com.ar:/var/lib/git/software/pymin:
  Move handler decorator help checking to avoid an extra level in the stack trace.

Move handler decorator help checking to avoid an extra level in the stack trace.

Add an INSTALL file, at least to keep track of the dependencies.

Bugfix: fix pymin.serializer test case import.

Add pymin.item module.

Add pymin.validatedclass module.

Add logging support to procman module.

Merge branch 'procman'

* procman:
  Bugfix: set the catched signal to None *after* calling the signal handler.
  Improve vrrp restorable defaults readability.
  Use procman.restart() to restart vrrp service.
  Add ProcessManager.restart() method to block until the restart is done.
  Use procman to manage vrrp service.
  Bugfix: raise a KeyError, don't return it.
  Bugfix: call ProcessInfo.stop() in the right way (without parameters).
  Bugfix: use self instead of an unbinded pi object when killing a process.
  Remove unused ProcessInfo.last_return attribute.
  Bugfix: use correct module for simbol ECHILD.
  Handle SIGCHLD in PyminDaemon.
  Add a global ProcessManager instance and functions to procman module.
  Implement timer in PyminDaemon using EventLoop signal handling.
  Support general signals handling in EventLoop.
  Replace time.sleep() for signal.pause() in the ProcessManager test.
  Improve ProcessManager to manage registerable named services.
  Add a ProcessManager class to manage processes.
  Improve ProcessManager to manage registerable named services.
  Add a ProcessManager class to manage processes.

Conflicts:

pymin/eventloop.py
pymin/pymindaemon.py
pymin/services/vrrp/__init__.py

Merge branch 'master' of git.llucax.com.ar:/var/lib/git/software/pymin into logging

* 'master' of git.llucax.com.ar:/var/lib/git/software/pymin:
  Add protocol specification of firewall and nat commands.
  Added the protocol specification.
  Root class inyects ip forwrading in constructor.
  Added route handling capabilities and service restarting
  Fix so that when a device is brought back up, the routes
  Added support to hook services to IPHandler.
  Support for inactive devices added in IPHandler.

Conflicts:

pymin/services/ip/__init__.py

Merge branch 'master' of git.llucax.com.ar:/var/lib/git/software/pymin into procman

* 'master' of git.llucax.com.ar:/var/lib/git/software/pymin:
  Add protocol specification of firewall and nat commands.
  Added the protocol specification.
  Root class inyects ip forwrading in constructor.
  Added route handling capabilities and service restarting
  Fix so that when a device is brought back up, the routes
  Added support to hook services to IPHandler.
  Support for inactive devices added in IPHandler.
  Remove ReturnNot0Error, use subprocess.check_call instead.
  qos implementation (working)
  qos template fixes

Merge branch 'master' of git.llucax.com.ar:/var/lib/git/software/pymin

Merge commit 'llucax/logging' into logging

Conflicts:

config.py
pymin/pymindaemon.py

Merge commit 'scm/master'

Merge branch 'master' of baryon.com.ar:/home/luca/pymin

Conflicts:

config.py

Add protocol specification of firewall and nat commands.

Added the protocol specification.

Root class inyects ip forwrading in constructor.

Added route handling capabilities and service restarting
upon device events such as up and down.