Skip to main content

Blueprint Library plugin for Alliance Auth.

Project description

AA Blueprints

This is an blueprints library app for Alliance Auth (AA) that can be used to list blueprints for your corporation or alliance.

release License python django pre-commit Code style: black

Overview

Features

  • Lists all blueprints owned by corporation or alliance (configurable with permissions)
  • Manage user requests for making copies of blueprints

Hint
Blueprints sends Auth notifications to inform users about blueprint requests. If you like to get those as direct messages on Discord please consider also installing Discord Notify.

Screenshots

Library

library

View Blueprint

view-blueprint

Create a Request

create-request

My Requests

my-requests

Open Requests

open-requests

Manage Blueprints

manage-blueprints

Installation

Requirements

AA Blueprints needs the app django-eveuniverse to function. Please make sure it is installed before before continuing.

Steps

Step 1 - Install the Package

Make sure you are in the virtual environment (venv) of your Alliance Auth installation. Then install the newest release from PyPI:

pip install aa-blueprints

Step 2 - Configure AA

  • Add 'blueprints' to INSTALLED_APPS in settings/local.py.
  • Add the following automated task definition:
CELERYBEAT_SCHEDULE['blueprints_update_all_blueprints'] = {
    'task': 'blueprints.tasks.update_all_blueprints',
    'schedule': crontab(minute=0, hour='*/3'),
}
CELERYBEAT_SCHEDULE['blueprints_update_all_industry_jobs'] = {
    'task': 'blueprints.tasks.update_all_industry_jobs',
    'schedule': crontab(minute=0, hour='*'),
}
CELERYBEAT_SCHEDULE['blueprints_update_all_locations'] = {
    'task': 'blueprints.tasks.update_all_locations',
    'schedule': crontab(minute=0, hour='*/12'),
}

Step 3 - Finalize App installation

Run migrations & copy static files:

python manage.py migrate
python manage.py collectstatic

Restart your supervisor services for Auth

Step 4 - Update EVE Online API Application

Update the Eve Online API app used for authentication in your AA installation to include the following scopes:

  • esi-assets.read_assets.v1
  • esi-assets.read_corporation_assets.v1
  • esi-characters.read_blueprints.v1
  • esi-corporations.read_blueprints.v1
  • esi-industry.read_character_jobs.v1
  • esi-industry.read_corporation_jobs.v1
  • esi-universe.read_structures.v1

Step 5 - Data import

Load EVE Online type data from ESI:

python manage.py blueprints_load_types

Permissions

ID Description Notes
basic_access Can access this app
request_blueprints Can request blueprints
manage_requests Can review and accept blueprint requests
add_personal_blueprint_owner Can add personal blueprint owners
add_corporate_blueprint_owner Can add corporate blueprint owners :warning: Should only be given to directors or the CEO.
view_alliance_blueprints Can view alliance's blueprints
view_industry_jobs Can view details about running industry jobs :warning: This permission will let someone see all industry job information.

Upgrading

See UPGRADING.md.

Authors

The main authors (in alphabetical order):

Project details


Download files

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

Source Distribution

aa_blueprints-1.5.0.tar.gz (129.4 kB view hashes)

Uploaded Source

Built Distribution

aa_blueprints-1.5.0-py3-none-any.whl (171.1 kB view hashes)

Uploaded Python 3

Supported by

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