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

clear_skies_gitlab-2.0.1.dist-info/METADATA

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: clear-skies-gitlab
+Version: 2.0.1
+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
+Project-URL: Issues, https://github.com/clearskies-py/gitlab/issues
+Project-URL: Changelog, https://github.com/clearskies-py/gitlab/blob/main/CHANGELOG.md
+Author-email: Tom Nijboer <tom.nijboer@cimpress.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+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: requests>=2.32.5
+Provides-Extra: dev
+Requires-Dist: types-requests>=2.32.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+
+# gitlab
+
+
+Gitlab module for Clearskies
+
+This template scaffolds a dynamic Clearskies module for any kind of logic, integration, or API. You can use it to build modules for data processing, service integration, automation, or any custom business logic.
+
+Your module can implement any logic you need: fetch data, process input, interact with external services, or perform custom actions. The endpoints and payloads are up to you.
+
+## Installation
+
+```bash
+# Install uv if not already installed
+pip install uv
+
+# Create a virtual environment and install dependencies
+uv sync
+```
+
+## Development
+
+To set up your development environment with pre-commit hooks:
+
+```bash
+# Install uv if not already installed
+pip install uv
+
+# Create a virtual environment and install all dependencies (including dev)
+uv sync
+
+# Install dev dependencies (including ruff, black, mypy) in the project environment
+uv pip install .[dev]
+
+# Install pre-commit hooks
+uv run pre-commit install
+
+# Optionally, run pre-commit on all files
+uv run pre-commit run --all-files
+```
+
+## Usage Example
+
+```python
+import clearskies
+import clearskies_gitlab
+
+wsgi = clearskies.contexts.WsgiRef(
+    clearskies_gitlab.build__module()
+)
+wsgi()
+```

clear_skies_gitlab-2.0.1.dist-info/RECORD

