File: install.rst

package info (click to toggle)
bcolz 1.2.1%2Bds2-2
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 4,528 kB
  • sloc: python: 9,691; makefile: 148; sh: 26; ansic: 11
file content (103 lines) | stat: -rw-r--r-- 2,710 bytes parent folder | download | duplicates (2)
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
------------
Installation
------------

bcolz depends on NumPy and, optionally, Numexpr.  Also, if you are
going to install from sources, and a C compiler (Clang, GCC and MSVC
2008 for Python 2, and MSVC 2010 for Python 3, have been tested).


Installing from PyPI repository
===============================

Do::

  $ easy_install -U bcolz

or::

  $ pip install -U bcolz

Installing from conda-forge
===========================

Binaries for Linux, Mac and Windows are available for installation via conda. 
Do::

  $ conda install -c conda-forge bcolz

Installing Windows binaries
===========================

Unofficial Windows binaries are provided by Christoph Gohlke and can be
downloaded from:

http://www.lfd.uci.edu/~gohlke/pythonlibs/#bcolz

Using the Microsoft Python 2.7 Compiler
=======================================

As of Sept 2014 Microsoft has made a Visual C++ compiler for Python 2.7
available for download:

http://aka.ms/vcpython27

This has been made available specifically to ease the handling of Python
packages with C-extensions on Windows (installation and building wheels).

It is possible to compile bcolz with this compiler (Jan 2015), however,
you may need to use the following patch::

    diff --git i/setup.py w/setup.py
    index d77d37f233..b54bfd0fa1 100644
    --- i/setup.py
    +++ w/setup.py
    @@ -11,8 +11,8 @@ from __future__ import absolute_import
     import sys
     import os
     import glob
    -from distutils.core import Extension
    -from distutils.core import setup
    +from setuptools import Extension
    +from setuptools import setup
     import textwrap
     import re, platform

Installing from tarball sources
===============================

Go to the bcolz main directory and do the typical distutils dance::

    $ python setup.py build_ext --inplace

In case you have Blosc installed as an external library you can link
with it (disregarding the included Blosc sources) in a couple of ways:

Using an environment variable::

  $ BLOSC_DIR=/usr/local     (or "set BLOSC_DIR=\blosc" on Win)
  $ export BLOSC_DIR         (not needed on Win)
  $ python setup.py build_ext --inplace

Using a flag::

  $ python setup.py build_ext --inplace --blosc=/usr/local

It is always nice to run the tests before installing the package::

  $ PYTHONPATH=.   (or "set PYTHONPATH=." on Windows)
  $ export PYTHONPATH    (not needed on Windows)
  $ python -c"import bcolz; bcolz.test()"  # add `heavy=True` if desired

And if everything runs fine, then install it via::

  $ python setup.py install


Testing the installation
========================

You can always test the installation from any directory with::

  $ python -c "import bcolz; bcolz.test()"