Switch branches/tags
Nothing to show
Find file
Fetching contributors…
Cannot retrieve contributors at this time
executable file 260 lines (212 sloc) 9.34 KB
#!/usr/bin/env python
# -*- coding: utf-8 -*-
"""Setup script for IPython.
Under Posix environments it works like a typical script.
Under Windows, the command sdist is not supported, since IPython
requires utilities which are not available under Windows."""
# Copyright (c) 2008-2011, IPython Development Team.
# Copyright (c) 2001-2007, Fernando Perez <>
# Copyright (c) 2001, Janko Hauser <>
# Copyright (c) 2001, Nathaniel Gray <>
# Distributed under the terms of the Modified BSD License.
# The full license is in the file COPYING.txt, distributed with this software.
# Minimal Python version sanity check
from __future__ import print_function
import sys
# This check is also made in IPython/__init__, don't forget to update both when
# changing Python version requirements.
#~ if sys.version[0:3] < '2.6':
#~ error = """\
#~ ERROR: 'IPython requires Python Version 2.6 or above.'
#~ Exiting."""
#~ print >> sys.stderr, error
#~ sys.exit(1)
PY3 = (sys.version_info[0] >= 3)
# At least we're on the python version we need, move on.
# Imports
# Stdlib imports
import os
import shutil
from glob import glob
# BEFORE importing distutils, remove MANIFEST. distutils doesn't properly
# update it when the contents of directories change.
if os.path.exists('MANIFEST'): os.remove('MANIFEST')
from distutils.core import setup
# On Python 3, we need distribute (new setuptools) to do the 2to3 conversion
if PY3:
import setuptools
# Our own imports
from setupbase import target_update
from setupbase import (
from setupext import setupext
isfile = os.path.isfile
pjoin = os.path.join
# Function definitions
def cleanup():
"""Clean up the junk left around by the build process"""
if "develop" not in sys.argv:
# Handle OS specific things
if == 'posix':
os_name = 'posix'
elif in ['nt','dos']:
os_name = 'windows'
print('Unsupported operating system:',
# Under Windows, 'sdist' has not been supported. Now that the docs build with
# Sphinx it might work, but let's not turn it on until someone confirms that it
# actually works.
if os_name == 'windows' and 'sdist' in sys.argv:
print('The sdist command is not available under Windows. Exiting.')
# Things related to the IPython documentation
# update the manuals when building a source dist
if len(sys.argv) >= 2 and sys.argv[1] in ('sdist','bdist_rpm'):
import textwrap
# List of things to be updated. Each entry is a triplet of args for
# target_update()
to_update = [
# FIXME - Disabled for now: we need to redo an automatic way
# of generating the magic info inside the rst.
#"cd doc && ./" ),
'cd docs/man && gzip -9c ipcluster.1 > ipcluster.1.gz'),
'cd docs/man && gzip -9c ipcontroller.1 > ipcontroller.1.gz'),
'cd docs/man && gzip -9c ipengine.1 > ipengine.1.gz'),
'cd docs/man && gzip -9c iplogger.1 > iplogger.1.gz'),
'cd docs/man && gzip -9c ipython.1 > ipython.1.gz'),
'cd docs/man && gzip -9c irunner.1 > irunner.1.gz'),
'cd docs/man && gzip -9c pycolor.1 > pycolor.1.gz'),
[ target_update(*t) for t in to_update ]
# Find all the packages, package data, and data_files
packages = find_packages()
package_data = find_package_data()
data_files = find_data_files()
setup_args['cmdclass'] = {'build_py': record_commit_info('IPython')}
setup_args['packages'] = packages
setup_args['package_data'] = package_data
setup_args['data_files'] = data_files
# Handle scripts, dependencies, and setuptools specific things
# For some commands, use setuptools. Note that we do NOT list install here!
# If you want a setuptools-enhanced install, just run ' install'
needs_setuptools = set(('develop', 'release', 'bdist_egg', 'bdist_rpm',
'bdist', 'bdist_dumb', 'bdist_wininst', 'install_egg_info',
'egg_info', 'easy_install', 'upload',
if sys.platform == 'win32':
# Depend on setuptools for install on *Windows only*
# If we get script-installation working without setuptools,
# then we can back off, but until then use it.
# See Issue #369 on GitHub for more
if len(needs_setuptools.intersection(sys.argv)) > 0:
import setuptools
# This dict is used for passing extra arguments that are setuptools
# specific to setup
setuptools_extra_args = {}
if 'setuptools' in sys.modules:
setuptools_extra_args['zip_safe'] = False
setuptools_extra_args['entry_points'] = find_scripts(True)
setup_args['extras_require'] = dict(
parallel = 'pyzmq>=2.1.4',
zmq = 'pyzmq>=2.1.4',
doc = 'Sphinx>=0.3',
test = 'nose>=0.10.1',
notebook = 'tornado>=2.0'
requires = setup_args.setdefault('install_requires', [])
setupext.display_status = False
if not setupext.check_for_readline():
if sys.platform == 'darwin':
elif sys.platform.startswith('win'):
# Pyreadline 64 bit windows issue solved in versions >=1.7.1
# Also solves issues with some older versions of pyreadline that
# satisfy the unconstrained depdendency.
# do we want to install readline here?
# Script to be run by the windows binary installer after the default setup
# routine, to add shortcuts and similar windows-only things. Windows
# post-install scripts MUST reside in the scripts/ dir, otherwise distutils
# doesn't find them.
if 'bdist_wininst' in sys.argv:
if len(sys.argv) > 2 and \
('sdist' in sys.argv or 'bdist_rpm' in sys.argv):
print >> sys.stderr, "ERROR: bdist_wininst must be run alone. Exiting."
setup_args['scripts'] = [pjoin('scripts','')]
setup_args['options'] = {"bdist_wininst":
if PY3:
setuptools_extra_args['use_2to3'] = True
from setuptools.command.build_py import build_py
setup_args['cmdclass'] = {'build_py': record_commit_info('IPython', build_cmd=build_py)}
setuptools_extra_args['entry_points'] = find_scripts(True, suffix='3')
setuptools._dont_write_bytecode = True
# If we are running without setuptools, call this function which will
# check for dependencies an inform the user what is needed. This is
# just to make life easy for users.
setup_args['scripts'] = find_scripts(False)
# Do the actual setup now
def main():
if __name__ == '__main__':