Skip to content

VideoSegmentResource

Source code in dsp/dsp-tools/src/dsp_tools/xmllib/models/dsp_base_resources.py
 635
 636
 637
 638
 639
 640
 641
 642
 643
 644
 645
 646
 647
 648
 649
 650
 651
 652
 653
 654
 655
 656
 657
 658
 659
 660
 661
 662
 663
 664
 665
 666
 667
 668
 669
 670
 671
 672
 673
 674
 675
 676
 677
 678
 679
 680
 681
 682
 683
 684
 685
 686
 687
 688
 689
 690
 691
 692
 693
 694
 695
 696
 697
 698
 699
 700
 701
 702
 703
 704
 705
 706
 707
 708
 709
 710
 711
 712
 713
 714
 715
 716
 717
 718
 719
 720
 721
 722
 723
 724
 725
 726
 727
 728
 729
 730
 731
 732
 733
 734
 735
 736
 737
 738
 739
 740
 741
 742
 743
 744
 745
 746
 747
 748
 749
 750
 751
 752
 753
 754
 755
 756
 757
 758
 759
 760
 761
 762
 763
 764
 765
 766
 767
 768
 769
 770
 771
 772
 773
 774
 775
 776
 777
 778
 779
 780
 781
 782
 783
 784
 785
 786
 787
 788
 789
 790
 791
 792
 793
 794
 795
 796
 797
 798
 799
 800
 801
 802
 803
 804
 805
 806
 807
 808
 809
 810
 811
 812
 813
 814
 815
 816
 817
 818
 819
 820
 821
 822
 823
 824
 825
 826
 827
 828
 829
 830
 831
 832
 833
 834
 835
 836
 837
 838
 839
 840
 841
 842
 843
 844
 845
 846
 847
 848
 849
 850
 851
 852
 853
 854
 855
 856
 857
 858
 859
 860
 861
 862
 863
 864
 865
 866
 867
 868
 869
 870
 871
 872
 873
 874
 875
 876
 877
 878
 879
 880
 881
 882
 883
 884
 885
 886
 887
 888
 889
 890
 891
 892
 893
 894
 895
 896
 897
 898
 899
 900
 901
 902
 903
 904
 905
 906
 907
 908
 909
 910
 911
 912
 913
 914
 915
 916
 917
 918
 919
 920
 921
 922
 923
 924
 925
 926
 927
 928
 929
 930
 931
 932
 933
 934
 935
 936
 937
 938
 939
 940
 941
 942
 943
 944
 945
 946
 947
 948
 949
 950
 951
 952
 953
 954
 955
 956
 957
 958
 959
 960
 961
 962
 963
 964
 965
 966
 967
 968
 969
 970
 971
 972
 973
 974
 975
 976
 977
 978
 979
 980
 981
 982
 983
 984
 985
 986
 987
 988
 989
 990
 991
 992
 993
 994
 995
 996
 997
 998
 999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
