PYME installation instructions

Hi all developers,

I was going to briefly bring up a few questions re PYME installation, mostly for those who are trying to follow latest PYME updates fairly swiftly (i.e. use github with install develop option).

Disclaimer: I appreciate this is a moving target which is the cause of most difficulties.

  1. What is the authorative source of install instructions and how can we see what version/date these instructions refer to? For example, while the PYME installation docs are a nice source I wasn’t sure when they were last updated and if they get rebuilt with each release automatically etc. They seem to lack at date/version stamp or similar which I would appreciate to have.

  2. As we are in a transition phase with 2.7 -> 3.X happening fairly swiftly, installation instructions seem to rapidly go out of date, particularly with regard to conda etc and py27 related things start breaking at various levels. The py3 vs py27 distinction also refers to choice of compilers on windows platforms etc. Maybe this should be prominently added to the docs as a caveat?

  3. I will aim to keep our local install docs for win10 current with developments if I can figure out what the latest state is. Looks like py27 installs will increasingly break, so may try to focus on py3 more. These docs are aimed at non-specialists and adopt gitkraken as git GUI front end (which I happen to like).

Thanks,
Christian

Hi Christian,

Thanks for your message! I’ll try to reply point-by-point.

  1. The PYME installation instructions are up-to-date. Our docs re-build every time we merge a PR modifying the docs. We recently pared down the installation documentation to make it easier to follow, but we may have removed too much. We should certainly add a “last modified” date stamp to our docs.
  2. Since Python 2 was sunsetted on January 1, 2020, conda’s py2 solver has become less stable. We are actively trying to stay on top of this by pinning requirements in pyme-depends. In general, the same installation instructions and compilers should work regardless of the choice of py2/py3. Specific examples of discrepancies (e.g. your Issue) will help us nail down if and why this isn’t the case. For now, I recommend installing a non-Python-version-specific compiler such as Build Tools for Visual Studio 2019 on Windows 10. I believe this (or perhaps a slightly newer version) is installed by default on fresh anaconda installs.
  3. Thanks for maintaining these detailed install docs!

Best,
Zach

1 Like