mirror of
https://github.com/kennethreitz/tablib.git
synced 2026-06-05 23:10:17 +00:00
Kenneth Reitz
87 lines
2.3 KiB
ReStructuredText
87 lines
2.3 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.
|
|
|
|
|
|
Philosphy
|
|
---------
|
|
|
|
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.
|
|
|
|
.. _apache:
|
|
|
|
Apache License v2
|
|
-----------------
|
|
|
|
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 Apache License v2`_.
|
|
|
|
.. _`GPL Licensed`: http://www.opensource.org/licenses/gpl-license.php
|
|
.. _`The Apache License v2`: http://opensource.org/licenses/Apache-2.0
|
|
|
|
|
|
.. _license:
|
|
|
|
Tablib License
|
|
--------------
|
|
|
|
Copyright 2011 Kenneth Reitz
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
|
|
|
|
.. _pythonsupport:
|
|
|
|
Pythons Supported
|
|
-----------------
|
|
|
|
At this time, the following Python platforms are officially supported:
|
|
|
|
* cPython 2.5
|
|
* cPython 2.6
|
|
* cPython 2.7
|
|
* cPython 3.1
|
|
* cPython 3.2
|
|
* PyPy-c 1.4
|
|
* PyPy-c 1.5
|
|
|
|
Support for other Pythons will be rolled out soon.
|
|
|
|
|
|
|
|
|
|
Now, go :ref:`Install Tablib <install>`. |