Metadata-Version: 2.1
Name: perspective-python
Version: 0.4.2
Summary: Python bindings and JupyterLab integration for Perspective
Home-page: https://github.com/finos/perspective
Author: Perspective Authors
Author-email: open_source@jpmorgan.com
License: Apache 2.0
Description: # perspective-python
        
        Python APIs for [perspective](https://github.com/finos/perspective) front end
        
        [![Build Status](https://travis-ci.org/finos/perspective.svg?branch=master)](https://travis-ci.org/finos/perspective)
        [![GitHub issues](https://img.shields.io/github/issues/finos/perspective.svg)]()
        [![codecov](https://codecov.io/gh/finos/perspective/branch/master/graph/badge.svg)](https://codecov.io/gh/finos/perspective)
        [![PyPI](https://img.shields.io/pypi/v/perspective-python.svg)](https://pypi.python.org/pypi/perspective-python)
        [![PyPI](https://img.shields.io/pypi/l/perspective-python.svg)](https://pypi.python.org/pypi/perspective-python)
        
        ## Install
        
        ### Dependencies
        
        `PyArrow==0.15.1` and `Numpy` are required build-time dependencies, and can both be installed via `pip`.
        
        `pip install pyarrow==0.15.1`
        
        It is recommended to have [https://github.com/intel/tbb](TBB) installed as a system dependency:
        
        On MacOs:
        
        `brew install tbb`
        
        On CentOS/RHEL:
        
        `yum install tbb-devel`
        
        On Ubuntu:
        
        `apt-get install libtbb-dev`
        
        On Windows:
        
        `choco install tbb`
        
        Or install from source.
        
        All other dependencies will be vendored if missing as part of Perspective's CMake build, but you can install them yourself and CMake will detect them via the usual mechanisms. 
        
        ### Installation
        
        To install the base package from pip:
        
        `pip install perspective-python`
        
        To install the JupyterLab extension:
        
        `jupyter labextension install @finos/perspective-jupyterlab`
        
        ## Getting Started
        
        [Python User Guide](https://perspective.finos.org/docs/md/python.html)
        [Python API](https://perspective.finos.org/docs/obj/perspective-python.html)
        [Examples](https://github.com/finos/perspective/tree/master/python/perspective/examples)
        
        ## Developing
        
        To build `perspective-python` from source, you'll need the following C++ dependencies:
        
        - Python 3.7
        - numpy
        - CMake
        - PyBind11
        - tbb
        
        On MacOS, you should be able to install Boost, PyBind11, and tbb from brew:
        
        ```shell
        brew install pybind11 tbb
        ```
        
        And then install Python dependencies using pip:
        
        ```shell
        python3 -m pip install -r requirements-dev.txt
        ```
        
        Then run `yarn build`, and if a `.perspectiverc` config file has not been created yet, you'll be taken through the `yarn setup` script. On the `Focus` section, type `p` for python, and continue through the script. Run `yarn build` again, and the python build should begin.
        
        If you already have a `.perspectiverc` and want to reset your build configuration, simply run `yarn setup`.
        
        Once the build successfully completes, run `yarn test_python` from the project root in order to verify operation.
        
        ### Windows
        By default, perspective attempts to build utilizing Microsoft Visual Studio 2017 (MSVC 14.1). You may change this to older versions by editing `setup.py`.
        
Keywords: analytics tools plotting
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Description-Content-Type: text/markdown
Provides-Extra: dev
