While being too specific, you can still version that file (meaning: not include it in the default .gitignore), as :
- it will be used only by
pyenv - it is a good addition to the
README, in order to illustrate what version of python is recommended for the specific project, - it can be overridden easily (if you are using
pyenv), or simply ignored (if you don’t havepyenv).
As the article “How to manage multiple Python versions and virtual environments ” states:
When setting up a new project that is to use Python 3.6.4 then
pyenv local 3.6.4would be ran in its root directory.
This would both set the version, and create a.python-versionfile, so that other contributors’ machines would pick it up.
But:
pyenvlooks in four places to decide which version of Python to use, in priority order:
- The
PYENV_VERSIONenvironment variable (if specified).
You can use thepyenv shellcommand to set this environment variable in your current shell session.- The application-specific
.python-versionfile in the current directory (if present).
You can modify the current directory’s.python-versionfile with thepyenv localcommand.- The first
.python-versionfile found (if any) by searching each parent directory, until reaching the root of your filesystem.- The global version file. You can modify this file using the
pyenv globalcommand.
If the global version file is not present,pyenvassumes you want to use the “system” Python. (In other words, whatever version would run ifpyenvweren’t in yourPATH.)