TODO: Build badges and such
The pyenv rules integrate pyenv with Bazel.
These rules can be used to hermetically download and compile versions of CPython supported by pyenv and pyenv-win for the supporting platform.
Add the following to your WORKSPACE file:
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
http_archive(
name = "dpu_rules_pyenv",
urls = ["https://github.com/digital-plumbers-union/rules_pyenv/archive/v0.1.0.tar.gz"],
sha256 = "6dc7aaaa6e9a2b0f68e219afacebc2374313f4ff26c9c197d22e018b2160e39a",
)
load("@dpu_rules_pyenv//pyenv:defs.bzl", "pyenv_install")
pyenv_install(
py2 = "<The version of python2 you want to use for your project>",
py3 = "<The version of python3 you want to use for your project>",
)rules_pyenv allows projects to select between hermetic versions of Python controlled by Bazel or non-hermetic versions
of Python managed by a pre-existing installation of pyenv or pyenv-win on the host machine.
Hermetic use of pyenv is the default, simply declare your project's py_runtime_pair in your WORKSPACE file.
pyenv_install(
py2 = "2.7.17",
py3 = "3.8.2",
)Alternatively, your project can have rules_pyenv use the host installed version of pyenv or pyenv-win and the
versions of Python it already manages. This can be useful if you find yourself needing to clean your workspace often
and are spending a lot of time waiting for pyenv to compile the declared Python versions.
pyenv_install(
hermetic = False,
py2 = "2.7.17",
py3 = "3.8.2",
)- This thing needs tests
- This thing needs build automation
- This thing hasn't been tried on Windows (yet); hence tests and build automation
- You will probably find bugs. No, you're not crazy, it's just not working right; open an issue (PRs are welcome too)
- Since the native Bazel rules only support CPython your use of
pyenvis restricted to CPython versions 2 and 3. If you want additional support for other Python impl
This work is dual-licensed as Apache-2.0 OR MIT to achieve compatibility with GPLv2 and to be friendly for
both individuals and enterprise.
SPDX-License-Identifier: Apache-2.0 OR MIT