codegrade 16.1.48__tar.gz → 16.1.51__tar.gz

{codegrade-16.1.48 → codegrade-16.1.51}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: codegrade
-Version: 16.1.48
+Version: 16.1.51
 Summary: A client library for accessing CodeGrade
 License: AGPL-3.0-only OR BSD-3-Clause-Clear
 Requires-Python: >=3.8.0,<4.0

{codegrade-16.1.48 → codegrade-16.1.51}/codegrade/__init__.py

@@ -7,7 +7,7 @@ from functools import wraps
 from .client import AuthenticatedClient, Client
 
 __all__ = ("login", "AuthenticatedClient", "Client", "login_from_cli")
-__version__ = "16.1.48"
+__version__ = "16.1.51"
 
 
 @wraps(AuthenticatedClient.get)

{codegrade-16.1.48 → codegrade-16.1.51}/codegrade/client.py

@@ -526,7 +526,7 @@ class Client(_BaseClient):
         return httpx.Client(
             base_url=self.base_url,
             headers={
-                "User-Agent": "CodeGradeAPI/16.1.48",
+                "User-Agent": "CodeGradeAPI/16.1.51",
             },
             follow_redirects=True,
         )
@@ -546,7 +546,7 @@ class AuthenticatedClient(_BaseClient):
             base_url=self.base_url,
             headers={
                 "Authorization": f"Bearer {self.token}",
-                "User-Agent": "CodeGradeAPI/16.1.48",
+                "User-Agent": "CodeGradeAPI/16.1.51",
             },
             follow_redirects=True,
         )

{codegrade-16.1.48 → codegrade-16.1.51}/codegrade/models/__init__.py

@@ -255,6 +255,10 @@ from .custom_output_extra import CustomOutputExtra
 from .custom_output_input_as_json import CustomOutputInputAsJSON
 from .custom_output_log import CustomOutputLog
 from .custom_output_log_base import CustomOutputLogBase
+from .default_course_ta_role_setting import DefaultCourseTaRoleSetting
+from .default_course_teacher_role_setting import (
+    DefaultCourseTeacherRoleSetting,
+)
 from .deleted_comment_reply import DeletedCommentReply
 from .deletion_type import DeletionType
 from .directory_with_children import DirectoryWithChildren
@@ -394,9 +398,15 @@ from .logout_response import LogoutResponse
 from .logout_user_data import LogoutUserData
 from .lti1p1_provider import LTI1p1Provider
 from .lti1p1_provider_data import LTI1p1ProviderData
+from .lti1p3_nonce_and_state_validation_enabled_setting import (
+    Lti1p3NonceAndStateValidationEnabledSetting,
+)
 from .lti1p3_parse_most_privileged_role_setting import (
     Lti1p3ParseMostPrivilegedRoleSetting,
 )
+from .lti1p3_prevent_nonce_reuse_enabled_setting import (
+    Lti1p3PreventNonceReuseEnabledSetting,
+)
 from .lti1p3_provider import LTI1p3Provider
 from .lti1p3_provider_data import LTI1p3ProviderData
 from .lti1p3_provider_presentation_as_json import (

{codegrade-16.1.48 → codegrade-16.1.51}/codegrade/models/all_site_settings.py

@@ -131,6 +131,25 @@ class AllSiteSettings(FrontendSiteSettings):
     lti_launch_data_logging: Maybe["bool"] = Nothing
     #: Whether or not pearson templates should be enabled.
     pearson_templates: Maybe["bool"] = Nothing
+    #: The teacher role to be used for teachers in new courses. Existing
+    #: courses will not be affected.
+    default_course_teacher_role: Maybe[
+        "t.Literal['Full Teacher', 'Non-Editing Teacher']"
+    ] = Nothing
+    #: The TA role to be used for TAs in new courses. Existing courses will not
+    #: be affected.
+    default_course_ta_role: Maybe[
+        "t.Literal['Full TA', 'Non-Editing TA']"
+    ] = Nothing
+    #: Whether LTI 1.3 launches using cookies (and sessions) should check for
+    #: correct nonce and state. When disabling this feature flag, please be
+    #: mindful. These validations protect us from certain attacks. If unsure,
+    #: consult with the Security Officer before disabling.
+    lti_1p3_nonce_and_state_validation_enabled: Maybe["bool"] = Nothing
+    #: Whether LTI 1.3 launches should check nonces against the cached value.
+    #: Enabling this prevents replay attacks. If unsure, consult with the
+    #: Security Officer before disabling.
+    lti_1p3_prevent_nonce_reuse_enabled: Maybe["bool"] = Nothing
 
     raw_data: t.Optional[t.Dict[str, t.Any]] = field(init=False, repr=False)
 
@@ -447,6 +466,44 @@ class AllSiteSettings(FrontendSiteSettings):
                     rqa.SimpleValue.bool,
                     doc="Whether or not pearson templates should be enabled.",
                 ),
