doc: python bindings howto
authorBen McGinnes <ben@adversary.org>
Tue, 13 Mar 2018 08:20:44 +0000 (19:20 +1100)
committerBen McGinnes <ben@adversary.org>
Tue, 13 Mar 2018 08:20:44 +0000 (19:20 +1100)
* Added key selection for specifying signing key or keys.

lang/python/docs/GPGMEpythonHOWTOen.org

index 5ee3a82..ea1b765 100644 (file)
    :CUSTOM_ID: howto-basic-signing
    :END:
 
-   Need to determine whether or not to include clearsigning and
-   detached signing here or give them separate sections.  Yes, section
-   them.
+   X
 
 *** Signing key selection
     :PROPERTIES:
     available it may be necessary to specify the key or keys with
     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
     :PROPERTIES:
     :CUSTOM_ID: howto-basic-signing-normal
 
      """
 
-     c = gpg.Context()
-     c.armor = True
+     c = gpg.Context(armor=True, signers=sig_src)
      signed = c.sign(text, mode=0)
 
      afile = open("/path/to/statement.txt.asc", "wb")
 
      """
 
-     c = gpg.Context()
-     c.armor = True
+     c = gpg.Context(armor=True)
      signed = c.sign(text, mode=1)
 
      afile = open("/path/to/statement.txt.asc", "wb")
      text = tfile.read()
      tfile.close()
 
-     c = gpg.Context()
+     c = gpg.Context(signers=sig_src)
      signed = c.sign(text, mode=1)
 
      afile = open("/path/to/statement.txt.sig", "wb")