core-framework 0.12.6__tar.gz → 0.12.8__tar.gz

{core_framework-0.12.6 → core_framework-0.12.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: core-framework
-Version: 0.12.6
+Version: 0.12.8
 Summary: Core Framework - Django-inspired, FastAPI-powered. Alta performance, baixo acoplamento, produtividade extrema.
 Project-URL: Homepage, https://github.com/SorPuti/core-framework
 Project-URL: Documentation, https://github.com/SorPuti/core-framework#readme
@@ -56,6 +56,11 @@ Provides-Extra: rabbitmq
 Requires-Dist: aio-pika>=9.0.0; extra == 'rabbitmq'
 Provides-Extra: redis
 Requires-Dist: redis>=5.0.0; extra == 'redis'
+Provides-Extra: testing
+Requires-Dist: faker>=20.0.0; extra == 'testing'
+Requires-Dist: httpx>=0.26.0; extra == 'testing'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'testing'
+Requires-Dist: pytest>=7.4.0; extra == 'testing'
 Description-Content-Type: text/markdown
 
 # Core Framework

{core_framework-0.12.6 → core_framework-0.12.8}/core/__init__.py

@@ -278,7 +278,7 @@ from core.exceptions import (
     MissingDependency,
 )
 
-__version__ = "0.12.6"
+__version__ = "0.12.8"
 __all__ = [
     # Models
     "Model",

{core_framework-0.12.6 → core_framework-0.12.8}/core/auth/decorators.py

@@ -24,12 +24,33 @@ from typing import Any, TYPE_CHECKING
 from fastapi import Depends, HTTPException, Request, status
 
 from core.permissions import Permission as PermissionBase
-from core.auth.helpers import get_request_user
 
 if TYPE_CHECKING:
     pass
 
 
+def _get_user(request: Request) -> Any | None:
+    """
+    Get authenticated user from request.
+    
+    Internal helper to avoid circular imports.
+    Checks both Starlette and legacy patterns.
+    """
+    # Pattern 1: request.user (Starlette AuthenticationMiddleware)
+    user = getattr(request, "user", None)
+    if user is not None:
+        if getattr(user, "is_authenticated", False):
+            if hasattr(user, "_user"):
+                return user._user
+            return user
+    
+    # Pattern 2: request.state.user (legacy)
+    if hasattr(request, "state"):
+        return getattr(request.state, "user", None)
+    
+    return None
+
+
 # =============================================================================
 # Classes de Permissão (para uso em ViewSets)
 # =============================================================================
@@ -71,7 +92,7 @@ class HasPermission(PermissionBase):
         request: Request,
         view: Any = None,
     ) -> bool:
-        user = get_request_user(request)
+        user = _get_user(request)
         
         if user is None:
             return False
@@ -136,7 +157,7 @@ class IsInGroup(PermissionBase):
         request: Request,
         view: Any = None,
     ) -> bool:
-        user = get_request_user(request)
+        user = _get_user(request)
         
         if user is None:
             return False
@@ -180,7 +201,7 @@ class IsSuperuser(PermissionBase):
         request: Request,
         view: Any = None,
     ) -> bool:
-        user = get_request_user(request)
+        user = _get_user(request)
         
         if user is None:
             return False
@@ -208,7 +229,7 @@ class IsStaff(PermissionBase):
         request: Request,
         view: Any = None,
     ) -> bool:
-        user = get_request_user(request)
+        user = _get_user(request)
         
         if user is None:
             return False
@@ -236,7 +257,7 @@ class IsActive(PermissionBase):
         request: Request,
         view: Any = None,
     ) -> bool:
-        user = get_request_user(request)
+        user = _get_user(request)
         
         if user is None:
             return False
@@ -372,7 +393,7 @@ def login_required():
             ...
     """
     async def check(request: Request):
-        user = get_request_user(request)
+        user = _get_user(request)
         
         if user is None:
             raise HTTPException(

{core_framework-0.12.6 → core_framework-0.12.8}/core/cli/__init__.py

@@ -10,6 +10,8 @@ Comandos disponíveis:
 - core run: Executa o servidor de desenvolvimento
 - core shell: Abre shell interativo
 - core routes: Lista rotas registradas
+- core test: Executa testes com ambiente isolado
+- core version: Mostra versão do framework
 """
 
 from core.cli.main import cli, main

{core_framework-0.12.6 → core_framework-0.12.8}/core/cli/main.py

@@ -13,7 +13,16 @@ Comandos:
     run             Executa servidor de desenvolvimento
     shell           Abre shell interativo async
     routes          Lista rotas registradas
+    test            Executa testes com ambiente isolado
     version         Mostra versão do framework
