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