README

   1 Python module and tools for communicating in the Assuan_ protocol.
   2
   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.
   7
   8 __ wrappers_
   9 __ gpgme-tool_
  10
  11 Installation
  12 ============
  13
  14 Packages
  15 --------
  16
  17 Gentoo
  18 ~~~~~~
  19
  20 I've packaged ``pyassuan`` for Gentoo_.  You need layman_ and
  21 my `wtk overlay`_.  Install with::
  22
  23   # emerge -av app-portage/layman
  24   # layman --add wtk
  25   # emerge -av dev-python/pyassuan
  26
  27 Dependencies
  28 ------------
  29
  30 ``pyassuan`` is a simple package with no external dependencies outside
  31 the Python 3.3 standard library.
  32
  33 Installing by hand
  34 ------------------
  35
  36 ``pyassuan`` is available as a Git_ repository::
  37
  38   $ git clone git://tremily.us/pyassuan.git
  39
  40 See the homepage_ for details.  To install the checkout, run the
  41 standard::
  42
  43   $ python setup.py install
  44
  45 Usage
  46 =====
  47
  48 Checkout the docstrings and the examples in ``bin``.
  49
  50 Testing
  51 =======
  52
  53 Run the internal unit tests using nose_::
  54
  55   $ nosetests --with-doctest --doctest-tests pyassuan
  56
  57 If a Python-3-version of ``nosetests`` is not the default on your
  58 system, you may need to try something like::
  59
  60   $ nosetests-3.3 --with-doctest --doctest-tests pyassuan
  61
  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::
  64
  65   $ gpg-connect-agent --raw-socket name
  66
  67 Licence
  68 =======
  69
  70 This project is distributed under the `GNU General Public License
  71 Version 3`_ or greater.
  72
  73 Author
  74 ======
  75
  76 W. Trevor King
  77 wking@tremily.us
  78
  79
  80 .. _Assuan: http://www.gnupg.org/documentation/manuals/assuan/
  81 .. _GnuPG: http://www.gnupg.org/
  82 .. _wrappers: http://wiki.python.org/moin/GnuPrivacyGuard
  83 .. _gpgme-tool:
  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