1 Python module and tools for communicating in the Assuan_ protocol.
3 There are a number of GnuPG_ wrappers for python `out there`__, but
4 they mostly work via the ``gpg`` executable. This is an attempt to
5 cut to the chase and speak directly to ``gpgme-tool`` (source__) over
6 a well-defined socket protocol.
20 I've packaged ``pyassuan`` for Gentoo_. You need layman_ and
21 my `wtk overlay`_. Install with::
23 # emerge -av app-portage/layman
25 # emerge -av dev-python/pyassuan
30 ``pyassuan`` is a simple package with no external dependencies outside
31 the Python 3 standard library.
36 ``pyassuan`` is available as a Git_ repository::
38 $ git clone git://tremily.us/pyassuan.git
40 See the homepage_ for details. To install the checkout, run the
43 $ python setup.py install
48 Checkout the docstrings and the examples in ``bin``.
53 Run the internal unit tests using nose_::
55 $ nosetests --with-doctest --doctest-tests pyassuan
57 If a Python-3-version of ``nosetests`` is not the default on your
58 system, you may need to try something like::
60 $ nosetests-3.2 --with-doctest --doctest-tests pyassuan
62 To test running servers by hand, you can use `gpg-connect-agent`_.
63 Despite the name, this program can connect to any Assuan server::
65 $ gpg-connect-agent --raw-socket name
70 This project is distributed under the `GNU General Public License
71 Version 3`_ or greater.
80 .. _Assuan: http://www.gnupg.org/documentation/manuals/assuan/
81 .. _GnuPG: http://www.gnupg.org/
82 .. _wrappers: http://wiki.python.org/moin/GnuPrivacyGuard
84 http://git.gnupg.org/cgi-bin/gitweb.cgi?p=gpgme.git;a=blob;f=src/gpgme-tool.c;hb=HEAD
85 .. _enable-special-filenames:
86 http://lists.gnupg.org/pipermail/gnupg-devel/2002-November/019343.html
87 .. _Gentoo: http://www.gentoo.org/
88 .. _layman: http://layman.sourceforge.net/
89 .. _wtk overlay: http://blog.tremily.us/posts/Gentoo_overlay/
90 .. _Git: http://git-scm.com/
91 .. _homepage: http://blog.tremily.us/posts/pyassuan/
92 .. _nose: http://readthedocs.org/docs/nose/en/latest/
93 .. _gpg-connect-agent:
94 http://www.gnupg.org/documentation/manuals/gnupg-devel/gpg_002dconnect_002dagent.html
95 .. _GNU General Public License Version 3: http://www.gnu.org/licenses/gpl.html