qontract-reconcile 0.10.2.dev485__py3-none-any.whl → 0.10.2.dev493__py3-none-any.whl

{qontract_reconcile-0.10.2.dev485.dist-info → qontract_reconcile-0.10.2.dev493.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qontract-reconcile
-Version: 0.10.2.dev485
+Version: 0.10.2.dev493
 Summary: Collection of tools to reconcile services with their desired state as defined in the app-interface DB.
 Project-URL: homepage, https://github.com/app-sre/qontract-reconcile
 Project-URL: repository, https://github.com/app-sre/qontract-reconcile
@@ -43,9 +43,11 @@ Requires-Dist: pyjwt~=2.7
 Requires-Dist: pyopenssl~=23.0
 Requires-Dist: pypd<1.2.0,>=1.1.0
 Requires-Dist: python-gitlab==6.0.0
+Requires-Dist: qontract-api-client
+Requires-Dist: qontract-utils
 Requires-Dist: requests-oauthlib~=1.3
 Requires-Dist: requests~=2.32
-Requires-Dist: rich<14.0.0,>=13.3.0
+Requires-Dist: rich==14.3.1
 Requires-Dist: ruamel-yaml<0.18.0,>=0.17.22
 Requires-Dist: semver~=3.0
 Requires-Dist: sendgrid<6.5.0,>=6.4.8

{qontract_reconcile-0.10.2.dev485.dist-info → qontract_reconcile-0.10.2.dev493.dist-info}/RECORD

@@ -8,7 +8,7 @@ reconcile/aws_iam_password_reset.py,sha256=5oajSspJVAvpGd445hKsxtEGYb75dM4l1_PJT
 reconcile/aws_support_cases_sos.py,sha256=G9g0oM6ohvuJ5N592ePjiPeaDug4_vapAy58RyG-S3Y,3478
 reconcile/blackbox_exporter_endpoint_monitoring.py,sha256=O1wFp52EyF538c6txaWBs8eMtUIy19gyHZ6VzJ6QXS8,3512
 reconcile/checkpoint.py,sha256=Q5Ru36ZEwWw95ZkUXBf4VfvCmqDS9TcAF7QVroOf9Vk,5375
-reconcile/cli.py,sha256=ZHOM3LPTUyKJy-N7p9OSyrJsb8pWGCsUFthBvJgjUkE,115887
+reconcile/cli.py,sha256=bGWl826ucs0KOwH7DciYJkdZvEV90bqoSlMs36gxgg4,116607
 reconcile/closedbox_endpoint_monitoring_base.py,sha256=_OKz7K7HHw0-gzxeEma8PcUCtd70pRBy7JMoaAm8IVU,4940
 reconcile/cluster_deployment_mapper.py,sha256=aKroYLY6-nNxWi2jxDu7VRMuNZ3YgSI0J6ek7Fet2AQ,2241
 reconcile/dashdotdb_base.py,sha256=83ZWIf5JJk3P_D69y2TmXRcQr6ELJGlv10OM0h7fJVs,4767
@@ -98,6 +98,7 @@ reconcile/service_dependencies.py,sha256=KydjllianL0lUwhroBAPui7jrnhHSq7j2PB6CoV
 reconcile/signalfx_endpoint_monitoring.py,sha256=Nqgsg1cflSd2nNnm89y_e8c--7xLUqTrKOHkDs-qADE,2868
 reconcile/slack_base.py,sha256=I-msunWxfgu5bSwXYulGbtLjxUB_tRmTCAUCU-3nabI,3484
 reconcile/slack_usergroups.py,sha256=C36L64wb95tf2tIqJ8T1xXmREpxHvxbhnglk0QOfUVc,30939
+reconcile/slack_usergroups_api.py,sha256=NnO8Di6tt5yVJG0e-KnHgOOpQq5JhourwCMaMnNEhDw,24862
 reconcile/sql_query.py,sha256=Go_H36p3YTW4Xv-elYDxW_Fe6Q4ErFhD6eQoFh9Jylw,26424
 reconcile/status.py,sha256=h73oaSxO5sftEGqFrXVAlySBvNYPWpowDaYYplcky5A,565
 reconcile/status_board.py,sha256=iv2CR3IsX_uDY5aXHjTOySeTR5d3vsABykYNiYNjZew,15316
@@ -289,6 +290,7 @@ reconcile/gql_definitions/common/smtp_client_settings.py,sha256=M7yAoK7dJDPv-nmv
 reconcile/gql_definitions/common/state_aws_account.py,sha256=nworxRE4w2L80eIwTStvmH9vj1ZprLTewnwwZVVXvx4,2191
 reconcile/gql_definitions/common/users.py,sha256=xyBIIywmpNxzjFVnPEoBq2JOaCiv2nP5-KATI0J2ndE,1683
 reconcile/gql_definitions/common/users_with_paths.py,sha256=nZVNZA0Z8oy0xCEe15PuX6q1YVQSUVRkr_MUch9798M,2721
+reconcile/gql_definitions/common/vcs.py,sha256=OGHBQoMGGZj0GnpzMTMtomxnJUZbbwzq2xJF__qdh0Q,2315
 reconcile/gql_definitions/cost_report/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 reconcile/gql_definitions/cost_report/app_names.py,sha256=OWCgrG9EAZvjC9lC_sqGwdjThAHcrxME4HGA2vX9dfM,1781
 reconcile/gql_definitions/cost_report/cost_namespaces.py,sha256=UptiwccN0l-z2t_zU62WEymg0wHlRouKRoJk-u-6II4,2281
@@ -403,6 +405,11 @@ reconcile/gql_definitions/slack_usergroups/__init__.py,sha256=47DEQpj8HBSa-_TImW
 reconcile/gql_definitions/slack_usergroups/clusters.py,sha256=O1XNASxsW5S57nsn0Y-y2533tlLTFaiIMKXtyFlpyXY,2114
 reconcile/gql_definitions/slack_usergroups/permissions.py,sha256=TPeOLm2Uy-L-Pejyk1TADZT9cmc1yC0KrTGzBlnK8UM,5443
 reconcile/gql_definitions/slack_usergroups/users.py,sha256=XMrZ4c_Mnnzq-JkIblrq91D-1-1TQua9kDuzeP4z9Ps,2875
+reconcile/gql_definitions/slack_usergroups_api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+reconcile/gql_definitions/slack_usergroups_api/clusters.py,sha256=lYTelX3xdklam8hsUfZuCE41LcwJIhlhLDj0jsRSy58,2129
+reconcile/gql_definitions/slack_usergroups_api/permissions.py,sha256=uX7_aSXQghw1eekr7E2U_NBRZbTxIqCSXJmzfTM4OSY,4722
+reconcile/gql_definitions/slack_usergroups_api/roles.py,sha256=a41pFZbF1-50M8uzib8eyI2rWUC7ke85gJ9jCiXBlI0,3694
+reconcile/gql_definitions/slack_usergroups_api/users.py,sha256=8zL6qLgwiHtLJQ4X60AkTUBX68x_h5E5Fdmfb4skNlI,3002
 reconcile/gql_definitions/slo_documents/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 reconcile/gql_definitions/slo_documents/slo_documents.py,sha256=SZg-K5ShF3uFWuKWJwHX2W6ZOP8tcqEcWULrc491rVE,3741
 reconcile/gql_definitions/status_board/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -578,6 +585,7 @@ reconcile/typed_queries/unleash.py,sha256=7HDc4owF044xM9Thx4WsXV7DZgETxJjy4lbpwm
 reconcile/typed_queries/users.py,sha256=UXlaxeZAoNIugMEndfcjbkHYowUURE72aWcdmxfb3yk,377
 reconcile/typed_queries/users_with_paths.py,sha256=lvW0QzTJtKkLS2O_Jm9_0mFXJFKvGlZE809LI-5ddvc,342
 reconcile/typed_queries/vault.py,sha256=lkRsmobykorof3fcrIPLz-NgvAiSOWSOZc_jXBlnl1w,274
+reconcile/typed_queries/vcs.py,sha256=a0XHygp1H3n-Eb4yWyCMHGyrfdciIczMB7DOwg-0rgc,1077
 reconcile/typed_queries/app_interface_metrics_exporter/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 reconcile/typed_queries/app_interface_metrics_exporter/onboarding_status.py,sha256=X-N1WJGOL6OR9940P0_K4-YJzkL5Vg4favhYrBxXD9A,327
 reconcile/typed_queries/app_interface_metrics_exporter/terraform_repo.py,sha256=r-nJ5CucAOE_cwxnbVp5lmAAfHBG8t1h2tVmhviVYls,290
@@ -756,9 +764,9 @@ reconcile/utils/rosa/session.py,sha256=o7RCTazHRQbDOC_E89qYaQBiHIoj4mfcCjC6ndlA8
 reconcile/utils/runtime/__init__.py,sha256=sfk92MGfsBh9tKYHl_FH17NdEsrGBwgDFTb7KNKoIfY,107
 reconcile/utils/runtime/desired_state_diff.py,sha256=Bw4zqel-klXCMZGqD1gyh8zkFq4h5qzv8rJn7K6WTXs,8132
 reconcile/utils/runtime/environment.py,sha256=h-CFKLK1qRl_gfOVIUwjqVNOmukIPzUG7AiqpJGrjHA,2038
-reconcile/utils/runtime/integration.py,sha256=6Dhx30J6kS1CTztVp7LP_V8TryJvidi8YAUuJaATNFA,10968
+reconcile/utils/runtime/integration.py,sha256=ZvaRX6huhPqlX4wX2GHVwIdoi5kJgdhXMLLlgtyrYnU,14634
 reconcile/utils/runtime/meta.py,sha256=M_EOxrb0KhQA4TwpHekbog2jOZqaBPVTIijXyRuMjn0,255
-reconcile/utils/runtime/runner.py,sha256=Mi3qCwCe_WJZLJLdTWzD8FGbkN3zUfxU9uuiCVyarww,7938
+reconcile/utils/runtime/runner.py,sha256=p7xCT1IDlDz6wKYMDMPOTEdztM4hbcxo0fw9gQf4q-A,9028
 reconcile/utils/runtime/sharding.py,sha256=r0ieUtNed7NvknSw6qQrCkKpVXE1shuHGnfFcnpA_k4,16142
 reconcile/utils/saasherder/__init__.py,sha256=3U8plqMAPRE1kjwZ5YnIsYsggTf4_gS7flRUEuXVBAs,343
 reconcile/utils/saasherder/interfaces.py,sha256=T-V6EQhzpKj0OAgnGAuAOWtKPa35UtMDuXcgnQs8Vd8,9413
@@ -809,7 +817,7 @@ tools/saas_promotion_state/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJ
 tools/saas_promotion_state/saas_promotion_state.py,sha256=uQv2QJAmUXP1g2GPIH30WTlvL9soY6m9lefpZEVDM5w,3965
 tools/sre_checkpoints/__init__.py,sha256=CDaDaywJnmRCLyl_NCcvxi-Zc0hTi_3OdwKiFOyS39I,145
 tools/sre_checkpoints/util.py,sha256=KcYVfa3UmJHVP_ocgrKe8NkrO5IDB9aWEDydSokPcRk,975
-qontract_reconcile-0.10.2.dev485.dist-info/METADATA,sha256=O8j7Xv0e0wviHqcNSOPnqpyCfuJPmdOjKoX5i3s36ik,24901
-qontract_reconcile-0.10.2.dev485.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-qontract_reconcile-0.10.2.dev485.dist-info/entry_points.txt,sha256=5i9l54La3vQrDLAdwDKQWC0iG4sV9RRfOb1BpvzOWLc,698
-qontract_reconcile-0.10.2.dev485.dist-info/RECORD,,
+qontract_reconcile-0.10.2.dev493.dist-info/METADATA,sha256=_nWbcZlopfC_ddowLK39qp9cAPE07nKHO5-Cwg7Hqm4,24958
+qontract_reconcile-0.10.2.dev493.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+qontract_reconcile-0.10.2.dev493.dist-info/entry_points.txt,sha256=5i9l54La3vQrDLAdwDKQWC0iG4sV9RRfOb1BpvzOWLc,698
+qontract_reconcile-0.10.2.dev493.dist-info/RECORD,,

reconcile/cli.py

@@ -38,6 +38,7 @@ from reconcile.utils.runtime.integration import (
     ModuleBasedQontractReconcileIntegration,
     NoParams,
     PydanticRunParams,
+    QontractReconcileApiIntegration,
     QontractReconcileIntegration,
 )
 from reconcile.utils.runtime.meta import IntegrationMeta
@@ -563,7 +564,7 @@ def run_integration(
 
 
 def run_class_integration(
-    integration: QontractReconcileIntegration,
+    integration: QontractReconcileIntegration | QontractReconcileApiIntegration,
     ctx: click.Context,
 ) -> None:
     register_faulthandler()
@@ -1240,6 +1241,29 @@ def slack_usergroups(
     )
 
 
+@integration.command(short_help="Manage Slack User Groups (channels and users).")
+@workspace_name
+@usergroup_name
+@click.pass_context
+def slack_usergroups_api(
+    ctx: click.Context, workspace_name: str | None, usergroup_name: str | None
+) -> None:
+    from reconcile.slack_usergroups_api import (
+        SlackUsergroupsIntegration,
+        SlackUsergroupsIntegrationParams,
+    )
+
+    run_class_integration(
+        integration=SlackUsergroupsIntegration(
+            SlackUsergroupsIntegrationParams(
+                workspace_name=workspace_name,
+                usergroup_name=usergroup_name,
+            )
+        ),
+        ctx=ctx,
+    )
+
+
 @integration.command(short_help="Manage permissions on GitLab projects.")
 @threaded()
 @click.pass_context

reconcile/gql_definitions/common/vcs.py

@@ -0,0 +1,91 @@
+"""
+Generated by qenerate plugin=pydantic_v2. DO NOT MODIFY MANUALLY!
+"""
+from collections.abc import Callable  # noqa: F401 # pylint: disable=W0611
+from datetime import datetime  # noqa: F401 # pylint: disable=W0611
+from enum import Enum  # noqa: F401 # pylint: disable=W0611
+from typing import (  # noqa: F401 # pylint: disable=W0611
+    Any,
+    Optional,
+    Union,
+)
+
+from pydantic import (  # noqa: F401 # pylint: disable=W0611
+    BaseModel,
+    ConfigDict,
+    Field,
+    Json,
+)
+
+from reconcile.gql_definitions.fragments.vault_secret import VaultSecret
+
+
+DEFINITION = """
+fragment VaultSecret on VaultSecret_v1 {
+  path
+  field
+  version
+  format
+}
+
+query Vcs {
+  gh_orgs: githuborg_v1 {
+    name
+    url
+    default
+    token {
+      ...VaultSecret
+    }
+  }
+  gl_instances: gitlabinstance_v1 {
+    name
+    url
+    token {
+      ...VaultSecret
+    }
+  }
+}
+"""
+
+
+class ConfiguredBaseModel(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid'
+    )
+
+
+class GithubOrgV1(ConfiguredBaseModel):
+    name: str = Field(..., alias="name")
+    url: str = Field(..., alias="url")
+    default: Optional[bool] = Field(..., alias="default")
+    token: VaultSecret = Field(..., alias="token")
+
+
+class GitlabInstanceV1(ConfiguredBaseModel):
+    name: str = Field(..., alias="name")
+    url: str = Field(..., alias="url")
+    token: VaultSecret = Field(..., alias="token")
+
+
+class VcsQueryData(ConfiguredBaseModel):
+    gh_orgs: Optional[list[GithubOrgV1]] = Field(..., alias="gh_orgs")
+    gl_instances: Optional[list[GitlabInstanceV1]] = Field(..., alias="gl_instances")
+
+
+def query(query_func: Callable, **kwargs: Any) -> VcsQueryData:
+    """
+    This is a convenience function which queries and parses the data into
+    concrete types. It should be compatible with most GQL clients.
+    You do not have to use it to consume the generated data classes.
+    Alternatively, you can also mime and alternate the behavior
+    of this function in the caller.
+
+    Parameters:
+        query_func (Callable): Function which queries your GQL Server
+        kwargs: optional arguments that will be passed to the query function
+
+    Returns:
+        VcsQueryData: queried data parsed into generated classes
+    """
+    raw_data: dict[Any, Any] = query_func(DEFINITION, **kwargs)
+    return VcsQueryData(**raw_data)

reconcile/gql_definitions/slack_usergroups_api/clusters.py

@@ -0,0 +1,76 @@
+"""
+Generated by qenerate plugin=pydantic_v2. DO NOT MODIFY MANUALLY!
+"""
+from collections.abc import Callable  # noqa: F401 # pylint: disable=W0611
+from datetime import datetime  # noqa: F401 # pylint: disable=W0611
+from enum import Enum  # noqa: F401 # pylint: disable=W0611
+from typing import (  # noqa: F401 # pylint: disable=W0611
+    Any,
+    Optional,
+    Union,
+)
+
+from pydantic import (  # noqa: F401 # pylint: disable=W0611
+    BaseModel,
+    ConfigDict,
+    Field,
+    Json,
+)
+
+
+DEFINITION = """
+query SlackUsergroupApiCluster {
+  clusters: clusters_v1 {
+    name
+    auth {
+      service
+    }
+    disable {
+      integrations
+    }
+  }
+}
+"""
+
+
+class ConfiguredBaseModel(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid'
+    )
+
+
+class ClusterAuthV1(ConfiguredBaseModel):
+    service: str = Field(..., alias="service")
+
+
+class DisableClusterAutomationsV1(ConfiguredBaseModel):
+    integrations: Optional[list[str]] = Field(..., alias="integrations")
+
+
+class ClusterV1(ConfiguredBaseModel):
+    name: str = Field(..., alias="name")
+    auth: list[ClusterAuthV1] = Field(..., alias="auth")
+    disable: Optional[DisableClusterAutomationsV1] = Field(..., alias="disable")
+
+
+class SlackUsergroupApiClusterQueryData(ConfiguredBaseModel):
+    clusters: Optional[list[ClusterV1]] = Field(..., alias="clusters")
+
+
+def query(query_func: Callable, **kwargs: Any) -> SlackUsergroupApiClusterQueryData:
+    """
+    This is a convenience function which queries and parses the data into
+    concrete types. It should be compatible with most GQL clients.
+    You do not have to use it to consume the generated data classes.
+    Alternatively, you can also mime and alternate the behavior
+    of this function in the caller.
+
+    Parameters:
+        query_func (Callable): Function which queries your GQL Server
+        kwargs: optional arguments that will be passed to the query function
+
+    Returns:
+        SlackUsergroupApiClusterQueryData: queried data parsed into generated classes
+    """
+    raw_data: dict[Any, Any] = query_func(DEFINITION, **kwargs)
+    return SlackUsergroupApiClusterQueryData(**raw_data)

reconcile/gql_definitions/slack_usergroups_api/permissions.py

@@ -0,0 +1,173 @@
+"""
+Generated by qenerate plugin=pydantic_v2. DO NOT MODIFY MANUALLY!
+"""
+from collections.abc import Callable  # noqa: F401 # pylint: disable=W0611
+from datetime import datetime  # noqa: F401 # pylint: disable=W0611
+from enum import Enum  # noqa: F401 # pylint: disable=W0611
+from typing import (  # noqa: F401 # pylint: disable=W0611
+    Any,
+    Optional,
+    Union,
+)
+
+from pydantic import (  # noqa: F401 # pylint: disable=W0611
+    BaseModel,
+    ConfigDict,
+    Field,
+    Json,
+)
+
+from reconcile.gql_definitions.fragments.user import User
+from reconcile.gql_definitions.fragments.vault_secret import VaultSecret
+
+
+DEFINITION = """
+fragment User on User_v1 {
+  name
+  org_username
+  github_username
+  pagerduty_username
+  tag_on_merge_requests
+}
+
+fragment VaultSecret on VaultSecret_v1 {
+  path
+  field
+  version
+  format
+}
+
+query SlackUsergroupApiPermission {
+  permissions: permissions_v1 {
+    service
+    ... on PermissionSlackUsergroup_v1 {
+      name
+      channels
+      description
+      handle
+      ownersFromRepos
+      skip
+      pagerduty {
+        name
+        instance {
+          token {
+            ...VaultSecret
+          }
+        }
+        scheduleID
+        escalationPolicyID
+      }
+      roles {
+        users {
+          ...User
+        }
+      }
+      schedule {
+        schedule {
+          start
+          end
+          users {
+            ...User
+          }
+        }
+      }
+      workspace {
+        path
+        name
+        integrations {
+          name
+          token {
+            ...VaultSecret
+          }
+          channel
+        }
+        managedUsergroups
+      }
+    }
+  }
+}
+"""
+
+
+class ConfiguredBaseModel(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid'
+    )
+
+
+class PermissionV1(ConfiguredBaseModel):
+    service: str = Field(..., alias="service")
+
+
+class PagerDutyInstanceV1(ConfiguredBaseModel):
+    token: VaultSecret = Field(..., alias="token")
+
+
+class PagerDutyTargetV1(ConfiguredBaseModel):
+    name: str = Field(..., alias="name")
+    instance: PagerDutyInstanceV1 = Field(..., alias="instance")
+    schedule_id: Optional[str] = Field(..., alias="scheduleID")
+    escalation_policy_id: Optional[str] = Field(..., alias="escalationPolicyID")
+
+
+class RoleV1(ConfiguredBaseModel):
+    users: list[User] = Field(..., alias="users")
+
+
+class ScheduleEntryV1(ConfiguredBaseModel):
+    start: str = Field(..., alias="start")
+    end: str = Field(..., alias="end")
+    users: list[User] = Field(..., alias="users")
+
+
+class ScheduleV1(ConfiguredBaseModel):
+    schedule: list[ScheduleEntryV1] = Field(..., alias="schedule")
+
+
+class SlackWorkspaceIntegrationV1(ConfiguredBaseModel):
+    name: str = Field(..., alias="name")
+    token: VaultSecret = Field(..., alias="token")
+    channel: str = Field(..., alias="channel")
+
+
+class SlackWorkspaceV1(ConfiguredBaseModel):
+    path: str = Field(..., alias="path")
+    name: str = Field(..., alias="name")
+    integrations: Optional[list[SlackWorkspaceIntegrationV1]] = Field(..., alias="integrations")
+    managed_usergroups: list[str] = Field(..., alias="managedUsergroups")
+
+
+class PermissionSlackUsergroupV1(PermissionV1):
+    name: str = Field(..., alias="name")
+    channels: list[str] = Field(..., alias="channels")
+    description: str = Field(..., alias="description")
+    handle: str = Field(..., alias="handle")
+    owners_from_repos: Optional[list[str]] = Field(..., alias="ownersFromRepos")
+    skip: Optional[bool] = Field(..., alias="skip")
+    pagerduty: Optional[list[PagerDutyTargetV1]] = Field(..., alias="pagerduty")
+    roles: Optional[list[RoleV1]] = Field(..., alias="roles")
+    schedule: Optional[ScheduleV1] = Field(..., alias="schedule")
+    workspace: SlackWorkspaceV1 = Field(..., alias="workspace")
+
+
+class SlackUsergroupApiPermissionQueryData(ConfiguredBaseModel):
+    permissions: list[Union[PermissionSlackUsergroupV1, PermissionV1]] = Field(..., alias="permissions")
+
+
+def query(query_func: Callable, **kwargs: Any) -> SlackUsergroupApiPermissionQueryData:
+    """
+    This is a convenience function which queries and parses the data into
+    concrete types. It should be compatible with most GQL clients.
+    You do not have to use it to consume the generated data classes.
+    Alternatively, you can also mime and alternate the behavior
+    of this function in the caller.
+
+    Parameters:
+        query_func (Callable): Function which queries your GQL Server
+        kwargs: optional arguments that will be passed to the query function
+
+    Returns:
+        SlackUsergroupApiPermissionQueryData: queried data parsed into generated classes
+    """
+    raw_data: dict[Any, Any] = query_func(DEFINITION, **kwargs)
+    return SlackUsergroupApiPermissionQueryData(**raw_data)

reconcile/gql_definitions/slack_usergroups_api/roles.py

@@ -0,0 +1,135 @@
+"""
+Generated by qenerate plugin=pydantic_v2. DO NOT MODIFY MANUALLY!
+"""
+from collections.abc import Callable  # noqa: F401 # pylint: disable=W0611
+from datetime import datetime  # noqa: F401 # pylint: disable=W0611
+from enum import Enum  # noqa: F401 # pylint: disable=W0611
+from typing import (  # noqa: F401 # pylint: disable=W0611
+    Any,
+    Optional,
+    Union,
+)
+
+from pydantic import (  # noqa: F401 # pylint: disable=W0611
+    BaseModel,
+    ConfigDict,
+    Field,
+    Json,
+)
+
+from reconcile.gql_definitions.fragments.user import User
+
+
+DEFINITION = """
+fragment User on User_v1 {
+  name
+  org_username
+  github_username
+  pagerduty_username
+  tag_on_merge_requests
+}
+
+query SlackUsergroupsApiRoles {
+  roles: roles_v1 {
+    name
+    access {
+      cluster {
+        auth {
+          service
+        }
+        name
+      }
+      group
+      namespace {
+        cluster {
+          name
+          auth {
+            service
+          }
+        }
+        delete
+        managedRoles
+      }
+    }
+    expirationDate
+    users {
+      ...User
+      tag_on_cluster_updates
+      tag_on_merge_requests
+    }
+    tag_on_cluster_updates
+  }
+}
+"""
+
+
+class ConfiguredBaseModel(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid'
+    )
+
+
+class ClusterAuthV1(ConfiguredBaseModel):
+    service: str = Field(..., alias="service")
+
+
+class ClusterV1(ConfiguredBaseModel):
+    auth: list[ClusterAuthV1] = Field(..., alias="auth")
+    name: str = Field(..., alias="name")
+
+
+class NamespaceV1_ClusterV1_ClusterAuthV1(ConfiguredBaseModel):
+    service: str = Field(..., alias="service")
+
+
+class NamespaceV1_ClusterV1(ConfiguredBaseModel):
+    name: str = Field(..., alias="name")
+    auth: list[NamespaceV1_ClusterV1_ClusterAuthV1] = Field(..., alias="auth")
+
+
+class NamespaceV1(ConfiguredBaseModel):
+    cluster: NamespaceV1_ClusterV1 = Field(..., alias="cluster")
+    delete: Optional[bool] = Field(..., alias="delete")
+    managed_roles: Optional[bool] = Field(..., alias="managedRoles")
+
+
+class AccessV1(ConfiguredBaseModel):
+    cluster: Optional[ClusterV1] = Field(..., alias="cluster")
+    group: Optional[str] = Field(..., alias="group")
+    namespace: Optional[NamespaceV1] = Field(..., alias="namespace")
+
+
+class UserV1(User):
+    tag_on_cluster_updates: Optional[bool] = Field(..., alias="tag_on_cluster_updates")
+    tag_on_merge_requests: Optional[bool] = Field(..., alias="tag_on_merge_requests")
+
+
+class RoleV1(ConfiguredBaseModel):
+    name: str = Field(..., alias="name")
+    access: Optional[list[AccessV1]] = Field(..., alias="access")
+    expiration_date: Optional[str] = Field(..., alias="expirationDate")
+    users: list[UserV1] = Field(..., alias="users")
+    tag_on_cluster_updates: Optional[bool] = Field(..., alias="tag_on_cluster_updates")
+
+
+class SlackUsergroupsApiRolesQueryData(ConfiguredBaseModel):
+    roles: Optional[list[RoleV1]] = Field(..., alias="roles")
+
+
+def query(query_func: Callable, **kwargs: Any) -> SlackUsergroupsApiRolesQueryData:
+    """
+    This is a convenience function which queries and parses the data into
+    concrete types. It should be compatible with most GQL clients.
+    You do not have to use it to consume the generated data classes.
+    Alternatively, you can also mime and alternate the behavior
+    of this function in the caller.
+
+    Parameters:
+        query_func (Callable): Function which queries your GQL Server
+        kwargs: optional arguments that will be passed to the query function
+
+    Returns:
+        SlackUsergroupsApiRolesQueryData: queried data parsed into generated classes
+    """
+    raw_data: dict[Any, Any] = query_func(DEFINITION, **kwargs)
+    return SlackUsergroupsApiRolesQueryData(**raw_data)