TROMPA CE client¶
The TROMPA CE client is a Python library that can be used to read data from and write data to the TROMPA Contributor Environment using its GraphQL interface.
Installation¶
To install the package, use pip:
pip install trompace-client
For information about the TROMPA schema, see TROMPA Schema
Mutations¶
Mutations are queries used to create or update data in the CE.
AudioObject¶
-
trompace.mutations.audioobject.
mutation_create_audioobject
(*, title: str, contributor: str, creator: str, source: str, format_: str, name: str = None, description: str = None, date: str = None, encodingformat: str = None, embedurl: str = None, url: str = None, contenturl: str = None, language: str = None, inlanguage: str = None, license: str = None, subject: str = None)¶ Returns a mutation for creating a AudioObject.
- Parameters
name – The name of the audio object.
description – An account of the audio object.
date – The date associated with the audio object.
creator – The person, organization or service who created the thing the web resource is about.
contributor – A person, an organization, or a service responsible for contributing the audio object to the web resource. This can be either a name or a base URL.
format_ – A MimeType of the format of the page describing the audio object.
encodingformat – A MimeType of the format of object encoded by the audio object.
source – The URL of the web resource about this audio object. If no such resource is available, use the same value as contentUrl.
subject – The subject of the audio object.
contenturl – The URL of the content encoded by the audio object.
url –
license –
language – The language the metadata is written in. Currently supported languages are en,es,ca,nl,de,fr
inlanguage – The language of the audio object.
title – The title of the resource indicated by source
- Returns
The string for the mutation for creating the AudioObject.
- Raises
UnsupportedLanguageException if the input language is not one of the supported languages. –
ValueError if a required argument is None –
-
trompace.mutations.audioobject.
mutation_delete_audioobject
(identifier: str)¶ Returns a mutation for deleting a AudioObject based on the identifier.
- Parameters
identifier – The unique identifier of the AudioObject.
- Returns
The string for the mutation for deleting the AudioObject based on the identifier.
-
trompace.mutations.audioobject.
mutation_merge_audioobject_encoding
(audioobject_identifier: str, audiobject_derivative_identifier: str)¶ Returns a mutation for indicating that a derivative AudioObject encodes a primary AudioObject (https://schema.org/encoding). For example a transcription of a score is an encoding of that score.
- Parameters
audiobject_identifier – The unique identifier of the “main” AudioObject.
audiobject_derivative_identifier – The unique identifier of the AudioObject which is the encoding.
- Returns
A GraphQL mutation for MergeAudioObjectEncoding.
-
trompace.mutations.audioobject.
mutation_merge_audioobject_exampleofwork
(audioobject_identifier: str, work_identifier: str)¶ Returns a mutation for indicating that a AudioObject is an example of a work (https://schema.org/exampleOfWork).
- Parameters
audioobject_identifier – The unique identifier of the AudioObject.
work_identifier – The unique identifier of the work that the AudioObject is an example of.
- Returns
A GraphQL mutation for MergeAudioObjectExampleOfWork.
-
trompace.mutations.audioobject.
mutation_remove_audioobject_encoding
(audioobject_identifier: str, audiobject_derivative_identifier: str)¶ Returns a mutation for removing that a derivative AudioObject encodes a primary AudioObject (https://schema.org/encoding). For example a transcription of a score is an encoding of that score.
- Parameters
audiobject_identifier – The unique identifier of the “main” AudioObject.
audiobject_derivative_identifier – The unique identifier of the AudioObject which is the encoding.
- Returns
A GraphQL mutation for RemoveAudioObjectEncoding.
-
trompace.mutations.audioobject.
mutation_remove_audioobject_exampleofwork
(audioobject_identifier: str, work_identifier: str)¶ Returns a mutation for removing that a AudioObject is an example of a work (https://schema.org/exampleOfWork).
- Parameters
audio_object_identifier – The unique identifier of the AudioObject.
work_identifier – The unique identifier of the work that the AudioObject is an example of.
- Returns
A GraphQL mutation for RemoveAudioObjectExampleOfWork.
-
trompace.mutations.audioobject.
mutation_update_audioobject
(identifier: str, *, name: str = None, title: str = None, description: str = None, date: str = None, creator: str = None, contributor: str = None, format_: str = None, encodingformat: str = None, source: str = None, license: str = None, subject: str = None, contenturl: str = None, language: str = None, inlanguage: str = None)¶ Returns a mutation for updating a AudioObject.
- Parameters
identifier – The identifier of the AudioObject in the CE to be updated.
name – The name of the audio object.
description – An account of the audio object.
date – The date associated with the audio object.
creator – The person, organization or service who created the thing the web resource is about.
contributor – A person, an organization, or a service responsible for contributing the audio object to the web resource. This can be either a name or a base URL.
format_ – A MimeType of the format of the page describing the audio object.
encodingformat – A MimeType of the format of object encoded by the audio object.
source – The URL of the web resource about this audio object. If no such resource is available, use the same value as contentUrl.
subject – The subject of the audio object.
contenturl – The URL of the content encoded by the audio object.
url –
license –
language – The language the metadata is written in. Currently supported languages are en,es,ca,nl,de,fr
inlanguage – The language of the audio object.
title – The title of the resource indicated by source
- Returns
The string for the mutation for updating the AudioObject.
- Raises
Assertion error if the input language or inlanguage is not one of the supported languages. –
ControlAction¶
-
trompace.mutations.controlaction.
mutation_add_actioninterface_result
(controlaction_id: str, thing_interface_id: str)¶ Returns a mutation for linking a control action object and a thing interface with the result relation :param controlaction_id: The unique identifier of the control action. :param thing_interface_id: the unique identifier of a thing interface object
- Returns
The string for the mutation for adding a control action to an object.
-
trompace.mutations.controlaction.
mutation_add_controlaction_additionalproperty
(controlaction_id: str, property_id: str)¶ Returns a mutation for adding a control action to a property value specification. :param controlaction_id: The unique identifier of the control action. :param property_id: The unique identifier of the property.
- Returns
The string for the mutation foradding a control action to a property.
-
trompace.mutations.controlaction.
mutation_add_controlaction_object
(controlaction_id: str, object_id: str)¶ Returns a mutation for adding a control action to an object, either a property value specification or a property :param controlaction_id: The unique identifier of the control action. :param object_id: The unique identifier of the object (property / property value specification).
- Returns
The string for the mutation for adding a control action to an object.
-
trompace.mutations.controlaction.
mutation_add_entrypoint_controlaction
(entrypoint_id: str, controlaction_id: str)¶ Returns a mutation for adding an entry point object to a control action :param entrypoint_id: The unique identifier of the entry point. :param controlaction_id: The unique identifier of the control action.
- Returns
The string for the mutation for adding an entry point object to a control action
-
trompace.mutations.controlaction.
mutation_add_propertyvaluespecification_potentialaction
(propertyvaluespecification_id: str, controlaction_id: str)¶ Returns a mutation for adding a control action to a property value specification. :param controlaction_id: The unique identifier of the control action. :param propertyvaluespecification_id: The unique identifier of the property value specification.
- Returns
The string for the mutation foradding a control action to a property value specification.
-
trompace.mutations.controlaction.
mutation_create_controlaction
(name: str, actionstatus: trompace.constants.ActionStatusType = <ActionStatusType.PotentialActionStatus: 4>, description: str = None)¶ Returns a mutation for creating a ControlAction. If an action status is not set, defaults to a PotentialActionStatus :param name: The name of the ControlAction. :param description: An account of the ControlAction. :param actionstatus: The status of the ControlAction.
- Returns
The string for the mutation for creating the ControlAction object.
-
trompace.mutations.controlaction.
mutation_modify_controlaction
(controlaction_id: str, actionstatus: trompace.constants.ActionStatusType, error: str = None)¶ Returns a mutation for modifying the status and errors of the ControlAction :param controlaction_id: The unique identifier of the ControlAction. :param actionstatus: the status to update to. :param error: An error to set if the actionstatus is FailedActionStatus
- Returns
The string for the mutation for modifying a ControlAction.
-
trompace.mutations.controlaction.
mutation_request_controlaction
(controlaction_id: str, entrypoint_id: str, properties: list, propertyValues: list)¶ - Returns a mutation for requesting a control action
controlaction_id: The unique identifier of the control action. entrypoint_id: The unique identifier of the entry point linked to this control action properties: a list of the properties objects of the control action propertyValues: a list of the properties objects of the control action
- Returns
The string for the mutation for requesting a control action.
-
trompace.mutations.controlaction.
mutation_update_controlaction_status
(controlaction_id: str, action_status: trompace.constants.ActionStatusType)¶ Returns a mutation for updating the status of a control action to an object :param controlaction_id: The unique identifier of the control action. :param action_status: the action status enum object.
- Returns
The string for the mutation for adding a control action to an object.
DefinedTerm¶
-
trompace.mutations.definedterm.
create_defined_term
(*, creator: str, termcode: str, additionaltype: List[str], broader_url: str = None, broader_schema: trompace.mutations.annotation.AnnotationSchemaMotivation = None, image: str = None)¶ Return a mutation for making a DefinedTerm. A DefinedTerm (https://schema.org/DefinedTerm) is a word, name, acronym, phrase, etc. with a formal definition. It is part of a DefinedTermSet.
- Parameters
creator – a URI to the identity of the user who created this DefinedTerm
termcode – The name of this term
additionaltype – A list of schema.org additionalTypes used to categorise this DefinedTerm
broader_url (optional) – a type to be related with skos:broader
broader_schema (optional) – an annotation motivation to be related with skos:broader
image (optional) – an image to describe this DefinedTerm
- Returns
A GraphQL Mutation to create a DefinedTerm in the Trompa CE
-
trompace.mutations.definedterm.
create_defined_term_set
(*, creator: str, name: str, additionaltype: List[str], image: str = None)¶ Return a mutation for making a DefinedTermSet. A DefinedTermSet (https://schema.org/DefinedTermSet) is a group of defined terms, e.g. categories or labels.
- Parameters
creator – a URI to the identity of the user who created this DefinedTermSet
name – the name of this DefinedTermSet
additionaltype – A list of schema.org additionalTypes used to categorise this DefinedTermSet
image (optional) – an image to describe this DefinedTermSet
- Returns
A GraphQL Mutation to create a DefinedTermSet in the Trompa CE
-
trompace.mutations.definedterm.
defined_term_add_to_defined_term_set
(*, defined_term_set: str, defined_term: str)¶ Return a mutation for adding a DefinedTerm to a DefinedTermSet.
- Parameters
defined_term_set – The identifier of the DefinedTermSet to add to
defined_term – The identifier of the DefinedTermSet to add
- Returns
A GraphQL Mutation to add a DefinedTerm to the DefinedTermSet
-
trompace.mutations.definedterm.
delete_defined_term
(identifier: str)¶ Return a mutation for deleting a DefinedTermSet.
- Parameters
identifier – The identifier of the DefinedTerm to delete
- Returns
A GraphQL Mutation to delete a DefinedTerm from the Trompa CE
-
trompace.mutations.definedterm.
delete_defined_term_set
(identifier: str)¶ Return a mutation for deleting a DefinedTermSet.
- Parameters
identifier – The identifier of the DefinedTermSet to delete
- Returns
A GraphQL Mutation to delete a DefinedTermSet from the Trompa CE
-
trompace.mutations.definedterm.
update_defined_term
(identifier: str, *, creator: str = None, termcode: str = None, additionaltype: List[str] = None, broader_url: str = None, broader_schema: trompace.mutations.annotation.AnnotationSchemaMotivation = None, image: str = None)¶ Return a mutation for updating a DefinedTerm.
TODO: Copy arguments from create_
- Returns
A GraphQL Mutation to update a DefinedTerm in the Trompa CE
-
trompace.mutations.definedterm.
update_defined_term_set
(identifier: str, *, creator: str = None, name: str = None, additionaltype: List[str] = None, image: str = None)¶ Return a mutation for updating a DefinedTermSet.
TODO: Copy arguments from create_
- Returns
A GraphQL Mutation to update a DefinedTermSet in the Trompa CE
DigitalDocument¶
-
trompace.mutations.digitaldocument.
mutation_create_digitaldocument
(*, title: str, contributor: str, creator: str, source: str, format_: str, subject: str = None, language: str = None, description: str = None)¶ Returns a mutation for creating a digital document object.
- Parameters
title – The title of the resource indicated by source
contributor – The main URL of the site where the information about this DigitalDocument was taken from
creator – The person, organization or service who is creating this DigitalDocument (e.g. URL of the software)
source – The URL of the web resource where information about this DigitalDocument is taken from
format_ – The mimetype of the resource indicated by source
subject (optional) – The subject of the music composition.
language (optional) – The language the metadata is written in. Currently supported languages are en,es,ca,nl,de,fr
description (optional) – A description about the item referred to by source.
- Returns
The string for the mutation for creating the digital document.
- Raises
UnsupportedLanguageException if the input language is not one of the supported languages. –
NotAMimeTypeException – if
format_
is not a valid mimetype.
-
trompace.mutations.digitaldocument.
mutation_delete_digitaldocument
(identifier: str)¶ Returns a mutation for deleting a digital document object based on the identifier.
- Parameters
identifier – The unique identifier of the digital document object.
- Returns
The string for the mutation for deleting the digital document object based on the identifier.
-
trompace.mutations.digitaldocument.
mutation_update_digitaldocument
(identifier: str, *, title: str = None, contributor: str = None, creator: str = None, source: str = None, format_: str = None, subject: str = None, language: str = None, description: str = None)¶ Returns a mutation for updating a digital document object.
- Parameters
identifier – The identifier of the media object in the CE to be updated.
title – The title of the resource indicated by source
contributor – The main URL of the site where the information about this DigitalDocument was taken from
creator – The person, organization or service who is creating this DigitalDocument (e.g. URL of the software)
source – The URL of the web resource where information about this DigitalDocument is taken from
format_ – The mimetype of the resource indicated by source
subject (optional) – The subject of the music composition.
language (optional) – The language the metadata is written in. Currently supported languages are en,es,ca,nl,de,fr
description (optional) – A description about the item referred to by source.
- Returns
The string for the mutation for creating the artist.
- Raises
Assertion error if the input language is not one of the supported languages. –
EntryPoint¶
-
trompace.mutations.entrypoint.
mutation_create_entry_point
(*, name: str, contributor: str, subject: str, creator: str, source: str, language: str, actionPlatform: str, contentType: List, encodingType: list, formatin='text/html', identifier=None, description: str = None)¶ Returns a mutation for creating an entry point object :param name: The name of the entry point. :param contributor: A person, an organization, or a service responsible for contributing the aentry point to the web resource. This can be either a name or a base URL. :param creator: The person, organization or service who created the thing the entry point is about. :param source: The URL of the web resource to be represented by the node. :param description: An account of the entry point.. :param language: The language the metadata is written in. Currently supported languages are en,es,ca,nl,de,fr. :param actionPlatform: The action platform. :param contentType: The content type associated with the entry point, should be a mimetype. :param encodingType: The encoding type associated with the entry point, should be a mimetype.
- Returns
The string for the mutation for creating the artist.
- Raises
Assertion error if the input language is not one of the supported languages. –
ItemList¶
-
trompace.mutations.itemlist.
mutation_add_itemlist_itemlist_element
(itemlist_id: str, element_id: str)¶ Returns a mutation for adding a ThingInterface in an ItemList object based on the identifier. (https://schema.org/itemListElement)
- Parameters
itemlist_id – The unique identifier of the ItemList object.
element_id – The unique identifier of the ThingInterface object.
- Returns
The string for the mutation for adding an ThingInterface in an ItemList object based on the identifier,
-
trompace.mutations.itemlist.
mutation_add_listitem_item
(listitem_id: str, item_id: str)¶ Returns a mutation for adding an Item to a ListItem object based on the identifier. (https://schema.org/item)
- Parameters
listitem_id – The unique identifier of the ListItem object.
item_id – The unique identifier of the Item object.
- Returns
The string for the mutation for adding a Item to a ListItem object
based on the identifier.
-
trompace.mutations.itemlist.
mutation_add_listitem_nextitem
(listitem_id: str, nextitem_id: str)¶ Returns a mutation for adding a NextItem to a ListItem object based on the identifier. (https://schema.org/nextItem)
- Parameters
listitem_id – The unique identifier of the ListItem object.
nextitem_id – The unique identifier of the NextItem object.
- Returns
The string for the mutation for adding a NextItem to a ListItem object
based on the identifier.
-
trompace.mutations.itemlist.
mutation_create_itemlist
(name: str, creator: str, itemlistorder: trompace.constants.ItemListOrderType = <ItemListOrderType.ItemListUnordered: 3>, description: str = None, contributor: str = None, additionaltype: List[str] = None)¶ Returns a mutation for creating an ItemList object. (https://schema.org/ItemList)
- Parameters
name – The name of the ItemList object.
creator – The person, organization or service who created the ItemList.
itemlistorder – The type of ordering for the list (ascending, descending, unordered, ordered)
contributor (optional) – A person, an organization, or a service responsible for contributing the ItemList to the web resource. This can be either a name or a base URL.
description (optional) – The description of the ItemList object
additionaltype (optional) – A list of schema.org additionalTypes used to categorise this ItemList
- Returns
The string for the mutation for creating the ItemList.
-
trompace.mutations.itemlist.
mutation_create_listitem
(creator: str, name: str = None, contributor: str = None, description: str = None, itemurl: str = None, position: Optional[int] = None)¶ Returns a mutation for creating a ListItem object. (https://schema.org/ListItem)
- Parameters
name – The name of the ListItem object.
creator – The person, organization or service who created the ListItem.
contributor – A person, an organization, or a service responsible for contributing the ListItem to the web resource. This can be either a name or a base URL.
description – The description of the ListItem object
itemurl – If the item of this ListItem points to a URL outside of the CE, the item URL
position – the position of the ListItem
- Returns
The string for the mutation for creating the ListItem.
-
trompace.mutations.itemlist.
mutation_delete_itemlist
(identifier: str)¶ Returns a mutation for deleting an ItemList object based on the identifier. (https://schema.org/ItemList)
- Parameters
identifier – The unique identifier of the ItemList object.
- Returns
The string for the mutation for deleting the ItemList object based on the identifier.
-
trompace.mutations.itemlist.
mutation_delete_listitem
(identifier: str)¶ Returns a mutation for deleting a ListItem object based on the identifier. (https://schema.org/ListItem)
- Parameters
identifier – The unique identifier of the ListItem object.
- Returns
The string for the mutation for deleting the ListItem object based on the identifier.
-
trompace.mutations.itemlist.
mutation_remove_itemlist_itemlist_element
(itemlist_id: str, element_id: str)¶ Returns a mutation for removing a ThingInterface from an ItemList object based on the identifier. (https://schema.org/itemListElement)
- Parameters
itemlist_id – The unique identifier of the ItemList object.
element_id – The unique identifier of the ThingInterface object.
- Returns
The string for the mutation for removing an ThingInterface from an ItemList object based on the identifier.
-
trompace.mutations.itemlist.
mutation_remove_listitem_item
(listitem_id: str, item_id: str)¶ Returns a mutation for removing a Item from a ListItem object based on the identifier. (https://schema.org/item)
- Parameters
listitem_id – The unique identifier of the ListItem object.
item_id – The unique identifier of the Item object.
- Returns
The string for the mutation for removing a Item from a ListItem
object based on the identifier.
-
trompace.mutations.itemlist.
mutation_remove_listitem_nextitem
(listitem_id: str, nextitem_id: str)¶ Returns a mutation for removing a NextItem from a ListItem object based on the identifier. (https://schema.org/nextItem)
- Parameters
listitem_id – The unique identifier of the ListItem object.
nextitem_id – The unique identifier of the NextItem object.
- Returns
The string for the mutation for removing a NextItem from a ListItem
object based on the identifier.
-
trompace.mutations.itemlist.
mutation_sequence_add_itemlist_itemlist_element
(itemlist_id: str, element_ids: list)¶ Returns a mutation for adding a sequence of ThingInterface in an ItemList object based on the identifiers. (https://schema.org/itemListElement)
- Parameters
itemlist_id – The unique identifier of the ItemList object.
element_ids – The list of unique identifiers of the ThingInterface objects.
- Returns
The string for the mutation for adding a sequence of ThingInterface in an ItemList object based on the identifiers.
-
trompace.mutations.itemlist.
mutation_sequence_add_listitem_item
(listitem_ids: list, item_ids: list)¶ Returns a mutation for adding a sequence of ThingInterface in an ListItem objects based on the identifiers. (https://schema.org/itemListElement)
- Parameters
listitem_ids – The list of unique identifiers of the ListItem objects.
item_ids – The list of unique identifiers of the ThingInterface objects.
- Returns
The string for the mutation for adding a sequence of ThingInterface in an
ListItem objects based on the identifiers.
-
trompace.mutations.itemlist.
mutation_sequence_add_listitem_nextitem
(listitem_ids: list)¶ Returns a mutation for adding a sequence of NextItem to an ListItem objects based on the identifiers. (https://schema.org/itemListElement)
- Parameters
listitem_ids – The list of unique identifier of the ListItems objects.
- Returns
The string for the mutation for adding a sequence of NextItem to an
ListItem objects based on the identifiers.
-
trompace.mutations.itemlist.
mutation_sequence_create_listitem
(listitems: list, contributor: str, creator: str = None, name: str = None, description: list = None)¶ Returns a mutation for creating a sequence of ListItem objects (https://schema.org/itemListElement)
- Parameters
listitems – the ListItems objects to create
creator – The person, organization or service who created the items.
contributor – A person, an organization, or a service responsible for contributing the ListItem to the web resource. This can be either a name or a base URL.
name – The name of the ListItem object.
- Returns
The string for the mutation for creating a sequence of ListItem objects
-
trompace.mutations.itemlist.
mutation_update_itemlist
(identifier: str, name: str = None, creator: str = None, itemlistorder: trompace.constants.ItemListOrderType = None, description: str = None, contributor: str = None, additionaltype: List[str] = None)¶ Returns a mutation for updating an ItemList object. (https://schema.org/ItemList)
- Parameters
identifier – The identifier of the ItemList in the CE to be updated.
name – The name of the ItemList object.
creator – The person, organization or service who created the ItemList.
itemlistorder – The type of ordering for the list (ascending, descending, unordered, ordered)
contributor (optional) – A person, an organization, or a service responsible for contributing the ItemList to the web resource. This can be either a name or a base URL.
description (optional) – The description of the ItemList object
additionaltype (optional) – A list of schema.org additionalTypes used to categorise this ItemList
- Returns
The string for the mutation for updating the ItemList.
-
trompace.mutations.itemlist.
mutation_update_listitem
(identifier: str, creator: str = None, name: str = None, contributor: str = None, description: str = None, itemurl: str = None, position: int = None)¶ Returns a mutation for updating a ListItem object. (https://schema.org/ListItem)
- Parameters
identifier – The identifier of the ListItem in the CE to be updated.
name – The name of the ListItem object.
creator – The person, organization or service who created the ListItem.
contributor – A person, an organization, or a service responsible for contributing the ListItem to the web resource. This can be either a name or a base URL.
description – The description of the ListItem object
itemurl – If the item of this ListItem points to a URL outside of the CE, the item URL
position – the position of the ListItem
- Returns
The string for the mutation for updating the ListItem.
MediaObject¶
-
trompace.mutations.mediaobject.
mutation_add_media_object_used
(mediaobject_identifier: str, thing_identifier: str)¶ Returns a mutation for indicating that a MediaObject used some other thing to create it (http://www.w3.org/ns/prov#used). For example an MEI file coverted from musicxml might use the verovio software.
- Parameters
mediaobject_identifier – The unique identifier of a MediaObject.
thing_identifier – The unique identifier of some Thing that was used to create the MediaObject.
- Returns
A GraphQL mutation for MergeMediaObjectUsed.
-
trompace.mutations.mediaobject.
mutation_create_media_object
(*, title: str, contributor: str, creator: str, source: str, format_: str, name: str = None, description: str = None, date: str = None, encodingformat: str = None, embedurl: str = None, url: str = None, contenturl: str = None, language: str = None, inlanguage: str = None, license: str = None)¶ Returns a mutation for creating a media object object.
- Parameters
name – The name of the media object.
description – An account of the media object.
date – The date associated with the media object.
creator – The person, organization or service who created the thing the web resource is about.
contributor – A person, an organization, or a service responsible for contributing the media object to the web resource. This can be either a name or a base URL.
format_ – A MimeType of the format of the page describing the media object.
encodingformat – A MimeType of the format of object encoded by the media object.
source – The URL of the web resource about this media object. If no such resource is available, use the same value as contentUrl.
subject – The subject of the media object.
contenturl – The URL of the content encoded by the media object.
url –
license –
language – The language the metadata is written in. Currently supported languages are en,es,ca,nl,de,fr
inLanguage – The language of the media object.
title – The title of the resource indicated by source
- Returns
The string for the mutation for creating the media object.
- Raises
UnsupportedLanguageException if the input language is not one of the supported languages. –
-
trompace.mutations.mediaobject.
mutation_delete_media_object
(identifier: str)¶ Returns a mutation for deleting a media object object based on the identifier.
- Parameters
identifier – The unique identifier of the media object object.
- Returns
The string for the mutation for deleting the media object object based on the identifier.
-
trompace.mutations.mediaobject.
mutation_merge_media_object_encoding
(mediaobject_identifier: str, mediaobject_derivative_identifier: str)¶ Returns a mutation for indicating that a derivative MediaObject encodes a primary MediaObject (https://schema.org/encoding). For example a transcription of a score is an encoding of that score.
- Parameters
mediaobject_identifier – The unique identifier of the “main” MediaObject.
mediaobject_derivative_identifier – The unique identifier of the MediaObject which is the encoding.
- Returns
A GraphQL mutation for MergeMediaObjectEncoding.
-
trompace.mutations.mediaobject.
mutation_merge_media_object_wasderivedfrom
(mediaobject_derivative_identifier: str, mediaobject_source_identifier: str)¶ Returns a mutation for indicating that a MediaObject was derived from a primary MediaObject (http://www.w3.org/ns/prov#wasDerivedFrom). For example a PDF generated from a MusicXML source file was derived from that source file.
- Parameters
mediaobject_derivative_identifier – The unique identifier of the MediaObject which is the derivative.
mediaobject_source_identifier – The unique identifier of the “source” MediaObject.
- Returns
A GraphQL mutation for MergeMediaObjectWasDerivedFrom.
-
trompace.mutations.mediaobject.
mutation_merge_mediaobject_example_of_work
(mediaobject_identifier: str, work_identifier: str)¶ Returns a mutation for indicating that a MediaObject is an example of a work (https://schema.org/exampleOfWork).
- Parameters
mediaobject_identifier – The unique identifier of the media object.
work_identifier – The unique identifier of the work that the media object is an example of.
- Returns
A GraphQL mutation for MergeMediaObjectExampleOfWork.
-
trompace.mutations.mediaobject.
mutation_remove_media_object_encoding
(mediaobject_identifier: str, mediaobject_derivative_identifier: str)¶ Returns a mutation for removing that a derivative MediaObject encodes a primary MediaObject (https://schema.org/encoding).
- Parameters
mediaobject_identifier – The unique identifier of the “main” MediaObject.
mediaobject_derivative_identifier – The unique identifier of the MediaObject which is the encoding.
- Returns
A GraphQL mutation for RemoveMediaObjectEncoding.
-
trompace.mutations.mediaobject.
mutation_remove_media_object_wasderivedfrom
(mediaobject_derivative_identifier: str, mediaobject_source_identifier: str)¶ Returns a mutation for removing that a MediaObject was derived from a primary MediaObject (http://www.w3.org/ns/prov#wasDerivedFrom).
- Parameters
mediaobject_derivative_identifier – The unique identifier of the MediaObject which is the derivative.
mediaobject_source_identifier – The unique identifier of the “source” MediaObject.
- Returns
A GraphQL mutation for RemoveMediaObjectWasDerivedFrom.
-
trompace.mutations.mediaobject.
mutation_remove_mediaobject_example_of_work
(mediaobject_identifier: str, work_identifier: str)¶ Returns a mutation for removing that a MediaObject is an example of a work (https://schema.org/exampleOfWork).
- Parameters
mediaobject_identifier – The unique identifier of the media object.
work_identifier – The unique identifier of the work that the media object is an example of.
- Returns
A GraphQL mutation for RemoveMediaObjectExampleOfWork.
-
trompace.mutations.mediaobject.
mutation_update_media_object
(identifier: str, *, name: str = None, title: str = None, description: str = None, date: str = None, creator: str = None, contributor: str = None, format_: str = None, encodingformat: str = None, source: str = None, license: str = None, subject: str = None, url: str = None, contenturl: str = None, language: str = None, inlanguage: str = None)¶ Returns a mutation for updating a media object object.
- Parameters
identifier – The identifier of the media object in the CE to be updated.
name – The name of the media object.
description – An account of the media object.
date – The date associated with the media object.
creator – The person, organization or service who created the thing the web resource is about.
contributor – A person, an organization, or a service responsible for contributing the media object to the web resource. This can be either a name or a base URL.
format_ – A MimeType of the format of the page describing the media object.
encodingformat – A MimeType of the format of object encoded by the media object.
source – The URL of the web resource about this media object. If no such resource is available, use the same value as contentUrl.
subject – The subject of the media object.
contenturl – The URL of the content encoded by the media object.
url –
license –
language – The language the metadata is written in. Currently supported languages are en,es,ca,nl,de,fr
inLanguage – The language of the media object.
title – The title of the resource indicated by source
- Returns
The string for the mutation for updating the media object.
- Raises
Assertion error if the input language or inLanguage is not one of the supported languages. –
MusicComposition¶
-
trompace.mutations.musiccomposition.
mutation_create_music_composition
(*, title: str, contributor: str, creator: str, source: str, format_: str, subject: str = None, language: str = None, inlanguage: str = None, name: str = None, description: str = None, position: int = None)¶ Returns a mutation for creating a music composition object
- Parameters
title – The title of the resource indicated by source
contributor – The main URL of the site where the information about this MusicComposition was taken from
creator – The person, organization or service who is creating this MusicComposition (e.g. URL of the software)
source – The URL of the web resource where information about this MusicComposition is taken from
format_ – The mimetype of the resource indicated by source
subject – The subject of the music composition.
language – The language the metadata is written in. Currently supported languages are en,es,ca,nl,de,fr
inlanguage – The language of the music composition.
name – The name of the music composition.
description – An account of the music composition.
position – In the case that this is a movement of a larger work (e.g. a Symphony), the position of this MusicComposition in the larger one.
- Returns
The string for the mutation for creating the music composition.
- Raises
UnsupportedLanguageException – if
language
is not one of the supported languages.NotAMimeTypeException – if
format_
is not a valid mimetype
-
trompace.mutations.musiccomposition.
mutation_delete_music_composition
(identifier: str)¶ Returns a mutation for deleting a MusicComposition.
- Parameters
identifier – The identifier of the MusicComposition.
- Returns
The string for the mutation for deleting the music composition object based on the identifier.
-
trompace.mutations.musiccomposition.
mutation_merge_music_composition_composer
(composition_identifier, person_identifier)¶ Returns a mutation for adding a Person as the composer of a MusicComposition (https://schema.org/composer).
- Parameters
composition_identifier – The identifier of a MusicComposition.
person_identifier – The identifier of a Person who composed the MusicComposition.
-
trompace.mutations.musiccomposition.
mutation_merge_music_composition_exact_match
(from_identifier, to_identifier)¶ Returns a mutation for indicating that two MusicComposition objects represent the same composition (http://www.w3.org/2004/02/skos/core#exactMatch).
- Parameters
from_identifier – The identifier of one MusicComposition.
to_identifier – The identifier of another MusicComposition.
-
trompace.mutations.musiccomposition.
mutation_merge_music_composition_has_part
(main_identifier, part_identifier)¶ Returns a mutation for adding a MusicComposition as a part of another MusicComposition (https://schema.org/hasPart). For example, the first movement of a composition could be represented as a hasPart of a main symphony.
- Parameters
main_identifier – The identifier of a main MusicComposition.
part_identifier – The identifier of a MusicComposition which is a part of the main MusicComposition.
-
trompace.mutations.musiccomposition.
mutation_merge_music_composition_included_composition
(main_identifier, part_identifier)¶ Returns a mutation for adding a MusicComposition as an included composition of another MusicComposition (https://schema.org/includedComposition). For example, the first movement of a composition could be represented as an includedComposition of a main symphony.
- Parameters
main_identifier – The identifier of a main MusicComposition.
part_identifier – The identifier of a MusicComposition which is an included part of the main MusicComposition.
-
trompace.mutations.musiccomposition.
mutation_merge_music_composition_recorded_as
(music_composition_id: str, music_recording_id: str)¶ Returns a mutation for adding a MusicRecording as an recording of a MusicComposition (https://schema.org/recordedAs).
- Parameters
music_composition_id – The identifier of a MusicComposition.
music_recording_id – The identifier of a MusicRecording which is a recording of the MusicComposition.
-
trompace.mutations.musiccomposition.
mutation_merge_music_composition_work_example
(music_composition_id: str, creativework_id: str)¶ Returns a mutation for adding a CreativeWork as an example of a MusicComposition (https://schema.org/workExample).
- Parameters
music_composition_id – The identifier of a MusicComposition.
creativework_id – The identifier of a CreativeWork which is an example of the MusicComposition.
-
trompace.mutations.musiccomposition.
mutation_remove_music_composition_composer
(composition_identifier, person_identifier)¶ Returns a mutation for removing a Person as the composer of a MusicComposition (https://schema.org/composer).
- Parameters
composition_identifier – The identifier of a MusicComposition.
person_identifier – The identifier of a Person who composed the MusicComposition.
-
trompace.mutations.musiccomposition.
mutation_remove_music_composition_exact_match
(from_identifier, to_identifier)¶ Returns a mutation for removing two MusicComposition representing the same composition (http://www.w3.org/2004/02/skos/core#exactMatch).
- Parameters
from_identifier – The identifier of one MusicComposition.
to_identifier – The identifier of another MusicComposition.
-
trompace.mutations.musiccomposition.
mutation_remove_music_composition_has_part
(main_identifier, part_identifier)¶ Returns a mutation for removing a MusicComposition as a part of another MusicComposition (https://schema.org/hasPart).
- Parameters
main_identifier – The identifier of a main MusicComposition.
part_identifier – The identifier of a MusicComposition which is a part of the main MusicComposition.
-
trompace.mutations.musiccomposition.
mutation_remove_music_composition_included_composition
(main_identifier, part_identifier)¶ Returns a mutation for removing a MusicComposition as an included composition of another MusicComposition (https://schema.org/includedComposition).
- Parameters
main_identifier – The identifier of a main MusicComposition.
part_identifier – The identifier of a MusicComposition which is an included part of the main MusicComposition.
-
trompace.mutations.musiccomposition.
mutation_remove_music_composition_recorded_as
(music_composition_id: str, music_recording_id: str)¶ Returns a mutation for removing a MusicRecording as a recording of a MusicComposition. (https://schema.org/recordedAs).
- Parameters
music_composition_id – The identifier of a MusicComposition.
music_recording_id – The identifier of a MusicRecording which is a recording of the MusicComposition.
-
trompace.mutations.musiccomposition.
mutation_remove_music_composition_work_example
(music_composition_id: str, creativework_id: str)¶ Returns a mutation for removing a CreativeWork as an example of a MusicComposition (https://schema.org/workExample).
- Parameters
music_composition_id – The identifier of a MusicComposition.
creativework_id – The identifier of a CreativeWork which is an example of the MusicComposition.
-
trompace.mutations.musiccomposition.
mutation_update_music_composition
(identifier: str, *, title: str = None, contributor: str = None, creator: str = None, source: str = None, format_: str = None, subject: str = None, language: str = None, inlanguage: str = None, name: str = None, description: str = None, position: int = None)¶ Returns a mutation for updating a MusicComposition object.
- Parameters
identifier – The identifier of the MusicComposition in the CE to be updated
title – The title of the resource indicated by source
contributor – The main URL of the site where the information about this MusicComposition was taken from
creator – The person, organization or service who is creating this MusicComposition (e.g. URL of the software)
source – The URL of the web resource where information about this MusicComposition is taken from
format_ – The mimetype of the resource indicated by source
subject – The subject of the music composition.
language – The language the metadata is written in. Currently supported languages are en,es,ca,nl,de,fr
inlanguage – The language of the music composition.
name – The name of the music composition.
description – An account of the music composition.
position – In the case that this is a movement of a larger work (e.g. a Symphony), the position of this MusicComposition in the larger one.
- Returns
The string for the mutation for updating the music composition.
- Raises
UnsupportedLanguageException – if
language
is not one of the supported languages.NotAMimeTypeException – if
format_
is not a valid mimetype
Person¶
A Person
objects represents a web resource about a person. For example, this could be a composer or performer.
We recommend that the following fields are set:
field |
required |
Description |
---|---|---|
yes |
The title of the resource indicated by |
|
contributor |
yes |
The main URL of the site where the information about this Person was taken from |
creator |
yes |
The person, organization or service who is creating this Person (e.g. URL of the software) |
source |
yes |
The URL of the web resource where information about this Person is taken from |
language |
yes |
The language the metadata is written in. Currently supported languages are en,es,ca,nl,de,fr |
format_ |
yes |
The mimetype of the resource indicated by source |
name |
yes |
The name of the person |
family_name |
The family name of the person |
|
given_name |
The given name of the person |
|
gender |
The person’s gender |
|
birth_date |
The birth date of the person, formatted as yyyy, yyyy-mm or yyyy-mm-dd |
|
death_date |
The date of death of the person , formatted as yyyy, yyyy-mm or yyyy-mm-dd |
|
description |
A biographical description of the person |
|
image |
URL to an image associated with the person |
|
publisher |
An entity responsible for making the resource available |
|
honorific_prefix |
An honorific prefix |
|
honorific_suffix |
An honorific suffix |
|
job_title |
The person’s job title |
Relations¶
exactMatch: Use trompace.mutations.person.mutation_person_add_exact_match_person()
-
trompace.mutations.person.
mutation_create_person
(*, title: str, contributor: str, creator: str, source: str, format_: str, language: str = None, name: str = None, family_name: str = None, given_name: str = None, gender: str = None, birth_date: str = None, death_date: str = None, description: str = None, image: str = None, publisher: str = None, honorific_prefix: str = None, honorific_suffix: str = None, job_title: str = None)¶ Returns a mutation for creating a Person
- Parameters
title – The title of the resource indicated by source
contributor – The main URL of the site where the information about this Person was taken from
creator – The person, organization or service who is creating this Person (e.g. URL of the software)
source – The URL of the web resource where information about this Person is taken from
language – The language the metadata is written in. Currently supported languages are en,es,ca,nl,de,fr
format_ – The mimetype of the resource indicated by source
name – The name of the person
family_name (optional) – The family name of the person
given_name (optional) – The given name of the person
gender (optional) – The person’s gender
birth_date (optional) – The birth date of the person, formatted as yyyy, yyyy-mm or yyyy-mm-dd
death_date (optional) – The date of death of the person , formatted as yyyy, yyyy-mm or yyyy-mm-dd
description (optional) – A biographical description of the person
image (optional) – URL to an image associated with the person
publisher (optional) – An entity responsible for making the resource available
honorific_prefix (optional) – An honorific prefix.
honorific_suffix (optional) – An honorific suffix.
job_title (optional) – The person’s job title.
- Returns
The string for the mutation for creating the person.
- Raises
UnsupportedLanguageException – if
language
is not one of the supported languages.ValueError – if
gender
is not a value supported by the CENotAMimeTypeException – if
format_
is not a valid mimetype.
-
trompace.mutations.person.
mutation_delete_person
(identifier: str)¶ Returns a mutation for deleting a Person with the given identifier.
- Parameters
identifier – The identifier of the Person to delete.
- Returns
A mutation string to delete a Person
-
trompace.mutations.person.
mutation_person_add_exact_match_person
(identifier_from: str, identifier_to: str)¶ Returns a mutation for linking two Person objects with skos:exactMatch.
- Parameters
identifier_from – the identifer of the Person to match to
identifier_to – the identifier of the Person that is an exact match of identifier_from
Returns: a mutation to make an exactMatch relationship between the Person objects
-
trompace.mutations.person.
mutation_person_remove_exact_match_person
(identifier_from: str, identifier_to: str)¶ Returns a mutation for removing the skos:exactMatch relation between two Person objects
- Parameters
identifier_from – the identifer of the Person to match to
identifier_to – the identifier of the Person that is an exact match of identifier_from
Returns: a mutation to remove the exactMatch relationship from the Person objects
-
trompace.mutations.person.
mutation_update_person
(identifier: str, *, title: str = None, contributor: str = None, creator: str = None, source: str = None, language: str = None, format_: str = None, name: str = None, family_name: str = None, given_name: str = None, gender: str = None, birth_date: str = None, death_date: str = None, description: str = None, image: str = None, publisher: str = None, honorific_prefix: str = None, honorific_suffix: str = None, job_title: str = None)¶ Returns a mutation for updating a Person
- Parameters
identifier – The identifier of the person in the CE to be updated
title – The title of the resource indicated by source
contributor – The main URL of the site where the information about this Person was taken from
creator – The person, organization or service who is creating this Person (e.g. URL of the software)
source – The URL of the web resource where information about this Person is taken from
language – The language the metadata is written in. Currently supported languages are en,es,ca,nl,de,fr
format_ – The mimetype of the resource indicated by source
name – The name of the person
family_name (optional) – The family name of the person
given_name (optional) – The given name of the person
gender (optional) – The person’s gender
birth_date (optional) – The birth date of the person, formatted as yyyy, yyyy-mm or yyyy-mm-dd
death_date (optional) – The date of death of the person , formatted as yyyy, yyyy-mm or yyyy-mm-dd
description (optional) – A biographical description of the person
image (optional) – URL to an image associated with the person
publisher (optional) – An entity responsible for making the resource available
honorific_prefix (optional) – An honorific prefix.
honorific_suffix (optional) – An honorific suffix.
job_title (optional) – The person’s job title.
- Returns
The string for the mutation for updating the person.
- Raises
UnsupportedLanguageException – if
language
is not one of the supported languages.ValueError – if
gender
is not a value supported by the CeNotAMimeTypeException – if
format_
is not a valid mimetype.
Place¶
-
trompace.mutations.place.
mutation_create_place
(*, title: str, contributor: str, creator: str, source: str, format_: str, name: str = None, language: str = None)¶ Returns a mutation for creating a place object.
- Parameters
name – The name of the place object.
creator – The person, organization or service who created the thing the web resource is about.
contributor – A person, an organization, or a service responsible for contributing the place to the web resource. This can be either a name or a base URL.
format_ – A MimeType of the format of the page describing the place.
source – The URL of the web resource about this place.
title – The title of the resource indicated by source
- Returns
The string for the mutation for creating the place.
-
trompace.mutations.place.
mutation_delete_place
(identifier: str)¶ Returns a mutation for deleting a place object based on the identifier.
- Parameters
identifier – The unique identifier of the place object.
- Returns
The string for the mutation for deleting the place object based on the identifier.
-
trompace.mutations.place.
mutation_merge_person_birthplace
(person_identifier: str, place_identifier: str)¶ Returns a mutation for adding a place as the place of birth of a person.
- Parameters
person_identifier – The unique identifier of the person object.
place_identifier – The unique identifier of the place where the person was born.
- Returns
The string for the mutation for merging a place as the birth place of a person.
-
trompace.mutations.place.
mutation_merge_person_deathplace
(person_identifier: str, place_identifier: str)¶ Returns a mutation for adding a place as the place of death of a person.
- Parameters
person_identifier – The unique identifier of the person.
place_identifier – The unique identifier of the place where the person died.
- Returns
The string for the mutation for merging a place as the place of death of a person.
-
trompace.mutations.place.
mutation_remove_person_birthplace
(person_identifier: str, place_identifier: str)¶ Returns a mutation for removing a place as the place of birth of a person.
- Parameters
person_identifier – The unique identifier of the person object.
place_identifier – The unique identifier of the place where the person was born.
- Returns
The string for the mutation for removing a place as the birth place of a person.
-
trompace.mutations.place.
mutation_remove_person_deathplace
(person_identifier: str, place_identifier: str)¶ Returns a mutation for removing a place as the place of death of a person.
- Parameters
person_identifier – The unique identifier of the person.
place_identifier – The unique identifier of the place where the person died.
- Returns
The string for the mutation for removing a place as the place of death of a person.
-
trompace.mutations.place.
mutation_update_place
(identifier: str, *, name: str = None, title: str = None, creator: str = None, contributor: str = None, format_: str = None, source: str = None, language: str = None)¶ Returns a mutation for updating a place object.
- Parameters
identifier – The identifier of the place in the CE to be updated.
name – The name of the place object.
creator – The person, organization or service who created the thing the web resource is about.
contributor – A person, an organization, or a service responsible for contributing the place to the web resource. This can be either a name or a base URL.
format_ – A MimeType of the format of the page describing the place.
source – The URL of the web resource about this place.
title – The title of the resource indicated by source
- Returns
The string for the mutation for updating the place.
Property¶
-
trompace.mutations.property.
mutation_create_property
(title: str, name: str, rangeIncludes: List[trompace.StringConstant], description: str = None)¶ Returns a mutation for creating a property :param title: The title of the property :param name: The name of the property :param description: An account of the property :param rangeIncludes: accepts an array of possible node types for this content reference and can be used by the Component developer to limit the type of nodes (content types) that can be selected.
- Returns
The string for the mutation for creating the property.
-
trompace.mutations.property.
mutation_create_propertyvaluespecification
(name: str, defaultValue: str, valueMaxLength: int, valueMinLength: int, multipleValues: bool, valueName: str, valuePattern: str, valueRequired: bool, description: str = None)¶ Returns a mutation for creating a property value specification Each PropertyValueSpecification defines a scalar input parameter that the Component user should be prompted with when preparing the request for an algorithm process job. There are numerous properties that can be used to set requirements, type and limits for a scalar parameter. With these properties, a Component developer can set up the input field for this parameter. :param name: The name of the property value specification. :param description: An account of the property :param defaultValue: the default value to use for the property value specification. :param valueMaxLength: The maximum length of the value. :param valueMinLength: The minimum length of the value. :param multipleValues: A boolean that states if multiple values are accepted or not. :param valueName: The name of the value. :param valuePattern: The format of the value. :param valueRequired: A boolean stating if the value is required or not.
- Returns
The string for the mutation for creating the property value specification.
Rating¶
-
trompace.mutations.rating.
create_rating
(*, creator: str, bestrating: int, ratingvalue: int = None, worstrating: int = None, ratingexplanation: str = None, additionaltype: str = None)¶ Return a mutation for making a Rating. A Rating (https://schema.org/Rating) is an evaluation on a numeric scale.
- Parameters
creator – a URI to the identity of the user who created this DefinedTerm
bestrating – The highest value allowed in this rating system
ratingvalue – The rating for the content.
worstrating (optional) – The lowest value allowed in this rating system. If worstRating is omitted, 1 is assumed.
ratingexplanation (optional) – A freeform text box describing why this rating was given
additionaltype (optional) – A schema.org additionalType used to categorise this Rating
- Returns
A GraphQL Mutation to create a Rating in the Trompa CE
-
trompace.mutations.rating.
create_rating_definition
(*, creator: str, bestrating: int, worstrating: int, name: str = None)¶ Return a mutation for making a Rating definition. A Rating (https://schema.org/Rating) is an evaluation on a numeric scale. A Rating definition describes the structure that a rating can take. It is used so that an annotation tool can give a title and present an input according to the correct scale (e.g. 1-5 or 1-100).
This is a helper method that requires a bestrating and worstrating value and automatically sets additionaltype to RATING_DEFINITION_ADDITIONAL_TYPE
A name is recommended if multiple ratings are going to be shown on the same annotator, but isn’t necessary.
-
trompace.mutations.rating.
delete_rating
(identifier: str)¶ Return a mutation for deleting a Rating.
- Parameters
identifier – The identifier of the Rating to delete
- Returns
A GraphQL Mutation to delete a Rating from the Trompa CE
-
trompace.mutations.rating.
rating_add_was_derived_from_rating
(rating_id: str, original_rating_id: str)¶ Generate a mutation to link two ratings with the prov:wasDerivedFrom relation
- Parameters
rating_id – the id of the new rating
original_rating_id – the id of the original rating from which rating_id was derived
- Returns
A GraphQL Mutation for MergeRatingWasDerivedFrom
-
trompace.mutations.rating.
rating_remove_was_derived_from_rating
(rating_id: str, original_rating_id: str)¶ Generate a mutation to remove the prov:wasDerivedFrom relation between two ratings
- Parameters
rating_id – the id of the new rating
original_rating_id – the id of the original rating from which rating_id was derived
- Returns
A GraphQL Mutation for RemoveRatingWasDerivedFrom
Queries¶
Queries are used to retrieve information from the CE
Person¶
-
trompace.queries.person.
query_person
(identifier: str = None, contributor: str = None, creator: str = None, source: str = None, language: str = None, format_: str = None, name: str = None, family_name: str = None, given_name: str = None, return_items_list: list = ['identifier', 'name'])¶ Returns a query for retrieving a person or people.
- Parameters
identifier – The identifier of the person in the CE.
contributor – The main URL of the site where the information about the Person was taken from
creator – The person, organization or service who is creating this Person (e.g. URL of the software)
source – The URL of the web resource where information about this Person is taken from
language – The language the metadata is written in.
format_ – The mimetype of the resource indicated by source
name – The name of the person
family_name – The family name of the person
given_name – The given name of the person
return_items_list – A list of item fields that the query must return.
- Returns
The string for a person query.
MusicComposition¶
-
trompace.queries.musiccomposition.
query_musiccomposition
(identifier: str = None, title: str = None, contributor: str = None, creator: str = None, source: str = None, inlanguage: str = None, name: str = None, position: int = None, filter_: dict = None, return_items: Union[list, str] = None)¶ Returns a query for querying the database for a music composition. :param identifier: The identifier of the music composition in the CE. :param title: The title of the resource indicated by source :param creator: The person, organization or service who created the thing the web resource is about. :param contributor: A person, an organization, or a service responsible for contributing the music composition to the web resource. This can be either a name or a base URL. :param source: The source URL that an item comes from :param inlanguage: The language of the music composition. Currently supported languages are en,es,ca,nl,de,fr :param name: The name of the music composition. :param position: In the case that this is a movement of a larger work (e.g. a Symphony), the position of this
MusicComposition in the larger one.
- Parameters
filter_ – return nodes with this custom filter
return_items – return these items in the response
- Returns
The string for the quereing the music composition.
- Raises
UnsupportedLanguageException if the input language is not one of the supported languages. –
MediaObject¶
-
trompace.queries.mediaobject.
query_mediaobject
(identifier: str = None, creator: str = None, contributor: str = None, encodingformat: str = None, source: str = None, contenturl: str = None, inlanguage: str = None, filter_: dict = None, return_items: Union[list, str] = None)¶ Returns a query for querying the database for a media object. :param identifier: The identifier of the media object in the CE. :param creator: The person, organization or service who created the thing the web resource is about. :param contributor: A person, an organization, or a service responsible for contributing the media object to the web resource. This can be either a name or a base URL. :param encodingformat: A MimeType of the format of object encoded by the media object. :param source: The URL of the web resource to be represented by the node. :param contenturl: The URL of the content encoded by the media object. :param inlanguage: The language of the media object. Currently supported languages are en,es,ca,nl,de,fr. :param filter_: return nodes with this custom filter :param return_items: return these items in the response
- Returns
The string for the quereing the media object.
- Raises
UnsupportedLanguageException if the input language is not one of the supported languages. –
Algorithms¶
The algorithms module allows for the realtime interaction between external algorithms and the CE.