Reorganise the file structure into a project tree

app/eve_api/models/__init__.py

@@ -0,0 +1,26 @@
+"""
+By importing all of these sub-modules, the models package is transparently
+accessible by the rest of the project. This makes it act just as if it were
+one monolithic models.py.
+"""
+
+from django.db import models
+
+class EVEAPIModel(models.Model):
+    """
+    A simple abstract base class to set some consistent fields on the models
+    that are updated from the EVE API.
+    """
+    api_last_updated = models.DateTimeField(blank=True, null=True,
+                                            verbose_name="Time last updated from API",
+                                            help_text="When this object was last updated from the EVE API.")
+
+    class Meta:
+        abstract = True
+
+
+from static import *
+from account import *
+from character import *
+from corporation import *
+from alliance import *

app/eve_api/models/account.py

@@ -0,0 +1,38 @@
+from django.db import models
+from django.contrib.auth.models import User
+from eve_api.app_defines import *
+from eve_api.models import EVEAPIModel
+
+class EVEAccount(EVEAPIModel):
+    """
+    Use this class to store EVE user account information. Note that its use is
+    entirely optional and up to the developer's discretion.
+    """
+    user = models.ForeignKey(User, blank=True, null=True,
+                             help_text="User that owns this account")
+    description = models.CharField(max_length=50, blank=True,
+                                   help_text="User-provided description.")
+    api_key = models.CharField(max_length=64, verbose_name="API Key")
+    api_user_id = models.IntegerField(verbose_name="API User ID")
+    characters = models.ManyToManyField('eve_api.EVEPlayerCharacter', blank=True, null=True)
+    api_status = models.IntegerField(choices=API_STATUS_CHOICES,
+                                     default=API_STATUS_PENDING,
+                                     verbose_name="API Status",
+                                     help_text="End result of the last attempt at updating this object from the API.")
+    api_keytype = models.IntegerField(choices=API_KEYTYPE_CHOICES,
+                                     default=API_KEYTYPE_UNKNOWN,
+                                     verbose_name="API Key Type",
+                                     help_text="Type of API key")
+
+    def __unicode__(self):
+        return u"%s" % self.id
+
+    def in_corp(self, corpid):
+        return self.character.filter(corporation__id=corpid).count()
+
+    class Meta:
+        app_label = 'eve_api'
+        verbose_name = 'EVE Account'
+        verbose_name_plural = 'EVE Accounts'
+        ordering = ['api_user_id']
+

app/eve_api/models/alliance.py

@@ -0,0 +1,27 @@
+from django.db import models
+from django.contrib.auth.models import Group
+from eve_api.models import EVEAPIModel
+
+class EVEPlayerAlliance(EVEAPIModel):
+    """
+    Represents a player-controlled alliance. Updated from the alliance
+    EVE XML API puller at intervals.
+    """
+    name = models.CharField(max_length=255, blank=True, null=False)
+    ticker = models.CharField(max_length=15, blank=True, null=False)
+    executor = models.ForeignKey('eve_api.EVEPlayerCorporation', blank=True, null=True)
+    member_count = models.IntegerField(blank=True, null=True)
+    date_founded = models.DateField(blank=True, null=True)
+    group = models.ForeignKey(Group, blank=True, null=True)
+
+    class Meta:
+        app_label = 'eve_api'
+        ordering = ['date_founded']
+        verbose_name = 'Player Alliance'
+        verbose_name_plural = 'Player Alliances'
+
+    def __unicode__(self):
+        if self.name:
+            return self.name
+        else:
+            return "(#%d)" % self.id

app/eve_api/models/character.py

@@ -0,0 +1,64 @@
+from django.db import models
+from eve_api.app_defines import *
+from eve_api.models import EVEAPIModel
+
+
+class EVEPlayerCharacter(EVEAPIModel):
+    """
+    Represents an individual player character within the game. Not to be
+    confused with an account.
+    """
+    name = models.CharField(max_length=255, blank=True, null=False)
+    corporation = models.ForeignKey('eve_api.EVEPlayerCorporation', blank=True, null=True)
+    corporation_date = models.DateTimeField(blank=True, null=True, verbose_name="Corporation Join Date")
+    race = models.IntegerField(blank=True, null=True, choices=API_RACES_CHOICES)
+    gender = models.IntegerField(blank=True, null=True, choices=API_GENDER_CHOICES)
+    balance = models.FloatField("Account Balance", blank=True, null=True)
+    attrib_intelligence = models.IntegerField("Intelligence", blank=True, null=True)
+    attrib_memory = models.IntegerField("Memory", blank=True, null=True)
+    attrib_charisma = models.IntegerField("Charisma", blank=True, null=True)
+    attrib_perception = models.IntegerField("Perception", blank=True, null=True)
+    attrib_willpower = models.IntegerField("Willpower", blank=True, null=True)
+    total_sp = models.IntegerField("Total SP", blank=True, null=True)
+    security_status = models.FloatField("Security Status", blank=True, null=True)
+    current_location_id = models.IntegerField("Current Location ID", blank=True, null=True)
+    last_login = models.DateTimeField(blank=True, null=True,
+                                            verbose_name="Last Login Date/Time",
+                                            help_text="The last time this character logged into EVE")
+    last_logoff = models.DateTimeField(blank=True, null=True, verbose_name="Last Logoff Date/Time",
+                                            help_text="The last time this character logged off EVE")
+    director = models.BooleanField(blank=False, default=False, verbose_name="Director",
+                                            help_text="This character is a Director of the associated corporation")
+    roles = models.ManyToManyField('eve_api.EVEPlayerCharacterRole', blank=True, null=True,
+                                            help_text="Roles associated with this character")
+    skills = models.ManyToManyField('eve_api.EVESkill', through='eve_api.EVEPlayerCharacterSkill')
+    
+    def __unicode__(self):
+        if self.name:
+            return self.name
+        else:
+            return u"(%d)" % self.id
+
+    class Meta:
+        app_label = 'eve_api'
+        verbose_name = 'Player Character'
+        verbose_name_plural = 'Player Characters'
+
+
+class EVEPlayerCharacterSkill(models.Model):
+    """
+    For our m2m join to EVESkills
+    """
+    character = models.ForeignKey('eve_api.EVEPlayerCharacter')
+    skill = models.ForeignKey('eve_api.EVESkill')
+    level = models.IntegerField(default=0)
+    skillpoints = models.IntegerField(default=0)
+
+    def __unicode__(self):
+        return u"%s - Level %s" % (self.skill, self.level)
+
+    class Meta:
+        app_label = 'eve_api'
+        verbose_name = 'Player Character Skill'
+        verbose_name_plural = 'Player Character Skills'
+