@dataclass
class VideoSegmentResource:
    res_id: str
    label: str
    segment_of: str
    segment_bounds: SegmentBounds
    title: str | None = None
    comments: list[str] = field(default_factory=list)
    descriptions: list[str] = field(default_factory=list)
    keywords: list[str] = field(default_factory=list)
    relates_to: list[str] = field(default_factory=list)
    permissions: Permissions = Permissions.PROJECT_SPECIFIC_PERMISSIONS
    migration_metadata: MigrationMetadata | None = None

    def __post_init__(self) -> None:
        _check_strings(string_to_check=self.res_id, res_id=self.res_id, field_name="Resource ID")
        _check_strings(string_to_check=self.label, res_id=self.res_id, field_name="Label")
        _check_strings(string_to_check=self.segment_of, res_id=self.res_id, field_name="isSegmentOf")

    @staticmethod
    def create_new(
        res_id: str,
        label: str,
        segment_of: str,
        segment_start: float,
        segment_end: float,
        permissions: Permissions = Permissions.PROJECT_SPECIFIC_PERMISSIONS,
    ) -> VideoSegmentResource:
        """
        Creates a new video segment resource, i.e. a time span of a MovingImageRepresentation.

        [See XML documentation for details](https://docs.dasch.swiss/latest/DSP-TOOLS/file-formats/xml-data-file/#video-segment-and-audio-segment)

        Args:
            res_id: ID of this video segment resource
            label: label of this video segment resource
            segment_of: ID of the video resource that this segment refers to (cardinality 1)
            segment_start: start of the segment in seconds (cardinality 1)
            segment_end: end of the segment in seconds (cardinality 1)
            permissions: permissions of this resource

        Returns:
            A video segment resource

        Examples:
            ```python
            video_segment = xmllib.VideoSegmentResource.create_new(
                res_id="ID",
                label="label",
                segment_of="video_resource_id",
                segment_start=1.2,
                segment_end=3.4,
            )
            ```
        """
        return VideoSegmentResource(
            res_id=res_id,
            label=label,
            segment_of=segment_of,
            segment_bounds=SegmentBounds(segment_start, segment_end, res_id),
            permissions=permissions,
        )

    def add_title(self, title: str) -> VideoSegmentResource:
        """
        Add a title to the resource.

        Args:
            title: text

        Returns:
            The original resource, with the added title

        Examples:
            ```python
            video_segment = video_segment.add_title("segment title")
            ```
        """
        if self.title:
            _warn_value_exists(old_value=self.title, new_value=title, value_field="title", res_id=self.res_id)
        self.title = title
        return self

    def add_title_optional(self, title: Any) -> VideoSegmentResource:
        """
        If the value is not empty, add it as title, otherwise return the resource unchanged.

        Args:
            title: text or empty value

        Returns:
            The original resource, with the added title

        Examples:
            ```python
            video_segment = video_segment.add_title("segment title")
            ```

            ```python
            video_segment = video_segment.add_title(None)
            ```
        """
        if is_nonempty_value(title):
            if self.title:
                _warn_value_exists(old_value=self.title, new_value=title, value_field="title", res_id=self.res_id)
            self.title = title
        return self

    def add_comment(
        self,
        text: str,
    ) -> VideoSegmentResource:
        """
        Add a comment to the resource

        Args:
            text: text

        Returns:
            The original resource, with the added comment

        Examples:
            ```python
            video_segment = video_segment.add_comment("comment text")
            ```
        """
        self.comments.append(text)
        return self

    def add_comment_multiple(
        self,
        texts: Collection[str],
    ) -> VideoSegmentResource:
        """
        Add several comments to the resource

        Args:
            texts: list of texts

        Returns:
            The original resource, with the added comments

        Examples:
            ```python
            video_segment = video_segment.add_comment_multiple(["comment 1", "comment 2"])
            ```
        """
        vals = check_and_fix_collection_input(texts, "hasComment", self.res_id)
        self.comments.extend(vals)
        return self

    def add_comment_optional(
        self,
        text: Any,
    ) -> VideoSegmentResource:
        """
        If the value is not empty, add it as comment, otherwise return the resource unchanged.

        Args:
            text: text of the comment (or empty value)

        Returns:
            The original resource, with the added comment

        Examples:
            ```python
            video_segment = video_segment.add_comment_optional("comment text")
            ```

            ```python
            video_segment = video_segment.add_comment_optional(None)
            ```
        """
        if is_nonempty_value(text):
            self.comments.append(text)
        return self

    def add_description(self, description: str) -> VideoSegmentResource:
        """
        Add a description to the resource

        Args:
            description: text

        Returns:
            The original resource, with the added description

        Examples:
            ```python
            video_segment = video_segment.add_description("description text")
            ```
        """
        self.descriptions.append(description)
        return self

    def add_description_multiple(self, descriptions: Collection[str]) -> VideoSegmentResource:
        """
        Add several descriptions to the resource

        Args:
            descriptions: list of texts

        Returns:
            The original resource, with the added descriptions

        Examples:
            ```python
            video_segment = video_segment.add_description_multiple(["description 1", "description 2"])
            ```
        """
        vals = check_and_fix_collection_input(descriptions, "description", self.res_id)
        self.descriptions.extend(vals)
        return self

    def add_description_optional(self, description: Any) -> VideoSegmentResource:
        """
        If the value is not empty, add it as description, otherwise return the resource unchanged.

        Args:
            description: text or empty value

        Returns:
            The original resource, with the added description

        Examples:
            ```python
            video_segment = video_segment.add_description_optional("description text")
            ```

            ```python
            video_segment = video_segment.add_description_optional(None)
            ```
        """
        if is_nonempty_value(description):
            self.descriptions.append(description)
        return self

    def add_keyword(self, keyword: str) -> VideoSegmentResource:
        """
        Add a keyword to the resource

        Args:
            keyword: text

        Returns:
            The original resource, with the added keyword

        Examples:
            ```python
            video_segment = video_segment.add_keyword("keyword")
            ```
        """
        self.keywords.append(keyword)
        return self

    def add_keyword_multiple(self, keywords: Collection[str]) -> VideoSegmentResource:
        """
        Add several keywords to the resource

        Args:
            keywords: list of texts

        Returns:
            The original resource, with the added keywords

        Examples:
            ```python
            video_segment = video_segment.add_keyword_multiple(["keyword 1", "keyword 2"])
            ```
        """
        vals = check_and_fix_collection_input(keywords, "keywords", self.res_id)
        self.keywords.extend(vals)
        return self

    def add_keyword_optional(self, keyword: Any) -> VideoSegmentResource:
        """
        If the value is not empty, add it as keyword, otherwise return the resource unchanged.

        Args:
            keyword: text or empty value

        Returns:
            The original resource, with the added keyword

        Examples:
            ```python
            video_segment = video_segment.add_keyword_optional("keyword")
            ```

            ```python
            video_segment = video_segment.add_keyword_optional(None)
            ```
        """
        if is_nonempty_value(keyword):
            self.keywords.append(keyword)
        return self

    def add_relates_to(self, relates_to: str) -> VideoSegmentResource:
        """
        Add a link to a related resource

        Args:
            relates_to: ID of the related resource

        Returns:
            The original resource, with the added related resource

        Examples:
            ```python
            video_segment = video_segment.add_relates_to("target_resource_id")
            ```
        """
        self.relates_to.append(relates_to)
        return self

    def add_relates_to_multiple(self, relates_to: Collection[str]) -> VideoSegmentResource:
        """
        Add several links to related resources

        Args:
            relates_to: list of IDs of the related resources

        Returns:
            The original resource, with the added related resources

        Examples:
            ```python
            video_segment = video_segment.add_relates_to_multiple(["target_resource_id_1", "target_resource_id_2"])
            ```
        """
        vals = check_and_fix_collection_input(relates_to, "relatesTo", self.res_id)
        self.relates_to.extend(vals)
        return self

    def add_relates_to_optional(self, relates_to: Any) -> VideoSegmentResource:
        """
        If the value is not empty, add it as related resource, otherwise return the resource unchanged.

        Args:
            relates_to: ID or the related resource or empty value

        Returns:
            The original resource, with the added related resources

        Examples:
            ```python
            video_segment = video_segment.add_relates_to_optional("target_resource_id")
            ```

            ```python
            video_segment = video_segment.add_relates_to_optional(None)
            ```
        """
        if is_nonempty_value(relates_to):
            self.relates_to.append(relates_to)
        return self

    def add_migration_metadata(
        self, creation_date: str | None, iri: str | None = None, ark: str | None = None
    ) -> VideoSegmentResource:
        """
        Add metadata from a SALSAH migration.

        Args:
            creation_date: creation date of the resource in SALSAH
            iri: Original IRI in SALSAH
            ark: Original ARK in SALSAH

        Raises:
            InputError: if metadata already exists

        Returns:
            The original resource, with the added metadata

        Examples:
            ```python
            video_segment = video_segment.add_migration_metadata(
                iri="http://rdfh.ch/4123/DiAmYQzQSzC7cdTo6OJMYA",
                creation_date="1999-12-31T23:59:59.9999999+01:00"
            )
            ```
        """
        if self.migration_metadata:
            raise InputError(
                f"The resource with the ID '{self.res_id}' already contains migration metadata, "
                f"no new data can be added."
            )
        self.migration_metadata = MigrationMetadata(creation_date=creation_date, iri=iri, ark=ark, res_id=self.res_id)
        return self

