File: README.txt

package info (click to toggle)
ipython 8.35.0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 11,696 kB
  • sloc: python: 42,461; sh: 376; makefile: 243
file content (109 lines) | stat: -rw-r--r-- 3,331 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
===========================================================
 Self-contained IPython installation with all dependencies
===========================================================

This is a self-contained source distribution of IPython with all its
*non-graphical* dependencies, that installs in a single ``make`` call to your
home directory (by default) or any location of your choice.

This distribution is meant for developer-type usage in Unix environments, it is
*not* an easy way to get IPython working on Windows, since it assumes the
presence of a working compiler and development tools.

Currently, the distribution contains::

  ipython-0.9.1.tar.gz
  pyOpenSSL-0.6.tar.gz
  zope.interface-3.4.1.tar.gz
  Twisted-8.1.0.tar.bz2
  foolscap-0.3.1.tar.gz
  nose-0.10.3.tar.gz


Usage
=====

Download the single tarball where this README file lives and unpack it.  If
your system is already configured as described below, these lines will do the
whole job::

    wget http://ipython.scipy.org/dist/alldeps/ipython-alldeps-0.9.1.tar
    tar xf ipython-alldeps-0.9.1.tar
    cd ipython-alldeps-0.9.1
    make

If all goes well, then just type::

    iptest

to run IPython's test suite.

    
It is meant to be used in an environment where you have your ``$PATH``,
``$PYTHONPATH``, etc variables properly configured, so that the installation of
packages can be made with (using ``~/usr/local`` as an example)::

    pip install . --prefix=~/usr/local

For an explanation of how to do this, see below.

You can configure the default prefix used by editing the file
``pkginstall.cfg``, where you can also override the python version used for the
process.  If your system is configured in this manner, you can simply type::

    make

and this will build and install all of IPython's non-graphical dependencies on
your system, assuming you have Python, a compiler, the Python headers and the
SSL headers available.


.. _environment_configuration:

Environment configuration
=========================

Below is an example of what to put in your ``~/.bashrc`` file to configure your
environment as described in this document, in a reasonably portable manner that
takes 64-bit operating systems into account::

  # For processor dependent config
  MACHINE=$(uname -m)

  # Python version information
  PYVER=$(python -ESV 2>&1)
  PYVER_MINOR=${PYVER#Python }
  PYVER_MAJOR=${PYVER_MINOR:0:3}

  function export_paths {
      # Export useful paths based on a common prefix

      # Input: a path prefix

      local prefix=$1
      local pp
      local lp
      local pypath=python${PYVER_MAJOR}/site-packages

      # Compute paths with 64-bit specifics
      if [[ $MACHINE == "x86_64" ]]; then
	  lp=$prefix/lib64:$prefix/lib
	  pp=$prefix/lib64/$pypath:$prefix/lib/$pypath
      else	
	  lp=$prefix/lib
	  pp=$prefix/lib/$pypath
      fi

      # Set paths based on given prefix
      export PATH=$prefix/bin:$PATH
      export CPATH=$prefix/include:$CPATH
      export LD_LIBRARY_PATH=$lp:$LD_LIBRARY_PATH
      export LIBRARY_PATH=$lp:$LIBRARY_PATH
      export PYTHONPATH=$pp:$PYTHONPATH
  }

  # Actually call the export function to set the paths.  If you want more than
  # one such prefix, note that the call *prepends* the new prefix to the
  # existing paths, so later calls take priority.

  export_paths $HOME/usr/local