Bump to v3.17.1

Author: msitt

MANIFEST.in

@@ -0,0 +1,6 @@
+include README.md changelog.txt NOTES License.txt
+
+recursive-include examples *.py README.md diagram.png
+recursive-exclude examples/demoapps-internal *
+
+prune cpp-licenses

PKG-INFO

@@ -1,15 +1,19 @@
-Metadata-Version: 1.1
+Metadata-Version: 2.1
 Name: blpapi
-Version: 3.16.5
+Version: 3.17.1
 Summary: Python SDK for Bloomberg BLPAPI
 Home-page: http://www.bloomberglabs.com/api/
 Author: Bloomberg L.P.
 Author-email: open-tech@bloomberg.net
 License: UNKNOWN
-Description: UNKNOWN
 Platform: UNKNOWN
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Financial and Insurance Industry
 Classifier: License :: Other/Proprietary License
 Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3
+License-File: License.txt
+
+UNKNOWN
+

README README.mdREADME renamed to README.md

@@ -1,5 +1,4 @@
-Bloomberg Python API
-====================
+# Bloomberg Python API
 
 This directory contains an interface for interacting with Bloomberg API
 services using the Python programming language. This package is the source
@@ -9,8 +8,7 @@ Python's `setuptools` package.
 Users are encouraged to install using `pip` directly, as documented in
 <https://www.bloomberg.com/professional/support/api-library>
 
-Dependencies
-------------
+## Dependencies
 
 This SDK requires the following products:
 
@@ -29,15 +27,9 @@ unsupported versions of CPython.
 
 On Windows, the VS redistributable package for the compiler used in the target
 CPython installation is needed.  You can find the compiler version for a
-CPython version in [1] and the VC redistributable package in [2].
+CPython version [here](https://wiki.python.org/moin/WindowsCompilers) and the VC redistributable package [here](https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads).
 
-[1] https://wiki.python.org/moin/WindowsCompilers
-
-[2] https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads
-
-
-Installation from sources
--------------------------
+## Installation from sources
 
 Installation using pip is strongly recommended, and can handle installing from
 sources by building the Python SDK binaries locally.  The C++ SDK and setting
@@ -57,20 +49,26 @@ distributed as part of the Bloomberg C++ SDK.
 
 2. To compile and install the `blpapi` Python package for all users, run
 
-       > python setup.py install
+    ```bash
+    > python setup.py install
+    ```
 
    To compile and install the `blpapi` Python package for only the current
    user, run
 
-       > python setup.py install --user
+   ```bash
+   > python setup.py install --user
+   ```
 
    (Note that the former command requires root/administrator access, while the
    latter does not.)
 
    Documentation on additional build and installation options is available by
    running
 
-       > python setup.py --help
+   ```bash
+   > python setup.py --help
+   ```
 
 3. (optional) Copy the C++ SDK shared library/DLL to a standard library
    location (e.g. `/usr/lib` on Linux), or update the system-wide library path
@@ -82,8 +80,7 @@ distributed as part of the Bloomberg C++ SDK.
    installed.
 
 
-Writing Bloomberg API Programs in Python
-----------------------------------------
+## Writing Bloomberg API Programs in Python
 
 In order for python scripts to call Bloomberg API functions, the libraries
 distributed as part of the Bloomberg C++ SDK must be available to the Python
@@ -99,12 +96,14 @@ these libraries in their `PATH`.)
 After installation, the `blpapi` module can be imported by a Python script or
 within the CPython interpreter:
 
-    >>> import blpapi
-    >>> options = blpapi.SessionOptions()
-    >>> options.setServerHost('localhost')
-    >>> options.setServerPort(8194)
-    >>> session = blpapi.Session(options)
-    >>> session.start()
+```python
+>>> import blpapi
+>>> options = blpapi.SessionOptions()
+>>> options.setServerHost('localhost')
+>>> options.setServerPort(8194)
+>>> session = blpapi.Session(options)
+>>> session.start()
+```
 
 Note that many Python installations add the current directory to the module
 search path. If the Python interpreter is invoked from the installer directory,
@@ -121,19 +120,17 @@ Developer's Guide, available at
 <http://www.bloomberg.com/professional/api-library>.
 
 
-Examples
---------
+## Examples
 
 A collection of complete Python programs covering a wide range of typical API
-usage is available in the `examples` directory, located in the same directory
+usage is available in the [`examples` directory](examples/), located in the same directory
 as this `README` file. Note that many examples make use of command-line
 arguments to specify server and authentication configuration; in most cases
 usage information can be obtained by passing the `--help` option on the command
 line.
 
 
-Implementation Notes
---------------------
+## Implementation Notes
 
 - The Bloomberg SDK for Python 2 does not provide direct support for Python
   `unicode` objects. Clients can pass unicode data to SDK functions accepting
@@ -145,8 +142,7 @@ Implementation Notes
   `pickle` modules.
 
 
-Copyright and License
----------------------
+## Copyright and License
 
 All files Copyright 2012 Bloomberg Finance L.P.
 
@@ -168,4 +164,3 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
-

changelog.txt

@@ -1,3 +1,46 @@
+Version 3.17.1:
+===============
+- Stability and performance improvements
+
+Version 3.17.0:
+===============
+- Native-type formatting and message consumption
+	Add ability to format 'Event's and 'Request's from native Python types
+	using methods 'EventFormatter.fromPy' and 'Request.fromPy'. Add ability
+	to convert a 'Message' to 'dict' with 'Message.toPy'. 'Message's and
+	'Request's have 'dict'-like behavior with '__getitem__' and
+	'__setitem__'.
+	
+- A new method 'correlationId()' is added to 'blpapi.Message'
+	A new method 'Message.correlationId()' is added to return the
+	single CorrelationId associated with the message or None if the
+	message has no CorrelationIds. If the message has multiple
+	CorrelationIds, the first one is returned.
+	
+- Constants for common used `Names`
+	A new utility class `blpapi.Names` has been added with common
+	message names.
+
+- Revamped examples
+	The 'examples' directory now contains 'demoapps' and 'unittests'
+	subdirectories. The 'demoapps' directory contains a consolidated set of
+	example applications. Within 'demoapps', the 'snippets' directory contains
+	sample code for creating and sending requests, and for processing
+	responses. Also within 'demoapps', the 'util' directory contains common
+	code shared between examples. The 'unittests' directory has been renamed
+	from 'mock-test-examples' and contains sample code for using the mock
+	testing interface.
+
+- End of Python 2 support
+	Installation and use of BLPAPI Python now requires a Python 3.6+
+	runtime.
+
+- Stability and performance improvements
+
+Version 3.16.6:
+===============
+- Stability and performance improvements
+
 Version 3.16.5:
 ===============
 - Stability and performance improvements