Metadata-Version: 2.1
Name: fastparquet
Version: 0.3.1
Summary: Python support for Parquet file format
Home-page: https://github.com/dask/fastparquet/
Author: Martin Durant
Author-email: mdurant@continuum.io
License: Apache License 2.0
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: Implementation :: CPython
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*,
Provides-Extra: lzo
Provides-Extra: brotli
Provides-Extra: snappy
Provides-Extra: lz4
Provides-Extra: zstandard
Requires-Dist: pandas (>=0.19)
Requires-Dist: numba (>=0.28)
Requires-Dist: numpy (>=1.11)
Requires-Dist: thrift (>=0.11.0)
Requires-Dist: six
Provides-Extra: brotli
Requires-Dist: brotli; extra == 'brotli'
Provides-Extra: lz4
Requires-Dist: lz4 (>=0.19.1); extra == 'lz4'
Provides-Extra: lzo
Requires-Dist: python-lzo; extra == 'lzo'
Provides-Extra: snappy
Requires-Dist: python-snappy; extra == 'snappy'
Provides-Extra: zstandard
Requires-Dist: zstandard; extra == 'zstandard'

fastparquet
===========

.. image:: https://travis-ci.org/jcrobak/parquet-python.svg?branch=master
    :target: https://github.com/dask/fastparquet

fastparquet is a python implementation of the `parquet
format <https://github.com/apache/parquet-format>`_, aiming integrate
into python-based big data work-flows.

Not all parts of the parquet-format have been implemented yet or tested
e.g. see the Todos linked below. With that said,
fastparquet is capable of reading all the data files from the
`parquet-compatability <https://github.com/Parquet/parquet-compatibility>`_
project.

Introduction
------------

Details of this project can be found in the documentation_.

.. _documentation: https://fastparquet.readthedocs.io

The original plan listing expected features can be found in
`this issue`_.
Please feel free to comment on that list as to missing items and priorities,
or raise new issues with bugs or requests.

.. _this issue: https://github.com/dask/fastparquet/issues/1



Requirements
------------

(all development is against recent versions in the default anaconda channels)

Required:

- numba (requires `LLVM 4.0.x`_)
- numpy
- pandas
- cython
- six

.. _LLVM 4.0.x: https://github.com/llvm-mirror/llvm 

Optional (compression algorithms; gzip is always available):

- snappy (aka python-snappy)
- lzo
- brotli
- lz4
- zstandard


Installation
------------

Install using conda::

   conda install -c conda-forge fastparquet

install from pypi::

   pip install fastparquet

or install latest version from github::

   pip install git+https://github.com/dask/fastparquet

For the pip methods, numba must have been previously installed (using conda).

Usage
-----

*Reading*

.. code-block:: python

    from fastparquet import ParquetFile
    pf = ParquetFile('myfile.parq')
    df = pf.to_pandas()
    df2 = pf.to_pandas(['col1', 'col2'], categories=['col1'])

You may specify which columns to load, which of those to keep as categoricals
(if the data uses dictionary encoding). The file-path can be a single file,
a metadata file pointing to other data files, or a directory (tree) containing
data files. The latter is what is typically output by hive/spark.

*Writing*

.. code-block:: python

    from fastparquet import write
    write('outfile.parq', df)
    write('outfile2.parq', df, row_group_offsets=[0, 10000, 20000],
          compression='GZIP', file_scheme='hive')

The default is to produce a single output file with a single row-group
(i.e., logical segment) and no compression. At the moment, only simple
data-types and plain encoding are supported, so expect performance to be
similar to *numpy.savez*.

History
-------

Since early October 2016, this fork of `parquet-python`_ has been
undergoing considerable redevelopment. The aim is to have a small and simple
and performant library for reading and writing the parquet format from python.

.. _parquet-python: https://github.com/jcrobak/parquet-python