@@ -0,0 +1,42 @@
+clearskies_gitlab/__init__.py,sha256=ClIA0vw3F7SEkiHWukom62Vc023czAhujTj61w8nZL0,129
+clearskies_gitlab/backends/__init__.py,sha256=edqByrjBImEUO1KvHjBHpA9X15uRXxstCYo9UXpJkPM,254
+clearskies_gitlab/backends/gitlab_rest_backend.py,sha256=v8HiKbQyn5i0OvOr6w8Zag4BQznIrDQNg2FaLgL1Iaw,6543
+clearskies_gitlab/defaults/__init__.py,sha256=GF1ggkRAFoRP7F0mzUj0lfMV1WneKa8z3f5eDWLhCKY,216
+clearskies_gitlab/defaults/gitlab_default_auth.py,sha256=iwlvQrYkODVwoyj4hkRdq-OHaLXX0kxasPvBuyTIHnY,323
+clearskies_gitlab/defaults/gitlab_default_url.py,sha256=lfjr5_rNydY-yGGzKp1D-ANdbc51_yIz2AEUF07tO9U,288
+clearskies_gitlab/exceptions/__init__.py,sha256=QUg8lVn91QMENpN_uZmYdNkhI1EjFAWN9X6cMKgKmtE,301
+clearskies_gitlab/exceptions/gitlab_error.py,sha256=DUplWahAT2hC6GZiuapVZc_PEb-D3068CJmaGFg_yek,2000
+clearskies_gitlab/models/__init__.py,sha256=jJ0Knev4oE8ew_RI01rDD-0G1WOZdF7wfyuaGFb9wUk,645
+clearskies_gitlab/models/gitlab_cicd_variable.py,sha256=Bzk6M6ycIqeUxY6uhT_3zRBxm7pkOqdPjEk4JYO2oxM,506
+clearskies_gitlab/models/gitlab_gql_model.py,sha256=NkmQEqECofkNTDWjSywniUCYDG2inejzVgLxyBfqecg,189
+clearskies_gitlab/models/gitlab_group.py,sha256=mmruk1OLSLb5cwN8xtOY30tCXbgtngz399N4WFzzNa4,2283
+clearskies_gitlab/models/gitlab_member.py,sha256=-x0xU_Kf14Bkc9-h27KYxSbdmS6X2LthLI2Gdch0C80,547
+clearskies_gitlab/models/gitlab_namespace.py,sha256=fW9ADAqXrWPJoVBrQo0JbJvccJZKaGmXtJjShwgXxII,917
+clearskies_gitlab/models/gitlab_project.py,sha256=Fx9xiUrhO4YWdCRSFQLuFphPVZEGNfUoj1Cwo2VdJ-0,4223
+clearskies_gitlab/models/gitlab_rest_model.py,sha256=XnlKBuORJPi4AKPNSuCasx3blmmpWZZv-nJfzYbQ54E,225
+clearskies_gitlab/models/rest/__init__.py,sha256=auEn31pkPk8zcbw6ZamNrMbltydjufUIxh-WhcpWx6w,1854
+clearskies_gitlab/models/rest/gitlab_rest_advanced_search.py,sha256=9ftD-rcMhEejzQdEQBxNpQOxtL0yywB0mg5peSpCyMk,893
+clearskies_gitlab/models/rest/gitlab_rest_advanced_search_blob.py,sha256=ZDko71JUsL1-dIsoWulQVlY30L6GMHS8taFUL_k9fn0,688
+clearskies_gitlab/models/rest/gitlab_rest_current_user.py,sha256=fCyrkk3KO66nTH2I7ioggqdUHRSDOKofZRB9qlD19_4,1107
+clearskies_gitlab/models/rest/gitlab_rest_group.py,sha256=wFXleyn34d1gz9pVBYubuBNLx5B2vkcFv9pEtc83DXM,2102
+clearskies_gitlab/models/rest/gitlab_rest_group_access_token.py,sha256=Wx2NOzsgaRizKZNNk_BqAmUq3wOU8E0YQCdzxE8IzR0,904
+clearskies_gitlab/models/rest/gitlab_rest_group_member.py,sha256=0L03cVruwUvJa-laJVA1bVULJM_gS2DZJGjkgF08Sbc,774
+clearskies_gitlab/models/rest/gitlab_rest_group_member_reference.py,sha256=y1gbRc-XJljMizOOa2diA-cxAllACykN7h08RNzfn6k,200
+clearskies_gitlab/models/rest/gitlab_rest_group_project.py,sha256=bQXIFz1GiLjIB2Pm6W_4JuqEd0sefumpmEFMo8_L0Z8,865
+clearskies_gitlab/models/rest/gitlab_rest_group_reference.py,sha256=mJTBjjiPfjYgngzcotUjcWPPRBA0wdUCcOZKdIrxVcQ,174
+clearskies_gitlab/models/rest/gitlab_rest_group_search.py,sha256=Q_bR6es8l8vZGi5u_31d9V2QY6byzYZAu_ACNEWJx7k,547
+clearskies_gitlab/models/rest/gitlab_rest_group_search_blob.py,sha256=EhCs3KkaZsdmf85Ctt8Wgq681YvmgeYK47VBh1bdRIE,353
+clearskies_gitlab/models/rest/gitlab_rest_group_subgroup.py,sha256=l9bGhkULbL0wtQxp4XfoQS7vwfcJdY96NxsKq4FHvKE,1781
+clearskies_gitlab/models/rest/gitlab_rest_group_subgroup_reference.py,sha256=CXdGQQ4Aswk5e4ixMTn8wWGotI5ETl-xESRPuueJSIA,208
+clearskies_gitlab/models/rest/gitlab_rest_group_variable.py,sha256=s24Q6agioITIfX9G2xnNAzySR0BflGiYnLgrXfCGeFQ,629
+clearskies_gitlab/models/rest/gitlab_rest_namespace.py,sha256=PmY2yHY63G2DJBOo5Xe6BdzfcGumM4cVlX1aONLesEY,1919
+clearskies_gitlab/models/rest/gitlab_rest_project.py,sha256=diO2-8QiN9VvXCNa7egKTnIp6SFl6P2lHrG5wkjaUbk,2492
+clearskies_gitlab/models/rest/gitlab_rest_project_reference.py,sha256=oK42SyFQQTIFeidstoIz-_PFq9qwlzyvhq9cmJcqg2E,182
+clearskies_gitlab/models/rest/gitlab_rest_project_repository_commit.py,sha256=R3Km247_TDyYqtQEGM1w5r1BYpUtA1j0cS2XA06Q9tw,1171
+clearskies_gitlab/models/rest/gitlab_rest_project_repository_commit_diff.py,sha256=EAZd1H6AnuwvzW4ZH5KX4prNn_RoV_0PzBlPOHkXOiQ,892
+clearskies_gitlab/models/rest/gitlab_rest_project_variable.py,sha256=FylNaIBiFx7oVOIz9Nltdp0GT2OsjSghDD4nLQAQ1pA,790
+clearskies_gitlab/models/rest/gitlab_rest_project_variable_refence.py,sha256=jdiE-9v5yovfk5HM7vkmQlkkAthmI6YNh6sDQrrjoSU,216
+clear_skies_gitlab-2.0.1.dist-info/METADATA,sha256=aMsKuagx7ecWaqdlzEeTmFT3z4PRzJ99OONnPPxBUAw,2138
+clear_skies_gitlab-2.0.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+clear_skies_gitlab-2.0.1.dist-info/licenses/LICENSE,sha256=MkEX8JF8kZxdyBpTTcB0YTd-xZpWnHvbRlw-pQh8u58,1069
+clear_skies_gitlab-2.0.1.dist-info/RECORD,,

