pyexcel 0.0.10

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

Known constraints

Fonts, colors and charts are not supported.

Available Plugins

Plugins	Supported file formats
pyexcel	csv, csvz, tsv, tsvz
pyexcel-xls	xls, xlsx(r), xlsm(r)
pyexcel-xlsx	xlsx
pyexcel-ods	ods (python 2.6, 2.7)
pyexcel-ods3	ods (python 2.7, 3.3, 3.4)
pyexcel-text	(write only)json, rst, mediawiki,latex, grid, pipe, orgtbl, plain simple

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

Installation of individual plugins , please refer to individual plugin page.

Usage

Here are some example codes:

>>> import pyexcel as pe
>>> import pyexcel.ext.xls # import it to be able handle xls file
>>> import pyexcel.ext.xlsx # import it to be able handle xlsx file
>>> sheet = pe.load("your_file.xls")
>>> sheet
Sheet Name: Sheet 1
+----------+----------+----------+
| 1        | 2        | 3        |
+----------+----------+----------+
| Column 1 | Column 2 | Column 3 |
+----------+----------+----------+
| 4        | 5        | 6        |
+----------+----------+----------+
>>> sheet["A1"]
1.0
>>> # format a row using a lambda function
>>> sheet.row.format(1, str, lambda value: str(value))
>>> sheet.column[0]
[1.0, 'Column 1', 4.0]
>>> sheet.row[2]
[4.0, 5.0, 6.0]
>>> sheet.name_columns_by_row(1)
>>> sheet.column["Column 1"]
[1.0, 4.0]
>>> sheet.save_as("myfile.csv")
>>> # load the whole excel file
>>> book = pe.load_book("your_file.xls")
>>> book
Sheet Name: Sheet 1
+----------+----------+----------+
| 1        | 2        | 3        |
+----------+----------+----------+
| Column 1 | Column 2 | Column 3 |
+----------+----------+----------+
| 4        | 5        | 6        |
+----------+----------+----------+
Sheet Name: Sheet 2
+---+---+---+-------+
| a | b | c | Row 1 |
+---+---+---+-------+
| e | f | g | Row 2 |
+---+---+---+-------+
| 1 | 2 | 3 | Row 3 |
+---+---+---+-------+
>>> # alternative access to the same cell on sheet 1
>>> print(book["Sheet 1"][0,0])
1.0
>>> book["Sheet 2"].name_rows_by_column(3)
>>> book["Sheet 2"].row["Row 3"]
[1.0, 2.0, 3.0]
>>> book.save_as("new_file.xlsx") # save a copy

Documentation

Documentation is hosted at read the docs and pyhosted

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”.

Acknowledgement

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

Extension management code was copied from flask.