mirror of
https://github.com/kennethreitz/tablib.git
synced 2026-06-05 23:10:17 +00:00
Jon Dufresne
f7b3fd4601
The platform is not tested on Travis and it fails to run with:
Processing ./.tox/dist/tablib-0.12.1.zip
Collecting odfpy (from tablib==0.12.1)
Collecting openpyxl>=2.4.0 (from tablib==0.12.1)
Collecting backports.csv (from tablib==0.12.1)
Using cached https://files.pythonhosted.org/packages/71/f7/5db9136de67021a6dce4eefbe50d46aa043e59ebb11c83d4ecfeb47b686e/backports.csv-1.0.6-py2.py3-none-any.whl
Collecting xlrd (from tablib==0.12.1)
Using cached https://files.pythonhosted.org/packages/b0/16/63576a1a001752e34bf8ea62e367997530dc553b689356b9879339cf45a4/xlrd-1.2.0-py2.py3-none-any.whl
Collecting xlwt (from tablib==0.12.1)
Using cached https://files.pythonhosted.org/packages/44/48/def306413b25c3d01753603b1a222a011b8621aed27cd7f89cbc27e6b0f4/xlwt-1.3.0-py2.py3-none-any.whl
Collecting pyyaml (from tablib==0.12.1)
Collecting pandas (from tablib==0.12.1)
Using cached https://files.pythonhosted.org/packages/81/fd/b1f17f7dc914047cd1df9d6813b944ee446973baafe8106e4458bfb68884/pandas-0.24.1.tar.gz
Complete output from command python setup.py egg_info:
Traceback (most recent call last):
File "<module>", line 1, in <module>
File "/tmp/pip-install-F5lmAg/pandas/setup.py", line 732, in <module>
ext_modules=maybe_cythonize(extensions, compiler_directives=directives),
File "/tmp/pip-install-F5lmAg/pandas/setup.py", line 475, in maybe_cythonize
numpy_incl = pkg_resources.resource_filename('numpy', 'core/include')
File "tablib/.tox/pypy/site-packages/pkg_resources/__init__.py", line 1144, in resource_filename
return get_provider(package_or_requirement).get_resource_filename(
File "tablib/.tox/pypy/site-packages/pkg_resources/__init__.py", line 361, in get_provider
__import__(moduleOrReq)
ImportError: No module named numpy
----------------------------------------
Command "python setup.py egg_info" failed with error code 1 in /tmp/pip-install-F5lmAg/pandas/
92 lines
2.8 KiB
ReStructuredText
92 lines
2.8 KiB
ReStructuredText
.. _intro:
|
|
|
|
Introduction
|
|
============
|
|
|
|
This part of the documentation covers all the interfaces of Tablib.
|
|
Tablib is a format-agnostic tabular dataset library, written in Python.
|
|
It allows you to Pythonically import, export, and manipulate tabular data sets.
|
|
Advanced features include, segregation, dynamic columns, tags / filtering, and
|
|
seamless format import/export.
|
|
|
|
|
|
Philosophy
|
|
---------
|
|
|
|
Tablib was developed with a few :pep:`20` idioms in mind.
|
|
|
|
|
|
#. Beautiful is better than ugly.
|
|
#. Explicit is better than implicit.
|
|
#. Simple is better than complex.
|
|
#. Complex is better than complicated.
|
|
#. Readability counts.
|
|
|
|
All contributions to Tablib should keep these important rules in mind.
|
|
|
|
.. mit:
|
|
|
|
MIT License
|
|
-----------
|
|
|
|
A large number of open source projects you find today are `GPL Licensed`_.
|
|
While the GPL has its time and place, it should most certainly not be your
|
|
go-to license for your next open source project.
|
|
|
|
A project that is released as GPL cannot be used in any commercial product
|
|
without the product itself also being offered as open source. The MIT, BSD, and
|
|
ISC licenses are great alternatives to the GPL that allow your open-source
|
|
software to be used in proprietary, closed-source software.
|
|
|
|
Tablib is released under terms of `The MIT License`_.
|
|
|
|
.. _`GPL Licensed`: http://www.opensource.org/licenses/gpl-license.php
|
|
.. _`The MIT License`: http://www.opensource.org/licenses/mit-license.php
|
|
|
|
|
|
.. _license:
|
|
|
|
Tablib License
|
|
--------------
|
|
|
|
Copyright 2017 Kenneth Reitz
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
in the Software without restriction, including without limitation the rights
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included in
|
|
all copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
THE SOFTWARE.
|
|
|
|
|
|
.. _pythonsupport:
|
|
|
|
Pythons Supported
|
|
-----------------
|
|
|
|
At this time, the following Python platforms are officially supported:
|
|
|
|
* cPython 2.7
|
|
* cPython 3.3
|
|
* cPython 3.4
|
|
* cPython 3.5
|
|
* cPython 3.6
|
|
|
|
Support for other Pythons will be rolled out soon.
|
|
|
|
|
|
|
|
|
|
Now, go :ref:`Install Tablib <install>`.
|