clear_skies_gitlab-2.0.1.dist-info/WHEEL

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

clear_skies_gitlab-2.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025, 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
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

clearskies_gitlab/__init__.py

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

clearskies_gitlab/backends/__init__.py

@@ -0,0 +1,9 @@
+from __future__ import annotations
+
+# from clearskies_gitlab.backends.gitlab_gql_backend import GitlabGqlBackend
+from clearskies_gitlab.backends.gitlab_rest_backend import GitlabRestBackend
+
+__all__ = [
+    "GitlabGqlBackend",
+    "GitlabRestBackend",
+]

clearskies_gitlab/backends/gitlab_rest_backend.py

@@ -0,0 +1,150 @@
+from __future__ import annotations
+
+import logging
+import urllib
+from collections.abc import Callable
+from typing import TYPE_CHECKING, Any, cast
+
+import requests
+from clearskies import Column, Model, 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
+
+
+class GitlabRestBackend(ApiBackend):
+    """Backend for Gitlab.com."""
+
+    base_url = inject.ByName("gitlab_url", cache=True)
+    authentication = inject.ByName("gitlab_auth", cache=False)
+    requests = inject.Requests()
+    _auth_headers: dict[str, str] = {}
+
+    api_to_model_map = configs.AnyDict(default={})
+    pagination_parameter_name = configs.String(default="page")
+
+    @parameters_to_properties
+    def __init__(
+        self,
+        base_url: str | None = None,
+        authentication: Authentication | None = None,
+        model_casing: str = "snake_case",
+        api_casing: str = "snake_case",
+        api_to_model_map: dict[str, str | list[str]] = {},
+        pagination_parameter_name: str = "page",
+        pagination_parameter_type: str = "str",
+        limit_parameter_name: str = "per_page",
+    ):
+        self.finalize_and_validate_configuration()
+
+    def count_method(self, query: Query) -> str:
+        """Return the request method to use when making a request for a record count."""
+        return "HEAD"
+
+    def count(self, query: Query) -> int:
+        """Return the count of records matching the query."""
+        self.check_query(query)
+        (url, method, body, headers) = self.build_records_request(query)
+        response = self.execute_request(url, self.count_method(query), json=body, headers=headers)
+        return self._map_count_response(response.headers)
+
+    def _map_count_response(self, headers: CaseInsensitiveDict[str]) -> int:
+        return int(headers.get("x-total", 0))
+
+    # def map_records_response(
+    #     self, response_data: Any, query: Query, query_data: dict[str, Any] | None = None
+    # ) -> list[dict[str, Any]]:
+    #     """Map the response data to model records with support for nested fields."""
+    #     if query_data is None:
+    #         query_data = {}
+
+    #     columns = query.model_class.get_columns()
+    #     result = []
+
+    #     # Handle list response
+    #     if isinstance(response_data, list):
+    #         for item in response_data:
+    #             if not isinstance(item, dict):
+    #                 continue
+    #             mapped = self.check_dict_and_map_to_model(item, columns, query_data)
+    #             if mapped:
+    #                 result.append(mapped)
+    #     # Handle single object response
+    #     elif isinstance(response_data, dict):
+    #         mapped = self.check_dict_and_map_to_model(response_data, columns, query_data)
+    #         if mapped:
+    #             result.append(mapped)
+
+    #     return result
+
+    def conditions_to_request_parameters(
+        self, query: Query, used_routing_parameters: list[str]
+    ) -> tuple[str, dict[str, str], dict[str, Any]]:
+        route_id = ""
+
+        url_parameters = {}
+        for condition in query.conditions:
+            if condition.column_name in used_routing_parameters:
+                continue
+            if condition.operator != "=":
+                raise ValueError(
+                    f"I'm not very smart and only know how to search with the equals operator, but I received a condition of {condition.parsed}.  If you need to support this, you'll have to extend the ApiBackend and overwrite the build_records_request method."
+                )
+            if condition.column_name == query.model_class.id_column_name:
+                route_id = urllib.parse.quote_plus(condition.values[0]).replace("+", "%20")
+                continue
+            url_parameters[condition.column_name] = condition.values[0]
+
+        return (route_id, url_parameters, {})
+
+    # def set_next_page_data_from_response(
+    #     self,
+    #     next_page_data: dict[str, Any],
+    #     query: Query,
+    #     response: requests.Response,  # type: ignore
+    # ) -> None:
+    #     """
+    #     Update the next_page_data dictionary with the appropriate data needed to fetch the next page of records.
+
+    #     This method has a very important job, which is to inform clearskies about how to make another API call to fetch the next
+    #     page of records.  The way this happens is by updating the `next_page_data` dictionary in place with whatever pagination
+    #     information is necessary.  Note that this relies on next_page_data being passed by reference, hence the need to update
+    #     it in place.  That means that you can do this:
+
+    #     ```python
+    #     next_page_data["some_key"] = "some_value"
+    #     ```
+
+    #     but if you do this:
+
+    #     ```python
+    #     next_page_data = {"some_key": "some_value"}
+    #     ```
+
+    #     Then things simply won't work.
+    #     """
+    #     # Different APIs generally have completely different ways of communicating pagination data, but one somewhat common
+    #     # approach is to use a link header, so let's support that in the base class.
+    #     if "link" not in response.headers:
+    #         return
+    #     next_link = [rel for rel in response.headers["link"].split(",") if 'rel="next"' in rel]
+    #     if not next_link:
+    #         return
+    #     parsed_next_link = urllib.parse.urlparse(next_link[0].split(";")[0].strip(" <>"))
+    #     query_parameters = urllib.parse.parse_qs(parsed_next_link.query)
+    #     if self.pagination_parameter_name not in query_parameters:
+    #         raise ValueError(
+    #             f"Configuration error with {self.__class__.__name__}!  I am configured to expect a pagination key of '{self.pagination_parameter_name}.  However, when I was parsing the next link from a response to get the next pagination details, I could not find the designated pagination key.  This likely means that backend.pagination_parameter_name is set to the wrong value.  The link in question was "
+    #             + parsed_next_link.geturl()
+    #         )
+    #     next_page_data[self.pagination_parameter_name] = query_parameters[self.pagination_parameter_name][0]