+                rqa.OptionalArgument(
+                    "DEFAULT_COURSE_TEACHER_ROLE",
+                    rqa.StringEnum("Full Teacher", "Non-Editing Teacher"),
+                    doc=(
+                        "The teacher role to be used for teachers in new"
+                        " courses. Existing courses will not be affected."
+                    ),
+                ),
+                rqa.OptionalArgument(
+                    "DEFAULT_COURSE_TA_ROLE",
+                    rqa.StringEnum("Full TA", "Non-Editing TA"),
+                    doc=(
+                        "The TA role to be used for TAs in new courses."
+                        " Existing courses will not be affected."
+                    ),
+                ),
+                rqa.OptionalArgument(
+                    "LTI_1P3_NONCE_AND_STATE_VALIDATION_ENABLED",
+                    rqa.SimpleValue.bool,
+                    doc=(
+                        "Whether LTI 1.3 launches using cookies (and sessions)"
+                        " should check for correct nonce and state. When"
+                        " disabling this feature flag, please be mindful."
+                        " These validations protect us from certain attacks."
+                        " If unsure, consult with the Security Officer before"
+                        " disabling."
+                    ),
+                ),
+                rqa.OptionalArgument(
+                    "LTI_1P3_PREVENT_NONCE_REUSE_ENABLED",
+                    rqa.SimpleValue.bool,
+                    doc=(
+                        "Whether LTI 1.3 launches should check nonces against"
+                        " the cached value. Enabling this prevents replay"
+                        " attacks. If unsure, consult with the Security"
+                        " Officer before disabling."
+                    ),
+                ),
             )
         ).use_readable_describe(True)
     )
@@ -550,6 +607,18 @@ class AllSiteSettings(FrontendSiteSettings):
             self.lti_launch_data_logging
         )
         self.pearson_templates = maybe_from_nullable(self.pearson_templates)
+        self.default_course_teacher_role = maybe_from_nullable(
+            self.default_course_teacher_role
+        )
+        self.default_course_ta_role = maybe_from_nullable(
+            self.default_course_ta_role
+        )
+        self.lti_1p3_nonce_and_state_validation_enabled = maybe_from_nullable(
+            self.lti_1p3_nonce_and_state_validation_enabled
+        )
+        self.lti_1p3_prevent_nonce_reuse_enabled = maybe_from_nullable(
+            self.lti_1p3_prevent_nonce_reuse_enabled
+        )
 
     def to_dict(self) -> t.Dict[str, t.Any]:
         res: t.Dict[str, t.Any] = {}
@@ -1013,6 +1082,22 @@ class AllSiteSettings(FrontendSiteSettings):
             )
         if self.pearson_templates.is_just:
             res["PEARSON_TEMPLATES"] = to_dict(self.pearson_templates.value)
+        if self.default_course_teacher_role.is_just:
+            res["DEFAULT_COURSE_TEACHER_ROLE"] = to_dict(
+                self.default_course_teacher_role.value
+            )
+        if self.default_course_ta_role.is_just:
+            res["DEFAULT_COURSE_TA_ROLE"] = to_dict(
+                self.default_course_ta_role.value
+            )
+        if self.lti_1p3_nonce_and_state_validation_enabled.is_just:
+            res["LTI_1P3_NONCE_AND_STATE_VALIDATION_ENABLED"] = to_dict(
+                self.lti_1p3_nonce_and_state_validation_enabled.value
+            )
+        if self.lti_1p3_prevent_nonce_reuse_enabled.is_just:
+            res["LTI_1P3_PREVENT_NONCE_REUSE_ENABLED"] = to_dict(
+                self.lti_1p3_prevent_nonce_reuse_enabled.value
+            )
         return res
 
     @classmethod
