Add version 3.9.0.

Author: msitt

PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 1.0
 Name: blpapi
-Version: 3.5.5
-Summary: Python SDK for Bloomberg BLPAPI (3.5.5)
-Home-page: http://open.bloomberg.com/
+Version: 3.9.0
+Summary: Python SDK for Bloomberg BLPAPI (<=3.9)
+Home-page: http://www.bloomberglabs.com/api/
 Author: Bloomberg L.P.
-Author-email: UNKNOWN
+Author-email: [email protected]
 License: UNKNOWN
 Description: UNKNOWN
 Platform: UNKNOWN

README

@@ -1,18 +1,22 @@
-Bloomberg Python API version 3.5
+Bloomberg Python API version 3.9
 ================================
 
 This directory contains an interface for interacting with Bloomberg API
-services using the Python programming language.
+services using the Python programming language. This package is the source
+installer, and requires a C compilation environment compatible with Python's
+`distutils` package. Windows users without such an environment are encourage to
+instead use the appropriate binary installer, available from
+<http://www.bloomberglabs.com/api/libraries/>.
 
 
 Dependencies
 ------------
 
 This SDK requires the following products:
 
-- CPython version 2.6 or 2.7
+- CPython version 2.6 or higher
 
-- Bloomberg C++ SDK version 3.5 or later
+- Bloomberg C++ SDK version 3.9 or later
 
 - Visual C++ 2008 or 2010 (Windows) or GCC 4.1+ (Linux)
 
@@ -24,8 +28,12 @@ Note that installation requires a working C compiler and the C headers
 distributed as part of the Bloomberg C++ SDK.
 
 1. Set the `BLPAPI_ROOT` environment variable to the location at which the
