@spec all(map() | nil) :: %{required(String.t()) => map()}

Returns all registered tasks as a map of %{name => task_def}, merging global and app-specific tasks.

Returns a specification to start this module under a supervisor.

See Supervisor.

@spec fetch!(String.t(), map() | nil) :: map()

Fetches a task definition by name or raises Celery.NotRegistered.

@spec keys(map() | nil) :: [String.t()]

Returns a sorted list of all registered task names.

@spec load_include(module() | String.t()) :: [map()]

Resolves a module from either an Elixir module atom (Src.Tasks) or a Python-style dotted module string ("src.tasks" -> Src.Tasks), loads its __celery_tasks__/0 definitions if present, and registers them.

@spec lookup(String.t(), map() | nil) ::
  {:ok, map()} | {:error, Celery.NotRegistered.t()}

Looks up a task definition by name in an optional app's local registry or the global registry.

@spec module_candidates(String.t()) :: [module()]

Converts a Python-style dotted module name (e.g. "src.tasks") or Elixir module string (e.g. "Src.Tasks", "Elixir.Src.Tasks") into candidate Elixir module atoms.

@spec python_module_name(module()) :: String.t()

Converts an Elixir module atom into a Python-style dotted module string (e.g. Src.Tasks -> "src.tasks").

@spec register(map()) :: :ok

Registers a %Celery.Task.Definition{} in the global registry.

Starts the global Celery task registry.

@spec unregister(String.t()) :: :ok

Unregisters a task by name from the global registry.