Browse Apps

Sovereignty Timer

Sov Campaign Timer for Alliance Auth


AA Sovereignty Timer

Version License Python Django pre-commit pre-commit.ci status Code Style: black Automated Checks codecov Translation status Contributor Covenant Discord

ko-fi

Sovereignty campaign overview for Alliance Auth.

<hr /> <hr />

Screenshots

AA Sov Timer Dashboard

AA Sov Timer Dashboard

Installation

[!IMPORTANT]

Please make sure you meet all preconditions before you proceed.

  • AA Sovereignty Timer is a plugin for Alliance Auth. If you don't have Alliance Auth running already, please install it first before proceeding. (see the official AA installation guide for details)
  • AA Sovereignty Timer needs the app django-eveuniverse to function. Please make sure it is installed before continuing.

Bare Metal Installation

Step 1: Installing the App

Make sure you're in the virtual environment (venv) of your Alliance Auth installation. Then install the latest version:

pip install aa-sov-timer==3.2.1

Step 2: Update Your AA Settings

Configure your AA settings (local.py) as follows:

  • Add "eveuniverse", to INSTALLED_APPS if not already done for another app
  • Add "sovtimer", to INSTALLED_APPS
  • Add the Scheduled Task
# AA Sovereignty Timer - Run sovereignty related updates every 30 seconds
CELERYBEAT_SCHEDULE["sovtimer.tasks.run_sov_campaign_updates"] = {
    "task": "sovtimer.tasks.run_sov_campaign_updates",
    "schedule": 30,
}

Step 3: Finalizing the Installation

Copy static files and run migrations

python manage.py collectstatic
python manage.py migrate

Step 4: Preload Eve Universe Data

AA Sovereignty Timer uses Eve Universe data to map IDs to names for solar systems, regions and constellations. So you need to preload some data from ESI once. If you already have run this command, you can skip this step.

python manage.py eveuniverse_load_data map
python manage.py sovtimer_load_initial_data

Both commands might take a moment or two, so be patient ...

Step 5: Restart Supervisor

Once you have completed all previous steps, restart your AA supervisor service to apply the changes.

Continue with the Common Steps / Configuration below to finish the installation.

Docker Installation

Step 1: Add the App

Add the app to your conf/requirements.txt:

aa-sov-timer==3.2.1

Step 2: Update Your AA Settings

Configure your AA settings (conf/local.py) as follows:

  • Add "eveuniverse", to INSTALLED_APPS if not already done for another app
  • Add "sovtimer", to INSTALLED_APPS
  • Add the Scheduled Task
# AA Sovereignty Timer - Run sovereignty related updates every 30 seconds
CELERYBEAT_SCHEDULE["sovtimer.tasks.run_sov_campaign_updates"] = {
    "task": "sovtimer.tasks.run_sov_campaign_updates",
    "schedule": 30,
}

Step 3: Build Auth and Restart Your Containers

docker compose build --no-cache
docker compose --env-file=.env up -d

Step 4: Finalizing the Installation

Run migrations, copy static files and load EVE universe data:

docker compose exec allianceauth_gunicorn bash

auth collectstatic
auth migrate

auth eveuniverse_load_data map
auth sovtimer_load_initial_data

Continue with the Common Steps / Configuration below to finish the installation.

Common Steps / Configuration

(Optional) Allow Public Views

This app supports AA's feature of public views. \ To allow this feature, please add "sovtimer",, to the list of APPS_WITH_PUBLIC_VIEWS in your local.py or conf/local.py for Docker:

APPS_WITH_PUBLIC_VIEWS = [
    "sovtimer",
]

[!NOTE]

If you don't have a list for APPS_WITH_PUBLIC_VIEWS yet, then add the whole block from here.

Restart your supervisor service or your Docker containers to apply the changes.

Updating

Bare Metal Installation

To update your existing installation of AA Sovereignty Timer, first enable your virtual environment.

Then run the following commands from your AA project directory (the one that contains manage.py).

pip install aa-sov-timer==3.2.1

python manage.py collectstatic
python manage.py migrate

Finally, restart your AA supervisor service.

Docker Installation

To update your existing installation of AA Sovereignty Timer, all you need to do is to update the respective line in your conf/requirements.txt file to the latest version.

aa-sov-timer==3.2.1

Now rebuild your containers and restart them:

docker compose build --no-cache
docker compose --env-file=.env up -d

After that, run the following commands to update your database and static files:

docker compose exec allianceauth_gunicorn bash

auth collectstatic
auth migrate

Common Steps

It is possible that some versions need some more changes. Always read the changelog and/or release notes to find out more.

Changelog

See CHANGELOG.md for a detailed list of changes and improvements.

Translation Status

Translation status

Do you want to help translate this app into your language or improve the existing translation? - Join our team of translators!

Contributing

Do you want to contribute to this project? That's cool!

Please make sure to read the Contribution Guidelines.\ (I promise, it's not much, just some basics)

No reviews yet...

Python Requirements

Required Python packages to be installed and other Python requirement.

App Dependencies


Required apps:

Used by apps:

    -

Dependencies to other apps registered in this app directory.

Classifiers

  • Environment :: Web Environment
  • Framework :: Django
  • Framework :: Django :: 4.2
  • Intended Audience :: Developers
  • License :: OSI Approved :: GNU General Public License v3 (GPLv3)
  • Operating System :: OS Independent
  • Programming Language :: Python
  • Programming Language :: Python :: 3 :: Only
  • Programming Language :: Python :: 3.10
  • Programming Language :: Python :: 3.11
  • Programming Language :: Python :: 3.12
  • Programming Language :: Python :: 3.13
  • Topic :: Internet :: WWW/HTTP
  • Topic :: Internet :: WWW/HTTP :: Dynamic Content

Version

3.2.1

License

GPLv3

PyPI

  https://pypi.org/project/aa-sov-timer/

Last updated

1 week, 1 day ago

First published

5 years ago

Category

Plugin Apps

Rating

-

Authors

Rounon Dax

Maintainers

Rounon Dax Rounon Dax

Please login to see more options.