summaryrefslogtreecommitdiff
path: root/INSTALL.rst
blob: a4f2bf11a251a0b19ce9857e063c572c0820b105 (plain)
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
110
111
112
113
114
115
Linux, Windows, macOS (wheels)
==============================

psutil makes extensive use of C extension modules, meaning a C compiler is
required.
For these 3 platforms though, pre-compiled cPython wheels are provided on each
psutil release, so all you have to do is this::

    pip3 install psutil

If wheels are not available and you whish to install from sources, keep reading.

Linux (install from sources)
============================

Ubuntu / Debian::

    sudo apt-get install gcc python3-dev
    pip3 install --user psutil --no-binary :all:

RedHat / CentOS::

    sudo yum install gcc python3-devel
    pip3 install --user psutil --no-binary :all:

Windows (install from sources)
==============================

In order to compile psutil on Windows you'll need **Visual Studio**.
Here's a couple of guides describing how to do it: `1 <https://blog.ionelmc.ro/2014/12/21/compiling-python-extensions-on-windows/>`__
and `2 <https://cpython-core-tutorial.readthedocs.io/en/latest/build_cpython_windows.html>`__. And then::

    pip3 install --user psutil --no-binary :all:

Note that MinGW compiler is not supported.

FreeBSD
=======

::

    pkg install python3 gcc
    python3 -m pip3 install psutil

OpenBSD
=======

::

    export PKG_PATH=http://ftp.eu.openbsd.org/pub/OpenBSD/`uname -r`/packages/`uname -m`/
    pkg_add -v python gcc
    python3 -m pip install psutil

NetBSD
======

::

    export PKG_PATH="ftp.netbsd.org/pub/pkgsrc/packages/NetBSD/`uname -m`/`uname -r`/All"
    pkg_add -v pkgin
    pkgin install python3 gcc
    python3 -m pip install psutil

Solaris
=======

If ``cc`` compiler is not installed create a symlink to ``gcc``::

    sudo ln -s /usr/bin/gcc /usr/local/bin/cc

Install::

    pkg install gcc
    python3 -m pip install psutil

Testing installation
====================

::

    python3 -m psutil.tests

Dev Guide
=========

`Link <https://github.com/giampaolo/psutil/blob/master/docs/DEVGUIDE.rst>`__.

Install pip
===========

Pip is shipped by default with Python 2.7.9+ and 3.4+.
If you don't have it you can install with wget::

    wget https://bootstrap.pypa.io/get-pip.py -O - | python3

...ow with curl::

    python3 < <(curl -s https://bootstrap.pypa.io/get-pip.py)

On Windows, `download pip <https://pip.pypa.io/en/latest/installing/>`__, open
cmd.exe and install it::

    C:\Python27\python.exe get-pip.py

Permission issues (UNIX)
========================

If you bump into permission errors you have two options.
Install psutil for your user only::

    pip3 install --user psutil

...or prepend ``sudo`` and install it at system level::

    sudo pip3 install psutil