artellapipe.core.artellalib module

Utility module that contains useful utilities and classes related with Artella

class artellapipe.core.artellalib.AbstractArtella

Bases: object

Class that is used by non supported Artella DCCs (such as Houdini) to interface with official Artella python module

static getCmsUri(broken_path)

artellapipe.core.artellalib.artella

alias of artellapipe.core.artellalib.AbstractArtella

artellapipe.core.artellalib.can_unlock(file_path)

Returns whether given path can be unlocked or not by current user :param file_path: str :return: bool

artellapipe.core.artellalib.check_artella_plugin_loaded()

Returns True if the Artella plugin is loaded in Maya or False otherwise :return: bool

artellapipe.core.artellalib.close_all_artella_app_processes(console)

Closes all Artella app (lifecycler.exe) processes :return:

artellapipe.core.artellalib.connect_artella_app_to_spigot(cli=None, app_identifier=None)

Creates a new Spigot Client instance and makes it to listen to our current installed (and launched) Artella app

artellapipe.core.artellalib.create_asset(asset_name, asset_path)

Creates an asset with given name and in given path :param asset_name: str :param asset_path: str :return: dict

artellapipe.core.artellalib.delete_file(file_path)

Removes given file from Artella server :param file_path: str :return: dict

artellapipe.core.artellalib.explore_file(path)

Opens the current file in the file explorer :param path: str

artellapipe.core.artellalib.fix_path_by_project(project, path, fullpath=False)

Fix given path and updates to make it relative to the Artella project :param project: ArtellaProject :param path: str, path to be fixed :return: str

artellapipe.core.artellalib.get_artella_app()

Returns path where Artella path is installed :return: str

artellapipe.core.artellalib.get_artella_app_identifier()

Returns the installed Artella App identifier :return: variant, str || None

artellapipe.core.artellalib.get_artella_data_folder()

Returns last version Artella folder installation :return: str

artellapipe.core.artellalib.get_artella_dcc_plugin(dcc='maya')

Gets Artella DCC plugin depending of the given dcc string :param dcc: str, “maya” or “nuke” :return: str

artellapipe.core.artellalib.get_artella_launch_shortcut()

Returns path where Launch Artella shortcut is located :return: str

artellapipe.core.artellalib.get_artella_plugins_folder()

Returns folder where Artella stores its plugins :return: str

artellapipe.core.artellalib.get_artella_program_folder()

Returns folder where Artella shortcuts are located :return: str

artellapipe.core.artellalib.get_artella_python_folder()

Returns folder where Artella stores Python scripts :return: str

artellapipe.core.artellalib.get_asset_history(file_path, as_json=False)

Returns the history info of the given file, if exists :param file_path: str

artellapipe.core.artellalib.get_asset_image(asset_path, project_id)

Returns the asset image from Artella server :param asset_path: str, path of the asset relative to the Assets folder :param project_id: str, ID of the Artella project you are currently working :return:

artellapipe.core.artellalib.get_asset_version(name)

Returns the version of a specific given asset (model_v001, return [v001, 001, 1]) :param name: str :return: list(str, int, int)

artellapipe.core.artellalib.get_cms_uri(path)

Returns the CMS uri of the given path, if exists :param path: str :return: dict

artellapipe.core.artellalib.get_cms_uri_current_file()

Returns the CMS uri of the current file :return: str

artellapipe.core.artellalib.get_current_user_id()

Returns Artella ID of the current user :return: str

artellapipe.core.artellalib.get_dependencies(file_path)

Returns a list with all the dependencies :param file_path: str :return: dict

artellapipe.core.artellalib.get_file_current_working_version(file_path)

Returns current working version of the given file in Artella server :param file_path: str :return: int

artellapipe.core.artellalib.get_metadata()

Returns Artella App MetaData :return: ArtellaMetaData

artellapipe.core.artellalib.get_spigot_client(app_identifier=None)

Creates, connects and returns an instance of the Spigot client :return: SpigotClient

artellapipe.core.artellalib.get_status(file_path, as_json=False, max_tries=10)

Returns the status of the given file path :param file_path: str :return: str

artellapipe.core.artellalib.get_status_current_file()

Returns the status of the current file :return:

artellapipe.core.artellalib.get_user_avatar(user_id)

Downloads from Artella the avatar of the given user id Only works if the user is loaded before to Artella :param user_id: str :return:

artellapipe.core.artellalib.import_file_in_maya(file_path, maya_version=None)

Import the given asset path in the given Maya version current scene :param file_path: str :param maya_version: int

artellapipe.core.artellalib.is_locked(file_path)

Returns whether an absolute file path refers to a locked asset in edit mode, and if the file is locked by the current storage workspace :param file_path: str, absolute path to a file :return: bool, bool

artellapipe.core.artellalib.is_published(file_path)

Returns whether an absolute file path refers to a published asset :param file_path: str, absolute path to a file :return: bool

artellapipe.core.artellalib.launch_artella_app()

Executes Artella App

artellapipe.core.artellalib.launch_maya(file_path, maya_version=None)

Parameters

• file_path – str

• maya_version – int

Returns

artellapipe.core.artellalib.load_artella_maya_plugin()

Loads the Artella plugin in the current Maya session :return: bool

artellapipe.core.artellalib.lock_file(file_path=None, force=False)

Locks given file path :param file_path: str :param force: bool

artellapipe.core.artellalib.new_folder(root_path, folder_name)

Creates a new folder in the given path :param root_path: str :param folder_name: str

artellapipe.core.artellalib.open_file_in_maya(file_path, maya_version=None)

Open the given path in the given Maya version :param file_path: str :param maya_version: int

artellapipe.core.artellalib.publish_asset(asset_path, comment, selected_versions, version_name)

Publish a new version of the given asset :param asset_path: :param comment: :param selected_versions: :param version_name:

artellapipe.core.artellalib.reference_file_in_maya(file_path, maya_version=None)

Import the given asset path in the given Maya version current scene :param file_path: str :param maya_version: int

artellapipe.core.artellalib.rename_file(file_path, new_name)

Renames given file with new given name :param file_path: str :param new_name: str

artellapipe.core.artellalib.synchronize_file(file_path)

Synchronize the specific given file, if exists :param file_path: str :return:

artellapipe.core.artellalib.synchronize_path(path)

Synchronize all the content of the given path, if exists :param path: str

artellapipe.core.artellalib.synchronize_path_with_folders(file_path, recursive=False)

Synchronizes given path and all its folders :param file_path: str :param recursive: bool :return:

artellapipe.core.artellalib.unlock_file(file_path)

Unlocks a given file path :param file_path:

artellapipe.core.artellalib.update_artella_paths()

Updates system path to add artella paths if they are not already added :return:

artellapipe.core.artellalib.update_local_artella_root()

Updates the environment variable that stores the Artella Local Path NOTE: This is done by Artella plugin when is loaded, so we should not do it manually again

artellapipe.core.artellalib.upload_file(file_path, comment)

Uploads a new version of the given file to Artella server :param file_path: str :param comment: str

artellapipe.core.artellalib.upload_new_asset_version(file_path=None, comment='Published new version with Artella Pipeline', skip_saving=False)

Adds a new file to the Artella server :param file_path: :param comment: :param skip_saving: When we publish textures we do not want to save the maya scene

artellapipe.core.artellalib.within_artella_scene()

Returns True if the current Maya scene corresponds to a Artella Maya scene :return: bool