There are a number of GnuPG_ wrappers for python `out there`__, but
they mostly work via the ``gpg`` executable. This is an attempt to
-cut to the chase and speak directly to ``gpg-agent``. Unfortunately,
-``gpg`` only uses ``gpg-agent`` for passphrase caching, not
-encryption. This means that speaking directly to ``gpg-agent``
-doesn't help you do much cryptography.
+cut to the chase and speak directly to ``gpgme-tool`` (source__) over
+a well-defined socket protocol.
__ wrappers_
+__ gpgme-tool_
Installation
============
------------
``pyassuan`` is a simple package with no external dependencies outside
-the Python 3 standard library.
+the Python 3.3+ standard library.
Installing by hand
------------------
-``pgp-mime`` is available as a Git_ repository::
+``pyassuan`` is available as a Git_ repository::
- $ git clone git://tremily.us/pgp-mime.git
+ $ git clone git://tremily.us/pyassuan.git
See the homepage_ for details. To install the checkout, run the
standard::
Testing
=======
-Run the internal unit tests using nose_::
+Run the internal unit tests with `Python 3.2+'s unittest discovery`__::
- $ nosetests --with-doctest --doctest-tests pgp-mime
-
-If a Python-3-version of ``nosetests`` is not the default on your
-system, you may need to try something like::
-
- $ nosetests-3.2 --with-doctest --doctest-tests pgp-mime
+ $ python -m unittest discover
To test running servers by hand, you can use `gpg-connect-agent`_.
Despite the name, this program can connect to any Assuan server::
$ gpg-connect-agent --raw-socket name
+__ unittest-discovery_
+
Licence
=======
======
W. Trevor King
-wking@drexel.edu
+wking@tremily.us
.. _Assuan: http://www.gnupg.org/documentation/manuals/assuan/
.. _GnuPG: http://www.gnupg.org/
.. _wrappers: http://wiki.python.org/moin/GnuPrivacyGuard
-.. _enable-special-filenames:
- http://lists.gnupg.org/pipermail/gnupg-devel/2002-November/019343.html
+.. _gpgme-tool:
+ http://git.gnupg.org/cgi-bin/gitweb.cgi?p=gpgme.git;a=blob;f=src/gpgme-tool.c;hb=HEAD
.. _Gentoo: http://www.gentoo.org/
.. _layman: http://layman.sourceforge.net/
.. _wtk overlay: http://blog.tremily.us/posts/Gentoo_overlay/
.. _Git: http://git-scm.com/
.. _homepage: http://blog.tremily.us/posts/pyassuan/
-.. _nose: http://readthedocs.org/docs/nose/en/latest/
.. _gpg-connect-agent:
http://www.gnupg.org/documentation/manuals/gnupg-devel/gpg_002dconnect_002dagent.html
+.. _unittest-discovery:
+ https://docs.python.org/3.5/library/unittest.html#unittest-test-discovery
.. _GNU General Public License Version 3: http://www.gnu.org/licenses/gpl.html