Subsectioned history
[gpgme.git] / lang / python / docs / Short_History.org
1 #+TITLE: A Short History of the GPGME bindings for Python
2
3 * Overview
4   :PROPERTIES:
5   :CUSTOM_ID: overview
6   :END:
7
8 The GPGME Python bindings passed through many hands and numerous
9 phases before, after a fifteen year journey, coming full circle to
10 return to the source.  This is a short explanation of that journey.
11
12 ** In the beginning
13    :PROPERTIES:
14    :CUSTOM_ID: in-the-begining
15    :END:
16
17    In 2002 John Goerzen released PyME; Python bindings for the GPGME
18    module which utilised the current release of Python of the time
19    (Python 2.2 or 2.3) and SWIG.  Shortly after creating it and
20    ensuring it worked he stopped supporting it, though he left his
21    work available on his Gopher site.
22
23 ** Keeping the flame alive
24    :PROPERTIES:
25    :CUSTOM_ID: keeping-the-flame-alive
26    :END:
27
28    A couple of years later the project was picked up by Igor Belyi and
29    actively developed and maintained by him from 2004 to 2008.  Igor's
30    whereabouts at the time of this document's creation are unknown,
31    but the current authors do hope he is well.  We're assuming (or
32    hoping) that life did what life does and made continuing untenable.
33
34 ** Passing the torch
35    :PROPERTIES:
36    :CUSTOM_ID: passing-the-torch
37    :END:
38
39    In 2014 Martin Albrecht wanted to patch a bug in the PyME code and
40    discovered the absence of Igor.  Following a discussion on the PyME
41    mailing list he became the new maintainer for PyME, releasing
42    version 0.9.0 in May of that year.  He remains the maintainer of
43    the original PyME release in Python 2.6 and 2.7 (available via
44    PyPI).
45
46 ** Coming full circle
47    :PROPERTIES:
48    :CUSTOM_ID: ouroboros 
49    :END:
50
51    In 2015 Ben McGinnes approached Martin about a Python 3 version,
52    while investigating how complex a task this would be the task ended
53    up being completed.  A subsequent discussion with Werner Koch led to
54    the decision to fold the Python 3 port back into the original GPGME
55    release in the languages subdirectory for non-C bindings.  Ben is
56    the maintainer of the Python 3 port within GPGME.
57
58    In 2016 PyME was renamed to "gpg" and adopted by the upstream GnuPG
59    team.
60
61 ** The Annoyances of Git
62    :PROPERTIES:
63    :CUSTOM_ID: the-annoyances-of-git
64    :END:
65
66    As anyone who has ever worked with git knows, submodules are
67    horrible way to deal with pretty much anything.  In the interests
68    of avoiding migraines, that is being skipped with addition of PyME
69    to GPGME.  Instead the files will be added to the subdirectory,
70    along with a copy of the entire git log up to that point as a
71    separate file within the docs directory (old-commits.log).  As the
72    log for PyME is nearly 100KB and the log for GPGME is approximately
73    1MB, this would cause considerable bloat, as well as some
74    confusion, should the two be merged.  Hence the unfortunate, but
75    necessary, step to simply move the files.  A regular repository
76    version will be maintained should it be possible to implement this
77    better in the future.
78
79 ** The Perils of PyPI
80    :PROPERTIES:
81    :CUSTOM_ID: the-perils-of-pypi
82    :END:
83
84    At the current time the Python 3 fork is not available via PyPI and
85    the pip installer.  The recommended installation method is to follow
86    the instructions in lang/py3-pyme/INSTALL.  This will build the
87    necessary SWIG portions against the installed version of GPGME.