update readme and classifiers

This commit is contained in:
chfw 2017-02-02 21:07:42 +00:00
parent 392e76e129
commit e9d2f09f3a
4 changed files with 25 additions and 20 deletions

View File

@ -8,6 +8,16 @@ ods format using python 2.6 and python 2.7. You are likely to use it with
does the same thing but supports Python 3.3 and 3.4 and depends on lxml.
{%endblock%}
{% block pagination_note%}
Special notice 30/01/2017: due to the constraints of the underlying 3rd party
library, it will read the whole file before returning the paginated data. So
at the end of day, the only benefit is less data returned from the reading
function. No major performance improvement will be seen.
With that said, please install `pyexcel-odsr <https://github.com/pyexcel/pyexcel-odsr>`_
and it gives better performance in reading partial ods files.
{%endblock%}
{%block extras %}
Credits
================================================================================

View File

@ -6,8 +6,3 @@
{%block compat_block%}
{%endblock%}
{%block additional_classifiers%}
'Programming Language :: Python :: 2.6',
'Programming Language :: Python :: 2.7'
{%endblock%}}

View File

@ -43,9 +43,6 @@ Usage
As a standalone library
--------------------------------------------------------------------------------
Write to an ods file
********************************************************************************
.. testcode::
:hide:
@ -62,6 +59,11 @@ Write to an ods file
... from collections import OrderedDict
Write to an ods file
********************************************************************************
Here's the sample code to write a dictionary to an ods file:
.. code-block:: python
@ -72,6 +74,7 @@ Here's the sample code to write a dictionary to an ods file:
>>> data.update({"Sheet 2": [["row 1", "row 2", "row 3"]]})
>>> save_data("your_file.ods", data)
Read from an ods file
********************************************************************************
@ -105,6 +108,7 @@ Here's the sample code to write a dictionary to an ods file:
Read from an ods from memory
********************************************************************************
@ -128,6 +132,9 @@ library, it will read the whole file before returning the paginated data. So
at the end of day, the only benefit is less data returned from the reading
function. No major performance improvement will be seen.
With that said, please install `pyexcel-odsr <https://github.com/pyexcel/pyexcel-odsr>`_
and it gives better performance in reading partial ods files.
Let's assume the following file is a huge ods file:
.. code-block:: python
@ -184,16 +191,6 @@ No longer, explicit import is needed since pyexcel version 0.2.2. Instead,
this library is auto-loaded. So if you want to read data in ods format,
installing it is enough.
Any version under pyexcel 0.2.2, you have to keep doing the following:
Import it in your file to enable this plugin:
.. code-block:: python
from pyexcel.ext import ods
Please note only pyexcel version 0.0.4+ support this.
Reading from an ods file
********************************************************************************
@ -203,7 +200,6 @@ Here is the sample code:
.. code-block:: python
>>> import pyexcel as pe
>>> # from pyexcel.ext import ods
>>> sheet = pe.get_book(file_name="your_file.ods")
>>> sheet
Sheet 1:
@ -274,6 +270,7 @@ You need to pass a StringIO instance to Writer:
>>> # In reality, you might give it to your http response
>>> # object for downloading
License
================================================================================

View File

@ -28,7 +28,10 @@ CLASSIFIERS = [
'License :: OSI Approved :: BSD License',
'Intended Audience :: Developers',
'Programming Language :: Python :: 2.6',
'Programming Language :: Python :: 2.7'
'Programming Language :: Python :: 2.7',
'Programming Language :: Python :: 3.4',
'Programming Language :: Python :: 3.5',
'Programming Language :: Python :: 3.6',
]
INSTALL_REQUIRES = [