Table/data-grid framework for Django
Project description
django-tables2 - An app for creating HTML tables
django-tables2 simplifies the task of turning sets of data into HTML tables. It has native support for pagination and sorting. It does for HTML tables what django.forms does for HTML forms. e.g.
Its features include:
Any iterable can be a data-source, but special support for Django querysets is included.
The builtin UI does not rely on JavaScript.
Support for automatic table generation based on a Django model.
Supports custom column functionality via subclassing.
Pagination.
Column based table sorting.
Template tag to enable trivial rendering to HTML.
Generic view mixin.
Example
Start by adding “django_tables2” to your INSTALLED_APPS setting like this:
INSTALLED_APPS = (
...,
'django_tables2',
)Creating a table for a model Simple is as simple as:
import django_tables2 as tables
class SimpleTable(tables.Table):
class Meta:
model = SimpleThis would then be used in a view:
def simple_list(request):
queryset = Simple.objects.all()
table = SimpleTable(queryset)
return render(request, 'simple_list.html', {'table': table})And finally in the template:
{% load django_tables2 %}
{% render_table table %}This example shows one of the simplest cases, but django-tables2 can do a lot more! Check out the _documentation: http://django-tables2.readthedocs.org/en/latest/ for more details.
Running the tests
With tox installed, you can run the test suite by typing tox. It will take care of installing the correct dependencies. During development, you might not want to wait for the tests to run in all environments. In that case, use the -e argument to specify an environment:
tox -e py27-1.9 to run the tests in python 2.7 with Django 1.9.
To generate a html coverage report:
PYTHONPATH=. py.test -s –cov=django_tables2 –cov-report html
Building the documentation
If you want to build the docs from within a virtualenv, and Sphinx is installed globally, use:
cd docs/ make html SPHINXBUILD=”python $(which sphinx-build)”
Publishing a release
Bump the version in django-tables2/__init__.py.
Update CHANGELOG.md.
Create a tag git tag -a v1.0.6 -m 'tagging v1.0.6'
Run python setup.py sdist upload --sign --identity=<your gpg identity>.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file django-tables2-1.1.6.tar.gz.
File metadata
- Download URL: django-tables2-1.1.6.tar.gz
- Upload date:
- Size: 979.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | bea279b44d5036a36d73e713955183df682be26c5701e9e35577ccee7929c995 |
|
| MD5 | a671074ae8e3201310c45095bc923bda |
|
| BLAKE2b-256 | cff776af516afb21097385c14123fe7093ddc5d9d6d992dc08cadd1ac63e3d36 |
