Skip to content

addon

ApplicationsAddon

Bases: AYONAddon, IPluginPaths

Source code in client/ayon_applications/addon.py
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
class ApplicationsAddon(AYONAddon, IPluginPaths):
    name = "applications"
    version = __version__

    def initialize(self, settings):
        # TODO remove when addon is removed from ayon-core
        self.enabled = self.name in settings

    def get_app_environments_for_context(
        self,
        project_name,
        folder_path,
        task_name,
        full_app_name,
        env_group=None,
        launch_type=None,
        env=None,
    ):
        """Calculate environment variables for launch context.

        Args:
            project_name (str): Project name.
            folder_path (str): Folder path.
            task_name (str): Task name.
            full_app_name (str): Full application name.
            env_group (Optional[str]): Environment group.
            launch_type (Optional[str]): Launch type.
            env (Optional[dict[str, str]]): Environment variables to update.

        Returns:
            dict[str, str]: Environment variables for context.

        """
        from ayon_applications.utils import get_app_environments_for_context

        if not full_app_name:
            return {}

        return get_app_environments_for_context(
            project_name,
            folder_path,
            task_name,
            full_app_name,
            env_group=env_group,
            launch_type=launch_type,
            env=env,
            addons_manager=self.manager
        )

    def get_farm_publish_environment_variables(
        self,
        project_name,
        folder_path,
        task_name,
        full_app_name=None,
        env_group=None,
    ):
        """Calculate environment variables for farm publish.

        Args:
            project_name (str): Project name.
            folder_path (str): Folder path.
            task_name (str): Task name.
            env_group (Optional[str]): Environment group.
            full_app_name (Optional[str]): Full application name. Value from
                environment variable 'AYON_APP_NAME' is used if 'None' is
                passed.

        Returns:
            dict[str, str]: Environment variables for farm publish.

        """
        if full_app_name is None:
            full_app_name = os.getenv("AYON_APP_NAME")

        return self.get_app_environments_for_context(
            project_name,
            folder_path,
            task_name,
            full_app_name,
            env_group=env_group,
            launch_type=LaunchTypes.farm_publish
        )

    def get_applications_manager(self, settings=None):
        """Get applications manager.

        Args:
            settings (Optional[dict]): Studio/project settings.

        Returns:
            ApplicationManager: Applications manager.

        """
        return ApplicationManager(settings)

    def get_plugin_paths(self):
        plugins_dir = os.path.join(APPLICATIONS_ADDON_ROOT, "plugins")
        return {
            "actions": [os.path.join(plugins_dir, "launcher_actions")],
            "publish": [os.path.join(plugins_dir, "publish")]
        }

    def get_launch_hook_paths(self, app):
        return [
            os.path.join(APPLICATIONS_ADDON_ROOT, "hooks")
        ]

    def get_app_icon_path(self, icon_filename):
        """Get icon path.

        Args:
            icon_filename (str): Icon filename.

        Returns:
            Union[str, None]: Icon path or None if not found.

        """
        return get_app_icon_path(icon_filename)

    def get_app_icon_url(self, icon_filename, server=False):
        """Get icon path.

        Method does not validate if icon filename exist on server.

        Args:
            icon_filename (str): Icon name.
            server (Optional[bool]): Return url to AYON server.

        Returns:
            Union[str, None]: Icon path or None is server url is not
                available.

        """
        if not icon_filename:
            return None
        icon_name = os.path.basename(icon_filename)
        if server:
            base_url = ayon_api.get_base_url()
            return (
                f"{base_url}/addons/{self.name}/{self.version}"
                f"/public/icons/{icon_name}"
            )
        server_url = os.getenv("AYON_WEBSERVER_URL")
        if not server_url:
            return None
        return "/".join([
            server_url, "addons", self.name, "icons", icon_name
        ])

    def get_applications_action_classes(self):
        """Get application action classes for launcher tool.

        This method should be used only by launcher tool. Please do not use it
        in other places as its implementation is not optimal, and might
        change or be removed.

        Returns:
            list[ApplicationAction]: List of application action classes.

        """
        from .action import ApplicationAction

        actions = []

        manager = self.get_applications_manager()
        for full_name, application in manager.applications.items():
            if not application.enabled:
                continue

            icon = self.get_app_icon_path(application.icon)

            action = type(
                "app_{}".format(full_name),
                (ApplicationAction,),
                {
                    "identifier": "application.{}".format(full_name),
                    "application": application,
                    "name": application.name,
                    "label": application.group.label,
                    "label_variant": application.label,
                    "group": None,
                    "icon": icon,
                    "color": getattr(application, "color", None),
                    "order": getattr(application, "order", None) or 0,
                    "data": {}
                }
            )
            actions.append(action)
        return actions

    def launch_application(
        self, app_name, project_name, folder_path, task_name
    ):
        """Launch application.

        Args:
            app_name (str): Full application name e.g. 'maya/2024'.
            project_name (str): Project name.
            folder_path (str): Folder path.
            task_name (str): Task name.

        """
        ensure_addons_are_process_ready(
            addon_name=self.name,
            addon_version=self.version,
            project_name=project_name,
        )
        headless = is_headless_mode_enabled()

        # TODO handle raise errors
        failed = True
        message = None
        detail = None
        try:
            app_manager = self.get_applications_manager()
            app_manager.launch(
                app_name,
                project_name=project_name,
                folder_path=folder_path,
                task_name=task_name,
            )
            failed = False

        except (
            ApplicationLaunchFailed,
            ApplicationExecutableNotFound,
            ApplicationNotFound,
        ) as exc:
            message = str(exc)
            self.log.warning(f"Application launch failed: {message}")

        except Exception as exc:
            message = "An unexpected error happened"
            detail = "".join(traceback.format_exception(*sys.exc_info()))
            self.log.warning(
                f"Application launch failed: {str(exc)}",
                exc_info=True
            )

        if not failed:
            return

        if not headless:
            self._show_launch_error_dialog(message, detail)
        sys.exit(1)

    def webserver_initialization(self, manager):
        """Initialize webserver.

        Args:
            manager (WebServerManager): Webserver manager.

        """
        static_prefix = f"/addons/{self.name}/icons"
        manager.add_static(
            static_prefix, os.path.join(APPLICATIONS_ADDON_ROOT, "icons")
        )

    # --- CLI ---
    def cli(self, addon_click_group):
        main_group = click_wrap.group(
            self._cli_main, name=self.name, help="Applications addon"
        )
        (
            main_group.command(
                self._cli_extract_environments,
                name="extractenvironments",
                help=(
                    "Extract environment variables for context into json file"
                )
            )
            .argument("output_json_path")
            .option("--project", help="Project name", default=None)
            .option("--folder", help="Folder path", default=None)
            .option("--task", help="Task name", default=None)
            .option("--app", help="Full application name", default=None)
            .option(
                "--envgroup",
                help="Environment group (e.g. \"farm\")",
                default=None
            )
        )
        (
            main_group.command(
                self._cli_launch_context_names,
                name="launch",
                help="Launch application"
            )
            .option("--app", required=True, help="Full application name")
            .option("--project", required=True, help="Project name")
            .option("--folder", required=True, help="Folder path")
            .option("--task", required=True, help="Task name")
        )
        # Convert main command to click object and add it to parent group
        (
            main_group.command(
                self._cli_launch_with_task_id,
                name="launch-by-id",
                help="Launch application"
            )
            .option("--app", required=True, help="Full application name")
            .option("--project", required=True, help="Project name")
            .option("--task-id", required=True, help="Task id")
        )
        # Convert main command to click object and add it to parent group
        addon_click_group.add_command(
            main_group.to_click_obj()
        )

    def _cli_main(self):
        pass

    def _cli_extract_environments(
        self, output_json_path, project, folder, task, app, envgroup
    ):
        """Produces json file with environment based on project and app.

        Called by farm integration to propagate environment into farm jobs.

        Args:
            output_json_path (str): Output json file path.
            project (str): Project name.
            folder (str): Folder path.
            task (str): Task name.
            app (str): Full application name e.g. 'maya/2024'.
            envgroup (str): Environment group.

        """
        if all((project, folder, task, app)):
            env = self.get_farm_publish_environment_variables(
                project, folder, task, app, env_group=envgroup,
            )
        else:
            env = os.environ.copy()

        output_dir = os.path.dirname(output_json_path)
        os.makedirs(output_dir, exist_ok=True)

        with open(output_json_path, "w") as file_stream:
            json.dump(env, file_stream, indent=4)

    def _cli_launch_context_names(self, project, folder, task, app):
        """Launch application.

        Args:
            project (str): Project name.
            folder (str): Folder path.
            task (str): Task name.
            app (str): Full application name e.g. 'maya/2024'.

        """
        self.launch_application(app, project, folder, task)


    def _cli_launch_with_task_id(self, project, task_id, app):
        """Launch application.

        Args:
            project (str): Project name.
            task_id (str): Task id.
            app (str): Full application name e.g. 'maya/2024'.

        """
        task_entity = ayon_api.get_task_by_id(
            project, task_id, fields={"name", "folderId"}
        )
        folder_entity = ayon_api.get_folder_by_id(
            project, task_entity["folderId"], fields={"path"}
        )
        self.launch_application(
            app, project, folder_entity["path"], task_entity["name"]
        )

    def _show_launch_error_dialog(self, message, detail):
        script_path = os.path.join(
            APPLICATIONS_ADDON_ROOT, "ui", "launch_failed_dialog.py"
        )
        with tempfile.NamedTemporaryFile("w", delete=False) as tmp:
            tmp_path = tmp.name
            json.dump(
                {"message": message, "detail": detail},
                tmp.file
            )

        try:
            run_ayon_launcher_process(
                "--skip-bootstrap",
                script_path,
                tmp_path,
                add_sys_paths=True,
                creationflags=0,
            )

        finally:
            os.remove(tmp_path)

