An automated slug field for Django.
Project description
django-autoslug
===============
Django-autoslug is a reusable Django application that provides an improved
slug field which can automatically:
a) populate itself from another field,
b) preserve uniqueness of the value and
c) use custom `slugify()` functions for better i18n.
Examples
--------
A simple example::
from django.db.models import CharField, Model
from autoslug import AutoSlugField
class Article(Model):
title = CharField(max_length=200)
slug = AutoSlugField(populate_from='title')
More complex example::
from django.db.models import CharField, DateField, ForeignKey, Model
from django.contrib.auth.models import User
from autoslug import AutoSlugField
class Article(Model):
title = CharField(max_length=200)
pub_date = DateField(auto_now_add=True)
author = ForeignKey(User)
slug = AutoSlugField(populate_from=lambda instance: instance.title,
unique_with=['author__name', 'pub_date__month'],
slugify=lambda value: value.replace(' ','-'))
Documentation
-------------
See complete `HTML documentation <http://packages.python.org/django-autoslug/>`_
for details. Sometimes it may get slightly outdated. You can always have the
latest snapsnot by building it from the source (using Sphinx).
Community
---------
This application was initially created by Andy Mikhailenko and then improved
by other developers. They are listed in :file:`AUTHORS`.
Please feel free to file issues and/or submit patches.
See :file:`CONTRIBUTING` for hints related to the preferred workflow.
Licensing
---------
Django-autoslug is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public License as
published by the Free Software Foundation; either version 3 of the
License, or (at your option) any later version.
Django-autoslug is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this program; see the file COPYING.LESSER. If not,
see `GNU licenses <http://gnu.org/licenses/>`_.
===============
Django-autoslug is a reusable Django application that provides an improved
slug field which can automatically:
a) populate itself from another field,
b) preserve uniqueness of the value and
c) use custom `slugify()` functions for better i18n.
Examples
--------
A simple example::
from django.db.models import CharField, Model
from autoslug import AutoSlugField
class Article(Model):
title = CharField(max_length=200)
slug = AutoSlugField(populate_from='title')
More complex example::
from django.db.models import CharField, DateField, ForeignKey, Model
from django.contrib.auth.models import User
from autoslug import AutoSlugField
class Article(Model):
title = CharField(max_length=200)
pub_date = DateField(auto_now_add=True)
author = ForeignKey(User)
slug = AutoSlugField(populate_from=lambda instance: instance.title,
unique_with=['author__name', 'pub_date__month'],
slugify=lambda value: value.replace(' ','-'))
Documentation
-------------
See complete `HTML documentation <http://packages.python.org/django-autoslug/>`_
for details. Sometimes it may get slightly outdated. You can always have the
latest snapsnot by building it from the source (using Sphinx).
Community
---------
This application was initially created by Andy Mikhailenko and then improved
by other developers. They are listed in :file:`AUTHORS`.
Please feel free to file issues and/or submit patches.
See :file:`CONTRIBUTING` for hints related to the preferred workflow.
Licensing
---------
Django-autoslug is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public License as
published by the Free Software Foundation; either version 3 of the
License, or (at your option) any later version.
Django-autoslug is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this program; see the file COPYING.LESSER. If not,
see `GNU licenses <http://gnu.org/licenses/>`_.
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
django-autoslug-1.5.0.tar.gz
(9.2 kB
view details)
File details
Details for the file django-autoslug-1.5.0.tar.gz.
File metadata
- Download URL: django-autoslug-1.5.0.tar.gz
- Upload date:
- Size: 9.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 25ab05ab02cf68a64f5347195ccfcd5b85bbccec7ccad122e09b618e7959f8be |
|
| MD5 | afc783965ec2e7c0bac7a4ab2a4864b4 |
|
| BLAKE2b-256 | a9c7b960475d896e325260ba1ff6097195420def28fcfff9ae44d28de623c1f6 |