@@ -1143,6 +1228,10 @@ class AllSiteSettings(FrontendSiteSettings):
             lti_first_launch_content_id_enabled=parsed.LTI_FIRST_LAUNCH_CONTENT_ID_ENABLED,
             lti_launch_data_logging=parsed.LTI_LAUNCH_DATA_LOGGING,
             pearson_templates=parsed.PEARSON_TEMPLATES,
+            default_course_teacher_role=parsed.DEFAULT_COURSE_TEACHER_ROLE,
+            default_course_ta_role=parsed.DEFAULT_COURSE_TA_ROLE,
+            lti_1p3_nonce_and_state_validation_enabled=parsed.LTI_1P3_NONCE_AND_STATE_VALIDATION_ENABLED,
+            lti_1p3_prevent_nonce_reuse_enabled=parsed.LTI_1P3_PREVENT_NONCE_REUSE_ENABLED,
         )
         res.raw_data = d
         return res

{codegrade-16.1.48 → codegrade-16.1.51}/codegrade/models/course_perm_map.py

@@ -280,6 +280,9 @@ class CoursePermMap:
     #: Users with this permission can create test submissions in the
     #: assignments of this course.
     can_create_test_submissions: "bool"
+    #: Users with this permission are allowed to see the details of Pearson
+    #: templates in a course (context).
+    can_view_pearson_context_templates: "bool"
 
     raw_data: t.Optional[t.Dict[str, t.Any]] = field(init=False, repr=False)
 
@@ -1006,6 +1009,14 @@ class CoursePermMap:
                     " the assignments of this course."
                 ),
             ),
+            rqa.RequiredArgument(
+                "can_view_pearson_context_templates",
+                rqa.SimpleValue.bool,
+                doc=(
+                    "Users with this permission are allowed to see the details"
+                    " of Pearson templates in a course (context)."
+                ),
+            ),
         ).use_readable_describe(True)
     )
 
@@ -1174,6 +1185,9 @@ class CoursePermMap:
             "can_create_test_submissions": to_dict(
                 self.can_create_test_submissions
             ),
+            "can_view_pearson_context_templates": to_dict(
+                self.can_view_pearson_context_templates
+            ),
         }
         return res
 
@@ -1269,6 +1283,7 @@ class CoursePermMap:
             can_view_own_course_section_members=parsed.can_view_own_course_section_members,
             can_view_all_assignment_timeframes=parsed.can_view_all_assignment_timeframes,
             can_create_test_submissions=parsed.can_create_test_submissions,
+            can_view_pearson_context_templates=parsed.can_view_pearson_context_templates,
         )
         res.raw_data = d
         return res

{codegrade-16.1.48 → codegrade-16.1.51}/codegrade/models/course_permission.py

@@ -105,3 +105,4 @@ class CoursePermission(str, Enum):
     can_view_own_course_section_members = "can_view_own_course_section_members"
     can_view_all_assignment_timeframes = "can_view_all_assignment_timeframes"
     can_create_test_submissions = "can_create_test_submissions"
+    can_view_pearson_context_templates = "can_view_pearson_context_templates"

codegrade-16.1.51/codegrade/models/default_course_ta_role_setting.py

