Skip to main content

Utility to ease reading data from tabular data files

Project description

==========
Tab Import
==========

Tab Import is a Python utility to ease imports of tabular data from CSV, ODF,
XLS or XLSX files.

Some formats require an external Python library:

* ODF: ooolib
* XLS/XLSX: xlrd

This library is meant to be used inside a Django project context.

Usage::

#!/usr/bin/env python

import tabimport

smart_file = tabimport.FileFactory(file_path)
for data_line in smart_file:
do_something_with(data_line['header'])

Import helper
=============

To use the Django import helper in your Django project, follow the steps below.

1. Add 'tabimport' into your INSTALLED_APPS setting.

2. Include the urls of tabimport into your urls::

url(r'^data-import/', include('tabimport.urls')),

3. In any of your models for which you'd like to enable data import, set a
class variable like this: ``support_tabimport = True``.

4. You can then link to the tabimport utility from one of your templates by
reversing a url with ``tabimport``::

<a href="{% url 'tabimport' %}">Import utility</a>

Alternatively, your models can include a class method which will receive the
imported data as a dictionary just before they are used to create a new
instance. This allows you to handle special cases in imported data::

@classmethod
def prepare_import(cls, values):
return values

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

TabImport-0.4.0.tar.gz (8.4 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page