Registry / web-framework / django-eveuniverse

django-eveuniverse

JSON →
library2.0.0pypypi✓ verified 85d ago

Django Eve Universe provides a complete set of Eve Universe models, allowing easy access to EVE Online universe data fetched on-demand from ESI. It enables storing, caching, and updating critical EVE Online static data within a Django project. The current version is 1.6.1, and it maintains an active release cadence with regular updates and bug fixes.

pip install django-eveuniverse
INSTALL
IMPORT
SIG · DJANGO-EVEUNIVERSE
D
django-eveuniverse
web-frameworkpythonv2.0.0
Install
13.7s avg
Import
Disk
148MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v2.0.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.103.910 runs
installs and imports cleanly · install 0.0s · import 0.000s · 149.2MB
glibc
py 3.103.910 runs
installs and imports cleanly · install 13.7s · import 0.000s · 159MB
148MB installed
● package 148MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

default_app_config
from eveuniverse import default_app_config
from eveuniverse.models import EveType

This quickstart demonstrates basic retrieval of Eve Universe models like `EveType`. After installing `django-eveuniverse` and adding 'eveuniverse' to `INSTALLED_APPS`, you must run `python manage.py migrate` and then `python manage.py eveuniverse_load_data` to populate your database with universe entities. The `EVEUNIVERSE_DATA_SOURCES` setting in your Django `settings.py` determines which entities are loaded.

import os import django from django.conf import settings # Minimal Django setup for quickstart demonstration # In a real Django project, this setup is handled by manage.py if not settings.configured: settings.configure( INSTALLED_APPS=['django.contrib.sites', 'eveuniverse'], DATABASES={'default': {'ENGINE': 'django.db.backends.sqlite3', 'NAME': ':memory:'}}, SITE_ID=1, EVEUNIVERSE_DATA_SOURCES={ # Configure at least one source for data loading 'eveuniverse.EveType': {'priority': 100, 'enabled': True} } ) django.setup() from eveuniverse.models import EveType # In a real setup, you would run 'python manage.py migrate' # and then 'python manage.py eveuniverse_load_data' to populate the database. # For this quickstart, we assume data is already present. try: # Example: Retrieve 'Tritanium' (a common EVE mineral) tritanium = EveType.objects.get(name='Tritanium') print(f"Found Tritanium: ID {tritanium.id}, Group: {tritanium.eve_group.name if tritanium.eve_group else 'N/A'}") # Example: Retrieve 'Jita' solar system (which is an EveType) jita_system_id = 30000142 jita_system = EveType.objects.get(id=jita_system_id) print(f"Found Jita system: {jita_system.name}") except EveType.DoesNotExist: print("One or more Eve Types not found. Ensure you have run 'python manage.py eveuniverse_load_data' after setup.") except Exception as e: print(f"An error occurred: {e}")
Debug
Known issues
breakingMajor breaking changes were introduced in version 1.0. The `EveEntity` model was renamed to `EveUniverseEntity`, and the `EveUniverseEntity` mixin was renamed to `EveUniverseEntityModel`.
fix
Update all references to `EveEntity` to `EveUniverseEntity` and `EveUniverseEntity` (mixin) to `EveUniverseEntityModel` in your code. Review the v1.0 migration guide for full details.
affects: <1.0
gotchaData for Eve Universe entities (types, groups, systems, etc.) is not automatically loaded upon installation. You must configure `EVEUNIVERSE_DATA_SOURCES` in your Django settings and then run the management command `python manage.py eveuniverse_load_data`.
fix
Add `EVEUNIVERSE_DATA_SOURCES` to your `settings.py` with the entities you need (e.g., `{'eveuniverse.EveType': {'priority': 100, 'enabled': True}}`), then execute `python manage.py eveuniverse_load_data` to populate the database. Consider setting this up as a recurring task if data needs to be kept fresh.
affects: All
gotchaEnsure your Django version meets the minimum requirement. `django-eveuniverse` v1.x requires Django >=3.2. Older versions had different compatibility requirements.
fix
Check `setup.py` or PyPI for the exact Django version requirements for the `django-eveuniverse` version you are using. Upgrade Django if necessary, or install an older compatible version of `django-eveuniverse`.
affects: All
Upgrade
Version history
2.0.0latest on PyPI · released May 21, 2026
Audit
Dependencies
DjangorequiredCore framework dependency, requires >=3.2
django-esirequiredUsed for fetching data from EVE Online's ESI API, requires >=2.0.0
Agent activity
11 hits · last 30 days
node
10
Resources
django-eveuniverse — pip install django-eveuniverse · libregistry