Distribution and Checksum

class fdp.distribution.Distribution(fair_data_point: FairDataPoint = None, iri: str = None, uuid: str = None)

Bases: Resource

Class representing a DCATv3 dcat:Distribution.

A Distribution describes an accessible form of a Dataset, such as a file download, an API endpoint, or any other form in which the dataset is made available.

RDF Class

dcat:Distribution

Base Classes

• fdp.resource.Resource

Supported inherited properties

From Resource:

• license

• title

• version

• publisher

Supported Dataset-specific properties

• downloadURL — url for directly downloading the distribution

• byteSize — size of the distribution in bytes

• mediaType — IANA media type

• compressFormat — compression format

• checksum — associated checksum for file integrity

• isPartOf — linking of the distribution to a larger collection

property downloadURL

The dcat:downloadURL property.

The access URL where the distribution can be downloaded.

Type:

str or rdflib.term.URIRef

Returns:

The IRI of the download location.

Return type:

rdflib.term.URIRef

property byteSize

The dcat:byteSize property.

The size of the distribution in bytes.

Type:

int

Returns:

File size expressed in bytes.

Return type:

int

property creator

The dcterms:creator property.

Type:

str, FOAFAgent, Graph

Return type:

fdp.foaf.FOAFAgent

Returns:

The resource’s creator.

property description

The dcterms:description property.

A free-text description of the resource.

Type:

str, rdflib.term.Literal, rdflib.graph.Graph

Return type:

str

Returns:

The resource’s description.

property issued

The dcterms:issued property.

The date the resource was formally issued or published.

Type:

str, datetime.date, rdflib.graph.Graph, rdflib.term.Literal,

Return type:

datetime.date

Returns:

The publication or release date in ISO 8601 format.

property license

The dcterms:license property.

The license or rights statement under which the resource is made available.

Type:

str, rdflib.term.URIRef, rdflib.graph.Graph

Return type:

str

Returns:

A reference to the license resource or a literal text description.

Note

must follow recommendation from: https://joinup.ec.europa.eu/release/dcat-ap-how-refer-licence-documents-and-licence-uris

property publisher

The dcterms:publisher property.

The entity responsible for making the resource available.

Type:

str, FOAFAgent, rdflib.graph.Graph

Return type:

fdp.foaf.FOAFAgent

Returns:

The publisher, typically a FOAF Agent.

property theme

The dcat:theme property.

The main category or subject of the resource.

Type:

str, rdflib.term.URIRef

Return type:

str

Returns:

The resource’s theme.

Note

a list of themes can be found here: https://inspire.ec.europa.eu/theme

Warning

Currently, only a single theme value is supported. The interface may change in future versions to support multiple themes.

property title

The dcterms:title property.

The human-readable title of the resource.

Type:

str, rdflib.term.Literal, rdflib.graph.Graph :rtype: str

Returns:

The preferred label or name of the resource.

property version

The dcat:version property.

The version identifier for the resource.

Type:

str, int, Tuple[int, int, int], fdp.version.Version, rdflib.graph.Graph, rdflib.term.Literal

Return type:

fdp.version.Version

Returns:

The version of the resource in one of the supported formats.

property mediaType

The dcat:mediaType property.

The media type of the distribution, typically expressed as a MIME type.

Return type:

str

Type:

str or rdflib.term.URIRef

Returns:

IRI representing the media type, typically from the IANA media type registry (for example, "http://www.iana.org/assignments/media-types/text/tab-separated-values").

Return type:

str

property compressFormat

The dcat:compressFormat property.

The compression format applied to the distribution, such as ZIP, GZIP, or TAR.

Type:

str or rdflib.term.URIRef

Returns:

The compression format represented as an IRI.

Return type:

str

property checksum

The dcat:checksum property.

The checksum associated with the distribution to verify file integrity.

Type:

fdp.checksum.Checksum

Returns:

A checksum object describing algorithm and hash value.

Return type:

fdp.checksum.Checksum

property isPartOf: dict

The isPartOf propery of the Dataset.

Identifies a resource or series of which this distribution is a part.

Type:

str or rdflib.term.URIRef

Returns:

IRI representing the containing resource or series.

Return type:

rdflib.term.URIRef

class fdp.distribution.Checksum(iri: str = None, uuid: str = None)

Bases: object

Class representing a DCATv3 package checksum.

property algorithm

The spdx:algorithm property of the Checksum’s instance.

property checksumValue

The spdx:checksumValue property.