"""
This module defines the things that are used in setup.py for building IPython
This includes:
* The basic arguments to setup
* Functions for finding things like packages, package data, etc.
* A function for checking dependencies.
"""
import os
from pathlib import Path
import re
import sys
from glob import glob
from logging import log
from setuptools import Command
from setuptools.command.build_py import build_py
from setuptools.command.install import install
from setuptools.command.install_scripts import install_scripts
repo_root = Path(__file__).resolve().parent
def execfile(path, globs, locs=None):
locs = locs or globs
with path.open(encoding="utf-8") as f:
exec(compile(f.read(), str(path), "exec"), globs, locs)
execfile(Path(repo_root, "IPython", "core", "release.py"), globals())
setup_args = dict(
author = author,
author_email = author_email,
license = license,
)
def check_package_data(package_data):
"""verify that package_data globs make sense"""
print("checking package data")
for pkg, data in package_data.items():
pkg_root = Path(*pkg.split("."))
for d in data:
path = pkg_root / d
if "*" in str(path):
assert len(glob(str(path))) > 0, "No files match pattern %s" % path
else:
assert path.exists(), f"Missing package data: {path}"
def check_package_data_first(command):
"""decorator for checking package_data before running a given command
Probably only needs to wrap build_py
"""
class DecoratedCommand(command):
def run(self):
check_package_data(self.package_data)
command.run(self)
return DecoratedCommand
def find_data_files():
"""
Find IPython's data_files.
Just man pages at this point.
"""
if "freebsd" in sys.platform:
manpagebase = Path("man") / "man1"
else:
manpagebase = Path("share") / "man" / "man1"
manpages = [f for f in Path("docs/man").glob("*.1.gz") if f.is_file()]
if not manpages:
manpages = [f for f in Path("docs/man").glob("*.1") if f.is_file()]
data_files = [(str(manpagebase), [str(f) for f in manpages])]
return data_files
def target_outdated(target, deps):
"""Determine whether a target is out of date.
target_outdated(target,deps) -> 1/0
deps: list of filenames which MUST exist.
target: single filename which may or may not exist.
If target doesn't exist or is older than any file listed in deps, return
true, otherwise return false.
"""
try:
target_time = Path(target).stat().st_mtime
except FileNotFoundError:
return 1
for dep in deps:
dep_time = Path(dep).stat().st_mtime
if dep_time > target_time:
return 1
return 0
def target_update(target, deps, cmd):
"""Update a target with a given command given a list of dependencies.
target_update(target,deps,cmd) -> runs cmd if target is outdated.
This is just a wrapper around target_outdated() which calls the given
command if target is outdated."""
if target_outdated(target, deps):
os.system(cmd)
def git_prebuild(pkg_dir, build_cmd=build_py):
"""Return extended build or sdist command class for recording commit
records git commit in IPython.utils._sysinfo.commit
for use in IPython.utils.sysinfo.sys_info() calls after installation.
"""
class MyBuildPy(build_cmd):
''' Subclass to write commit data into installation tree '''
def run(self):
print("check version number")
loose_pep440re = re.compile(r'^(\d+)\.(\d+)\.(\d+((a|b|rc)\d+)?)(\.post\d+)?(\.dev\d*)?$')
if not loose_pep440re.match(version):
raise ValueError("Version number '%s' is not valid (should match [N!]N(.N)*[{a|b|rc}N][.postN][.devN])" % version)
build_cmd.run(self)
if hasattr(self, 'build_lib'):
self._record_commit(self.build_lib)
def make_release_tree(self, base_dir, files):
build_cmd.make_release_tree(self, base_dir, files)
self._record_commit(base_dir)
def _record_commit(self, base_dir):
import subprocess
proc = subprocess.Popen('git rev-parse --short HEAD',
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
shell=True)
repo_commit, _ = proc.communicate()
repo_commit = repo_commit.strip().decode("ascii")
out_pth = Path(base_dir) / pkg_dir / "utils" / "_sysinfo.py"
if out_pth.is_file() and not repo_commit:
return
print(f"writing git commit '{repo_commit}' to {out_pth}")
try:
out_pth.unlink()
except FileNotFoundError:
pass
with out_pth.open("w", encoding="utf-8") as out_file:
out_file.writelines(
[
"# GENERATED BY setup.py\n",
f'commit = "{repo_commit}"\n',
]
)
return MyBuildPy