1- Bloomberg Python API version 3.12
2- =================================
1+ Bloomberg Python API
2+ ====================
33
44This directory contains an interface for interacting with Bloomberg API
55services using the Python programming language. This package is the source
6- installer, and requires a C compilation environment compatible with Python's
7- `distutils` package. Windows users without such an environment are encourage to
8- instead use the appropriate binary installer, available from
9- <http://www.bloomberglabs.com/api/libraries/>.
6+ installer, and requires a C/C++ compilation environment compatible with
7+ Python's `setuptools` package.
108
9+ Users are encouraged to install using `pip` directly, as documented in
10+ <https://www.bloomberg.com/professional/support/api-library>
1111
1212Dependencies
1313------------
1414
1515This SDK requires the following products:
1616
17- - CPython version 2.6 or higher
17+ - CPython version 2.7 or higher
1818
19- - Bloomberg C++ SDK version 3.9 or later
19+ - Bloomberg C++ SDK same major and minor version as the Python SDK
2020
21- - Visual C ++ 2008 or 2010 (Windows) or GCC 4.1+ (Linux)
21+ - Optionally, C/C ++ compiler for your CPython installation
2222
23+ - On Windows, the VC redistributable package for the Python install
2324
24- Installation
25- ------------
25+ The C/C++ compilers are only needed for building the binary part of the module.
26+ We provide pre-built binaries for different versions of CPython on Windows, but
27+ you may need to have the compiler to build on other operating systems or
28+ unsupported versions of CPython.
29+
30+ On Windows, the VS redistributable package for the compiler used in the target
31+ CPython installation is needed. You can find the compiler version for a
32+ CPython version in [1] and the VC redistributable package in [2].
33+
34+ [1] https://wiki.python.org/moin/WindowsCompilers
35+
36+ [2] https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads
37+
38+
39+ Installation from sources
40+ -------------------------
41+
42+ Installation using pip is strongly recommended, and can handle installing from
43+ sources by building the Python SDK binaries locally. The C++ SDK and setting
44+ the `BLPAPI_ROOT` environment is still needed to build with `pip`, but the rest
45+ of the steps are equivalent to a normal installation.
2646
2747Note that installation requires a working C compiler and the C headers
2848distributed as part of the Bloomberg C++ SDK.
2949
30501. Set the `BLPAPI_ROOT` environment variable to the location at which the
3151 Bloomberg C++ SDK is installed. (This is the directory containing the
3252 `include` directory. On linux this may be of the form
33- `$HOME/blpapi_cpp_3.9.5.1 `; on Windows, this location may be of the
34- form `C:\blp\API\APIv3\C++API\v3.9.5.1 \`.) Note that this is environment
53+ `$HOME/blpapi_cpp_3.x.y.z `; on Windows, this location may be of the
54+ form `C:\blp\API\APIv3\C++API\v3.x.y.z \`.) Note that this is environment
3555 variable is required only for *installing* the `blpapi` package, not for
3656 running blpapi python applications.
3757
@@ -57,8 +77,9 @@ distributed as part of the Bloomberg C++ SDK.
5777 (configured by `/etc/ld.so.conf` on Linux and by setting the `PATH`
5878 environment variable on Windows) to include the directory containing the
5979 C++ SDK library. Note that this step is not necessary for users who already
60- have a system-wide installation of the C++ SDK, including Windows users who
61- have the Bloomberg Terminal software installed.
80+ have a system-wide installation of the C++ SDK with the same or newer
81+ version, including Windows users who have the Bloomberg Terminal software
82+ installed.
6283
6384
6485Writing Bloomberg API Programs in Python
@@ -96,7 +117,8 @@ Documentation for individual Bloomberg API classes and functions is provided
96117through Python's built-in help system.
97118
98119Further documentation on programming the Bloomberg API is available in the
99- Developer's Guide, available at <http://www..bloomberglabs.com/api/>.
120+ Developer's Guide, available at
121+ <http://www.bloomberg.com/professional/api-library>.
100122
101123
102124Examples
0 commit comments