edx-enterprise-data 10.7.0__tar.gz → 10.7.1__tar.gz

{edx_enterprise_data-10.7.0 → edx_enterprise_data-10.7.1}/CHANGELOG.rst

@@ -16,6 +16,11 @@ Unreleased
 
 =========================
 
+[10.7.1] - 2025-01-07
+---------------------
+  * feat: add group_membership table
+  * feat: add APIs to support LPR filtering for enterprise groups
+
 [10.7.0] - 2024-12-24
 ---------------------
   * feat: Added user's first and last name in the enterprise enrollments API and related DB table.

{edx_enterprise_data-10.7.0/edx_enterprise_data.egg-info → edx_enterprise_data-10.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: edx-enterprise-data
-Version: 10.7.0
+Version: 10.7.1
 Summary: Enterprise Reporting
 Home-page: https://github.com/openedx/edx-enterprise-data
 Author: edX
@@ -39,5 +39,14 @@ Requires-Dist: pyminizip; extra == "reporting"
 Requires-Dist: snowflake-connector-python; extra == "reporting"
 Requires-Dist: unicodecsv==0.14.1; extra == "reporting"
 Requires-Dist: vertica-python; extra == "reporting"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: home-page
+Dynamic: license
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: summary
 
 Tools and products related to providing access to Enterprise data.

{edx_enterprise_data-10.7.0 → edx_enterprise_data-10.7.1/edx_enterprise_data.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: edx-enterprise-data
-Version: 10.7.0
+Version: 10.7.1
 Summary: Enterprise Reporting
 Home-page: https://github.com/openedx/edx-enterprise-data
 Author: edX
@@ -39,5 +39,14 @@ Requires-Dist: pyminizip; extra == "reporting"
 Requires-Dist: snowflake-connector-python; extra == "reporting"
 Requires-Dist: unicodecsv==0.14.1; extra == "reporting"
 Requires-Dist: vertica-python; extra == "reporting"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: home-page
+Dynamic: license
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: summary
 
 Tools and products related to providing access to Enterprise data.

{edx_enterprise_data-10.7.0 → edx_enterprise_data-10.7.1}/edx_enterprise_data.egg-info/SOURCES.txt

@@ -116,6 +116,7 @@ enterprise_data/migrations/0039_auto_20240212_1403.py
 enterprise_data/migrations/0040_auto_20240718_0536_squashed_0043_alter_enterpriselearnerenrollment_enterprise_enrollment_id.py
 enterprise_data/migrations/0044_enterpriseexecedlcmoduleperformance.py
 enterprise_data/migrations/0045_alter_enterpriseexecedlcmoduleperformance_options_and_more.py
+enterprise_data/migrations/0046_enterprisegroupmembership.py
 enterprise_data/migrations/__init__.py
 enterprise_data/settings/__init__.py
 enterprise_data/settings/test.py

{edx_enterprise_data-10.7.0 → edx_enterprise_data-10.7.1}/enterprise_data/__init__.py

@@ -2,4 +2,4 @@
 Enterprise data api application. This Django app exposes API endpoints used by enterprises.
 """
 
-__version__ = "10.7.0"
+__version__ = "10.7.1"

{edx_enterprise_data-10.7.0 → edx_enterprise_data-10.7.1}/enterprise_data/api/v1/serializers.py

@@ -10,6 +10,7 @@ from enterprise_data.models import (
     EnterpriseAdminLearnerProgress,
     EnterpriseAdminSummarizeInsights,
     EnterpriseExecEdLCModulePerformance,
+    EnterpriseGroupMembership,
     EnterpriseLearner,
     EnterpriseLearnerEnrollment,
     EnterpriseOffer,
@@ -253,6 +254,19 @@ class EnterpriseBudgetSerializer(serializers.ModelSerializer):
         )
 
 
+class EnterpriseGroupMembershipSerializer(serializers.ModelSerializer):
+    """
+    Serializer for EnterpriseGroupMembership model.
+    """
+
+    class Meta:
+        model = EnterpriseGroupMembership
+        fields = (
+            'enterprise_group_uuid',
+            'enterprise_group_name',
+        )
+
+
 class AdvanceAnalyticsQueryParamSerializer(serializers.Serializer):  # pylint: disable=abstract-method
     """Serializer for validating query params"""
     RESPONSE_TYPES = [

{edx_enterprise_data-10.7.0 → edx_enterprise_data-10.7.1}/enterprise_data/api/v1/urls.py

@@ -101,6 +101,11 @@ urlpatterns = [
         enterprise_admin_views.EnterpriseBudgetView.as_view(),
         name='enterprise-budgets'
     ),
+    re_path(
+        fr'^enterprise/(?P<enterprise_uuid>{UUID4_REGEX})/groups',
+        enterprise_admin_views.EnterpriseGroupMembershipView.as_view(),
+        name='enterprise-groups'
+    ),
 ]
 
 urlpatterns += router.urls

{edx_enterprise_data-10.7.0 → edx_enterprise_data-10.7.1}/enterprise_data/api/v1/views/enterprise_admin.py

@@ -21,6 +21,7 @@ from enterprise_data.models import (
     EnterpriseAdminLearnerProgress,
     EnterpriseAdminSummarizeInsights,
     EnterpriseExecEdLCModulePerformance,
+    EnterpriseGroupMembership,
     EnterpriseSubsidyBudget,
 )
 from enterprise_data.utils import timer
@@ -230,3 +231,24 @@ class EnterpriseBudgetView(APIView):
 
         serializer = serializers.EnterpriseBudgetSerializer(budgets, many=True)
         return Response(serializer.data)
+
+
+class EnterpriseGroupMembershipView(APIView):
+    """
+    View for getting Group Memberships information for an enterprise.
+    """
+    authentication_classes = (JwtAuthentication,)
+    http_method_names = ["get"]
+
+    @permission_required("can_access_enterprise", fn=lambda request, enterprise_uuid: enterprise_uuid)
+    def get(self, request, enterprise_uuid):
+        """
+        Returns the groups and budgets for an enterprise.
+        """
+        groups = EnterpriseGroupMembership.objects.filter(
+            enterprise_customer_id=enterprise_uuid,
+            group_type='flex',
+        )
+
+        serializer = serializers.EnterpriseGroupMembershipSerializer(groups, many=True)
+        return Response(serializer.data)

{edx_enterprise_data-10.7.0 → edx_enterprise_data-10.7.1}/enterprise_data/api/v1/views/enterprise_learner.py

@@ -12,7 +12,7 @@ from rest_framework.response import Response
 
 from django.conf import settings
 from django.core.paginator import Paginator
-from django.db.models import Count, Max, OuterRef, Prefetch, Q, Subquery, Value
+from django.db.models import Count, Exists, Max, OuterRef, Prefetch, Q, Subquery, Value
 from django.db.models.fields import IntegerField
 from django.db.models.functions import Coalesce
 from django.http import StreamingHttpResponse
@@ -20,7 +20,7 @@ from django.utils import timezone
 
 from enterprise_data.admin_analytics.database.utils import LOGGER
 from enterprise_data.api.v1 import serializers
-from enterprise_data.models import EnterpriseLearner, EnterpriseLearnerEnrollment
+from enterprise_data.models import EnterpriseGroupMembership, EnterpriseLearner, EnterpriseLearnerEnrollment
 from enterprise_data.paginators import EnterpriseEnrollmentsPagination
 from enterprise_data.renderers import EnrollmentsCSVRenderer
 from enterprise_data.utils import subtract_one_month
@@ -174,6 +174,15 @@ class EnterpriseLearnerEnrollmentViewSet(EnterpriseViewSetMixin, viewsets.ReadOn
         if is_subsidy:
             queryset = queryset.filter(is_subsidy=is_subsidy)
 
+        group_uuid = query_filters.get('group_uuid')
+        if group_uuid:
+            flex_group_exists = EnterpriseGroupMembership.objects.filter(
+                enterprise_customer_user_id=OuterRef('enterprise_user_id'),
+                enterprise_group_uuid=group_uuid,
+                group_type='flex'
+            )
+            queryset = queryset.filter(Exists(flex_group_exists))
+
         return queryset
 
     def filter_by_offer_id(self, queryset, offer_id):

edx_enterprise_data-10.7.1/enterprise_data/migrations/0046_enterprisegroupmembership.py

@@ -0,0 +1,36 @@
+# Generated by Django 4.2.16 on 2025-01-08 07:31
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('enterprise_data', '0045_alter_enterpriseexecedlcmoduleperformance_options_and_more'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='EnterpriseGroupMembership',
+            fields=[
+                ('group_membership_unique_id', models.CharField(max_length=64, primary_key=True, serialize=False)),
+                ('is_applies_to_all_contexts', models.BooleanField(default=False)),
+                ('enterprise_customer_id', models.UUIDField(db_index=True, null=True)),
+                ('enterprise_group_name', models.CharField(max_length=255, null=True)),
+                ('enterprise_group_uuid', models.UUIDField(null=True)),
+                ('group_is_removed', models.BooleanField(default=False)),
+                ('group_type', models.CharField(max_length=128, null=True)),
+                ('activated_at', models.DateTimeField(null=True)),
+                ('enterprise_customer_user_id', models.PositiveIntegerField(null=True)),
+                ('membership_is_removed', models.BooleanField(default=False)),
+                ('membership_status', models.CharField(max_length=128, null=True)),
+                ('enterprise_group_membership_uuid', models.UUIDField(null=True)),
+            ],
+            options={
+                'verbose_name': 'Group Membership',
+                'verbose_name_plural': 'Group Memberships',
+                'db_table': 'group_membership',
+                'indexes': [models.Index(fields=['enterprise_group_uuid', 'group_type', 'enterprise_customer_user_id'], name='group_membe_enterpr_796f48_idx')],
+            },
+        ),
+    ]

{edx_enterprise_data-10.7.0 → edx_enterprise_data-10.7.1}/enterprise_data/models.py

@@ -398,6 +398,50 @@ class EnterpriseSubsidyBudget(models.Model):
         return self.__str__()
 
 
+class EnterpriseGroupMembership(models.Model):
+    """
+    Details of group memberships in enterprise reports.
+    """
+
+    objects = EnterpriseReportingModelManager()
+
+    class Meta:
+        app_label = 'enterprise_data'
+        db_table = 'group_membership'
+        verbose_name = _("Group Membership")
+        verbose_name_plural = _("Group Memberships")
+        indexes = [
+            models.Index(fields=['enterprise_group_uuid', 'group_type', 'enterprise_customer_user_id']),
+        ]
+
+    group_membership_unique_id = models.CharField(max_length=64, primary_key=True)
+    is_applies_to_all_contexts = models.BooleanField(default=False)
+    enterprise_customer_id = models.UUIDField(db_index=True, null=True)
+    enterprise_group_name = models.CharField(max_length=255, null=True)
+    enterprise_group_uuid = models.UUIDField(null=True)
+    group_is_removed = models.BooleanField(default=False)
+    group_type = models.CharField(max_length=128, null=True)
+    activated_at = models.DateTimeField(null=True)
+    enterprise_customer_user_id = models.PositiveIntegerField(null=True)
+    membership_is_removed = models.BooleanField(default=False)
+    membership_status = models.CharField(max_length=128, null=True)
+    enterprise_group_membership_uuid = models.UUIDField(null=True)
+
+    def __str__(self):
+        """
+        Return a human-readable string representation of the object.
+        """
+        return (f'<Enterprise Group Membership: {self.enterprise_group_name} '
+                f'(Group UUID: {self.enterprise_group_uuid}) '
+                f'for Customer ID {self.enterprise_customer_id}>')
+
+    def __repr__(self):
+        """
+        Return uniquely identifying string representation.
+        """
+        return self.__str__()
+
+
 class EnterpriseUser(models.Model):
     """Information includes a mix of the user's meta data.
 

{edx_enterprise_data-10.7.0 → edx_enterprise_data-10.7.1}/enterprise_data/tests/test_models.py

@@ -10,6 +10,7 @@ from pytest import mark
 
 from enterprise_data.tests.test_utils import (
     EnterpriseEnrollmentFactory,
+    EnterpriseGroupMembershipFactory,
     EnterpriseOfferFactory,
     EnterpriseSubsidyBudgetFactory,
     EnterpriseUserFactory,
@@ -91,6 +92,32 @@ class TestEnterpriseSubsidyBudget(unittest.TestCase):
         assert expected_str == method(self.enterprise_subsidy_budget)
 
 
+@mark.django_db
+@ddt.ddt
+class TestEnterpriseGroupMembership(unittest.TestCase):
+    """
+    Tests for Enterprise Group Membership model
+    """
+
+    def setUp(self):
+        self.enterprise_group_membership = EnterpriseGroupMembershipFactory(
+            enterprise_customer_id='ee5e6b3a-069a-4947-bb8d-d2dbc323396c',
+            enterprise_group_name='Test Group',
+            enterprise_group_uuid='ee5e6b3a-069a-4947-bb8d-d2dbc323396d',
+        )
+        super().setUp()
+
+    @ddt.data(str, repr)
+    def test_string_conversion(self, method):
+        """
+        Test conversion to string.
+        """
+        expected_str = ('<Enterprise Group Membership: Test Group '
+                        '(Group UUID: ee5e6b3a-069a-4947-bb8d-d2dbc323396d) '
+                        'for Customer ID ee5e6b3a-069a-4947-bb8d-d2dbc323396c>')
+        assert expected_str == method(self.enterprise_group_membership)
+
+
 @mark.django_db
 @ddt.ddt
 class TestEnterpriseUser(unittest.TestCase):

{edx_enterprise_data-10.7.0 → edx_enterprise_data-10.7.1}/enterprise_data/tests/test_utils.py

@@ -14,6 +14,7 @@ from django.contrib.auth import get_user_model
 
 from enterprise_data.models import (
     EnterpriseEnrollment,
+    EnterpriseGroupMembership,
     EnterpriseLearner,
     EnterpriseLearnerEnrollment,
     EnterpriseOffer,
@@ -288,6 +289,27 @@ class EnterpriseSubsidyBudgetFactory(factory.django.DjangoModelFactory):
     )
 
 
+class EnterpriseGroupMembershipFactory(factory.django.DjangoModelFactory):
+    """
+    EnterpriseGroupMembership model Factory.
+    """
+    class Meta:
+        model = EnterpriseGroupMembership
+
+    enterprise_customer_id = factory.LazyAttribute(lambda _: FAKER.uuid4())
+    enterprise_group_name = factory.LazyAttribute(lambda _: ' '.join(FAKER.words(nb=2)).title())
+    enterprise_group_uuid = factory.LazyAttribute(lambda _: FAKER.uuid4())
+    group_is_removed = factory.LazyAttribute(lambda _: FAKER.boolean())
+    group_type = factory.LazyAttribute(lambda _: 'budget')
+    activated_at = factory.LazyAttribute(lambda _: FAKER.date_time_this_decade(tzinfo=pytz.UTC))
+    enterprise_customer_user_id = factory.LazyAttribute(lambda _: FAKER.random_int(min=1, max=10000))
+    membership_is_removed = factory.LazyAttribute(lambda _: FAKER.boolean())
+    membership_status = factory.LazyAttribute(lambda _: FAKER.word())
+    enterprise_group_membership_uuid = factory.LazyAttribute(lambda _: FAKER.uuid4())
+
+    is_applies_to_all_contexts = factory.LazyAttribute(lambda _: FAKER.boolean())
+
+
 class EnterpriseOfferFactory(factory.django.DjangoModelFactory):
     """
     EnterpriseLearner model Factory.

{edx_enterprise_data-10.7.0 → edx_enterprise_data-10.7.1}/requirements/base.txt

@@ -10,15 +10,15 @@ asgiref==3.8.1
     # via django
 asn1crypto==1.5.1
     # via snowflake-connector-python
-awscli==1.36.22
+awscli==1.36.38
     # via -r requirements/reporting.in
 bcrypt==4.2.1
     # via paramiko
 billiard==4.2.1
     # via celery
-boto3==1.35.81
+boto3==1.35.97
     # via -r requirements/reporting.in
-botocore==1.35.81
+botocore==1.35.97
     # via
     #   awscli
     #   boto3
@@ -35,11 +35,11 @@ cffi==1.17.1
     #   cryptography
     #   pynacl
     #   snowflake-connector-python
-charset-normalizer==3.4.0
+charset-normalizer==3.4.1
     # via
     #   requests
     #   snowflake-connector-python
-click==8.1.7
+click==8.1.8
     # via
     #   celery
     #   click-didyoumean
@@ -125,7 +125,7 @@ edx-rest-api-client==6.0.0
     # via -r requirements/base.in
 factory-boy==3.3.1
     # via -r requirements/base.in
-faker==33.1.0
+faker==33.3.1
     # via factory-boy
 filelock==3.16.1
     # via snowflake-connector-python
@@ -147,7 +147,7 @@ mysql-connector-python==9.1.0
     # via -r requirements/base.in
 newrelic==10.4.0
     # via edx-django-utils
-numpy==2.2.0
+numpy==2.2.1
     # via
     #   -r requirements/base.in
     #   pandas
@@ -165,13 +165,13 @@ pbr==6.1.0
     # via stevedore
 pgpy==0.6.0
     # via -r requirements/reporting.in
-pillow==11.0.0
+pillow==11.1.0
     # via pansi
 platformdirs==4.3.6
     # via snowflake-connector-python
 prompt-toolkit==3.0.48
     # via click-repl
-psutil==6.1.0
+psutil==6.1.1
     # via edx-django-utils
 py2neo @ https://github.com/overhangio/py2neo/releases/download/2021.2.3/py2neo-2021.2.3.tar.gz
     # via -r requirements/reporting.in
@@ -181,7 +181,7 @@ pyasn1==0.6.1
     #   rsa
 pycparser==2.22
     # via cffi
-pygments==2.18.0
+pygments==2.19.1
     # via py2neo
 pyjwt[crypto]==2.10.1
     # via
@@ -262,6 +262,7 @@ unicodecsv==0.14.1
     # via -r requirements/reporting.in
 urllib3==2.2.3
     # via
+    #   -c /home/runner/work/edx-enterprise-data/edx-enterprise-data/requirements/common_constraints.txt
     #   botocore
     #   py2neo
     #   requests

{edx_enterprise_data-10.7.0 → edx_enterprise_data-10.7.1}/requirements/ci.txt

@@ -10,7 +10,7 @@ chardet==5.2.0
     # via tox
 colorama==0.4.6
     # via tox
-coverage==7.6.9
+coverage==7.6.10
     # via -r requirements/ci.in
 distlib==0.3.9
     # via virtualenv
@@ -32,5 +32,5 @@ pyproject-api==1.8.0
     # via tox
 tox==4.23.2
     # via -r requirements/ci.in
-virtualenv==20.28.0
+virtualenv==20.28.1
     # via tox

{edx_enterprise_data-10.7.0 → edx_enterprise_data-10.7.1}/requirements/common_constraints.txt

@@ -26,3 +26,7 @@ django-simple-history==3.0.0
 # Cause: https://github.com/openedx/edx-lint/issues/458
 # This can be unpinned once https://github.com/openedx/edx-lint/issues/459 has been resolved.
 pip<24.3
+
+# Cause: https://github.com/openedx/edx-lint/issues/475
+# This can be unpinned once https://github.com/openedx/edx-lint/issues/476 has been resolved.
+urllib3<2.3.0

{edx_enterprise_data-10.7.0 → edx_enterprise_data-10.7.1}/requirements/dev.txt

@@ -10,19 +10,19 @@ asgiref==3.8.1
     # via django
 asn1crypto==1.5.1
     # via snowflake-connector-python
-astroid==3.3.6
+astroid==3.3.8
     # via
     #   pylint
     #   pylint-celery
-awscli==1.36.22
+awscli==1.36.38
     # via -r requirements/reporting.in
 bcrypt==4.2.1
     # via paramiko
 billiard==4.2.1
     # via celery
-boto3==1.35.81
+boto3==1.35.97
     # via -r requirements/reporting.in
-botocore==1.35.81
+botocore==1.35.97
     # via
     #   awscli
     #   boto3
@@ -47,11 +47,11 @@ chardet==5.2.0
     # via
     #   diff-cover
     #   tox
-charset-normalizer==3.4.0
+charset-normalizer==3.4.1
     # via
     #   requests
     #   snowflake-connector-python
-click==8.1.7
+click==8.1.8
     # via
     #   celery
     #   click-didyoumean
@@ -163,7 +163,7 @@ edx-rest-api-client==6.0.0
     # via -r requirements/base.in
 factory-boy==3.3.1
     # via -r requirements/base.in
-faker==33.1.0
+faker==33.3.1
     # via factory-boy
 filelock==3.16.1
     # via
@@ -190,7 +190,7 @@ jeepney==0.8.0
     # via
     #   keyring
     #   secretstorage
-jinja2==3.1.4
+jinja2==3.1.5
     # via
     #   code-annotations
     #   diff-cover
@@ -198,7 +198,7 @@ jmespath==1.0.1
     # via
     #   boto3
     #   botocore
-keyring==25.5.0
+keyring==25.6.0
     # via twine
 kombu==5.4.2
     # via celery
@@ -226,9 +226,9 @@ mysql-connector-python==9.1.0
     # via -r requirements/base.in
 newrelic==10.4.0
     # via edx-django-utils
-nh3==0.2.19
+nh3==0.2.20
     # via readme-renderer
-numpy==2.2.0
+numpy==2.2.1
     # via
     #   -r requirements/base.in
     #   pandas
@@ -252,7 +252,7 @@ pbr==6.1.0
     # via stevedore
 pgpy==0.6.0
     # via -r requirements/reporting.in
-pillow==11.0.0
+pillow==11.1.0
     # via pansi
 pip-tools==7.4.1
     # via -r requirements/dev-enterprise_data.in
@@ -272,7 +272,7 @@ polib==1.2.0
     # via edx-i18n-tools
 prompt-toolkit==3.0.48
     # via click-repl
-psutil==6.1.0
+psutil==6.1.1
     # via edx-django-utils
 py2neo @ https://github.com/overhangio/py2neo/releases/download/2021.2.3/py2neo-2021.2.3.tar.gz
     # via -r requirements/reporting.in
@@ -286,7 +286,7 @@ pycparser==2.22
     # via cffi
 pydocstyle==6.3.0
     # via -r requirements/quality.in
-pygments==2.18.0
+pygments==2.19.1
     # via
     #   diff-cover
     #   py2neo
@@ -298,7 +298,7 @@ pyjwt[crypto]==2.10.1
     #   edx-drf-extensions
     #   edx-rest-api-client
     #   snowflake-connector-python
-pylint==3.3.2
+pylint==3.3.3
     # via
     #   edx-lint
     #   pylint-celery
@@ -422,6 +422,7 @@ unicodecsv==0.14.1
     # via -r requirements/reporting.in
 urllib3==2.2.3
     # via
+    #   -c /home/runner/work/edx-enterprise-data/edx-enterprise-data/requirements/common_constraints.txt
     #   botocore
     #   py2neo
     #   requests
@@ -433,7 +434,7 @@ vine==5.1.0
     #   amqp
     #   celery
     #   kombu
-virtualenv==20.28.0
+virtualenv==20.28.1
     # via tox
 wcwidth==0.2.13
     # via prompt-toolkit

{edx_enterprise_data-10.7.0 → edx_enterprise_data-10.7.1}/requirements/pip.txt

@@ -12,5 +12,5 @@ pip==24.2
     # via
     #   -c /home/runner/work/edx-enterprise-data/edx-enterprise-data/requirements/common_constraints.txt
     #   -r requirements/pip.in
-setuptools==75.6.0
+setuptools==75.8.0
     # via -r requirements/pip.in

{edx_enterprise_data-10.7.0 → edx_enterprise_data-10.7.1}/requirements/pip_tools.txt

@@ -6,7 +6,7 @@
 #
 build==1.2.2.post1
     # via pip-tools
-click==8.1.7
+click==8.1.8
     # via pip-tools
 packaging==24.2
     # via build