Method ready

apps/plugins/apps.py:11–74

Wire up plugin discovery without hitting the DB during app init. - Skip during common management commands that don't need discovery. - Register post_migrate handler to sync plugin registry to DB after migrations. - Run in-memory discovery (no DB) in every non-Celery process

(self)

    verbose_name = "Plugins"

    def ready(self):
        """Wire up plugin discovery without hitting the DB during app init.

        - Skip during common management commands that don't need discovery.
        - Register post_migrate handler to sync plugin registry to DB after migrations.
        - Run in-memory discovery (no DB) in every non-Celery process so plugin
          modules are imported and monkey-patches apply. This includes uWSGI workers
          under lazy-apps=true, which each start cold and never inherit a warmed fork.
          Celery workers skip here and discover via the worker_ready signal instead.
        - One-shot startup tasks (schedule setup, repo refresh) are gated by
          should_skip_initialization() so they only fire in the master/main process.
        """
        try:
            # Allow explicit opt-out via env var
            if os.environ.get("DISPATCHARR_SKIP_PLUGIN_AUTODISCOVERY", "").lower() in ("1", "true", "yes"):
                return

            argv = sys.argv[1:] if len(sys.argv) > 1 else []
            mgmt_cmds_to_skip = {
                # Skip immediate discovery for these commands
                "makemigrations", "collectstatic", "check", "test", "shell", "showmigrations",
            }
            if argv and argv[0] in mgmt_cmds_to_skip:
                return

            # Run discovery with DB sync after the plugins app has been migrated
            def _post_migrate_discover(sender=None, app_config=None, **kwargs):
                try:
                    if app_config and getattr(app_config, 'label', None) != 'plugins':
                        return
                    from .loader import PluginManager
                    PluginManager.get().discover_plugins(sync_db=True)
                except Exception:
                    import logging
                    logging.getLogger(__name__).exception("Plugin discovery failed in post_migrate")

            post_migrate.connect(
                _post_migrate_discover,
                dispatch_uid="apps.plugins.post_migrate_discover",
            )

            from dispatcharr.app_initialization import should_skip_initialization
            # Skip discovery for Celery (worker_ready signal handles it) and
            # pure management commands that don't serve requests. Every other
            # process - including each uWSGI worker under lazy-apps=true - runs
            # discovery so plugin modules are imported and monkey-patches apply.
            _no_discovery_cmds = {'celery', 'beat', 'migrate', 'dbshell', 'loaddata'}
            if not any(cmd in sys.argv for cmd in _no_discovery_cmds):
                from .loader import PluginManager
                PluginManager.get().discover_plugins(sync_db=False)

            if should_skip_initialization():
                return
        except Exception:
            # Avoid breaking startup due to plugin errors
            import logging

            logging.getLogger(__name__).exception("Plugin discovery wiring failed during app ready")