@@ -0,0 +1,56 @@
+"""The module that defines the ``DefaultCourseTaRoleSetting`` model.
+
+SPDX-License-Identifier: AGPL-3.0-only OR BSD-3-Clause-Clear
+"""
+
+import typing as t
+from dataclasses import dataclass, field
+
+import cg_request_args as rqa
+
+from ..utils import to_dict
+
+
+@dataclass
+class DefaultCourseTaRoleSetting:
+    """ """
+
+    name: "t.Literal['DEFAULT_COURSE_TA_ROLE']"
+    value: "t.Optional[t.Literal['Full TA', 'Non-Editing TA']]"
+
+    raw_data: t.Optional[t.Dict[str, t.Any]] = field(init=False, repr=False)
+
+    data_parser: t.ClassVar = rqa.Lazy(
+        lambda: rqa.FixedMapping(
+            rqa.RequiredArgument(
+                "name",
+                rqa.StringEnum("DEFAULT_COURSE_TA_ROLE"),
+                doc="",
+            ),
+            rqa.RequiredArgument(
+                "value",
+                rqa.Nullable(rqa.StringEnum("Full TA", "Non-Editing TA")),
+                doc="",
+            ),
+        ).use_readable_describe(True)
+    )
+
+    def to_dict(self) -> t.Dict[str, t.Any]:
+        res: t.Dict[str, t.Any] = {
+            "name": to_dict(self.name),
+            "value": to_dict(self.value),
+        }
+        return res
+
+    @classmethod
+    def from_dict(
+        cls: t.Type["DefaultCourseTaRoleSetting"], d: t.Dict[str, t.Any]
+    ) -> "DefaultCourseTaRoleSetting":
+        parsed = cls.data_parser.try_parse(d)
+
+        res = cls(
+            name=parsed.name,
+            value=parsed.value,
+        )
+        res.raw_data = d
+        return res

codegrade-16.1.51/codegrade/models/default_course_teacher_role_setting.py

@@ -0,0 +1,58 @@
+"""The module that defines the ``DefaultCourseTeacherRoleSetting`` model.
+
+SPDX-License-Identifier: AGPL-3.0-only OR BSD-3-Clause-Clear
+"""
+
+import typing as t
+from dataclasses import dataclass, field
+
+import cg_request_args as rqa
+
+from ..utils import to_dict
+
+
+@dataclass
+class DefaultCourseTeacherRoleSetting:
+    """ """
+
+    name: "t.Literal['DEFAULT_COURSE_TEACHER_ROLE']"
+    value: "t.Optional[t.Literal['Full Teacher', 'Non-Editing Teacher']]"
+
+    raw_data: t.Optional[t.Dict[str, t.Any]] = field(init=False, repr=False)
+
+    data_parser: t.ClassVar = rqa.Lazy(
+        lambda: rqa.FixedMapping(
+            rqa.RequiredArgument(
+                "name",
+                rqa.StringEnum("DEFAULT_COURSE_TEACHER_ROLE"),
+                doc="",
+            ),
+            rqa.RequiredArgument(
+                "value",
+                rqa.Nullable(
+                    rqa.StringEnum("Full Teacher", "Non-Editing Teacher")
+                ),
+                doc="",
+            ),
+        ).use_readable_describe(True)
+    )
+
+    def to_dict(self) -> t.Dict[str, t.Any]:
+        res: t.Dict[str, t.Any] = {
+            "name": to_dict(self.name),
+            "value": to_dict(self.value),
+        }
+        return res
+
+    @classmethod
+    def from_dict(
+        cls: t.Type["DefaultCourseTeacherRoleSetting"], d: t.Dict[str, t.Any]
+    ) -> "DefaultCourseTeacherRoleSetting":
+        parsed = cls.data_parser.try_parse(d)
+
+        res = cls(
+            name=parsed.name,
+            value=parsed.value,
+        )
+        res.raw_data = d
+        return res

codegrade-16.1.51/codegrade/models/lti1p3_nonce_and_state_validation_enabled_setting.py

@@ -0,0 +1,57 @@
+"""The module that defines the ``Lti1p3NonceAndStateValidationEnabledSetting`` model.
+
+SPDX-License-Identifier: AGPL-3.0-only OR BSD-3-Clause-Clear
+"""
+
+import typing as t
+from dataclasses import dataclass, field
+
+import cg_request_args as rqa
+
+from ..utils import to_dict
+
+
+@dataclass
+class Lti1p3NonceAndStateValidationEnabledSetting:
+    """ """
+
+    name: "t.Literal['LTI_1P3_NONCE_AND_STATE_VALIDATION_ENABLED']"
+    value: "t.Optional[bool]"
+
+    raw_data: t.Optional[t.Dict[str, t.Any]] = field(init=False, repr=False)
+
+    data_parser: t.ClassVar = rqa.Lazy(
+        lambda: rqa.FixedMapping(
+            rqa.RequiredArgument(
+                "name",
+                rqa.StringEnum("LTI_1P3_NONCE_AND_STATE_VALIDATION_ENABLED"),
+                doc="",
+            ),
+            rqa.RequiredArgument(
+                "value",
+                rqa.Nullable(rqa.SimpleValue.bool),
+                doc="",
+            ),
+        ).use_readable_describe(True)
+    )
+
+    def to_dict(self) -> t.Dict[str, t.Any]:
+        res: t.Dict[str, t.Any] = {
+            "name": to_dict(self.name),
+            "value": to_dict(self.value),
+        }
+        return res
+
+    @classmethod
+    def from_dict(
+        cls: t.Type["Lti1p3NonceAndStateValidationEnabledSetting"],
+        d: t.Dict[str, t.Any],
+    ) -> "Lti1p3NonceAndStateValidationEnabledSetting":
+        parsed = cls.data_parser.try_parse(d)
+
+        res = cls(
+            name=parsed.name,
+            value=parsed.value,
+        )
+        res.raw_data = d
+        return res

