GpgFrontend/gpgme
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
46d2e48105
gpgme/lang/python
History
Justus Winter 1e68f93dc5
python: Improve error handling. 
* NEWS: Update.
* lang/python/src/core.py (Context.__read__): New helper function.
(Context.encrypt): Attach partial results to exceptions.
(Context.decrypt): Likewise.
(Context.sign): Likewise.
(Context.verify): Likewise.
* lang/python/src/errors.py (GpgError): Move the core of GPGMEError to
this class, add a nicer interface for it.  This makes the errors
thrown by this library more uniform, and allows us to track the
underlying error in synthesized high-level errors.
(GPGMEError): Simplify.
(...): Make sure to call the parent classes' constructor in all other
classes.
--

Attach partial results to errors.  Some operations return results even
though they signal an error.  Of course this information must be taken
with a grain of salt.  But often, this information is useful for
diagnostic uses or to give the user feedback.  Since the normal
control flow is disrupted by the exception, the callee can no longer
return results, hence we attach them to the exception objects.

GnuPG-bug-id: 3271
Signed-off-by: Justus Winter <justus@g10code.com>
2017-07-11 12:28:39 +02:00
..
docs python: Rename Python module from PyME to gpg. 2016-10-31 15:42:27 +01:00
examples python: Use vanity modules for constants in tests and examples. 2016-10-31 15:42:35 +01:00
src python: Improve error handling. 2017-07-11 12:28:39 +02:00
tests python: Fix test environment creation. 2017-05-10 16:19:52 +02:00
gpgme.i python: Wrap 'gpgme_op_keylist_from_data_start'. 2017-03-21 12:55:33 +01:00
helpers.c python: Fix passphrase callback wrapping. 2017-02-16 14:49:27 +01:00
helpers.h python: Rename Python module from PyME to gpg. 2016-10-31 15:42:27 +01:00
Makefile.am python: use autoconf pre-processor when building via autoconf 2017-04-11 10:24:44 +02:00
MANIFEST.in python: simplify build, some fixups 2017-04-07 12:12:20 +02:00
private.h python: Rename Python module from PyME to gpg. 2016-10-31 15:42:27 +01:00
README python: Rename Python module from PyME to gpg. 2016-10-31 15:42:27 +01:00
setup.py.in python: Fix build in certain cases. 2017-05-18 12:22:29 +02:00
version.py.in python: simplify build, some fixups 2017-04-07 12:12:20 +02:00

README 

gpg - GPGME bindings for Python                                      -*- org -*-
=======================

The "gpg" module is a python interface to the GPGME library:
https://www.gnupg.org/related_software/gpgme/

"gpg" offers two interfaces, one is a high-level, curated, and
idiomatic interface that is implemented as a shim on top of the
low-level interface automatically created using SWIG.

This way we make simple things easy, while still providing the entire
functionality of the underlying library.

* Mailing List

For general discussion and help see the gnupg-users mailing list:
https://lists.gnupg.org/mailman/listinfo/gnupg-users

For development see the gnupg-devel mailing list:
https://lists.gnupg.org/mailman/listinfo/gnupg-devel

* Bugs

Please report bugs using our bug tracker using the category 'gpgme',
and topic 'python':
https://bugs.gnupg.org/gnupg/

* Authors

PyME was created by John Goerzen, and maintained, developed, and
cherished by Igor Belyi, Martin Albrecht, Ben McGinnes, and everyone
who contributed to it in any way.

In 2016 we merged a port of PyME to into the GPGME repository, and
development will continue there.  Please see the VCS history for the
list of contributors, and if you do find bugs, or want to contribute,
please get in touch and help maintain the python gpg bindings.

Please see the section 'History' further down this document for
references to previous versions.

* History

 - The python bindings were renamed from PyME to "gpg" in 2016.

 - The bindings have been merged into the GPGME repository in 2016.

 - The latest version of PyME for Python 3.2 and above (as of
   May, 2015) is v0.9.1.
   https://git.gnupg.org/gpgme.git/lang/py3-pyme

 - The latest version of PyME for Python 2.6 and 2.7 (as of this
   writing) is v0.9.0.  https://bitbucket.org/malb/pyme

 - A previous version of PyME v0.8.0 can be found on sourceforge:
   http://pyme.sourceforge.net/

 - A previous version of PyME v0.5.1 which works with GPGME v0.3.15
   can be found on John Goerzen's PyME page:
   http://quux.org/devel/pyme/
   http://www.complete.org/JohnGoerzen