Metadata-Version: 2.1
Name: pandas-multi
Version: 2019.3.12
Summary: Read multiple csvs or Excel files as a single pandas DataFrame.
Home-page: https://github.com/bartbroere/pandas_multi/
Author: Bart Broere
Author-email: mail@bartbroere.eu
License: MIT License
Keywords: pandas readcsv readcsvs csv xls xlsx excel dataframe multiple multi
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Utilities
Requires-Dist: pandas

pandas_multi
============

Simple loop for reading multiple csv files (matching a certain pattern) as a 
``pandas.DataFrame``.

I'm aware this need can be solved in even one line of Python, but loading 
multiple similar csv's is just something that should be as easy as loading 
one csv. If you don't want to add a new dependency to your project, google 
what ``os.listdir`` and ``glob`` can do for you.

Installation can be done by typing::

    pip install pandas_multi
Usage of ``pandas_multi.read_csvs`` has been kept as similar as possible to
``pandas.read_csv``::

    import pandas_multi

    # <sarcasm>
    #   Note that dataframes only work if you give them the non-descriptive name df
    # </sarcasm>
    df = pandas_multi.read_csvs('./20180728*.csv')
    # if you provide it with a path to a folder and nothing else, it will assume
    # everything in the folder is a comma-separated file
    df = pandas_multi.read_csvs('./data/')
    # if this is not the case, do this:
    df = pandas_multi.read_csvs('./data/*.csv')
All options that are available to ``pandas.read_csv`` or ``pandas.concat`` 
can be passed into ``pandas_multi.read_csvs`` and will be redirected to the 
appropriate underlying functions.

If you wish to maintain a trace back to the original data, you can run the 
function with the keyword argument ``filenames_as_keys=True``. Note that you
should no longer use the keyword argument ``keys``. This will be ignored.

Please note that the API for concatenation of Excel sheets is not yet stable.


