maquinaweb-shared-auth 0.2.28__py3-none-any.whl → 0.2.29__py3-none-any.whl

{maquinaweb_shared_auth-0.2.28.dist-info → maquinaweb_shared_auth-0.2.29.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maquinaweb-shared-auth
-Version: 0.2.28
+Version: 0.2.29
 Summary: Models read-only para autenticação compartilhada entre projetos Django.
 Author-email: Seu Nome <seuemail@dominio.com>
 License: MIT

{maquinaweb_shared_auth-0.2.28.dist-info → maquinaweb_shared_auth-0.2.29.dist-info}/RECORD

@@ -5,7 +5,7 @@ shared_auth/conf.py,sha256=WlSXQB7p3BfE3BL6WR6EDYpCHQEjDlxQlyf8dTfClsk,621
 shared_auth/decorators.py,sha256=RT-Qfi7oGBo6PvWJRR1dqJUQdU6ZOf9p-8mV3rZmqQ0,3237
 shared_auth/exceptions.py,sha256=VKamHjBl2yjXG2RsMrLrXru1_Q9IJXmy4xmDcXlpWsU,627
 shared_auth/fields.py,sha256=RAcmFh1D_nkbai_7t_OrPZhfhAipesy5kKnEj4LUvvM,1254
-shared_auth/managers.py,sha256=xRj8d5r2Q5pBi36dQAOasS7EPvUUehb0eFbA-sAuzxY,6727
+shared_auth/managers.py,sha256=WB0tU3asVxwS4tFq2R9-zXtWMBpvOuM94_SehGbVQFw,8268
 shared_auth/middleware.py,sha256=72GF8kGijbhw98v2Q-1sXBXk-7Bamfyvypm9h8xLX_I,6112
 shared_auth/mixins.py,sha256=BSYNTWYjLRGuxfy7x-uAaNZmrTMsm67ogAQzjrU2DoQ,7388
 shared_auth/models.py,sha256=vCyssDwKfWRE3ofl6LK_CB1-y5O-_6uvJyGZGoCnb44,6574
@@ -15,7 +15,7 @@ shared_auth/serializers.py,sha256=VmajFqnAHB5wyxsdd5_WVegAQygi0KNOMk7vScCPHiQ,73
 shared_auth/storage_backend.py,sha256=Eqkjz8aF5UrOpRwYl-J0Td95IObfxnJ8eLQDJVFM3Io,184
 shared_auth/urls.py,sha256=591wWEWJPaHEGkcOZ8yvfgxddRyOcZLgOc0vNtF7XRI,289
 shared_auth/views.py,sha256=2hyLnYSWUscfq-jVcskt-ukzDt4vg6IXeKjRDRu9RXk,1519
-maquinaweb_shared_auth-0.2.28.dist-info/METADATA,sha256=_5GAwOTIYAawX33fPW4kRXYzc1z2Zh_fThPyaLo-Ows,26331
-maquinaweb_shared_auth-0.2.28.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-maquinaweb_shared_auth-0.2.28.dist-info/top_level.txt,sha256=msyYRy02ZV7zz7GR1raUI5LXGFIFn2TIkgkeKZqKufE,12
-maquinaweb_shared_auth-0.2.28.dist-info/RECORD,,
+maquinaweb_shared_auth-0.2.29.dist-info/METADATA,sha256=0zltusF9fsm1p4ldeM4su1hxpCactgoNbIFQZhDQEJM,26331
+maquinaweb_shared_auth-0.2.29.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+maquinaweb_shared_auth-0.2.29.dist-info/top_level.txt,sha256=msyYRy02ZV7zz7GR1raUI5LXGFIFn2TIkgkeKZqKufE,12
+maquinaweb_shared_auth-0.2.29.dist-info/RECORD,,

shared_auth/managers.py

@@ -89,13 +89,27 @@ class OrganizationQuerySetMixin:
 
     def with_organization_data(self):
         """
-        Pré-carrega dados de organizações (evita N+1)
+        Pré-carrega dados de organizações (evita N+1 queries)
+
+        Faz uma única query bulk para buscar todas as organizações necessárias
+        e cacheia nos objetos usando _cached_organization.
+
+        Usage:
+            # Sem otimização (N+1 queries)
+            rascunhos = Rascunho.objects.all()
+            for r in rascunhos:
+                print(r.organization.name)  # Query individual para cada
+
+            # Com otimização (2 queries total)
+            rascunhos = Rascunho.objects.all().with_organization_data()
+            for r in rascunhos:
+                print(r.organization.name)  # Usa cache, sem queries extras
 
         Returns:
             Lista de objetos com _cached_organization
         """
         objects = list(self.all())
-        from . import SharedOrganization
+        from .models import SharedOrganization
 
         if not objects:
             return objects
@@ -128,9 +142,15 @@ class UserQuerySetMixin:
 
     def with_user_data(self):
         """
-        Pré-carrega dados de usuários (evita N+1)
+        Pré-carrega dados de usuários (evita N+1 queries)
+
+        Usage:
+            # Com otimização (2 queries total)
+            rascunhos = Rascunho.objects.all().with_user_data()
+            for r in rascunhos:
+                print(r.user.email)  # Usa cache, sem queries extras
         """
-        from . import SharedUser
+        from .models import User
 
         objects = list(self.all())
 
@@ -139,7 +159,7 @@ class UserQuerySetMixin:
 
         user_ids = set(obj.user_id for obj in objects)
 
-        users = {user.pk: user for user in SharedUser.objects.filter(pk__in=user_ids)}
+        users = {user.pk: user for user in User.objects.filter(pk__in=user_ids)}
 
         for obj in objects:
             obj._cached_user = users.get(obj.user_id)
@@ -152,9 +172,27 @@ class OrganizationUserQuerySetMixin(OrganizationQuerySetMixin, UserQuerySetMixin
 
     def with_auth_data(self):
         """
-        Pré-carrega dados de organizações E usuários (evita N+1)
+        Pré-carrega dados de organizações E usuários (evita N+1 queries)
+
+        Faz apenas 3 queries no total, independente da quantidade de objetos:
+        1. Query dos objetos principais
+        2. Query bulk das organizações
+        3. Query bulk dos usuários
+
+        Usage:
+            # Sem otimização (1 + N + N queries)
+            rascunhos = Rascunho.objects.all()  # 1 query
+            for r in rascunhos:
+                print(r.organization.name)  # N queries
+                print(r.user.email)  # N queries
+
+            # Com otimização (3 queries total)
+            rascunhos = Rascunho.objects.all().with_auth_data()
+            for r in rascunhos:
+                print(r.organization.name)  # Cache
+                print(r.user.email)  # Cache
         """
-        from . import SharedOrganization, SharedUser
+        from .models import SharedOrganization, User
 
         objects = list(self.all())
 
@@ -170,7 +208,7 @@ class OrganizationUserQuerySetMixin(OrganizationQuerySetMixin, UserQuerySetMixin
             org.pk: org for org in SharedOrganization.objects.filter(pk__in=org_ids)
         }
 
-        users = {user.pk: user for user in SharedUser.objects.filter(pk__in=user_ids)}
+        users = {user.pk: user for user in User.objects.filter(pk__in=user_ids)}
 
         # Cachear
         for obj in objects:
@@ -183,7 +221,7 @@ class OrganizationUserQuerySetMixin(OrganizationQuerySetMixin, UserQuerySetMixin
         """
         Cria objeto com validação de organização e usuário
         """
-        from . import SharedMember, SharedOrganization
+        from .models import SharedMember, SharedOrganization
 
         # Valida organização
         SharedOrganization.objects.get_or_fail(organization_id)