fastapi-djauth 1.4.0__py3-none-any.whl

djauth/__init__.py

@@ -0,0 +1,82 @@
+"""djauth: usuarios, grupos (roles), permisos y administración al estilo de Django, para FastAPI.
+
+from djauth import AuthKit, AuthSettings, current_user, require_perm
+
+kit = AuthKit(AuthSettings(database_url="sqlite:///auth.sqlite3")).init()
+kit.install(app, protect=True)
+"""
+
+from djauth.api import (
+    AuthMiddleware,
+    Rule,
+    current_user,
+    identify,
+    optional_user,
+    require_perm,
+    require_staff,
+    require_superuser,
+    rule,
+    ws_user,
+)
+from djauth.backends import AllowAllUsersModelBackend, AuthRequest, BaseBackend, ModelBackend
+from djauth.core import SERVICE_USER, AuthKit, AuthUser
+from djauth.database import DatabaseConfigError, url_from_django
+from djauth.decorators import login_required, permission_required, staff_member_required, superuser_required, user_passes_test
+from djauth.errors import (
+    AuthError,
+    InvalidCredentialsError,
+    NotAuthenticatedError,
+    NotFoundError,
+    PermissionDeniedError,
+    TooManyAttemptsError,
+    ValidationError,
+)
+from djauth.hashers import check_password, make_password
+from djauth.routers import BaseRouter, Databases, ModelMeta, RoutingSession, model_meta
+from djauth.settings import AuthSettings, ExtraField
+
+__version__ = "1.4.0"
+
+__all__ = [
+    "SERVICE_USER",
+    "AllowAllUsersModelBackend",
+    "AuthError",
+    "AuthKit",
+    "AuthMiddleware",
+    "AuthRequest",
+    "AuthSettings",
+    "AuthUser",
+    "BaseBackend",
+    "BaseRouter",
+    "DatabaseConfigError",
+    "Databases",
+    "ExtraField",
+    "InvalidCredentialsError",
+    "ModelBackend",
+    "ModelMeta",
+    "NotAuthenticatedError",
+    "NotFoundError",
+    "PermissionDeniedError",
+    "RoutingSession",
+    "Rule",
+    "TooManyAttemptsError",
+    "ValidationError",
+    "__version__",
+    "check_password",
+    "current_user",
+    "identify",
+    "login_required",
+    "make_password",
+    "model_meta",
+    "optional_user",
+    "permission_required",
+    "require_perm",
+    "require_staff",
+    "require_superuser",
+    "rule",
+    "staff_member_required",
+    "superuser_required",
+    "url_from_django",
+    "user_passes_test",
+    "ws_user",
+]

djauth/__main__.py

@@ -0,0 +1,98 @@
+"""Comandos de administración (como `manage.py`):
+
+    python -m djauth --db sqlite:///auth.sqlite3 createsuperuser --username admin --email a@b.co
+    python -m djauth --db … changepassword admin
+    python -m djauth --db … listusers
+    djauth startproject inventario --db postgresql      # proyecto FastAPI nuevo con djauth integrado
+
+La contraseña se pide por teclado; para scripts, use la variable DJAUTH_PASSWORD.
+"""
+
+from __future__ import annotations
+
+import argparse
+import getpass
+import os
+import sys
+
+from djauth.core import AuthKit
+from djauth.errors import AuthError, ValidationError
+from djauth.settings import AuthSettings
+
+
+def _ask_password() -> str:
+    if env := os.environ.get("DJAUTH_PASSWORD"):
+        return env
+    while True:
+        first = getpass.getpass("Contraseña: ")
+        if first == getpass.getpass("Contraseña (otra vez): "):
+            return first
+        print("Las contraseñas no coinciden.", file=sys.stderr)
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(prog="python -m djauth", description="Administración de usuarios de djauth")
+    parser.add_argument(
+        "--db", default=os.environ.get("DJAUTH_DATABASE_URL", "sqlite:///auth.sqlite3"), help="URL de la base de datos"
+    )
+    parser.add_argument("--prefix", default="auth_", help="Prefijo de las tablas")
+    sub = parser.add_subparsers(dest="command", required=True)
+    create = sub.add_parser("createsuperuser", help="Crear un superusuario")
+    create.add_argument("--username", required=True)
+    create.add_argument("--email", default="")
+    change = sub.add_parser("changepassword", help="Cambiar la contraseña de un usuario")
+    change.add_argument("username")
+    sub.add_parser("listusers", help="Listar usuarios")
+    start = sub.add_parser("startproject", help="Crear un proyecto FastAPI nuevo con djauth integrado")
+    start.add_argument("name", help="Nombre del paquete: minúsculas, números y _ (p. ej. inventario)")
+    start.add_argument("directory", nargs="?", help="Carpeta donde crearlo (por defecto ./<name>; debe estar vacía)")
+    start.add_argument("--db", dest="db_engine", choices=("sqlite", "postgresql", "mysql"), default="sqlite")
+    start.add_argument(
+        "--versiones",
+        dest="versions",
+        choices=("probadas", "ultimas"),
+        default="probadas",
+        help="probadas: versiones exactas verificadas con este djauth · ultimas: lo más reciente compatible",
+    )
+    start.add_argument("--titulo", dest="title", help='Nombre visible de la aplicación (p. ej. "Inventario de planta")')
+    start.add_argument("--sin-lock", dest="no_lock", action="store_true", help="No ejecutar `uv lock` al terminar")
+    args = parser.parse_args(argv)
+
+    if args.command == "startproject":
+        from djauth.startproject import main as startproject
+
+        return startproject(args)
+
+    kit = AuthKit(AuthSettings(database_url=args.db, table_prefix=args.prefix)).init()
+    try:
+        if args.command == "createsuperuser":
+            created = kit.create_superuser(
+                args.username, _ask_password(), email=args.email, reason="Creado con djauth createsuperuser."
+            )
+            print(f"Superusuario {created['username']} creado.")
+        elif args.command == "changepassword":
+            user = kit.get_by_username(args.username)
+            if user is None:
+                print(f"No existe el usuario {args.username}.", file=sys.stderr)
+                return 1
+            kit.set_password(user.id, _ask_password(), reason="Cambiada con djauth changepassword.")
+            print(f"Contraseña de {user.username} cambiada; sus sesiones abiertas se cerraron.")
+        elif args.command == "listusers":
+            items, total = kit.list_users(limit=1000)
+            for u in items:
+                flags = "".join(f for f, on in (("S", u["is_superuser"]), ("A", u["is_staff"]), ("-", not u["is_active"])) if on)
+                print(f"{u['id']:>5}  {u['username']:<30} {flags:<3} {', '.join(u['groups'])}")
+            print(f"{total} usuarios")
+    except ValidationError as exc:
+        for field, messages in exc.errors.items():
+            for m in messages:
+                print(f"{field}: {m}", file=sys.stderr)
+        return 1
+    except AuthError as exc:
+        print(str(exc), file=sys.stderr)
+        return 1
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())