mirror of
https://github.com/kennethreitz/tablib.git
synced 2026-06-05 15:00:19 +00:00
yarko
c5c2dffe42
map() is a function in python2, and iterator in python3+; In any case - map is inefficient compared to either comprehensions (most efficient), or simple loops (close second). SInce in this case, data.append() returns nothing, use a simple look. It is clearer, more efficient, and works with both python2 and python3
105 lines
2.7 KiB
ReStructuredText
105 lines
2.7 KiB
ReStructuredText
.. Tablib documentation master file, created by
|
|
sphinx-quickstart on Tue Oct 5 15:25:21 2010.
|
|
You can adapt this file completely to your liking, but it should at least
|
|
contain the root `toctree` directive.
|
|
|
|
Tablib: Pythonic Tabular Datasets
|
|
=================================
|
|
|
|
Release v\ |version|. (:ref:`Installation <install>`)
|
|
|
|
.. Contents:
|
|
..
|
|
.. .. toctree::
|
|
.. :maxdepth: 2
|
|
..
|
|
|
|
.. Indices and tables
|
|
.. ==================
|
|
..
|
|
.. * :ref:`genindex`
|
|
.. * :ref:`modindex`
|
|
.. * :ref:`search`
|
|
|
|
|
|
Tablib is an :ref:`MIT Licensed <mit>` format-agnostic tabular dataset library, written in Python. It allows you to import, export, and manipulate tabular data sets. Advanced features include, segregation, dynamic columns, tags & filtering, and seamless format import & export.
|
|
|
|
::
|
|
|
|
>>> data = tablib.Dataset(headers=['First Name', 'Last Name', 'Age'])
|
|
>>> for i in [('Kenneth', 'Reitz', 22), ('Bessie', 'Monke', 21)]:
|
|
... data.append(i)
|
|
|
|
|
|
>>> print data.json
|
|
[{"Last Name": "Reitz", "First Name": "Kenneth", "Age": 22}, {"Last Name": "Monke", "First Name": "Bessie", "Age": 21}]
|
|
|
|
>>> print data.yaml
|
|
- {Age: 22, First Name: Kenneth, Last Name: Reitz}
|
|
- {Age: 21, First Name: Bessie, Last Name: Monke}
|
|
|
|
>>> data.xlsx
|
|
<censored binary data>
|
|
|
|
|
|
Testimonials
|
|
------------
|
|
|
|
`National Geographic <http://www.nationalgeographic.com/>`_,
|
|
`Digg, Inc <http://digg.com/>`_,
|
|
`Northrop Grumman <http://www.northropgrumman.com/>`_,
|
|
`Discovery Channel <http://dsc.discovery.com/>`_,
|
|
and `The Sunlight Foundation <http://sunlightfoundation.com/>`_ use Tablib internally.
|
|
|
|
|
|
|
|
**Greg Thorton**
|
|
Tablib by @kennethreitz saved my life. I had to consolidate like 5 huge poorly maintained lists of domains and data. It was a breeze!
|
|
|
|
**Dave Coutts**
|
|
It's turning into one of my most used modules of 2010. You really hit a sweet spot for managing tabular data with a minimal amount of code and effort.
|
|
|
|
**Joshua Ourisman**
|
|
Tablib has made it so much easier to deal with the inevitable 'I want an Excel file!' requests from clients...
|
|
|
|
**Brad Montgomery**
|
|
I think you nailed the "Python Zen" with tablib. Thanks again for an awesome lib!
|
|
|
|
|
|
User's Guide
|
|
------------
|
|
|
|
This part of the documentation, which is mostly prose, begins with some background information about Tablib, then focuses on step-by-step instructions for getting the most out of your datasets.
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
intro
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
install
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
tutorial
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
development
|
|
|
|
|
|
API Reference
|
|
-------------
|
|
|
|
If you are looking for information on a specific function, class or
|
|
method, this part of the documentation is for you.
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
api
|