indy-hub 0.1.1__tar.gz

indy_hub-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 erka Ekanon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

indy_hub-0.1.1/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: indy-hub
+Version: 0.1.1
+Summary: Indy Hub Plugin for Alliance Auth
+Keywords: allianceauth,eveonline,hub,industry,indy
+Author-email: erka Ekanon <erkaekanon@outlook.com>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Celery
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.0
+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: aa-discordnotify>=2
+Requires-Dist: allianceauth>=4,<5
+Requires-Dist: django-eveuniverse>=1.5.7
+Project-URL: Home, https://github.com/Erkaek/aa-Indy_Hub
+Project-URL: Source, https://github.com/Erkaek/aa-Indy_Hub
+Project-URL: Tracker, https://github.com/Erkaek/aa-Indy_Hub/issues
+
+# Indy Hub for Alliance Auth
+
+A modern industry management module for [Alliance Auth](https://allianceauth.org/), focused on blueprint and job tracking for EVE Online alliances and corporations.
+
+______________________________________________________________________
+
+## ✨ Features (Current)
+
+- **Blueprint Library**: View, filter, and search all your EVE Online blueprints by character, type, and efficiency.
+- **Industry Job Tracking**: Monitor and filter your manufacturing, research, and invention jobs in real time.
+- **Blueprint Copy Sharing**: Request, offer, and deliver blueprint copies (BPCs) within your alliance, with notifications for each step.
+- **ESI Integration**: Secure OAuth2-based sync for blueprints and jobs, with periodic background updates (Celery required).
+- **Notifications**: In-app alerts for job completions, copy offers, and deliveries. Optional Discord notifications (via aa-discordnotify).
+- **Modern UI**: Responsive Bootstrap 5 interface, theme-compatible, with accessibility and i18n support.
+
+______________________________________________________________________
+
+## 🚧 In Development
+
+- **Alliance-wide Blueprint Library**: Browse all blueprints available in the alliance (admin-controlled visibility).
+- **Advanced Copy Request Fulfillment**: Streamlined workflows for fulfilling and tracking copy requests.
+- **Improved Job Analytics**: More detailed job statistics, filtering, and export options.
+- **Better Admin Tools**: Enhanced dashboards and management commands for admins.
+
+______________________________________________________________________
+
+## 🛣️ Planned / Coming Soon
+
+- **Blueprint Lending/Loan System**: Track and manage temporary blueprint loans between members.
+- **Production Cost Estimation**: Integrated cost calculators and market price lookups.
+- **More ESI Scopes**: Support for additional ESI endpoints (e.g., assets, wallet, reactions).
+- **API/Export**: Public API endpoints and improved CSV/Excel export for all lists.
+- **More Notifications**: Customizable notification rules and Discord webhooks.
+
+______________________________________________________________________
+
+## Requirements
+
+- Alliance Auth v4+
+- Python 3.10+
+- Django (as required by AA)
+- django-eveuniverse (populated with industry data)
+- Celery (for background sync)
+- (Optional) aa-discordnotify for Discord alerts
+
+______________________________________________________________________
+
+## Quick Install
+
+1. `pip install django-eveuniverse` and `pip install indy_hub`
+
+1. Add `eveuniverse` and `indy_hub` to `INSTALLED_APPS` in your AA settings.
+
+1. Add to your local.py:
+
+- EVEUNIVERSE_LOAD_TYPE_MATERIALS = True
+- EVEUNIVERSE_LOAD_MARKET_GROUPS = True
+- EVEUNIVERSE_LOAD_TYPE_MATERIALS = True
+
+1. Run migrations: `python manage.py migrate`
+
+1. Collect static files: `python manage.py collectstatic`
+
+1. Restart your auth.
+
+1. Populate EveUniverse with industry data `python manage.py eveuniverse_load_data types --types-enabled-sections industry_activities type_materials`.
+
+1. Assign the `can access indy_hub` permission to users/groups.
+
+______________________________________________________________________
+
+## Usage
+
+- Go to the Indy Hub dashboard in Alliance Auth.
+- Authorize ESI for blueprints and jobs.
+- View/manage your blueprints and jobs, request/offer BPCs, and receive notifications.
+
+______________________________________________________________________
+
+## Support & Contributing
+
+- Open an issue or pull request on GitHub for help or to contribute.
+
+______________________________________________________________________
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.
+

indy_hub-0.1.1/README.md

@@ -0,0 +1,88 @@
+# Indy Hub for Alliance Auth
+
+A modern industry management module for [Alliance Auth](https://allianceauth.org/), focused on blueprint and job tracking for EVE Online alliances and corporations.
+
+______________________________________________________________________
+
+## ✨ Features (Current)
+
+- **Blueprint Library**: View, filter, and search all your EVE Online blueprints by character, type, and efficiency.
+- **Industry Job Tracking**: Monitor and filter your manufacturing, research, and invention jobs in real time.
+- **Blueprint Copy Sharing**: Request, offer, and deliver blueprint copies (BPCs) within your alliance, with notifications for each step.
+- **ESI Integration**: Secure OAuth2-based sync for blueprints and jobs, with periodic background updates (Celery required).
+- **Notifications**: In-app alerts for job completions, copy offers, and deliveries. Optional Discord notifications (via aa-discordnotify).
+- **Modern UI**: Responsive Bootstrap 5 interface, theme-compatible, with accessibility and i18n support.
+
+______________________________________________________________________
+
+## 🚧 In Development
+
+- **Alliance-wide Blueprint Library**: Browse all blueprints available in the alliance (admin-controlled visibility).
+- **Advanced Copy Request Fulfillment**: Streamlined workflows for fulfilling and tracking copy requests.
+- **Improved Job Analytics**: More detailed job statistics, filtering, and export options.
+- **Better Admin Tools**: Enhanced dashboards and management commands for admins.
+
+______________________________________________________________________
+
+## 🛣️ Planned / Coming Soon
+
+- **Blueprint Lending/Loan System**: Track and manage temporary blueprint loans between members.
+- **Production Cost Estimation**: Integrated cost calculators and market price lookups.
+- **More ESI Scopes**: Support for additional ESI endpoints (e.g., assets, wallet, reactions).
+- **API/Export**: Public API endpoints and improved CSV/Excel export for all lists.
+- **More Notifications**: Customizable notification rules and Discord webhooks.
+
+______________________________________________________________________
+
+## Requirements
+
+- Alliance Auth v4+
+- Python 3.10+
+- Django (as required by AA)
+- django-eveuniverse (populated with industry data)
+- Celery (for background sync)
+- (Optional) aa-discordnotify for Discord alerts
+
+______________________________________________________________________
+
+## Quick Install
+
+1. `pip install django-eveuniverse` and `pip install indy_hub`
+
+1. Add `eveuniverse` and `indy_hub` to `INSTALLED_APPS` in your AA settings.
+
+1. Add to your local.py:
+
+- EVEUNIVERSE_LOAD_TYPE_MATERIALS = True
+- EVEUNIVERSE_LOAD_MARKET_GROUPS = True
+- EVEUNIVERSE_LOAD_TYPE_MATERIALS = True
+
+1. Run migrations: `python manage.py migrate`
+
+1. Collect static files: `python manage.py collectstatic`
+
+1. Restart your auth.
+
+1. Populate EveUniverse with industry data `python manage.py eveuniverse_load_data types --types-enabled-sections industry_activities type_materials`.
+
+1. Assign the `can access indy_hub` permission to users/groups.
+
+______________________________________________________________________
+
+## Usage
+
+- Go to the Indy Hub dashboard in Alliance Auth.
+- Authorize ESI for blueprints and jobs.
+- View/manage your blueprints and jobs, request/offer BPCs, and receive notifications.
+
+______________________________________________________________________
+
+## Support & Contributing
+
+- Open an issue or pull request on GitHub for help or to contribute.
+
+______________________________________________________________________
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.

indy_hub-0.1.1/indy_hub/__init__.py

@@ -0,0 +1,5 @@
+"""
+Indy Hub - An industrial management application for Alliance Auth
+"""
+
+__version__ = "0.1.1"

indy_hub-0.1.1/indy_hub/admin.py

@@ -0,0 +1,173 @@
+"""
+Django admin configuration for indy_hub models
+"""
+
+# Django
+from django.contrib import admin
+
+from .models import Blueprint, CharacterUpdateTracker, IndustryJob
+
+
+@admin.register(Blueprint)
+class BlueprintAdmin(admin.ModelAdmin):
+    list_display = [
+        "type_name",
+        "owner_user",
+        "character_id",
+        "quantity",
+        "material_efficiency",
+        "time_efficiency",
+        "runs",
+        "last_updated",
+    ]
+    list_filter = ["owner_user", "character_id", "quantity", "last_updated"]
+    search_fields = ["type_name", "type_id", "owner_user__username"]
+    readonly_fields = ["item_id", "last_updated", "created_at"]
+
+    fieldsets = (
+        (
+            "Basic Information",
+            {
+                "fields": (
+                    "owner_user",
+                    "character_id",
+                    "item_id",
+                    "type_id",
+                    "type_name",
+                )
+            },
+        ),
+        ("Location", {"fields": ("location_id", "location_flag")}),
+        (
+            "Blueprint Details",
+            {"fields": ("quantity", "material_efficiency", "time_efficiency", "runs")},
+        ),
+        (
+            "Timestamps",
+            {"fields": ("created_at", "last_updated"), "classes": ("collapse",)},
+        ),
+    )
+
+
+@admin.register(IndustryJob)
+class IndustryJobAdmin(admin.ModelAdmin):
+    list_display = [
+        "job_id",
+        "activity_name",
+        "blueprint_type_name",
+        "owner_user",
+        "character_id",
+        "status",
+        "runs",
+        "start_date",
+        "end_date",
+    ]
+    list_filter = ["status", "activity_id", "owner_user", "character_id", "start_date"]
+    search_fields = [
+        "blueprint_type_name",
+        "product_type_name",
+        "activity_name",
+        "owner_user__username",
+        "job_id",
+    ]
+    readonly_fields = ["job_id", "last_updated", "created_at", "start_date", "end_date"]
+
+    fieldsets = (
+        (
+            "Job Information",
+            {
+                "fields": (
+                    "owner_user",
+                    "character_id",
+                    "job_id",
+                    "installer_id",
+                    "status",
+                )
+            },
+        ),
+        (
+            "Activity Details",
+            {"fields": ("activity_id", "activity_name", "runs", "duration")},
+        ),
+        (
+            "Blueprint Information",
+            {"fields": ("blueprint_id", "blueprint_type_id", "blueprint_type_name")},
+        ),
+        ("Product Information", {"fields": ("product_type_id", "product_type_name")}),
+        (
+            "Locations",
+            {
+                "fields": (
+                    "facility_id",
+                    "station_id",
+                    "blueprint_location_id",
+                    "output_location_id",
+                ),
+                "classes": ("collapse",),
+            },
+        ),
+        ("Financial", {"fields": ("cost", "licensed_runs"), "classes": ("collapse",)}),
+        (
+            "Invention/Research",
+            {"fields": ("probability", "successful_runs"), "classes": ("collapse",)},
+        ),
+        (
+            "Timestamps",
+            {
+                "fields": (
+                    "start_date",
+                    "end_date",
+                    "pause_date",
+                    "completed_date",
+                    "created_at",
+                    "last_updated",
+                ),
+                "classes": ("collapse",),
+            },
+        ),
+    )
+
+
+@admin.register(CharacterUpdateTracker)
+class CharacterUpdateTrackerAdmin(admin.ModelAdmin):
+    list_display = [
+        "user",
+        "character_id",
+        "blueprints_last_update",
+        "jobs_last_update",
+        "last_refresh_request",
+        "updated_at",
+        "has_error",
+    ]
+    list_filter = [
+        "user",
+        "blueprints_last_update",
+        "jobs_last_update",
+        "last_refresh_request",
+        "updated_at",
+    ]
+    search_fields = ["user__username", "character_id"]
+    readonly_fields = ["updated_at"]
+
+    @admin.display(
+        description="Has Error",
+        boolean=True,
+    )
+    def has_error(self, obj):
+        return bool(obj.last_error)
+
+    fieldsets = (
+        ("Character Information", {"fields": ("user", "character_id")}),
+        (
+            "Update Status",
+            {
+                "fields": (
+                    "blueprints_last_update",
+                    "jobs_last_update",
+                    "last_refresh_request",
+                    "updated_at",
+                )
+            },
+        ),
+        ("Error Information", {"fields": ("last_error",), "classes": ("collapse",)}),
+    )

indy_hub-0.1.1/indy_hub/apps.py

@@ -0,0 +1,94 @@
+# Standard Library
+import logging
+import sys
+from importlib import import_module
+
+# Django
+from django.apps import AppConfig, apps
+from django.conf import settings
+from django.db import connection
+
+logger = logging.getLogger(__name__)
+
+
+class IndyHubConfig(AppConfig):
+    """
+    Django application configuration for IndyHub.
+
+    Handles initialization of the application, including signal registration
+    and configuration of periodic tasks for industry data updates.
+    """
+
+    name = "indy_hub"
+    verbose_name = "Indy Hub"
+    default_auto_field = "django.db.models.BigAutoField"
+
+    def ready(self):
+        """
+        Initializes the application when Django starts.
+
+        This method:
+        1. Loads signal handlers for event processing
+        2. Sets up periodic tasks for automated industry data updates
+        3. Injects beat schedule for compatibility
+        """
+        super().ready()
+
+        # Load signals
+        try:
+            import_module("indy_hub.signals")
+            logger.info("IndyHub signals loaded.")
+        except Exception as e:
+            logger.exception(f"Error loading signals: {e}")
+
+        # Skip tasks configuration during tests
+        if (
+            "test" in sys.argv
+            or "runtests.py" in sys.argv[0]
+            or hasattr(settings, "TESTING")
+            or "pytest" in sys.modules
+        ):
+            logger.info("Skipping periodic tasks setup during tests.")
+            return
+
+        # Skip during migrations
+        if "migrate" in sys.argv or "makemigrations" in sys.argv:
+            logger.info("Skipping periodic tasks setup during migrations.")
+            return
+
+        # Check that Celery Beat tables exist
+        try:
+            with connection.cursor() as cursor:
+                cursor.execute(
+                    "SELECT 1 FROM django_celery_beat_crontabschedule LIMIT 1"
+                )
+        except Exception as e:
+            logger.warning(
+                f"Celery Beat tables not available, skipping periodic tasks setup: {e}"
+            )
+            return
+
+        # Inject beat schedule for compatibility (optional, non-blocking)
+        try:
+            # AA Example App
+            from indy_hub.schedules import INDY_HUB_BEAT_SCHEDULE
+
+            if hasattr(settings, "CELERYBEAT_SCHEDULE"):
+                settings.CELERYBEAT_SCHEDULE.update(INDY_HUB_BEAT_SCHEDULE)
+            else:
+                settings.CELERYBEAT_SCHEDULE = INDY_HUB_BEAT_SCHEDULE.copy()
+        except Exception as e:
+            logger.warning(f"Could not inject indy_hub beat schedule: {e}")
+
+        # Configure periodic tasks
+        try:
+            from .tasks import setup_periodic_tasks
+
+            setup_periodic_tasks()
+            logger.info("IndyHub periodic tasks configured.")
+        except Exception as e:
+            logger.exception(f"Error setting up periodic tasks: {e}")
+
+        # Check dependencies (optional logging)
+        if not apps.is_installed("esi"):
+            logger.warning("ESI not installed; some features may be disabled.")

indy_hub-0.1.1/indy_hub/auth_hooks.py

@@ -0,0 +1,69 @@
+# Alliance Auth
+from allianceauth import hooks
+from allianceauth.services.hooks import MenuItemHook, UrlHook
+
+from . import urls
+
+
+class IndyHubMenu(MenuItemHook):
+    """
+    Adds a menu item for Indy Hub in Alliance Auth navigation.
+    """
+
+    def __init__(self):
+        super().__init__(
+            "Indy Hub",
+            "fas fa-industry fa-fw",
+            "indy_hub:index",
+            navactive=[
+                "indy_hub:index",
+                "indy_hub:blueprints_list",
+                "indy_hub:jobs_list",
+                "indy_hub:token_management",
+            ],
+        )
+
+    def render(self, request):
+        # Only show to authenticated users with the correct permission
+        if not request.user.is_authenticated:
+            return ""
+        if not request.user.has_perm("indy_hub.can_access_indy_hub"):
+            return ""
+        # Calculate pending copy requests count
+        try:
+            from .models import Blueprint, BlueprintCopyRequest
+
+            bps = Blueprint.objects.filter(owner_user=request.user, quantity=-1)
+            count = (
+                BlueprintCopyRequest.objects.filter(
+                    type_id__in=bps.values_list("type_id", flat=True),
+                    material_efficiency__in=bps.values_list(
+                        "material_efficiency", flat=True
+                    ),
+                    time_efficiency__in=bps.values_list("time_efficiency", flat=True),
+                    fulfilled=False,
+                )
+                .exclude(requested_by=request.user)
+                .count()
+            )
+            self.count = count if count > 0 else None
+        except Exception:
+            self.count = None
+        # Delegate rendering to base class
+        return super().render(request)
+
+
+@hooks.register("menu_item_hook")
+def register_menu():
+    """
+    Register the IndyHub menu item.
+    """
+    return IndyHubMenu()
+
+
+@hooks.register("url_hook")
+def register_urls():
+    """
+    Register IndyHub URL patterns.
+    """
+    return UrlHook(urls, "indy_hub", r"^indy_hub/")

indy_hub-0.1.1/indy_hub/decorators.py

@@ -0,0 +1,79 @@
+# indy_hub/decorators.py
+# Standard Library
+from functools import wraps
+
+# Django
+from django.contrib import messages
+from django.shortcuts import redirect
+
+# Import ESI Token only when needed to avoid import issues
+try:
+    # Alliance Auth
+    from esi.models import Token
+except ImportError:
+    Token = None
+
+
+def token_required(scopes=None):
+    """
+    Decorator that checks if the user has valid ESI tokens with required scopes.
+    If not, redirects to token authorization page.
+    """
+    if scopes is None:
+        scopes = []
+
+    def decorator(view_func):
+        @wraps(view_func)
+        def _wrapped_view(request, *args, **kwargs):
+            if not request.user.is_authenticated:
+                return redirect("auth_login_user")
+
+            # Check if user has tokens with required scopes
+            if Token:
+                try:
+                    tokens = Token.objects.filter(user=request.user).require_scopes(
+                        scopes
+                    )
+                    if not tokens.exists():
+                        # User doesn't have tokens with required scopes
+                        scope_names = ", ".join(scopes)
+                        messages.warning(
+                            request,
+                            f"You need to authorize ESI access with the following scopes: {scope_names}",
+                        )
+                        return redirect("indy_hub:token_management")
+                except Exception as e:
+                    messages.error(request, f"Error checking ESI tokens: {e}")
+                    return redirect("indy_hub:token_management")
+            else:
+                messages.error(request, "ESI module not available")
+                return redirect("indy_hub:index")
+
+            return view_func(request, *args, **kwargs)
+
+        return _wrapped_view
+
+    return decorator
+
+
+def blueprints_token_required(view_func):
+    """Decorator specifically for blueprint views."""
+    return token_required(["esi-characters.read_blueprints.v1"])(view_func)
+
+
+def industry_jobs_token_required(view_func):
+    """Decorator specifically for industry jobs views."""
+    return token_required(["esi-industry.read_character_jobs.v1"])(view_func)
+
+
+def indy_hub_access_required(view_func):
+    @wraps(view_func)
+    def _wrapped_view(request, *args, **kwargs):
+        if not request.user.is_authenticated:
+            return redirect("auth_login_user")
+        if not request.user.has_perm("indy_hub.can_access_indy_hub"):
+            messages.error(request, "You do not have permission to access Indy Hub.")
+            return redirect("indy_hub:index")
+        return view_func(request, *args, **kwargs)
+
+    return _wrapped_view