create_new

Creates a new video segment resource, i.e. a time span of a MovingImageRepresentation.

See XML documentation for details

Parameters:

Name Type Description Default
res_id str

ID of this video segment resource

required
label str

label of this video segment resource

required
segment_of str

ID of the video resource that this segment refers to (cardinality 1)

required
segment_start float

start of the segment in seconds (cardinality 1)

required
segment_end float

end of the segment in seconds (cardinality 1)

required
permissions Permissions

permissions of this resource

PROJECT_SPECIFIC_PERMISSIONS

Returns:

Type Description
VideoSegmentResource

A video segment resource

Examples:

video_segment = xmllib.VideoSegmentResource.create_new(
    res_id="ID",
    label="label",
    segment_of="video_resource_id",
    segment_start=1.2,
    segment_end=3.4,
)
Source code in dsp/dsp-tools/src/dsp_tools/xmllib/models/dsp_base_resources.py
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
@staticmethod
def create_new(
    res_id: str,
    label: str,
    segment_of: str,
    segment_start: float,
    segment_end: float,
    permissions: Permissions = Permissions.PROJECT_SPECIFIC_PERMISSIONS,
) -> VideoSegmentResource:
    """
    Creates a new video segment resource, i.e. a time span of a MovingImageRepresentation.

    [See XML documentation for details](https://docs.dasch.swiss/latest/DSP-TOOLS/file-formats/xml-data-file/#video-segment-and-audio-segment)

    Args:
        res_id: ID of this video segment resource
        label: label of this video segment resource
        segment_of: ID of the video resource that this segment refers to (cardinality 1)
        segment_start: start of the segment in seconds (cardinality 1)
        segment_end: end of the segment in seconds (cardinality 1)
        permissions: permissions of this resource

    Returns:
        A video segment resource

    Examples:
        ```python
        video_segment = xmllib.VideoSegmentResource.create_new(
            res_id="ID",
            label="label",
            segment_of="video_resource_id",
            segment_start=1.2,
            segment_end=3.4,
        )
        ```
    """
    return VideoSegmentResource(
        res_id=res_id,
        label=label,
        segment_of=segment_of,
        segment_bounds=SegmentBounds(segment_start, segment_end, res_id),
        permissions=permissions,
    )

