# Robust result objects
#
# Copyright (C) 2016 g10 Code GmbH
#
# This file is part of GPGME.
#
# GPGME is free software; you can redistribute it and/or modify it
# under the terms of the GNU Lesser General Public License as
# published by the Free Software Foundation; either version 2.1 of the
# License, or (at your option) any later version.
#
# GPGME is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
# Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this program; if not, see <https://www.gnu.org/licenses/>.
from __future__ import absolute_import, print_function, unicode_literals
del absolute_import, print_function, unicode_literals
"""Robust result objects
Results returned by the underlying library are fragile, i.e. they are
only valid until the next operation is performed in the context.
We cannot arbitrarily constrain the lifetime of Python objects, we
therefore create deep copies of the results.
"""
class Result(object):
"""Result object
Describes the result of an operation.
"""
"""Convert to types"""
_type = {}
"""Map functions over list attributes"""
_map = {}
"""Automatically copy unless blacklisted"""
_blacklist = {
'acquire',
'append',
'disown',
'next',
'own',
'this',
'thisown',
}
def __init__(self, fragile):
for key, func in self._type.items():
if hasattr(fragile, key):
setattr(self, key, func(getattr(fragile, key)))
for key, func in self._map.items():
if hasattr(fragile, key):
setattr(self, key, list(map(func, getattr(fragile, key))))
for key in dir(fragile):
if key.startswith('_') or key in self._blacklist:
continue
if hasattr(self, key):
continue
setattr(self, key, getattr(fragile, key))
def __repr__(self):
return '{}({})'.format(
self.__class__.__name__,
', '.join('{}={!r}'.format(k, getattr(self, k)) for k in dir(self)
if not k.startswith('_')))
class InvalidKey(Result):
pass
class EncryptResult(Result):
_map = dict(invalid_recipients=InvalidKey)
class Recipient(Result):
pass
class DecryptResult(Result):
_type = dict(wrong_key_usage=bool, is_de_vs=bool)
_map = dict(recipients=Recipient)
class NewSignature(Result):
pass
class SignResult(Result):
_map = dict(invalid_signers=InvalidKey, signatures=NewSignature)
class Notation(Result):
pass
class Signature(Result):
_type = dict(wrong_key_usage=bool, chain_model=bool, is_de_vs=bool)
_map = dict(notations=Notation)
class VerifyResult(Result):
_map = dict(signatures=Signature)
class ImportStatus(Result):
pass
class ImportResult(Result):
_map = dict(imports=ImportStatus)
class GenkeyResult(Result):
_type = dict(primary=bool, sub=bool)
class KeylistResult(Result):
_type = dict(truncated=bool)
class VFSMountResult(Result):
pass
class EngineInfo(Result):
pass
