<filename>shortwave/models.py
from django.db import models
from django.contrib.auth.models import User
from django.utils.translation import ugettext_lazy as _

from shortwave import forms


# Fields.

class CommandTriggerField(models.CharField):
    """
    Model field for a Shortwave command trigger.

    Uses the `shortwave.forms.CommandTriggerField`.

    """

    description = _(u'Shortwave command trigger')

    def __init__(self, *args, **kwargs):
        kwargs['max_length'] = kwargs.get('max_length', 10)
        models.CharField.__init__(self, *args, **kwargs)

    def formfield(self, **kwargs):
        defaults = {'form_class': forms.CommandTriggerField}
        defaults.update(kwargs)
        return super(CommandTriggerField, self).formfield(**defaults)


# Managers.

class WaveManager(models.Manager):
    """A custom manager for Wave objects."""

    def active(self):
        """Returns only waves for active users."""
        return self.get_query_set().filter(user__is_active=True)


# Models.

class Wave(models.Model):
    """A collection of commands relating to a user."""

    user = models.OneToOneField(User, verbose_name=_(u'user'),
        limit_choices_to={'is_active': True})
    kill_defaults = models.BooleanField(_(u'kill default commands'),
        help_text=_(u'Select to remove all default Shortwave commands.'))

    objects = WaveManager()

    class Meta:
        ordering = ('user', )
        verbose_name = _(u'wave')
        verbose_name_plural = _(u'waves')

    def __unicode__(self):
        return "%s" % self.user

    @models.permalink
    def get_absolute_url(self):
        return ('shortwave_wave_detail', (), {'username': self.user})


class Command(models.Model):
    """A Shortwave command."""

    wave = models.ForeignKey(Wave, verbose_name=_(u'wave'),
        limit_choices_to={'user__is_active': True}, related_name='commands')
    trigger = CommandTriggerField(_(u'trigger'))
    url = models.CharField(_(u'URL'), max_length=255)
    description = models.CharField(_(u'description'), max_length=75)

    class Meta:
        ordering = ('trigger', 'wave')
        unique_together = ('trigger', 'wave')
        verbose_name = _(u'command')
        verbose_name_plural = _(u'commands')

    def __unicode__(self):
        return "%s (%s)" % (self.description, self.trigger)

<filename>shortwave/models.py
from django.db import models
from django.contrib.auth.models import User
from django.utils.translation import ugettext_lazy as _

from shortwave import forms


# Fields.

class CommandTriggerField(models.CharField):
    """
    Model field for a Shortwave command trigger.

    Uses the `shortwave.forms.CommandTriggerField`.

    """

    description = _(u'Shortwave command trigger')

    def __init__(self, *args, **kwargs):
        kwargs['max_length'] = kwargs.get('max_length', 10)
        models.CharField.__init__(self, *args, **kwargs)

    def formfield(self, **kwargs):
        defaults = {'form_class': forms.CommandTriggerField}
        defaults.update(kwargs)
        return super(CommandTriggerField, self).formfield(**defaults)


# Managers.

class WaveManager(models.Manager):
    """A custom manager for Wave objects."""

    def active(self):
        """Returns only waves for active users."""
        return self.get_query_set().filter(user__is_active=True)


# Models.

class Wave(models.Model):
    """A collection of commands relating to a user."""

    user = models.OneToOneField(User, verbose_name=_(u'user'),
        limit_choices_to={'is_active': True})
    kill_defaults = models.BooleanField(_(u'kill default commands'),
        help_text=_(u'Select to remove all default Shortwave commands.'))

    objects = WaveManager()

    class Meta:
        ordering = ('user', )
        verbose_name = _(u'wave')
        verbose_name_plural = _(u'waves')

    def __unicode__(self):
        return "%s" % self.user

    @models.permalink
    def get_absolute_url(self):
        return ('shortwave_wave_detail', (), {'username': self.user})


class Command(models.Model):
    """A Shortwave command."""

    wave = models.ForeignKey(Wave, verbose_name=_(u'wave'),
        limit_choices_to={'user__is_active': True}, related_name='commands')
    trigger = CommandTriggerField(_(u'trigger'))
    url = models.CharField(_(u'URL'), max_length=255)
    description = models.CharField(_(u'description'), max_length=75)

    class Meta:
        ordering = ('trigger', 'wave')
        unique_together = ('trigger', 'wave')
        verbose_name = _(u'command')
        verbose_name_plural = _(u'commands')

    def __unicode__(self):
        return "%s (%s)" % (self.description, self.trigger)

# Fields. Model field for a Shortwave command trigger.      Uses the `shortwave.forms.CommandTriggerField`. # Managers. A custom manager for Wave objects. Returns only waves for active users. # Models. A collection of commands relating to a user. A Shortwave command.