add_title

Add a title to the resource.

Parameters:

Name Type Description Default
title str

text

required

Returns:

Type Description
VideoSegmentResource

The original resource, with the added title

Examples:

video_segment = video_segment.add_title("segment title")
Source code in dsp/dsp-tools/src/dsp_tools/xmllib/models/dsp_base_resources.py
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
def add_title(self, title: str) -> VideoSegmentResource:
    """
    Add a title to the resource.

    Args:
        title: text

    Returns:
        The original resource, with the added title

    Examples:
        ```python
        video_segment = video_segment.add_title("segment title")
        ```
    """
    if self.title:
        _warn_value_exists(old_value=self.title, new_value=title, value_field="title", res_id=self.res_id)
    self.title = title
    return self

add_title_optional

If the value is not empty, add it as title, otherwise return the resource unchanged.

Parameters:

Name Type Description Default
title Any

text or empty value

required

Returns:

Type Description
VideoSegmentResource

The original resource, with the added title

Examples:

video_segment = video_segment.add_title("segment title")
video_segment = video_segment.add_title(None)
Source code in dsp/dsp-tools/src/dsp_tools/xmllib/models/dsp_base_resources.py
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
def add_title_optional(self, title: Any) -> VideoSegmentResource:
    """
    If the value is not empty, add it as title, otherwise return the resource unchanged.

    Args:
        title: text or empty value

    Returns:
        The original resource, with the added title

    Examples:
        ```python
        video_segment = video_segment.add_title("segment title")
        ```

        ```python
        video_segment = video_segment.add_title(None)
        ```
    """
    if is_nonempty_value(title):
        if self.title:
            _warn_value_exists(old_value=self.title, new_value=title, value_field="title", res_id=self.res_id)
        self.title = title
    return self

