Skip to main content

A wrapper library to read, manipulate and write data in different excel formats: csv, ods, xls, xlsx and xlsm.

Project description Supported Python implementation

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.

In addition, the library recognizes that Excel files are de-facto file format for information sharing in non-software centric organisations. Excel files are not only used for mathematical computation in financial institutions but also used for many othe purposes in an office work environment.

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


>>> import pyexcel as pe
>>> book = pe.load_book("your_file.xls")
>>> book.to_dict()
{"Sheet 1":[[1, 2, 3], ["4", "5", "6"]], "Sheet 2": [["a", "b", "c"], ["e", "f", "g"]], "Sheet 3":[[True, True, False]]}
>>> # access first sheet's top left cell
>>> print(book["Sheet 1"]["A1"])
>>> # alternative access to the same cell
>>> print(book["Sheet 1"][0,0])


Latest document is hosted at pyexcel@read the docs and latest stable version is hosted in pyexcel@pyhosted

Latest stable



You can install it via pip:

$ pip install pyexcel

or clone it and install it:

$ git clone
$ cd pyexcel
$ python install

Open Document Spreadsheet(ods) Support

In order to add ods support, please choose one of two packages: pyexcel-ods or pyexcel-ods3 . Please read individual installation instructions respectively. Here is the comparsion of two packages:

package python 2.6 python 2.7 python 3.3 python 3.4 lxml dependent
pyexcel-ods yes yes     no
pyexcel-ods3   yes yes yes yes

Plugin compatibility management

pyexcel ods ods3
v0.0.6 0.0.2 0.0.2
v0.0.4 0.0.1 0.0.1
v0.0.1 n/a n/a


Here is the test command:

pip install -r tests/requirements.txt
make test

On Windows, please use:


Test coverage is shown in . For more local test coverage, you can add –cover-html –cover-html-dir=your_file_directory to 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”.


Extension management code was copied from flask.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pyexcel, version 0.0.7
Filename, size File type Python version Upload date Hashes
Filename, size pyexcel-0.0.7.tar.gz (28.7 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page