[git] GPGME - branch, ben/docs/2018-03, updated. gpgme-1.10.0-86-gef27f37

[by Ben McGinnes]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GnuPG Made Easy".

The branch, ben/docs/2018-03 has been updated
       via  ef27f3781a37e264d0eb7d1745eb2c804ec062c4 (commit)
       via  423fdcd4653cb01f07f2b0e72cfcf49554930f70 (commit)
      from  a71205dc3b58970adf591b4e4553824a33f353db (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit ef27f3781a37e264d0eb7d1745eb2c804ec062c4
Author: Ben McGinnes <ben at adversary.org>
Date:   Wed Mar 14 20:40:50 2018 +1100

    doc: python bindings todo
    
    * minor phrasing fix.

diff --git a/lang/python/docs/TODO.org b/lang/python/docs/TODO.org
index 21d2216..e85315a 100644
--- a/lang/python/docs/TODO.org
+++ b/lang/python/docs/TODO.org
@@ -83,8 +83,8 @@
      :CUSTOM_ID: howto-s-mime
      :END:
 
-     Eventually add some of this, but it the OpenPGP details are far
-     more important at the moment.
+     Eventually add some of this, but the OpenPGP details are far more
+     important at the moment.
 
 ** TODO Documentation SWIG
    :PROPERTIES:

commit 423fdcd4653cb01f07f2b0e72cfcf49554930f70
Author: Ben McGinnes <ben at adversary.org>
Date:   Wed Mar 14 20:36:30 2018 +1100

    doc: python bindings howto
    
    * Added recommended method of single encryption with description.

diff --git a/lang/python/docs/GPGMEpythonHOWTOen.org b/lang/python/docs/GPGMEpythonHOWTOen.org
index e4e2a74..360bce9 100644
--- a/lang/python/docs/GPGMEpythonHOWTOen.org
+++ b/lang/python/docs/GPGMEpythonHOWTOen.org
@@ -565,6 +565,72 @@
     This will attempt to encrypt to all the keys searched for, then
     remove invalid recipients if it fails and try again.
 
+**** Encrypting to one key using the second method
+     :PROPERTIES:
+     :CUSTOM_ID: howto-basic-encryption-monogamous
+     :END:
+
+     This example re-creates the first encryption example except it
+     uses the same =encrypt= method used in the subsequent examples
+     instead of the =op_encrypt= method.  This means that, unlike the
+     =op_encrypt= method, it /must/ use byte literal input data.
+
+     #+begin_src python
+       import gpg
+
+       rkey = "0x12345678DEADBEEF"
+       text = b"""Some text to test with.
+
+       Since the text in this case must be bytes, it is most likely that
+       the input form will be a separate file which is opened with "rb"
+       as this is the simplest method of obtaining the correct data
+       format.
+       """
+
+       c = gpg.Context(armor=True)
+       rpattern = list(c.keylist(pattern=rkey, secret=False))
+       logrus = []
+
+       for i in range(len(rpattern)):
+	   if rpattern[i].can_encrypt == 1:
+	       logrus.append(rpattern[i])
+
+       cipher = c.encrypt(text, recipients=logrus, sign=False, always_trust=True)
+
+       afile = open("secret_plans.txt.asc", "wb")
+       afile.write(cipher[0])
+       afile.close()
+     #+end_src
+
+     With one or two exceptions, this method will probably prove to be
+     easier to implement than the first method and thus it is the
+     recommended encryption method.  Though it is even more likely to
+     be used like this:
+
+     #+begin_src python
+       import gpg
+
+       rkey = "0x12345678DEADBEEF"
+
+       afile = open("secret_plans.txt", "rb")
+       text = afile.read()
+       afile.close()
+
+       c = gpg.Context(armor=True)
+       rpattern = list(c.keylist(pattern=rkey, secret=False))
+       logrus = []
+
+       for i in range(len(rpattern)):
+	   if rpattern[i].can_encrypt == 1:
+	       logrus.append(rpattern[i])
+
+       cipher = c.encrypt(text, recipients=logrus, sign=False, always_trust=True)
+
+       afile = open("secret_plans.txt.asc", "wb")
+       afile.write(cipher[0])
+       afile.close()
+     #+end_src
+
 
 ** Decryption
    :PROPERTIES:

-----------------------------------------------------------------------

Summary of changes:
 lang/python/docs/GPGMEpythonHOWTOen.org | 66 +++++++++++++++++++++++++++++++++
 lang/python/docs/TODO.org               |  4 +-
 2 files changed, 68 insertions(+), 2 deletions(-)


hooks/post-receive
-- 
GnuPG Made Easy
http://git.gnupg.org