+
+Comando test:
+    core test                       # Roda todos os testes em tests/
+    core test tests/test_auth.py    # Roda arquivo específico
+    core test -v                    # Saída verbosa
+    core test --cov                 # Com cobertura de código
+    core test -k "test_login"       # Filtrar por keyword
+    core test -m unit               # Apenas testes unitários
 """
 
 from __future__ import annotations
@@ -472,6 +481,112 @@ def cmd_version(args: argparse.Namespace) -> int:
     return 0
 
 
+def cmd_test(args: argparse.Namespace) -> int:
+    """
+    Run tests with auto-discovery and isolated environment.
+    
+    This command:
+    - Automatically sets up an isolated test environment
+    - Initializes database with in-memory SQLite
+    - Configures auth, settings, and middleware
+    - Runs pytest with appropriate options
+    - Supports coverage reporting
+    
+    Usage:
+        core test                    # Run all tests in tests/
+        core test tests/test_auth.py # Run specific file
+        core test -v                 # Verbose output
+        core test --cov              # With coverage
+        core test -k "test_login"    # Filter by keyword
+        core test -m unit            # Only unit tests
+    """
+    import subprocess
+    import shutil
+    
+    # Check if pytest is installed
+    pytest_path = shutil.which("pytest")
+    if not pytest_path:
+        print(error("pytest not installed. Install with:"))
+        print(info("  pip install pytest pytest-asyncio"))
+        return 1
+    
+    print(bold("🧪 Core Framework Test Runner"))
+    print()
+    
+    # Build pytest command
+    cmd = ["python", "-m", "pytest"]
+    
+    # Add test path
+    cmd.append(args.path)
+    
+    # Verbose
+    if args.verbose:
+        cmd.append("-v")
+    
+    # Keyword filter
+    if args.keyword:
+        cmd.extend(["-k", args.keyword])
+    
+    # Exit on first failure
+    if args.exitfirst:
+        cmd.append("-x")
+    
+    # Marker filter
+    if args.marker:
+        cmd.extend(["-m", args.marker])
+    
+    # No header
+    if args.no_header:
+        cmd.append("--no-header")
+    
+    # Coverage
+    if args.cov:
+        # Check if pytest-cov is installed
+        if not shutil.which("pytest-cov") and not _check_pytest_cov():
+            print(warning("pytest-cov not installed. Install with:"))
+            print(info("  pip install pytest-cov"))
+            print()
+        
+        cmd.append(f"--cov={args.cov}")
+        cmd.append(f"--cov-report={args.cov_report}")
+    
+    # Always use asyncio mode auto
+    cmd.extend(["--asyncio-mode=auto"])
+    
+    # Show short traceback
+    cmd.append("--tb=short")
+    
+    print(info(f"Running: {' '.join(cmd)}"))
+    print()
+    
+    # Set environment variables for isolated testing
+    env = os.environ.copy()
+    env["TESTING"] = "true"
+    env["DEBUG"] = "true"
+    env.setdefault("DATABASE_URL", "sqlite+aiosqlite:///:memory:")
+    env.setdefault("SECRET_KEY", "test-secret-key-for-testing-only")
+    
+    # Run pytest
+    try:
+        result = subprocess.run(cmd, env=env)
+        return result.returncode
+    except KeyboardInterrupt:
+        print(warning("\nTests interrupted"))
+        return 130
+    except Exception as e:
+        print(error(f"Error running tests: {e}"))
+        return 1
+
+
+def _check_pytest_cov() -> bool:
+    """Check if pytest-cov is installed as a module."""
+    try:
+        import pytest_cov
+        return True
+    except ImportError:
+        return False
+
+
 def check_uv_installed() -> bool:
     """Verifica se uv está instalado."""
     import shutil
@@ -3747,6 +3862,54 @@ For more information, visit: https://github.com/SorPuti/core-framework
     )
     tasks_parser.set_defaults(func=cmd_tasks)
     
+    # test
+    test_parser = subparsers.add_parser(
+        "test",
+        help="Run tests with auto-discovery and isolated environment"
+    )
+    test_parser.add_argument(
+        "path",
+        nargs="?",
+        default="tests",
+        help="Test path or file (default: tests)"
+    )
+    test_parser.add_argument(
+        "-v", "--verbose",
+        action="store_true",
+        help="Verbose output"
+    )
+    test_parser.add_argument(
+        "-k", "--keyword",
+        help="Only run tests matching keyword expression"
+    )
+    test_parser.add_argument(
+        "-x", "--exitfirst",
+        action="store_true",
+        help="Exit on first failure"
+    )
+    test_parser.add_argument(
+        "--cov",
+        nargs="?",
+        const=".",
+        help="Enable coverage (optionally specify source)"
+    )
+    test_parser.add_argument(
+        "--cov-report",
+        choices=["term", "html", "xml", "json"],
+        default="term",
+        help="Coverage report format"
+    )
+    test_parser.add_argument(
+        "-m", "--marker",
+        help="Only run tests with this marker (e.g., 'unit', 'integration')"
+    )
+    test_parser.add_argument(
+        "--no-header",
+        action="store_true",
+        help="Disable pytest header"
+    )
+    test_parser.set_defaults(func=cmd_test)
+    
     return parser
 
 

{core_framework-0.12.6 → core_framework-0.12.8}/core/permissions.py

@@ -15,12 +15,33 @@ from typing import Any, TYPE_CHECKING
 
 from fastapi import HTTPException, Request, status
 
-from core.auth.helpers import get_request_user
-
 if TYPE_CHECKING:
     from core.views import APIView
 
 
+def _get_user(request: Request) -> Any | None:
+    """
+    Get authenticated user from request.
+    
+    Internal helper to avoid circular imports.
+    Checks both Starlette and legacy patterns.
+    """
+    # Pattern 1: request.user (Starlette AuthenticationMiddleware)
+    user = getattr(request, "user", None)
+    if user is not None:
+        if getattr(user, "is_authenticated", False):
+            # If it's our AuthenticatedUser wrapper, return the underlying model
+            if hasattr(user, "_user"):
+                return user._user
+            return user
+    
+    # Pattern 2: request.state.user (legacy)
+    if hasattr(request, "state"):
+        return getattr(request.state, "user", None)
+    
+    return None
+
+
 class Permission(ABC):
     """
     Classe base para permissões.