get_app_environments_for_context(project_name, folder_path, task_name, full_app_name, env_group=None, launch_type=None, env=None)

Calculate environment variables for launch context.

Parameters:

Name Type Description Default
project_name str

Project name.

required
folder_path str

Folder path.

required
task_name str

Task name.

required
full_app_name str

Full application name.

required
env_group Optional[str]

Environment group.

None
launch_type Optional[str]

Launch type.

None
env Optional[dict[str, str]]

Environment variables to update.

None

Returns:

Type Description

dict[str, str]: Environment variables for context.

Source code in client/ayon_applications/addon.py
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
def get_app_environments_for_context(
    self,
    project_name,
    folder_path,
    task_name,
    full_app_name,
    env_group=None,
    launch_type=None,
    env=None,
):
    """Calculate environment variables for launch context.

    Args:
        project_name (str): Project name.
        folder_path (str): Folder path.
        task_name (str): Task name.
        full_app_name (str): Full application name.
        env_group (Optional[str]): Environment group.
        launch_type (Optional[str]): Launch type.
        env (Optional[dict[str, str]]): Environment variables to update.

    Returns:
        dict[str, str]: Environment variables for context.

    """
    from ayon_applications.utils import get_app_environments_for_context

    if not full_app_name:
        return {}

    return get_app_environments_for_context(
        project_name,
        folder_path,
        task_name,
        full_app_name,
        env_group=env_group,
        launch_type=launch_type,
        env=env,
        addons_manager=self.manager
    )

