mirror of
https://github.com/kennethreitz/tablib.git
synced 2026-06-05 23:10:17 +00:00
Jean Jordaan
a4f974287b
I fixed some extra commas, missing apostrophes, and typos; added some linebreaks between sentences for very long lines; added explicit markup for console blocks, got rid of some tabs, fixed indentation of an admonition, and some more small tweaks. This supersedes https://github.com/kennethreitz/tablib/pull/84
110 lines
2.7 KiB
ReStructuredText
110 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'])
|
|
>>> map(data.append, [('Kenneth', 'Reitz', 22), ('Bessie', 'Monke', 21)])
|
|
|
|
>>> 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
|
|
<redacted 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
|