nomenclator.utilities

nomenclator.utilities.fetch_next_version(path, pattern, token_mapping)

Fetch next version from scene files saved in path.

Parameters:

• path – Path to fetch scene files from.
• pattern – Pattern to compare scene files with.
• token_mapping – Mapping regrouping resolved token values associated with their name.

Returns:

version integer.

nomenclator.utilities.fetch_version(scene_path, pattern, token_mapping)

Fetch version from scene path.

Parameters:

• scene_path – Path to the scene file to analyze.
• pattern – Pattern to compare scene file with.
• token_mapping – Mapping regrouping resolved token values associated with their name.

Returns:

version integer, or None if no version is found.

nomenclator.utilities.fetch_template_config(path, template_configs, token_mapping)

Return template configuration compatible with path.

Incoming token mapping will be mutated with new token values extracted from matching template configuration.

Parameters:

• path – Path to extract template configuration from.
• template_configs – List of available TemplateConfig instances
• token_mapping – Mapping regrouping resolved token values associated with their name. It will be updated with new token found.

Returns:

TemplateConfig Instance or None.

nomenclator.utilities.fetch_output_template_config(path, template_configs)

Return output template configuration compatible with path.

Incoming token mapping will be mutated with new token values extracted from matching template configuration.

Parameters:

• path – Path to extract template configuration from.
• template_configs – List of available OutputTemplateConfig instances

Returns:

OutputTemplateConfig Instance or None.

nomenclator.utilities.fetch_nodes()

Fetch all available output nodes in the graph with all node names.

Returns:tuple with a list of output nodes and a list all available node names.

nomenclator.utilities.fetch_recent_comp_paths(max_values=10)

Return list of paths recently used to save a composition.

Parameters:max_values – Maximum number of recent composition paths to return Returns:List of recent composition paths.

nomenclator.utilities.fetch_recent_project_paths(max_values=10)

Return list of paths recently used to save a project.

Parameters:max_values – Maximum number of recent composition paths to return Returns:List of recent composition paths.

nomenclator.utilities.fetch_paddings(max_value=5)

Return all available paddings if notation requested.

Parameters:max_value – Maximum padding number to use. Returns:List of available paddings.

nomenclator.utilities.fetch_current_comp_path()

Return current composition path.

Returns:Path to current ‘nk’ file or empty string.

nomenclator.utilities.fetch_current_project_path()

Return current project path.

Returns:Path to current ‘hrox’ file or empty string.

nomenclator.utilities.fetch_output_path(node)

Return output path from node.

Parameters:node – nuke.Node instance. Returns:Output path.

nomenclator.utilities.fetch_colorspace(node, alias_mapping)

Return colorspace value from node.

Parameters:

• node – nuke.Node instance.
• alias_mapping – Mapping containing alias to replace some values.

Returns:

Colorspace value, or “none” if node does not have a ‘colorspace’ knob.

nomenclator.utilities.fetch_file_type(node, default_value)

Return file type from node.

Parameters:

• node – nuke.Node instance.
• default_value – Default value to return if no file type is set.

Returns:

File type value.

nomenclator.utilities.fetch_file_types(node)

Return list of available file types for node.

Parameters:node – nuke.Node instance. Returns:Tuple containing all available file types.

nomenclator.utilities.has_multiple_views(node)

Indicate whether node is configured with multiple views.

Parameters:node – nuke.Node instance. Returns:Boolean value.

nomenclator.utilities.is_enabled(node)

Indicate whether node is enabled in the graph.

Parameters:node – nuke.Node instance. Returns:Boolean value.

nomenclator.utilities.save_comp(context)

Save comp with path from context.

nomenclator.utilities.save_project(context)

Save project with path from context.

nomenclator.utilities.update_nodes(context)

Update nodes in graph from context.