flashforge-python-api 1.3.2__py3-none-any.whl → 1.3.3__py3-none-any.whl

flashforge/api/controls/control.py

@@ -2,6 +2,7 @@
 FlashForge Python API - Control Module
 """
 
+import logging
 from typing import TYPE_CHECKING, Any
 
 from ...models.responses import FilamentArgs
@@ -14,6 +15,8 @@ if TYPE_CHECKING:
     from ...client import FlashForgeClient
     from ...tcp.ff_client import FlashForgeClient as TcpClient
 
+logger = logging.getLogger(__name__)
+
 
 class Control:
     """
@@ -75,7 +78,7 @@ class Control:
             return await self._send_filtration_command(
                 FilamentArgs(internal="close", external="open")
             )
-        print("SetExternalFiltrationOn() error, filtration not equipped.")
+        logger.warning("set_external_filtration_on: filtration is not equipped on this printer.")
         return False
 
     async def set_internal_filtration_on(self) -> bool:
@@ -90,7 +93,7 @@ class Control:
             return await self._send_filtration_command(
                 FilamentArgs(internal="open", external="close")
             )
-        print("SetInternalFiltrationOn() error, filtration not equipped.")
+        logger.warning("set_internal_filtration_on: filtration is not equipped on this printer.")
         return False
 
     async def set_filtration_off(self) -> bool:
@@ -105,7 +108,7 @@ class Control:
             return await self._send_filtration_command(
                 FilamentArgs(internal="close", external="close")
             )
-        print("SetFiltrationOff() error, filtration not equipped.")
+        logger.warning("set_filtration_off: filtration is not equipped on this printer.")
         return False
 
     async def turn_camera_on(self) -> bool:
@@ -188,7 +191,7 @@ class Control:
             True if the command is successful, False otherwise.
         """
         if not self.client.led_control:
-            print("SetLedOn() error, LED control not equipped.")
+            logger.warning("set_led_on: LED control is not equipped on this printer.")
             return False
         return await self.send_control_command(Commands.LIGHT_CONTROL_CMD, {"status": "open"})
 
@@ -200,7 +203,7 @@ class Control:
             True if the command is successful, False otherwise.
         """
         if not self.client.led_control:
-            print("SetLedOff() error, LED control not equipped.")
+            logger.warning("set_led_off: LED control is not equipped on this printer.")
             return False
         return await self.send_control_command(Commands.LIGHT_CONTROL_CMD, {"status": "close"})
 
@@ -259,7 +262,9 @@ class Control:
             True if the command is successful, False otherwise.
         """
         if not self.client.is_ad5x and not self.client.is_creator5:
-            print("configure_slot() error, material station only available on AD5X / Creator 5.")
+            logger.warning(
+                "configure_slot: the material station is only available on the AD5X / Creator 5."
+            )
             return False
         # The AD5X and Creator 5 use MUTUALLY EXCLUSIVE color wire formats (see
         # creator5_palette for the firmware match rules), so model-gate here:
@@ -293,7 +298,9 @@ class Control:
             "payload": {"cmd": command, "args": args},
         }
 
-        print(f"SendControlCommand:\n{payload}")
+        # Log the command, never `payload`: it carries the serial number and
+        # check code, and these lines end up pasted into bug reports.
+        logger.debug("Sending control command %s with args %s", command, args)
 
         try:
             await self.client.is_http_client_busy()
@@ -305,12 +312,12 @@ class Control:
                 headers={"Content-Type": "application/json"},
             ) as response:
                 data = await json_from_response(response)
-                print(f"Command reply: {data}")
+                logger.debug("Control command %s reply: %s", command, data)
 
                 return NetworkUtils.is_ok(data)
 
         except Exception as e:
-            print(f"Error in send_control_command: {e}")
+            logger.warning("Error in send_control_command (%s): %s", command, e)
             return False
         finally:
             self.client.release_http_client()

flashforge/api/controls/creator5_palette.py

@@ -16,6 +16,7 @@ for the model-gating that splits them.
 
 from __future__ import annotations
 
+import logging
 import math
 import re
 from dataclasses import dataclass
@@ -25,6 +26,8 @@ from dataclasses import dataclass
 # reference. PEP 8 lowercase locals are therefore relaxed here on purpose.
 # ruff: noqa: N806
 
+logger = logging.getLogger(__name__)
+
 
 @dataclass(frozen=True)
 class Creator5PaletteColor:
@@ -238,9 +241,9 @@ def snap_to_creator5_palette(hex_str: str) -> Creator5PaletteColor:
     """
     rgb = _hex_to_rgb(hex_str)
     if rgb is None:
