Metadata-Version: 2.1
Name: allianceauth-imicusfat
Version: 1.0.0
Summary: Fleet Activity Tracking tool for Alliance Auth
Home-page: https://gitlab.com/evictus.iou/allianceauth-imicusfat
Author: Exiom, Aproia, ppfeufer
Author-email: evictus.iou@gmail.com
License: GPLv3
Description: # ImicusFAT
        
        [![pipeline status](https://gitlab.com/evictus.iou/allianceauth-imicusfat/badges/master/pipeline.svg)](https://gitlab.com/evictus.iou/allianceauth-imicusfat/commits/master)
        [![version](https://img.shields.io/pypi/v/allianceauth-imicusfat?label=release)](https://pypi.org/project/allianceauth-imicusfat/)
        [![license](https://img.shields.io/badge/license-GPLv3-green)](https://pypi.org/project/allianceauth-imicusfat/)
        [![python](https://img.shields.io/pypi/pyversions/allianceauth-imicusfat)](https://pypi.org/project/allianceauth-imicusfat/)
        [![django](https://img.shields.io/pypi/djversions/allianceauth-imicusfat?label=django)](https://pypi.org/project/allianceauth-imicusfat/)
        [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](http://black.readthedocs.io/en/latest/)
        
        An Improved FAT/PAP System for [Alliance Auth](https://gitlab.com/allianceauth/allianceauth). 
        
        ### Feature Highlights/Differences
        - FATLink Creation and Population from ESI
        - Fleet Type Classification (can be added in the Admin Menu)
        - Graphical Statistics Views
        - Many Core Functionality Improvements and Fixes
        
        ImicusFAT will work alongside the built-in AA-FAT System and bFAT*. However data does not share, but you can migrate their data to ImicusFAT, for more information see below.
        
        ## Contents
        
        - [Installation](#installation)
        - [Updating](#updating)
        - [Data Migration](#data-migration)
            - [Import from AA-FAT](#import-from-aa-fat)
            - [Import from bFAT](#import-from-bfat)
        - [Credits](#credits)
        
        ## Installation
        
        **Important**: This app 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)
        **Important**: For users migrating from bFAT, please read [Migrating from bFAT](#migrating-from-bfat) specific instructions FIRST.
        
        ### Step 1 - Install app
        
        Make sure you are in the virtual environment (venv) of your Alliance Auth installation. Then install the latest version:
        
        ```bash
        pip install allianceauth-imicusfat
        ```
        
        ### Step 2 - Update your AA settings
        
        Configure your AA settings (`local.py`) as follows:
        
        - Add `'imicusfat',` to `INSTALLED_APPS`
        
        ### Step 3 - Finalize the installation
        
        Run migrations & copy static files
        
        ```bash
        python manage.py collectstatic
        python manage.py migrate
        ```
        
        Restart your supervisor services for AA.
        
        ## Updating
        
        To update your existing installation of ImicusFAT, first enable your virtual environment (venv) of your Alliance Auth installation.
        
        ```bash
        pip install -U allianceauth-imicusfat
        
        python manage.py collectstatic
        python manage.py migrate
        ```
        
        Finally restart your supervisor services for AA
        
        ## Data Migration
        
        Right after the initial installation and running migrations, you can import the data from Alliance Auth's own FAT system or bFAT, if you have used it until now.
        
        **!!IMPORTANT!!**
        
        Only do this once and ONLY BEFORE you are using ImicusFAT.
        
        ### Import from AA-FAT
        
        To import your old FAT data from Alliance Auth's own FAT, you have to disable foreign key checks temporarily.
        
        
        ```
        INSERT INTO imicusfat_ifat (id, `system`, shiptype, character_id, ifatlink_id)
        SELECT id,`system`,shiptype,character_id,fatlink_id
        FROM fleetactivitytracking_fat;
        
        INSERT INTO imicusfat_ifatlink (id, ifattime, fleet, `hash`, creator_id)
        SELECT id,fatdatetime,fleet,hash,creator_id 
        FROM fleetactivitytracking_fatlink;
        ```
        
        ### Migrating from bFAT
        
        Before installation, temporarily comment out `bfat` in your AA settings (`local.py`) by doing:
        
        - Modify `'bfat',` to `#'bfat',` under `INSTALLED_APPS`
        
        And then continue installation as normal. You may undo this after successful installation.
        
        #### Import from bFAT
        To import your old FAT data from bFAT, you have to disable foreign key checks temporarily.
        
        
        ```
        INSERT INTO imicusfat_clickifatduration (id, duration, fleet_id)
        SELECT id, duration, fleet_id
        FROM bfat_clickfatduration;
        
        INSERT INTO imicusfat_dellog (id, deltype, string, remover_id)
        SELECT id, deltype, string, remover_id
        FROM bfat_dellog;
        
        INSERT INTO imicusfat_ifat (id, `system`, shiptype, character_id, ifatlink_id)
        SELECT id,`system`,shiptype,character_id,fatlink_id
        FROM bfat_fat;
        
        INSERT INTO imicusfat_ifatlink (id, ifattime, fleet, `hash`, creator_id)
        SELECT id,fattime,fleet,hash,creator_id 
        FROM bfat_fatlink;
        
        INSERT INTO imicusfat_manualifat (id, character_id, creator_id, ifatlink_id)
        SELECT id, character_id, creator_id, fatlink_id
        FROM bfat_manualfat;
        ```
        
        ## Credits
        • ImicusFAT • Developed and Maintained by @exiom with @Aproia and @ppfeufer • Based on [allianceauth-bfat](https://gitlab.com/colcrunch/allianceauth-bfat) by @colcrunch •
        
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 2.2
Classifier: Framework :: Django :: 3.1
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.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Python: ~=3.6
Description-Content-Type: text/markdown