-   Bloomberg C++ SDK is installed. (On Windows, this location may be of the
-   form `C:\blp\API\APIv3\C++API\v3.5.2.1\`.)
+   Bloomberg C++ SDK is installed. (This is the directory containing the
+   `include` directory. On linux this may be of the form
+   `$HOME/blpapi_cpp_3.9.5.1`; on Windows, this location may be of the
+   form `C:\blp\API\APIv3\C++API\v3.9.5.1\`.) Note that this is environment
+   variable is required only for *installing* the `blpapi` package, not for
+   running blpapi python applications.
 
 2. To compile and install the `blpapi` Python package for all users, run
 
@@ -88,7 +96,7 @@ Documentation for individual Bloomberg API classes and functions is provided
 through Python's built-in help system.
 
 Further documentation on programming the Bloomberg API is available in the
-Developer's Guide, available at <http://open.bloomberg.com>.
+Developer's Guide, available at <http://www..bloomberglabs.com/api/>.
 
 
 Examples
@@ -105,11 +113,11 @@ line.
 Implementation Notes
 --------------------
 
-- The Python Bloomberg SDK does not provide direct support for Python `unicode`
-  objects. Clients can pass unicode data to SDK functions accepting strings by
-  calling `u.encode('utf-8')` for an appropriate `unicode` object `u`; a string
-  `s` received from an SDK function can be converted to a `unicode` object by
-  calling `s.decode('utf-8')`.
+- The Bloomberg SDK for Python 2 does not provide direct support for Python
+  `unicode` objects. Clients can pass unicode data to SDK functions accepting
+   strings by calling `u.encode('utf-8')` for an appropriate `unicode` object
+   `u`; a string `s` received from an SDK function can be converted to a
+   `unicode` object by calling `s.decode('utf-8')`.
 
 - Python Bloomberg SDK types do not provide support for the Python `copy` or
   `pickle` modules.

blpapi/__init__.py

@@ -1,6 +1,6 @@
 # __init__.py
 
-from __future__ import absolute_import
+
 
 from .internals import CorrelationId
 

blpapi/abstractsession.py

@@ -4,18 +4,29 @@
 
 This file defines a class 'AbstractSession' - an interface which is shared
 between its concrete implementations 'Session' and 'ProviderSession'.
+
+SERVICE IDENTIFIER
+------------------
+A service identifier is the fully qualified service name which uniquely
+identifies the service in the API infrastructure.  A service must be of the
+form "//<namespace>/<service-name>" where '<namespace>' and '<local-name>' are
+non-empty strings of characters from the set '[-_.a-zA-Z0-9]'. Service
+identifiers are case-insensitive, but clients are encouraged to prefer
+identifiers without upper-case characters.  Note that the <namespace> and
+<service-name> cannot contain the character '/'.
 """
 
-from __future__ import absolute_import
+
 
 from .exception import _ExceptionUtil
 from .identity import Identity
 from .service import Service
 from . import internals
 from .internals import CorrelationId
 from . import utils
+from .compat import with_metaclass
 
-
+@with_metaclass(utils.MetaClassForClassesWithEnums)
 class AbstractSession(object):
     """A common interface shared between publish and consumer sessions.
 
@@ -256,8 +267,7 @@ def createIdentity(self):
 
     # Protect enumeration constant(s) defined in this class and in classes
     # derived from this class from changes:
-    __metaclass__ = utils.MetaClassForClassesWithEnums
-
+    
 __copyright__ = """
 Copyright 2012. Bloomberg Finance L.P.
 

blpapi/compat.py

@@ -0,0 +1,73 @@
+# compat.py
+
+import sys
+
+""" Different compatibility tools. Needed to support both
+2.x and 3.x python versions."""
+
+def with_metaclass(metaclass):
+    """Python 2 and 3 different metaclass syntax workaround. Should be used as a decorator."""
+    def wrapper(cls):
+        vars = cls.__dict__.copy()
+        slots = vars.get('__slots__')
+        if slots is not None:
+            if isinstance(slots, str):
+                slots = [slots]
+            for slots_var in slots:
+                vars.pop(slots_var)
+        vars.pop('__dict__', None)
+        vars.pop('__weakref__', None)
+        return metaclass(cls.__name__, cls.__bases__, vars)
+    return wrapper
+
+# NOTE: this function should be used to convert integer values to long
+# values in both python2 and 3.
+
+if sys.version.startswith('2'):
+    def tolong(val):
+        return long(val)
+else:
+    def tolong(val):
+        return int(val)
+
+# NOTE: python2 wrapper uses byte strings (str type) to pass strings to C-functions,
+# unicode type is not supported so we need to encode all strings first.
+# On the other hand, python3 wrapper uses unicode strings (str type) for this so we need
+# to decode byte-strings first to get unicode strings. Rule of thumb: to pass string to any
+# wrapper function convert it using `conv2str` function first, to check that type of the
+# string is correct - use `isstr` function.
+
+if sys.version.startswith('2'):
+    def conv2str(s):
+        """Convert unicode string to byte string."""
+        if isinstance(s, str):
+            return s
+        elif isinstance(s, unicode):
+            return s.encode('utf-8')
+        else:
+            return None
+
+    def isstr(s):
+        if isinstance(s, (str, unicode)):
+            return True
+        return False
+else:
+    def conv2str(s):
+        """Convert byte string to unicode string."""
+        if isinstance(s, bytes):
+            return s.decode()
+        elif isinstance(s, str):
+            return s
+        else:
+            return None
+
+    def isstr(s):
+        if isinstance(s, (bytes, str)):
+            return True
+        return False
+
+# NOTE: integer typelist for different python versions to use with isinstance builtin function
+if sys.version.startswith('2'):
+    int_typelist = (int, long)
+else:
+    int_typelist = (int,)

blpapi/constant.py

@@ -10,7 +10,7 @@
 a representation for lists of such constants
 """
 
-from __future__ import absolute_import
+
 
 from .exception import _ExceptionUtil, NotFoundException, \
     IndexOutOfRangeException
@@ -179,7 +179,7 @@ def datatype(self):
     def hasConstant(self, name):
         """True if this 'ConstantList' contains an item with this 'name'.
 
-        Returns True if this 'ConstantList' contains an item with the specified
+        Return True if this 'ConstantList' contains an item with the specified
         'name', and False otherwise.
 
         Exception is raised if 'name' is neither a Name nor a string.
@@ -208,11 +208,11 @@ def getConstant(self, name):
         return Constant(res, self.__sessions)
 
     def getConstantAt(self, position):
-        """Return the 'Constant' at the specified 'index'.
+        """Return the 'Constant' at the specified 'position'.
 
-        Return the 'Constant' at the specified 'index' in this 'ConstantList'.
-        If 'index' is not in the range from 0 to numConstants() - 1 then an
-        exception is raised.
+        Return the 'Constant' at the specified 'position' in this
+        'ConstantList'.  If 'position' is not in the range from 0 to
+        'numConstants() - 1' then an exception is raised.
         """
         res = internals.blpapi_ConstantList_getConstantAt(self.__handle,
                                                           position)

blpapi/datatype.py

@@ -6,13 +6,15 @@
     'DataType' - "enum" representing all possible data types in an Element.
 """
 
-from __future__ import absolute_import
+
 
 from . import internals
 from . import utils
+from .compat import with_metaclass
 
 
-class DataType:
+@with_metaclass(utils.MetaClassForClassesWithEnums)
+class DataType(object):
     """Contains the possible data types which can be represented in an Element.
 
     Class attributes:
@@ -70,10 +72,6 @@ class DataType:
     CORRELATION_ID = internals.DATATYPE_CORRELATION_ID
     """Used for some internal messages"""
 
-    # Protect enumeration constant(s) defined in this class and in classes
-    # derived from this class from changes:
-    __metaclass__ = utils.MetaClassForClassesWithEnums
-
 __copyright__ = """
 Copyright 2012. Bloomberg Finance L.P.
 

blpapi/datetime.py

@@ -3,13 +3,16 @@
 """Utilities that deal with blpapi.Datetime data type"""
 
 from __future__ import absolute_import
+from __future__ import division
 
 from . import internals
 from . import utils
+from .compat import with_metaclass
 
 import datetime as _dt
 
 
+@with_metaclass(utils.MetaClassForClassesWithEnums)
 class FixedOffset(_dt.tzinfo):
     """Time zone information.
 
@@ -43,29 +46,43 @@ class FixedOffset(_dt.tzinfo):
     """
 
     def __init__(self, offsetInMinutes=0):
-        _dt.tzinfo.__init__(self)
         self.__offset = _dt.timedelta(minutes=offsetInMinutes)
 
     def utcoffset(self, unused):
         return self.__offset
 
     def dst(self, unused):
-        return FixedOffset._dt.timedelta(0)
+        return _dt.timedelta(0)
 
     def getOffsetInMinutes(self):
-        return self.__offset.days * 24 * 60 + self.__offset.seconds / 60
+        return self.__offset.days * 24 * 60 + self.__offset.seconds // 60
 
     def __hash__(self):
         """x.__hash__() <==> hash(x)"""
         return self.getOffsetInMinutes()
 
     def __cmp__(self, other):
-        """Let the comparison operations work based on the time delta."""
+        """Let the comparison operations work based on the time delta.
+        NOTE: (compatibility) this method have no special meaning in python3, 
+        we should use __eq__, __lt__ and __le__ instead. Built-in cmp function
+        is also gone. This method can be called only from python2."""
         return cmp(self.getOffsetInMinutes(), other.getOffsetInMinutes())
 
-    # Protect enumeration constant(s) defined in this class and in classes
-    # derived from this class from changes:
-    __metaclass__ = utils.MetaClassForClassesWithEnums
+    def __eq__(self, other):
+        """Let the equality operator work based on the time delta."""
+        return self.getOffsetInMinutes() == other.getOffsetInMinutes()
+
+    def __lt__(self, other):
+        """Let the comparison operator work based on the time delta."""
+        return self.getOffsetInMinutes() < other.getOffsetInMinutes()
+
+    def __le__(self, other):
+        """Let the comparison operator work based on the time delta."""
+        return self.getOffsetInMinutes() <= other.getOffsetInMinutes()
+
+
+# UTC timezone
+UTC = FixedOffset(0)
 
 
 class _DatetimeUtil(object):
@@ -126,7 +143,7 @@ def convertToBlpapi(dtime):
             res.hours = dtime.hour
             res.minutes = dtime.minute
             res.seconds = dtime.second
-            res.milliSeconds = dtime.microsecond / 1000
+            res.milliSeconds = dtime.microsecond // 1000
             res.parts = internals.DATETIME_DATE_PART | \
                 internals.DATETIME_TIMEMILLI_PART
         elif isinstance(dtime, _dt.date):
@@ -139,7 +156,7 @@ def convertToBlpapi(dtime):
             res.hours = dtime.hour
             res.minutes = dtime.minute
             res.seconds = dtime.second
-            res.milliSeconds = dtime.microsecond / 1000
+            res.milliSeconds = dtime.microsecond // 1000
             res.parts = internals.DATETIME_TIMEMILLI_PART
         else:
             raise TypeError("Datetime could be created only from \

blpapi/diagnosticsutil.py

@@ -0,0 +1,14 @@
+# coding: utf-8
+
+#@PURPOSE: Provide api to access diagnostics information on the blpapi library
+#
+#@DESCRIPTION: This component provide a collection of functions which give
+# access to various sets of diagnostics information on the 'blpapi' library.
+
+import internals
+
+
+def memoryInfo():
+    """Return the string describing the 'blpapi' library's memory usage; the
+    format of the string is platform-specific."""
+    return internals.blpapi_DiagnosticsUtil_memoryInfo_wrapper()