add_comment

Add a comment to the resource

Parameters:

Name Type Description Default
text str

text

required

Returns:

Type Description
VideoSegmentResource

The original resource, with the added comment

Examples:

video_segment = video_segment.add_comment("comment text")
Source code in dsp/dsp-tools/src/dsp_tools/xmllib/models/dsp_base_resources.py
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
def add_comment(
    self,
    text: str,
) -> VideoSegmentResource:
    """
    Add a comment to the resource

    Args:
        text: text

    Returns:
        The original resource, with the added comment

    Examples:
        ```python
        video_segment = video_segment.add_comment("comment text")
        ```
    """
    self.comments.append(text)
    return self

add_comment_multiple

Add several comments to the resource

Parameters:

Name Type Description Default
texts Collection[str]

list of texts

required

Returns:

Type Description
VideoSegmentResource

The original resource, with the added comments

Examples:

video_segment = video_segment.add_comment_multiple(["comment 1", "comment 2"])
Source code in dsp/dsp-tools/src/dsp_tools/xmllib/models/dsp_base_resources.py
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
def add_comment_multiple(
    self,
    texts: Collection[str],
) -> VideoSegmentResource:
    """
    Add several comments to the resource

    Args:
        texts: list of texts

    Returns:
        The original resource, with the added comments

    Examples:
        ```python
        video_segment = video_segment.add_comment_multiple(["comment 1", "comment 2"])
        ```
    """
    vals = check_and_fix_collection_input(texts, "hasComment", self.res_id)
    self.comments.extend(vals)
    return self

add_comment_optional

If the value is not empty, add it as comment, otherwise return the resource unchanged.

Parameters:

Name Type Description Default
text Any

text of the comment (or empty value)

required

Returns:

Type Description
VideoSegmentResource

The original resource, with the added comment

Examples:

video_segment = video_segment.add_comment_optional("comment text")
video_segment = video_segment.add_comment_optional(None)
Source code in dsp/dsp-tools/src/dsp_tools/xmllib/models/dsp_base_resources.py
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
def add_comment_optional(
    self,
    text: Any,
) -> VideoSegmentResource:
    """
    If the value is not empty, add it as comment, otherwise return the resource unchanged.

    Args:
        text: text of the comment (or empty value)

    Returns:
        The original resource, with the added comment

    Examples:
        ```python
        video_segment = video_segment.add_comment_optional("comment text")
        ```

        ```python
        video_segment = video_segment.add_comment_optional(None)
        ```
    """
    if is_nonempty_value(text):
        self.comments.append(text)
    return self

add_description

Add a description to the resource

Parameters:

Name Type Description Default
description str

text

required

Returns:

Type Description
VideoSegmentResource

The original resource, with the added description

Examples:

video_segment = video_segment.add_description("description text")
Source code in dsp/dsp-tools/src/dsp_tools/xmllib/models/dsp_base_resources.py
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
def add_description(self, description: str) -> VideoSegmentResource:
    """
    Add a description to the resource

    Args:
        description: text

    Returns:
        The original resource, with the added description

    Examples:
        ```python
        video_segment = video_segment.add_description("description text")
        ```
    """
    self.descriptions.append(description)
    return self

add_description_multiple

Add several descriptions to the resource

Parameters:

Name Type Description Default
descriptions Collection[str]

list of texts

required

Returns:

Type Description
VideoSegmentResource

The original resource, with the added descriptions

Examples:

video_segment = video_segment.add_description_multiple(["description 1", "description 2"])
Source code in dsp/dsp-tools/src/dsp_tools/xmllib/models/dsp_base_resources.py
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
def add_description_multiple(self, descriptions: Collection[str]) -> VideoSegmentResource:
    """
    Add several descriptions to the resource

    Args:
        descriptions: list of texts

    Returns:
        The original resource, with the added descriptions

    Examples:
        ```python
        video_segment = video_segment.add_description_multiple(["description 1", "description 2"])
        ```
    """
    vals = check_and_fix_collection_input(descriptions, "description", self.res_id)
    self.descriptions.extend(vals)
    return self

