Django Tagulous - Fabulous Tags
A tagging library for Django. Built on ForeignKey and ManyToManyField to support tag strings as well as native ORM queries.
Use a SingleTagField as a CharField with dynamic choices, or a TagField for
conventional tagging or nested categorisation.
If you find this project useful, please do consider sponsoring development.
Features
- Easy to install - simple requirements, simple syntax, lots of options
- Based on ForeignKey and ManyToManyField, so it's easy to query
- Autocomplete support built in, if you want it
- Supports multiple independent fields on a single model
- Supports trees of nested tags, for detailed categorisation
- Admin support for managing tags and tagged models
Tested on Django 3.2 to 6.1, on Python 3.10+.
See the Documentation for details of how Tagulous works; in particular:
- Installation - how to install Tagulous
- Example Usage - see examples of Tagulous in use
- Upgrading - how to upgrade Tagulous, and see what has changed in the changelog
- Contributing - for how to contribute to Tagulous
Quickstart
Install with pip install django-tagulous, add django_tagulous to Django's INSTALLED_APPS
and
define the serializers,
then start adding tag fields to your model:
from django.db import models
from django_tagulous.models import SingleTagField, TagField
class Person(models.Model):
name = models.CharField(max_length=255)
title = SingleTagField(initial="Mr, Mrs, Miss, Ms")
skills = TagField()
You can now set and get them using strings, lists or querysets:
myperson = Person.objects.create(name='Bob', title='Mr', skills='run, hop')
# myperson.skills == 'run, hop'
myperson.skills = ['jump', 'kung fu']
myperson.save()
# myperson.skills == 'jump, "kung fu"'
runners = Person.objects.filter(skills='run')
Behind the scenes each tag field is a ForeignKey or ManyToManyField relationship to
a separate model (by default), so more complex queries are simple:
qs = MyRelatedModel.objects.filter(
person__skills__name__in=['run', 'jump'],
)
As well as this you also get autocompletion in public and admin forms, automatic slug generation, unicode support, you can build tag clouds easily, and can nest tags for more complex categorisation.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file django_tagulous-2.2.1.tar.gz.
File metadata
- Download URL: django_tagulous-2.2.1.tar.gz
- Upload date:
- Size: 306.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
561827e9b5a6f56c4810daf63209ad8253314fe2f1e8f396855436b94c04b20b
|
|
| MD5 |
a316372db0b6b750d0d39da051b3d6b4
|
|
| BLAKE2b-256 |
3c5b9a9c2c30b040d0e30155174798ef29b7df01800559febc221b244e8ee272
|
Provenance
The following attestation bundles were made for django_tagulous-2.2.1.tar.gz:
Publisher:
pypi.yml on radiac/django-tagulous
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
django_tagulous-2.2.1.tar.gz -
Subject digest:
561827e9b5a6f56c4810daf63209ad8253314fe2f1e8f396855436b94c04b20b - Sigstore transparency entry: 2456709011
- Sigstore integration time:
-
Permalink:
radiac/django-tagulous@1303ca1e38a2dbcf34259fe732ed1ad8743a3b54 -
Branch / Tag:
refs/tags/v2.2.1 - Owner: https://github.com/radiac
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi.yml@1303ca1e38a2dbcf34259fe732ed1ad8743a3b54 -
Trigger Event:
push
-
Statement type:
File details
Details for the file django_tagulous-2.2.1-py3-none-any.whl.
File metadata
- Download URL: django_tagulous-2.2.1-py3-none-any.whl
- Upload date:
- Size: 294.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7b722e5e2bb159bb35897ee793ba83cd8a5b0c0f5bc2b5e2a8717c28bfb8a467
|
|
| MD5 |
38339b3412d712882be44d0ca7a75db6
|
|
| BLAKE2b-256 |
48767cf5cadaf8646c0a4a5bf63e4908dd663f35bf423f0626369c4dd08620d4
|
Provenance
The following attestation bundles were made for django_tagulous-2.2.1-py3-none-any.whl:
Publisher:
pypi.yml on radiac/django-tagulous
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
django_tagulous-2.2.1-py3-none-any.whl -
Subject digest:
7b722e5e2bb159bb35897ee793ba83cd8a5b0c0f5bc2b5e2a8717c28bfb8a467 - Sigstore transparency entry: 2456709761
- Sigstore integration time:
-
Permalink:
radiac/django-tagulous@1303ca1e38a2dbcf34259fe732ed1ad8743a3b54 -
Branch / Tag:
refs/tags/v2.2.1 - Owner: https://github.com/radiac
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi.yml@1303ca1e38a2dbcf34259fe732ed1ad8743a3b54 -
Trigger Event:
push
-
Statement type:
