gpgme/lang/python
Ben McGinnes 75463d5895 doc: Basic operation of the python bindings
* Added sample code for encrypting some text to a single key.
* Basically I'm just lifting existing production code and changing the
  key IDs from mine to "0x12345678DEADBEEF" for these first few
  examples.
* I'll fill in the text description after.
* Note: due to my regional location, I might split some tasks into
  more commits in order to be sure no work gets lost in case of
  emergency (or to put it another way: I know Telstra too well to
  trust them).
2018-03-09 04:42:41 +11:00
..
docs doc: Basic operation of the python bindings 2018-03-09 04:42:41 +11:00
examples Spelling fixes for comments and doc 2017-12-08 05:59:11 +01:00
src python: Improve error handling. 2017-07-11 12:28:39 +02:00
tests tests: Makefile portability. 2018-02-15 11:14:49 +09:00
gpgme.i python: Default whence argument for Data() to SEEK_SET. 2017-12-04 08:10:06 +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 Renaming ad infinitum ... 2018-02-20 03:13:42 +11:00
README.org Title fix 2018-02-20 03:11:02 +11: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

		   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
		    GPG - GPGME BINDINGS FOR PYTHON
		   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


Table of Contents
─────────────────

1 Mailing List
2 Bugs
3 Authors
4 History


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.


1 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]


2 Bugs
══════

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


3 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.


4 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]