get_app_icon_path(icon_filename)

Get icon path.

Parameters:

Name Type Description Default
icon_filename str

Icon filename.

required

Returns:

Type Description

Union[str, None]: Icon path or None if not found.

Source code in client/ayon_applications/addon.py
140
141
142
143
144
145
146
147
148
149
150
def get_app_icon_path(self, icon_filename):
    """Get icon path.

    Args:
        icon_filename (str): Icon filename.

    Returns:
        Union[str, None]: Icon path or None if not found.

    """
    return get_app_icon_path(icon_filename)

get_app_icon_url(icon_filename, server=False)

Get icon path.

Method does not validate if icon filename exist on server.

Parameters:

Name Type Description Default
icon_filename str

Icon name.

required
server Optional[bool]

Return url to AYON server.

False

Returns:

Type Description

Union[str, None]: Icon path or None is server url is not available.

Source code in client/ayon_applications/addon.py
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
def get_app_icon_url(self, icon_filename, server=False):
    """Get icon path.

    Method does not validate if icon filename exist on server.

    Args:
        icon_filename (str): Icon name.
        server (Optional[bool]): Return url to AYON server.

    Returns:
        Union[str, None]: Icon path or None is server url is not
            available.

    """
    if not icon_filename:
        return None
    icon_name = os.path.basename(icon_filename)
    if server:
        base_url = ayon_api.get_base_url()
        return (
            f"{base_url}/addons/{self.name}/{self.version}"
            f"/public/icons/{icon_name}"
        )
    server_url = os.getenv("AYON_WEBSERVER_URL")
    if not server_url:
        return None
    return "/".join([
        server_url, "addons", self.name, "icons", icon_name
    ])

get_applications_action_classes()

Get application action classes for launcher tool.

This method should be used only by launcher tool. Please do not use it in other places as its implementation is not optimal, and might change or be removed.

Returns:

Type Description

list[ApplicationAction]: List of application action classes.

