Path: csiph.com!fu-berlin.de!uni-berlin.de!not-for-mail
From: Vinay Sajip <vinay_sajip@yahoo.co.uk>
Newsgroups: comp.lang.python.announce
Subject: ANN: A new version (0.4.1) of python-gnupg has been released.
Date: Mon, 10 Jul 2017 21:40:56 +0000 (UTC)
Lines: 117
Approved: python-announce-list@python.org
Message-ID: <mailman.21.1499758406.29743.python-announce-list@python.org>
References: <1241259385.3956741.1499722856981.ref@mail.yahoo.com> <1241259385.3956741.1499722856981@mail.yahoo.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
Precedence: list
Xref: csiph.com comp.lang.python.announce:2567

A new version of the Python module which wraps GnuPG has been released.

What Changed?
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
This is an enhancement and bug-fix release, and all users are encouraged to=
 upgrade.
See the project website [1] for more information.

Brief summary:

* Updated message handling logic to no longer raise exceptions when a messa=
ge isn't
=C2=A0=C2=A0recognised. Thanks to Daniel Kahn Gillmor for the patch.
* Always use always use --fixed-list-mode, --batch and --with-colons. Thank=
s to Daniel
=C2=A0=C2=A0Kahn Gillmor for the patch.
* Improved scan_keys() handling on GnuPG >=3D 2.1. Thanks to Daniel Kahn Gi=
llmor for the
=C2=A0=C2=A0patch.
* Improved test behaviour with GnuPG >=3D 2.1. Failures when deleting test =
directory trees
=C2=A0=C2=A0are now ignored. Thanks to Daniel Kahn Gillmor for the patch.
* Added close_file keyword argument to verify_file to allow the file closin=
g to be made
=C2=A0=C2=A0optional. Current behaviour is maintained - close_file=3DFalse =
can be passed to skip
=C2=A0=C2=A0closing the file being verified.
* Added the extra_args keyword parameter to allow custom arguments to be pa=
ssed to the
=C2=A0=C2=A0gpg executable.
* Instances of the GPG class now have an additional on_data attribute, whic=
h defaults to
=C2=A0=C2=A0None. It can be set to a callable which will be called with a s=
ingle argument - a binary
=C2=A0=C2=A0chunk of data received from the gpg executable. The callable ca=
n do whatever it likes
=C2=A0=C2=A0with the chunks passed to it - e.g. write them to a separate st=
ream. The callable should
=C2=A0=C2=A0not raise any exceptions (unless it wants the current operation=
 to fail).

This release [2] has been signed with my code signing key:

Vinay Sajip (CODE SIGNING KEY) <vina... at yahoo.co.uk>
Fingerprint: CA74 9061 914E AC13 8E66 EADB 9147 B477 339A 9B86

What Does It Do?
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
The gnupg module allows Python programs to make use of the
functionality provided by the Gnu Privacy Guard (abbreviated GPG or
GnuPG). Using this module, Python programs can encrypt and decrypt
data, digitally sign documents and verify digital signatures, manage
(generate, list and delete) encryption keys, using proven Public Key
Infrastructure (PKI) encryption technology based on OpenPGP.

This module is expected to be used with Python versions >=3D 2.4, as it
makes use of the subprocess module which appeared in that version of
Python. This module is a newer version derived from earlier work by
Andrew Kuchling, Richard Jones and Steve Traugott.

A test suite using unittest is included with the source distribution.

Simple usage:

>>> import gnupg
>>> gpg =3D gnupg.GPG(gnupghome=3D'/path/to/keyring/directory')
>>> gpg.list_keys()

[{
...
'fingerprint': 'F819EE7705497D73E3CCEE65197D5DAC68F1AAB2',
'keyid': '197D5DAC68F1AAB2',
'length': '1024',
'type': 'pub',
'uids': ['', 'Gary Gross (A test user) <gary.gr... at gamma.com>']},
{
...
'fingerprint': '37F24DD4B918CC264D4F31D60C5FEFA7A921FC4A',
'keyid': '0C5FEFA7A921FC4A',
'length': '1024',
...
'uids': ['', 'Danny Davis (A test user) <danny.da... at delta.com>']}]
>>> encrypted =3D gpg.encrypt("Hello, world!", ['0C5FEFA7A921FC4A'])
>>> str(encrypted)

'-----BEGIN PGP MESSAGE-----\nVersion: GnuPG v1.4.9 (GNU/Linux)\n
\nhQIOA/6NHMDTXUwcEAf
.
-----END PGP MESSAGE-----\n'
>>> decrypted =3D gpg.decrypt(str(encrypted), passphrase=3D'secret')
>>> str(decrypted)

'Hello, world!'
>>> signed =3D gpg.sign("Goodbye, world!", passphrase=3D'secret')
>>> verified =3D gpg.verify(str(signed))
>>> print "Verified" if verified else "Not verified"

'Verified'

As always, your feedback is most welcome (especially bug reports [3],
patches and suggestions for improvement, or any other points via the
mailing list/discussion group [4]).

Please refer to the documentation [5] for more information.

Enjoy!

Cheers

Vinay Sajip
Red Dove Consultants Ltd.

[1] https://bitbucket.org/vinay.sajip/python-gnupg
[2] https://pypi.python.org/pypi/python-gnupg/0.4.1
[3] https://bitbucket.org/vinay.sajip/python-gnupg/issues
[4] https://groups.google.com/forum/#!forum/python-gnupg
[5] https://gnupg.readthedocs.io/en/latest/=C2=A0