codegrade-16.1.51/codegrade/models/lti1p3_prevent_nonce_reuse_enabled_setting.py

@@ -0,0 +1,57 @@
+"""The module that defines the ``Lti1p3PreventNonceReuseEnabledSetting`` model.
+
+SPDX-License-Identifier: AGPL-3.0-only OR BSD-3-Clause-Clear
+"""
+
+import typing as t
+from dataclasses import dataclass, field
+
+import cg_request_args as rqa
+
+from ..utils import to_dict
+
+
+@dataclass
+class Lti1p3PreventNonceReuseEnabledSetting:
+    """ """
+
+    name: "t.Literal['LTI_1P3_PREVENT_NONCE_REUSE_ENABLED']"
+    value: "t.Optional[bool]"
+
+    raw_data: t.Optional[t.Dict[str, t.Any]] = field(init=False, repr=False)
+
+    data_parser: t.ClassVar = rqa.Lazy(
+        lambda: rqa.FixedMapping(
+            rqa.RequiredArgument(
+                "name",
+                rqa.StringEnum("LTI_1P3_PREVENT_NONCE_REUSE_ENABLED"),
+                doc="",
+            ),
+            rqa.RequiredArgument(
+                "value",
+                rqa.Nullable(rqa.SimpleValue.bool),
+                doc="",
+            ),
+        ).use_readable_describe(True)
+    )
+
+    def to_dict(self) -> t.Dict[str, t.Any]:
+        res: t.Dict[str, t.Any] = {
+            "name": to_dict(self.name),
+            "value": to_dict(self.value),
+        }
+        return res
+
+    @classmethod
+    def from_dict(
+        cls: t.Type["Lti1p3PreventNonceReuseEnabledSetting"],
+        d: t.Dict[str, t.Any],
+    ) -> "Lti1p3PreventNonceReuseEnabledSetting":
+        parsed = cls.data_parser.try_parse(d)
+
+        res = cls(
+            name=parsed.name,
+            value=parsed.value,
+        )
+        res.raw_data = d
+        return res

{codegrade-16.1.48 → codegrade-16.1.51}/codegrade/models/site_setting_input.py

