gallery/gallery.py

   1 import atexit
   2 import json
   3 import subprocess
   4 import tarfile
   5 import tempfile
   6 import traceback
   7 import venv
   8 import zipfile
   9 from argparse import ArgumentParser, Namespace
  10 from concurrent.futures import ThreadPoolExecutor
  11 from functools import lru_cache, partial
  12 from pathlib import Path
  13 from typing import (  # type: ignore # typing can't see Literal
  14     Generator,
  15     List,
  16     Literal,
  17     NamedTuple,
  18     Optional,
  19     Tuple,
  20     Union,
  21     cast,
  22 )
  23 from urllib.request import urlopen, urlretrieve
  24
  25 PYPI_INSTANCE = "https://pypi.org/pypi"
  26 PYPI_TOP_PACKAGES = (
  27     "https://hugovk.github.io/top-pypi-packages/top-pypi-packages-{days}-days.json"
  28 )
  29 INTERNAL_BLACK_REPO = f"{tempfile.gettempdir()}/__black"
  30
  31 ArchiveKind = Union[tarfile.TarFile, zipfile.ZipFile]
  32 Days = Union[Literal[30], Literal[365]]
  33
  34 subprocess.run = partial(subprocess.run, check=True)  # type: ignore
  35 # https://github.com/python/mypy/issues/1484
  36
  37
  38 class BlackVersion(NamedTuple):
  39     version: str
  40     config: Optional[str] = None
  41
  42
  43 def get_pypi_download_url(package: str, version: Optional[str]) -> str:
  44     with urlopen(PYPI_INSTANCE + f"/{package}/json") as page:
  45         metadata = json.load(page)
  46
  47     if version is None:
  48         sources = metadata["urls"]
  49     else:
  50         if version in metadata["releases"]:
  51             sources = metadata["releases"][version]
  52         else:
  53             raise ValueError(
  54                 f"No releases found with version ('{version}') tag. "
  55                 f"Found releases: {metadata['releases'].keys()}"
  56             )
  57
  58     for source in sources:
  59         if source["python_version"] == "source":
  60             break
  61     else:
  62         raise ValueError(f"Couldn't find any sources for {package}")
  63
  64     return cast(str, source["url"])
  65
  66
  67 def get_top_packages(days: Days) -> List[str]:
  68     with urlopen(PYPI_TOP_PACKAGES.format(days=days)) as page:
  69         result = json.load(page)
  70
  71     return [package["project"] for package in result["rows"]]
  72
  73
  74 def get_package_source(package: str, version: Optional[str]) -> str:
  75     if package == "cpython":
  76         if version is None:
  77             version = "master"
  78         return f"https://github.com/python/cpython/archive/{version}.zip"
  79     elif package == "pypy":
  80         if version is None:
  81             version = "branch/default"
  82         return (
  83             f"https://foss.heptapod.net/pypy/pypy/repository/{version}/archive.tar.bz2"
  84         )
  85     else:
  86         return get_pypi_download_url(package, version)
  87
  88
  89 def get_archive_manager(local_file: str) -> ArchiveKind:
  90     if tarfile.is_tarfile(local_file):
  91         return tarfile.open(local_file)
  92     elif zipfile.is_zipfile(local_file):
  93         return zipfile.ZipFile(local_file)
  94     else:
  95         raise ValueError("Unknown archive kind.")
  96
  97
  98 def get_first_archive_member(archive: ArchiveKind) -> str:
  99     if isinstance(archive, tarfile.TarFile):
 100         return archive.getnames()[0]
 101     elif isinstance(archive, zipfile.ZipFile):
 102         return archive.namelist()[0]
 103
 104
 105 def download_and_extract(package: str, version: Optional[str], directory: Path) -> Path:
 106     source = get_package_source(package, version)
 107
 108     local_file, _ = urlretrieve(source, directory / f"{package}-src")
 109     with get_archive_manager(local_file) as archive:
 110         archive.extractall(path=directory)
 111         result_dir = get_first_archive_member(archive)
 112     return directory / result_dir
 113
 114
 115 def get_package(
 116     package: str, version: Optional[str], directory: Path
 117 ) -> Optional[Path]:
 118     try:
 119         return download_and_extract(package, version, directory)
 120     except Exception:
 121         print(f"Caught an exception while downloading {package}.")
 122         traceback.print_exc()
 123         return None
 124
 125
 126 DEFAULT_SLICE = slice(None)  # for flake8
 127
 128
 129 def download_and_extract_top_packages(
 130     directory: Path, days: Days = 365, workers: int = 8, limit: slice = DEFAULT_SLICE,
 131 ) -> Generator[Path, None, None]:
 132     with ThreadPoolExecutor(max_workers=workers) as executor:
 133         bound_downloader = partial(get_package, version=None, directory=directory)
 134         for package in executor.map(bound_downloader, get_top_packages(days)[limit]):
 135             if package is not None:
 136                 yield package
 137
 138
 139 def git_create_repository(repo: Path) -> None:
 140     subprocess.run(["git", "init"], cwd=repo)
 141     git_add_and_commit(msg="Inital commit", repo=repo)
 142
 143
 144 def git_add_and_commit(msg: str, repo: Path) -> None:
 145     subprocess.run(["git", "add", "."], cwd=repo)
 146     subprocess.run(["git", "commit", "-m", msg, "--allow-empty"], cwd=repo)
 147
 148
 149 def git_switch_branch(
 150     branch: str, repo: Path, new: bool = False, from_branch: Optional[str] = None
 151 ) -> None:
 152     args = ["git", "checkout"]
 153     if new:
 154         args.append("-b")
 155     args.append(branch)
 156     if from_branch:
 157         args.append(from_branch)
 158     subprocess.run(args, cwd=repo)
 159
 160
 161 def init_repos(options: Namespace) -> Tuple[Path, ...]:
 162     options.output.mkdir(exist_ok=True)
 163
 164     if options.top_packages:
 165         source_directories = tuple(
 166             download_and_extract_top_packages(
 167                 directory=options.output,
 168                 workers=options.workers,
 169                 limit=slice(None, options.top_packages),
 170             )
 171         )
 172     else:
 173         source_directories = (
 174             download_and_extract(
 175                 package=options.pypi_package,
 176                 version=options.version,
 177                 directory=options.output,
 178             ),
 179         )
 180
 181     for source_directory in source_directories:
 182         git_create_repository(source_directory)
 183
 184     if options.black_repo is None:
 185         subprocess.run(
 186             ["git", "clone", "https://github.com/psf/black.git", INTERNAL_BLACK_REPO],
 187             cwd=options.output,
 188         )
 189         options.black_repo = options.output / INTERNAL_BLACK_REPO
 190
 191     return source_directories
 192
 193
 194 @lru_cache(8)
 195 def black_runner(version: str, black_repo: Path) -> Path:
 196     directory = tempfile.TemporaryDirectory()
 197     venv.create(directory.name, with_pip=True)
 198
 199     python = Path(directory.name) / "bin" / "python"
 200     subprocess.run([python, "-m", "pip", "install", "-e", black_repo])
 201
 202     atexit.register(directory.cleanup)
 203     return python
 204
 205
 206 def format_repo_with_version(
 207     repo: Path,
 208     from_branch: Optional[str],
 209     black_repo: Path,
 210     black_version: BlackVersion,
 211     input_directory: Path,
 212 ) -> str:
 213     current_branch = f"black-{black_version.version}"
 214     git_switch_branch(black_version.version, repo=black_repo)
 215     git_switch_branch(current_branch, repo=repo, new=True, from_branch=from_branch)
 216
 217     format_cmd: List[Union[Path, str]] = [
 218         black_runner(black_version.version, black_repo),
 219         (black_repo / "black.py").resolve(),
 220         ".",
 221     ]
 222     if black_version.config:
 223         format_cmd.extend(["--config", input_directory / black_version.config])
 224
 225     subprocess.run(format_cmd, cwd=repo, check=False)  # ensure the process
 226     # continuess to run even it can't format some files. Reporting those
 227     # should be enough
 228     git_add_and_commit(f"Format with black:{black_version.version}", repo=repo)
 229
 230     return current_branch
 231
 232
 233 def format_repos(repos: Tuple[Path, ...], options: Namespace) -> None:
 234     black_versions = tuple(
 235         BlackVersion(*version.split(":")) for version in options.versions
 236     )
 237
 238     for repo in repos:
 239         from_branch = None
 240         for black_version in black_versions:
 241             from_branch = format_repo_with_version(
 242                 repo=repo,
 243                 from_branch=from_branch,
 244                 black_repo=options.black_repo,
 245                 black_version=black_version,
 246                 input_directory=options.input,
 247             )
 248         git_switch_branch("master", repo=repo)
 249
 250     git_switch_branch("master", repo=options.black_repo)
 251
 252
 253 def main() -> None:
 254     parser = ArgumentParser(
 255         description="""Black Gallery is a script that
 256     automates the process of applying different Black versions to a selected
 257     PyPI package and seeing the results between versions."""
 258     )
 259
 260     group = parser.add_mutually_exclusive_group(required=True)
 261     group.add_argument("-p", "--pypi-package", help="PyPI package to download.")
 262     group.add_argument(
 263         "-t", "--top-packages", help="Top n PyPI packages to download.", type=int
 264     )
 265
 266     parser.add_argument("-b", "--black-repo", help="Black's Git repository.", type=Path)
 267     parser.add_argument(
 268         "-v",
 269         "--version",
 270         help=(
 271             "Version for given PyPI package. "
 272             "Will be discarded if used with -t option."
 273         ),
 274     )
 275     parser.add_argument(
 276         "-w",
 277         "--workers",
 278         help=(
 279             "Maximum number of threads to download with at the same time. "
 280             "Will be discarded if used with -p option."
 281         ),
 282     )
 283     parser.add_argument(
 284         "-i",
 285         "--input",
 286         default=Path("/input"),
 287         type=Path,
 288         help="Input directory to read configuration.",
 289     )
 290     parser.add_argument(
 291         "-o",
 292         "--output",
 293         default=Path("/output"),
 294         type=Path,
 295         help="Output directory to download and put result artifacts.",
 296     )
 297     parser.add_argument("versions", nargs="*", default=("master",), help="")
 298
 299     options = parser.parse_args()
 300     repos = init_repos(options)
 301     format_repos(repos, options)
 302
 303
 304 if __name__ == "__main__":
 305     main()