add_description_optional

If the value is not empty, add it as description, otherwise return the resource unchanged.

Parameters:

Name Type Description Default
description Any

text or empty value

required

Returns:

Type Description
VideoSegmentResource

The original resource, with the added description

Examples:

video_segment = video_segment.add_description_optional("description text")
video_segment = video_segment.add_description_optional(None)
Source code in dsp/dsp-tools/src/dsp_tools/xmllib/models/dsp_base_resources.py
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
def add_description_optional(self, description: Any) -> VideoSegmentResource:
    """
    If the value is not empty, add it as description, otherwise return the resource unchanged.

    Args:
        description: text or empty value

    Returns:
        The original resource, with the added description

    Examples:
        ```python
        video_segment = video_segment.add_description_optional("description text")
        ```

        ```python
        video_segment = video_segment.add_description_optional(None)
        ```
    """
    if is_nonempty_value(description):
        self.descriptions.append(description)
    return self

add_keyword

Add a keyword to the resource

Parameters:

Name Type Description Default
keyword str

text

required

Returns:

Type Description
VideoSegmentResource

The original resource, with the added keyword

Examples:

video_segment = video_segment.add_keyword("keyword")
Source code in dsp/dsp-tools/src/dsp_tools/xmllib/models/dsp_base_resources.py
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
def add_keyword(self, keyword: str) -> VideoSegmentResource:
    """
    Add a keyword to the resource

    Args:
        keyword: text

    Returns:
        The original resource, with the added keyword

    Examples:
        ```python
        video_segment = video_segment.add_keyword("keyword")
        ```
    """
    self.keywords.append(keyword)
    return self

add_keyword_multiple

Add several keywords to the resource

Parameters:

Name Type Description Default
keywords Collection[str]

list of texts

required

Returns:

Type Description
VideoSegmentResource

The original resource, with the added keywords

Examples:

video_segment = video_segment.add_keyword_multiple(["keyword 1", "keyword 2"])
Source code in dsp/dsp-tools/src/dsp_tools/xmllib/models/dsp_base_resources.py
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
def add_keyword_multiple(self, keywords: Collection[str]) -> VideoSegmentResource:
    """
    Add several keywords to the resource

    Args:
        keywords: list of texts

    Returns:
        The original resource, with the added keywords

    Examples:
        ```python
        video_segment = video_segment.add_keyword_multiple(["keyword 1", "keyword 2"])
        ```
    """
    vals = check_and_fix_collection_input(keywords, "keywords", self.res_id)
    self.keywords.extend(vals)
    return self

add_keyword_optional

If the value is not empty, add it as keyword, otherwise return the resource unchanged.

Parameters:

Name Type Description Default
keyword Any

text or empty value

required

Returns:

Type Description
VideoSegmentResource

The original resource, with the added keyword

Examples:

video_segment = video_segment.add_keyword_optional("keyword")
video_segment = video_segment.add_keyword_optional(None)
Source code in dsp/dsp-tools/src/dsp_tools/xmllib/models/dsp_base_resources.py
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
def add_keyword_optional(self, keyword: Any) -> VideoSegmentResource:
    """
    If the value is not empty, add it as keyword, otherwise return the resource unchanged.

    Args:
        keyword: text or empty value

    Returns:
        The original resource, with the added keyword

    Examples:
        ```python
        video_segment = video_segment.add_keyword_optional("keyword")
        ```

        ```python
        video_segment = video_segment.add_keyword_optional(None)
        ```
    """
    if is_nonempty_value(keyword):
        self.keywords.append(keyword)
    return self

add_relates_to

Add a link to a related resource

Parameters:

Name Type Description Default
relates_to str

ID of the related resource

required

Returns:

Type Description
VideoSegmentResource

The original resource, with the added related resource

Examples:

video_segment = video_segment.add_relates_to("target_resource_id")
Source code in dsp/dsp-tools/src/dsp_tools/xmllib/models/dsp_base_resources.py
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
def add_relates_to(self, relates_to: str) -> VideoSegmentResource:
    """
    Add a link to a related resource

    Args:
        relates_to: ID of the related resource

    Returns:
        The original resource, with the added related resource

    Examples:
        ```python
        video_segment = video_segment.add_relates_to("target_resource_id")
        ```
    """
    self.relates_to.append(relates_to)
    return self

