: Follow the installation guide on the pyenv GitHub repository.
: Defines the required Python version range in the pyproject.toml file under the [tool.poetry.dependencies] section.
: Match the version in this file to the version used in your production environment (e.g., your Dockerfile or AWS Lambda runtime) to ensure consistent behavior across all stages of development. Common Alternatives .python version
: Use a command like pyenv install 3.12.0 .
: You should typically commit the .python-version file to your Git repository. This ensures that every developer on the team is using the exact same version of Python, reducing "it works on my machine" bugs. : Follow the installation guide on the pyenv
While .python-version is the standard for pyenv , other tools have different methods:
To use this file effectively, you should first install a version manager. Common Alternatives : Use a command like pyenv install 3
In modern development, different projects often require different Python versions. For example, an older legacy app might need , while a new data science project requires Python 3.12 . Managing these manually by changing global paths is error-prone. Tools like pyenv solve this by looking for a .python-version file. How the .python-version File Works
: Navigate to your project folder and run pyenv local 3.12.0 . This automatically generates the .python-version file for you. Best Practices for Teams