GpgFrontend/gpgme
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Python bindings: docs

Browse Source 
* lang/python/docs/GPGMEpythonHOWTOen.org: Fixed a few errors in the
  newer sections.
* Updated code in the examples using secret key exporting and group
  lines to reflect the Python 2.7 compatibility fixes added.
This commit is contained in:
Ben McGinnes 2018-09-16 03:36:14 +10:00
parent 4e8a92ed14
commit d04fb0bf12
1 changed files with 38 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

48
lang/python/docs/GPGMEpythonHOWTOen.org
View File

@ -316,12 +316,16 @@ both by and in order to create, the bindings (including both the
:END: :END:
If specifying a selected number of languages to create bindings for, If specifying a selected number of languages to create bindings for,
always leave Python last. Currently the other languages are also try to leave Python last. Currently the majority of the other
preceding Python of either version when listed alphabetically and so language bindings are also preceding Python of either version when
that just happens by default currently. If Python is set to precede listed alphabetically and so that just happens by default currently.
one of the other languages then it is possible that the errors
described here may interrupt the build process before generating If Python is set to precede one of the other languages then it is
bindings for those other languages. possible that the errors described here may interrupt the build
process before generating bindings for those other languages. In
these cases it may be preferable to configure all preferred language
bindings separately with alternative =configure= steps for GPGME using
the =--enable-languages=$LANGUAGE= option.
*** Multiple installations *** Multiple installations
@ -333,7 +337,7 @@ For a veriety of reasons it may be either necessary or just preferable
to install the bindings to alternative installed Python versions which to install the bindings to alternative installed Python versions which
meet the requirements of these bindings. meet the requirements of these bindings.
On POSIX systens this will generally be most simply achieved by On POSIX systems this will generally be most simply achieved by
running the manual installation commands (build, build, install) as running the manual installation commands (build, build, install) as
described in the previous section for each Python installation the described in the previous section for each Python installation the
bindings need to be installed to. bindings need to be installed to.
@ -414,10 +418,11 @@ GPGME is compiled.
CFFI is currently unable to adapt to such a potentially mutable CFFI is currently unable to adapt to such a potentially mutable
codebase. If there were some means of applying SWIG's dynamic code codebase. If there were some means of applying SWIG's dynamic code
generation to produce CFFI API modes of accessing the GPGME libraries generation to produce the Python/CFFI API modes of accessing the GPGME
(or the source source code directly), but such a thing does not exist libraries (or the source source code directly), but such a thing does
yet either and it currently appears that work is needed in at least not exist yet either and it currently appears that work is needed in
one of CFFI's dependencies before any of this can be addressed. at least one of CFFI's dependencies before any of this can be
addressed.
So if you're a massive fan of CFFI; that's great, but if you want this So if you're a massive fan of CFFI; that's great, but if you want this
project to switch to CFFI then rather than just insisting that it project to switch to CFFI then rather than just insisting that it
@ -463,8 +468,7 @@ retrain developers.
This API does not do that. It would not be able to do that and also This API does not do that. It would not be able to do that and also
provide access to the entire C API on which it's built. It does, provide access to the entire C API on which it's built. It does,
however, provide a very pythonic interface on top of the direct however, provide a very pythonic interface on top of the direct
bindings and it's this pythonic layer with which this HOWTO deals bindings and it's this pythonic layer that this HOWTO deals with.
with.
** Context ** Context
@ -1062,7 +1066,16 @@ else:
if os.path.exists(os.environ["GNUPGHOME"]) is True: if os.path.exists(os.environ["GNUPGHOME"]) is True:
hd = os.environ["GNUPGHOME"] hd = os.environ["GNUPGHOME"]
else: else:
try:
hd = subprocess.getoutput(gpgconfcmd) hd = subprocess.getoutput(gpgconfcmd)
except:
process = subprocess.Popen(gpgconfcmd.split(),
stdout=subprocess.PIPE)
procom = process.communicate()
if sys.version_info[0] == 2:
hd = procom[0].strip()
else:
hd = procom[0].decode().strip()
gpgfile = "{0}/{1}.gpg".format(hd, keyfile) gpgfile = "{0}/{1}.gpg".format(hd, keyfile)
ascfile = "{0}/{1}.asc".format(hd, keyfile) ascfile = "{0}/{1}.asc".format(hd, keyfile)
@ -1967,8 +1980,17 @@ information in Python.
#+BEGIN_SRC python -i #+BEGIN_SRC python -i
import subprocess import subprocess
import sys
try:
lines = subprocess.getoutput("gpgconf --list-options gpg").splitlines() lines = subprocess.getoutput("gpgconf --list-options gpg").splitlines()
except:
process = subprocess.Popen(gpgconfcmd.split(), stdout=subprocess.PIPE)
procom = process.communicate()
if sys.version_info[0] == 2:
lines = procom[0].splitlines()
else:
lines = procom[0].decode().splitlines()
for i in range(len(lines)): for i in range(len(lines)):
if lines[i].startswith("group") is True: if lines[i].startswith("group") is True: