codegrade 17.0.40__tar.gz → 17.0.42__tar.gz

{codegrade-17.0.40 → codegrade-17.0.42}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codegrade
-Version: 17.0.40
+Version: 17.0.42
 Summary: A client library for accessing CodeGrade
 Project-URL: Documentation, https://python.api.codegrade.com
 License-Expression: AGPL-3.0-only OR BSD-3-Clause-Clear

{codegrade-17.0.40 → codegrade-17.0.42}/docs/conf.py

@@ -39,7 +39,7 @@ author = "CodeGrade Team"
 # built documents.
 #
 # The short X.Y version.
-version = "17.0.40"
+version = "17.0.42"
 # The full version, including alpha/beta/rc tags.
 release = version
 
@@ -103,7 +103,7 @@ html_js_files = ["toggle.js"]
 
 html_favicon = "_static/favicon/favicon.ico"
 html_logo = "_static/images/logo.svg"
-html_title = "CodeGrade 17.0.40"
+html_title = "CodeGrade 17.0.42"
 
 # -- Extension configuration -------------------------------------------------
 

{codegrade-17.0.40 → codegrade-17.0.42}/docs/models/APICodes.rst

@@ -65,3 +65,4 @@ APICodes
 * ``ASSIGNMENT_HAS_STUDENT_SUBMISSIONS``
 * ``ISOLATED_SESSION_ACTIVE``
 * ``TIER_RESTRICTED``
+* ``COURSE_USER_LIMIT_EXCEEDED``

codegrade-17.0.42/docs/models/CourseUserLimitExceededException.rst

@@ -0,0 +1,9 @@
+CourseUserLimitExceededException
+================================
+
+.. currentmodule:: codegrade.models.course_user_limit_exceeded_exception
+
+.. autoclass:: CourseUserLimitExceededException
+   :members: course_id, user_type, current_count, limit
+   :inherited-members:
+   :exclude-members: raw_data, data_parser, to_dict, from_dict, __init__, __new__

{codegrade-17.0.40 → codegrade-17.0.42}/docs/models/FrontendSiteSettings.rst

@@ -4,6 +4,6 @@ FrontendSiteSettings
 .. currentmodule:: codegrade.models.frontend_site_settings
 
 .. autoclass:: FrontendSiteSettings
-   :members: assignment_max_points_enabled, download_editor_files_enabled, grading_notifications_enabled, hide_no_deadline_enabled, show_premium_badges, inline_rubric_viewer_enabled, register_enabled, assignment_default_grading_scale, assignment_default_grading_scale_points, assignment_percentage_decimals, assignment_point_decimals, assistant_models, code_editor_start_on_assignment_description, default_submission_page_tab, hide_code_editor_output_viewer_with_only_quiz_steps, hide_code_editor_filetree_controls_with_only_quiz_steps, new_auto_test_ubuntu_20_04_base_image_ids, new_auto_test_ubuntu_24_04_base_image_ids, quiz_minimum_questions_for_dropdown, simple_submission_navigate_to_latest_editor_session, access_token_modal_warning_time, access_token_toast_warning_time, login_token_before_time, student_payment_main_option, lti_lock_date_copying_enabled, blackboard_zip_upload_enabled, is_pearson, exam_heartbeat, new_login_and_register, tier_free_ai_enabled, tier_free_lti_enabled, tier_free_atv1_enabled, tier_free_jupyter_enabled, tier_free_quiz_enabled, tier_free_extended_runtime_enabled, tier_free_unlimited_install_steps_enabled, tier_starter_ai_enabled, tier_starter_lti_enabled, tier_starter_atv1_enabled, tier_starter_jupyter_enabled, tier_starter_quiz_enabled, tier_starter_extended_runtime_enabled, tier_starter_unlimited_install_steps_enabled, tier_advanced_ai_enabled, tier_advanced_lti_enabled, tier_advanced_atv1_enabled, tier_advanced_jupyter_enabled, tier_advanced_quiz_enabled, tier_advanced_extended_runtime_enabled, tier_advanced_unlimited_install_steps_enabled
+   :members: assignment_max_points_enabled, download_editor_files_enabled, grading_notifications_enabled, hide_no_deadline_enabled, show_premium_badges, inline_rubric_viewer_enabled, register_enabled, assignment_default_grading_scale, assignment_default_grading_scale_points, assignment_percentage_decimals, assignment_point_decimals, assistant_models, code_editor_start_on_assignment_description, default_submission_page_tab, hide_code_editor_output_viewer_with_only_quiz_steps, hide_code_editor_filetree_controls_with_only_quiz_steps, new_auto_test_ubuntu_20_04_base_image_ids, new_auto_test_ubuntu_24_04_base_image_ids, quiz_minimum_questions_for_dropdown, simple_submission_navigate_to_latest_editor_session, access_token_modal_warning_time, access_token_toast_warning_time, login_token_before_time, student_payment_main_option, lti_lock_date_copying_enabled, blackboard_zip_upload_enabled, is_pearson, exam_heartbeat, new_login_and_register, tier_free_ai_enabled, tier_free_lti_enabled, tier_free_atv1_enabled, tier_free_jupyter_enabled, tier_free_quiz_enabled, tier_free_extended_runtime_enabled, tier_free_unlimited_install_steps_enabled, tier_free_max_students, tier_free_max_staff, tier_starter_ai_enabled, tier_starter_lti_enabled, tier_starter_atv1_enabled, tier_starter_jupyter_enabled, tier_starter_quiz_enabled, tier_starter_extended_runtime_enabled, tier_starter_unlimited_install_steps_enabled, tier_starter_max_students, tier_starter_max_staff, tier_advanced_ai_enabled, tier_advanced_lti_enabled, tier_advanced_atv1_enabled, tier_advanced_jupyter_enabled, tier_advanced_quiz_enabled, tier_advanced_extended_runtime_enabled, tier_advanced_unlimited_install_steps_enabled, tier_advanced_max_students, tier_advanced_max_staff
    :inherited-members:
    :exclude-members: raw_data, data_parser, to_dict, from_dict, __init__, __new__

{codegrade-17.0.40 → codegrade-17.0.42}/docs/models/RestrictionSetSessionLockdown.rst

@@ -4,6 +4,6 @@ RestrictionSetSessionLockdown
 .. currentmodule:: codegrade.models.restriction_set_session_lockdown
 
 .. autoclass:: RestrictionSetSessionLockdown
-   :members: tag, max_entries
+   :members: tag, max_entries, heartbeat_enforced
    :inherited-members:
    :exclude-members: raw_data, data_parser, to_dict, from_dict, __init__, __new__

{codegrade-17.0.40 → codegrade-17.0.42}/docs/models/SetSessionLockdownData.rst

@@ -4,6 +4,6 @@ SetSessionLockdownData
 .. currentmodule:: codegrade.models.set_session_lockdown_data
 
 .. autoclass:: SetSessionLockdownData
-   :members: tag, max_entries
+   :members: tag, max_entries, heartbeat_enforced
    :inherited-members:
    :exclude-members: raw_data, data_parser, to_dict, from_dict, __init__, __new__

codegrade-17.0.42/docs/models/TierAdvancedMaxStaffSetting.rst

@@ -0,0 +1,9 @@
+TierAdvancedMaxStaffSetting
+===========================
+
+.. currentmodule:: codegrade.models.tier_advanced_max_staff_setting
+
+.. autoclass:: TierAdvancedMaxStaffSetting
+   :members: name, value
+   :inherited-members:
+   :exclude-members: raw_data, data_parser, to_dict, from_dict, __init__, __new__

codegrade-17.0.42/docs/models/TierAdvancedMaxStudentsSetting.rst

@@ -0,0 +1,9 @@
+TierAdvancedMaxStudentsSetting
+==============================
+
+.. currentmodule:: codegrade.models.tier_advanced_max_students_setting
+
+.. autoclass:: TierAdvancedMaxStudentsSetting
+   :members: name, value
+   :inherited-members:
+   :exclude-members: raw_data, data_parser, to_dict, from_dict, __init__, __new__

codegrade-17.0.42/docs/models/TierFreeMaxStaffSetting.rst

@@ -0,0 +1,9 @@
+TierFreeMaxStaffSetting
+=======================
+
+.. currentmodule:: codegrade.models.tier_free_max_staff_setting
+
+.. autoclass:: TierFreeMaxStaffSetting
+   :members: name, value
+   :inherited-members:
+   :exclude-members: raw_data, data_parser, to_dict, from_dict, __init__, __new__

codegrade-17.0.42/docs/models/TierFreeMaxStudentsSetting.rst

@@ -0,0 +1,9 @@
+TierFreeMaxStudentsSetting
+==========================
+
+.. currentmodule:: codegrade.models.tier_free_max_students_setting
+
+.. autoclass:: TierFreeMaxStudentsSetting
+   :members: name, value
+   :inherited-members:
+   :exclude-members: raw_data, data_parser, to_dict, from_dict, __init__, __new__

codegrade-17.0.42/docs/models/TierStarterMaxStaffSetting.rst

@@ -0,0 +1,9 @@
+TierStarterMaxStaffSetting
+==========================
+
+.. currentmodule:: codegrade.models.tier_starter_max_staff_setting
+
+.. autoclass:: TierStarterMaxStaffSetting
+   :members: name, value
+   :inherited-members:
+   :exclude-members: raw_data, data_parser, to_dict, from_dict, __init__, __new__

codegrade-17.0.42/docs/models/TierStarterMaxStudentsSetting.rst

@@ -0,0 +1,9 @@
+TierStarterMaxStudentsSetting
+=============================
+
+.. currentmodule:: codegrade.models.tier_starter_max_students_setting
+
+.. autoclass:: TierStarterMaxStudentsSetting
+   :members: name, value
+   :inherited-members:
+   :exclude-members: raw_data, data_parser, to_dict, from_dict, __init__, __new__

{codegrade-17.0.40 → codegrade-17.0.42}/docs/services/restriction.rst

@@ -5,7 +5,7 @@ RestrictionService
 .. currentmodule:: codegrade._api.restriction
 
 .. autoclass:: RestrictionService
-   :members: put_allowed_ip, delete_allowed_ip, get_all_entries, enter, get, patch, get_all_allowed_ips, patch_entry_override
+   :members: put_allowed_ip, delete_allowed_ip, get_all_entries, enter, get, patch, get_all_allowed_ips, heartbeat, patch_entry_override
 
 	 .. rubric:: Methods
 
@@ -19,4 +19,5 @@ RestrictionService
 			~RestrictionService.get
 			~RestrictionService.patch
 			~RestrictionService.get_all_allowed_ips
+			~RestrictionService.heartbeat
 			~RestrictionService.patch_entry_override

{codegrade-17.0.40 → codegrade-17.0.42}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codegrade"
-version = "17.0.40"
+version = "17.0.42"
 description = "A client library for accessing CodeGrade"
 authors = []
 requires-python = ">=3.8.0,<4.0"

{codegrade-17.0.40 → codegrade-17.0.42}/src/codegrade/__init__.py

@@ -17,7 +17,7 @@ except ImportError:
     )
 
 __all__ = ("login", "AuthenticatedClient", "Client", "login_from_cli")
-__version__ = "17.0.40"
+__version__ = "17.0.42"
 
 _P = _ParamSpec("_P")
 _T = _t.TypeVar("_T")

{codegrade-17.0.40 → codegrade-17.0.42}/src/codegrade/_api/restriction.py

@@ -379,6 +379,43 @@ class RestrictionService(t.Generic[_ClientT]):
 
         return paginated.Response(do_request, parse_response)
 
+    def heartbeat(
+        self: RestrictionService[client.AuthenticatedClient],
+    ) -> None:
+        """Send a heartbeat to keep an isolated exam session alive.
+
+        When heartbeat enforcement is active, the session's `expires_at` is set
+        to a short window (5 minutes). This endpoint extends it forward, capped
+        by `max_expires_at`.
+
+        If the session is already expired, the auth flow rejects the request
+        before it reaches this endpoint (401).
+
+        :returns: An empty response.
+        """
+
+        url = "/api/v1/restrictions/heartbeat"
+        params = None
+
+        with self.__client as client:
+            resp = client.http.post(url=url, params=params)
+        utils.log_warnings(resp)
+
+        if utils.response_code_matches(resp.status_code, 204):
+            return parsers.ConstantlyParser(None).try_parse(resp)
+
+        from ..models.any_error import AnyError
+
+        raise utils.get_error(
+            resp,
+            (
+                (
+                    (400, 409, 401, 403, 404, 429, 500),
+                    utils.unpack_union(AnyError),
+                ),
+            ),
+        )
+
     def patch_entry_override(
         self: RestrictionService[client.AuthenticatedClient],
         json_body: PatchEntryOverrideRestrictionData,

{codegrade-17.0.40 → codegrade-17.0.42}/src/codegrade/client.py

@@ -647,7 +647,7 @@ class Client(_BaseClient):
         return httpx.Client(
             base_url=self.base_url,
             headers={
-                "User-Agent": "CodeGradeAPI/17.0.40",
+                "User-Agent": "CodeGradeAPI/17.0.42",
             },
             follow_redirects=True,
             transport=RetryingTransport(httpx.HTTPTransport()),
@@ -668,7 +668,7 @@ class AuthenticatedClient(_BaseClient):
             base_url=self.base_url,
             headers={
                 "Authorization": f"Bearer {self.token}",
-                "User-Agent": "CodeGradeAPI/17.0.40",
+                "User-Agent": "CodeGradeAPI/17.0.42",
             },
             follow_redirects=True,
             transport=RetryingTransport(httpx.HTTPTransport()),

{codegrade-17.0.40 → codegrade-17.0.42}/src/codegrade/models/__init__.py

@@ -205,6 +205,9 @@ from .course_snippet import CourseSnippet
 from .course_state import CourseState as CourseState
 from .course_statistics_as_json import CourseStatisticsAsJSON
 from .course_tier import CourseTier as CourseTier
+from .course_user_limit_exceeded_exception import (
+    CourseUserLimitExceededException,
+)
 from .create_access_plan_data import CreateAccessPlanData
 from .create_allow_registration_domain_data import (
     CreateAllowRegistrationDomainData,
@@ -654,6 +657,8 @@ from .tier_advanced_jupyter_enabled_setting import (
     TierAdvancedJupyterEnabledSetting,
 )
 from .tier_advanced_lti_enabled_setting import TierAdvancedLtiEnabledSetting
+from .tier_advanced_max_staff_setting import TierAdvancedMaxStaffSetting
+from .tier_advanced_max_students_setting import TierAdvancedMaxStudentsSetting
 from .tier_advanced_quiz_enabled_setting import TierAdvancedQuizEnabledSetting
 from .tier_advanced_unlimited_install_steps_enabled_setting import (
     TierAdvancedUnlimitedInstallStepsEnabledSetting,
@@ -665,6 +670,8 @@ from .tier_free_extended_runtime_enabled_setting import (
 )
 from .tier_free_jupyter_enabled_setting import TierFreeJupyterEnabledSetting
 from .tier_free_lti_enabled_setting import TierFreeLtiEnabledSetting
+from .tier_free_max_staff_setting import TierFreeMaxStaffSetting
+from .tier_free_max_students_setting import TierFreeMaxStudentsSetting
 from .tier_free_quiz_enabled_setting import TierFreeQuizEnabledSetting
 from .tier_free_unlimited_install_steps_enabled_setting import (
     TierFreeUnlimitedInstallStepsEnabledSetting,
@@ -679,6 +686,8 @@ from .tier_starter_jupyter_enabled_setting import (
     TierStarterJupyterEnabledSetting,
 )
 from .tier_starter_lti_enabled_setting import TierStarterLtiEnabledSetting
+from .tier_starter_max_staff_setting import TierStarterMaxStaffSetting
+from .tier_starter_max_students_setting import TierStarterMaxStudentsSetting
 from .tier_starter_quiz_enabled_setting import TierStarterQuizEnabledSetting
 from .tier_starter_unlimited_install_steps_enabled_setting import (
     TierStarterUnlimitedInstallStepsEnabledSetting,

{codegrade-17.0.40 → codegrade-17.0.42}/src/codegrade/models/all_site_settings.py

@@ -173,6 +173,14 @@ class AllSiteSettings(FrontendSiteSettings, BackendSiteSettings):
             res["TIER_FREE_UNLIMITED_INSTALL_STEPS_ENABLED"] = to_dict(
                 self.tier_free_unlimited_install_steps_enabled.value
             )
+        if self.tier_free_max_students.is_just:
+            res["TIER_FREE_MAX_STUDENTS"] = to_dict(
+                self.tier_free_max_students.value
+            )
+        if self.tier_free_max_staff.is_just:
+            res["TIER_FREE_MAX_STAFF"] = to_dict(
+                self.tier_free_max_staff.value
+            )
         if self.tier_starter_ai_enabled.is_just:
             res["TIER_STARTER_AI_ENABLED"] = to_dict(
                 self.tier_starter_ai_enabled.value
@@ -201,6 +209,14 @@ class AllSiteSettings(FrontendSiteSettings, BackendSiteSettings):
             res["TIER_STARTER_UNLIMITED_INSTALL_STEPS_ENABLED"] = to_dict(
                 self.tier_starter_unlimited_install_steps_enabled.value
             )
+        if self.tier_starter_max_students.is_just:
+            res["TIER_STARTER_MAX_STUDENTS"] = to_dict(
+                self.tier_starter_max_students.value
+            )
+        if self.tier_starter_max_staff.is_just:
+            res["TIER_STARTER_MAX_STAFF"] = to_dict(
+                self.tier_starter_max_staff.value
+            )
         if self.tier_advanced_ai_enabled.is_just:
             res["TIER_ADVANCED_AI_ENABLED"] = to_dict(
                 self.tier_advanced_ai_enabled.value
@@ -229,6 +245,14 @@ class AllSiteSettings(FrontendSiteSettings, BackendSiteSettings):
             res["TIER_ADVANCED_UNLIMITED_INSTALL_STEPS_ENABLED"] = to_dict(
                 self.tier_advanced_unlimited_install_steps_enabled.value
             )
+        if self.tier_advanced_max_students.is_just:
+            res["TIER_ADVANCED_MAX_STUDENTS"] = to_dict(
+                self.tier_advanced_max_students.value
+            )
+        if self.tier_advanced_max_staff.is_just:
+            res["TIER_ADVANCED_MAX_STAFF"] = to_dict(
+                self.tier_advanced_max_staff.value
+            )
         if self.max_file_size.is_just:
             res["MAX_FILE_SIZE"] = to_dict(self.max_file_size.value)
         if self.max_large_upload_size.is_just:
@@ -344,6 +368,8 @@ class AllSiteSettings(FrontendSiteSettings, BackendSiteSettings):
             tier_free_quiz_enabled=parsed.TIER_FREE_QUIZ_ENABLED,
             tier_free_extended_runtime_enabled=parsed.TIER_FREE_EXTENDED_RUNTIME_ENABLED,
             tier_free_unlimited_install_steps_enabled=parsed.TIER_FREE_UNLIMITED_INSTALL_STEPS_ENABLED,
+            tier_free_max_students=parsed.TIER_FREE_MAX_STUDENTS,
+            tier_free_max_staff=parsed.TIER_FREE_MAX_STAFF,
             tier_starter_ai_enabled=parsed.TIER_STARTER_AI_ENABLED,
             tier_starter_lti_enabled=parsed.TIER_STARTER_LTI_ENABLED,
             tier_starter_atv1_enabled=parsed.TIER_STARTER_ATV1_ENABLED,
@@ -351,6 +377,8 @@ class AllSiteSettings(FrontendSiteSettings, BackendSiteSettings):
             tier_starter_quiz_enabled=parsed.TIER_STARTER_QUIZ_ENABLED,
             tier_starter_extended_runtime_enabled=parsed.TIER_STARTER_EXTENDED_RUNTIME_ENABLED,
             tier_starter_unlimited_install_steps_enabled=parsed.TIER_STARTER_UNLIMITED_INSTALL_STEPS_ENABLED,
+            tier_starter_max_students=parsed.TIER_STARTER_MAX_STUDENTS,
+            tier_starter_max_staff=parsed.TIER_STARTER_MAX_STAFF,
             tier_advanced_ai_enabled=parsed.TIER_ADVANCED_AI_ENABLED,
             tier_advanced_lti_enabled=parsed.TIER_ADVANCED_LTI_ENABLED,
             tier_advanced_atv1_enabled=parsed.TIER_ADVANCED_ATV1_ENABLED,
@@ -358,6 +386,8 @@ class AllSiteSettings(FrontendSiteSettings, BackendSiteSettings):
             tier_advanced_quiz_enabled=parsed.TIER_ADVANCED_QUIZ_ENABLED,
             tier_advanced_extended_runtime_enabled=parsed.TIER_ADVANCED_EXTENDED_RUNTIME_ENABLED,
             tier_advanced_unlimited_install_steps_enabled=parsed.TIER_ADVANCED_UNLIMITED_INSTALL_STEPS_ENABLED,
+            tier_advanced_max_students=parsed.TIER_ADVANCED_MAX_STUDENTS,
+            tier_advanced_max_staff=parsed.TIER_ADVANCED_MAX_STAFF,
             max_file_size=parsed.MAX_FILE_SIZE,
             max_large_upload_size=parsed.MAX_LARGE_UPLOAD_SIZE,
             max_normal_upload_size=parsed.MAX_NORMAL_UPLOAD_SIZE,

{codegrade-17.0.40 → codegrade-17.0.42}/src/codegrade/models/any_error.py

@@ -17,6 +17,9 @@ from .auto_test_step_validation_exception import (
     AutoTestStepValidationException,
 )
 from .base_error import BaseError
+from .course_user_limit_exceeded_exception import (
+    CourseUserLimitExceededException,
+)
 from .disabled_setting_exception import DisabledSettingException
 from .failed_to_send_email_exception import FailedToSendEmailException
 from .first_phase_lti_launch_exception import FirstPhaseLTILaunchException
@@ -39,6 +42,7 @@ from .weak_password_exception import WeakPasswordException
 AnyError = t.Union[
     DisabledSettingException,
     TierRestrictedException,
+    CourseUserLimitExceededException,
     WeakPasswordException,
     ParseAPIException,
     InvalidIOCasesException,
@@ -60,6 +64,7 @@ AnyErrorParser = rqa.Lazy(
     lambda: make_union(
         ParserFor.make(DisabledSettingException),
         ParserFor.make(TierRestrictedException),
+        ParserFor.make(CourseUserLimitExceededException),
         ParserFor.make(WeakPasswordException),
         ParserFor.make(ParseAPIException),
         ParserFor.make(InvalidIOCasesException),

{codegrade-17.0.40 → codegrade-17.0.42}/src/codegrade/models/api_codes.py

@@ -65,3 +65,4 @@ class APICodes(str, Enum):
     ASSIGNMENT_HAS_STUDENT_SUBMISSIONS = "ASSIGNMENT_HAS_STUDENT_SUBMISSIONS"
     ISOLATED_SESSION_ACTIVE = "ISOLATED_SESSION_ACTIVE"
     TIER_RESTRICTED = "TIER_RESTRICTED"
+    COURSE_USER_LIMIT_EXCEEDED = "COURSE_USER_LIMIT_EXCEEDED"

codegrade-17.0.42/src/codegrade/models/course_user_limit_exceeded_exception.py

@@ -0,0 +1,106 @@
+"""The module that defines the ``CourseUserLimitExceededException`` model.
+
+SPDX-License-Identifier: AGPL-3.0-only OR BSD-3-Clause-Clear
+"""
+
+from __future__ import annotations
+
+import typing as t
+from dataclasses import dataclass, field
+
+import cg_request_args as rqa
+from httpx import Response
+
+from ..utils import to_dict
+from .permission_exception import PermissionException
+
+
+@dataclass
+class CourseUserLimitExceededException(PermissionException):
+    """Exception raised when a course user limit is exceeded."""
+
+    #: The id of the course that has the restriction.
+    course_id: int
+    #: Which user type is at its limit: `"student"` or `"staff"`.
+    user_type: t.Literal["staff", "student"]
+    #: The current number of users of this type in the course.
+    current_count: int
+    #: The maximum number of users of this type allowed in the course.
+    limit: int
+
+    raw_data: t.Optional[t.Dict[str, t.Any]] = field(init=False, repr=False)
+
+    data_parser: t.ClassVar[t.Any] = rqa.Lazy(
+        lambda: PermissionException.data_parser.parser.combine(
+            rqa.FixedMapping(
+                rqa.RequiredArgument(
+                    "course_id",
+                    rqa.SimpleValue.int,
+                    doc="The id of the course that has the restriction.",
+                ),
+                rqa.RequiredArgument(
+                    "user_type",
+                    rqa.StringEnum("staff", "student"),
+                    doc='Which user type is at its limit: `"student"` or `"staff"`.',
+                ),
+                rqa.RequiredArgument(
+                    "current_count",
+                    rqa.SimpleValue.int,
+                    doc="The current number of users of this type in the course.",
+                ),
+                rqa.RequiredArgument(
+                    "limit",
+                    rqa.SimpleValue.int,
+                    doc="The maximum number of users of this type allowed in the course.",
+                ),
+            )
+        ).use_readable_describe(True)
+    )
+
+    def to_dict(self) -> t.Dict[str, t.Any]:
+        res: t.Dict[str, t.Any] = {
+            "course_id": to_dict(self.course_id),
+            "user_type": to_dict(self.user_type),
+            "current_count": to_dict(self.current_count),
+            "limit": to_dict(self.limit),
+            "missing_permissions": to_dict(self.missing_permissions),
+            "user_id": to_dict(self.user_id),
+            "message": to_dict(self.message),
+            "description": to_dict(self.description),
+            "code": to_dict(self.code),
+            "request_id": to_dict(self.request_id),
+        }
+        return res
+
+    @classmethod
+    def from_dict(
+        cls: t.Type[CourseUserLimitExceededException],
+        d: t.Dict[str, t.Any],
+        response: t.Optional[Response] = None,
+    ) -> CourseUserLimitExceededException:
+        parsed = cls.data_parser.try_parse(d)
+
+        res = cls(
+            course_id=parsed.course_id,
+            user_type=parsed.user_type,
+            current_count=parsed.current_count,
+            limit=parsed.limit,
+            missing_permissions=parsed.missing_permissions,
+            user_id=parsed.user_id,
+            message=parsed.message,
+            description=parsed.description,
+            code=parsed.code,
+            request_id=parsed.request_id,
+            response=response,
+        )
+        res.raw_data = d
+        return res
+
+
+import os
+
+if os.getenv("CG_GENERATING_DOCS", "False").lower() in ("", "true"):
+    from .api_codes import APICodes
+    from .base_error import BaseError
+    from .course_permission import CoursePermission
+    from .global_permission import GlobalPermission