Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/ppfeufer/aa-sov-timer


https://github.com/ppfeufer/aa-sov-timer

allianceauth django python sovereignty-timer

Last synced: 14 days ago
JSON representation

Awesome Lists containing this project

README 

          
# AA Sovereignty Timer



[![Version](https://img.shields.io/pypi/v/aa-sov-timer?label=release "Version")](https://pypi.org/project/aa-sov-timer/)

[![License](https://img.shields.io/badge/license-GPLv3-green "License")](https://pypi.org/project/aa-sov-timer/)

[![Python](https://img.shields.io/pypi/pyversions/aa-sov-timer "Python")](https://pypi.org/project/aa-sov-timer/)

[![Django](https://img.shields.io/pypi/djversions/aa-sov-timer?label=django "Django")](https://pypi.org/project/aa-sov-timer/)

![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)

[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/ppfeufer/aa-sov-timer/master.svg)](https://results.pre-commit.ci/latest/github/ppfeufer/aa-sov-timer/master)

[![Code Style: black](https://img.shields.io/badge/code%20style-black-000000.svg "Code Style: black")](http://black.readthedocs.io/en/latest/)

[![Automated Checks](https://github.com/ppfeufer/aa-sov-timer/actions/workflows/automated-checks.yml/badge.svg "Automated Checks")](https://github.com/ppfeufer/aa-sov-timer/actions/workflows/automated-checks.yml)

[![codecov](https://codecov.io/gh/ppfeufer/aa-sov-timer/branch/master/graph/badge.svg?token=J9PBF0HM8C "codecov")](https://codecov.io/gh/ppfeufer/aa-sov-timer)

[![Translation status](https://weblate.ppfeufer.de/widget/alliance-auth-apps/aa-sov-timer/svg-badge.svg)](https://weblate.ppfeufer.de/engage/alliance-auth-apps/)

[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg "Contributor Covenant")](https://github.com/ppfeufer/aa-sov-timer/blob/master/CODE_OF_CONDUCT.md)

[![Discord](https://img.shields.io/discord/399006117012832262?label=discord)](https://discord.gg/fjnHAmk)



[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/N4N8CL1BY)



Sovereignty campaign overview for Alliance Auth.



______________________________________________________________________



- [Screenshots](#screenshots)

  - [AA Sov Timer Dashboard](#aa-sov-timer-dashboard)

- [Installation](#installation)

  - [Bare Metal Installation](#bare-metal-installation)

    - [Step 1: Installing the App](#step-1-installing-the-app)

    - [Step 2: Update Your AA Settings](#step-2-update-your-aa-settings)

    - [Step 3: Finalizing the Installation](#step-3-finalizing-the-installation)

    - [Step 4: Preload Eve Universe Data](#step-4-preload-eve-universe-data)

    - [Step 5: Restart Supervisor](#step-5-restart-supervisor)

  - [Docker Installation](#docker-installation)

    - [Step 1: Add the App](#step-1-add-the-app)

    - [Step 2: Update Your AA Settings](#step-2-update-your-aa-settings-1)

    - [Step 3: Build Auth and Restart Your Containers](#step-3-build-auth-and-restart-your-containers)

    - [Step 4: Finalizing the Installation](#step-4-finalizing-the-installation)

  - [Common Steps / Configuration](#common-steps--configuration)

    - [(Optional) Allow Public Views](#optional-allow-public-views)

- [Updating](#updating)

  - [Bare Metal Installation](#bare-metal-installation-1)

  - [Docker Installation](#docker-installation-1)

  - [Common Steps](#common-steps)

- [Changelog](#changelog)

- [Translation Status](#translation-status)

- [Contributing](#contributing)



______________________________________________________________________



## Screenshots



### AA Sov Timer Dashboard



![AA Sov Timer Dashboard](https://raw.githubusercontent.com/ppfeufer/aa-sov-timer/master/docs/images/presentation/aa-sov-timer.jpg "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](https://allianceauth.readthedocs.io/en/latest/installation/allianceauth.html) for details)

- AA Sovereignty Timer needs the app [django-eveuniverse](https://gitlab.com/ErikKalkoken/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:



```shell

pip install aa-sov-timer==3.5.0

```



#### 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



```python

# 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



```shell

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.



```shell

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](#common-steps--configuration) below to finish the installation.**



### Docker Installation



#### Step 1: Add the App



Add the app to your `conf/requirements.txt`:



```text

aa-sov-timer==3.5.0

```



#### 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



```python

# 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



```shell

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:



```shell

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](#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:



```python

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`).



```shell

pip install aa-sov-timer==3.5.0



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.



```text

aa-sov-timer==3.5.0

```



Now rebuild your containers and restart them:



```shell

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:



```shell

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](https://github.com/ppfeufer/aa-sov-timer/releases) to find out more.



## Changelog



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



## Translation Status



[![Translation status](https://weblate.ppfeufer.de/widget/alliance-auth-apps/aa-sov-timer/multi-auto.svg)](https://weblate.ppfeufer.de/engage/alliance-auth-apps/)



Do you want to help translate this app into your language or improve the existing

translation? - [Join our team of translators][weblate engage]!



## 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)



[changelog]: https://github.com/ppfeufer/aa-sov-timer/blob/master/CHANGELOG.md

[contribution guidelines]: https://github.com/ppfeufer/aa-sov-timer/blob/master/CONTRIBUTING.md "Contribution Guidelines"

[weblate engage]: https://weblate.ppfeufer.de/engage/alliance-auth-apps/ "Weblate Translations"