Source code in client/ayon_applications/addon.py
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
def get_applications_action_classes(self):
    """Get application action classes for launcher tool.

    This method should be used only by launcher tool. Please do not use it
    in other places as its implementation is not optimal, and might
    change or be removed.

    Returns:
        list[ApplicationAction]: List of application action classes.

    """
    from .action import ApplicationAction

    actions = []

    manager = self.get_applications_manager()
    for full_name, application in manager.applications.items():
        if not application.enabled:
            continue

        icon = self.get_app_icon_path(application.icon)

        action = type(
            "app_{}".format(full_name),
            (ApplicationAction,),
            {
                "identifier": "application.{}".format(full_name),
                "application": application,
                "name": application.name,
                "label": application.group.label,
                "label_variant": application.label,
                "group": None,
                "icon": icon,
                "color": getattr(application, "color", None),
                "order": getattr(application, "order", None) or 0,
                "data": {}
            }
        )
        actions.append(action)
    return actions

get_applications_manager(settings=None)

Get applications manager.

Parameters:

Name Type Description Default
settings Optional[dict]

Studio/project settings.

None

Returns:

Name Type Description
ApplicationManager

Applications manager.

Source code in client/ayon_applications/addon.py
116
117
118
119
120
121
122
123
124
125
126
def get_applications_manager(self, settings=None):
    """Get applications manager.

    Args:
        settings (Optional[dict]): Studio/project settings.

    Returns:
        ApplicationManager: Applications manager.

    """
    return ApplicationManager(settings)

get_farm_publish_environment_variables(project_name, folder_path, task_name, full_app_name=None, env_group=None)

Calculate environment variables for farm publish.

Parameters:

Name Type Description Default
project_name str

Project name.

required
folder_path str

Folder path.

required
task_name str

Task name.

required
env_group Optional[str]

Environment group.

None
full_app_name Optional[str]

Full application name. Value from environment variable 'AYON_APP_NAME' is used if 'None' is passed.

None

Returns:

Type Description

dict[str, str]: Environment variables for farm publish.

Source code in client/ayon_applications/addon.py
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
def get_farm_publish_environment_variables(
    self,
    project_name,
    folder_path,
    task_name,
    full_app_name=None,
    env_group=None,
):
    """Calculate environment variables for farm publish.

    Args:
        project_name (str): Project name.
        folder_path (str): Folder path.
        task_name (str): Task name.
        env_group (Optional[str]): Environment group.
        full_app_name (Optional[str]): Full application name. Value from
            environment variable 'AYON_APP_NAME' is used if 'None' is
            passed.

    Returns:
        dict[str, str]: Environment variables for farm publish.

    """
    if full_app_name is None:
        full_app_name = os.getenv("AYON_APP_NAME")

    return self.get_app_environments_for_context(
        project_name,
        folder_path,
        task_name,
        full_app_name,
        env_group=env_group,
        launch_type=LaunchTypes.farm_publish
    )

launch_application(app_name, project_name, folder_path, task_name)

Launch application.

Parameters:

Name Type Description Default
app_name str

Full application name e.g. 'maya/2024'.

required
project_name str

Project name.

required
folder_path str

Folder path.

required
task_name str

Task name.

required
Source code in client/ayon_applications/addon.py
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
def launch_application(
    self, app_name, project_name, folder_path, task_name
):
    """Launch application.

    Args:
        app_name (str): Full application name e.g. 'maya/2024'.
        project_name (str): Project name.
        folder_path (str): Folder path.
        task_name (str): Task name.

    """
    ensure_addons_are_process_ready(
        addon_name=self.name,
        addon_version=self.version,
        project_name=project_name,
    )
    headless = is_headless_mode_enabled()

    # TODO handle raise errors
    failed = True
    message = None
    detail = None
    try:
        app_manager = self.get_applications_manager()
        app_manager.launch(
            app_name,
            project_name=project_name,
            folder_path=folder_path,
            task_name=task_name,
        )
        failed = False

    except (
        ApplicationLaunchFailed,
        ApplicationExecutableNotFound,
        ApplicationNotFound,
    ) as exc:
        message = str(exc)
        self.log.warning(f"Application launch failed: {message}")

    except Exception as exc:
        message = "An unexpected error happened"
        detail = "".join(traceback.format_exception(*sys.exc_info()))
        self.log.warning(
            f"Application launch failed: {str(exc)}",
            exc_info=True
        )

    if not failed:
        return

    if not headless:
        self._show_launch_error_dialog(message, detail)
    sys.exit(1)

webserver_initialization(manager)

Initialize webserver.

Parameters:

Name Type Description Default
manager WebServerManager

Webserver manager.

required
Source code in client/ayon_applications/addon.py
279
280
281
282
283
284
285
286
287
288
289
def webserver_initialization(self, manager):
    """Initialize webserver.

    Args:
        manager (WebServerManager): Webserver manager.

    """
    static_prefix = f"/addons/{self.name}/icons"
    manager.add_static(
        static_prefix, os.path.join(APPLICATIONS_ADDON_ROOT, "icons")
    )