dex-connector-contentful 0.1.0__tar.gz

dex_connector_contentful-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+/.dex-local/dexcli
+/.dex-local/dex-server-zd
+/.dex-local/data/
+/.dex-local/cli.log
+/.dex-local/visualize.json
+/.dex-local/visualize.err

dex_connector_contentful-0.1.0/PKG-INFO

@@ -0,0 +1,48 @@
+Metadata-Version: 2.5
+Name: dex-connector-contentful
+Version: 0.1.0
+Summary: Contentful connector for Dex Flows
+License-Expression: MIT
+Requires-Python: >=3.11
+Requires-Dist: dex-connectors-sdk==0.1.0
+Requires-Dist: dex-python-sdk>=1.28.0
+Requires-Dist: httpx>=0.27
+Description-Content-Type: text/markdown
+
+# Contentful connector for Python
+
+Install with `pip install dex-connector-contentful==0.1.0`. The package requires
+`dex-connectors-sdk==0.1.0` and `dex-python-sdk>=1.28.0`, and implements the
+manifest Queries `getEntry` and `listEntries` with the same
+branches, defaults, and failure classification as the Go module. Each output
+keeps the provider's JSON response untouched in `data`.
+
+## Operations
+
+| Operation | Factory | Happy branch | Optional branches |
+| --- | --- | --- | --- |
+| `getEntry` | `new_get_entry_step` | `found` | `notFound`, `providerRejected`, `invalidResponse`, `defect` |
+| `listEntries` | `new_list_entries_step` | `listed` | `providerRejected`, `invalidResponse`, `defect` |
+
+Space, environment, and entry IDs must be letters, digits, `_`, or `-`; `listEntries` accepts `limit` up to 1000 and a nonnegative `skip`. 408, 409, 429, 5xx, and transport failures retry. HTTP 404
+selects `notFound` where the operation declares it; other non-200 responses
+select `providerRejected` with authentication (401), authorization (403), or
+validation (400, 422) failure kinds. A successful body without the expected
+top-level shape is `invalidResponse`.
+
+## Authorization
+
+Create a Dex Web connection named `contentful` as described in the
+[connector README](../README.md#authorization-and-configuration). The Content Delivery API token travels only in the `Authorization: Bearer` header and is resolved for every attempt.
+
+## Example
+
+[`examples/sample_contentful`](examples/sample_contentful/flow.py) runs one
+`getEntry` read and records the result. Run the Worker with
+`uv run python -m examples.sample_contentful.worker` after `dexcli dev` has
+loaded a project containing the `contentful` connection.
+
+## Tests
+
+`contentfulmock.Mock` scripts both Queries and defaults to the manifest answers.
+Run `uv run pytest tests` for provider parity and manifest contract checks.

dex_connector_contentful-0.1.0/README.md

@@ -0,0 +1,37 @@
+# Contentful connector for Python
+
+Install with `pip install dex-connector-contentful==0.1.0`. The package requires
+`dex-connectors-sdk==0.1.0` and `dex-python-sdk>=1.28.0`, and implements the
+manifest Queries `getEntry` and `listEntries` with the same
+branches, defaults, and failure classification as the Go module. Each output
+keeps the provider's JSON response untouched in `data`.
+
+## Operations
+
+| Operation | Factory | Happy branch | Optional branches |
+| --- | --- | --- | --- |
+| `getEntry` | `new_get_entry_step` | `found` | `notFound`, `providerRejected`, `invalidResponse`, `defect` |
+| `listEntries` | `new_list_entries_step` | `listed` | `providerRejected`, `invalidResponse`, `defect` |
+
+Space, environment, and entry IDs must be letters, digits, `_`, or `-`; `listEntries` accepts `limit` up to 1000 and a nonnegative `skip`. 408, 409, 429, 5xx, and transport failures retry. HTTP 404
+selects `notFound` where the operation declares it; other non-200 responses
+select `providerRejected` with authentication (401), authorization (403), or
+validation (400, 422) failure kinds. A successful body without the expected
+top-level shape is `invalidResponse`.
+
+## Authorization
+
+Create a Dex Web connection named `contentful` as described in the
+[connector README](../README.md#authorization-and-configuration). The Content Delivery API token travels only in the `Authorization: Bearer` header and is resolved for every attempt.
+
+## Example
+
+[`examples/sample_contentful`](examples/sample_contentful/flow.py) runs one
+`getEntry` read and records the result. Run the Worker with
+`uv run python -m examples.sample_contentful.worker` after `dexcli dev` has
+loaded a project containing the `contentful` connection.
+
+## Tests
+
+`contentfulmock.Mock` scripts both Queries and defaults to the manifest answers.
+Run `uv run pytest tests` for provider parity and manifest contract checks.

dex_connector_contentful-0.1.0/examples/sample_contentful/__init__.py

@@ -0,0 +1,3 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT
+"""Contentful sample example Flow."""

dex_connector_contentful-0.1.0/examples/sample_contentful/flow.py

@@ -0,0 +1,74 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT
+"""Runnable Contentful sample Flow using the getEntry Query."""
+
+import dex
+from dex_connectors.sdk import QueryResult
+
+from dex_connectors.contentful import Connection, GetEntryInput, GetEntryOutput, new_get_entry_step
+
+FLOW_TYPE = "ContentfulSample"
+CONNECTION_NAME = "contentful"
+_CALL_STEP_TYPE = "CallContentful"
+_RESULT = dex.Attribute("contentful-sample-result", GetEntryOutput)
+
+
+def map_to_operation_input(request: GetEntryInput) -> GetEntryInput:
+    """Send the request unchanged."""
+    return request
+
+
+# dex:group group-id:contentful group-label:"Contentful"
+# dex:explanation text:"Start the Contentful request."
+class _StartRequest(dex.Step[GetEntryInput]):
+    def get_step_type(self) -> str:
+        return "StartContentfulRequest"
+
+    def execute(self, context: dex.Context, input: GetEntryInput) -> dex.StepDecision:
+        return dex.go_to(dex.StepRef(_CALL_STEP_TYPE), input)
+
+
+# dex:group group-id:contentful group-label:"Contentful"
+# dex:explanation text:"Record the provider result and complete the Flow."
+class _CompleteRequest(dex.Step[QueryResult[GetEntryOutput]]):
+    def get_step_type(self) -> str:
+        return "CompleteContentfulRequest"
+
+    def execute(self, context: dex.Context, input: QueryResult[GetEntryOutput]) -> dex.StepDecision:
+        _RESULT.set(context, input.value)
+        return dex.graceful_complete(input.value)
+
+
+class SampleFlow(dex.Flow[GetEntryInput]):
+    """Run one getEntry read through the static contentful connection."""
+
+    def __init__(self, connection: Connection) -> None:
+        if connection.reference.name != CONNECTION_NAME:
+            raise ValueError("the sample requires the static contentful connection")
+        self._start = _StartRequest()
+        self._complete = _CompleteRequest()
+        self._call = new_get_entry_step(
+            step_type=_CALL_STEP_TYPE,
+            step_input_type=GetEntryInput,
+            annotations={
+                "groupId": "contentful",
+                "groupLabel": "Contentful",
+                "explanation": "Get one published Contentful entry.",
+            },
+            connection=connection,
+            connection_name=CONNECTION_NAME,
+            map_to_operation_input=map_to_operation_input,
+            found=self._complete,
+        )
+
+    def get_flow_type(self) -> str:
+        """Return the stable Flow identity used in Dex Web."""
+        return FLOW_TYPE
+
+    def get_steps(self) -> dex.StepList[GetEntryInput]:
+        """Register the start, provider read, and completion Steps."""
+        return dex.StepList.start_step(self._start).other_steps(self._call, self._complete)
+
+    def get_persistence_schema(self) -> dex.PersistenceSchema:
+        """Persist the provider result."""
+        return dex.PersistenceSchema.of(_RESULT)

dex_connector_contentful-0.1.0/examples/sample_contentful/worker.py

@@ -0,0 +1,51 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT
+"""Worker entrypoint for the Contentful sample Flow."""
+
+import asyncio
+import os
+import tempfile
+from pathlib import Path
+
+import dex
+from dex_connectors.sdk.projectconfig import load_from_environment
+
+from dex_connectors.contentful import new_project_connection
+
+from .flow import CONNECTION_NAME, SampleFlow
+
+
+async def run_worker() -> None:
+    """Load the named Dex Web connection and serve Contentful reads."""
+    project = await load_from_environment()
+    connection = None
+    cache = None
+    try:
+        connection = new_project_connection(project, CONNECTION_NAME)
+        registry = dex.Registry([SampleFlow(connection)], allow_async_handlers=True)
+        cache_directory = os.environ.get(
+            "DEX_BLOB_CACHE_DIR", str(Path(tempfile.gettempdir()) / "dex-contentful-sample-blobs")
+        )
+        cache = dex.open_blob_cache(dex.BlobCacheConfig(cache_directory, 1 << 30))
+        worker = dex.AsyncWorker(
+            registry,
+            cache,
+            dex.WorkerOptions(server_address=os.environ.get("DEX_FLOW_SERVICE_ADDRESS", "localhost:8801")),
+        )
+        async with worker:
+            await worker.start()
+    finally:
+        if connection is not None:
+            await connection.aclose()
+        if cache is not None:
+            cache.close()
+        await project.close()
+
+
+def main() -> None:
+    """Run until the Worker stops or the process receives an interrupt."""
+    asyncio.run(run_worker())
+
+
+if __name__ == "__main__":
+    main()

dex_connector_contentful-0.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "dex-connector-contentful"
+version = "0.1.0"
+description = "Contentful connector for Dex Flows"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+dependencies = ["dex-connectors-sdk==0.1.0", "dex-python-sdk>=1.28.0", "httpx>=0.27"]
+
+[dependency-groups]
+dev = ["pytest>=8", "pytest-asyncio>=0.24", "mypy>=1.13", "ruff>=0.7", "pyyaml>=6", "types-PyYAML>=6"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/dex_connectors"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = [".", "src"]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+mypy_path = "src"
+explicit_package_bases = true
+
+[tool.ruff]
+target-version = "py311"
+line-length = 110
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]

dex_connector_contentful-0.1.0/src/dex_connectors/contentful/__init__.py

@@ -0,0 +1,50 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT
+"""Contentful Queries for Dex connector Steps."""
+
+from .client import (
+    CONNECTOR_ID,
+    DEFECT,
+    FOUND,
+    GET_ENTRY_DEFINITION,
+    INVALID_RESPONSE,
+    LIST_ENTRIES_DEFINITION,
+    LISTED,
+    NOT_FOUND,
+    PROVIDER_REJECTED,
+    Client,
+    Config,
+    Credentials,
+    GetEntryOperation,
+    ListEntriesOperation,
+)
+from .connection import Connection, new_connection, new_connection_with_operations, new_project_connection
+from .models import GetEntryInput, GetEntryOutput, ListEntriesInput, ListEntriesOutput
+from .steps import new_get_entry_step, new_list_entries_step
+
+__all__ = [
+    "Client",
+    "Config",
+    "Connection",
+    "Credentials",
+    "GetEntryInput",
+    "GetEntryOperation",
+    "GetEntryOutput",
+    "ListEntriesInput",
+    "ListEntriesOperation",
+    "ListEntriesOutput",
+    "new_connection",
+    "new_connection_with_operations",
+    "new_get_entry_step",
+    "new_list_entries_step",
+    "new_project_connection",
+    "CONNECTOR_ID",
+    "DEFECT",
+    "FOUND",
+    "GET_ENTRY_DEFINITION",
+    "INVALID_RESPONSE",
+    "LISTED",
+    "LIST_ENTRIES_DEFINITION",
+    "NOT_FOUND",
+    "PROVIDER_REJECTED",
+]

dex_connector_contentful-0.1.0/src/dex_connectors/contentful/_generated/__init__.py

@@ -0,0 +1,2 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT

dex_connector_contentful-0.1.0/src/dex_connectors/contentful/_generated/config.py

@@ -0,0 +1,25 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT
+# ruff: noqa
+
+from dataclasses import dataclass
+
+from dex_connectors.sdk import SecretString
+
+
+@dataclass(frozen=True, slots=True)
+class Config:
+
+    base_url: str = "https://cdn.contentful.com"
+    timeout_seconds: float = 15
+    max_response_bytes: int = 2097152
+
+setattr(Config, '__module__', 'dex_connectors.contentful.client')
+
+
+@dataclass(frozen=True, slots=True)
+class Credentials:
+
+    delivery_token: SecretString
+
+setattr(Credentials, '__module__', 'dex_connectors.contentful.client')

dex_connector_contentful-0.1.0/src/dex_connectors/contentful/_generated/connection.py

@@ -0,0 +1,131 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT
+# ruff: noqa
+
+from typing import Any
+
+import httpx
+from dex_connectors.sdk import ConnectionRef, Query, Call, SecretString
+from dex_connectors.sdk.projectconfig import ConnectionKey, LoadedProject
+
+from ..client import Client, Config, Credentials
+from .definitions import CONNECTOR_ID, GET_ENTRY_DEFINITION, LIST_ENTRIES_DEFINITION
+from ..models import GetEntryInput, GetEntryOutput, ListEntriesInput, ListEntriesOutput
+
+class Connection:
+
+    __slots__ = ('_get_entry', '_list_entries', '_client', 'reference')
+
+    def __init__(self,
+        reference: ConnectionRef,
+        get_entry: Query[GetEntryInput, GetEntryOutput],
+        list_entries: Query[ListEntriesInput, ListEntriesOutput],
+        client: Client | None = None,
+    ) -> None:
+        reference.validate()
+        if reference.provider != CONNECTOR_ID or get_entry is None or list_entries is None:
+            raise ValueError("Contentful connection provider and operations are required")
+        if get_entry.definition().operation != GET_ENTRY_DEFINITION.operation:
+            raise ValueError("Contentful connection operation identity differs")
+        if list_entries.definition().operation != LIST_ENTRIES_DEFINITION.operation:
+            raise ValueError("Contentful connection operation identity differs")
+        self.reference = reference
+        self._get_entry = get_entry
+        self._list_entries = list_entries
+        self._client = client
+
+    def get_entry(self) -> Query[GetEntryInput, GetEntryOutput]:
+        return self._get_entry
+
+    def list_entries(self) -> Query[ListEntriesInput, ListEntriesOutput]:
+        return self._list_entries
+
+    async def aclose(self) -> None:
+        if self._client is not None:
+            await self._client.aclose()
+
+    def __repr__(self) -> str:
+        return "contentful.Connection([REDACTED])"
+
+    def __reduce__(self) -> tuple[object, ...]:
+        raise TypeError("Contentful connections cannot be serialized")
+
+setattr(Connection, '__module__', 'dex_connectors.contentful.connection')
+
+
+def new_connection(client: Client, reference: ConnectionRef) -> Connection:
+    if client is None:
+        raise ValueError("Contentful client is required")
+    return Connection(reference, client.get_entry(), client.list_entries(), client)
+
+setattr(new_connection, '__module__', 'dex_connectors.contentful.connection')
+
+
+def new_connection_with_operations(
+    get_entry: Query[GetEntryInput, GetEntryOutput],
+    list_entries: Query[ListEntriesInput, ListEntriesOutput],
+    reference: ConnectionRef,
+) -> Connection:
+    return Connection(reference, get_entry, list_entries)
+
+setattr(new_connection_with_operations, '__module__', 'dex_connectors.contentful.connection')
+
+
+class _ProjectCredentialSource:
+
+    def __init__(self, project: LoadedProject, key: ConnectionKey) -> None:
+        self.project = project
+        self.key = key
+
+    async def resolve(self, call: Call) -> Credentials:
+        material = await self.project.resolve_credential(self.key, str(call.id))
+        delivery_token = material.get("delivery_token")
+        if not isinstance(delivery_token, str) or not delivery_token:
+            raise ValueError("Contentful credential delivery_token is required")
+        return Credentials(SecretString(delivery_token))
+
+
+def new_project_connection(
+    project: LoadedProject, connection_name: str, http_client: httpx.AsyncClient | None = None
+) -> Connection:
+    if project is None:
+        raise ValueError("Contentful connection requires loaded project configuration")
+    reference = ConnectionRef(CONNECTOR_ID, connection_name)
+    reference.validate()
+    key = ConnectionKey(CONNECTOR_ID, connection_name)
+    matching = [
+        entry
+        for entry in project.configuration.connections
+        if entry.connector_id == CONNECTOR_ID and entry.connection_name == connection_name
+    ]
+    if len(matching) != 1:
+        raise ValueError("Contentful project connection is missing or duplicated")
+    if matching[0].provider != CONNECTOR_ID:
+        raise ValueError("Contentful project connection provider differs")
+    config = _decode_config(matching[0].configuration)
+    client = Client(config, _ProjectCredentialSource(project, key), http_client)
+    return new_connection(client, reference)
+
+setattr(new_project_connection, '__module__', 'dex_connectors.contentful.connection')
+
+
+def _decode_config(value: dict[str, Any]) -> Config:
+    if set(value) - {"baseUrl", "timeout", "maxResponseBytes"}:
+        raise ValueError("Contentful configuration has unknown fields")
+    config_arguments: dict[str, Any] = {}
+    if "baseUrl" in value:
+        base_url = value["baseUrl"]
+        if not (isinstance(base_url, str)):
+            raise ValueError("Contentful configuration baseUrl has an invalid type")
+        config_arguments['base_url'] = base_url
+    if "timeout" in value:
+        timeout = value["timeout"]
+        if not (type(timeout) is int):
+            raise ValueError("Contentful configuration timeout has an invalid type")
+        config_arguments['timeout_seconds'] = timeout / 1_000_000_000
+    if "maxResponseBytes" in value:
+        max_response_bytes = value["maxResponseBytes"]
+        if not (type(max_response_bytes) is int):
+            raise ValueError("Contentful configuration maxResponseBytes has an invalid type")
+        config_arguments['max_response_bytes'] = max_response_bytes
+    return Config(**config_arguments)

dex_connector_contentful-0.1.0/src/dex_connectors/contentful/_generated/definitions.py

@@ -0,0 +1,57 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT
+# ruff: noqa
+
+from datetime import timedelta
+
+from dex_connectors.sdk import (
+    BranchDefinition,
+    MutationDefinition,
+    OperationRef,
+    QueryDefinition,
+    RetryPolicy,
+    StepDefaults,
+    default_connector_step_execute_retry_policy,
+)
+
+CONNECTOR_ID = "contentful"
+PROVIDER = "contentful"
+GET_ENTRY_OPERATION_ID = "getEntry"
+LIST_ENTRIES_OPERATION_ID = "listEntries"
+DEFECT = "defect"
+FOUND = "found"
+INVALID_RESPONSE = "invalidResponse"
+LISTED = "listed"
+NOT_FOUND = "notFound"
+PROVIDER_REJECTED = "providerRejected"
+
+GET_ENTRY_DEFINITION = QueryDefinition(
+    OperationRef(CONNECTOR_ID, GET_ENTRY_OPERATION_ID),
+    (
+        BranchDefinition(FOUND, "Get one published Contentful entry.", False),
+        BranchDefinition(NOT_FOUND, "The requested provider resource does not exist or is not visible.", True),
+        BranchDefinition(PROVIDER_REJECTED, "The provider conclusively rejected the request or credentials.", True),
+        BranchDefinition(INVALID_RESPONSE, "The provider returned malformed or oversized JSON.", True),
+        BranchDefinition(DEFECT, "Local input, configuration, or credentials are invalid.", True),
+    ),
+    StepDefaults(
+        timedelta(seconds=30),
+        2,
+        execute_retry=default_connector_step_execute_retry_policy(),
+    ),
+)
+
+LIST_ENTRIES_DEFINITION = QueryDefinition(
+    OperationRef(CONNECTOR_ID, LIST_ENTRIES_OPERATION_ID),
+    (
+        BranchDefinition(LISTED, "List one page of published entries in a space and environment.", False),
+        BranchDefinition(PROVIDER_REJECTED, "The provider conclusively rejected the request or credentials.", True),
+        BranchDefinition(INVALID_RESPONSE, "The provider returned malformed or oversized JSON.", True),
+        BranchDefinition(DEFECT, "Local input, configuration, or credentials are invalid.", True),
+    ),
+    StepDefaults(
+        timedelta(seconds=30),
+        2,
+        execute_retry=default_connector_step_execute_retry_policy(),
+    ),
+)

dex_connector_contentful-0.1.0/src/dex_connectors/contentful/_generated/mock.py

@@ -0,0 +1,113 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT
+# ruff: noqa
+
+from datetime import datetime
+
+from dex_connectors.sdk import ConnectionRef, Failure, FailureKind
+from dex_connectors.sdk.connectormock import Case, Query
+
+from ..connection import Connection, new_connection_with_operations
+from ..models import GetEntryInput, GetEntryOutput, ListEntriesInput, ListEntriesOutput
+from .definitions import CONNECTOR_ID, DEFECT, FOUND, GET_ENTRY_DEFINITION, INVALID_RESPONSE, LISTED, LIST_ENTRIES_DEFINITION, NOT_FOUND, PROVIDER_REJECTED
+
+def get_entry_found(value: GetEntryOutput, failure: Failure | None = None) -> Case[GetEntryOutput]:
+    return Case.branch_result(FOUND, value, failure)
+
+setattr(get_entry_found, '__module__', "dex_connectors.contentful.contentfulmock")
+
+def get_entry_not_found(value: GetEntryOutput, failure: Failure | None = None) -> Case[GetEntryOutput]:
+    return Case.branch_result(NOT_FOUND, value, failure)
+
+setattr(get_entry_not_found, '__module__', "dex_connectors.contentful.contentfulmock")
+
+def get_entry_provider_rejected(value: GetEntryOutput, failure: Failure | None = None) -> Case[GetEntryOutput]:
+    return Case.branch_result(PROVIDER_REJECTED, value, failure)
+
+setattr(get_entry_provider_rejected, '__module__', "dex_connectors.contentful.contentfulmock")
+
+def get_entry_invalid_response(value: GetEntryOutput, failure: Failure | None = None) -> Case[GetEntryOutput]:
+    return Case.branch_result(INVALID_RESPONSE, value, failure)
+
+setattr(get_entry_invalid_response, '__module__', "dex_connectors.contentful.contentfulmock")
+
+def get_entry_defect(value: GetEntryOutput, failure: Failure | None = None) -> Case[GetEntryOutput]:
+    return Case.branch_result(DEFECT, value, failure)
+
+setattr(get_entry_defect, '__module__', "dex_connectors.contentful.contentfulmock")
+
+def get_entry_retry(failure: Failure, after_seconds: float = 0) -> Case[GetEntryOutput]:
+    return Case.retry(failure, after_seconds)
+
+setattr(get_entry_retry, '__module__', "dex_connectors.contentful.contentfulmock")
+
+def get_entry_default_get_entry() -> Case[GetEntryOutput]:
+    return Case.branch_result(FOUND, GetEntryOutput(data={'sys': {'id': 'entry-meridian', 'type': 'Entry'}, 'fields': {'title': 'Meridian'}}))
+
+setattr(get_entry_default_get_entry, '__module__', "dex_connectors.contentful.contentfulmock")
+
+def list_entries_listed(value: ListEntriesOutput, failure: Failure | None = None) -> Case[ListEntriesOutput]:
+    return Case.branch_result(LISTED, value, failure)
+
+setattr(list_entries_listed, '__module__', "dex_connectors.contentful.contentfulmock")
+
+def list_entries_provider_rejected(value: ListEntriesOutput, failure: Failure | None = None) -> Case[ListEntriesOutput]:
+    return Case.branch_result(PROVIDER_REJECTED, value, failure)
+
+setattr(list_entries_provider_rejected, '__module__', "dex_connectors.contentful.contentfulmock")
+
+def list_entries_invalid_response(value: ListEntriesOutput, failure: Failure | None = None) -> Case[ListEntriesOutput]:
+    return Case.branch_result(INVALID_RESPONSE, value, failure)
+
+setattr(list_entries_invalid_response, '__module__', "dex_connectors.contentful.contentfulmock")
+
+def list_entries_defect(value: ListEntriesOutput, failure: Failure | None = None) -> Case[ListEntriesOutput]:
+    return Case.branch_result(DEFECT, value, failure)
+
+setattr(list_entries_defect, '__module__', "dex_connectors.contentful.contentfulmock")
+
+def list_entries_retry(failure: Failure, after_seconds: float = 0) -> Case[ListEntriesOutput]:
+    return Case.retry(failure, after_seconds)
+
+setattr(list_entries_retry, '__module__', "dex_connectors.contentful.contentfulmock")
+
+def list_entries_default_list_entries() -> Case[ListEntriesOutput]:
+    return Case.branch_result(LISTED, ListEntriesOutput(data={'items': [{'sys': {'id': 'entry-meridian', 'type': 'Entry'}, 'fields': {'title': 'Meridian'}}], 'total': 1, 'skip': 0, 'limit': 100}))
+
+setattr(list_entries_default_list_entries, '__module__', "dex_connectors.contentful.contentfulmock")
+
+
+class Mock:
+
+    def __init__(self, connection_name: str = "contentful") -> None:
+        self.get_entry_script: Query[GetEntryInput, GetEntryOutput] = Query(GET_ENTRY_DEFINITION)
+        self.get_entry_script.default(get_entry_default_get_entry())
+        self.list_entries_script: Query[ListEntriesInput, ListEntriesOutput] = Query(LIST_ENTRIES_DEFINITION)
+        self.list_entries_script.default(list_entries_default_list_entries())
+        self._connection = new_connection_with_operations(
+            get_entry=self.get_entry_script,
+            list_entries=self.list_entries_script,
+            reference=ConnectionRef(CONNECTOR_ID, connection_name),
+        )
+
+    def connection(self) -> Connection:
+        return self._connection
+
+setattr(Mock, '__module__', "dex_connectors.contentful.contentfulmock")
+
+__all__ = [
+    "Mock",
+    "get_entry_found",
+    "get_entry_not_found",
+    "get_entry_provider_rejected",
+    "get_entry_invalid_response",
+    "get_entry_defect",
+    "get_entry_retry",
+    "get_entry_default_get_entry",
+    "list_entries_listed",
+    "list_entries_provider_rejected",
+    "list_entries_invalid_response",
+    "list_entries_defect",
+    "list_entries_retry",
+    "list_entries_default_list_entries",
+]