8000 GitHub - Cassidamius/pyexcel: Python Wrapper for reading, manipulating and writing csv, ods, xls, xlsx and xlsm files
[go: up one dir, main page]

Skip to content

Cassidamius/pyexcel

 
 

Repository files navigation

pyexcel

https://api.travis-ci.org/chfw/pyexcel.png https://codecov.io/github/chfw/pyexcel/coverage.png https://readthedocs.org/projects/pyexcel/badge/?version=latest https://pypip.in/d/pyexcel/badge.png https://pypip.in/py_versions/pyexcel/badge.png https://pypip.in/implementation/pyexcel/badge.png

pyexcel is a wrapper library to read, manipulate and write data in different excel formats: csv, ods, xls, xlsx and xlsm. Its mission is to let you focus on data itself and it deals with different file formats. ODS format support is provided by pyexcel-ods or pyexcel-ods3. Fonts, colors and charts are not supported.

It was created due to the lack of uniform programming interface to access data in different formats. A developer needs to use different methods of different libraries to read the same data in different excel formats, hence the resulting code is cluttered and unmaintainable.

All great work have done by odf, ezodf(2), xlrd and other individual developers. This library unites only the data access code.

Installation

You can install it via pip:

$ pip install pyexcel

or clone it and install it:

$ git clone http://github.com/chfw/pyexcel.git
$ cd pyexcel
$ python setup.py install

Open Document Spreadsheet(ods) Support

In order to add ods support, please choose one of two packages: pyexcel-ods or pyexcel-ods3

$ pip install pyexcel-ods

or:

$ pip install pyexcel-ods3

In order to use them together with pyexcel, you need an extra import line in your code to activate it:

from pyexcel.ext import ods

or:

from pyexcel.ext import ods3

No futher code is needed. pyexcel will automatically support ods after this import.

package python 2.6 python 2.7 python 3.2 python 3.3 python 3.4
pyexcel-ods yes yes      
pyexcel-ods3   yes   yes yes

Test

Here is the test command:

pip install -r tests/requirements.txt
nosetests tests

Test coverage is shown in codecov.io . You can get instant test coverage report by using the following command:

make test

Or on Windows please use:

test.bat

Optionally, you can add --cover-html --cover-html-dir=your_file_directory to test.sh or test.bat

Known Issues

  • If a zero was typed in a DATE formatted field in xls, you will get "01/01/1900".
  • If a zero was typed in a TIME formatted field in xls, you will get "00:00:00".

Documentation

It is hosted in pyhosted

Acknowledgement

Extension management code was copied from flask.

About

Python Wrapper for reading, manipulating and writing csv, ods, xls, xlsx and xlsm files

Resources

License

Stars

Watchers

Forks

Packages

No packages published
0