doc/todo/consider_using_python3_for_rst_plugin.mdwn

   1 Python 2 is officially unsupported after 2020, which is before the expected end-of-life
   2 date of the next round of long-term-stable distributions like Debian 10 and Ubuntu 18.04,
   3 so those distributions are encouraging all software that can migrate to Python 3 to do so.
   4
   5 The down side of this is that it would make it harder to use the `rst` plugin on
   6 very old OS releases, or on OSs where Python 3 is available but doesn't have a `python3`
   7 symbolic link (if such OSs exist - [PEP 394](https://www.python.org/dev/peps/pep-0394/)
   8 says they shouldn't), or in shared hosting environments where Python 2 is installed but
   9 Python 3 isn't. (Mitigation: switching it to `python` or `python2` is a 1-line change.)
  10
  11 For today's upload to Debian, I switched the `#!` line in the [[plugins/rst]] plugin
  12 to `#!/usr/bin/python3`. In upstream ikiwiki it would probably be more appropriate
  13 to use `#!/usr/bin/env python3`, and it would certainly be more appropriate to do it
  14 by changing the source rather than by using `sed` after installation. I didn't apply that
  15 change upstream immediately to give other maintainers a chance to comment. Thoughts?
  16
  17 --[[smcv]]
  18
  19 > I can attest as a pkgsrc developer, where we try to build and package
  20 > software on all sorts of platforms (some old and wacky), that as long
  21 > as the relevant Pythons build on those platforms (and we tend to make
  22 > sure they do), I don't foresee any negative impact of your suggested
  23 > change to ikiwiki. Can't attest for other situations, but am generally
  24 > biased toward biting future bullets as early as possible.
  25 > --[[schmonz]]