app/eve_api/models/corporation.py

@@ -0,0 +1,43 @@
+from django.db import models
+from django.contrib.auth.models import Group
+from eve_api.models import EVEAPIModel
+
+class EVEPlayerCorporation(EVEAPIModel):
+    """
+    Represents a player-controlled corporation. Updated from a mixture of
+    the alliance and corporation API pullers.
+    """
+    name = models.CharField(max_length=255, blank=True, null=True)
+    ticker = models.CharField(max_length=15, blank=True, null=True)
+    description = models.TextField(blank=True, null=True)
+    url = models.URLField(verify_exists=False, blank=True, null=True)
+    ceo_character = models.ForeignKey('eve_api.EVEPlayerCharacter', blank=True, null=True)
+    alliance = models.ForeignKey('eve_api.EVEPlayerAlliance', blank=True, null=True)
+    alliance_join_date = models.DateField(blank=True, null=True)
+    tax_rate = models.FloatField(blank=True, null=True)
+    member_count = models.IntegerField(blank=True, null=True)
+    shares = models.IntegerField(blank=True, null=True)
+
+    # Logo generation stuff
+    logo_graphic_id = models.IntegerField(blank=True, null=True)
+    logo_shape1 = models.IntegerField(blank=True, null=True)
+    logo_shape2 = models.IntegerField(blank=True, null=True)
+    logo_shape3 = models.IntegerField(blank=True, null=True)
+    logo_color1 = models.IntegerField(blank=True, null=True)
+    logo_color2 = models.IntegerField(blank=True, null=True)
+    logo_color3 = models.IntegerField(blank=True, null=True)
+
+    group = models.ForeignKey(Group, blank=True, null=True)
+    applications = models.BooleanField(blank=False, default=False)
+
+    class Meta:
+        app_label = 'eve_api'
+        verbose_name = 'Player Corporation'
+        verbose_name_plural = 'Player Corporations'
+
+    def __str__(self):
+        if self.name:
+            return self.name
+        else:
+            return "Corp #%d" % self.id
+

app/eve_api/models/static.py

@@ -0,0 +1,64 @@
+"""
+This file covers any static information from the EVE data dumps. While
+using django-evedb would be a smarter choice, for the limited subset of
+data we're using it isn't worth the overhead
+"""
+
+from django.db import models
+
+
+class EVESkill(models.Model):
+    """ Represents a skill in EVE Online """
+
+    name = models.CharField(blank=True, max_length=255)
+    group = models.ForeignKey('eve_api.EVESkillGroup', null=True)
+    description = models.TextField(blank=True)    
+
+    def __unicode__(self):
+        if self.name:
+            return self.name
+        else:
+            return u"Skill %d" % self.id
+
+    class Meta:
+        app_label = 'eve_api'
+        verbose_name = 'Character Skill'
+        verbose_name_plural = 'Character Skills'
+
+
+class EVESkillGroup(models.Model):
+    """ Represents a skill group in EVE Online """
+
+    name = models.CharField(blank=True, max_length=255)
+
+    def __unicode__(self):
+        if self.name:
+            return self.name
+        else:
+            return u"Skill Group %d" % self.id
+
+    class Meta:
+        app_label = 'eve_api'
+        verbose_name = 'Character Skill Group'
+        verbose_name_plural = 'Character Skill Groups'
+
+
+class EVEPlayerCharacterRole(models.Model):
+    """
+    Represents a role which can be applied to a character
+    """
+
+    roleid = models.CharField(max_length=64, blank=False, null=False)
+    name = models.CharField(max_length=255, blank=False, null=False)
+
+    def __unicode__(self):
+        if self.name:
+            return self.name
+        else:
+            return u"Role %d" % self.id
+
+    class Meta:
+        app_label = 'eve_api'
+        verbose_name = 'Character Role'
+        verbose_name_plural = 'Character Roles'
+