Metadata-Version: 1.0
Name: gpgkeys
Version: 1.15
Summary: Command line shell for GnuPG
Home-page: http://pypi.python.org/pypi/gpgkeys
Author: Stefan H. Holek
Author-email: stefan@epy.co.at
License: GPL
Description: =======
        gpgkeys
        =======
        ----------------------------
        Command line shell for GnuPG
        ----------------------------
        
        Introduction
        ============
        
        **gpgkeys** is a Python program that allows to conveniently
        manage GnuPG keys and keyrings.
        
        It serves as example application and testbed for the development of the
        rl_ library. In particular, gpgkeys contains a sophisticated implementation of
        `filename completion`_ which may one day find its way into a standalone
        package or rl_ add-on.
        
        .. _rl: http://pypi.python.org/pypi/rl
        .. _`filename completion`: http://github.com/stefanholek/gpgkeys/tree/master/gpgkeys/completions
        
        Repository Access
        -----------------
        
        gpgkeys development is hosted on github_.
        
        .. _github: http://github.com/stefanholek/gpgkeys
        
        Installation
        ============
        
        gpgkeys uses the rl_ library. Since rl_ contains a C extension, it is
        a good idea to review its `installation instructions`_ and make sure
        all dependencies are in place.
        
        To install the ``gpgkeys`` script, type::
        
            easy_install gpgkeys
        
        Then put it on your system PATH by e.g.  symlinking it to ``/usr/local/bin``.
        
        .. _`installation instructions`: http://pypi.python.org/pypi/rl#installation
        
        Example Session
        ===============
        
        Everything in gpgkeys can be tab-completed: commands, help
        topics, userids, option flags, keyids, filenames, shell
        commands, and keyserver URLs.
        ::
        
            $ gpgkeys
            gpgkeys 1.14 (type help for help)
        
            gpgkeys> help
        
            Available commands (type help <topic>):
            =======================================
            EOF       del   export  genkey     import   lsign  refresh  shell
            checksig  dump  fdump   genrevoke  list     quit   search   sign
            clear     edit  fetch   help       listsig  recv   send     version
        
            Shortcut commands (type help <topic>):
            ======================================
            !  .  e  ll  ls
        
            gpgkeys> help export
            Usage: export <keyspec>
            Options: --armor --clean --minimal --output --secret
        
            Export keys to stdout or to a file
        
            gpgkeys> ls Stefan
            pub   1024R/E1F438AD 1995-10-03
            uid                  Stefan H. Holek (RSA) <stefan@epy.co.at>
        
            pub   1024D/355A2D28 2001-11-04
            uid                  Stefan H. Holek <stefan@epy.co.at>
            sub   2048g/A27E0DBC 2004-10-27
        
            gpgkeys> export --armor E1F438AD > stefan.asc
            gpgkeys> .ls
            alice.asc             stefan.asc
        
        gpgkeys understands shell pipes and input/output redirects. This
        allows command lines like::
        
            gpgkeys> export E1F438AD | pgpdump | less
        
        
        Changelog
        =========
        
        1.15 - 2011-05-05
        -----------------
        
        - Require rl >= 1.14.
          [stefan]
        
        
        1.14 - 2011-03-24
        -----------------
        
        - Add '!' and '.' to shortcut commands so they show up in help.
          [stefan]
        
        - Drop Python 2.5 support in favor of faster byte string operations
          in later Python versions.
          [stefan]
        
        
        1.13 - 2011-03-11
        -----------------
        
        - Require rl >= 1.13.
          [stefan]
        
        
        1.12 - 2010-05-21
        -----------------
        
        - Print help when required command arguments are missing.
          [stefan]
        
        - Require rl >= 1.11.
          [stefan]
        
        
        1.11 - 2010-05-07
        -----------------
        
        - Change an import statement so 2to3 is able to resolve it.
          [stefan]
        
        
        1.10 - 2010-05-05
        -----------------
        
        - Refactor completions: Extract generic parts into base class.
          [stefan]
        
        - Require rl >= 1.10.
          [stefan]
        
        
        1.9 - 2010-03-07
        ----------------
        
        - Rename the del command's --all option to --secret-and-public.
          [stefan]
        
        - Require rl >= 1.6.
          [stefan]
        
        
        1.8.2 - 2010-03-01
        ------------------
        
        - Fix failing tests under Python 3 on Linux.
          [stefan]
        
        
        1.8.1 - 2010-02-25
        ------------------
        
        - Restore Python 2.5 compatibility. D'oh.
          [stefan]
        
        
        1.8 - 2010-02-25
        ----------------
        
        - Support Python 3 via distribute.
          [stefan]
        
        - The --fingerprint option may be given more than once.
          [stefan]
        
        
        1.7.1 - 2010-02-13
        ------------------
        
        - Depend on rl >= 1.4.1 explicitly so setuptools does not forget to upgrade
          it as well.
          [stefan]
        
        
        1.7 - 2010-02-13
        ----------------
        
        - Change license to GPL.
          [stefan]
        
        
        1.6 - 2010-01-31
        ----------------
        
        - Add --clean and --minimal import/export options to respective commands.
          [stefan]
        
        - Fix --merge-only import option of keyserver commands.
          [stefan]
        
        - Remove the --yes option again since it has no apparent effect.
          [stefan]
        
        
        1.5 - 2010-01-26
        ----------------
        
        - Remove obsolete --secret option from the import command.
          [stefan]
        
        - Userid completion is now triggered by any kind of quoting.
          [stefan]
        
        - Allow to specifiy command line options after the argument.
          [stefan]
        
        
        1.4 - 2010-01-20
        ----------------
        
        - Extend the quoting and dequoting API to make it more (re)usable.
          [stefan]
        
        - Dequoting didn't work right when the default quoting character
          was single quote.
          [stefan]
        
        - Tildes in quoted filenames could cause quotes to be closed even
          if the tilde-expanded name matched a directory.
          [stefan]
        
        
        1.3 - 2010-01-03
        ----------------
        
        - Cut down on infrastructure slack in filename completion. The
          individual strategies are very small.
          [stefan]
        
        - Remove logging as it clutters up the code.
          [stefan]
        
        - Add an example session to the README.
          [stefan]
        
        
        1.2 - 2009-11-24
        ----------------
        
        - Extend keyid completion to also complete userids and names.
          [stefan]
        
        - Extract filename completion functionality into functions,
          as it is useful in other places as well.
          [stefan]
        
        
        1.1 - 2009-11-16
        ----------------
        
        - Allow to specify the filename quoting style on the command line
          to ease experimentation.
          [stefan]
        
        - Filename completion: By dequoting early on we can skip a problematic
          hook and regain control over tilde expansion. Also see rl `issue/3`_.
          [stefan]
        
        .. _`issue/3`: http://github.com/stefanholek/rl/issues#issue/3
        
        
        1.0 - 2009-11-08
        ----------------
        
        - Initial release.
        
Keywords: gnupg shell
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
