Metadata-Version: 2.4
Name: aa_moonregistry
Version: 0.2.0
Summary: Moon Registry for Alliance Auth.
Author-email: CMBrando <CMBrando999@gmail.com>
Requires-Python: >=3.10,<3.15
Description-Content-Type: text/markdown
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 5.2
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
License-File: LICENSE
Requires-Dist: allianceauth>=5.0,<6.0
Requires-Dist: django>=5.2,<6.0
Requires-Dist: django-eveonline-sde>=0.2.0,<1.0
Project-URL: Homepage, https://github.com/CMBrando/aaMoonRegistry
Project-URL: Issues, https://github.com/CMBrando/aaMoonRegistry/issues

# Moon Registry for Alliance Auth

This is a Moon Registry app for [Alliance Auth](https://gitlab.com/allianceauth/allianceauth) (AA) 


## Features

- Search all moons across Eve once imported, by (system, constellation, region), ore, sov. owner, rarity
- Add moon scans via parsed text

## Installation

Before installing Moon Registry, install and configure `django-eveonline-sde`
(`eve_sde`) in Alliance Auth. Complete its migrations and run `esde_load_sde`
successfully. The SDE load must include regions, constellations, solar systems,
item types, type materials, planets, and moons. Follow the SDE package's setup
instructions, including its `modeltranslation` requirement.

In your Alliance Auth virtual environment, install Moon Registry in editable
mode from a local checkout:

```bash
pip install -e {path_to}/aa_moonregistry
```

or via PyPi:

```bash
pip install aa_moonregistry
```

Add `aa_moonregistry` to `INSTALLED_APPS` in `settings/local.py`.

Apply Moon Registry's migrations. On upgrades, existing moon scans and cached
prices keep their EVE type IDs.

```bash
python manage.py migrate
```

Load initial Eve sovereignty

```bash
python manage.py aa_moonregistry_load_sovereignty
```

Load Metenox-specific fuel data

```bash
python manage.py aa_moonregistry_load_metenox_data
```

Load initial JITA IV material pricing. Calculates average of top 5 JBV per type 

```bash
python manage.py aa_moonregistry_load_jita_materials_prices
```

Next copy all the static data to the output folder

```bash
python manage.py collectstatic --noinput
```

Finally restart your AA setup.

## Permissions

There is only one access level that will give access to the app in menu
    *aa_moonregistry.basic_access*


## Alliance Auth Tasks

There are several registered tasks that should be run periodically.

*aa_moonregistry.tasks.refresh_sovereignty* - Reloads current Eve Sovereignty. Schedule once a week or so.

*aa_moonregistry.tasks.refresh_material_prices* - Refreshes pricing for calculations. Schedule once per day.

*aa_moonregistry.tasks.refresh_metenox_data* - Refreshes Metenox metadata. Schedule once per month.

