Metadata-Version: 1.1
Name: pyexcel-io
Version: 0.2.3
Summary: A python library to read and write structured data in csv, zipped csv format and to/from databases
Home-page: UNKNOWN
Author: C.W.
Author-email: wangc_2011 (at) hotmail.com
License: New BSD
Description: ================================================================================
        pyexcel-io - Let you focus on data, instead of file formats
        ================================================================================
        
        .. image:: https://api.travis-ci.org/pyexcel/pyexcel-io.svg?branch=master
           :target: http://travis-ci.org/pyexcel/pyexcel-io
        
        .. image:: https://codecov.io/github/pyexcel/pyexcel-io/coverage.png
            :target: https://codecov.io/github/pyexcel/pyexcel-io
        
        .. image:: https://readthedocs.org/projects/pyexcel-io/badge/?version=latest
           :target: http://pyexcel-io.readthedocs.org/en/latest/
        
        
        **pyexcel-io** provides **one** application programming interface(API) to read
        and write the data in excel format, import the data into and export the data
        from database. It provides support for csv(z) format, django database and
        sqlalchemy supported databases. Its supported file formats are extended to cover
        "xls", "xlsx", "ods" by the following extensions:
        
        .. _file-format-list:
        .. _a-map-of-plugins-and-file-formats:
        
        .. table:: A list of file formats supported by external plugins
        
           ================= ======================= ============= ==================
           Package name      Supported file formats  Dependencies  Python versions
           ================= ======================= ============= ==================
           `pyexcel-io`_     csv, csvz [#f1]_, tsv,                2.6, 2.7, 3.3,
                             tsvz [#f2]_                           3.4, 3.5,
                                                                   pypy, pypy3
           `pyexcel-xls`_    xls, xlsx(read only),   xlrd, xlwt    same as above
                             xlsm(read only)                       
                                                                   
           `pyexcel-xlsx`_   xlsx                    openpyxl      same as above
           `pyexcel-xlsxw`_  xlsx(write only)        xlsxwriter    same as above
           `pyexcel-ods3`_   ods                     ezodf, lxml   2.6, 2.7, 3.3, 3.4
                                                                   3.5
           `pyexcel-ods`_    ods                     odfpy         same as above
           ================= ======================= ============= ==================
        
        .. _pyexcel-io: https://github.com/pyexcel/pyexcel-io
        .. _pyexcel-xls: https://github.com/pyexcel/pyexcel-xls
        .. _pyexcel-xlsx: https://github.com/pyexcel/pyexcel-xlsx
        .. _pyexcel-ods: https://github.com/pyexcel/pyexcel-ods
        .. _pyexcel-ods3: https://github.com/pyexcel/pyexcel-ods3
        .. _pyexcel-xlsxw: https://github.com/pyexcel/pyexcel-xlsxw
        
        
        .. rubric:: Footnotes
        
        .. [#f1] zipped csv file
        .. [#f2] zipped tsv file
        
        If you need to manipulate the data, you might do it yourself or use its brother
        library `pyexcel <https://github.com/pyexcel/pyexcel>`__ .
        
        If you would like to extend it, you may use it to write your own
        extension to handle a specific file format.
        
        
        Known constraints
        ==================
        
        Fonts, colors and charts are not supported.
        
        
        Installation
        ================================================================================
        You can install it via pip:
        
        .. code-block:: bash
        
            $ pip install pyexcel-io
        
        
        or clone it and install it:
        
        .. code-block:: bash
        
            $ git clone http://github.com/pyexcel/pyexcel-io.git
            $ cd pyexcel-io
            $ python setup.py install
        
        
        
        License
        ================================================================================
        
        New BSD License
        
        Change log
        ================================================================================
        
        0.24 - unreleased
        --------------------------------------------------------------------------------
        
        Updated
        ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
        
        #. `#19 <https://github.com/pyexcel/pyexcel-io/issues/19>`__, use cString by default
        
        0.23 - unreleased
        --------------------------------------------------------------------------------
        
        Added
        ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
        
        #. `#21 <https://github.com/pyexcel/pyexcel-io/issues/21>`__, choose subset from data base tables for export
        #. `#22 <https://github.com/pyexcel/pyexcel-io/issues/22>`__, custom renderer if given `row_renderer` as parameter.
        
        0.22 - 31.08.2016
        --------------------------------------------------------------------------------
        
        Added
        ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
        
        #. support pagination. two pairs: start_row, row_limit and start_column, column_limit
           help you deal with large files.
        #. `skip_empty_rows=True` was introduced. To include empty rows, put it to False.
        
        Updated
        ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
        
        #. `#20 <https://github.com/pyexcel/pyexcel-io/issues/20>`__, pyexcel-io attempts
           to parse cell contents of 'infinity' as a float/int, crashes
        
        
        0.2.1 - 11.07.2016
        --------------------------------------------------------------------------------
        
        
        Added
        ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
        
        #. csv format: handle utf-16 encoded csv files. Potentially being able to decode other formats if correct "encoding" is provided
        #. csv format: write utf-16 encoded files. Potentially other encoding is also supported
        #. support stdin as input stream and stdout as output stream
        
        Updated
        ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
        
        #. Attention, user of pyexcel-io! No longer io stream validation is performed in python 3. The guideline is: io.StringIO for csv, tsv only, otherwise BytesIO for xlsx, xls, ods. You can use RWManager.get_io to produce a correct stream type for you.
        #. `#15 <https://github.com/pyexcel/pyexcel-io/issues/15>`__, support foreign django/sql foreign key
           
        0.2.0 - 01.06.2016
        --------------------------------------------------------------------------------
        
        Added
        ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
        
        #. autoload of pyexcel-io plugins
        #. auto detect `datetime`, `float` and `int`. Detection can be switched off by
           `auto_detect_datetime`, `auto_detect_float`, `auto_detect_int`
        
           
        0.1.0 - 17.01.2016
        --------------------------------------------------------------------------------
        
        Added
        ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
        
        # yield key word to return generator as content
        
        
Keywords: excel,python,pyexcel,API,tsv,tsvzcsv,csvz
Platform: UNKNOWN
Classifier: Topic :: Office/Business
Classifier: Topic :: Utilities
Classifier: Topic :: Software Development :: Libraries
Classifier: Programming Language :: Python
Classifier: License :: OSI Approved :: BSD License
Classifier: Intended Audience :: Developers
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: Implementation :: PyPy
