Files

84 lines
2.2 KiB
Python

"""Pip arguments for bootstrap install modes.
Generated by AI/LLM: 2026-09-30 - local and no-env install options.
SPEC 7.21. Both ``bootstrap`` and ``bootstrap.ps1`` call this script
and read one pip argument per stdout line.
"""
import argparse
import sys
def pip_install_args(
*,
local: bool,
no_env: bool,
break_system_packages: bool = False,
) -> list[str]:
"""Return the arguments passed to ``python -m pip``.
Args:
local: Install this repository as a normal package. When
false, the install is editable and includes the ``dev``
extra.
no_env: Add ``--user`` so the install does not need a virtual
environment.
break_system_packages: Add ``--break-system-packages``. Bash
sets this. PowerShell does not.
Returns:
The pip argument list, starting with ``install``.
"""
args = ["install"]
if no_env:
args.append("--user")
if break_system_packages:
args.append("--break-system-packages")
if local:
args.append(".")
else:
args.extend(["-e", ".[dev]"])
return args
def main(argv: list[str] | None = None) -> int:
"""Print pip arguments, one per line.
Args:
argv: Flags to parse. ``None`` reads ``sys.argv``.
Returns:
Process exit code. ``0`` after the arguments are written.
"""
parser = argparse.ArgumentParser(
description="Print pip install arguments for bootstrap.",
)
parser.add_argument(
"--local",
action="store_true",
help="install this repository as a normal package",
)
parser.add_argument(
"--no-env",
action="store_true",
help="add --user so no virtual environment is required",
)
parser.add_argument(
"--break-system-packages",
action="store_true",
help="pass --break-system-packages to pip",
)
parsed = parser.parse_args(argv)
words = pip_install_args(
local=parsed.local,
no_env=parsed.no_env,
break_system_packages=parsed.break_system_packages,
)
sys.stdout.write("\n".join(words) + "\n")
return 0
if __name__ == "__main__":
sys.exit(main())