docs: python bindings howto
* Added a section on checking the version details of GPGME and the underlying engines. * This is a component of the updated workaround in the previous commit(s).
This commit is contained in:
parent
6a527a6407
commit
b97ee3e0aa
@ -316,6 +316,46 @@
|
|||||||
operation type has one.
|
operation type has one.
|
||||||
|
|
||||||
|
|
||||||
|
** GPGME and Python Bindings Versions
|
||||||
|
:PROPERTIES:
|
||||||
|
:CUSTOM_ID: howto-get-version-info
|
||||||
|
:END:
|
||||||
|
|
||||||
|
Essentially there are two methods for checking useful version
|
||||||
|
information.
|
||||||
|
|
||||||
|
The first, =gpg.core.check_version=, returns the version of GPGME
|
||||||
|
installed. This should match the version of the Python bindings
|
||||||
|
themselves, but if the bindings have been installed separately from
|
||||||
|
GPGME (e.g. via PyPI, in spite of the current recommendations) then
|
||||||
|
a mismatch is possible and the effects may be unpredictable.
|
||||||
|
|
||||||
|
#+begin_src python
|
||||||
|
import gpg
|
||||||
|
|
||||||
|
print(gpg.core.check_version(version=None))
|
||||||
|
#+end_src
|
||||||
|
|
||||||
|
The quick way to see whether the output of =gpg.core.check_version()=
|
||||||
|
matches the GPGME library installed is to see if the version number
|
||||||
|
reported matches the first header produced by the =gpgme-tool=
|
||||||
|
installed with the library.
|
||||||
|
|
||||||
|
The second method, =gpg.core.get_engine_info=, returns version
|
||||||
|
information for the underlying engines, libraries and relevant
|
||||||
|
components. It also returns the full paths of certain important
|
||||||
|
executables, particularly =gpg= or =gpg.exe= for the OpenPGP engine
|
||||||
|
and =gpgsm= or =gpgsm.exe= for the S/MIME engine.
|
||||||
|
|
||||||
|
#+begin_src python
|
||||||
|
import gpg
|
||||||
|
|
||||||
|
for i in range(len(gpg.core.get_engine_info())):
|
||||||
|
print("{0}: version {1}".format(gpg.core.get_engine_info()[i].file_name,
|
||||||
|
gpg.core.get_engine_info()[i].version))
|
||||||
|
#+end_src
|
||||||
|
|
||||||
|
|
||||||
* Working with keys
|
* Working with keys
|
||||||
:PROPERTIES:
|
:PROPERTIES:
|
||||||
:CUSTOM_ID: howto-keys
|
:CUSTOM_ID: howto-keys
|
||||||
|
Loading…
Reference in New Issue
Block a user