-        print(
-            f'snap_to_creator5_palette: could not parse "{hex_str}" as hex; '
-            "falling back to White."
+        logger.warning(
+            'snap_to_creator5_palette: could not parse "%s" as hex; falling back to White.',
+            hex_str,
         )
         return CREATOR5_PALETTE[0]
 

flashforge/api/controls/files.py

@@ -90,7 +90,10 @@ class Files:
                 data = await json_from_response(response)
 
                 if not NetworkUtils.is_ok(data):
-                    print(f"Error retrieving file list: {NetworkUtils.get_error_message(data)}")
+                    logger.warning(
+                        "Error retrieving the file list: %s",
+                        NetworkUtils.get_error_message(data),
+                    )
                     return []
 
                 # Parse the response using GCodeListResponse
@@ -147,7 +150,7 @@ class Files:
                 return []
 
         except Exception as err:
-            print(f"GetRecentFileList error: {err}")
+            logger.warning("get_recent_file_list error: %s", err)
             return []
 
     async def get_gcode_thumbnail(self, file_name: str) -> bytes | None:
@@ -185,9 +188,12 @@ class Files:
                     result = ThumbnailResponse(**data)
                     return base64.b64decode(result.image_data)
                 else:
-                    print(f"Error retrieving thumbnail: {NetworkUtils.get_error_message(data)}")
+                    logger.warning(
+                        "Error retrieving the thumbnail: %s",
+                        NetworkUtils.get_error_message(data),
+                    )
                     return None
 
         except Exception as err:
-            print(f"GetGcodeThumbnail error: {err}")
+            logger.warning("get_gcode_thumbnail error: %s", err)
             return None

flashforge/api/controls/info.py

@@ -2,6 +2,7 @@
 FlashForge Python API - Info Module
 """
 
+import logging
 import re
 from datetime import datetime, timedelta
 from typing import TYPE_CHECKING
@@ -9,11 +10,14 @@ from typing import TYPE_CHECKING
 from ...models.machine_info import FFMachineInfo, MachineState, Temperature
 from ...models.responses import DetailResponse, FFPrinterDetail
 from ..constants.endpoints import Endpoints
+from ..misc.redaction import redact_model
 from ..network.utils import json_from_response
 
 if TYPE_CHECKING:
     from ...client import FlashForgeClient
 
+logger = logging.getLogger(__name__)
+
 
 # Firmware-reported PIDs from FlashForge's /detail endpoint. These are stable
 # identifiers set by firmware, unlike the user-mutable `name` field.
@@ -267,8 +271,14 @@ class MachineInfoParser:
             return machine_info
 
         except Exception as error:
-            print(f"Error in MachineInfoParser.from_detail: {error}")
-            print(f"Detail object causing error: {detail}")
+            logger.warning(
+                "Could not parse the /detail payload into FFMachineInfo; the caller sees "
+                "this as an unreachable printer. %s",
+                error,
+            )
+            # Redacted: this dump carries the MAC, IP and cloud registration
+            # codes, and it exists to be pasted into a bug report.
+            logger.debug("Detail object that failed to parse: %s", redact_model(detail))
             return None
 
     @staticmethod
@@ -303,7 +313,7 @@ class MachineInfoParser:
             return state_mapping[valid_status]
 
         if valid_status:
-            print(f"Unknown machine status received: '{status}'")
+            logger.warning("Unknown machine status received: %r", status)
         return MachineState.UNKNOWN
 
 
@@ -384,12 +394,17 @@ class Info:
                 headers={"Content-Type": "application/json"},
             ) as response:
                 if response.status != 200:
-                    print(f"Non-200 status from detail endpoint: {response.status}")
+                    logger.warning("Non-200 status from the /detail endpoint: %s", response.status)
                     return None
 
                 data = await json_from_response(response)
                 return DetailResponse(**data)
 
         except Exception as error:
-            print(f"GetDetailResponse Request error: {error}")
+            logger.warning(
+                "Could not read /detail; callers cannot tell this from an unreachable "
+                "printer or a rejected check code, so this line is the only record of "
+                "the real cause. %s",
+                error,
+            )
             return None

flashforge/api/controls/job_control.py

@@ -4,6 +4,7 @@ FlashForge Python API - Job Control Module
 
 import base64
 import json
+import logging
 import re
 from pathlib import Path
 from typing import TYPE_CHECKING, Any
@@ -19,12 +20,15 @@ from ...models.responses import (
     Creator5UploadParams,
 )
 from ..constants.endpoints import Endpoints
+from ..misc.redaction import redact_mapping
 from ..network.utils import NetworkUtils, json_from_response
 
 if TYPE_CHECKING:
     from ...client import FlashForgeClient
     from .control import Control
 
+logger = logging.getLogger(__name__)
+
 
 class JobControl:
     """
@@ -136,14 +140,18 @@ class JobControl:
         file_path_obj = Path(file_path)
 
         if not file_path_obj.exists():
-            print(f"UploadFile error: File not found at {file_path}")
+            logger.warning("upload_file: file not found at %s", file_path)
             return False
 
         file_size = file_path_obj.stat().st_size
         file_name = file_path_obj.name
 
-        print(
-            f"Starting upload for {file_name}, Size: {file_size}, Start: {start_print}, Level: {level_before_print}"
+        logger.debug(
+            "Starting upload for %s (size=%s, start=%s, level=%s)",
+            file_name,
+            file_size,
+            start_print,
+            level_before_print,
         )
 
         try:
@@ -159,16 +167,16 @@ class JobControl:
 
             # Add additional headers for new firmware
             if self._is_new_firmware_version():
-                print("Using new firmware headers for upload.")
+                logger.debug("Using new firmware headers for upload.")
                 custom_headers["flowCalibration"] = "false"
                 custom_headers["useMatlStation"] = "false"
                 custom_headers["gcodeToolCnt"] = "0"
                 # Base64 encode "[]" which is "W10="
                 custom_headers["materialMappings"] = "W10="
             else:
-                print("Using old firmware headers for upload.")
+                logger.debug("Using old firmware headers for upload.")
 
-            print("Upload Request Headers:", custom_headers)
+            logger.debug("Upload request headers: %s", redact_mapping(custom_headers))
 
             # Create multipart form data
             async with aiohttp.ClientSession() as session:
@@ -183,26 +191,31 @@ class JobControl:
                         data=data,
                         headers=custom_headers,
                     ) as response:
-                        print(f"Upload Response Status: {response.status}")
+                        logger.debug("Upload response status: %s", response.status)
 
                         if response.status != 200:
-                            print(f"Upload failed: Printer responded with status {response.status}")
+                            logger.warning(
+                                "Upload failed: the printer responded with status %s",
+                                response.status,
+                            )
                             return False
 
                         result = await json_from_response(response)
-                        print("Upload Response Data:", result)
+                        logger.debug("Upload response data: %s", result)
 
                         if NetworkUtils.is_ok(result):
-                            print("Upload successful according to printer response.")
+                            logger.debug("Upload successful according to the printer response.")
                             return True
                         else:
-                            print(
-                                f"Upload failed: Printer response code={result.get('code')}, message={result.get('message')}"
+                            logger.warning(
+                                "Upload failed: printer response code=%s, message=%s",
+                                result.get("code"),
+                                result.get("message"),
                             )
                             return False
 
         except Exception as e:
-            print(f"UploadFile error: {e}")
+            logger.warning("upload_file error: %s", e)
             return False
 
     async def print_local_file(self, file_name: str, leveling_before_print: bool) -> bool:
@@ -252,7 +265,7 @@ class JobControl:
                 return NetworkUtils.is_ok(result)
 
         except Exception as error:
-            print(f"PrintLocalFile error: {error}")
+            logger.warning("print_local_file error: %s", error)
             raise error
 
     async def upload_file_ad5x(self, params: AD5XUploadParams) -> bool:
@@ -278,14 +291,19 @@ class JobControl:
         # Validate file exists
         file_path_obj = Path(params.file_path)
         if not file_path_obj.exists():
-            print(f"UploadFileAD5X error: File not found at {params.file_path}")
+            logger.warning("upload_file_ad5x: file not found at %s", params.file_path)
             return False
 
         file_size = file_path_obj.stat().st_size
         file_name = file_path_obj.name
 
-        print(
-            f"Starting AD5X upload for {file_name}, Size: {file_size}, Start: {params.start_print}, Level: {params.leveling_before_print}, Tools: {len(params.material_mappings)}"
+        logger.debug(
+            "Starting AD5X upload for %s (size=%s, start=%s, level=%s, tools=%s)",
+            file_name,
+            file_size,
+            params.start_print,
+            params.leveling_before_print,
+            len(params.material_mappings),
         )
 
         try:
@@ -310,7 +328,7 @@ class JobControl:
                 "Expect": "100-continue",
             }
 
-            print("AD5X Upload Request Headers:", custom_headers)
+            logger.debug("AD5X upload request headers: %s", redact_mapping(custom_headers))
 
             # Create multipart form data
             async with aiohttp.ClientSession() as session:
@@ -325,28 +343,33 @@ class JobControl:
                         data=data,
                         headers=custom_headers,
                     ) as response:
-                        print(f"AD5X Upload Response Status: {response.status}")
+                        logger.debug("AD5X upload response status: %s", response.status)
 
                         if response.status != 200:
-                            print(
-                                f"AD5X Upload failed: Printer responded with status {response.status}"
+                            logger.warning(
+                                "AD5X upload failed: the printer responded with status %s",
+                                response.status,
                             )
                             return False
 
                         result = await json_from_response(response)
-                        print("AD5X Upload Response Data:", result)
+                        logger.debug("AD5X upload response data: %s", result)
 
                         if NetworkUtils.is_ok(result):
-                            print("AD5X Upload successful according to printer response.")
+                            logger.debug(
+                                "AD5X upload successful according to the printer response."
+                            )
                             return True
                         else:
-                            print(
-                                f"AD5X Upload failed: Printer response code={result.get('code')}, message={result.get('message')}"
+                            logger.warning(
+                                "AD5X upload failed: printer response code=%s, message=%s",
+                                result.get("code"),
+                                result.get("message"),
                             )
                             return False
 
         except Exception as e:
-            print(f"UploadFileAD5X error: {e}")
+            logger.warning("upload_file_ad5x error: %s", e)
             return False
 
     async def start_ad5x_multi_color_job(self, params: AD5XLocalJobParams) -> bool:
@@ -371,7 +394,7 @@ class JobControl:
 
         # Validate file name
         if not params.file_name or params.file_name.strip() == "":
-            print("AD5X Multi-Color Job error: fileName cannot be empty")
+            logger.warning("AD5X multi-color job: fileName cannot be empty.")
             return False
 
         # Create payload with AD5X-specific parameters
@@ -411,7 +434,7 @@ class JobControl:
                 return NetworkUtils.is_ok(result)
 
         except Exception as error:
-            print(f"AD5X Multi-Color Job error: {error}")
+            logger.warning("AD5X multi-color job error: %s", error)
             raise error
 
     async def start_ad5x_single_color_job(self, params: AD5XSingleColorJobParams) -> bool:
@@ -432,7 +455,7 @@ class JobControl:
 
         # Validate file name
         if not params.file_name or params.file_name.strip() == "":
-            print("AD5X Single-Color Job error: fileName cannot be empty")
+            logger.warning("AD5X single-color job: fileName cannot be empty.")
             return False
 
         # Create payload with AD5X-specific parameters for single-color printing
@@ -463,7 +486,7 @@ class JobControl:
                 return NetworkUtils.is_ok(result)
 
         except Exception as error:
-            print(f"AD5X Single-Color Job error: {error}")
+            logger.warning("AD5X single-color job error: %s", error)
             raise error
 
     # --- Creator 5 / Creator 5 Pro ---
@@ -495,16 +518,21 @@ class JobControl:
         file_path_obj = Path(params.file_path)
 
         if not file_path_obj.exists():
-            print(f"upload_file_creator5 error: File not found at {params.file_path}")
+            logger.warning("upload_file_creator5: file not found at %s", params.file_path)
             return False
 
         file_size = file_path_obj.stat().st_size
         file_name = file_path_obj.name
 
-        print(
-            f"Starting Creator 5 upload for {file_name}, Size: {file_size}, "
-            f"Start: {params.start_print}, Level: {params.leveling_before_print}, "
-            f"MatlStation: {params.use_matl_station}, Tools: {params.gcode_tool_cnt}"
+        logger.debug(
+            "Starting Creator 5 upload for %s (size=%s, start=%s, level=%s, "
+            "matl_station=%s, tools=%s)",
+            file_name,
+            file_size,
+            params.start_print,
+            params.leveling_before_print,
+            params.use_matl_station,
+            params.gcode_tool_cnt,
         )
 
         try:
@@ -524,7 +552,7 @@ class JobControl:
                 "Expect": "100-continue",
             }
 
-            print("Creator 5 Upload Request Headers:", custom_headers)
+            logger.debug("Creator 5 upload request headers: %s", redact_mapping(custom_headers))
 
             # Create multipart form data
             async with aiohttp.ClientSession() as session:
@@ -539,30 +567,33 @@ class JobControl:
                         data=data,
                         headers=custom_headers,
                     ) as response:
-                        print(f"Creator 5 Upload Response Status: {response.status}")
+                        logger.debug("Creator 5 upload response status: %s", response.status)
 
                         if response.status != 200:
-                            print(
-                                f"Creator 5 Upload failed: Printer responded with "
-                                f"status {response.status}"
+                            logger.warning(
+                                "Creator 5 upload failed: the printer responded with status %s",
+                                response.status,
                             )
                             return False
 
                         result = await json_from_response(response)
-                        print("Creator 5 Upload Response Data:", result)
+                        logger.debug("Creator 5 upload response data: %s", result)
 
                         if NetworkUtils.is_ok(result):
-                            print("Creator 5 Upload successful according to printer response.")
+                            logger.debug(
+                                "Creator 5 upload successful according to the printer response."
+                            )
                             return True
 
-                        print(
-                            "Creator 5 Upload failed: Printer response code="
-                            f"{result.get('code')}, message={result.get('message')}"
+                        logger.warning(
+                            "Creator 5 upload failed: printer response code=%s, message=%s",
+                            result.get("code"),
+                            result.get("message"),
                         )
                         return False
 
         except Exception as e:
-            print(f"upload_file_creator5 error: {e}")
+            logger.warning("upload_file_creator5 error: %s", e)
             return False
 
     async def start_creator5_job(self, params: Creator5JobParams) -> bool:
@@ -591,7 +622,7 @@ class JobControl:
             return False
 
         if not params.file_name or params.file_name.strip() == "":
-            print("Creator 5 Job error: fileName cannot be empty")
+            logger.warning("Creator 5 job: fileName cannot be empty.")
             return False
 
         has_mappings = params.material_mappings is not None and len(params.material_mappings) > 0
@@ -634,7 +665,7 @@ class JobControl:
                 return NetworkUtils.is_ok(result)
 
         except Exception as error:
-            print(f"Creator 5 Job error: {error}")
+            logger.warning("Creator 5 job error: %s", error)
             raise error
 
     def _validate_material_station_printer(self) -> bool:
@@ -648,9 +679,8 @@ class JobControl:
             True if the printer supports material mappings, False otherwise.
         """
         if not self.client.is_ad5x and not self.client.is_creator5:
-            print(
-                "Material-station job error: this method requires an AD5X or "
-                "Creator 5 series printer"
+            logger.warning(
+                "Material-station job: this method requires an AD5X or Creator 5 series printer."
             )
             return False
         return True
@@ -698,45 +728,53 @@ class JobControl:
         if not material_mappings or len(material_mappings) == 0:
             if allow_empty:
                 return True
-            print(f"{label} error: materialMappings array cannot be empty for multi-color jobs")
+            logger.warning("%s: materialMappings cannot be empty for multi-color jobs.", label)
             return False
 
         if len(material_mappings) > 4:
-            print(f"{label} error: Maximum 4 material mappings allowed")
+            logger.warning("%s: a maximum of 4 material mappings is allowed.", label)
             return False
 
         hex_color_regex = re.compile(r"^#[0-9A-Fa-f]{6}$")
 
         for i, mapping in enumerate(material_mappings):
             if mapping.tool_id < 0 or mapping.tool_id > 3:
-                print(
-                    f"{label} error: toolId must be between 0-3, "
-                    f"got {mapping.tool_id} at index {i}"
+                logger.warning(
+                    "%s: toolId must be between 0-3, got %s at index %s",
+                    label,
+                    mapping.tool_id,
+                    i,
                 )
                 return False
 
             if mapping.slot_id < 1 or mapping.slot_id > 4:
-                print(
-                    f"{label} error: slotId must be between 1-4, "
-                    f"got {mapping.slot_id} at index {i}"
+                logger.warning(
+                    "%s: slotId must be between 1-4, got %s at index %s",
+                    label,
+                    mapping.slot_id,
+                    i,
                 )
                 return False
 
             if not mapping.material_name or mapping.material_name.strip() == "":
-                print(f"{label} error: materialName cannot be empty at index {i}")
+                logger.warning("%s: materialName cannot be empty at index %s", label, i)
                 return False
 
             if not hex_color_regex.match(mapping.tool_material_color):
-                print(
-                    f"{label} error: toolMaterialColor must be in "
-                    f"#RRGGBB format, got {mapping.tool_material_color} at index {i}"
+                logger.warning(
+                    "%s: toolMaterialColor must be in #RRGGBB format, got %s at index %s",
+                    label,
+                    mapping.tool_material_color,
+                    i,
                 )
                 return False
 
             if not hex_color_regex.match(mapping.slot_material_color):
-                print(
-                    f"{label} error: slotMaterialColor must be in "
-                    f"#RRGGBB format, got {mapping.slot_material_color} at index {i}"
+                logger.warning(
+                    "%s: slotMaterialColor must be in #RRGGBB format, got %s at index %s",
+                    label,
+                    mapping.slot_material_color,
+                    i,
                 )
                 return False
 
@@ -750,7 +788,7 @@ class JobControl:
             True if the printer is AD5X, false otherwise
         """
         if not self.client.is_ad5x:
-            print("AD5X Job error: This method can only be used with AD5X printers")
+            logger.warning("AD5X job: this method can only be used with AD5X printers.")
             return False
         return True
 
@@ -781,7 +819,7 @@ class JobControl:
             json_string = json.dumps(json_array)
             return base64.b64encode(json_string.encode("utf-8")).decode("utf-8")
         except Exception as error:
-            print("Failed to encode material mappings to base64:", error)
+            logger.warning("Failed to encode the material mappings to base64: %s", error)
             raise Exception(
                 "Failed to encode material mappings for upload"
             ) from error  # noqa: B904

flashforge/api/controls/temp_control.py

@@ -6,6 +6,7 @@ direct TCP G-code/M-code commands; HTTP-only printers (Creator 5 / 5 Pro, no TCP
 channel) use the HTTP ``temperatureCtl_cmd`` instead.
 """
 
+import logging
 from typing import TYPE_CHECKING
 
 from ..constants.commands import Commands
@@ -14,6 +15,8 @@ if TYPE_CHECKING:
     from ...client import FlashForgeClient
     from ...tcp.ff_client import FlashForgeClient as TcpClient
 
+logger = logging.getLogger(__name__)
+
 
 # Sentinel value for `temperatureCtl_cmd` meaning "leave this heater unchanged"
 # (partial update). Sending a real 0 / -100 would turn the heater off.
@@ -106,7 +109,9 @@ class TempControl:
             The array, or None if ``tool_index`` is out of range.
         """
         if not isinstance(tool_index, int) or tool_index < 0 or tool_index >= NOZZLE_COUNT:
-            print(f"TempControl: toolIndex {tool_index} out of range (0-{NOZZLE_COUNT - 1}).")
+            logger.warning(
+                "TempControl: tool_index %s out of range (0-%s).", tool_index, NOZZLE_COUNT - 1
+            )
             return None
         nozzles = [TEMP_NO_CHANGE] * NOZZLE_COUNT
         nozzles[tool_index] = value
@@ -145,7 +150,7 @@ class TempControl:
             True if the command is acknowledged, False otherwise.
         """
         if len(temps) != NOZZLE_COUNT:
-            print(f"set_tool_temps: expected {NOZZLE_COUNT} temps, got {len(temps)}.")
+            logger.warning("set_tool_temps: expected %s temps, got %s.", NOZZLE_COUNT, len(temps))
             return False
         return await self._send_http_temp_command(nozzles=list(temps))
 
@@ -258,7 +263,9 @@ class TempControl:
             True if the command is acknowledged, False otherwise.
         """
         if not self.client.is_creator5 and not self.client.is_creator5_pro:
-            print("set_chamber_temp() error, chamber heater only available on Creator 5 series.")
+            logger.warning(
+                "set_chamber_temp: the chamber heater is only available on the Creator 5 series."
+            )
             return False
         return await self._send_http_temp_command(chamber=temp)
 
@@ -270,7 +277,9 @@ class TempControl:
             True if the command is acknowledged, False otherwise.
         """
         if not self.client.is_creator5 and not self.client.is_creator5_pro:
-            print("cancel_chamber_temp() error, chamber heater only available on Creator 5 series.")
+            logger.warning(
+                "cancel_chamber_temp: the chamber heater is only available on the Creator 5 series."
+            )
             return False
         return await self._send_http_temp_command(chamber=TEMP_OFF)
 
@@ -292,8 +301,8 @@ class TempControl:
             or HTTP-only (no TCP polling channel).
         """
         if self.client.http_only:
-            print(
-                "wait_for_part_cool() unavailable over HTTP-only connection; "
+            logger.warning(
+                "wait_for_part_cool is unavailable over an HTTP-only connection; "
                 "poll info.get() instead."
             )
             return False

flashforge/api/misc/redaction.py

@@ -0,0 +1,88 @@
+"""
+FlashForge Python API - Log redaction helpers.
+
+Debug logs get pasted into bug reports verbatim, so anything that identifies or
+grants control of a printer is masked before it can be formatted into a log
+record. The key set mirrors what ``ff-5mp-hass`` already strips from its
+diagnostics download, so the two surfaces cannot disagree about what is safe to
+share.
+
+- ``serialNumber`` / ``checkCode``: together these are full control of the
+  printer over the LAN API.
+- ``flashRegisterCode`` / ``polarRegisterCode``: cloud-account registration
+  codes.
+- ``macAddr`` / ``ipAddr``: identify the machine and its network.
+"""
+
+from typing import Any
+
+REDACTED = "<redacted>"
+
+# Both the firmware's camelCase aliases and the library's snake_case field
+# names, since payloads are logged in either form depending on the call site.
+SENSITIVE_KEYS = frozenset(
+    {
+        "serialNumber",
+        "serial_number",
+        "checkCode",
+        "check_code",
+        "macAddr",
+        "mac_addr",
+        "mac_address",
+        "ipAddr",
+        "ip_addr",
+        "ip_address",
+        "flashRegisterCode",
+        "flash_register_code",
+        "flash_cloud_register_code",
+        "polarRegisterCode",
+        "polar_register_code",
+        "polar_cloud_register_code",
+    }
+)
+
+
+def _redact_value(value: Any) -> Any:
+    """Recurse into nested containers so a sensitive key cannot hide one level down."""
+    if isinstance(value, dict):
+        return redact_mapping(value)
+    if isinstance(value, list):
+        return [_redact_value(item) for item in value]
+    return value
+
+
+def redact_mapping(mapping: dict[str, Any]) -> dict[str, Any]:
+    """Return a copy of ``mapping`` with every sensitive value masked.
+
+    The input is never mutated - callers are usually about to send it.
+    """
+    return {
+        key: (REDACTED if key in SENSITIVE_KEYS else _redact_value(value))
+        for key, value in mapping.items()
+    }
+
+
+def redact_model(model: Any) -> Any:
+    """Return a log-safe representation of a Pydantic model (or anything else).
+
+    Falls back to ``repr`` for objects that cannot be dumped, and to a plain
+    ``<unloggable>`` if even that raises - a redaction helper must never be the
+    reason an error path fails.
+    """
+    if model is None:
+        return None
+
+    dump = getattr(model, "model_dump", None)
+    if callable(dump):
+        try:
+            return redact_mapping(dump())
+        except Exception:  # noqa: BLE001 - logging must not raise
+            pass
+
+    if isinstance(model, dict):
+        return redact_mapping(model)
+
+    try:
+        return repr(model)
+    except Exception:  # noqa: BLE001
+        return "<unloggable>"

flashforge/client.py

@@ -164,7 +164,7 @@ class FlashForgeClient:
             True if TCP operations are permitted, False otherwise
         """
         if self._http_only:
-            print(f"{op}() unavailable: printer has no TCP control channel (HTTP-only).")
+            logger.debug("%s() unavailable: printer has no TCP control channel (HTTP-only).", op)
             return False
         return True
 
@@ -212,7 +212,7 @@ class FlashForgeClient:
         connected = await self.verify_connection()
         if connected:
             return True
-        print("Failed to connect to printer")
+        logger.warning("Failed to connect to the printer.")
         return False
 
     @property
@@ -260,7 +260,7 @@ class FlashForgeClient:
         """
         if await self.send_product_command():
             return await self.tcp_client.init_control()
-        print("New API control failed!")
+        logger.warning("New API control failed; the product command was rejected.")
         return False
 
     async def dispose(self) -> None:
@@ -396,13 +396,13 @@ class FlashForgeClient:
             # Get HTTP API response
             response = await self.info.get_detail_response()
             if not response or not NetworkUtils.is_ok(response):
-                print("Failed to get valid response from printer API")
+                logger.warning("Failed to get a valid response from the printer API.")
                 return False
 
             # Parse machine info from detail response
             machine_info = MachineInfoParser.from_detail(response.detail)
             if not machine_info:
-                print("Failed to parse machine info from detail response")
+                logger.warning("Failed to parse machine info from the /detail response.")
                 return False
 
             # Detect http_only from the parsed model BEFORE touching TCP. The
@@ -426,16 +426,16 @@ class FlashForgeClient:
                     ):
                         self.is_pro = True
                 else:
-                    print(
-                        "Warning: Unable to get PrinterInfo from TCP API, "
-                        "some features might not work"
+                    logger.warning(
+                        "Unable to get PrinterInfo from the TCP API; some features might "
+                        "not work."
                     )
 
             # Cache the details
             return self.cache_details(machine_info)
 
         except Exception as error:
-            print(f"Error in verify_connection: {error}")
+            logger.warning("Error in verify_connection: %s", error)
             return False
 
     async def send_product_command(self) -> bool:

flashforge/tcp/parsers/endstop_status.py

@@ -4,10 +4,13 @@ FlashForge Python API - Endstop Status Parser
 Parses endstop and machine status information from M119 command responses.
 """
 
+import logging
 import re
 from enum import Enum
 from typing import Optional
 
+logger = logging.getLogger(__name__)
+
 # Pre-compiled regex to match key:value pairs where value is an integer
 KV_PATTERN = re.compile(r"([A-Za-z0-9-]+):\s*(\d+)")
 
@@ -144,7 +147,7 @@ class EndstopStatus:
                     elif "BUSY" in machine_status:
                         self.machine_status = MachineStatus.BUSY
                     else:
-                        print(f"EndstopStatus: Encountered unknown MachineStatus: {machine_status}")
+                        logger.warning("EndstopStatus: unknown MachineStatus: %s", machine_status)
                         self.machine_status = MachineStatus.DEFAULT
                 elif line.startswith("MoveMode:"):
                     move_mode = line.replace("MoveMode:", "", 1).strip().upper()
@@ -159,7 +162,7 @@ class EndstopStatus:
                     elif "HOMING" in move_mode:
                         self.move_mode = MoveMode.HOMING
                     else:
-                        print(f"EndstopStatus: Encountered unknown MoveMode: {move_mode}")
+                        logger.warning("EndstopStatus: unknown MoveMode: %s", move_mode)
                         self.move_mode = MoveMode.DEFAULT
                 elif line.startswith("Status "):
                     self.status = Status(line)
@@ -184,9 +187,8 @@ class EndstopStatus:
             return self
 
         except Exception as e:
-            print("Unable to create EndstopStatus instance from replay")
-            print(f"Replay: {replay}")
-            print(f"Error: {e}")
+            logger.warning("Unable to create an EndstopStatus from the reply: %s", e)
+            logger.debug("Reply that failed to parse: %s", replay)
             return None
 
     def is_print_complete(self) -> bool:

flashforge/tcp/parsers/print_status.py

@@ -4,8 +4,11 @@ FlashForge Python API - Print Status Parser
 Parses print progress information from M27 command responses.
 """
 
+import logging
 from typing import Optional
 
+logger = logging.getLogger(__name__)
+
 
 class PrintStatus:
     """
@@ -69,13 +72,13 @@ class PrintStatus:
                         return None
 
             if not self.sd_current or not self.sd_total:
-                print("PrintStatus: Invalid SD progress format")
+                logger.warning("PrintStatus: invalid SD progress format.")
                 return None
 
             return self
 
         except Exception as e:
-            print(f"Error parsing print status: {e}")
+            logger.warning("Error parsing the print status: %s", e)
             return None
 
     def get_print_percent(self) -> float:

flashforge/tcp/parsers/thumbnail_info.py

@@ -6,9 +6,12 @@ Handles the parsing, storage, and manipulation of 3D print file thumbnail images
 
 import asyncio
 import base64
+import logging
 from pathlib import Path
 from typing import Optional
 
+logger = logging.getLogger(__name__)
+
 
 class ThumbnailInfo:
     """
@@ -65,7 +68,7 @@ class ThumbnailInfo:
             # Find where the PNG data starts (after the "ok" text delimiter)
             ok_index = replay.find("ok")
             if ok_index == -1:
-                print("ThumbnailInfo: No 'ok' found in response")
+                logger.warning("ThumbnailInfo: no 'ok' delimiter found in the response.")
                 return None
 
             # Skip the 'ok' text and any immediately following control characters
@@ -87,11 +90,11 @@ class ThumbnailInfo:
                 self._image_data = binary_buffer[png_start:]
                 return self
             else:
-                print("ThumbnailInfo: No PNG signature found in binary data")
+                logger.warning("ThumbnailInfo: no PNG signature found in the binary data.")
                 return None
 
         except Exception as e:
-            print(f"ThumbnailInfo: Error parsing response: {e}")
+            logger.warning("ThumbnailInfo: error parsing the response: %s", e)
             return None
 
     def get_image_data(self) -> str | None:
@@ -157,7 +160,7 @@ class ThumbnailInfo:
             True if the file was saved successfully, False otherwise
         """
         if not self._image_data:
-            print("ThumbnailInfo: No image data to save")
+            logger.warning("ThumbnailInfo: no image data to save.")
             return False
 
         try:
@@ -169,18 +172,20 @@ class ThumbnailInfo:
                 file_path = f"{base_name}.png"
 
             if not file_path:
-                print("ThumbnailInfo: No file path provided and no filename to generate one from")
+                logger.warning(
+                    "ThumbnailInfo: no file path provided and no filename to generate one from."
+                )
                 return False
 
             # Write the bytes to file in a separate thread to avoid blocking the event loop
             loop = asyncio.get_running_loop()
             await loop.run_in_executor(None, self._write_file_sync, file_path, self._image_data)
 
-            print(f"ThumbnailInfo: Saved thumbnail to {file_path}")
+            logger.debug("ThumbnailInfo: saved the thumbnail to %s", file_path)
             return True
 
         except Exception as e:
-            print(f"ThumbnailInfo: Error saving thumbnail to file: {e}")
+            logger.warning("ThumbnailInfo: error saving the thumbnail to a file: %s", e)
             return False
 
     def save_to_file_sync(self, file_path: str | None = None) -> bool:
@@ -194,7 +199,7 @@ class ThumbnailInfo:
             True if the file was saved successfully, False otherwise
         """
         if not self._image_data:
-            print("ThumbnailInfo: No image data to save")
+            logger.warning("ThumbnailInfo: no image data to save.")
             return False
 
         try:
@@ -206,18 +211,20 @@ class ThumbnailInfo:
                 file_path = f"{base_name}.png"
 
             if not file_path:
-                print("ThumbnailInfo: No file path provided and no filename to generate one from")
+                logger.warning(
+                    "ThumbnailInfo: no file path provided and no filename to generate one from."
+                )
                 return False
 
             # Write the bytes to file
             with open(file_path, "wb") as f:
                 f.write(self._image_data)
 
-            print(f"ThumbnailInfo: Saved thumbnail to {file_path}")
+            logger.debug("ThumbnailInfo: saved the thumbnail to %s", file_path)
             return True
 
         except Exception as e:
-            print(f"ThumbnailInfo: Error saving thumbnail to file: {e}")
+            logger.warning("ThumbnailInfo: error saving the thumbnail to a file: %s", e)
             return False
 
     def get_image_size(self) -> tuple[int, int]:

{flashforge_python_api-1.3.2.dist-info → flashforge_python_api-1.3.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flashforge-python-api
-Version: 1.3.2
+Version: 1.3.3
 Summary: A comprehensive Python library for controlling FlashForge 3D printers
 Project-URL: Homepage, https://github.com/GhostTypes/ff-5mp-api-py
 Project-URL: Documentation, https://github.com/GhostTypes/ff-5mp-api-py#readme

{flashforge_python_api-1.3.2.dist-info → flashforge_python_api-1.3.3.dist-info}/RECORD

@@ -1,19 +1,20 @@
 flashforge/__init__.py,sha256=0PGa08cJ2RjAlIyJqX4MW3w1I-FUIg8ftaJ6I-A5cc0,5336
-flashforge/client.py,sha256=CwgRq58JZNuFSNdp3x49kUs6tyxD7KHJGifjPH4_oEw,21321
+flashforge/client.py,sha256=nDtnv3y9XlEQknIkgIUiuOYAiyTEGbQ7tHBdCs2fg1I,21432
 flashforge/api/__init__.py,sha256=vQz-DkG6LTH39bI4fyiUc0D9jQzemLh45pORLptSOlg,335
 flashforge/api/constants/__init__.py,sha256=Q0HL2tqSBYPd4Oz49VHLS3qUvRuv__GCvTGecaLrQ-Y,163
 flashforge/api/constants/commands.py,sha256=XM2rooBESPDaywlZrfW2ECTaLLFaSKXkJ7FQ-RBmVdY,578
 flashforge/api/constants/endpoints.py,sha256=oZtOFfkU64THDeCMUIVv6_0L-BOUZzgLKAUfjHkUhi8,337
 flashforge/api/controls/__init__.py,sha256=53s-H25Pjwr0kvPk8MZ2Twy8VHGqGcO6Q6uBphhEOh4,293
-flashforge/api/controls/control.py,sha256=N1DGpuyvuPWzyMd4_CvbyaQQwoacPIRE8yBaFyy0d9g,14715
-flashforge/api/controls/creator5_palette.py,sha256=41weYaGnnPp5uqKzPixh4whCCo8ZyH9ZKYarzozfMUI,8774
-flashforge/api/controls/files.py,sha256=VhzZaCZ2_dTxHH6AHyhTutklERPSF3ymq3z_qcKpNIw,7848
-flashforge/api/controls/info.py,sha256=WfLeO_BZbqkD2kPXM9cTro7ZOCmn7sxOnd0g6QnA-aw,17559
-flashforge/api/controls/job_control.py,sha256=pO0D0YD_DCfsAwv196XCfrw-xarGZcYkrdxq11wAZEM,31955
-flashforge/api/controls/temp_control.py,sha256=eFMvuBJDWia_zQ5k8v2gKR0AsLtGohZao2sZBSZKgOg,12835
+flashforge/api/controls/control.py,sha256=OgE7K6NkFLwFN1r_q5g1RPwYC8MCt0f6L5CZxDW44d8,15151
+flashforge/api/controls/creator5_palette.py,sha256=zdD3PIXx7hCVj2Fmv1CSFOaqogRUPeBaymgY2DFiMxk,8835
+flashforge/api/controls/files.py,sha256=25yxln9NROas9TtFMZR9e8LtA8ruk8RUu2C81vpNgTk,8043
+flashforge/api/controls/info.py,sha256=jvP4mCkywfV79Uz_z1uJ7qWvEx0MwRoB6ziuvwps_YU,18206
+flashforge/api/controls/job_control.py,sha256=NnACm4LPUz4n8lnRiUl33jilWekS1b6HQTbP--nDzZc,33225
+flashforge/api/controls/temp_control.py,sha256=EOO5TkODirjFcnQ7rZrirxAweHBdVin032AWj-Z8VQs,13040
 flashforge/api/filament/__init__.py,sha256=isT2dl0hzUS0xMTXMm4Tip0GTG1gCsm8LKWa9xPu4Y8,104
 flashforge/api/filament/filament.py,sha256=TtcC2G2nD9Sq4cOrCZzFLZ6Q0Ve-zfrfuEF9uQ8M3eE,1214
 flashforge/api/misc/__init__.py,sha256=1AG7vOMRBZQtHp6QUzfr9alcJPeNv3JpU44NrznxDHs,211
+flashforge/api/misc/redaction.py,sha256=8LG2WsFXhdBqbZ4AXYwpm8hQ_PxaOeAKmZBeG5kzAT4,2675
 flashforge/api/misc/scientific_notation.py,sha256=KSMTrrYhPWLv0gbcEAD6u-jEOcIwUjOCOPMBi0LiO-k,826
 flashforge/api/misc/temperature.py,sha256=qeHlCdPzLyqGDEB874Ib5AgYHMR9Qtw61shnw4G095E,1066
 flashforge/api/network/__init__.py,sha256=G5fBoAlq-NQPDkWp579mFIqsj0v7B1Lb2TAzO6IZA0Q,164
@@ -34,14 +35,14 @@ flashforge/tcp/gcode/a3_gcode_controller.py,sha256=x84_xo_Ll5k6hMAwDWuNUo54znV-B
 flashforge/tcp/gcode/gcode_controller.py,sha256=6K1VGgX59AcE_Kh_gm13dmxCY_kuzV_d2ooSpheONRI,10075
 flashforge/tcp/gcode/gcodes.py,sha256=55Ii1JpJNJNmOnBivyF83vz3TZUPDtp01lX72NINfPQ,3658
 flashforge/tcp/parsers/__init__.py,sha256=kDaJmiH0JcR5i693Fj3pwmINLWN0ipirN3LWGFvPst0,730
-flashforge/tcp/parsers/endstop_status.py,sha256=4OWwE5cyBFhmTPmp18hU4lRr6YSA7sm7U13pHxI1ZJ0,9845
+flashforge/tcp/parsers/endstop_status.py,sha256=k7C5P_TiKlqBxSq2ybRoBDaaDcQ_EgiZe2NLYo7ubiE,9902
 flashforge/tcp/parsers/location_info.py,sha256=0fbqCmQ2EQQe8z9fiX0zP1YsnuVayTs81zmF3_HuGZM,2895
-flashforge/tcp/parsers/print_status.py,sha256=GdmRvkQKMq-JdefsateMYdlTrlEB16wm29DNUQAbiXA,6194
+flashforge/tcp/parsers/print_status.py,sha256=C-KzukhK0TR86AP3t3XrMH4dief6pa3I-yiST4rL0mk,6271
 flashforge/tcp/parsers/printer_info.py,sha256=CHPs6nJfEByXyG3co7Nb8_ygggxkYuc7A9O9bpQEqXE,5441
 flashforge/tcp/parsers/temp_info.py,sha256=9wRGUM9cKvDiZD3SIxBx_qVLZbeXoYsoY3-R3vN3H4g,7938
-flashforge/tcp/parsers/thumbnail_info.py,sha256=11MXltBg3HphSOATVt4mDcyETkHlnL6ngkXJ7KevviY,10201
-flashforge_python_api-1.3.2.dist-info/METADATA,sha256=K_4JvhnuupxESwEv9qzBpv-kHk7v7erICdSewlijVYE,4970
-flashforge_python_api-1.3.2.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
-flashforge_python_api-1.3.2.dist-info/entry_points.txt,sha256=AkOxlsLvQ7cvMLxn7tlzfKp_DCH2hXhbVceHIXxawpU,66
-flashforge_python_api-1.3.2.dist-info/licenses/LICENSE,sha256=-cTA-hrmvlb3pqlQrBZQXUnKayhUjsLJMPb7TD91frM,1067
-flashforge_python_api-1.3.2.dist-info/RECORD,,
+flashforge/tcp/parsers/thumbnail_info.py,sha256=1U1S_gcIZ2lDpEA4622ywUew6TVw0BnzjlBAiihQwzk,10478
+flashforge_python_api-1.3.3.dist-info/METADATA,sha256=UpYv26NPSHt5nqH57396UOE9s-JcirHPuNsD8e1afBM,4970
+flashforge_python_api-1.3.3.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+flashforge_python_api-1.3.3.dist-info/entry_points.txt,sha256=AkOxlsLvQ7cvMLxn7tlzfKp_DCH2hXhbVceHIXxawpU,66
+flashforge_python_api-1.3.3.dist-info/licenses/LICENSE,sha256=-cTA-hrmvlb3pqlQrBZQXUnKayhUjsLJMPb7TD91frM,1067
+flashforge_python_api-1.3.3.dist-info/RECORD,,