Update the README.

feature/documentation-builds-html
Isis Lovecruft 2013-04-11 18:21:32 +00:00
parent f01668fe48
commit f68d01b9f2
No known key found for this signature in database
GPG Key ID: A3ADB67A2CDB8B35
1 changed files with 38 additions and 8 deletions

View File

@ -1,10 +1,11 @@
# python-gnupg # # python-gnupg #
================ ================
Fork of python-gnupg-0.3.2, patched to remove Popen([...], shell=True). Fork of python-gnupg-0.3.2, patched to remove ```Popen([...], shell=True)```.
### Installation ### ### Installation ###
--------------------
#### From this git repository ####
To install this package from this git repository, do: To install this package from this git repository, do:
``` ```
@ -19,15 +20,44 @@ Optionally to build the documentation after installation, do:
make docs make docs
``` ```
To get started using python-gnupg's API, see the documentation online at [XXX To get started using python-gnupg's API, see the [online documentation](https://python-gnupg.readthedocs.org/en/latest/),
FIXME add readthedocs link](), and import the module like so: and import the module like so:
``` ```
>>> import gnupg >>> import gnupg
``` ```
The primary interface class you'll likely want to interact with is
[```gnupg.GPG```](https://python-gnupg.readthedocs.org/en/latest/gnupg.html#gpg):
```
>>> gpg = gnupg.GPG(gpgbinary='/usr/bin/gpg',
... gpghome='./keys',
... pubring='pubring.gpg',
... secring='secring.gpg')
>>> batch_key_input = gpg.gen_key_input()
>>> print batch_key_input
Key-Type: RSA
Name-Email: isis@wintermute
Name-Comment: Generated by gnupg.py
Key-Length: 4096
Name-Real: Autogenerated Key
%pubring /home/isis/code/python-gnupg/keys/pubring.gpg
%secring /home/isis/code/python-gnupg/keys/secring.gpg
%commit
To install this package from a tarballed source distribution, do the following: >>> key = gpg.gen_key(batch_key_input)
>>> print key.fingerprint
245D8FA30F543B742053949F553C0E154F2E7A98
1. Extract all the files in the distribution archive to some directory on your system. ```
2. In that directory, run "python setup.py install".
3. Optionally, run "python test_gnupg.py" to ensure that the package is working as expected. #### From PyPI ####
Hold your horses, boy. I haven't finished development, so the packages on
[PyPI](https://pypi.python.org) are still the old versions belonging to the
other authors.
### Bug Reports & Feature Requests ###
Our bugtracker is [here](https://leap.se/code/projects/eip_server/issue/new).
Please use that for bug reports and feature requests instead of github's
tracker. We're using github for code commenting and review between
collaborators.