* These classes also play a few other tricks, like the steps taken to disable
pinentry if GPG.use_agent=False:
1) detect if gpg-agent is running for the same EUID as python,
and if it is then
2) find out if the user wants us to use it, and if they don't then
3) find if pinentry is installed, and if it is then
4) modify the system PATH to exclude the directory where pinentry is,
symlinking out gpg if gpg was in the same directory, and then
5) register an _exithandler with the interpreter to replace the
original environment when the interpreter exits.
* This allows us to define immutable x.getter and x.setter methods in a
parent class while still inheriting the ability to alter the descriptor in
a child class without needing to set something like:
@property
def x(self):
super(self.__class__, self)._get_x()
as a property override for every descriptor.
* Include _ansistrm.py, which was released under new BSD license separately in
a github gist as well as in the Python logutils module. Instead of setting
up a src/includes/ directory, I have included this file in the currently
flat module directory, because dealing with submodule imports in Python2.x
is a pain. I'm not sure if this will cause problems for Debian packaging,
but it could be changed later if so. The full text of the original license
and copyright has been retained at the head of _ansistrm.py, clearly
demarcated from python-gnupg's license and copyright info. The author of
_ansistrm.py is the same as the current upstream maintainer for
python-gnupg, Vinay Sajip, and I don't see why this person doesn't include
_ansistrm.py in all of their packages, because it is making skimming the
test logs for errors much faster.
* Add _logger.py, which contains a class decorator:
@wraps(logging.Logger)
def create_logger(level=logging.NOTSET)
[...]
which autoconfigures logging functionality. By default, logging.NullHandler
is still used, so there are no logs (neither logfiles nor piped to
stdout). If _logger.create_logger() is called with either a LEVEL attribute
from the logging module, or the integer equivalent, it will initialise
logging to stdout only. In the unittest suite, extra log handling
functionality is added to also write to a datetime-stamped logfile in the
tests/ directory.
* Change all "logger.<level>" statements to "log.<level>" and add new ones for
debugging and user information purposes.
* Remove the import of the python standard utilities logging module from:
src/gnupg.py
src/parsers.py
src/util.py
and switch to setting a top-level attribute, util.log, which is the returned
class from _logger.create_logger(). Everything else now does "from util
import log".
Isis Lovecruft