Django snippets: Decouple 'help_text' attribute from field definition

# readable_models.py

from django.db.models.base import ModelBase as DjangoModelBase

class ModelBase(DjangoModelBase):
    ''' Decouples 'help_text' attribute from field definition. '''
    def __new__(cls, name, bases, attrs):
        help_text = attrs.pop('HelpText', None)
        new_cls = super(ModelBase, cls).__new__(cls, name, bases, attrs)
        if help_text:
            for field in new_cls._meta.fields:
                field.help_text = getattr(help_text, field.name, field.help_text)
        return new_cls

More like this

DRY Fieldsets by DrMeers 2 years, 8 months ago
Human readable file names decorator by maxk 10 months, 2 weeks ago
Modifying the fields of a third/existing model class by marinho 1 year, 1 month ago
Bind Administration by ashcrow 3 years, 5 months ago
Exists Filter OneToOneField in Admin by davidvaz 3 months ago

I found model definitions with large number of fields with long help_text unreadable and feel that help_text doesn't really belong to field definition. With this snippet help_text attributes can live outside field definitions in inner HelpText class so field definitions become shorter and more readable.

Usage:

from django.db import models
import readable_models

class MyModel(models.Model):
    __metaclass__ = readable_models.ModelBase

    name = models.CharField('Name', max_length=30)
    address = models.CharField('Address', max_length=255)
    # ... long list of fields

    class HelpText:
        name =  'The name ...'
        address = 'Example: <very verbose example is here>'

Author:: kmike
Posted:: August 30, 2010
Language:: Python
Django Version:: 1.2
Tags:: models help_text
Score:: 9 (after 9 ratings)

Django snippets

Decouple 'help_text' attribute from field definition

More like this

Tools

Comments

Snippets

About