2009-05-24 23:02:59 +02:00
|
|
|
/* This function provides a generic Python package builder. It is
|
2014-01-06 23:24:05 +01:00
|
|
|
intended to work with packages that use `distutils/setuptools'
|
2009-05-24 23:02:59 +02:00
|
|
|
(http://pypi.python.org/pypi/setuptools/), which represents a large
|
|
|
|
number of Python packages nowadays. */
|
|
|
|
|
2014-03-08 19:47:23 +01:00
|
|
|
{ python, setuptools, unzip, wrapPython, lib, recursivePthLoader, distutils-cfg }:
|
2009-05-24 23:02:59 +02:00
|
|
|
|
2014-01-06 23:24:05 +01:00
|
|
|
{ name
|
2009-05-24 23:02:59 +02:00
|
|
|
|
2014-01-11 11:44:24 +01:00
|
|
|
# by default prefix `name` e.g. "python3.3-${name}"
|
2014-01-06 23:24:05 +01:00
|
|
|
, namePrefix ? python.libPrefix + "-"
|
2010-07-28 15:05:04 +02:00
|
|
|
|
2014-01-06 23:24:05 +01:00
|
|
|
, buildInputs ? []
|
2012-12-03 05:20:50 +01:00
|
|
|
|
2014-01-11 11:44:24 +01:00
|
|
|
# pass extra information to the distutils global configuration (think as global setup.cfg)
|
2014-01-06 23:24:05 +01:00
|
|
|
, distutilsExtraCfg ? ""
|
2009-05-24 23:02:59 +02:00
|
|
|
|
2014-01-11 11:44:24 +01:00
|
|
|
# propagate build dependencies so in case we have A -> B -> C,
|
|
|
|
# C can import propagated packages by A
|
2014-01-06 23:24:05 +01:00
|
|
|
, propagatedBuildInputs ? []
|
2013-01-17 14:19:14 +01:00
|
|
|
|
2014-01-06 23:24:05 +01:00
|
|
|
# passed to "python setup.py install"
|
|
|
|
, setupPyInstallFlags ? []
|
2012-11-29 15:29:41 +01:00
|
|
|
|
2014-01-06 23:24:05 +01:00
|
|
|
# passed to "python setup.py build"
|
|
|
|
, setupPyBuildFlags ? []
|
2009-05-24 23:02:59 +02:00
|
|
|
|
2014-01-06 23:24:05 +01:00
|
|
|
# enable tests by default
|
2011-03-30 14:27:04 +02:00
|
|
|
, doCheck ? true
|
|
|
|
|
2014-01-06 23:24:05 +01:00
|
|
|
# List of packages that should be added to the PYTHONPATH
|
|
|
|
# environment variable in programs built by this function. Packages
|
|
|
|
# in the standard `propagatedBuildInputs' variable are also added.
|
|
|
|
# The difference is that `pythonPath' is not propagated to the user
|
|
|
|
# environment. This is preferrable for programs because it doesn't
|
|
|
|
# pollute the user environment.
|
2014-08-24 16:01:21 +02:00
|
|
|
, pythonPath ? []
|
|
|
|
|
|
|
|
# used to disable derivation, useful for specific python versions
|
|
|
|
, disabled ? false
|
2009-06-28 16:05:41 +02:00
|
|
|
|
2014-01-10 21:57:28 +01:00
|
|
|
, meta ? {}
|
2013-01-19 18:21:23 +01:00
|
|
|
|
2014-03-10 10:06:04 +01:00
|
|
|
# Execute before shell hook
|
|
|
|
, preShellHook ? ""
|
|
|
|
|
|
|
|
# Execute after shell hook
|
|
|
|
, postShellHook ? ""
|
|
|
|
|
2011-03-28 17:30:48 +02:00
|
|
|
, ... } @ attrs:
|
2009-05-24 23:02:59 +02:00
|
|
|
|
2014-08-24 16:01:21 +02:00
|
|
|
|
2014-01-06 23:24:05 +01:00
|
|
|
# Keep extra attributes from `attrs`, e.g., `patchPhase', etc.
|
2015-02-12 20:04:30 +01:00
|
|
|
python.stdenv.mkDerivation (attrs // {
|
2014-01-06 23:24:05 +01:00
|
|
|
inherit doCheck;
|
2009-05-24 23:02:59 +02:00
|
|
|
|
2011-03-28 17:30:48 +02:00
|
|
|
name = namePrefix + name;
|
2009-05-24 23:02:59 +02:00
|
|
|
|
2014-03-08 19:47:23 +01:00
|
|
|
buildInputs = [
|
2014-11-13 21:02:45 +01:00
|
|
|
wrapPython setuptools
|
2014-03-08 19:47:23 +01:00
|
|
|
(distutils-cfg.override { extraCfg = distutilsExtraCfg; })
|
|
|
|
] ++ buildInputs ++ pythonPath
|
2014-03-10 14:51:05 +01:00
|
|
|
++ (lib.optional (lib.hasSuffix "zip" attrs.src.name or "") unzip);
|
2009-05-24 23:02:59 +02:00
|
|
|
|
2014-11-13 21:02:45 +01:00
|
|
|
# propagate python to active setup-hook in nix-shell
|
|
|
|
propagatedBuildInputs = propagatedBuildInputs ++ [ recursivePthLoader python ];
|
2012-07-21 01:55:50 +02:00
|
|
|
|
2013-01-09 22:29:41 +01:00
|
|
|
pythonPath = [ setuptools ] ++ pythonPath;
|
2012-11-23 17:27:55 +01:00
|
|
|
|
2014-01-06 23:24:05 +01:00
|
|
|
configurePhase = attrs.configurePhase or ''
|
|
|
|
runHook preConfigure
|
|
|
|
|
2014-01-10 22:04:05 +01:00
|
|
|
# patch python interpreter to write null timestamps when compiling python files
|
|
|
|
# with following var we tell python to activate the patch so that python doesn't
|
|
|
|
# try to update them when we freeze timestamps in nix store
|
2013-06-22 07:52:27 +02:00
|
|
|
export DETERMINISTIC_BUILD=1
|
2014-01-06 23:24:05 +01:00
|
|
|
|
2014-01-10 22:04:05 +01:00
|
|
|
# prepend following line to import setuptools before distutils
|
|
|
|
# this way we make sure setuptools monkeypatches distutils commands
|
|
|
|
# this way setuptools provides extra helpers such as "python setup.py test"
|
2014-01-06 23:24:05 +01:00
|
|
|
sed -i '0,/import distutils/s//import setuptools;import distutils/' setup.py
|
|
|
|
sed -i '0,/from distutils/s//import setuptools;from distutils/' setup.py
|
|
|
|
|
|
|
|
runHook postConfigure
|
|
|
|
'';
|
|
|
|
|
|
|
|
checkPhase = attrs.checkPhase or ''
|
|
|
|
runHook preCheck
|
|
|
|
|
2014-02-21 14:29:32 +01:00
|
|
|
${python}/bin/${python.executable} setup.py test
|
2014-01-06 23:24:05 +01:00
|
|
|
|
|
|
|
runHook postCheck
|
|
|
|
'';
|
|
|
|
|
|
|
|
buildPhase = attrs.buildPhase or ''
|
|
|
|
runHook preBuild
|
|
|
|
|
|
|
|
${python}/bin/${python.executable} setup.py build ${lib.concatStringsSep " " setupPyBuildFlags}
|
|
|
|
|
|
|
|
runHook postBuild
|
2012-11-29 15:29:41 +01:00
|
|
|
'';
|
2009-05-24 23:02:59 +02:00
|
|
|
|
2014-01-06 23:24:05 +01:00
|
|
|
installPhase = attrs.installPhase or ''
|
|
|
|
runHook preInstall
|
|
|
|
|
2012-01-18 21:16:00 +01:00
|
|
|
mkdir -p "$out/lib/${python.libPrefix}/site-packages"
|
2009-05-24 23:02:59 +02:00
|
|
|
|
|
|
|
export PYTHONPATH="$out/lib/${python.libPrefix}/site-packages:$PYTHONPATH"
|
2014-01-06 23:24:05 +01:00
|
|
|
|
2014-01-11 11:44:24 +01:00
|
|
|
${python}/bin/${python.executable} setup.py install \
|
|
|
|
--install-lib=$out/lib/${python.libPrefix}/site-packages \
|
|
|
|
--old-and-unmanageable \
|
|
|
|
--prefix="$out" ${lib.concatStringsSep " " setupPyInstallFlags}
|
2009-08-11 18:25:41 +02:00
|
|
|
|
2014-01-22 10:17:34 +01:00
|
|
|
# --install-lib:
|
|
|
|
# sometimes packages specify where files should be installed outside the usual
|
|
|
|
# python lib prefix, we override that back so all infrastructure (setup hooks)
|
|
|
|
# work as expected
|
|
|
|
|
|
|
|
# --old-and-unmanagable:
|
2015-02-12 20:06:43 +01:00
|
|
|
# instruct setuptools not to use eggs but fallback to plan package install
|
2014-01-22 10:17:34 +01:00
|
|
|
# this also reduces one .pth file in the chain, but the main reason is to
|
|
|
|
# force install process to install only scripts for the package we are
|
|
|
|
# installing (otherwise it will install scripts also for dependencies)
|
|
|
|
|
2012-11-23 15:54:55 +01:00
|
|
|
# A pth file might have been generated to load the package from
|
|
|
|
# within its own site-packages, rename this package not to
|
|
|
|
# collide with others.
|
|
|
|
eapth="$out/lib/${python.libPrefix}"/site-packages/easy-install.pth
|
|
|
|
if [ -e "$eapth" ]; then
|
|
|
|
# move colliding easy_install.pth to specifically named one
|
|
|
|
mv "$eapth" $(dirname "$eapth")/${name}.pth
|
|
|
|
fi
|
|
|
|
|
|
|
|
# Remove any site.py files generated by easy_install as these
|
|
|
|
# cause collisions. If pth files are to be processed a
|
|
|
|
# corresponding site.py needs to be included in the PYTHONPATH.
|
2012-12-22 02:15:08 +01:00
|
|
|
rm -f "$out/lib/${python.libPrefix}"/site-packages/site.py*
|
2012-11-23 15:54:55 +01:00
|
|
|
|
2014-01-06 23:24:05 +01:00
|
|
|
runHook postInstall
|
2009-05-24 23:02:59 +02:00
|
|
|
'';
|
|
|
|
|
2014-05-21 14:46:37 +02:00
|
|
|
postFixup = attrs.postFixup or ''
|
2011-03-28 18:33:33 +02:00
|
|
|
wrapPythonPrograms
|
2012-07-21 01:55:50 +02:00
|
|
|
|
2014-01-11 11:44:24 +01:00
|
|
|
# TODO: document
|
2012-07-21 01:55:50 +02:00
|
|
|
createBuildInputsPth build-inputs "$buildInputStrings"
|
2012-12-28 19:20:09 +01:00
|
|
|
for inputsfile in propagated-build-inputs propagated-native-build-inputs; do
|
2012-07-21 01:55:50 +02:00
|
|
|
if test -e $out/nix-support/$inputsfile; then
|
|
|
|
createBuildInputsPth $inputsfile "$(cat $out/nix-support/$inputsfile)"
|
|
|
|
fi
|
|
|
|
done
|
2011-03-28 17:30:48 +02:00
|
|
|
'';
|
2014-01-06 23:24:05 +01:00
|
|
|
|
2014-03-10 10:06:04 +01:00
|
|
|
shellHook = attrs.shellHook or ''
|
2014-06-15 16:05:09 +02:00
|
|
|
if test -e setup.py; then
|
2014-09-19 14:23:45 +02:00
|
|
|
tmp_path=/tmp/`pwd | md5sum | cut -f 1 -d " "`-$name
|
|
|
|
mkdir -p $tmp_path/lib/${python.libPrefix}/site-packages
|
2014-06-15 16:05:09 +02:00
|
|
|
${preShellHook}
|
2014-09-19 14:23:45 +02:00
|
|
|
export PATH="$tmp_path/bin:$PATH"
|
|
|
|
export PYTHONPATH="$tmp_path/lib/${python.libPrefix}/site-packages:$PYTHONPATH"
|
|
|
|
${python}/bin/${python.executable} setup.py develop --prefix $tmp_path
|
2014-06-15 16:05:09 +02:00
|
|
|
${postShellHook}
|
|
|
|
fi
|
2014-03-10 10:06:04 +01:00
|
|
|
'';
|
|
|
|
|
2014-01-22 10:15:26 +01:00
|
|
|
meta = with lib.maintainers; {
|
2014-01-06 23:24:05 +01:00
|
|
|
# default to python's platforms
|
|
|
|
platforms = python.meta.platforms;
|
2015-02-12 20:04:30 +01:00
|
|
|
broken = disabled;
|
2014-01-22 10:15:26 +01:00
|
|
|
} // meta // {
|
2014-01-06 23:24:05 +01:00
|
|
|
# add extra maintainer(s) to every package
|
2014-01-11 11:44:24 +01:00
|
|
|
maintainers = (meta.maintainers or []) ++ [ chaoflow iElectric ];
|
2014-01-06 23:24:05 +01:00
|
|
|
};
|
|
|
|
|
2011-03-28 17:30:48 +02:00
|
|
|
})
|