Metadata-Version: 2.1
Name: aa-sov-timer
Version: 1.3.0
Summary: Sov Campaign Timer for Alliance Auth
Home-page: https://github.com/ppfeufer/aa-sov-timer
Author: Peter Pfeufer
Author-email: development@ppfeufer.de
License: GPLv3
Project-URL: Issue / Bug Reports, https://github.com/ppfeufer/aa-sov-timer/issues
Project-URL: Changelog, https://github.com/ppfeufer/aa-sov-timer/blob/master/CHANGELOG.md
Project-URL: Release Notes, https://github.com/ppfeufer/aa-sov-timer/releases/tag/v1.3.0
Project-URL: Git Repository, https://github.com/ppfeufer/aa-sov-timer
Description: # AA Sovereignty Timer
        
        [![Version](https://img.shields.io/pypi/v/aa-sov-timer?label=release)](https://pypi.org/project/aa-sov-timer/)
        [![License](https://img.shields.io/badge/license-GPLv3-green)](https://pypi.org/project/aa-sov-timer/)
        [![Python](https://img.shields.io/pypi/pyversions/aa-sov-timer)](https://pypi.org/project/aa-sov-timer/)
        [![Django](https://img.shields.io/pypi/djversions/aa-sov-timer?label=django)](https://pypi.org/project/aa-sov-timer/)
        [![Code Style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](http://black.readthedocs.io/en/latest/)
        [![Automated Checks](https://github.com/ppfeufer/aa-sov-timer/actions/workflows/automated-checks.yml/badge.svg)](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)](https://codecov.io/gh/ppfeufer/aa-sov-timer)
        [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](https://github.com/ppfeufer/aa-forum/blob/master/CODE_OF_CONDUCT.md)
        [![Discord](https://img.shields.io/discord/790364535294132234?label=discord)](https://discord.gg/zmh52wnfvM)
        
        Sovereignty campaign overview for Alliance Auth.
        
        #### AA Sov Timer Dashboard (Light Mode)
        ![AA Sov Timer Dashboard (Light Mode)](https://raw.githubusercontent.com/ppfeufer/aa-sov-timer/master/sovtimer/docs/presentation/aa-sov-timer-light-mode.jpg)
        
        #### AA Sov Timer Dashboard (Dark Mode)
        ![AA Sov Timer Dashboard (Dark Mode)](https://raw.githubusercontent.com/ppfeufer/aa-sov-timer/master/sovtimer/docs/presentation/aa-sov-timer-dark-mode.jpg)
        
        
        ## 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.
        
        ### Step 1 - Install the app
        
        Make sure you are in the virtual environment (venv) of your Alliance Auth installation.
        Then install the latest version:
        
        ```bash
        pip install aa-sov-timer
        ```
        
        ### Step 2 - Update your AA settings
        
        Configure your AA settings (`local.py`) as follows:
        
        - Add `'eveuniverse',` to `INSTALLED_APPS`
        - Add `'sovtimer',` to `INSTALLED_APPS`
        
        Restart your supervisor
        
        
        ### Step 3 - Finalize the installation
        
        Copy static files and run migrations
        
        ```bash
        python manage.py collectstatic
        ```
        
        ```bash
        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.
        
        ```bash
        python manage.py eveuniverse_load_data map
        ```
        
        ```bash
        python manage.py sovtimer_load_initial_data
        ```
        
        Both commands might take a moment or two, so be patient ...
        
        ### Step 5 - Setup permission
        
        Now you can setup permissions in Alliance Auth for your users.
        Add ``sovtimer | Sovereignty Timer | Can access the Sovereignty Timer module`` to
        the states and/or groups you would like to have access.
        
        
        ### Step 6 - Keep campaigns updated
        
        Add the following scheduled task to your `local.py`. One done, restart your supervisor.
        
        ```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.0,
        }
        ```
        
        Now your system is updating the sovereignty campains every 30 seconds.
        
        
        ## Updating
        
        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`).
        
        ```bash
        pip install -U aa-sov-timer
        ```
        
        ```bash
        python manage.py collectstatic
        ```
        
        ```bash
        python manage.py migrate
        ```
        
        Finally restart your AA supervisor services.
        
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 3.2
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Python: ~=3.7
Description-Content-Type: text/markdown