@@ -34,7 +55,7 @@ class Permission(ABC):
                 request: Request,
                 view: APIView | None = None,
             ) -> bool:
-                user = get_request_user(request)
+                user = _get_user(request)
                 return user is not None and user.is_admin
     """
     
@@ -216,7 +237,7 @@ class IsAuthenticated(Permission):
         request: Request,
         view: "APIView | None" = None,
     ) -> bool:
-        user = get_request_user(request)
+        user = _get_user(request)
         return user is not None
 
 
@@ -238,7 +259,7 @@ class IsAuthenticatedOrReadOnly(Permission):
         if request.method in self.SAFE_METHODS:
             return True
         
-        user = get_request_user(request)
+        user = _get_user(request)
         return user is not None
 
 
@@ -252,7 +273,7 @@ class IsAdmin(Permission):
         request: Request,
         view: "APIView | None" = None,
     ) -> bool:
-        user = get_request_user(request)
+        user = _get_user(request)
         if user is None:
             return False
         
@@ -287,7 +308,7 @@ class IsOwner(Permission):
         if obj is None:
             return True
         
-        user = get_request_user(request)
+        user = _get_user(request)
         if user is None:
             return False
         
@@ -320,7 +341,7 @@ class HasRole(Permission):
         request: Request,
         view: "APIView | None" = None,
     ) -> bool:
-        user = get_request_user(request)
+        user = _get_user(request)
         if user is None:
             return False
         

core_framework-0.12.8/core/testing/__init__.py

@@ -0,0 +1,99 @@
+"""
+Testing utilities for core-framework applications.
+
+This module provides a complete testing toolkit for applications built
+with core-framework, including:
+
+- TestClient: HTTP client with automatic test database setup
+- AuthenticatedClient: Pre-authenticated HTTP client
+- TestDatabase: Database utilities for testing
+- MockKafka, MockRedis, MockHTTP: Mock services
+- Factory: Data factory pattern for test data generation
+
+Usage:
+    # In your conftest.py
+    import pytest
+    from your_app import app as _app
+    
+    @pytest.fixture(scope="session")
+    def app():
+        return _app.app
+    
+    # In your tests
+    class TestUsers:
+        async def test_register(self, client):
+            response = await client.post("/auth/register", json={...})
+            assert response.status_code == 201
+        
+        async def test_profile(self, auth_client):
+            response = await auth_client.get("/auth/me")
+            assert response.status_code == 200
+
+Quick Start:
+    1. Install test dependencies: pip install core-framework[testing]
+    2. Add to pyproject.toml:
+       [tool.pytest.ini_options]
+       asyncio_mode = "auto"
+       plugins = ["core.testing.plugin"]
+    3. Create conftest.py with your app fixture
+    4. Write tests using provided fixtures
+"""
+
+from core.testing.client import (
+    TestClient,
+    AuthenticatedClient,
+    create_test_client,
+    create_auth_client,
+)
+from core.testing.database import (
+    TestDatabase,
+    setup_test_db,
+    teardown_test_db,
+    get_test_session,
+)
+from core.testing.mocks import (
+    MockKafka,
+    MockRedis,
+    MockHTTP,
+    MockMessage,
+    MockHTTPResponse,
+)
+from core.testing.factories import (
+    Factory,
+    UserFactory,
+    fake,
+)
+from core.testing.assertions import (
+    assert_status,
+    assert_json_contains,
+    assert_error_code,
+    assert_validation_error,
+)
+
+__all__ = [
+    # Client
+    "TestClient",
+    "AuthenticatedClient",
+    "create_test_client",
+    "create_auth_client",
+    # Database
+    "TestDatabase",
+    "setup_test_db",
+    "teardown_test_db",
+    "get_test_session",
+    # Mocks
+    "MockKafka",
+    "MockRedis",
+    "MockHTTP",
+    "MockMessage",
+    "MockHTTPResponse",
+    # Factories
+    "Factory",
+    "UserFactory",
+    "fake",
+    # Assertions
+    "assert_status",
+    "assert_json_contains",
+    "assert_error_code",
+    "assert_validation_error",
+]