Relocate providers/helpers into foundation and support

example/console-app/providers/console.py

@@ -1,5 +1,5 @@
 from commands.example_command import ExampleCommand
-from fastapi_startkit.providers import Provider
+from fastapi_startkit.support import Provider
 
 
 class ConsoleServiceProvider(Provider):

example/database-app/providers/console_provider.py

@@ -1,4 +1,4 @@
-from fastapi_startkit.providers import Provider
+from fastapi_startkit.support import Provider
 
 class ConsoleProvider(Provider):
     def register(self) -> None:

fastapi_startkit/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+## 0.48.0
+
+### Breaking changes
+
+The top-level `fastapi_startkit.providers` package has been removed. Its
+contents moved into `foundation` and `support`, and there is **no**
+backward-compatibility shim — consumers must update their imports:
+
+| Old import | New import |
+|---|---|
+| `from fastapi_startkit.providers import Provider` | `from fastapi_startkit.support import Provider` |
+| `from fastapi_startkit.providers.app_provider import ...` | `from fastapi_startkit.foundation.app_provider import ...` |
+| `from fastapi_startkit.helpers.dataclass import ...` | `from fastapi_startkit.support.dataclass import ...` |
+
+`fastapi_startkit.helpers.app` has been removed.

fastapi_startkit/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fastapi-startkit"
-version = "0.47.0"
+version = "0.48.0"
 description = "A modular, provider-driven framework for building async Python web applications with FastAPI — bundling a service container, configuration system, an async-first ORM, facades, and a Cleo-powered console."
 keywords = [
     "fastapi",

fastapi_startkit/src/fastapi_startkit/ai/providers/ai_provider.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from fastapi_startkit.providers import Provider
+from fastapi_startkit.support import Provider
 
 
 class AIProvider(Provider):

fastapi_startkit/src/fastapi_startkit/application.py

@@ -1,6 +1,6 @@
 import os
 import shlex
-from fastapi_startkit.providers.app_provider import AppProvider
+from fastapi_startkit.foundation.app_provider import AppProvider
 from pathlib import Path
 from typing import TYPE_CHECKING, Optional
 from typing import Type, Callable, Any, List, TypeVar, Generic

fastapi_startkit/src/fastapi_startkit/broadcasting/provider.py

@@ -5,7 +5,7 @@
 import sys
 from pathlib import Path
 
-from ..providers import Provider
+from fastapi_startkit.support import Provider
 from .config import BroadcastingConfig
 from .manager import BroadcastManager
 from .reverb.server import ReverbServer

fastapi_startkit/src/fastapi_startkit/configuration/Configuration.py

@@ -51,7 +51,7 @@ def merge_with(self, path, external_config):
         self.set(path, merged_config)
 
     def set(self, path, value):
-        from fastapi_startkit.helpers.dataclass import Dataclass
+        from fastapi_startkit.support.dataclass import Dataclass
 
         self._config[path] = Dataclass.to_dict(value)
 

fastapi_startkit/src/fastapi_startkit/configuration/providers/ConfigurationProvider.py

@@ -1,4 +1,4 @@
-from ...providers import Provider
+from fastapi_startkit.support import Provider
 
 from ..Configuration import Configuration
 

fastapi_startkit/src/fastapi_startkit/fastapi/providers/fastapi_provider.py

@@ -3,7 +3,7 @@
 
 from fastapi_startkit.fastapi.commands import ServeCommand
 from fastapi_startkit.fastapi.config import FastAPIConfig
-from fastapi_startkit.providers import Provider
+from fastapi_startkit.support import Provider
 
 
 class FastAPIProvider(Provider):

fastapi_startkit/src/fastapi_startkit/providers/app_provider.py → fastapi_startkit/src/fastapi_startkit/foundation/app_provider.py

@@ -1,5 +1,5 @@
 from fastapi_startkit.console.publish_command import PublishCommand
-from fastapi_startkit.providers import Provider
+from fastapi_startkit.support import Provider
 
 
 class AppProvider(Provider):

fastapi_startkit/src/fastapi_startkit/inertia/provider.py

@@ -1,6 +1,6 @@
 import json
 from markupsafe import Markup
-from fastapi_startkit.providers import Provider
+from fastapi_startkit.support import Provider
 from .inertia import Inertia
 from .middleware import InertiaMiddleware
 

fastapi_startkit/src/fastapi_startkit/logging/providers/log_provider.py

@@ -1,6 +1,6 @@
 from pathlib import Path
 
-from fastapi_startkit.providers import Provider
+from fastapi_startkit.support import Provider
 from ..ChannelFactory import ChannelFactory
 from ..config.logging import LoggingConfig
 from ..factory import DriverFactory

fastapi_startkit/src/fastapi_startkit/masoniteorm/providers/DatabaseProvider.py

@@ -14,7 +14,7 @@
 from fastapi_startkit.masoniteorm.connections.manager import DatabaseManager
 from fastapi_startkit.masoniteorm import Migrator
 from fastapi_startkit.masoniteorm import Model
-from fastapi_startkit.providers.Provider import Provider
+from fastapi_startkit.support import Provider
 
 
 class DatabaseProvider(Provider):

fastapi_startkit/src/fastapi_startkit/mcp/providers/mcp_provider.py

@@ -1,4 +1,4 @@
-from fastapi_startkit.providers import Provider
+from fastapi_startkit.support import Provider
 
 
 class McpProvider(Provider):

fastapi_startkit/src/fastapi_startkit/skills/provider.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from fastapi_startkit.providers import Provider
+from fastapi_startkit.support import Provider
 
 
 class AISkillProvider(Provider):

fastapi_startkit/src/fastapi_startkit/storage/providers/provider.py

@@ -1,5 +1,5 @@
 from pathlib import Path
-from ...providers import Provider
+from fastapi_startkit.support import Provider
 from ..storage import StorageManager
 from ...configuration import config
 from ..drivers import LocalDriver, S3Driver

fastapi_startkit/src/fastapi_startkit/support/__init__.py

@@ -1,5 +1,6 @@
 from .collection import Collection, collect
 from .string import Str, Stringable
 from .uri import Uri, Uriable
+from fastapi_startkit.support.providers import Provider
 
-__all__ = ["Collection", "collect", "Str", "Stringable", "Uri", "Uriable"]
+__all__ = ["Collection", "collect", "Str", "Stringable", "Uri", "Uriable", "Provider"]

fastapi_startkit/src/fastapi_startkit/support/providers/__init__.py

@@ -0,0 +1,3 @@
+from fastapi_startkit.support.providers.provider import Provider
+
+__all__ = ["Provider"]

fastapi_startkit/src/fastapi_startkit/providers/Provider.py → fastapi_startkit/src/fastapi_startkit/support/providers/provider.py

@@ -1,11 +1,10 @@
 from typing import TYPE_CHECKING
 
 from fastapi_startkit.support import Str
-
-from fastapi_startkit.helpers.dataclass import Dataclass
+from fastapi_startkit.support.dataclass import Dataclass
 
 if TYPE_CHECKING:
-    from ..application import Application
+    from fastapi_startkit.application import Application
 
 
 class Provider:

fastapi_startkit/src/fastapi_startkit/vite/providers/provider.py

@@ -1,7 +1,7 @@
 import os
 
 
-from fastapi_startkit.providers import Provider
+from fastapi_startkit.support import Provider
 from ..config.vite import ViteConfig
 
 from ..vite import Vite

fastapi_startkit/tests/ai/test_provider.py

@@ -5,7 +5,7 @@
 
 from fastapi_startkit.ai import AIConfig
 from fastapi_startkit.ai.providers.ai_provider import AIProvider
-from fastapi_startkit.providers import Provider
+from fastapi_startkit.support import Provider
 
 
 class TestAIProvider(unittest.TestCase):

fastapi_startkit/tests/core/test_application.py

@@ -6,7 +6,7 @@
 
 from fastapi_startkit.application import Application
 from fastapi_startkit.container.container import Container
-from fastapi_startkit.providers import Provider
+from fastapi_startkit.support import Provider
 
 
 # ---------------------------------------------------------------------------

fastapi_startkit/tests/core/test_providers.py

@@ -4,7 +4,7 @@
 
 from fastapi_startkit.application import Application
 from fastapi_startkit.container.container import Container
-from fastapi_startkit.providers import Provider
+from fastapi_startkit.support import Provider
 
 
 # ---------------------------------------------------------------------------

fastapi_startkit/tests/mcp/test_mcp_provider.py

@@ -1,7 +1,7 @@
 """Tests for McpProvider."""
 
 from fastapi_startkit.mcp import McpProvider
-from fastapi_startkit.providers import Provider
+from fastapi_startkit.support import Provider
 
 
 def test_mcp_provider_is_a_provider():

fastapi_startkit/tests/vite/test_template_binding.py

@@ -4,7 +4,7 @@
 import pytest
 
 from fastapi_startkit.application import Application
-from fastapi_startkit.providers import Provider
+from fastapi_startkit.support import Provider
 from fastapi_startkit.vite import ViteProvider
 from fastapi_startkit.vite.config.vite import ViteConfig