Metadata-Version: 2.0
Name: pdutil
Version: 0.0.2
Summary: Utilities for pandas.
Home-page: https://github.com/shaypal5/pdutil
Author: Shay Palachy
Author-email: shay.palachy@gmail.com
License: UNKNOWN
Description-Content-Type: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Intended Audience :: Developers
Requires-Dist: pymongo (>=3.4)
Requires-Dist: strct
Provides-Extra: test
Requires-Dist: pytest; extra == 'test'
Requires-Dist: coverage; extra == 'test'
Requires-Dist: pytest-cov; extra == 'test'
Requires-Dist: pymongo (>=3.4); extra == 'test'
Requires-Dist: strct; extra == 'test'

pdutil
######
|PyPI-Status| |PyPI-Versions| |Build-Status| |Codecov| |LICENCE|

Utilities for pandas.

.. code-block:: python

  import pdutil
  for subdf in pdutil.iter.sub_dfs_by_size(df, 2):
    print(subdf)

.. contents::

.. section-numbering::


Installation
============

.. code-block:: bash

  pip install pdutil


Basic Use
=========

``pdutil`` is divided into several sub-modules by functionality:

display
-------

Functions related to displaying ``pandas`` DataFrames:

* ``df_string`` - Returns a nicely formatted string for the given dataframe.
* ``pandas_big_frame_setup`` - Sets pandas to display really big data frames.
* ``df_to_html`` - Return a nicely formatted HTML code string for the given dataframe.

iter
----

Functions related to iterating over ``pandas`` dataframes:

* ``sub_dfs_by_size`` - Get a generator yielding consecutive sub-dataframes of the given size.
* ``sub_dfs_by_num`` - Get a generator yielding num consecutive sub-dataframes of the given df. 

Contributing
============

Package author and current maintainer is Shay Palachy (shay.palachy@gmail.com); You are more than welcome to approach him for help. Contributions are very welcomed.

Installing for development
----------------------------

Clone:

.. code-block:: bash

  git clone git@github.com:shaypal5/pdutil.git


Install in development mode:

.. code-block:: bash

  cd pdutil
  pip install -e .


Running the tests
-----------------

To run the tests use:

.. code-block:: bash

  pip install pytest pytest-cov coverage
  cd pdutil
  pytest


Adding documentation
--------------------

The project is documented using the `numpy docstring conventions`_, which were chosen as they are perhaps the most widely-spread conventions that are both supported by common tools such as Sphinx and result in human-readable docstrings. When documenting code you add to this project, follow `these conventions`_.

.. _`numpy docstring conventions`: https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt
.. _`these conventions`: https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt


Credits
=======

Created by Shay Palachy (shay.palachy@gmail.com).


.. |PyPI-Status| image:: https://img.shields.io/pypi/v/pdutil.svg
  :target: https://pypi.python.org/pypi/pdutil

.. |PyPI-Versions| image:: https://img.shields.io/pypi/pyversions/pdutil.svg
   :target: https://pypi.python.org/pypi/pdutil

.. |Build-Status| image:: https://travis-ci.org/shaypal5/pdutil.svg?branch=master
  :target: https://travis-ci.org/shaypal5/pdutil

.. |LICENCE| image:: https://img.shields.io/pypi/l/pdutil.svg
  :target: https://pypi.python.org/pypi/pdutil

.. |Codecov| image:: https://codecov.io/github/shaypal5/pdutil/coverage.svg?branch=master
   :target: https://codecov.io/github/shaypal5/pdutil?branch=master


