doc: python bindings howto

* Added key selection for specifying signing key or keys.
This commit is contained in:
Ben McGinnes 2018-03-13 19:20:44 +11:00
parent e489ddd08a
commit c92da2c7eb

View File

@ -532,9 +532,7 @@
:CUSTOM_ID: howto-basic-signing :CUSTOM_ID: howto-basic-signing
:END: :END:
Need to determine whether or not to include clearsigning and X
detached signing here or give them separate sections. Yes, section
them.
*** Signing key selection *** Signing key selection
:PROPERTIES: :PROPERTIES:
@ -547,6 +545,19 @@
available it may be necessary to specify the key or keys with available it may be necessary to specify the key or keys with
which to sign messages and files. which to sign messages and files.
#+begin_src python
import gpg
logrus = input("Enter the email address or string to match signing keys to: ")
hancock = gpg.Context().keylist(pattern=logrus, secret=True)
sig_src = list(hancock)
#+end_src
The signing examples in the following sections include the
explicitly designated =signers= parameter in two of the five
examples; once where the resulting signature would be ASCII
armoured and once where it would not be armoured.
*** Normal or default signing messages or files *** Normal or default signing messages or files
:PROPERTIES: :PROPERTIES:
:CUSTOM_ID: howto-basic-signing-normal :CUSTOM_ID: howto-basic-signing-normal
@ -559,8 +570,7 @@
""" """
c = gpg.Context() c = gpg.Context(armor=True, signers=sig_src)
c.armor = True
signed = c.sign(text, mode=0) signed = c.sign(text, mode=0)
afile = open("/path/to/statement.txt.asc", "wb") afile = open("/path/to/statement.txt.asc", "wb")
@ -598,8 +608,7 @@
""" """
c = gpg.Context() c = gpg.Context(armor=True)
c.armor = True
signed = c.sign(text, mode=1) signed = c.sign(text, mode=1)
afile = open("/path/to/statement.txt.asc", "wb") afile = open("/path/to/statement.txt.asc", "wb")
@ -617,7 +626,7 @@
text = tfile.read() text = tfile.read()
tfile.close() tfile.close()
c = gpg.Context() c = gpg.Context(signers=sig_src)
signed = c.sign(text, mode=1) signed = c.sign(text, mode=1)
afile = open("/path/to/statement.txt.sig", "wb") afile = open("/path/to/statement.txt.sig", "wb")