Skip to main content

Release Licence Python Django pre-commit.ci statusCode style: black Checks codecov Translation status

ko-fi

AA Belt Radar module for AllianceAuth.

A Belt Survey Analyser to track how fast you mine your belt.


Features

  • Display estimated completion time for belt mining
  • Show mining speed in m³/s
  • Display remaining volume and belt size information
  • Optional Share your Mining Session with others
  • Respawn Timer for Belts
  • Compressed Price
  • Discord Notification (optional)
  • Public/Private Respawn Timers
  • Discord Webhook for Respawn Timer

Upcoming

  • Graphical Upgrades
  • Auto Respawn Timer from Session per Survey

Highlights

Image: Belt Radar Dashboard

Image: Belt Radar My Sessions

Image: Belt Radar View Session

Installation

[!NOTE] AA Belt Radar needs at least Alliance Auth v5 Please make sure to update your Alliance Auth before you install this APP

Step 1 - Install the Package

Make sure you're in your virtual environment (venv) of your Alliance Auth then install the pakage.

pip install aa-beltradar

Step 2 - Configure Alliance Auth

Configure your Alliance Auth settings (local.py) as follows:

INSTALLED_APPS = [
    # other apps
    "eve_sde",  # only if it not already existing
    "beltradar",
    # other apps?
]

# This line is right below the `INSTALLED_APPS` list, if not already exist!
INSTALLED_APPS = ["modeltranslation"] + INSTALLED_APPS

Step 3 - Add the Scheduled Tasks

To set up the Scheduled Tasks add following code to your local.py

CELERYBEAT_SCHEDULE["AA Belt Radar :: Update Belt Radar"] = {
    "task": "beltradar.tasks.update_all_belt_radar",
    "schedule": 600,
}
CELERYBEAT_SCHEDULE["AA Belt Radar :: Update Market Price"] = {
    "task": "beltradar.tasks.update_market_prices",
    "schedule": 86400,
}

Step 3.1 - (Optional) Add own Logger File

To set up the Logger add following code to your local.py Ensure that you have writing permission in logs folder.

LOGGING["handlers"]["beltradar_file"] = {
    "level": "INFO",
    "class": "logging.handlers.RotatingFileHandler",
    "filename": os.path.join(BASE_DIR, "log/beltradar.log"),
    "formatter": "verbose",
    "maxBytes": 1024 * 1024 * 5,
    "backupCount": 5,
}
LOGGING["loggers"]["extensions.beltradar"] = {
    "handlers": ["beltradar_file"],
    "level": "DEBUG",
}

Step 4 - Migrate & Preload EVE SDE Data

AA Skillfarm uses EVE SDE data to map IDs to names for EveTypes. You will need to preload some data from SDE once.

python manage.py migrate eve_sde
python manage.py esde_load_sde

Step 4.1 - Migrate App and collect static

Migrate the app and collect static.

python manage.py migrate beltradar
python manage.py aabeltradar_migrate_market_data
python manage.py collectstatic --noinput

Step 5 - Setting up Permissions

With the Following IDs you can set up the permissions for the Belt Radar

ID Description
basic_access Can access the Belt Radar module All Members with the Permission can access the Belt Radar.
manage_access Can Manage Belt Radar module Can manage Application
admin_access Has access to all Survey Sessions Can see all Survey Sessions

Step 6 - (Optional) Setting up Compatibilies

The Following Settings can be setting up in the local.py

Setting Name Descriptioon Default
BELT_RADAR_APP_NAME Set the name of the APP "Belt Radar"
BELT_RADAR_TASK_TIME_LIMIT Defines the time (in seconds) a task will timeout 1200
BELT_RADAR_WEBHOOK_URL Defines URL for Webhook notification None

Translations

Translations

Help us translate this app into your language or improve existing translations. Join our team!"

Contributing

You want to improve the project? Please ensure you read the Contribution Guidelines

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aa_beltradar-0.5.1.tar.gz (100.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aa_beltradar-0.5.1-py3-none-any.whl (181.1 kB view details)

Uploaded Python 3

File details

Details for the file aa_beltradar-0.5.1.tar.gz.

File metadata

  • Download URL: aa_beltradar-0.5.1.tar.gz
  • Upload date:
  • Size: 100.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for aa_beltradar-0.5.1.tar.gz
Algorithm Hash digest
SHA256 7dbe95463a86deabb5fc19a28096d383a56039871a79cc25b7435c61a99e611a
MD5 d0267c63d4ed0413215750099d7c8eb8
BLAKE2b-256 4c78b9def061e3ad0992ed323c2fa7fc26927797ddbaafa9e6ebd00bd3ff63cd

See more details on using hashes here.

Provenance

The following attestation bundles were made for aa_beltradar-0.5.1.tar.gz:

Publisher: release.yml on Geuthur/aa-beltradar

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aa_beltradar-0.5.1-py3-none-any.whl.

File metadata

  • Download URL: aa_beltradar-0.5.1-py3-none-any.whl
  • Upload date:
  • Size: 181.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for aa_beltradar-0.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 705ef7290ee59b91ba10c1c38a3d5843ad1e92ebd84b0803adc68a22bd2da9f3
MD5 532129aa9a405efd68dc49cbcb900037
BLAKE2b-256 2c57abda548cfb85cfcfa0e5d90ea1a8a00ceca0b169a5ae7dc871dcc7eebeb0

See more details on using hashes here.

Provenance

The following attestation bundles were made for aa_beltradar-0.5.1-py3-none-any.whl:

Publisher: release.yml on Geuthur/aa-beltradar

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page