[FIX] VTK export appends .vtk (#78)

* Introducing check_folder_path helper function for vtk export

* Localise folder path message

* copilot review fixes

* Updating helper function name

Author: sankalps0549

CHANGELOG.md

@@ -25,6 +25,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Security
 - N/A
 
+## [27.0.1] - 2026-04-18
+
+### Added
+- N/A
+
+### Changed
+- N/A
+
+### Deprecated
+- N/A
+
+### Removed
+- N/A
+
+### Fixed
+- `PlotManager.export_to_vtk()` no longer appends a `.vtk` suffix to the export path; the path is treated as a VTK export **folder** root, matching Synergy UI behavior. Uses `prepare_folder_path()` in `helper.py` to validate the path and create parent directories only.
+
+### Security
+- N/A
+
 ## [27.0.0] - 2026-01-21
 
 ### Added
@@ -170,7 +190,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Initial version aligned with Moldflow Synergy 2026.0.1
 - Python 3.10-3.13 compatibility
 
-[Unreleased]: https://github.com/Autodesk/moldflow-api/compare/v26.0.5...HEAD
+[Unreleased]: https://github.com/Autodesk/moldflow-api/compare/v27.0.1...HEAD
+[27.0.1]: https://github.com/Autodesk/moldflow-api/releases/tag/v27.0.1
+[27.0.0]: https://github.com/Autodesk/moldflow-api/releases/tag/v27.0.0
 [26.0.5]: https://github.com/Autodesk/moldflow-api/releases/tag/v26.0.5
 [26.0.4]: https://github.com/Autodesk/moldflow-api/releases/tag/v26.0.4
 [26.0.3]: https://github.com/Autodesk/moldflow-api/releases/tag/v26.0.3

src/moldflow/common.py

@@ -175,6 +175,7 @@ class LogMessage(Enum):
     CHECK_NEGATIVE = ("Checking {value} is negative", logging.DEBUG)
     CHECK_INDEX_IN_RANGE = ("Checking index {index} is in range", logging.DEBUG)
     CHECK_FILE_EXTENSION = ("Checking file extension {file_name}", logging.DEBUG)
+    CHECK_FOLDER_PATH = ("Checking folder path {folder_path}", logging.DEBUG)
     CHECK_EXPECTED_VALUES = ("Checking {value} is in expected values", logging.DEBUG)
     FAIL_INIT_WITH_ENV = (
         "Could not initialize with Instance ID: {value}",

src/moldflow/helper.py

@@ -237,6 +237,22 @@ def check_index(index: int, min_value: int, max_value: int):
     process_log(__name__, LogMessage.VALID_INPUT)
 
 
+def _create_required_parent_directories(path: str):
+    """
+    Create parent directories for a given path.
+
+    Trailing separators are normalized first so ``dirname`` resolves to the
+    parent of the final path component (never the export root / file leaf).
+
+    Args:
+        path (str): The path to create parent directories for.
+    """
+    directory = os.path.dirname(os.path.normpath(path))
+    if not directory:
+        return
+    os.makedirs(directory, exist_ok=True)
+
+
 def check_file_extension(file_name: str, extensions: tuple | str):
     """
     Check if the file name has a valid extension.
@@ -247,9 +263,7 @@ def check_file_extension(file_name: str, extensions: tuple | str):
     process_log(__name__, LogMessage.CHECK_FILE_EXTENSION, locals(), file_name=file_name)
     check_type(file_name, str)
     check_type(extensions, (str, tuple))
-    directory = os.path.dirname(file_name)
-    if directory:
-        os.makedirs(directory, exist_ok=True)
+    _create_required_parent_directories(file_name)
     default = extensions if isinstance(extensions, str) else extensions[0]
     if not file_name.endswith(extensions):
         process_log(
@@ -263,6 +277,25 @@ def check_file_extension(file_name: str, extensions: tuple | str):
     return file_name
 
 
+def prepare_folder_path(folder_path: str) -> str:
+    """
+    Validate and prepare a folder-style export path.
+
+    Ensures parent directories exist. Does not modify the path or append a file extension.
+
+    Args:
+        folder_path (str): Full path to the export root folder (bare name, relative path,
+            or absolute path).
+
+    Returns:
+        str: The same path, unchanged.
+    """
+    process_log(__name__, LogMessage.CHECK_FOLDER_PATH, locals(), folder_path=folder_path)
+    check_type(folder_path, str)
+    _create_required_parent_directories(folder_path)
+    return folder_path
+
+
 def check_expected_values(value, expected_values: tuple):
     """
     Check if the value is in the expected values.

src/moldflow/locale/de-DE/LC_MESSAGES/locale.de-DE.po

@@ -9,6 +9,9 @@ msgstr "Abbrechen"
 msgid "Checking file extension {file_name}"
 msgstr "Überprüfen der Dateierweiterung {file_name}"
 
+msgid "Checking folder path {folder_path}"
+msgstr "Überprüfen des Ordnerpfads {folder_path}"
+
 msgid "Checking index {index} is in range"
 msgstr "Überprüfen, ob der Index {index} im Bereich liegt"
 

src/moldflow/locale/en-US/LC_MESSAGES/locale.en-US.po

@@ -9,6 +9,9 @@ msgstr "Cancel"
 msgid "Checking file extension {file_name}"
 msgstr "Checking file extension {file_name}"
 
+msgid "Checking folder path {folder_path}"
+msgstr "Checking folder path {folder_path}"
+
 msgid "Checking index {index} is in range"
 msgstr "Checking index {index} is in range"
 

src/moldflow/locale/es-ES/LC_MESSAGES/locale.es-ES.po

@@ -9,6 +9,9 @@ msgstr "Cancelar"
 msgid "Checking file extension {file_name}"
 msgstr "Comprobando la extensión del archivo {file_name}"
 
+msgid "Checking folder path {folder_path}"
+msgstr "Comprobando la ruta de la carpeta {folder_path}"
+
 msgid "Checking index {index} is in range"
 msgstr "Comprobando que el índice {index} está dentro del rango"
 

src/moldflow/locale/fr-FR/LC_MESSAGES/locale.fr-FR.po

@@ -9,6 +9,9 @@ msgstr "Annuler"
 msgid "Checking file extension {file_name}"
 msgstr "Vérification de l'extension du fichier {file_name}"
 
+msgid "Checking folder path {folder_path}"
+msgstr "Vérification du chemin du dossier {folder_path}"
+
 msgid "Checking index {index} is in range"
 msgstr "Vérification que l'indice {index} est dans l'intervalle"
 

src/moldflow/locale/it-IT/LC_MESSAGES/locale.it-IT.po

@@ -9,6 +9,9 @@ msgstr "Annulla"
 msgid "Checking file extension {file_name}"
 msgstr "Verifica dell'estensione del file {file_name}"
 
+msgid "Checking folder path {folder_path}"
+msgstr "Verifica del percorso della cartella {folder_path}"
+
 msgid "Checking index {index} is in range"
 msgstr "Verifica che l'indice {index} sia nell'intervallo"
 

src/moldflow/locale/ja-JP/LC_MESSAGES/locale.ja-JP.po

@@ -9,6 +9,9 @@ msgstr "キャンセル"
 msgid "Checking file extension {file_name}"
 msgstr "ファイル拡張子 {file_name} を確認しています"
 
+msgid "Checking folder path {folder_path}"
+msgstr "フォルダー パス {folder_path} を確認しています"
+
 msgid "Checking index {index} is in range"
 msgstr "インデックス {index} が範囲内であることを確認しています"
 

src/moldflow/locale/ko-KR/LC_MESSAGES/locale.ko-KR.po

@@ -9,6 +9,9 @@ msgstr "취소"
 msgid "Checking file extension {file_name}"
 msgstr "파일 확장자 {file_name} 확인 중"
 
+msgid "Checking folder path {folder_path}"
+msgstr "폴더 경로 {folder_path} 확인 중"
+
 msgid "Checking index {index} is in range"
 msgstr "인덱스 {index}가 범위 내에 있는지 확인 중"