clear-skies-gitlab 2.0.1__py3-none-any.whl → 2.0.3__py3-none-any.whl

{clear_skies_gitlab-2.0.1.dist-info → clear_skies_gitlab-2.0.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clear-skies-gitlab
-Version: 2.0.1
+Version: 2.0.3
 Summary: Gitlab module for Clearskies
 Project-URL: Docs, https://https://clearskies.info/modules/clear-skies-gitlab
 Project-URL: Repository, https://github.com/clearskies-py/gitlab
@@ -15,7 +15,7 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Requires-Python: <4.0,>=3.11
 Requires-Dist: clear-skies>=2.0.0
-Requires-Dist: gql>=4.0.0
+Requires-Dist: gql[all]>=4.0.0
 Requires-Dist: requests>=2.32.5
 Provides-Extra: dev
 Requires-Dist: types-requests>=2.32.4; extra == 'dev'

clear_skies_gitlab-2.0.3.dist-info/RECORD

@@ -0,0 +1,68 @@
+clearskies_gitlab/__init__.py,sha256=TlKrAfFOTW6YnQefxEQbUdnf_F3sVOvRKsG_6cfFAsk,123
+clearskies_gitlab/defaults/__init__.py,sha256=t3Dfm98aoahHCepQnW1YBSVKgDz0QEp7hTrGL8XAcTE,341
+clearskies_gitlab/defaults/gitlab_default_auth.py,sha256=w8w7LcekC38tbD-fuv5liDnvo4UsBxKVF7YZoTuzUus,456
+clearskies_gitlab/defaults/gitlab_default_host.py,sha256=wlyj0u-nbUqkkZQnZFgMXKH32nNlTABfCL6iWA88V6E,411
+clearskies_gitlab/defaults/gitlab_graphql_client.py,sha256=eIQ3efp2oYFuGSIGimZ1e5AC8TOTy1j8K26SU_AK-yU,609
+clearskies_gitlab/exceptions/__init__.py,sha256=QUg8lVn91QMENpN_uZmYdNkhI1EjFAWN9X6cMKgKmtE,301
+clearskies_gitlab/exceptions/gitlab_error.py,sha256=5hm8iYXnEfxxRkKPBXIq0v5mL1l5ZqaxlmUKnBjOe3g,2054
+clearskies_gitlab/graphql/__init__.py,sha256=zIlWQCDVnQLYPmPLsK4m4HJkDLS9Ltk2BFMpfTNpBOw,89
+clearskies_gitlab/graphql/backends/__init__.py,sha256=1QrNzwAnabngNZc-5lCAEdG0ePJv6BKEk3K2vNul4mk,170
+clearskies_gitlab/graphql/backends/gitlab_graphql_backend.py,sha256=B_nor-KI5JEeMDe9MbLP0vT8hbUciBbaKfW4r5ursR0,1326
+clearskies_gitlab/graphql/models/__init__.py,sha256=aKF4Ag-xZPUncPWJXovWAaROnsIdaItNzZmyXSYq3Mg,509
+clearskies_gitlab/graphql/models/gitlab_container_repository.py,sha256=ouj2pe8REgY8EW0uTfB3m-TS_EXqD4fuEeMAnHT4CLI,1192
+clearskies_gitlab/graphql/models/gitlab_container_repository_reference.py,sha256=wC_7sQ2ucmg9YxpLJ-EfgXa_gqjk3ptJP5wM2i833T0,352
+clearskies_gitlab/graphql/models/gitlab_container_repository_tag.py,sha256=V4pPiQdIvrzbHczTzR-wq3DHyVB42CKnyzXW8KY869U,1090
+clearskies_gitlab/graphql/models/gitlab_container_repository_tag_reference.py,sha256=IT8eUsOgVkoHpyswIasU-69yl1eXQJT6dgAh2pLBzHg,369
+clearskies_gitlab/graphql/models/gitlab_group.py,sha256=jqrySCT5iVWP9NYUPaI84MUiWss6isFh0_FwBY_fV-E,633
+clearskies_gitlab/graphql/models/gitlab_group_reference.py,sha256=V3y3DxKMhUWWjXINu1jxLSKublJdPqPWlr651F0mZB4,280
+clearskies_gitlab/graphql/models/gitlab_project.py,sha256=IBG38Rwks6A9aqC2Qlss_qWohNQ2oUHF64irwE3-mj8,641
+clearskies_gitlab/graphql/models/gitlab_project_reference.py,sha256=Z5Hi991TFQip-1151XcP-_ITVHwWmJiTDTlqRoAsg0A,290
+clearskies_gitlab/rest/__init__.py,sha256=KZyBO-7OCE_qgClt-eTOh8jYIJccKpcuXHZ4eZCpW-0,316
+clearskies_gitlab/rest/gitlab_branch_rule.py,sha256=D8HptQg9BdKAtPtVkRYbt1sga0R9eErECYDLLuvSa7A,569
+clearskies_gitlab/rest/gitlab_cicd_variable.py,sha256=398-5SPlMk3-Zyu1dZTbpM9YCP2qNOsnydku3hiWvlc,446
+clearskies_gitlab/rest/gitlab_member.py,sha256=o1G652wbIImd8rz9NJQeAlJaxAftNt-6u7quoLYFwh0,487
+clearskies_gitlab/rest/backends/__init__.py,sha256=xUhpRXyB_FHhTsz94A2kviBlPzZfaKqIiHOhDrNg6Wc,115
+clearskies_gitlab/rest/backends/gitlab_rest_backend.py,sha256=nAZe8JRD1xMUNNoinOBWAGWv__S3Jko9d7OhXUlTeQk,6672
+clearskies_gitlab/rest/models/__init__.py,sha256=mcfdh04R8Fu5T-6Cz-Iy3CJ2LLttgkwBGd3Qp0Rtt6A,2750
+clearskies_gitlab/rest/models/gitlab_rest_advanced_search.py,sha256=iFxCGDaqzRxl2a9g91P7zpj2ZAxuRbYoSiz_hsXMavY,883
+clearskies_gitlab/rest/models/gitlab_rest_advanced_search_blob.py,sha256=R3DFxbAcm3Em8S6dZ51EG6m-OSaM-BQmuo035SHV5NU,628
+clearskies_gitlab/rest/models/gitlab_rest_current_user.py,sha256=KrOfehkusr_FlB8Q4-IOU51Go5ULgykBDi9v883w80k,1135
+clearskies_gitlab/rest/models/gitlab_rest_group.py,sha256=iJgz78APzdlK9TOv0OmqVU_3qg-lJ3cdUBkMjyqhYho,1410
+clearskies_gitlab/rest/models/gitlab_rest_group_access_token.py,sha256=83tvO01CQktMwLm1Is9fIf_IkGR6zFIvvELwjkdSr4s,843
+clearskies_gitlab/rest/models/gitlab_rest_group_access_token_reference.py,sha256=GZnAOIgIDJCPR55ABD4bxPT--TUOnkVV1peQMtai2dU,358
+clearskies_gitlab/rest/models/gitlab_rest_group_base.py,sha256=lnX37uxnIu1aWmGjDuT1ZVk9NeHQwmnFRjS_2Wjq53s,3102
+clearskies_gitlab/rest/models/gitlab_rest_group_member.py,sha256=CLkslCom4Deo2c3GdkoM8cuVYLOsvfreYzOUm64DTNs,707
+clearskies_gitlab/rest/models/gitlab_rest_group_member_reference.py,sha256=XrhG_hiqGQf8vIosss2Vp4RWvNNtHxIn-TzXtPGQvgU,331
+clearskies_gitlab/rest/models/gitlab_rest_group_project.py,sha256=33hEMN08aIsl4-tcIgNmruGLRYr0XqIuD9nQZ3Xs_CY,415
+clearskies_gitlab/rest/models/gitlab_rest_group_project_reference.py,sha256=fp45VWXMC_3inaep1GIS6ortIucZoxh-7xb7RnTl8DI,336
+clearskies_gitlab/rest/models/gitlab_rest_group_reference.py,sha256=UiHQpQNuVM3WotCNEFIlEqLwXMdy-8YqYRil-S84MQI,292
+clearskies_gitlab/rest/models/gitlab_rest_group_search.py,sha256=VgpGDRwe3UhY2AXfqWpGYYY6ghUhoDNKJqeLsrNtwcA,506
+clearskies_gitlab/rest/models/gitlab_rest_group_search_blob.py,sha256=_tIkwwDzJF9nGV0LL9fVqY5Tn4SSBXNg1C0dKlUQ-oM,353
+clearskies_gitlab/rest/models/gitlab_rest_group_subgroup.py,sha256=x0h_alIV3QFbslXIlqHC48HAOmmFw5T96XAwWh31-uA,1937
+clearskies_gitlab/rest/models/gitlab_rest_group_subgroup_reference.py,sha256=vFAlOmQ8wJswlcNGJ9zrrxidsFXC70hDfYNrNZ5VQ9g,341
+clearskies_gitlab/rest/models/gitlab_rest_group_variable.py,sha256=ixs4o6BV31sepagW46d4ipunn-szKNCHtlqKB6IxG5o,607
+clearskies_gitlab/rest/models/gitlab_rest_group_variable_reference.py,sha256=rGgqrOY-HCxpsstDb1_Hy_KwPt6Z37xxIJnBRD9eXXw,341
+clearskies_gitlab/rest/models/gitlab_rest_namespace.py,sha256=AIh56mDeB8LtrKVhWEtZ1Gop_V9enBdObjpKfK5b-0g,2484
+clearskies_gitlab/rest/models/gitlab_rest_project.py,sha256=Nc6u-R3Pb4NO6pZUYtZ6RYkygqizyiTybIkpFN47aXM,6687
+clearskies_gitlab/rest/models/gitlab_rest_project_approval_config.py,sha256=E1Yhk4kWQfWA1Peyml0yrJuJeqkFfMvYffQ7vmfNmoc,1099
+clearskies_gitlab/rest/models/gitlab_rest_project_approval_config_reference.py,sha256=Gfs1iFo8VOH8llpcdOquZ7uNA5qFv6LNaGx-glTC3AM,383
+clearskies_gitlab/rest/models/gitlab_rest_project_approval_rule.py,sha256=W1bHWl1kv9Avs3oBtOAowVpVB0-pe2mXGDFyQuxUnJM,1249
+clearskies_gitlab/rest/models/gitlab_rest_project_approval_rule_reference.py,sha256=VTWBcv225UQyxFr8ZdTpgEdXCiTerYGIbYyGdt1j-tc,373
+clearskies_gitlab/rest/models/gitlab_rest_project_member.py,sha256=StXXvQ4Hs5VV2ngEMGvhdKwbXwlOu1ABbeQ-rfM3r48,717
+clearskies_gitlab/rest/models/gitlab_rest_project_member_reference.py,sha256=nNz0Qm5Q5Esyugk9IiNe3Y2Q9SNwWPiLxpOQuiMNAMk,341
+clearskies_gitlab/rest/models/gitlab_rest_project_protected_branch.py,sha256=95peeiCkBQCCsYWidIWWNAywBnPh1w9NUzVtrOIQwHY,1031
+clearskies_gitlab/rest/models/gitlab_rest_project_protected_branch_reference.py,sha256=TCP892aJDxn_YKR0wJFfOTfkwOHoDAc6uBvrDYO5fl8,388
+clearskies_gitlab/rest/models/gitlab_rest_project_reference.py,sha256=Rg3-fjN9WHoIsubKO3Un1trqPU1-ZoZAkE6jW33P568,302
+clearskies_gitlab/rest/models/gitlab_rest_project_repository_commit.py,sha256=h9Q3b3YtFXpCC_OVqckohm1tCZwGCfojBL3qo6I3oSw,1532
+clearskies_gitlab/rest/models/gitlab_rest_project_repository_commit_diff.py,sha256=xUxnA6TGOfwSraojid06V1wXOF-Tqp8JXw0a7Kg50nc,894
+clearskies_gitlab/rest/models/gitlab_rest_project_repository_contributor.py,sha256=QEvGxMOHIKFPoxjo9OzESaJ_syHij9o_dubFvhacIJo,971
+clearskies_gitlab/rest/models/gitlab_rest_project_repository_contributor_reference.py,sha256=yEIO424xhYcN7YpyAVXseMVET48RZ0hpu_WOOZTf3LA,418
+clearskies_gitlab/rest/models/gitlab_rest_project_repository_file.py,sha256=0yYNi2zgUjl4UAjUvDaJ92wIutxOEpzBKNE-7dBN3ZQ,1112
+clearskies_gitlab/rest/models/gitlab_rest_project_repository_file_raw.py,sha256=oExYzvAT6mUxY5mkw-nkAUZh-MmWy5lXq9UcFRst7nA,895
+clearskies_gitlab/rest/models/gitlab_rest_project_repository_file_reference.py,sha256=WiK7aOhBZD_8HRvvlTQ6oWk3hXOJAyfEKdqmCIUIM9M,383
+clearskies_gitlab/rest/models/gitlab_rest_project_variable.py,sha256=rfmk38ndgtdzoaoUFxRDPLhrRc5JWuNa2B2mWO1q4aM,813
+clearskies_gitlab/rest/models/gitlab_rest_project_variable_reference.py,sha256=6P-9TbvhYMZGoBMM-BFFDFKsN40LEXd9FKYNTFpNayU,351
+clear_skies_gitlab-2.0.3.dist-info/METADATA,sha256=NZnrQFwjEuoE0637A1J7ewQjNNAitVQc714US84tP7Q,2143
+clear_skies_gitlab-2.0.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+clear_skies_gitlab-2.0.3.dist-info/licenses/LICENSE,sha256=S7gzTni6Tje0gBaQnXxs5BXdrBBKQ9eAVWjMHZccST8,1069
+clear_skies_gitlab-2.0.3.dist-info/RECORD,,

{clear_skies_gitlab-2.0.1.dist-info → clear_skies_gitlab-2.0.3.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.27.0
+Generator: hatchling 1.28.0
 Root-Is-Purelib: true
 Tag: py3-none-any

{clear_skies_gitlab-2.0.1.dist-info → clear_skies_gitlab-2.0.3.dist-info}/licenses/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025, Tom Nijboer
+Copyright (c) 2026, Tom Nijboer
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

clearskies_gitlab/__init__.py

@@ -1,3 +1,3 @@
-from clearskies_gitlab import backends, defaults, exceptions, models
+from clearskies_gitlab import defaults, exceptions, graphql, rest
 
-__all__ = ["backends", "models", "defaults", "exceptions"]
+__all__ = ["rest", "graphql", "defaults", "exceptions"]

clearskies_gitlab/defaults/__init__.py

@@ -1,7 +1,9 @@
 from clearskies_gitlab.defaults.gitlab_default_auth import GitlabDefaultAuth
-from clearskies_gitlab.defaults.gitlab_default_url import GitlabDefaultUrl
+from clearskies_gitlab.defaults.gitlab_default_host import GitlabDefaultHost
+from clearskies_gitlab.defaults.gitlab_graphql_client import GitlabDefaultGraphqlClient
 
 __all__ = [
     "GitlabDefaultAuth",
-    "GitlabDefaultUrl",
+    "GitlabDefaultHost",
+    "GitlabDefaultGraphqlClient",
 ]

clearskies_gitlab/defaults/gitlab_default_auth.py

@@ -2,6 +2,9 @@ import clearskies
 
 
 class GitlabDefaultAuth(clearskies.di.AdditionalConfigAutoImport):
+    """Provide default Gitlab authentication from environment."""
+
     def provide_gitlab_auth(self, environment: clearskies.Environment):
+        """Provide the Gitlab authentication from environment."""
         secret_key = environment.get("GITLAB_AUTH_KEY", True)
         return clearskies.authentication.SecretBearer(secret_key=secret_key, header_prefix="Bearer ")

clearskies_gitlab/defaults/gitlab_default_host.py

@@ -0,0 +1,10 @@
+import clearskies
+
+
+class GitlabDefaultHost(clearskies.di.AdditionalConfigAutoImport):
+    """Provide default GitLab Host from environment."""
+
+    def provide_gitlab_host(self, environment: clearskies.Environment):
+        """Provide the GitLab host from environment or default."""
+        gitlab_host = environment.get("GITLAB_HOST", True)
+        return gitlab_host if gitlab_host else "https://gitlab.com/"

clearskies_gitlab/defaults/gitlab_graphql_client.py

@@ -0,0 +1,18 @@
+import clearskies
+
+
+class GitlabDefaultGraphqlClient(clearskies.di.AdditionalConfigAutoImport):
+    """Provide default Gitlab authentication from environment."""
+
+    def provide_gitlab_graphql_client(
+        self,
+        gitlab_auth: clearskies.authentication.Authentication,
+        gitlab_host: str,
+        environment: clearskies.Environment,
+    ):
+        """Provide the Gitlab authentication from environment."""
+        return clearskies.clients.GraphqlClient(
+            endpoint=f"{gitlab_host.rstrip('/')}/api/graphql",
+            authentication=gitlab_auth,
+            timeout=30,
+        )

clearskies_gitlab/exceptions/gitlab_error.py

@@ -47,4 +47,5 @@ class GitlabParamMissingError(ValueError):
     """Error if param is missing."""
 
     def __init__(self, param_name: str, table_name: str) -> None:
+        """Create error with param and table name."""
         super().__init__(f"Must provide the {param_name} to add the member to when updating a {table_name}")

clearskies_gitlab/graphql/__init__.py

@@ -0,0 +1,3 @@
+from clearskies_gitlab.graphql import backends, models
+
+__all__ = ["backends", "models"]

clearskies_gitlab/graphql/backends/__init__.py

@@ -0,0 +1,7 @@
+from __future__ import annotations
+
+from clearskies_gitlab.graphql.backends.gitlab_graphql_backend import GitlabGraphqlBackend
+
+__all__ = [
+    "GitlabGraphqlBackend",
+]

clearskies_gitlab/graphql/backends/gitlab_graphql_backend.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+from clearskies import configs, decorators
+from clearskies.backends import GraphqlBackend
+from clearskies.clients.graphql_client import GraphqlClient
+from clearskies.di import inject
+
+
+class GitlabGraphqlBackend(GraphqlBackend):
+    """Backend to gitlab using graphql."""
+
+    graphql_client_name = configs.String(default="gitlab_graphql_client")
+
+    api_to_model_map = configs.AnyDict(default={})
+    pagination_parameter_name = configs.String(default="page")
+    api_casing = configs.String(default="camelCase")
+    model_casing = configs.String(default="snake_case")
+
+    di = inject.Di()
+
+    @decorators.parameters_to_properties
+    def __init__(
+        self,
+        graphql_client: GraphqlClient | None = None,
+        graphql_client_name: str = "gitlab_graphql_client",
+        root_field: str = "",
+        pagination_style: str = "cursor",
+        api_case: str = "camelCase",
+        model_case: str = "snake_case",
+        is_collection: bool | None = None,
+        max_relationship_depth: int = 2,
+        relationship_limit: int = 10,
+        use_connection_for_relationships: bool = True,
+        id_argument_name: str | None = None,
+        id_argument_is_array: bool = False,
+        id_format_pattern: str = "",
+    ):
+        self.finalize_and_validate_configuration()

clearskies_gitlab/graphql/models/__init__.py

@@ -0,0 +1,13 @@
+from __future__ import annotations
+
+from clearskies_gitlab.graphql.models.gitlab_container_repository import GitlabContainerRepository
+from clearskies_gitlab.graphql.models.gitlab_container_repository_tag import GitlabContainerRepositoryTag
+from clearskies_gitlab.graphql.models.gitlab_group import GitlabGroup
+from clearskies_gitlab.graphql.models.gitlab_project import GitlabProject
+
+__all__ = [
+    "GitlabContainerRepository",
+    "GitlabContainerRepositoryTag",
+    "GitlabProject",
+    "GitlabGroup",
+]

clearskies_gitlab/graphql/models/gitlab_container_repository.py

@@ -0,0 +1,34 @@
+from clearskies import Model
+from clearskies.columns import BelongsToId, BelongsToModel, Datetime, HasMany, String
+
+from clearskies_gitlab.graphql.backends import GitlabGraphqlBackend
+from clearskies_gitlab.graphql.models import gitlab_container_repository_tag_reference, gitlab_project_reference
+
+
+class GitlabContainerRepository(Model):
+    """Model for gitlab container repositories via GQL."""
+
+    id_column_name: str = "id"
+
+    backend = GitlabGraphqlBackend(
+        root_field="containerRepositories",
+        id_argument_is_array=True,
+        id_format_pattern="gid://gitlab/ContainerRepository/{id}",
+        id_argument_name="ids",
+    )
+
+    @classmethod
+    def destination_name(cls) -> str:
+        """Return the slug of the api endpoint for this model."""
+        return "containerRepository"
+
+    name = String()
+    location = String()
+    path = String()
+    created_at = Datetime()
+    project_id = BelongsToId(gitlab_project_reference.GitlabProjectReference)
+    project = BelongsToModel("project_id")
+    tags = HasMany(
+        gitlab_container_repository_tag_reference.GitlabContainerRepositoryTagReference,
+        foreign_column_name="containerRepositoryId",
+    )

clearskies_gitlab/graphql/models/gitlab_container_repository_reference.py

@@ -0,0 +1,8 @@
+class GitlabContainerRepositoryReference:
+    """Reference to GitlabContainerRepository model."""
+
+    def get_model_class(self) -> type:
+        """Return the model class this reference points to."""
+        from clearskies_gitlab.graphql.models import gitlab_container_repository
+
+        return gitlab_container_repository.GitlabContainerRepository

clearskies_gitlab/graphql/models/gitlab_container_repository_tag.py

@@ -0,0 +1,32 @@
+from clearskies import Model
+from clearskies.columns import BelongsToId, BelongsToModel, Datetime, String
+
+from clearskies_gitlab.graphql.backends import GitlabGraphqlBackend
+from clearskies_gitlab.graphql.models import gitlab_container_repository_reference
+
+
+class GitlabContainerRepositoryTag(Model):
+    """Model for gitlab container repositories via GQL."""
+
+    id_column_name: str = "name"
+
+    backend = GitlabGraphqlBackend(
+        root_field="containerRepositories",
+        id_argument_is_array=True,
+        id_format_pattern="gid://gitlab/ContainerRepository/{id}",
+        id_argument_name="ids",
+    )
+
+    @classmethod
+    def destination_name(cls) -> str:
+        """Return the slug of the api endpoint for this model."""
+        return "tag"
+
+    name = String()
+    digest = String()
+    location = String()
+    path = String()
+    created_at = Datetime()
+    published_at = Datetime()
+    container_repository_id = BelongsToId(gitlab_container_repository_reference.GitlabContainerRepositoryReference)
+    container_repository = BelongsToModel("container_repository_id")

clearskies_gitlab/graphql/models/gitlab_container_repository_tag_reference.py

@@ -0,0 +1,8 @@
+class GitlabContainerRepositoryTagReference:
+    """Reference to GitlabContainerRepositoryTag model."""
+
+    def get_model_class(self) -> type:
+        """Return the model class this reference points to."""
+        from clearskies_gitlab.graphql.models import gitlab_container_repository_tag
+
+        return gitlab_container_repository_tag.GitlabContainerRepositoryTag

clearskies_gitlab/graphql/models/gitlab_group.py

@@ -0,0 +1,24 @@
+from __future__ import annotations
+
+from clearskies import Model
+
+from clearskies_gitlab.graphql.backends import GitlabGraphqlBackend
+
+
+class GitlabGroup(Model):
+    """Model for gitlab projects via GQL."""
+
+    gitlab_id_pattern: str = "gid://gitlab/Group/[ID]"
+
+    id_column_name: str = "id"
+    backend = GitlabGraphqlBackend(
+        root_field="groups",
+        id_argument_is_array=True,
+        id_format_pattern="gid://gitlab/Project/{id}",
+        id_argument_name="ids",
+    )
+
+    @classmethod
+    def destination_name(cls) -> str:
+        """Return the slug of the api endpoint for this model."""
+        return "group"

clearskies_gitlab/graphql/models/gitlab_group_reference.py

@@ -0,0 +1,8 @@
+class GitlabGroupReference:
+    """Reference to GitlabGroup model."""
+
+    def get_model_class(self) -> type:
+        """Return the model class this reference points to."""
+        from clearskies_gitlab.graphql.models import gitlab_group
+
+        return gitlab_group.GitlabGroup

clearskies_gitlab/graphql/models/gitlab_project.py

@@ -0,0 +1,25 @@
+from __future__ import annotations
+
+from clearskies import Model
+from clearskies.columns import String
+
+from clearskies_gitlab.graphql.backends import GitlabGraphqlBackend
+
+
+class GitlabProject(Model):
+    """Model for gitlab projects via GQL."""
+
+    id_column_name: str = "id"
+    backend = GitlabGraphqlBackend(
+        root_field="projects",
+        id_argument_is_array=True,
+        id_format_pattern="gid://gitlab/Project/{id}",
+        id_argument_name="ids",
+    )
+
+    @classmethod
+    def destination_name(cls) -> str:
+        """Return the slug of the api endpoint for this model."""
+        return "projects"
+
+    id = String()

clearskies_gitlab/graphql/models/gitlab_project_reference.py

@@ -0,0 +1,8 @@
+class GitlabProjectReference:
+    """Reference to GitlabProject model."""
+
+    def get_model_class(self) -> type:
+        """Return the model class this reference points to."""
+        from clearskies_gitlab.graphql.models import gitlab_project
+
+        return gitlab_project.GitlabProject

clearskies_gitlab/rest/__init__.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+from clearskies_gitlab.rest import backends, models
+from clearskies_gitlab.rest.gitlab_cicd_variable import GitlabCICDVariable
+from clearskies_gitlab.rest.gitlab_member import GitlabMember
+
+__all__ = [
+    "backends",
+    "models",
+    "GitlabMember",
+    "GitlabCICDVariable",
+]

clearskies_gitlab/rest/backends/__init__.py

@@ -0,0 +1,3 @@
+from clearskies_gitlab.rest.backends.gitlab_rest_backend import GitlabRestBackend
+
+__all__ = ["GitlabRestBackend"]

clearskies_gitlab/{backends → rest/backends}/gitlab_rest_backend.py

@@ -1,23 +1,16 @@
 from __future__ import annotations
 
-import logging
 import urllib
-from collections.abc import Callable
-from typing import TYPE_CHECKING, Any, cast
+from typing import TYPE_CHECKING, Any
 
-import requests
-from clearskies import Column, Model, configs
+from clearskies import configs
 from clearskies.backends import ApiBackend
 from clearskies.decorators import parameters_to_properties
 from clearskies.di import inject
-from clearskies.functional import string
 from clearskies.query import Query
 from requests.structures import CaseInsensitiveDict
 
-from clearskies_gitlab.exceptions import gitlab_error
-
 if TYPE_CHECKING:
-    from clearskies import model
     from clearskies.authentication import Authentication
     from clearskies.query import Query
 
@@ -25,8 +18,8 @@ if TYPE_CHECKING:
 class GitlabRestBackend(ApiBackend):
     """Backend for Gitlab.com."""
 
-    base_url = inject.ByName("gitlab_url", cache=True)
-    authentication = inject.ByName("gitlab_auth", cache=False)
+    gitlab_host = inject.ByName("gitlab_host", cache=True)  # type: ignore[assignment]
+    authentication = inject.ByName("gitlab_auth", cache=False)  # type: ignore[assignment]
     requests = inject.Requests()
     _auth_headers: dict[str, str] = {}
 
@@ -47,6 +40,17 @@ class GitlabRestBackend(ApiBackend):
     ):
         self.finalize_and_validate_configuration()
 
+    @property
+    def base_url(self) -> str:
+        """
+        Docstring for base_url.
+
+        :param self: Description
+        :return: Description
+        :rtype: str
+        """
+        return f"{self.gitlab_host.rstrip('/')}/api/v4"
+
     def count_method(self, query: Query) -> str:
         """Return the request method to use when making a request for a record count."""
         return "HEAD"
@@ -90,6 +94,7 @@ class GitlabRestBackend(ApiBackend):
     def conditions_to_request_parameters(
         self, query: Query, used_routing_parameters: list[str]
     ) -> tuple[str, dict[str, str], dict[str, Any]]:
+        """Convert query conditions to request parameters."""
         route_id = ""
 
         url_parameters = {}
@@ -111,7 +116,7 @@ class GitlabRestBackend(ApiBackend):
     #     self,
     #     next_page_data: dict[str, Any],
     #     query: Query,
-    #     response: requests.Response,  # type: ignore
+    #     response: requests.Response,
     # ) -> None:
     #     """
     #     Update the next_page_data dictionary with the appropriate data needed to fetch the next page of records.

clearskies_gitlab/rest/gitlab_branch_rule.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+from clearskies import Model
+from clearskies.columns import Boolean, Datetime, Integer, Json, String
+
+
+class GitlabBranchRule(Model):
+    """Model for GitLab branch rules."""
+
+    id = Integer()
+    name = String()
+    protected = Boolean()
+    developers_can_push = Boolean()
+    developers_can_merge = Boolean()
+    can_push = Boolean()
+    default = Boolean()
+    created_at = Datetime()
+    updated_at = Datetime()
+    code_owner_approval_required = Boolean()
+    unprotect_access_levels = Json()
+    push_access_levels = Json()

clearskies_gitlab/{models → rest}/gitlab_cicd_variable.py

@@ -1,8 +1,5 @@
 from __future__ import annotations
 
-from collections import OrderedDict
-from typing import Any
-
 from clearskies import Model
 from clearskies.columns import Boolean, String
 

clearskies_gitlab/{models → rest}/gitlab_member.py

@@ -1,8 +1,5 @@
 from __future__ import annotations
 
-from collections import OrderedDict
-from typing import Any
-
 from clearskies import Model
 from clearskies.columns import Datetime, Email, Integer, Json, String
 

clearskies_gitlab/rest/models/__init__.py

@@ -0,0 +1,49 @@
+from __future__ import annotations
+
+from clearskies_gitlab.rest.models.gitlab_rest_advanced_search import GitlabRestAdvancedSearch
+from clearskies_gitlab.rest.models.gitlab_rest_advanced_search_blob import GitlabRestAdvancedSearchBlob
+from clearskies_gitlab.rest.models.gitlab_rest_current_user import GitlabRestCurrentUser
+from clearskies_gitlab.rest.models.gitlab_rest_group import GitlabRestGroup
+from clearskies_gitlab.rest.models.gitlab_rest_group_access_token import GitlabRestGroupAccessToken
+from clearskies_gitlab.rest.models.gitlab_rest_group_project import GitlabRestGroupProject
+from clearskies_gitlab.rest.models.gitlab_rest_group_search import GitlabRestGroupSearch
+from clearskies_gitlab.rest.models.gitlab_rest_group_search_blob import GitlabRestGroupSearchBlob
+from clearskies_gitlab.rest.models.gitlab_rest_group_subgroup import GitlabRestGroupSubgroup
+from clearskies_gitlab.rest.models.gitlab_rest_group_variable import GitlabRestGroupVariable
+from clearskies_gitlab.rest.models.gitlab_rest_project import GitlabRestProject
+from clearskies_gitlab.rest.models.gitlab_rest_project_approval_config import GitlabRestProjectApprovalConfig
+from clearskies_gitlab.rest.models.gitlab_rest_project_approval_rule import GitlabRestProjectApprovalRule
+from clearskies_gitlab.rest.models.gitlab_rest_project_member import GitlabRestProjectMember
+from clearskies_gitlab.rest.models.gitlab_rest_project_protected_branch import GitlabRestProjectProtectedBranch
+from clearskies_gitlab.rest.models.gitlab_rest_project_repository_commit import GitlabRestProjectRepositoryCommit
+from clearskies_gitlab.rest.models.gitlab_rest_project_repository_commit_diff import (
+    GitlabRestProjectRepositoryCommitDiff,
+)
+from clearskies_gitlab.rest.models.gitlab_rest_project_repository_contributor import (
+    GitlabRestProjectRepositoryContributor,
+)
+from clearskies_gitlab.rest.models.gitlab_rest_project_repository_file import GitlabRestProjectRepositoryFile
+from clearskies_gitlab.rest.models.gitlab_rest_project_variable import GitlabRestProjectVariable
+
+__all__ = [
+    "GitlabRestAdvancedSearch",
+    "GitlabRestAdvancedSearchBlob",
+    "GitlabRestCurrentUser",
+    "GitlabRestGroup",
+    "GitlabRestGroupAccessToken",
+    "GitlabRestGroupProject",
+    "GitlabRestGroupSearch",
+    "GitlabRestGroupSearchBlob",
+    "GitlabRestGroupSubgroup",
+    "GitlabRestGroupVariable",
+    "GitlabRestProject",
+    "GitlabRestProjectApprovalConfig",
+    "GitlabRestProjectApprovalRule",
+    "GitlabRestProjectMember",
+    "GitlabRestProjectProtectedBranch",
+    "GitlabRestProjectRepositoryCommit",
+    "GitlabRestProjectRepositoryCommitDiff",
+    "GitlabRestProjectRepositoryContributor",
+    "GitlabRestProjectRepositoryFile",
+    "GitlabRestProjectVariable",
+]

clearskies_gitlab/{models/rest → rest/models}/gitlab_rest_advanced_search.py

@@ -1,17 +1,17 @@
 from __future__ import annotations
 
-from collections import OrderedDict
-from typing import Any, Self
+from typing import Self
 
+from clearskies import Model
 from clearskies.columns import Boolean, Json, Select, String
 
-from clearskies_gitlab.models import gitlab_rest_model
+from clearskies_gitlab.rest.backends import GitlabRestBackend
 
 
-class GitlabRestAdvancedSearch(
-    gitlab_rest_model.GitlabRestModel,
-):
-    """Model for groups access tokens."""
+class GitlabRestAdvancedSearch(Model):
+    """Model for advanced search."""
+
+    backend = GitlabRestBackend()
 
     @classmethod
     def destination_name(cls: type[Self]) -> str:

clearskies_gitlab/{models/rest → rest/models}/gitlab_rest_advanced_search_blob.py

@@ -1,11 +1,8 @@
 from __future__ import annotations
 
-from collections import OrderedDict
-from typing import Any
-
 from clearskies.columns import BelongsToId, BelongsToModel, Integer, String
 
-from clearskies_gitlab.models.rest import gitlab_rest_advanced_search, gitlab_rest_project
+from clearskies_gitlab.rest.models import gitlab_rest_advanced_search, gitlab_rest_project
 
 
 class GitlabRestAdvancedSearchBlob(