clearskies_gitlab/defaults/__init__.py

@@ -0,0 +1,7 @@
+from clearskies_gitlab.defaults.gitlab_default_auth import GitlabDefaultAuth
+from clearskies_gitlab.defaults.gitlab_default_url import GitlabDefaultUrl
+
+__all__ = [
+    "GitlabDefaultAuth",
+    "GitlabDefaultUrl",
+]

clearskies_gitlab/defaults/gitlab_default_auth.py

@@ -0,0 +1,7 @@
+import clearskies
+
+
+class GitlabDefaultAuth(clearskies.di.AdditionalConfigAutoImport):
+    def provide_gitlab_auth(self, environment: clearskies.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_url.py

@@ -0,0 +1,7 @@
+import clearskies
+
+
+class GitlabDefaultUrl(clearskies.di.AdditionalConfigAutoImport):
+    def provide_gitlab_url(self, environment: clearskies.Environment):
+        gitlab_url = environment.get("GITLAB_URL", True)
+        return gitlab_url if gitlab_url else "https://gitlab.com/api/v4/"

clearskies_gitlab/exceptions/__init__.py

@@ -0,0 +1,13 @@
+from clearskies_gitlab.exceptions.gitlab_error import (
+    GitlabParamMissingError,
+    GitlabResourceError,
+    GitlabResponseError,
+    MethodNotImplementedError,
+)
+
+__all__ = [
+    "GitlabParamMissingError",
+    "GitlabResourceError",
+    "GitlabResponseError",
+    "MethodNotImplementedError",
+]

clearskies_gitlab/exceptions/gitlab_error.py

@@ -0,0 +1,50 @@
+from clearskies.exceptions import ClientError
+
+
+class CredentialError(ClientError):
+    """Throw exception if something goes wrong for fetching the credentials from Akeyless."""
+
+    def __init__(self, key_name: str) -> None:
+        """Create specific message for Credential Issue."""
+        super().__init__(f"Could not retrieve {key_name}")
+
+
+class InvalidCredentialError(ClientError):
+    """Throw exception if the token isn't valid anymore."""
+
+    def __init__(self) -> None:
+        """Create specific message for InvalidCredentialError Issue."""
+        super().__init__("Gitlab token for was not valid - please contact Cimpress security and privacy")
+
+
+class MethodNotImplementedError(NotImplementedError):
+    """Error if Method is not implemented in the Gitlab api for endpoint."""
+
+    def __init__(self, method: str, endpoint: str, version: str = "v1") -> None:
+        """Create error with method and endpoint on version."""
+        super().__init__(f"Method: {method} is not implemented for {endpoint} in {version}.")
+
+
+class GitlabResourceError(ValueError):
+    """Error if resource could be found."""
+
+    def __init__(self, endpoint: str, resource_name: str) -> None:
+        """Create error if resource name is not specified for endpoint."""
+        super().__init__(
+            f"The Gitlab API for endpoint {endpoint} requires searching by a column named {resource_name}, but it was missing in the query"
+        )
+
+
+class GitlabResponseError(ValueError):
+    """Error if response of Gitlab is wrong."""
+
+    def __init__(self, status_code: int, message: bytes) -> None:
+        """Create error with request info."""
+        super().__init__(f"Failed request.  Status code: {status_code}, message: {message.decode()}")
+
+
+class GitlabParamMissingError(ValueError):
+    """Error if param is missing."""
+
+    def __init__(self, param_name: str, table_name: str) -> None:
+        super().__init__(f"Must provide the {param_name} to add the member to when updating a {table_name}")

clearskies_gitlab/models/__init__.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+from clearskies_gitlab.models import rest
+from clearskies_gitlab.models.gitlab_cicd_variable import GitlabCICDVariable
+from clearskies_gitlab.models.gitlab_gql_model import GitlabGqlModel
+from clearskies_gitlab.models.gitlab_group import GitlabGroup
+from clearskies_gitlab.models.gitlab_member import GitlabMember
+from clearskies_gitlab.models.gitlab_project import GitlabProject
+from clearskies_gitlab.models.gitlab_rest_model import GitlabRestModel
+
+__all__ = [
+    "rest",
+    "GitlabGqlModel",
+    "GitlabGroup",
+    "GitlabMember",
+    "GitlabCICDVariable",
+    "GitlabProject",
+    "GitlabRestModel",
+]

clearskies_gitlab/models/gitlab_cicd_variable.py

@@ -0,0 +1,23 @@
+from __future__ import annotations
+
+from collections import OrderedDict
+from typing import Any
+
+from clearskies import Model
+from clearskies.columns import Boolean, String
+
+
+class GitlabCICDVariable(Model):
+    """Base model for groups ci/cd variables."""
+
+    id_column_name = "key"
+
+    key = String()
+    value = String()
+    description = String()
+    environment_scope = String()
+    variable_type = String()
+    masked = Boolean()
+    protected = Boolean()
+    hidden = Boolean()
+    raw = Boolean()

clearskies_gitlab/models/gitlab_gql_model.py

@@ -0,0 +1,9 @@
+from __future__ import annotations
+
+from clearskies import Model
+
+# from clearskies_gitlab.backends import GitlabGql
+
+
+class GitlabGqlModel(Model):
+    """Base model for gitlab via GQL."""

clearskies_gitlab/models/gitlab_group.py

@@ -0,0 +1,69 @@
+from __future__ import annotations
+
+from collections import OrderedDict
+from typing import Any
+
+from clearskies import Model
+from clearskies.columns import Boolean, Datetime, Integer, Json, String
+
+
+class GitlabGroup(Model):
+    """Base model for groups."""
+
+    id_column_name = "id"
+
+    id = String()
+    web_url = String()
+    name = String()
+    path = String()
+    description = String()
+    visibility = String()
+    share_with_group_lock = Boolean()
+    require_two_factor_authentication = Boolean()
+    two_factor_grace_period = Integer()
+    project_creation_level = String()
+    auto_devops_enabled = Boolean()
+    subgroup_creation_level = String()
+    emails_disabled = Boolean()
+    emails_enabled = Boolean()
+    mentions_disabled = String()
+    lfs_enabled = String()
+    math_rendering_limits_enabled = Boolean()
+    lock_math_rendering_limits_enabled = Boolean()
+    default_branch = String()
+    default_branch_protection = String()
+    default_branch_protection_defaults = String()
+    avatar_url = String()
+    request_access_enabled = Boolean()
+    full_name = String()
+    full_path = String()
+    created_at = Datetime()
+    parent_id = String()
+    organization_id = String()
+    shared_runners_setting = String()
+    custom_attributes = Json()
+    statistics = Json()
+    ldap_cn = String()
+    ldap_access = String()
+    ldap_group_links = Json()
+    saml_group_links = Json()
+    file_template_project_id = String()
+    marked_for_deletion_on = Datetime()
+    wiki_access_level = String()
+    repository_storage = String()
+    duo_features_enabled = Boolean()
+    lock_duo_features_enabled = Boolean()
+    shared_with_groups = Json()
+    runners_token = String()
+    enabled_git_access_protocol = String()
+    prevent_sharing_groups_outside_hierarchy = Boolean()
+    shared_runners_minutes_limit = Integer()
+    extra_shared_runners_minutes_limit = Integer()
+    prevent_forking_outside_group = Boolean()
+    service_access_tokens_expiration_enforced = Boolean()
+    membership_lock = Boolean()
+    ip_restriction_ranges = Json()
+    unique_project_download_limit = String()
+    unique_project_download_limit_interval_in_seconds = Integer()
+    unique_project_download_limit_alertlist = Json()
+    auto_ban_user_on_excessive_projects_download = Boolean()

clearskies_gitlab/models/gitlab_member.py

@@ -0,0 +1,24 @@
+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
+
+
+class GitlabMember(Model):
+    """Base model for group or project members."""
+
+    id_column_name = "id"
+
+    id = Integer()
+    username = String()
+    name = String()
+    state = String()
+    avatar_url = String()
+    access_level = Integer()
+    created_at = Datetime()
+    created_by = Json()
+    email = Email()
+    group_saml_identity = Json()

clearskies_gitlab/models/gitlab_namespace.py

@@ -0,0 +1,32 @@
+from __future__ import annotations
+
+from collections import OrderedDict
+from typing import Any
+
+from clearskies import Model
+from clearskies.columns import Boolean, Datetime, Integer, Json, Select, String
+
+
+class GitlabNamespace(Model):
+    """Base model for namespaces."""
+
+    id_column_name = "id"
+
+    id = String()
+    name = String()
+    path = String()
+    kind = Select(allowed_values=["group", "user"])
+    full_path = String()
+    avatar_url = String()
+    web_url = String()
+    billable_members_count = Integer()
+    plan = Select(allowed_values=["free", "premium", "ultimate", "bronze", "silver", "gold"])
+    end_date = Datetime()
+    trial_ends_on = Datetime()
+    trial = Boolean()
+    root_repository_size = Integer()
+    projects_count = Integer()
+    max_seats_used = Integer()
+    max_seats_used_changed_at = Datetime()
+    seats_in_use = Integer()
+    members_counts_with_descendants = Integer()