httk.serve.dsp.config¶

Validated configuration and durable publication records for DSP serving.

Attributes¶

`DSP_CONTEXT`	Protected official DSP JSON-LD context required by the 2025-1 schemas.
`DSP_VERSION`	Implemented Data Space Protocol version.
`HTTP_ENDPOINT_TYPE`	Official DSP endpoint type used by HTTPS-pull data addresses.
`DSP_2025_1_SPECIFICATION`
`DCAT_AP_3_0_1_PROFILE`
`DSP_MINIMAL_PROFILE`
`DCAT_AP_MINIMAL_PROFILE`
`DCAT_AP_MINIMAL_CONTENT_NEGOTIATION`
`EU_FILE_TYPE_CSV`
`EU_FILE_TYPE_JSON`
`IANA_MEDIA_TYPE_CSV`
`IANA_MEDIA_TYPE_JSON`
`SPDX_SHA256`

Classes¶

`DspDatasetPublication`	Attach the one DSP-specific offer identifier to a neutral dataset.
`DspPublicationRecord`	Store exactly one dataset publication or catalogue service envelope.
`DspPublicationEntry`	Non-OPTIMADE logical family for durable DSP publication records.
`DspProviderConfig`	Configure global DSP minimal service and catalogue metadata.

Module Contents¶

httk.serve.dsp.config.DSP_CONTEXT = 'https://w3id.org/dspace/2025/1/context.jsonld'¶: Protected official DSP JSON-LD context required by the 2025-1 schemas.

httk.serve.dsp.config.DSP_VERSION = '2025-1'¶: Implemented Data Space Protocol version.

httk.serve.dsp.config.HTTP_ENDPOINT_TYPE = 'https://w3id.org/idsa/v4.1/HTTP'¶: Official DSP endpoint type used by HTTPS-pull data addresses.

httk.serve.dsp.config.DSP_2025_1_SPECIFICATION = 'https://eclipse-dataspace-protocol-base.github.io/DataspaceProtocol/2025-1-err1/'¶

httk.serve.dsp.config.DCAT_AP_3_0_1_PROFILE = 'https://semiceu.github.io/DCAT-AP/releases/3.0.1/'¶

httk.serve.dsp.config.DSP_MINIMAL_PROFILE = 'https://schemas.httk.org/profiles/dsp/2025-1/minimal'¶

httk.serve.dsp.config.DCAT_AP_MINIMAL_PROFILE = 'https://schemas.httk.org/profiles/dcat-ap/3.0.1/minimal'¶

httk.serve.dsp.config.DCAT_AP_MINIMAL_CONTENT_NEGOTIATION = 'https://schemas.httk.org/profiles/dsp/2025-1/minimal#dcat-ap-content-negotiation'¶

httk.serve.dsp.config.EU_FILE_TYPE_CSV = 'http://publications.europa.eu/resource/authority/file-type/CSV'¶

httk.serve.dsp.config.EU_FILE_TYPE_JSON = 'http://publications.europa.eu/resource/authority/file-type/JSON'¶

httk.serve.dsp.config.IANA_MEDIA_TYPE_CSV = 'https://www.iana.org/assignments/media-types/text/csv'¶

httk.serve.dsp.config.IANA_MEDIA_TYPE_JSON = 'https://www.iana.org/assignments/media-types/application/json'¶

httk.serve.dsp.config.SPDX_SHA256 = 'https://spdx.org/rdf/terms#checksumAlgorithm_sha256'¶

class httk.serve.dsp.config.DspDatasetPublication(dataset, offer_id=None)¶

Attach the one DSP-specific offer identifier to a neutral dataset.

The dataset owns its distribution metadata. The minimal DSP profile accepts exactly one downloadable distribution and infers its CSV or JSON format/media-type IRIs only when either is absent. Other representations must provide both IRIs in the neutral distribution. No file is opened, measured, or hashed by this envelope.

dataset: httk.core.DatasetRecord¶

offer_id: str | None = None¶

property distribution: httk.core.DatasetDistribution¶

Return the sole neutral distribution accepted by this profile.

property distribution_id: str¶

Return the declared distribution IRI or the profile default.

property file_format: str¶

Return the explicit or CSV/JSON-inferred EU file-type IRI.

property media_type: str¶

Return the explicit or CSV/JSON-inferred IANA media-type IRI.

property access_url: str¶

Return the sole distribution’s validated HTTPS access URL.

property byte_size: int | None¶

Return publisher-supplied size metadata from the distribution.

property sha256: str | None¶

Return publisher-supplied checksum metadata from the distribution.

classmethod from_obj(obj)¶

class httk.serve.dsp.config.DspPublicationRecord(dataset=None, service=None)¶

Store exactly one dataset publication or catalogue service envelope.

dataset: DspDatasetPublication | None = None¶

service: httk.core.ServiceRecord | None = None¶

classmethod from_obj(obj)¶

class httk.serve.dsp.config.DspPublicationEntry¶

Non-OPTIMADE logical family for durable DSP publication records.

type = 'dsp-publications'¶

definition_id = None¶

class httk.serve.dsp.config.DspProviderConfig¶

Configure global DSP minimal service and catalogue metadata.

public_base_url: str¶

service_id: str¶

service_title: str¶

participant_id: str¶

catalog_id: str¶

catalog_title: str¶

catalog_description: str¶

dsp_mount: str = '/dsp'¶

automatic_progression: bool = True¶

dcat_ap_content_negotiation: bool = False¶

dsp_profile: str = 'https://schemas.httk.org/profiles/dsp/2025-1/minimal'¶

dcat_ap_profile: str = 'https://schemas.httk.org/profiles/dcat-ap/3.0.1/minimal'¶

dcat_ap_content_negotiation_profile: str = 'https://schemas.httk.org/profiles/dsp/2025-1/minimal#dcat-ap-content-negotiation'¶

property connector_root_url: str¶

Return the externally visible DSP connector root.

property service_endpoint_url: str¶

Return the externally visible versioned DSP endpoint.

resolve_access_url(access_url)¶

Resolve one validated publication URL against the public origin.