Update the README.
parent
f01668fe48
commit
f68d01b9f2
46
README.md
46
README.md
|
@ -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.
|
||||||
|
|
Loading…
Reference in New Issue