Module gamslib.objectcsv.objectdata

CSV data model for a single GAMS object.

Defines the ObjectData class, representing metadata for a single object as stored in object.csv. Provides methods for merging, validating, and listing field names.

Classes

class ObjectData (recid: str,
title: str = '',
project: str = '',
description: str = '',
creator: str = '',
rights: str = '',
publisher: str = '',
source: str = '',
objectType: str = '',
mainResource: str = '',
funder: str = '')

Expand source code

@dataclass
class ObjectData:
    """
    Represents CSV metadata for a single GAMS object.

    Fields:

      - recid (str): Object identifier.
      - title (str): Title of the object.
      - project (str): Project name or identifier.
      - description (str): Description of the object.
      - creator (str): Creator of the object.
      - rights (str): Rights statement for the object.
      - publisher (str): Publisher of the object.
      - source (str): Source of the object.
      - objectType (str): Type of the object.
      - mainResource (str): Main datastream identifier.
      - funder (str): Funder information.
    """

    recid: str
    title: str = ""
    project: str = ""
    description: str = ""
    creator: str = ""
    rights: str = ""
    publisher: str = ""
    source: str = ""
    objectType: str = ""
    mainResource: str = ""  # main datastream
    funder: str = ""

    @classmethod
    def fieldnames(cls) -> list[str]:
        """
        Return the list of field names for ObjectData.

        Returns:
            list[str]: Names of all fields in the ObjectData dataclass.
        """
        return [field.name for field in dataclasses.fields(cls)]

    def merge(self, other: "ObjectData"):
        """
        Merge the object data with another ObjectData instance.

        Overwrites fields with non-empty values from the other instance.
        Both objects must have the same recid.

        Args:
            other (ObjectData): Another ObjectData instance to merge from.

        Raises:
            ValueError: If recid values do not match.
        """
        if self.recid != other.recid:
            raise ValueError("Cannot merge objects with different recid values")
        # These are the fields which are possibly set automatically set in the new object data
        fields_to_merge = [
            "title",
            "project",
            "creator",
            "rights",
            "publisher",
            "source",
            "objectType",
            "mainResource",
            "funder",
        ]
        for field in fields_to_merge:
            if getattr(other, field).strip():
                setattr(self, field, getattr(other, field))

    def validate(self):
        """
        Validate required metadata fields.

        Raises:
            ValueError: If any required field is empty.
        """
        if not self.recid:
            raise ValueError("recid must not be empty")
        if not self.title:
            raise ValueError(f"{self.recid}: title must not be empty")
        if not self.rights:
            raise ValueError(f"{self.recid}: rights must not be empty")
        if not self.source:
            raise ValueError(f"{self.recid}: source must not be empty")
        if not self.objectType:
            raise ValueError(f"{self.recid}: objectType must not be empty")

Represents CSV metadata for a single GAMS object.

Fields

• recid (str): Object identifier.
• title (str): Title of the object.
• project (str): Project name or identifier.
• description (str): Description of the object.
• creator (str): Creator of the object.
• rights (str): Rights statement for the object.
• publisher (str): Publisher of the object.
• source (str): Source of the object.
• objectType (str): Type of the object.
• mainResource (str): Main datastream identifier.
• funder (str): Funder information.

Static methods

def fieldnames() ‑> list[str]

Return the list of field names for ObjectData.

Returns

list[str]

Names of all fields in the ObjectData dataclass.

Instance variables

var creator : str

The type of the None singleton.

var description : str

The type of the None singleton.

var funder : str

The type of the None singleton.

var mainResource : str

The type of the None singleton.

var objectType : str

The type of the None singleton.

var project : str

The type of the None singleton.

var publisher : str

The type of the None singleton.

var recid : str

The type of the None singleton.

var rights : str

The type of the None singleton.

var source : str

The type of the None singleton.

var title : str

The type of the None singleton.

Methods

def merge(self,
other: ObjectData)

Expand source code

def merge(self, other: "ObjectData"):
    """
    Merge the object data with another ObjectData instance.

    Overwrites fields with non-empty values from the other instance.
    Both objects must have the same recid.

    Args:
        other (ObjectData): Another ObjectData instance to merge from.

    Raises:
        ValueError: If recid values do not match.
    """
    if self.recid != other.recid:
        raise ValueError("Cannot merge objects with different recid values")
    # These are the fields which are possibly set automatically set in the new object data
    fields_to_merge = [
        "title",
        "project",
        "creator",
        "rights",
        "publisher",
        "source",
        "objectType",
        "mainResource",
        "funder",
    ]
    for field in fields_to_merge:
        if getattr(other, field).strip():
            setattr(self, field, getattr(other, field))

Merge the object data with another ObjectData instance.

Overwrites fields with non-empty values from the other instance. Both objects must have the same recid.

Args

other : ObjectData

Another ObjectData instance to merge from.

Raises

ValueError

If recid values do not match.

def validate(self)

Expand source code

def validate(self):
    """
    Validate required metadata fields.

    Raises:
        ValueError: If any required field is empty.
    """
    if not self.recid:
        raise ValueError("recid must not be empty")
    if not self.title:
        raise ValueError(f"{self.recid}: title must not be empty")
    if not self.rights:
        raise ValueError(f"{self.recid}: rights must not be empty")
    if not self.source:
        raise ValueError(f"{self.recid}: source must not be empty")
    if not self.objectType:
        raise ValueError(f"{self.recid}: objectType must not be empty")

Validate required metadata fields.

Raises

ValueError

If any required field is empty.