Back to bricks list
Introduction Version

Resource set

RESOURCE
Typing name :  RESOURCE.gws_core.ResourceSet Brick :  gws_core

A set of resources

Resource to manage a set of resources. By default the sytem create a new resource for each resource in the set when saving the set

Views

RESOURCES LISTDefault view
List the resources
VIEW RESOURCE
View the complete resource as json

Attributes

name: strstyle: TypingStyletags: TagListtechnical_info: TechnicalInfoDictuid: str

Functions

__INIT__

Constructor, please do not overwrite this method, use the init method instead Leave the constructor without parameters.

ADD_RESOURCE

Add a resource to the set

can be retrieve by calling the get_resource method with the name. If not provided, the resource name is used Otherwise it doesn't create a new resource but references it. In this case the resource must be an input of the task that created the ResourceSet and the resource must have been saved before, defaults to True

Parameters:
NameTypeDefault valueDescription
resourceResource Resource to add
unique_namestr Name used to store the resource in the dict. it must be unique. the resource
create_new_resourcebool True If true, a new resource is created when saving the resource. , optional
ADD_TECHNICAL_INFO

Add technical information on the resource. Technical info are useful to set additional information on the resource.

Parameters:
NameTypeDefault valueDescription
technical_infoTechnicalInfo Technical information to add (key, value)
CHECK_RESOURCE

You can redefine this method to define custom logic to check this resource. If there is a problem with the resource, return a string that define the error, otherwise return None This method is called on output resources of a task. If there is an error returned, the task will be set to error and next proceses will not be run. It is also call when uploading a resource (usually for files or folder), if there is an error returned, the resource will not be uploaded

Return type:
Optional
CLEAR_RESOURCES

Clear the resources

CLONE

Clone the resource to create a new instance with a new id. It copies the RFields.

Return type:
ResourceType
GET_DEFAULT_NAME

You can redefine this method to set a name of the resource. When saving the resource the name will be saved automatically This can be useful to distinguish this resource from another one or to search for the resource

Return type:
str
GET_MODEL_ID

Get the id of the resource model in the database. It is provided by the system for input resources of a task.

Return type:
str
GET_NAME_OR_DEFAULT

Get the name of the resource or the default name if the name is None

Return type:
str
GET_RESOURCE

Return the resource with the given name

:raises Exception: if the resource with the given name is not found

Parameters:
NameTypeDefault valueDescription
resource_namestr Name of the resource
Return type:
Resource
GET_RESOURCE_MODEL_IDS

Return the resource model ids of the sub resources

Return type:
Set
GET_RESOURCE_MODELS

Return the resource models of the sub resources list

Return type:
List[ResourceModel]
GET_RESOURCE_OR_NONE

Return the resource with the given name or None if not found

Parameters:
NameTypeDefault valueDescription
resource_namestr Name of the resource
Return type:
gws_core.resource.resource.Resource | None
GET_RESOURCES

Return the sub resources as a dict

Return type:
Dict
GET_RESOURCES_AS_SET

Return the sub resources as a set

Return type:
Set
GET_TECHNICAL_INFO

Get the technical information of the resource

Parameters:
NameTypeDefault valueDescription
keystr Key of the technical information
Return type:
TechnicalInfo
HAS_RESOURCE_MODEL

Return true if the resource with the given id is in the resource list

Parameters:
NameTypeDefault valueDescription
resource_model_idstr Id of the resourcemodel
Return type:
bool
INIT

This can be overwritten to perform custom initialization of the resource. This method is called after the init (constructor) of the resource. The values of RFields are set when this method is called.

REPLACE_RESOURCES_BY_MODEL_ID

Replace current resources by the resources in the dict

Parameters:
NameTypeDefault valueDescription
resourcesDict Dict where key is the resource model id and value is the resource [str, resource]
RESOURCE_EXISTS

Return true if the resource with the given name exists in the dict

Parameters:
NameTypeDefault valueDescription
resource_namestr Name of the resource
Return type:
Resource
CLASSNAME - @classmethod

Returns the name of the class

Parameters:
NameTypeDefault valueDescription
slugifybool False True to slugify the class name if true, defaults to false , optional
snakefybool False True to snakefy the class name if true, defaults to false , optional
replace_uppercasebool False Replace upper cases by "-" if true, defaults to false , optional
Return type:
str
COPY_STYLE - @classmethod

Copy the style of the resource with the possibility to override some properties. Useful when settings the style for a task based on the resource style.

Parameters:
NameTypeDefault valueDescription
icon_technical_namestr Technical name of the icon if provided, the icon_type must also be provided, defaults to none , optional
icon_typeTypingIconType Type of the icon if provided, the icon_technical_name must also be provided, defaults to none , optional
background_colorstr Background color, defaults to none , optional
icon_colorTypingIconColor Icon color, defaults to none , optional
Return type:
TypingStyle
DECORATED_METHOD_NAMES - @classmethod
Parameters:
NameTypeDefault valueDescription
decorator_nameAny
FULL_CLASSNAME - @classmethod

Returns the full name of the class

Parameters:
NameTypeDefault valueDescription
slugifybool False Slugify the returned class name if true, defaults to false , optional
snakefybool False Snakefy the returned class name if true, defaults to false ``
Return type:
str
GET_HUMAN_NAME - @classmethod

Get the human name of the resource

Return type:
str
GET_SHORT_DESCRIPTION - @classmethod

Get the short description of the resource

Return type:
str
GET_TYPING_NAME - @classmethod

Get the typing name of the resource

Return type:
str
INHERITORS - @classmethod

Get all the classes that inherit this class

Return type:
List
METHOD_NAMES - @classmethod

Returns the list of the methods

Return type:
List
MODULE_NAME - @classmethod

Returns the module name of the class

Return type:
str
PROPERTY_METHOD_NAMES - @classmethod
PROPERTY_NAMES - @classmethod

Retrieves the property names

Parameters:
NameTypeDefault valueDescription
instancetype The s of the properties to retrieve. set `none` to retrieve all. `type` or `union[type]`
excludetype
Return type:
List