{"id":17004235,"url":"https://github.com/ppfeufer/aa-fleetfinder","last_synced_at":"2025-07-31T17:09:10.845Z","repository":{"id":40439936,"uuid":"324018965","full_name":"ppfeufer/aa-fleetfinder","owner":"ppfeufer","description":"Control access to your fleets through Alliance Auth.","archived":false,"fork":false,"pushed_at":"2025-07-08T08:54:22.000Z","size":1509,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-08T09:51:03.019Z","etag":null,"topics":["allianceauth","django","fleetfinder","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ppfeufer.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"ko_fi":"ppfeufer"}},"created_at":"2020-12-23T23:05:00.000Z","updated_at":"2025-07-08T08:53:35.000Z","dependencies_parsed_at":"2024-02-17T22:28:55.486Z","dependency_job_id":"b6fde95d-af95-41bf-b959-41acf3de067a","html_url":"https://github.com/ppfeufer/aa-fleetfinder","commit_stats":{"total_commits":118,"total_committers":2,"mean_commits":59.0,"dds":"0.025423728813559365","last_synced_commit":"5f6bc342b8ed861c15567c12696e6c624eb0072c"},"previous_names":[],"tags_count":45,"template":false,"template_full_name":null,"purl":"pkg:github/ppfeufer/aa-fleetfinder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ppfeufer%2Faa-fleetfinder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ppfeufer%2Faa-fleetfinder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ppfeufer%2Faa-fleetfinder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ppfeufer%2Faa-fleetfinder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ppfeufer","download_url":"https://codeload.github.com/ppfeufer/aa-fleetfinder/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ppfeufer%2Faa-fleetfinder/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267302181,"owners_count":24066451,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-27T02:00:11.917Z","response_time":82,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["allianceauth","django","fleetfinder","python"],"created_at":"2024-10-14T04:43:07.994Z","updated_at":"2025-07-31T17:09:10.801Z","avatar_url":"https://github.com/ppfeufer.png","language":"Python","funding_links":["https://ko-fi.com/ppfeufer","https://ko-fi.com/N4N8CL1BY"],"categories":[],"sub_categories":[],"readme":"# AA Fleet Finder\u003ca name=\"aa-fleet-finder\"\u003e\u003c/a\u003e\n\n[![Version](https://img.shields.io/pypi/v/aa-fleetfinder?label=release)](https://pypi.org/project/aa-fleetfinder/)\n[![License](https://img.shields.io/github/license/ppfeufer/aa-fleetfinder)](https://github.com/ppfeufer/aa-fleetfinder/blob/master/LICENSE)\n[![Python](https://img.shields.io/pypi/pyversions/aa-fleetfinder)](https://pypi.org/project/aa-fleetfinder/)\n[![Django](https://img.shields.io/pypi/djversions/aa-fleetfinder?label=django)](https://pypi.org/project/aa-fleetfinder/)\n![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit\u0026logoColor=white)\n[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/ppfeufer/aa-fleetfinder/master.svg)](https://results.pre-commit.ci/latest/github/ppfeufer/aa-fleetfinder/master)\n[![Code Style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](http://black.readthedocs.io/en/latest/)\n[![Discord](https://img.shields.io/discord/790364535294132234?label=discord)](https://discord.gg/zmh52wnfvM)\n[![Checks](https://github.com/ppfeufer/aa-fleetfinder/actions/workflows/automated-checks.yml/badge.svg)](https://github.com/ppfeufer/aa-fleetfinder/actions/workflows/automated-checks.yml)\n[![codecov](https://codecov.io/gh/ppfeufer/aa-fleetfinder/branch/master/graph/badge.svg?token=GFOR9GWRNQ)](https://codecov.io/gh/ppfeufer/aa-fleetfinder)\n[![Translation status](https://weblate.ppfeufer.de/widget/alliance-auth-apps/aa-fleetfinder/svg-badge.svg)](https://weblate.ppfeufer.de/engage/alliance-auth-apps/)\n[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](https://github.com/ppfeufer/aa-fleetfinder/blob/master/CODE_OF_CONDUCT.md)\n\n[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/N4N8CL1BY)\n\nControl access to your fleets through Alliance Auth.\n\n______________________________________________________________________\n\n\u003c!-- mdformat-toc start --slug=github --maxlevel=6 --minlevel=2 --\u003e\n\n- [Installation](#installation)\n  - [Step 1: Install the Package](#step-1-install-the-package)\n  - [Step 2: Configure Alliance Auth](#step-2-configure-alliance-auth)\n  - [Step 3: Add the Scheduled Task](#step-3-add-the-scheduled-task)\n  - [Step 4: Finalizing the Installation](#step-4-finalizing-the-installation)\n  - [Step 4: Setup Permissions](#step-4-setup-permissions)\n- [Changelog](#changelog)\n- [Translation Status](#translation-status)\n- [Contributing](#contributing)\n\n\u003c!-- mdformat-toc end --\u003e\n\n______________________________________________________________________\n\n## Installation\u003ca name=\"installation\"\u003e\u003c/a\u003e\n\n\u003e [!NOTE]\n\u003e\n\u003e **AA Fleet Finder \u003e= 2.0.0 needs at least Alliance Auth v4.0.0!**\n\u003e\n\u003e Please make sure to update your Alliance Auth instance _before_ you install this\n\u003e module or update to the latest version, otherwise an update to Alliance Auth will\n\u003e be pulled in unsupervised.\n\u003e\n\u003e The last version compatible with Alliance Auth v3 is `1.5.2`.\n\n### Step 1: Install the Package\u003ca name=\"step-1-install-the-package\"\u003e\u003c/a\u003e\n\nMake sure you're in the virtual environment (venv) of your Alliance Auth installation Then install the latest release directly from PyPi.\n\n```shell\npip install aa-fleetfinder\n```\n\n### Step 2: Configure Alliance Auth\u003ca name=\"step-2-configure-alliance-auth\"\u003e\u003c/a\u003e\n\nThis is fairly simple, just add the following to the `INSTALLED_APPS` of your `local.py`\n\nConfigure your AA settings (`local.py`) as follows:\n\n- Add `\"fleetfinder\",` to `INSTALLED_APPS`\n\n### Step 3: Add the Scheduled Task\u003ca name=\"step-3-add-the-scheduled-task\"\u003e\u003c/a\u003e\n\nTo set up the scheduled task, add the following code to your `local.py`:\n\n```python\n# AA Fleetfinder - https://github.com/ppfeufer/aa-fleetfinder\nif \"fleetfinder\" in INSTALLED_APPS:\n    CELERYBEAT_SCHEDULE[\"fleetfinder_check_fleet_adverts\"] = {\n        \"task\": \"fleetfinder.tasks.check_fleet_adverts\",\n        \"schedule\": crontab(minute=\"*/1\"),\n    }\n```\n\n### Step 4: Finalizing the Installation\u003ca name=\"step-4-finalizing-the-installation\"\u003e\u003c/a\u003e\n\nRun static files collection and migrations\n\n```shell\npython manage.py collectstatic\npython manage.py migrate\n```\n\n### Step 4: Setup Permissions\u003ca name=\"step-4-setup-permissions\"\u003e\u003c/a\u003e\n\nNow it's time to set up access permissions for your new Fleetfinder module.\n\n| ID                   | Description                       | Notes                                                                                                       |\n| :------------------- | :-------------------------------- | :---------------------------------------------------------------------------------------------------------- |\n| `access_fleetfinder` | Can access the Fleetfinder module | Your line members should have this permission, together with everyone you want to have access to he module. |\n| `manage_fleets`      | Can manage fleets                 | Everyone with this permission can open and edit fleets                                                      |\n\n## Changelog\u003ca name=\"changelog\"\u003e\u003c/a\u003e\n\nSee [CHANGELOG.md](https://github.com/ppfeufer/aa-fleetfinder/blob/master/CHANGELOG.md)\n\n## Translation Status\u003ca name=\"translation-status\"\u003e\u003c/a\u003e\n\n[![Translation status](https://weblate.ppfeufer.de/widget/alliance-auth-apps/aa-fleetfinder/multi-auto.svg)](https://weblate.ppfeufer.de/engage/alliance-auth-apps/)\n\nDo you want to help translate this app into your language or improve the existing\ntranslation? - [Join our team of translators][weblate engage]!\n\n## Contributing\u003ca name=\"contributing\"\u003e\u003c/a\u003e\n\nYou want to contribute to this project? That's cool!\n\nPlease make sure to read the [Contribution Guidelines](https://github.com/ppfeufer/aa-fleetfinder/blob/master/CONTRIBUTING.md).\\\n(I promise, it's not much, just some basics)\n\n\u003c!-- Links --\u003e\n\n[weblate engage]: https://weblate.ppfeufer.de/engage/alliance-auth-apps/ \"Weblate Translations\"\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fppfeufer%2Faa-fleetfinder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fppfeufer%2Faa-fleetfinder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fppfeufer%2Faa-fleetfinder/lists"}