|Generated:||December 05, 2013|
OpenPyxl is a Python library to read/write Excel 2007 xlsx/xlsm files.
It was born from lack of existing library to read/write natively from Python the new Open Office XML format.
All kudos to the PHPExcel team as openpyxl is a Python port of PHPExcel http://www.phpexcel.net/
Any help will be greatly appreciated, just follow those steps:
- Please start a new fork (https://bitbucket.org/ericgazoni/openpyxl/fork) for each independant feature, don’t try to fix all problems at the same time, it’s easier for those who will review and merge your changes ;-)
- Hack hack hack
- Don’t forget to add unit tests for your changes ! (YES, even if it’s a one-liner, or there is a high probability your work will not be taken into consideration). There are plenty of examples in the /test directory if you lack know-how or inspiration.
- If you added a whole new feature, or just improved something, you can be proud of it, so add yourself to the AUTHORS file :-)
- Let people know about the shiny thing you just implemented, update the docs !
- When it’s done, just issue a pull request (click on the large “pull request” button on your repository) and wait for your code to be reviewed, and, if you followed all theses steps, merged into the main repository.
This is an open-source project, maintained by volunteers on their spare time, so while we try to work on this project as often as possible, sometimes life gets in the way. Please be patient.
There are several ways to contribute, even if you can’t code (or can’t code well):
The best method to install openpyxl is using a PyPi client such as easy_install (setuptools) or pip:
$ pip install openpyxl
$ easy_install install openpyxl
To install from sources (there is nothing to build, openpyxl is 100% pure Python), you can download an archive from bitbucket (look in the “tags” tab).
After extracting the archive, you can do:
$ python setup.py install
To be able to include images (jpeg,png,bmp,...) into an openpyxl file, you will also need the ‘PIL’ library that can be installed with:
$ pip install pillow
or browse https://pypi.python.org/pypi/Pillow/, pick the latest version and head to the bottom of the page for Windows binaries.
Source code is hosted on bitbucket.org. You can get it using a Mercurial client and the following URLs:
- $ hg clone https://bitbucket.org/ericgazoni/openpyxl -r 1.8.0
or to get the latest development version:
- $ hg clone https://bitbucket.org/ericgazoni/openpyxl