rules_python/python/private/py_executable_info.bzl at fc5aaec347bbfc3ba32b09ca71ee724164b6868d · rickeylev/rules_python · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
"""Implementation of PyExecutableInfo provider."""

PyExecutableInfo = provider(
    doc = """
Information about an executable.

This provider is for executable-specific information (e.g. tests and binaries).

:::{versionadded} 0.36.0
:::
""",
    fields = {
        "app_runfiles": """
:type: runfiles

The runfiles for the executable's "user" dependencies. These are things in e.g.
`deps` (or similar), but doesn't include "external" or "implicit" pieces,
e.g. the Python runtime itself. It's roughly akin to the files a traditional
venv would have installed into it.

:::{seealso}
{obj}`PyRuntimeInfo` for the Python runtime files. The {obj}`py_binary` et al
rules provide it directly so that the runtime the binary original chose
can be accessed.
:::

:::{versionadded} 1.9.0
:::
""",
        "build_data_file": """
:type: None | File

A symlink to build_data.txt if stamping is enabled, otherwise None.
""",
        "interpreter_args": """
:type: list[str]

Args that should be passed to the interpreter before regular args
(e.g. `-X whatever`).

:::{versionadded} 1.9.0
:::
""",
        "interpreter_path": """
:type: None | str

Path to the Python interpreter to use for running the executable itself (not the
bootstrap script). Either an absolute path (which means it is
platform-specific), or a runfiles-relative path (which means the interpreter
should be within `runtime_files`)
""",
        "main": """
:type: File

The user-level entry point file. Usually a `.py` file, but may also be `.pyc`
file if precompiling is enabled.

:::{seealso}

The {obj}`stage2_bootstrap` attribute, which bootstraps an executable to run
the user main file.
:::
""",
        "runfiles_without_exe": """
:type: runfiles

The runfiles the program needs, but without the original executable,
files only added to support the original executable, or files specific to the
original program.
""",
        "stage2_bootstrap": """
:type: File | None

The Bazel-executable-level entry point to the program, which handles Bazel-specific
setup before running the file in {obj}`main`. May be None if a two-stage bootstrap
implementation isn't being used.

:::{versionadded} 1.9.0
:::
""",
        "venv_interpreter_runfiles": """
:type: runfiles | None

Runfiles that are specific to the interpreter within the venv.

:::{versionadded} 2.0.0
:::
""",
        "venv_interpreter_symlinks": """
:type: depset[ExplicitSymlink] | None

Symlinks that are specific to the interpreter within the venv.

Only used with Windows for files that would have used `declare_symlink()`
to create relative symlinks. These may overlap with paths in runfiles; it's
up to the consumer to determine how to handle such overlaps.

:::{versionadded} 2.0.0
:::
""",
        "venv_python_exe": """
:type: File | None

The `bin/python3` file within the venv this binary uses. May be None if venv
mode is not enabled.

:::{versionadded} 1.9.0
:::
""",
    },
)