@@ -103,6 +103,10 @@ from .course_gradebook_render_warning_size_setting import (
 from .course_register_enabled_setting import CourseRegisterEnabledSetting
 from .csv_large_file_limit_setting import CsvLargeFileLimitSetting
 from .csv_too_many_errors_limit_setting import CsvTooManyErrorsLimitSetting
+from .default_course_ta_role_setting import DefaultCourseTaRoleSetting
+from .default_course_teacher_role_setting import (
+    DefaultCourseTeacherRoleSetting,
+)
 from .editor_enabled_for_teachers_setting import (
     EditorEnabledForTeachersSetting,
 )
@@ -140,9 +144,15 @@ from .is_admin_permission_enabled_setting import (
 from .jwt_access_token_expires_setting import JwtAccessTokenExpiresSetting
 from .linters_enabled_setting import LintersEnabledSetting
 from .login_token_before_time_setting import LoginTokenBeforeTimeSetting
+from .lti1p3_nonce_and_state_validation_enabled_setting import (
+    Lti1p3NonceAndStateValidationEnabledSetting,
+)
 from .lti1p3_parse_most_privileged_role_setting import (
     Lti1p3ParseMostPrivilegedRoleSetting,
 )
+from .lti1p3_prevent_nonce_reuse_enabled_setting import (
+    Lti1p3PreventNonceReuseEnabledSetting,
+)
 from .lti1p3_system_role_from_context_role_setting import (
     Lti1p3SystemRoleFromContextRoleSetting,
 )
@@ -396,6 +406,10 @@ SiteSettingInput = t.Union[
     SimpleSubmissionNavigateToLatestEditorSessionSetting,
     GradeViewerAndEditorOnSubmissionEnabledSetting,
     HideEmptyRubricRowDescriptionSetting,
+    DefaultCourseTeacherRoleSetting,
+    DefaultCourseTaRoleSetting,
+    Lti1p3NonceAndStateValidationEnabledSetting,
+    Lti1p3PreventNonceReuseEnabledSetting,
 ]
 SiteSettingInputParser = rqa.Lazy(
     lambda: make_union(
@@ -520,5 +534,9 @@ SiteSettingInputParser = rqa.Lazy(
         ParserFor.make(SimpleSubmissionNavigateToLatestEditorSessionSetting),
         ParserFor.make(GradeViewerAndEditorOnSubmissionEnabledSetting),
         ParserFor.make(HideEmptyRubricRowDescriptionSetting),
+        ParserFor.make(DefaultCourseTeacherRoleSetting),
+        ParserFor.make(DefaultCourseTaRoleSetting),
+        ParserFor.make(Lti1p3NonceAndStateValidationEnabledSetting),
+        ParserFor.make(Lti1p3PreventNonceReuseEnabledSetting),
     ),
 )

{codegrade-16.1.48 → codegrade-16.1.51}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "codegrade"
-version = "16.1.48"
+version = "16.1.51"
 description = "A client library for accessing CodeGrade"
 license = "AGPL-3.0-only OR BSD-3-Clause-Clear"
 authors = []

{codegrade-16.1.48 → codegrade-16.1.51}/setup.py

@@ -21,7 +21,7 @@ install_requires = \
 
 setup_kwargs = {
     'name': 'codegrade',
-    'version': '16.1.48',
+    'version': '16.1.51',
     'description': 'A client library for accessing CodeGrade',
     'long_description': '# CodeGrade API\n\nThis library makes it easier to use the CodeGrade API. Its API allows you to\nautomate your usage of CodeGrade. We are currently still busy documenting the\nentire API, but everything that is possible in the UI of CodeGrade is also\npossible through the API.\n## Installation\nYou can install the library through [pypi](https://pypi.org/), simply run\n`python3 -m pip install codegrade`. If you want to get a dev version with support\nfor the latest features, simply email [support@codegrade.com](mailto:support@codegrade.com)\nand we\'ll provide you with a dev version.\n## Usage\nFirst, create a client:\n\n```python\nimport codegrade\n\n# Don\'t store your password in your code!\nwith codegrade.login(\n    username=\'my-username\',\n    password=os.getenv(\'CG_PASSWORD\'),\n    tenant=\'My University\',\n) as client:\n    pass\n\n# Or supply information interactively.\nwith codegrade.login_from_cli() as client:\n    pass\n```\n\nNow call your endpoint and use your models:\n\n```python\nfrom codegrade.models import PatchCourseData\n\ncourses = client.course.get_all()\nfor course in courses:\n    client.course.patch(\n        PatchCourseData(name=course.name + \' (NEW)\'),\n        course_id=course.id,\n    )\n\n# Or, simply use dictionaries.\nfor course in courses:\n    client.course.patch(\n        {"name": course.name + \' (NEW)\'},\n        course_id=course.id,\n    )\n```\n\nFor the complete documentation go to\nhttps://python.api.codegrade.com.\n## Backwards compatibility\nCodeGrade is constantly upgrading its API, but we try to minimize backwards\nincompatible changes. We\'ll announce every backwards incompatible change in the\n[changelog](http://codegrade.com/changelog). A new version of the API\nclient is released with every release of CodeGrade, which is approximately every\nmonth. To upgrade simply run `pip install --upgrade codegrade`.\n## Supported python versions\nWe support python 3.6 and above, `pypy` is currently not tested but should work\njust fine.\n## License\nThe library is licensed under AGPL-3.0-only or BSD-3-Clause-Clear.',
     'author': 'None',