edx-enterprise-data 9.6.0__tar.gz → 9.7.1__tar.gz

{edx_enterprise_data-9.6.0 → edx_enterprise_data-9.7.1}/CHANGELOG.rst

@@ -16,6 +16,10 @@ Unreleased
 
 =========================
 
+[9.7.0] - 2024-10-23
+---------------------
+  * feat: Add API to fetch enterprise budgets information
+
 [9.6.0] - 2024-10-14
 ---------------------
   * feat: Added caching for API endpoints related to advanced analytics.

{edx_enterprise_data-9.6.0/edx_enterprise_data.egg-info → edx_enterprise_data-9.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: edx-enterprise-data
-Version: 9.6.0
+Version: 9.7.1
 Summary: Enterprise Reporting
 Home-page: https://github.com/openedx/edx-enterprise-data
 Author: edX

{edx_enterprise_data-9.6.0 → edx_enterprise_data-9.7.1/edx_enterprise_data.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: edx-enterprise-data
-Version: 9.6.0
+Version: 9.7.1
 Summary: Enterprise Reporting
 Home-page: https://github.com/openedx/edx-enterprise-data
 Author: edX

{edx_enterprise_data-9.6.0 → edx_enterprise_data-9.7.1}/edx_enterprise_data.egg-info/SOURCES.txt

@@ -65,12 +65,14 @@ enterprise_data/management/commands/create_enterprise_learner_enrollment_lpr_v1.
 enterprise_data/management/commands/create_enterprise_learner_lpr_v1.py
 enterprise_data/management/commands/create_enterprise_offer.py
 enterprise_data/management/commands/create_enterprise_user.py
+enterprise_data/management/commands/pre_warm_analytics_cache.py
 enterprise_data/management/commands/tests/__init__.py
 enterprise_data/management/commands/tests/test_create_dummy_data_lpr_v1.py
 enterprise_data/management/commands/tests/test_create_enterprise_enrollment.py
 enterprise_data/management/commands/tests/test_create_enterprise_learner_enrollment_lpr_v1.py
 enterprise_data/management/commands/tests/test_create_enterprise_learner_lpr_v1.py
 enterprise_data/management/commands/tests/test_create_enterprise_user.py
+enterprise_data/management/commands/tests/test_pre_warm_analytics_cache.py
 enterprise_data/migrations/0001_initial.py
 enterprise_data/migrations/0002_auto_20180430_1358.py
 enterprise_data/migrations/0003_auto_20180501_0603.py

{edx_enterprise_data-9.6.0 → edx_enterprise_data-9.7.1}/enterprise_data/__init__.py

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

{edx_enterprise_data-9.6.0 → edx_enterprise_data-9.7.1}/enterprise_data/admin_analytics/database/queries/fact_enrollment_admin_dash.py

@@ -7,6 +7,18 @@ class FactEnrollmentAdminDashQueries:
     """
     Queries related to the fact_enrollment_admin_dash table.
     """
+    @staticmethod
+    def get_top_enterprises_query(count=10):
+        """
+        Get the query to fetch the top enterprises by enrollments.
+        """
+        return f"""
+            SELECT enterprise_customer_uuid
+            FROM fact_enrollment_admin_dash
+            GROUP BY enterprise_customer_uuid
+            ORDER BY COUNT(enterprise_customer_uuid) DESC LIMIT {count};
+        """
+
     @staticmethod
     def get_enrollment_count_query():
         """

{edx_enterprise_data-9.6.0 → edx_enterprise_data-9.7.1}/enterprise_data/admin_analytics/database/tables/fact_enrollment_admin_dash.py

@@ -17,6 +17,22 @@ class FactEnrollmentAdminDashTable(BaseTable):
     """
     queries = FactEnrollmentAdminDashQueries()
 
+    def get_top_enterprises(self, count=10):
+        """
+        Get the top enterprises by enrollments.
+
+        Arguments:
+            count (int): The number of enterprises to return.
+
+        Returns:
+            list<str>: A list of enterprise UUIDs.
+        """
+        result = run_query(
+            query=self.queries.get_top_enterprises_query(count),
+            as_dict=False,
+        )
+        return [row[0] for row in result]
+
     @cache_it()
     def get_enrollment_count(self, enterprise_customer_uuid: UUID, start_date: date, end_date: date):
         """
@@ -77,7 +93,7 @@ class FactEnrollmentAdminDashTable(BaseTable):
         Get the enrollment date range for the given enterprise customer.
 
         Arguments:
-            enterprise_customer_uuid (UUID): The UUID of the enterprise customer.
+            enterprise_customer_uuid (UUID | str): The UUID of the enterprise customer.
 
         Returns:
             (tuple<date, date>): The minimum and maximum enrollment dates.

{edx_enterprise_data-9.6.0 → edx_enterprise_data-9.7.1}/enterprise_data/api/v1/serializers.py

@@ -240,6 +240,19 @@ class EnterpriseExecEdLCModulePerformanceSerializer(serializers.ModelSerializer)
         return obj.extensions_requested if obj.extensions_requested is not None else 0
 
 
+class EnterpriseBudgetSerializer(serializers.ModelSerializer):
+    """
+    Serializer for EnterpriseSubsidyBudget model.
+    """
+
+    class Meta:
+        model = EnterpriseSubsidyBudget
+        fields = (
+            'subsidy_access_policy_uuid',
+            'subsidy_access_policy_display_name',
+        )
+
+
 class AdvanceAnalyticsQueryParamSerializer(serializers.Serializer):  # pylint: disable=abstract-method
     """Serializer for validating query params"""
     RESPONSE_TYPES = [

{edx_enterprise_data-9.6.0 → edx_enterprise_data-9.7.1}/enterprise_data/api/v1/urls.py

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

{edx_enterprise_data-9.6.0 → edx_enterprise_data-9.7.1}/enterprise_data/api/v1/views/analytics_completions.py

@@ -2,7 +2,7 @@
 Views for enterprise admin completions analytics.
 """
 
-from datetime import datetime
+from datetime import date
 from logging import getLogger
 
 from edx_rbac.decorators import permission_required
@@ -50,7 +50,7 @@ class AdvanceAnalyticsCompletionsView(AnalyticsPaginationMixin, ViewSet):
 
         # get values from query params or use default values
         start_date = serializer.data.get('start_date', min_enrollment_date)
-        end_date = serializer.data.get('end_date', datetime.now())
+        end_date = serializer.data.get('end_date', date.today())
         page = serializer.data.get('page', 1)
         page_size = serializer.data.get('page_size', 100)
         completions = FactEnrollmentAdminDashTable().get_all_completions(
@@ -132,7 +132,7 @@ class AdvanceAnalyticsCompletionsView(AnalyticsPaginationMixin, ViewSet):
         )
         # get values from query params or use default
         start_date = serializer.data.get('start_date', min_enrollment_date)
-        end_date = serializer.data.get('end_date', datetime.now())
+        end_date = serializer.data.get('end_date', date.today())
         with timer('construct_completion_all_stats'):
             data = {
                 'completions_over_time': FactEnrollmentAdminDashTable().get_completions_time_series_data(

{edx_enterprise_data-9.6.0 → edx_enterprise_data-9.7.1}/enterprise_data/api/v1/views/analytics_engagements.py

@@ -2,7 +2,7 @@
 Views for handling REST endpoints related to Engagements analytics.
 """
 
-from datetime import datetime
+from datetime import date
 from logging import getLogger
 
 from edx_rbac.decorators import permission_required
@@ -50,7 +50,7 @@ class AdvanceAnalyticsEngagementView(AnalyticsPaginationMixin, ViewSet):
 
         # get values from query params or use default values
         start_date = serializer.data.get('start_date', min_enrollment_date)
-        end_date = serializer.data.get('end_date', datetime.now())
+        end_date = serializer.data.get('end_date', date.today())
         page = serializer.data.get('page', 1)
         page_size = serializer.data.get('page_size', 100)
         engagements = FactEngagementAdminDashTable().get_all_engagements(
@@ -132,7 +132,7 @@ class AdvanceAnalyticsEngagementView(AnalyticsPaginationMixin, ViewSet):
         )
         # get values from query params or use default
         start_date = serializer.data.get('start_date', min_enrollment_date)
-        end_date = serializer.data.get('end_date', datetime.now())
+        end_date = serializer.data.get('end_date', date.today())
         with timer('construct_engagement_all_stats'):
             data = {
                 'engagement_over_time': FactEngagementAdminDashTable().get_engagement_time_series_data(

{edx_enterprise_data-9.6.0 → edx_enterprise_data-9.7.1}/enterprise_data/api/v1/views/analytics_enrollments.py

@@ -1,7 +1,7 @@
 """
 Advance Analytics for API endpoints to fetch enterprise enrollments data.
 """
-from datetime import datetime
+from datetime import date
 from logging import getLogger
 
 from edx_rbac.decorators import permission_required
@@ -49,7 +49,7 @@ class AdvanceAnalyticsEnrollmentsView(AnalyticsPaginationMixin, ViewSet):
 
         # get values from query params or use default values
         start_date = serializer.data.get('start_date', min_enrollment_date)
-        end_date = serializer.data.get('end_date', datetime.now())
+        end_date = serializer.data.get('end_date', date.today())
         page = serializer.data.get('page', 1)
         page_size = serializer.data.get('page_size', 100)
         enrollments = FactEnrollmentAdminDashTable().get_all_enrollments(
@@ -131,7 +131,7 @@ class AdvanceAnalyticsEnrollmentsView(AnalyticsPaginationMixin, ViewSet):
         )
         # get values from query params or use default
         start_date = serializer.data.get('start_date', min_enrollment_date)
-        end_date = serializer.data.get('end_date', datetime.now())
+        end_date = serializer.data.get('end_date', date.today())
         with timer('construct_enrollment_all_stats'):
             data = {
                 'enrollments_over_time': FactEnrollmentAdminDashTable().get_enrolment_time_series_data(

{edx_enterprise_data-9.6.0 → edx_enterprise_data-9.7.1}/enterprise_data/api/v1/views/analytics_leaderboard.py

@@ -2,7 +2,7 @@
 Views for fetching leaderboard data.
 """
 
-from datetime import datetime
+from datetime import date
 from logging import getLogger
 
 from edx_rbac.decorators import permission_required
@@ -46,7 +46,7 @@ class AdvanceAnalyticsLeaderboardView(AnalyticsPaginationMixin, ViewSet):
 
         # get values from query params or use default values
         start_date = serializer.data.get('start_date', min_enrollment_date)
-        end_date = serializer.data.get('end_date', datetime.now())
+        end_date = serializer.data.get('end_date', date.today())
         page = serializer.data.get('page', 1)
         page_size = serializer.data.get('page_size', 100)
         leaderboard = FactEngagementAdminDashTable().get_all_leaderboard_data(

{edx_enterprise_data-9.6.0 → edx_enterprise_data-9.7.1}/enterprise_data/api/v1/views/enterprise_admin.py

@@ -1,7 +1,7 @@
 """
 Views for enterprise admin api v1.
 """
-from datetime import datetime
+from datetime import date, datetime
 
 from edx_rbac.decorators import permission_required
 from edx_rest_framework_extensions.auth.jwt.authentication import JwtAuthentication
@@ -21,6 +21,7 @@ from enterprise_data.models import (
     EnterpriseAdminLearnerProgress,
     EnterpriseAdminSummarizeInsights,
     EnterpriseExecEdLCModulePerformance,
+    EnterpriseSubsidyBudget,
 )
 from enterprise_data.utils import timer
 
@@ -159,7 +160,7 @@ class EnterpriseAdminAnalyticsSkillsView(APIView):
         if (start_date := serializer.data.get('start_date')) is None:
             start_date, _ = FactEnrollmentAdminDashTable().get_enrollment_date_range(enterprise_id)
 
-        end_date = serializer.data.get('end_date', datetime.now())
+        end_date = serializer.data.get('end_date', date.today())
 
         with timer('top_skills'):
             skills = SkillsDailyRollupAdminDashTable().get_top_skills(enterprise_id, start_date, end_date)
@@ -206,3 +207,26 @@ class EnterpriseExecEdLCModulePerformanceViewSet(EnterpriseViewSetMixin, viewset
         return EnterpriseExecEdLCModulePerformance.objects.filter(
             enterprise_customer_uuid=self.kwargs['enterprise_id'],
         )
+
+
+class EnterpriseBudgetView(APIView):
+    """
+    View for getting budgets 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):
+        """
+        Return the queryset of EnterpriseSubsidyBudget objects.
+        """
+        budgets = EnterpriseSubsidyBudget.objects.filter(
+            enterprise_customer_uuid=enterprise_uuid,
+        ).values(
+            'subsidy_access_policy_uuid',
+            'subsidy_access_policy_display_name',
+        )
+
+        serializer = serializers.EnterpriseBudgetSerializer(budgets, many=True)
+        return Response(serializer.data)

{edx_enterprise_data-9.6.0 → edx_enterprise_data-9.7.1}/enterprise_data/api/v1/views/enterprise_learner.py

@@ -150,6 +150,10 @@ class EnterpriseLearnerEnrollmentViewSet(EnterpriseViewSetMixin, viewsets.ReadOn
         if search_start_date:
             queryset = queryset.filter(course_start_date=search_start_date)
 
+        budget_uuid = query_filters.get('budget_uuid')
+        if budget_uuid:
+            queryset = queryset.filter(budget_id=budget_uuid)
+
         offer_id = query_filters.get('offer_id')
         if offer_id:
             queryset = self.filter_by_offer_id(queryset, offer_id)

edx_enterprise_data-9.7.1/enterprise_data/management/commands/pre_warm_analytics_cache.py

@@ -0,0 +1,218 @@
+"""
+Management command for pre-warming the analytics cache for large enterprises.
+"""
+from datetime import date
+
+from django.core.management.base import BaseCommand, CommandError
+
+from enterprise_data.admin_analytics.database.tables import (
+    FactEngagementAdminDashTable,
+    FactEnrollmentAdminDashTable,
+    SkillsDailyRollupAdminDashTable,
+)
+
+
+class Command(BaseCommand):
+    """
+    Add cache entries for analytics related data for a large enterprise.
+
+    The top enterprises will be the ones with the most enrollments.
+    """
+    help = 'Pre-warm the analytics cache for a large enterprises.'
+
+    @staticmethod
+    def __cache_enrollment_data(enterprise_customer_uuid):
+        """
+        Helper method to cache all the enrollment related data for the given enterprise.
+
+        Arguments:
+            enterprise_customer_uuid (str): The UUID of the enterprise customer.
+        """
+        enterprise_enrollment_table = FactEnrollmentAdminDashTable()
+        start_date, _ = enterprise_enrollment_table.get_enrollment_date_range(
+            enterprise_customer_uuid,
+        )
+        end_date = date.today()
+        enterprise_enrollment_table.get_enrollment_count(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+        )
+        page_size = 100
+        enterprise_enrollment_table.get_all_enrollments(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+            limit=page_size,
+            offset=0,
+        )
+        enterprise_enrollment_table.get_enrollment_and_course_count(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+        )
+        enterprise_enrollment_table.get_completion_count(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+        )
+        enterprise_enrollment_table.get_top_courses_by_enrollments(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+        )
+        enterprise_enrollment_table.get_top_subjects_by_enrollments(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+        )
+        enterprise_enrollment_table.get_enrolment_time_series_data(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+        )
+
+    @staticmethod
+    def __cache_completions_data(enterprise_customer_uuid):
+        """
+        Helper method to cache all the completions related data for the given enterprise.
+
+        Arguments:
+            enterprise_customer_uuid (str): The UUID of the enterprise customer.
+        """
+        enterprise_enrollment_table = FactEnrollmentAdminDashTable()
+        start_date, _ = enterprise_enrollment_table.get_enrollment_date_range(
+            enterprise_customer_uuid,
+        )
+        end_date = date.today()
+
+        page_size = 100
+        enterprise_enrollment_table.get_all_completions(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+            limit=page_size,
+            offset=0,
+        )
+        enterprise_enrollment_table.get_completion_count(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+        )
+        enterprise_enrollment_table.get_top_courses_by_completions(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+        )
+        enterprise_enrollment_table.get_top_subjects_by_completions(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+        )
+        enterprise_enrollment_table.get_completions_time_series_data(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+        )
+
+    @staticmethod
+    def __cache_engagement_data(enterprise_customer_uuid):
+        """
+        Helper method to cache all the engagement related data for the given enterprise.
+
+        Arguments:
+            enterprise_customer_uuid (str): The UUID of the enterprise customer.
+        """
+        start_date, _ = FactEnrollmentAdminDashTable().get_enrollment_date_range(
+            enterprise_customer_uuid,
+        )
+        end_date = date.today()
+        enterprise_engagement_table = FactEngagementAdminDashTable()
+        enterprise_engagement_table.get_learning_hours_and_daily_sessions(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+        )
+        enterprise_engagement_table.get_engagement_count(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+        )
+        page_size = 100
+        enterprise_engagement_table.get_all_engagements(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+            limit=page_size,
+            offset=0,
+        )
+        enterprise_engagement_table.get_top_courses_by_engagement(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+        )
+        enterprise_engagement_table.get_top_subjects_by_engagement(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+        )
+        enterprise_engagement_table.get_engagement_time_series_data(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+        )
+        enterprise_engagement_table.get_all_leaderboard_data(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+            limit=page_size,
+            offset=0,
+        )
+        enterprise_engagement_table.get_leaderboard_data_count(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+        )
+
+    @staticmethod
+    def __cache_skills_data(enterprise_customer_uuid):
+        """
+        Helper method to cache all the skills related data for the given enterprise.
+
+        Arguments:
+            enterprise_customer_uuid (str): The UUID of the enterprise customer.
+        """
+        start_date, _ = FactEnrollmentAdminDashTable().get_enrollment_date_range(
+            enterprise_customer_uuid,
+        )
+        end_date = date.today()
+        skills_table = SkillsDailyRollupAdminDashTable()
+        skills_table.get_top_skills(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+        )
+        skills_table.get_top_skills_by_enrollment(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+        )
+        skills_table.get_top_skills_by_completion(
+            enterprise_customer_uuid=enterprise_customer_uuid,
+            start_date=start_date,
+            end_date=end_date,
+        )
+
+    def handle(self, *args, **options):
+        for enterprise_customer_uuid in FactEnrollmentAdminDashTable().get_top_enterprises():
+            try:
+                self.__cache_enrollment_data(enterprise_customer_uuid)
+                self.__cache_completions_data(enterprise_customer_uuid)
+                self.__cache_engagement_data(enterprise_customer_uuid)
+                self.__cache_skills_data(enterprise_customer_uuid)
+            except Exception as exc:
+                info = (
+                    'Error trying to add cache entries for enterprise '
+                    '{}: {}'.format(enterprise_customer_uuid, exc)
+                )
+                raise CommandError(info) from exc

edx_enterprise_data-9.7.1/enterprise_data/management/commands/tests/test_pre_warm_analytics_cache.py

@@ -0,0 +1,51 @@
+"""
+Tests for `./manage.py pre_warm_analytics_cache` management command.
+"""
+from datetime import datetime
+from unittest import TestCase
+
+from mock import MagicMock, patch
+from pytest import mark
+
+from django.core.management import call_command
+
+
+@mark.django_db
+class Test(TestCase):
+    """
+    Tests to validate the behavior of `./manage.py pre_warm_analytics_cache` management command.
+    """
+    def setUp(self):
+        """
+        Setup method.
+        """
+        super().setUp()
+        self.enterprise_uuid = 'ee5e6b3a-069a-4947-bb8d-d2dbc323396c'
+
+        get_enrollment_date_range_patcher = patch(
+            'enterprise_data.api.v1.views.analytics_enrollments.FactEnrollmentAdminDashTable.get_enrollment_date_range',
+            return_value=(datetime.now(), datetime.now())
+        )
+
+        get_enrollment_date_range_patcher.start()
+        self.addCleanup(get_enrollment_date_range_patcher.stop)
+
+    @patch('enterprise_data.admin_analytics.database.tables.fact_engagement_admin_dash.run_query', MagicMock())
+    @patch('enterprise_data.admin_analytics.database.tables.fact_enrollment_admin_dash.run_query', MagicMock())
+    @patch('enterprise_data.admin_analytics.database.tables.skills_daily_rollup_admin_dash.run_query', MagicMock())
+    @patch('enterprise_data.api.v1.views.analytics_enrollments.FactEnrollmentAdminDashTable.get_top_enterprises')
+    @patch('enterprise_data.cache.decorators.cache.set')
+    @patch('enterprise_data.cache.decorators.cache.get')
+    def test_pre_warm_analytics_cache(self, mock_get_cache, mock_set_cache, mock_get_top_enterprises):
+        """
+        Validate that the command caches the analytics data for a large enterprise.
+        """
+        mock_get_top_enterprises.return_value = [
+            self.enterprise_uuid
+        ]
+        mock_get_cache.return_value = MagicMock(is_found=False)
+
+        call_command('pre_warm_analytics_cache')
+
+        assert mock_get_cache.call_count == 24
+        assert mock_set_cache.call_count == 24

{edx_enterprise_data-9.6.0 → edx_enterprise_data-9.7.1}/enterprise_data/tests/api/v1/views/test_enterprise_admin.py

@@ -21,7 +21,7 @@ from enterprise_data.tests.admin_analytics.mock_analytics_data import (
     TOP_SKILLS_BY_ENROLLMENTS,
 )
 from enterprise_data.tests.mixins import JWTTestMixin
-from enterprise_data.tests.test_utils import UserFactory, get_dummy_enterprise_api_data
+from enterprise_data.tests.test_utils import EnterpriseSubsidyBudgetFactory, UserFactory, get_dummy_enterprise_api_data
 from enterprise_data_roles.constants import ENTERPRISE_DATA_ADMIN_ROLE
 from enterprise_data_roles.models import EnterpriseDataFeatureRole, EnterpriseDataRoleAssignment
 
@@ -245,3 +245,49 @@ class TestSkillsStatsAPI(JWTTestMixin, APITransactionTestCase):
         response = self.client.get(self.url, params)
         assert response.status_code == status.HTTP_400_BAD_REQUEST
         assert response.json() == error
+
+
+@ddt.ddt
+class TestEnterpriseBudgetAPI(JWTTestMixin, APITransactionTestCase):
+    """Tests for EnterpriseBudgetView."""
+
+    def setUp(self):
+        """
+        Setup method.
+        """
+        super().setUp()
+        self.user = UserFactory(is_staff=True)
+        role, __ = EnterpriseDataFeatureRole.objects.get_or_create(
+            name=ENTERPRISE_DATA_ADMIN_ROLE
+        )
+        self.role_assignment = EnterpriseDataRoleAssignment.objects.create(
+            role=role, user=self.user
+        )
+        self.client.force_authenticate(user=self.user)
+
+        self.enterprise_uuid = "ee5e6b3a069a4947bb8dd2dbc323396c"
+        self.set_jwt_cookie()
+
+        self.url = reverse(
+            "v1:enterprise-budgets",
+            kwargs={"enterprise_uuid": self.enterprise_uuid},
+        )
+
+        self.enterprise_subsidy_budget = EnterpriseSubsidyBudgetFactory(
+            enterprise_customer_uuid=self.enterprise_uuid,
+            subsidy_access_policy_uuid='8d6503dd-e40d-42b8-442b-37dd4c5450e3',
+            subsidy_access_policy_display_name='test-budget'
+        )
+
+    def test_get(self):
+        """
+        Test the GET method for the EnterpriseBudgetView works.
+        """
+        response = self.client.get(self.url)
+        assert response.status_code == status.HTTP_200_OK
+        assert response.json() == [
+            {
+                'subsidy_access_policy_uuid': '8d6503dd-e40d-42b8-442b-37dd4c5450e3',
+                'subsidy_access_policy_display_name': 'test-budget',
+            }
+        ]