add_relates_to_multiple

Add several links to related resources

Parameters:

Name Type Description Default
relates_to Collection[str]

list of IDs of the related resources

required

Returns:

Type Description
VideoSegmentResource

The original resource, with the added related resources

Examples:

video_segment = video_segment.add_relates_to_multiple(["target_resource_id_1", "target_resource_id_2"])
Source code in dsp/dsp-tools/src/dsp_tools/xmllib/models/dsp_base_resources.py
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
def add_relates_to_multiple(self, relates_to: Collection[str]) -> VideoSegmentResource:
    """
    Add several links to related resources

    Args:
        relates_to: list of IDs of the related resources

    Returns:
        The original resource, with the added related resources

    Examples:
        ```python
        video_segment = video_segment.add_relates_to_multiple(["target_resource_id_1", "target_resource_id_2"])
        ```
    """
    vals = check_and_fix_collection_input(relates_to, "relatesTo", self.res_id)
    self.relates_to.extend(vals)
    return self

add_relates_to_optional

If the value is not empty, add it as related resource, otherwise return the resource unchanged.

Parameters:

Name Type Description Default
relates_to Any

ID or the related resource or empty value

required

Returns:

Type Description
VideoSegmentResource

The original resource, with the added related resources

Examples:

video_segment = video_segment.add_relates_to_optional("target_resource_id")
video_segment = video_segment.add_relates_to_optional(None)
Source code in dsp/dsp-tools/src/dsp_tools/xmllib/models/dsp_base_resources.py
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
def add_relates_to_optional(self, relates_to: Any) -> VideoSegmentResource:
    """
    If the value is not empty, add it as related resource, otherwise return the resource unchanged.

    Args:
        relates_to: ID or the related resource or empty value

    Returns:
        The original resource, with the added related resources

    Examples:
        ```python
        video_segment = video_segment.add_relates_to_optional("target_resource_id")
        ```

        ```python
        video_segment = video_segment.add_relates_to_optional(None)
        ```
    """
    if is_nonempty_value(relates_to):
        self.relates_to.append(relates_to)
    return self

add_migration_metadata

Add metadata from a SALSAH migration.

Parameters:

Name Type Description Default
creation_date str | None

creation date of the resource in SALSAH

required
iri str | None

Original IRI in SALSAH

None
ark str | None

Original ARK in SALSAH

None

Returns:

Type Description
VideoSegmentResource

The original resource, with the added metadata

Examples:

video_segment = video_segment.add_migration_metadata(
    iri="http://rdfh.ch/4123/DiAmYQzQSzC7cdTo6OJMYA",
    creation_date="1999-12-31T23:59:59.9999999+01:00"
)
Source code in dsp/dsp-tools/src/dsp_tools/xmllib/models/dsp_base_resources.py
 992
 993
 994
 995
 996
 997
 998
 999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
def add_migration_metadata(
    self, creation_date: str | None, iri: str | None = None, ark: str | None = None
) -> VideoSegmentResource:
    """
    Add metadata from a SALSAH migration.

    Args:
        creation_date: creation date of the resource in SALSAH
        iri: Original IRI in SALSAH
        ark: Original ARK in SALSAH

    Raises:
        InputError: if metadata already exists

    Returns:
        The original resource, with the added metadata

    Examples:
        ```python
        video_segment = video_segment.add_migration_metadata(
            iri="http://rdfh.ch/4123/DiAmYQzQSzC7cdTo6OJMYA",
            creation_date="1999-12-31T23:59:59.9999999+01:00"
        )
        ```
    """
    if self.migration_metadata:
        raise InputError(
            f"The resource with the ID '{self.res_id}' already contains migration metadata, "
            f"no new data can be added."
        )
    self.migration_metadata = MigrationMetadata(creation_date=creation_date, iri=iri, ark=ark, res_id=self.res_id)
    return self