Sherlock Project Export

This example demonstrates how to connect to the Sherlock gRPC service, import a project, and export the project in multiple configurations.

Description Sherlock’s gRPC API enables automation of various workflows, including project export. This script demonstrates how to: - Connect to the Sherlock service. - Import a tutorial project ZIP archive. - Export a project with different configurations.

import os

from examples.examples_globals import get_sherlock_tutorial_path, get_temp_dir

from ansys.sherlock.core import launcher
from ansys.sherlock.core.errors import (
    SherlockExportProjectError,
    SherlockImportProjectZipArchiveError,
)

Connect to Sherlock

Connect to the Sherlock service and ensure proper initialization.

sherlock = launcher.connect(port=9092, timeout=10)

Delete Project

Delete the project if it already exists.

try:
    sherlock.project.delete_project("Test")
    print("Project deleted successfully.")
except Exception:
    pass

Import Tutorial Project

Import a sample project ZIP archive provided with the Sherlock installation.

try:
    sherlock.project.import_project_zip_archive(
        project="Test",
        category="Demos",
        archive_file=os.path.join(get_sherlock_tutorial_path(), "Auto Relay Project.zip"),
    )
    print("Tutorial project imported successfully.")
except SherlockImportProjectZipArchiveError as e:
    print(f"Error importing project: {e}")

Export Project

Export the imported project with different configurations.

# Export with all options enabled
try:
    sherlock.project.export_project(
        project_name="Test",
        export_design_files=True,
        export_result_files=True,
        export_archive_results=True,
        export_user_files=True,
        export_log_files=True,
        export_system_data=True,
        export_file_dir=get_temp_dir(),
        export_file_name="Exported_Project_All.zip",
        overwrite_existing_file=True,
    )
    print("Project exported successfully with all options enabled.")
except SherlockExportProjectError as e:
    print(f"Error exporting project (all options): {e}")

# Export with limited options
try:
    sherlock.project.export_project(
        project_name="Test",
        export_design_files=True,
        export_result_files=False,
        export_archive_results=False,
        export_user_files=False,
        export_log_files=False,
        export_system_data=False,
        export_file_dir=get_temp_dir(),
        export_file_name="Exported_Project_Limited.zip",
        overwrite_existing_file=True,
    )
    print("Project exported successfully with limited options.")
except SherlockExportProjectError as e:
    print(f"Error exporting project (limited options): {e}")