Metadata-Version: 2.4
Name: aa-hunting
Version: 0.2.1a0
Summary: We are hunting Rabbits.
Keywords: allianceauth,eveonline
Author-email: Joel Falknau <joel.falknau@gmail.com>
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Classifier: Environment :: Web Environment
Classifier: Framework :: Celery
Classifier: Framework :: Django
Classifier: Framework :: Django :: 4.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 :: Implementation :: CPython
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
License-File: LICENSE
Requires-Dist: allianceauth>=4.6.4,<6
Requires-Dist: django-eveuniverse
Requires-Dist: django-solo>=2,<3
Requires-Dist: py-cord>=2,<3
Project-URL: Homepage, https://gitlab.com/tactical-supremacy/aa-hunting
Project-URL: Source, https://gitlab.com/tactical-supremacy/aa-hunting
Project-URL: Tracker, https://gitlab.com/tactical-supremacy/aa-hunting/-/issues

# Alliance Auth - Hunting Tools

We are hunting Rabbits.

## Features

- Display active targets
- Last known Locate and Past Locates for a given target
- Manage target Alts and their capability
- Note taking on given targets

### Planned Features

- Manage Locator Agent Expiries
- Request a Locate from available users
- Generate potential targets from kill activity

## Installation

### Step 1 - Install from pip

```shell
pip install aa-hunting
```

### Step 3 - Configure Auth settings

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

- Add `'hunting'` to `INSTALLED_APPS`
- Add below lines to your settings file:

```python
## Settings for AA-Hunting
# Notifications (Locator Agent Results)
CELERYBEAT_SCHEDULE['hunting_pull_notifications'] = {
    'task': 'hunting.tasks.pull_notifications',
    'schedule': crontab(minute='0', hour='*'),
    'apply_offset': True,
}
CELERYBEAT_SCHEDULE['hunting_import_notifications_apps'] = {
    'task': 'hunting.tasks.import_notifications_apps',
    'schedule': crontab(minute='30', hour='*'),
    'apply_offset': True,
}
# Dont hit squizz too hard, im not shipping the agent file incase it updates
CELERYBEAT_SCHEDULE['hunting_import_agents_squizz'] = {
    'task': 'hunting.tasks.import_agents_squizz',
    'schedule': crontab(minute='0', hour='0', day_of_week='0'),
}
```

### Step 3 - Maintain Alliance Auth

- Run migrations `python manage.py migrate`
- Gather your staticfiles `python manage.py collectstatic`
- Restart your project `supervisorctl restart myauth:`

## Permissions

| Perm             | Admin Site | Perm                         | Description                                   |
| ---------------- | ---------- | ---------------------------- | --------------------------------------------- |
| basic_access     | nill       | Can access the Hunting App   | Can access the Hunting App                    |
| target_add       | nill       | Can add a Hunting target     | Can add a Hunting target                      |
| target_edit      | nill       | Can edit a Hunting target    | Can edit a Target, Add Alts, Modify Ship Type |
| target_archive   | nill       | Can archive a Hunting target | Can                                           |
| alt_add          | nill       |                              |                                               |
| alt_edit         | nill       |                              |                                               |
| alt_remove       | nill       |                              |                                               |
| locator_addtoken | nill       |                              |                                               |
| locator_request  | nill       |                              |                                               |
| locator_action   | nill       |                              |                                               |

## Settings

| Name                              | Description                                                                                    | Default |
| --------------------------------- | ---------------------------------------------------------------------------------------------- | ------- |
| `HUNTING_ENABLE_CORPTOOLS_IMPORT` | Enable (if Installed) LocateCharMsg's to be pulled from Corp-Tools, for historical information | `True`  |

## Contributing

Make sure you have signed the [License Agreement](https://developers.eveonline.com/resource/license-agreement) by logging in at <https://developers.eveonline.com> before submitting any pull requests. All bug fixes or features must not include extra superfluous formatting changes.

