mirror of
https://github.com/pypa/pip
synced 2023-12-13 21:30:23 +01:00
354 lines
12 KiB
Python
354 lines
12 KiB
Python
"""Automation using nox.
|
|
"""
|
|
|
|
import glob
|
|
import os
|
|
import shutil
|
|
import sys
|
|
from pathlib import Path
|
|
from typing import Iterator, List, Tuple
|
|
|
|
import nox
|
|
|
|
# fmt: off
|
|
sys.path.append(".")
|
|
from tools import release # isort:skip # noqa
|
|
sys.path.pop()
|
|
# fmt: on
|
|
|
|
nox.options.reuse_existing_virtualenvs = True
|
|
nox.options.sessions = ["lint"]
|
|
|
|
LOCATIONS = {
|
|
"common-wheels": "tests/data/common_wheels",
|
|
"protected-pip": "tools/tox_pip.py",
|
|
}
|
|
REQUIREMENTS = {
|
|
"docs": "docs/requirements.txt",
|
|
"tests": "tests/requirements.txt",
|
|
"common-wheels": "tests/requirements-common_wheels.txt",
|
|
}
|
|
|
|
AUTHORS_FILE = "AUTHORS.txt"
|
|
VERSION_FILE = "src/pip/__init__.py"
|
|
|
|
|
|
def run_with_protected_pip(session: nox.Session, *arguments: str) -> None:
|
|
"""Do a session.run("pip", *arguments), using a "protected" pip.
|
|
|
|
This invokes a wrapper script, that forwards calls to original virtualenv
|
|
(stable) version, and not the code being tested. This ensures pip being
|
|
used is not the code being tested.
|
|
"""
|
|
# https://github.com/theacodes/nox/pull/377
|
|
env = {"VIRTUAL_ENV": session.virtualenv.location} # type: ignore
|
|
|
|
command = ("python", LOCATIONS["protected-pip"]) + arguments
|
|
session.run(*command, env=env, silent=True)
|
|
|
|
|
|
def should_update_common_wheels() -> bool:
|
|
# If the cache hasn't been created, create it.
|
|
if not os.path.exists(LOCATIONS["common-wheels"]):
|
|
return True
|
|
|
|
# If the requirements was updated after cache, we'll repopulate it.
|
|
cache_last_populated_at = os.path.getmtime(LOCATIONS["common-wheels"])
|
|
requirements_updated_at = os.path.getmtime(REQUIREMENTS["common-wheels"])
|
|
need_to_repopulate = requirements_updated_at > cache_last_populated_at
|
|
|
|
# Clear the stale cache.
|
|
if need_to_repopulate:
|
|
shutil.rmtree(LOCATIONS["common-wheels"], ignore_errors=True)
|
|
|
|
return need_to_repopulate
|
|
|
|
|
|
# -----------------------------------------------------------------------------
|
|
# Development Commands
|
|
# These are currently prototypes to evaluate whether we want to switch over
|
|
# completely to nox for all our automation. Contributors should prefer using
|
|
# `tox -e ...` until this note is removed.
|
|
# -----------------------------------------------------------------------------
|
|
@nox.session(python=["3.6", "3.7", "3.8", "3.9", "3.10", "pypy3"])
|
|
def test(session: nox.Session) -> None:
|
|
# Get the common wheels.
|
|
if should_update_common_wheels():
|
|
# fmt: off
|
|
run_with_protected_pip(
|
|
session,
|
|
"wheel",
|
|
"-w", LOCATIONS["common-wheels"],
|
|
"-r", REQUIREMENTS["common-wheels"],
|
|
)
|
|
# fmt: on
|
|
else:
|
|
msg = f"Re-using existing common-wheels at {LOCATIONS['common-wheels']}."
|
|
session.log(msg)
|
|
|
|
# Build source distribution
|
|
# https://github.com/theacodes/nox/pull/377
|
|
sdist_dir = os.path.join(session.virtualenv.location, "sdist") # type: ignore
|
|
if os.path.exists(sdist_dir):
|
|
shutil.rmtree(sdist_dir, ignore_errors=True)
|
|
|
|
# fmt: off
|
|
session.run(
|
|
"python", "setup.py", "sdist", "--formats=zip", "--dist-dir", sdist_dir,
|
|
silent=True,
|
|
)
|
|
# fmt: on
|
|
|
|
generated_files = os.listdir(sdist_dir)
|
|
assert len(generated_files) == 1
|
|
generated_sdist = os.path.join(sdist_dir, generated_files[0])
|
|
|
|
# Install source distribution
|
|
run_with_protected_pip(session, "install", generated_sdist)
|
|
|
|
# Install test dependencies
|
|
run_with_protected_pip(session, "install", "-r", REQUIREMENTS["tests"])
|
|
|
|
# Parallelize tests as much as possible, by default.
|
|
arguments = session.posargs or ["-n", "auto"]
|
|
|
|
# Run the tests
|
|
# LC_CTYPE is set to get UTF-8 output inside of the subprocesses that our
|
|
# tests use.
|
|
session.run("pytest", *arguments, env={"LC_CTYPE": "en_US.UTF-8"})
|
|
|
|
|
|
@nox.session
|
|
def docs(session: nox.Session) -> None:
|
|
session.install("-e", ".")
|
|
session.install("-r", REQUIREMENTS["docs"])
|
|
|
|
def get_sphinx_build_command(kind):
|
|
# type: (str) -> List[str]
|
|
# Having the conf.py in the docs/html is weird but needed because we
|
|
# can not use a different configuration directory vs source directory
|
|
# on RTD currently. So, we'll pass "-c docs/html" here.
|
|
# See https://github.com/rtfd/readthedocs.org/issues/1543.
|
|
# fmt: off
|
|
return [
|
|
"sphinx-build",
|
|
"-W",
|
|
"-c", "docs/html", # see note above
|
|
"-d", "docs/build/doctrees/" + kind,
|
|
"-b", kind,
|
|
"docs/" + kind,
|
|
"docs/build/" + kind,
|
|
]
|
|
# fmt: on
|
|
|
|
session.run(*get_sphinx_build_command("html"))
|
|
session.run(*get_sphinx_build_command("man"))
|
|
|
|
|
|
@nox.session(name="docs-live")
|
|
def docs_live(session: nox.Session) -> None:
|
|
session.install("-e", ".")
|
|
session.install("-r", REQUIREMENTS["docs"], "sphinx-autobuild")
|
|
|
|
session.run(
|
|
"sphinx-autobuild",
|
|
"-d=docs/build/doctrees/livehtml",
|
|
"-b=dirhtml",
|
|
"docs/html",
|
|
"docs/build/livehtml",
|
|
*session.posargs,
|
|
)
|
|
|
|
|
|
@nox.session
|
|
def lint(session: nox.Session) -> None:
|
|
session.install("pre-commit")
|
|
|
|
if session.posargs:
|
|
args = session.posargs + ["--all-files"]
|
|
else:
|
|
args = ["--all-files", "--show-diff-on-failure"]
|
|
|
|
session.run("pre-commit", "run", *args)
|
|
|
|
|
|
@nox.session
|
|
def vendoring(session: nox.Session) -> None:
|
|
session.install("vendoring>=0.3.0")
|
|
|
|
if "--upgrade" not in session.posargs:
|
|
session.run("vendoring", "sync", ".", "-v")
|
|
return
|
|
|
|
def pinned_requirements(path):
|
|
# type: (Path) -> Iterator[Tuple[str, str]]
|
|
for line in path.read_text().splitlines(keepends=False):
|
|
one, sep, two = line.partition("==")
|
|
if not sep:
|
|
continue
|
|
name = one.strip()
|
|
version = two.split("#", 1)[0].strip()
|
|
if name and version:
|
|
yield name, version
|
|
|
|
vendor_txt = Path("src/pip/_vendor/vendor.txt")
|
|
for name, old_version in pinned_requirements(vendor_txt):
|
|
if name == "setuptools":
|
|
continue
|
|
|
|
# update requirements.txt
|
|
session.run("vendoring", "update", ".", name)
|
|
|
|
# get the updated version
|
|
new_version = old_version
|
|
for inner_name, inner_version in pinned_requirements(vendor_txt):
|
|
if inner_name == name:
|
|
# this is a dedicated assignment, to make flake8 happy
|
|
new_version = inner_version
|
|
break
|
|
else:
|
|
session.error(f"Could not find {name} in {vendor_txt}")
|
|
|
|
# check if the version changed.
|
|
if new_version == old_version:
|
|
continue # no change, nothing more to do here.
|
|
|
|
# synchronize the contents
|
|
session.run("vendoring", "sync", ".")
|
|
|
|
# Determine the correct message
|
|
message = f"Upgrade {name} to {new_version}"
|
|
|
|
# Write our news fragment
|
|
news_file = Path("news") / (name + ".vendor.rst")
|
|
news_file.write_text(message + "\n") # "\n" appeases end-of-line-fixer
|
|
|
|
# Commit the changes
|
|
release.commit_file(session, ".", message=message)
|
|
|
|
|
|
# -----------------------------------------------------------------------------
|
|
# Release Commands
|
|
# -----------------------------------------------------------------------------
|
|
@nox.session(name="prepare-release")
|
|
def prepare_release(session: nox.Session) -> None:
|
|
version = release.get_version_from_arguments(session)
|
|
if not version:
|
|
session.error("Usage: nox -s prepare-release -- <version>")
|
|
|
|
session.log("# Ensure nothing is staged")
|
|
if release.modified_files_in_git("--staged"):
|
|
session.error("There are files staged in git")
|
|
|
|
session.log(f"# Updating {AUTHORS_FILE}")
|
|
release.generate_authors(AUTHORS_FILE)
|
|
if release.modified_files_in_git():
|
|
release.commit_file(session, AUTHORS_FILE, message=f"Update {AUTHORS_FILE}")
|
|
else:
|
|
session.log(f"# No changes to {AUTHORS_FILE}")
|
|
|
|
session.log("# Generating NEWS")
|
|
release.generate_news(session, version)
|
|
|
|
session.log(f"# Bumping for release {version}")
|
|
release.update_version_file(version, VERSION_FILE)
|
|
release.commit_file(session, VERSION_FILE, message="Bump for release")
|
|
|
|
session.log("# Tagging release")
|
|
release.create_git_tag(session, version, message=f"Release {version}")
|
|
|
|
session.log("# Bumping for development")
|
|
next_dev_version = release.get_next_development_version(version)
|
|
release.update_version_file(next_dev_version, VERSION_FILE)
|
|
release.commit_file(session, VERSION_FILE, message="Bump for development")
|
|
|
|
|
|
@nox.session(name="build-release")
|
|
def build_release(session: nox.Session) -> None:
|
|
version = release.get_version_from_arguments(session)
|
|
if not version:
|
|
session.error("Usage: nox -s build-release -- YY.N[.P]")
|
|
|
|
session.log("# Ensure no files in dist/")
|
|
if release.have_files_in_folder("dist"):
|
|
session.error(
|
|
"There are files in dist/. Remove them and try again. "
|
|
"You can use `git clean -fxdi -- dist` command to do this"
|
|
)
|
|
|
|
session.log("# Install dependencies")
|
|
session.install("setuptools", "wheel", "twine")
|
|
|
|
with release.isolated_temporary_checkout(session, version) as build_dir:
|
|
session.log(
|
|
"# Start the build in an isolated, "
|
|
f"temporary Git checkout at {build_dir!s}",
|
|
)
|
|
with release.workdir(session, build_dir):
|
|
tmp_dists = build_dists(session)
|
|
|
|
tmp_dist_paths = (build_dir / p for p in tmp_dists)
|
|
session.log(f"# Copying dists from {build_dir}")
|
|
os.makedirs("dist", exist_ok=True)
|
|
for dist, final in zip(tmp_dist_paths, tmp_dists):
|
|
session.log(f"# Copying {dist} to {final}")
|
|
shutil.copy(dist, final)
|
|
|
|
|
|
def build_dists(session: nox.Session) -> List[str]:
|
|
"""Return dists with valid metadata."""
|
|
session.log(
|
|
"# Check if there's any Git-untracked files before building the wheel",
|
|
)
|
|
|
|
has_forbidden_git_untracked_files = any(
|
|
# Don't report the environment this session is running in
|
|
not untracked_file.startswith(".nox/build-release/")
|
|
for untracked_file in release.get_git_untracked_files()
|
|
)
|
|
if has_forbidden_git_untracked_files:
|
|
session.error(
|
|
"There are untracked files in the working directory. "
|
|
"Remove them and try again",
|
|
)
|
|
|
|
session.log("# Build distributions")
|
|
session.run("python", "setup.py", "sdist", "bdist_wheel", silent=True)
|
|
produced_dists = glob.glob("dist/*")
|
|
|
|
session.log(f"# Verify distributions: {', '.join(produced_dists)}")
|
|
session.run("twine", "check", *produced_dists, silent=True)
|
|
|
|
return produced_dists
|
|
|
|
|
|
@nox.session(name="upload-release")
|
|
def upload_release(session: nox.Session) -> None:
|
|
version = release.get_version_from_arguments(session)
|
|
if not version:
|
|
session.error("Usage: nox -s upload-release -- YY.N[.P]")
|
|
|
|
session.log("# Install dependencies")
|
|
session.install("twine")
|
|
|
|
distribution_files = glob.glob("dist/*")
|
|
session.log(f"# Distribution files: {distribution_files}")
|
|
|
|
# Sanity check: Make sure there's 2 distribution files.
|
|
count = len(distribution_files)
|
|
if count != 2:
|
|
session.error(
|
|
f"Expected 2 distribution files for upload, got {count}. "
|
|
f"Remove dist/ and run 'nox -s build-release -- {version}'"
|
|
)
|
|
# Sanity check: Make sure the files are correctly named.
|
|
distfile_names = (os.path.basename(fn) for fn in distribution_files)
|
|
expected_distribution_files = [
|
|
f"pip-{version}-py3-none-any.whl",
|
|
f"pip-{version}.tar.gz",
|
|
]
|
|
if sorted(distfile_names) != sorted(expected_distribution_files):
|
|
session.error(f"Distribution files do not seem to be for {version} release.")
|
|
|
|
session.log("# Upload distributions")
|
|
session.run("twine", "upload", *distribution_files)
|