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

flashforge/__init__.py

@@ -127,7 +127,7 @@ from .tcp import (
 )
 
 FiveMClient = FlashForgeClient
-__version__ = "1.3.0"
+__version__ = "1.3.1"
 __author__ = "FlashForge Python API Contributors"
 __email__ = "notghosttypes@gmail.com"
 __description__ = "Python library for controlling FlashForge 3D printers"

flashforge/api/controls/creator5_palette.py

@@ -70,7 +70,7 @@ CREATOR5_PALETTE: tuple[Creator5PaletteColor, ...] = (
 )
 
 # 25^7, the CIEDE2000 chroma weighting constant.
-_25_POW_7 = 25.0 ** 7
+_25_POW_7 = 25.0**7
 
 # D65 reference white point used by the sRGB -> XYZ transform.
 _D65_XN = 0.95047
@@ -132,7 +132,7 @@ def _delta_e_2000(c1: tuple[float, float, float], c2: tuple[float, float, float]
     C1 = math.sqrt(a1 * a1 + b1 * b1)
     C2 = math.sqrt(a2 * a2 + b2 * b2)
     Cbar = (C1 + C2) / 2.0
-    Cbar7 = Cbar ** 7
+    Cbar7 = Cbar**7
     G = 0.5 * (1 - math.sqrt(Cbar7 / (Cbar7 + _25_POW_7)))
 
     a1p = (1 + G) * a1
@@ -178,7 +178,7 @@ def _delta_e_2000(c1: tuple[float, float, float], c2: tuple[float, float, float]
     )
 
     dTheta = 30 * math.exp(-(((hbarp - 275) / 25.0) ** 2))
-    Cbarp7 = Cbarp ** 7
+    Cbarp7 = Cbarp**7
     RC = 2 * math.sqrt(Cbarp7 / (Cbarp7 + _25_POW_7))
     SL = 1 + (0.015 * (Lbarp - 50) ** 2) / math.sqrt(20 + (Lbarp - 50) ** 2)
     SC = 1 + 0.045 * Cbarp

flashforge/api/controls/files.py

@@ -3,6 +3,7 @@ FlashForge Python API - Files Module
 """
 
 import base64
+import logging
 from typing import TYPE_CHECKING
 
 from pydantic import ValidationError
@@ -15,6 +16,8 @@ from ..network.utils import NetworkUtils, json_from_response
 if TYPE_CHECKING:
     from ...client import FlashForgeClient
 
+logger = logging.getLogger(__name__)
+
 
 class Files:
     """
@@ -93,7 +96,18 @@ class Files:
                 # Parse the response using GCodeListResponse
                 try:
                     result = GCodeListResponse(**data)
-                except ValidationError:
+                except ValidationError as err:
+                    # The names-only fallback below silently costs the caller
+                    # every per-file field, which is indistinguishable from a
+                    # printer that only reports names. Say so, loudly enough to
+                    # reach an integration's log, or the next model that changes
+                    # this payload looks like it reports no metadata at all.
+                    logger.warning(
+                        "Could not parse the /gcodeList response; falling back to file "
+                        "names only, so print time, filament weight, and per-tool "
+                        "material data are unavailable for every file. %s",
+                        err,
+                    )
                     raw_list = data.get("gcodeList", [])
                     if isinstance(raw_list, list):
                         entries: list[FFGcodeFileEntry] = []
@@ -127,9 +141,7 @@ class Files:
                     elif isinstance(first_item, FFGcodeFileEntry):
                         # Already FFGcodeFileEntry objects - need explicit type narrowing
                         return [
-                            item
-                            for item in result.gcode_list
-                            if isinstance(item, FFGcodeFileEntry)
+                            item for item in result.gcode_list if isinstance(item, FFGcodeFileEntry)
                         ]
 
                 return []

flashforge/api/controls/info.py

@@ -89,10 +89,17 @@ class MachineInfoParser:
             print_progress = getattr(detail, "print_progress", 0) or 0
             est_length = total_job_filament_meters * print_progress
             est_weight = (getattr(detail, "estimated_right_weight", 0) or 0) * print_progress
+            # Material Station presence, derived rather than read off a single
+            # field. `hasMatlStation` is AD5X-only: the Creator 5 series omits it
+            # from /detail entirely (verified on a Creator 5 Pro, pid 41, firmware
+            # 1.9.4) while reporting a fully populated matlStationInfo with four
+            # loaded slots, so an absent flag means "not reported", never "absent
+            # hardware". Populated slot data is the reliable signal.
             has_material_station = (
                 getattr(detail, "has_matl_station", None) is True
                 or (getattr(getattr(detail, "matl_station_info", None), "slot_cnt", 0) or 0) > 0
-                or len(getattr(getattr(detail, "matl_station_info", None), "slot_infos", []) or []) > 0
+                or len(getattr(getattr(detail, "matl_station_info", None), "slot_infos", []) or [])
+                > 0
             )
             printer_name = getattr(detail, "name", "") or ""
             pid = getattr(detail, "pid", None)
@@ -236,7 +243,9 @@ class MachineInfoParser:
                 print_speed_adjust=getattr(detail, "print_speed_adjust", 0) or 0,
                 filament_type=getattr(detail, "right_filament_type", "") or "",
                 # Machine state
-                machine_state=MachineInfoParser._get_machine_state(getattr(detail, "status", "") or ""),
+                machine_state=MachineInfoParser._get_machine_state(
+                    getattr(detail, "status", "") or ""
+                ),
                 status=getattr(detail, "status", "") or "",
                 total_print_layers=getattr(detail, "target_print_layer", 0) or 0,
                 tvoc=getattr(detail, "tvoc", 0) or 0,
@@ -249,8 +258,8 @@ class MachineInfoParser:
                 completion_time=completion_time,
                 formatted_run_time=formatted_run_time,
                 formatted_total_run_time=formatted_total_run_time,
-                # AD5X Material Station
-                has_matl_station=getattr(detail, "has_matl_station", None),
+                # Material Station (AD5X / Creator 5 series)
+                has_matl_station=has_material_station,
                 matl_station_info=getattr(detail, "matl_station_info", None),
                 indep_matl_info=getattr(detail, "indep_matl_info", None),
             )

flashforge/api/controls/job_control.py

@@ -698,9 +698,7 @@ 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"
-            )
+            print(f"{label} error: materialMappings array cannot be empty for multi-color jobs")
             return False
 
         if len(material_mappings) > 4:
@@ -784,7 +782,9 @@ class JobControl:
             return base64.b64encode(json_string.encode("utf-8")).decode("utf-8")
         except Exception as error:
             print("Failed to encode material mappings to base64:", error)
-            raise Exception("Failed to encode material mappings for upload") from error  # noqa: B904
+            raise Exception(
+                "Failed to encode material mappings for upload"
+            ) from error  # noqa: B904
 
     def _validate_material_mappings(self, material_mappings: list[AD5XMaterialMapping]) -> bool:
         """

flashforge/api/controls/temp_control.py

@@ -270,9 +270,7 @@ 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."
-            )
+            print("cancel_chamber_temp() error, chamber heater only available on Creator 5 series.")
             return False
         return await self._send_http_temp_command(chamber=TEMP_OFF)
 

flashforge/client.py

@@ -6,9 +6,11 @@ communication layers for controlling FlashForge 3D printers.
 """
 
 import asyncio
+import logging
 from dataclasses import dataclass
 
 import aiohttp
+from pydantic import ValidationError
 
 from .api.constants.endpoints import CAMERA_STREAM_PORT, Endpoints
 from .api.controls import Control, Files, Info, JobControl, TempControl
@@ -19,6 +21,8 @@ from .tcp import FlashForgeClient as TcpClient
 from .tcp import FlashForgeTcpClientOptions, PrinterInfo
 from .tcp.parsers.temp_info import TempInfo
 
+logger = logging.getLogger(__name__)
+
 
 @dataclass(slots=True)
 class FiveMClientConnectionOptions:
@@ -476,8 +480,21 @@ class FlashForgeClient:
                     self._apply_feature_overrides()
                     return True
 
+        except ValidationError as error:
+            # Distinct from a rejected check code, and it must not read as one:
+            # the printer answered 200 with code 0, we simply could not parse
+            # what it said. Callers treat a False return as bad credentials
+            # (ff-5mp-hass surfaces it as "check code incorrect"), so the log
+            # line is the only place the real cause can surface.
+            logger.warning(
+                "Could not parse the /product response; reporting the printer as "
+                "unavailable rather than the credentials as rejected. This usually "
+                "means the firmware added a field this library has not seen. %s",
+                error,
+            )
+            return False
         except Exception as error:
-            print(f"Error in send_product_command: {error}")
+            logger.warning("Error in send_product_command: %s", error)
             return False
         finally:
             self._http_client_busy = False

flashforge/discovery/discovery.py

@@ -303,7 +303,9 @@ class PrinterDiscovery:
             try:
                 transport, _ = await self._create_endpoint(message_queue, error_queue)
                 self._send_discovery_packets(transport, config)
-                discovered_printers = await self._receive_responses(message_queue, error_queue, config)
+                discovered_printers = await self._receive_responses(
+                    message_queue, error_queue, config
+                )
 
                 for printer in discovered_printers:
                     key = f"{printer.ip_address}:{printer.command_port}"
@@ -454,7 +456,9 @@ class PrinterDiscovery:
         status_code = int.from_bytes(buffer[0x8A:0x8C], byteorder="big")
         product_type = int.from_bytes(buffer[0x8C:0x8E], byteorder="big")
         event_port = int.from_bytes(buffer[0x8E:0x90], byteorder="big")
-        serial_number = buffer[0x92 : 0x92 + 128].decode("utf-8", errors="ignore").split("\x00", 1)[0]
+        serial_number = (
+            buffer[0x92 : 0x92 + 128].decode("utf-8", errors="ignore").split("\x00", 1)[0]
+        )
         model = self.detect_modern_model(name, product_type, product_id)
 
         return DiscoveredPrinter(
@@ -586,9 +590,7 @@ class PrinterDiscovery:
                         continue
 
                     mask_int = (0xFFFFFFFF << (32 - prefix)) & 0xFFFFFFFF
-                    netmask = ".".join(
-                        str((mask_int >> (8 * (3 - i))) & 0xFF) for i in range(4)
-                    )
+                    netmask = ".".join(str((mask_int >> (8 * (3 - i))) & 0xFF) for i in range(4))
 
                     broadcast = self.calculate_broadcast_address(ip_addr, netmask)
                     if broadcast and broadcast not in broadcast_addresses:
@@ -695,7 +697,9 @@ class FlashForgePrinterDiscovery:
             return None
 
         if LEGACY_PROTOCOL_SIZE <= len(response) < MODERN_PROTOCOL_SIZE and len(response) >= 0x92:
-            legacy_name = response[0:32].decode("utf-8", errors="ignore").split("\x00", 1)[0].strip()
+            legacy_name = (
+                response[0:32].decode("utf-8", errors="ignore").split("\x00", 1)[0].strip()
+            )
             legacy_serial = (
                 response[0x92 : 0x92 + 32]
                 .decode("utf-8", errors="ignore")

flashforge/models/machine_info.py

@@ -29,6 +29,10 @@ class MachineState(Enum):
 class Temperature(BaseModel):
     """Represents a pair of current and target temperatures for a component like an extruder or print bed."""
 
+    # `extra="forbid"` deliberately: this model is never parsed from a printer
+    # payload, only constructed by MachineInfoParser.from_detail. Forbidding
+    # extras there catches a typo'd keyword argument in our own parser, which
+    # `extra="allow"` would silently absorb.
     model_config = ConfigDict(extra="forbid")
 
     current: float = Field(
@@ -42,7 +46,12 @@ class Temperature(BaseModel):
 class SlotInfo(BaseModel):
     """Information about a single slot in the material station."""
 
-    model_config = ConfigDict(extra="forbid", populate_by_name=True)
+    # `extra="allow"`: inbound, nested under FFPrinterDetail.matl_station_info.
+    # FFPrinterDetail allowing extras is not enough on its own - a new field on
+    # a *child* fails validation for the whole /detail response, and
+    # `Info.get_detail_response` swallows that and returns None, which the HA
+    # integration reports as "could not retrieve printer information".
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
 
     has_filament: bool = Field(
         alias="hasFilament", description="Indicates if filament is present in this slot"
@@ -69,7 +78,8 @@ class SlotInfo(BaseModel):
 class MatlStationInfo(BaseModel):
     """Detailed information about the material station."""
 
-    model_config = ConfigDict(extra="forbid", populate_by_name=True)
+    # `extra="allow"`: inbound, see SlotInfo.
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
 
     current_load_slot: int = Field(
         alias="currentLoadSlot", ge=0, le=4, description="Currently loading slot ID (0 if none)"
@@ -98,7 +108,8 @@ class MatlStationInfo(BaseModel):
 class IndepMatlInfo(BaseModel):
     """Information related to independent material loading, often used when a single extruder printer has a material station."""
 
-    model_config = ConfigDict(extra="forbid", populate_by_name=True)
+    # `extra="allow"`: inbound, see SlotInfo.
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
 
     material_color: str = Field(alias="materialColor", description="Color of the material")
     material_name: str = Field(
@@ -123,7 +134,10 @@ class IndepMatlInfo(BaseModel):
 class FFGcodeToolData(BaseModel):
     """Represents data for a single tool/material used in a G-code file, typically part of a multi-material print."""
 
-    model_config = ConfigDict(extra="forbid", populate_by_name=True)
+    # `extra="allow"`: inbound, nested under FFGcodeFileEntry - which already
+    # allows extras, but a child that forbids them reintroduces the same
+    # names-only fallback it was flipped to avoid.
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
 
     filament_weight: float = Field(
         alias="filamentWeight",
@@ -158,7 +172,11 @@ class FFGcodeToolData(BaseModel):
 class FFGcodeFileEntry(BaseModel):
     """Represents a single G-code file entry as returned by the /gcodeList endpoint, especially for printers like AD5X that provide detailed material info."""
 
-    model_config = ConfigDict(extra="forbid", populate_by_name=True)
+    # `extra="allow"`, matching FFPrinterDetail: a firmware update that adds one
+    # field must not fail validation, because Files.get_recent_file_list falls
+    # back to a names-only list when it does - silently dropping print time,
+    # filament weight, and the per-tool material data for EVERY file.
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
 
     gcode_file_name: str = Field(
         alias="gcodeFileName", description="The name of the G-code file (e.g., 'FISH_PLA.3mf')"
@@ -231,6 +249,10 @@ class FFPrinterDetail(BaseModel):
     fill_amount: float | None = Field(default=None, ge=0, le=100, alias="fillAmount")
     firmware_version: str | None = Field(default=None, alias="firmwareVersion")
     flash_register_code: str | None = Field(default=None, alias="flashRegisterCode")
+    # AD5X-only, and firmware omits what does not apply: the Creator 5 series
+    # leaves this out of /detail even with four loaded slots, so None means "not
+    # reported", NOT "no station". Never gate a feature on it - read the derived
+    # FFMachineInfo.has_matl_station, or check matl_station_info yourself.
     has_matl_station: bool | None = Field(default=None, alias="hasMatlStation")
     matl_station_info: MatlStationInfo | None = Field(default=None, alias="matlStationInfo")
     indep_matl_info: IndepMatlInfo | None = Field(default=None, alias="indepMatlInfo")
@@ -289,6 +311,10 @@ class FFMachineInfo(BaseModel):
     This interface is populated by transforming data from FFPrinterDetail.
     """
 
+    # `extra="forbid"` deliberately: see Temperature. Built only at
+    # `MachineInfoParser.from_detail`, from ~50 keyword arguments, never from
+    # raw printer JSON - so forbidding extras is a typo check on our own code,
+    # not a firmware-compatibility risk.
     model_config = ConfigDict(extra="forbid")
 
     # Auto-shutdown settings
@@ -395,8 +421,15 @@ class FFMachineInfo(BaseModel):
     formatted_run_time: str = "00:00"
     formatted_total_run_time: str = "0h:0m"
 
-    # AD5X Material Station
-    has_matl_station: bool | None = None
+    # Material Station (AD5X / Creator 5 series)
+    #
+    # A capability, not a passthrough: MachineInfoParser DERIVES this from the
+    # station data rather than copying the raw `hasMatlStation` field, which the
+    # Creator 5 series never reports even with a station attached. It is a plain
+    # bool on purpose - there is no "unknown" state to represent, and offering
+    # one is what let an unreported flag read as absent hardware. For the
+    # untouched firmware value, read FFPrinterDetail.has_matl_station.
+    has_matl_station: bool = False
     matl_station_info: MatlStationInfo | None = None
     indep_matl_info: IndepMatlInfo | None = None
 

flashforge/models/responses.py

@@ -10,7 +10,12 @@ from .machine_info import FFGcodeFileEntry, FFPrinterDetail
 class GenericResponse(BaseModel):
     """Represents a generic response from the printer's API."""
 
-    model_config = ConfigDict(extra="forbid")
+    # `extra="allow"` on every inbound model: this is the envelope each printer
+    # response inherits, so a firmware update that adds one top-level key must
+    # not fail validation here. Callers cannot tell a parse failure from a real
+    # error - `send_product_command` returns a bare False either way, which the
+    # HA integration reports to the user as "check code incorrect".
+    model_config = ConfigDict(extra="allow")
 
     code: int
     message: str = ""
@@ -19,8 +24,6 @@ class GenericResponse(BaseModel):
 class DetailResponse(GenericResponse):
     """Represents the structure of the response from the printer's detail endpoint."""
 
-    model_config = ConfigDict(extra="forbid")
-
     detail: FFPrinterDetail
 
 
@@ -36,7 +39,10 @@ class Product(BaseModel):
     Field names match the actual camelCase format returned by the printer.
     """
 
-    model_config = ConfigDict(extra="forbid")
+    # `extra="allow"`: an unrecognized control-state flag must not fail
+    # validation. `send_product_command` has no fallback - it returns False,
+    # which is indistinguishable from the printer rejecting the credentials.
+    model_config = ConfigDict(extra="allow")
 
     chamberTempCtrlState: int  # noqa: N815 - field must match API camelCase response format
     externalFanCtrlState: int  # noqa: N815 - field must match API camelCase response format
@@ -55,8 +61,6 @@ class ProductResponse(GenericResponse):
     and a nested `product` object containing specific control states.
     """
 
-    model_config = ConfigDict(extra="forbid")
-
     product: Product
 
 
@@ -96,6 +100,10 @@ class FilamentArgs(BaseModel):
 class AD5XMaterialMapping(BaseModel):
     """Represents a material mapping for AD5X multi-color printing. Maps a tool (extruder) to a specific material station slot."""
 
+    # `extra="forbid"` deliberately, as on every outbound param model below:
+    # these are request bodies this library constructs, so no firmware update
+    # can break them, and forbidding extras turns a caller's typo'd keyword
+    # into an error instead of a field the printer silently ignores.
     model_config = ConfigDict(extra="forbid", populate_by_name=True)
 
     tool_id: int = Field(ge=0, le=3, description="Tool ID (0-based: 0, 1, 2, 3)")
@@ -181,9 +189,7 @@ class Creator5JobParams(BaseModel):
     leveling_before_print: bool = Field(
         description="Whether to perform bed leveling before printing"
     )
-    flow_calibration: bool = Field(
-        default=False, description="Whether to enable flow calibration"
-    )
+    flow_calibration: bool = Field(default=False, description="Whether to enable flow calibration")
     time_lapse_video: bool = Field(
         default=False, description="Whether to enable time lapse video recording"
     )
@@ -209,15 +215,11 @@ class Creator5UploadParams(BaseModel):
     leveling_before_print: bool = Field(
         description="Whether to perform bed leveling before printing"
     )
-    flow_calibration: bool = Field(
-        default=False, description="Whether to enable flow calibration"
-    )
+    flow_calibration: bool = Field(default=False, description="Whether to enable flow calibration")
     time_lapse_video: bool = Field(
         default=False, description="Whether to enable time lapse video recording"
     )
-    use_matl_station: bool = Field(
-        description="Whether this is a multi-tool material-station job"
-    )
+    use_matl_station: bool = Field(description="Whether this is a multi-tool material-station job")
     gcode_tool_cnt: int = Field(
         ge=1, le=4, description="Number of tools in the G-code (1-4 for the C5)"
     )
@@ -226,7 +228,9 @@ class Creator5UploadParams(BaseModel):
 class GCodeListResponse(GenericResponse):
     """Represents the response structure for a G-code file list request."""
 
-    model_config = ConfigDict(extra="forbid", populate_by_name=True)
+    # `extra="allow"`: see FFGcodeFileEntry. An unknown field at either level
+    # costs the caller all per-file metadata, so neither level may forbid one.
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
 
     gcode_list: list[str] | list[FFGcodeFileEntry] | None = Field(default=None, alias="gcodeList")
     gcode_list_detail: list[FFGcodeFileEntry] | None = Field(default=None, alias="gcodeListDetail")
@@ -235,7 +239,8 @@ class GCodeListResponse(GenericResponse):
 class ThumbnailResponse(GenericResponse):
     """Represents the response structure for a G-code thumbnail request."""
 
-    model_config = ConfigDict(extra="forbid", populate_by_name=True)
+    # `extra="allow"`: inbound, see GenericResponse.
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
 
     image_data: str = Field(
         alias="imageData", description="The thumbnail image data encoded as a base64 string"

flashforge/tcp/a3_client.py

@@ -84,7 +84,11 @@ class FlashForgeA3Client(FlashForgeTcpClient):
         bare_cmd = self._strip_protocol_prefix(cmd)
         if bare_cmd.startswith("M661"):
             return 500
-        if bare_cmd.startswith("M115") or bare_cmd.startswith("M119") or bare_cmd.startswith("M650"):
+        if (
+            bare_cmd.startswith("M115")
+            or bare_cmd.startswith("M119")
+            or bare_cmd.startswith("M650")
+        ):
             return 250
         return 200
 
@@ -102,7 +106,7 @@ class FlashForgeA3Client(FlashForgeTcpClient):
         if "Error: File not exists" in text_prefix:
             return True
 
-        magic_offset = buffer.find(b"\xA2\xA2\x2A\x2A")
+        magic_offset = buffer.find(b"\xa2\xa2\x2a\x2a")
         if magic_offset == -1 or len(buffer) < magic_offset + 8:
             return False
 
@@ -163,7 +167,9 @@ class FlashForgeA3Client(FlashForgeTcpClient):
             elif line.startswith("Mac Address:"):
                 info.mac_address = line.replace("Mac Address:", "", 1).strip()
             else:
-                volume_match = re.search(r"X:\s*(\d+)\s+Y:\s*(\d+)\s+Z:\s*(\d+)", line, re.IGNORECASE)
+                volume_match = re.search(
+                    r"X:\s*(\d+)\s+Y:\s*(\d+)\s+Z:\s*(\d+)", line, re.IGNORECASE
+                )
                 if volume_match:
                     info.build_volume = A3BuildVolume(
                         x=int(volume_match.group(1)),
@@ -331,7 +337,11 @@ class FlashForgeA3Client(FlashForgeTcpClient):
 
         files: list[A3FileEntry] = []
         count_index = next(
-            (index for index, line in enumerate(lines) if re.search(r"info_list\.size:\s*\d+", line)),
+            (
+                index
+                for index, line in enumerate(lines)
+                if re.search(r"info_list\.size:\s*\d+", line)
+            ),
             -1,
         )
         if count_index == -1:
@@ -354,11 +364,13 @@ class FlashForgeA3Client(FlashForgeTcpClient):
         if "Error: File not exists" in error_text:
             return None
 
-        magic_offset = buffer.find(b"\xA2\xA2\x2A\x2A")
+        magic_offset = buffer.find(b"\xa2\xa2\x2a\x2a")
         if magic_offset == -1 or len(buffer) < magic_offset + 8:
             return None
 
-        payload_length = int.from_bytes(buffer[magic_offset + 4 : magic_offset + 8], byteorder="big")
+        payload_length = int.from_bytes(
+            buffer[magic_offset + 4 : magic_offset + 8], byteorder="big"
+        )
         payload_end = magic_offset + 8 + payload_length
         if len(buffer) < payload_end:
             return None
@@ -378,7 +390,11 @@ class FlashForgeA3Client(FlashForgeTcpClient):
         return normalized.rstrip()
 
     def _get_normalized_lines(self, response: str) -> list[str]:
-        return [line.strip() for line in self._normalize_a3_text_response(response).split("\n") if line.strip()]
+        return [
+            line.strip()
+            for line in self._normalize_a3_text_response(response).split("\n")
+            if line.strip()
+        ]
 
     def _map_controller_command(self, cmd: str) -> str:
         if cmd == "~M146 r255 g255 b255 F0":
@@ -399,7 +415,10 @@ class FlashForgeA3Client(FlashForgeTcpClient):
         if bare_cmd.startswith("M23"):
             return "File opened" in normalized or "ok" in normalized
         if bare_cmd.startswith("M112"):
-            return bool(re.search(r"Emergency Stop", normalized, re.IGNORECASE)) or "Received." in normalized
+            return (
+                bool(re.search(r"Emergency Stop", normalized, re.IGNORECASE))
+                or "Received." in normalized
+            )
         if "ok" in normalized or "Received." in normalized:
             return True
         return normalized.startswith(bare_cmd)

flashforge/tcp/a4_client.py

@@ -274,7 +274,11 @@ class FlashForgeA4Client(FlashForgeTcpClient):
         return normalized
 
     def _get_normalized_lines(self, response: str) -> list[str]:
-        return [line.strip() for line in self._normalize_a4_text_response(response).split("\n") if line.strip()]
+        return [
+            line.strip()
+            for line in self._normalize_a4_text_response(response).split("\n")
+            if line.strip()
+        ]
 
     def _detect_variant(self, machine_type: str) -> A4PrinterVariant:
         normalized_type = machine_type.upper()

flashforge/tcp/parsers/endstop_status.py

@@ -118,7 +118,9 @@ class EndstopStatus:
             return None
 
         try:
-            lines = [line.strip() for line in replay.replace("\r", "\n").split("\n") if line.strip()]
+            lines = [
+                line.strip() for line in replay.replace("\r", "\n").split("\n") if line.strip()
+            ]
             if not lines:
                 return None
 

flashforge/tcp/parsers/location_info.py

@@ -47,7 +47,9 @@ class LocationInfo:
             The populated LocationInfo instance, or None if parsing fails
         """
         try:
-            lines = [line.strip() for line in replay.replace("\r", "\n").split("\n") if line.strip()]
+            lines = [
+                line.strip() for line in replay.replace("\r", "\n").split("\n") if line.strip()
+            ]
             coordinate_line = next(
                 (line for line in lines if "X:" in line and "Y:" in line and "Z:" in line),
                 "",

flashforge/tcp/parsers/print_status.py

@@ -48,7 +48,9 @@ class PrintStatus:
             self.sd_total = ""
             self.layer_current = ""
             self.layer_total = ""
-            lines = [line.strip() for line in replay.replace("\r", "\n").split("\n") if line.strip()]
+            lines = [
+                line.strip() for line in replay.replace("\r", "\n").split("\n") if line.strip()
+            ]
 
             for line in lines:
                 if "SD printing byte " in line:

flashforge/tcp/parsers/printer_info.py

@@ -70,7 +70,9 @@ class PrinterInfo:
             return None
 
         try:
-            lines = [line.strip() for line in replay.replace("\r", "\n").split("\n") if line.strip()]
+            lines = [
+                line.strip() for line in replay.replace("\r", "\n").split("\n") if line.strip()
+            ]
 
             for line in lines:
                 if line.startswith("Machine Type:"):

flashforge/tcp/parsers/temp_info.py

@@ -127,7 +127,9 @@ class TempInfo:
             return None
 
         try:
-            lines = [line.strip() for line in replay.replace("\r", "\n").split("\n") if line.strip()]
+            lines = [
+                line.strip() for line in replay.replace("\r", "\n").split("\n") if line.strip()
+            ]
             if not lines:
                 logger.error("TempInfo replay has invalid data: %s", replay)
                 return None

flashforge/tcp/parsers/thumbnail_info.py

@@ -50,7 +50,7 @@ class ThumbnailInfo:
                 return None
 
             binary_buffer = replay.encode("latin1")
-            magic_marker = b"\xA2\xA2\x2A\x2A"
+            magic_marker = b"\xa2\xa2\x2a\x2a"
             magic_offset = binary_buffer.find(magic_marker)
             if magic_offset >= 0 and len(binary_buffer) >= magic_offset + 8:
                 payload_length = int.from_bytes(

flashforge/tcp/tcp_client.py

@@ -150,10 +150,9 @@ class FlashForgeTcpClient:
             logger.error("Upload failed: remote file name resolved to an empty value.")
             return False
 
-        start_command = (
-            GCodes.CMD_PREP_FILE_UPLOAD.replace("%%size%%", str(file_path.stat().st_size))
-            .replace("%%filename%%", normalized_file_name)
-        )
+        start_command = GCodes.CMD_PREP_FILE_UPLOAD.replace(
+            "%%size%%", str(file_path.stat().st_size)
+        ).replace("%%filename%%", normalized_file_name)
 
         async with self._socket_lock:
             try:
@@ -184,7 +183,9 @@ class FlashForgeTcpClient:
                     GCodes.CMD_COMPLETE_FILE_UPLOAD
                 )
                 if not finish_response:
-                    logger.error("Upload failed: printer did not respond to M29 upload finalization.")
+                    logger.error(
+                        "Upload failed: printer did not respond to M29 upload finalization."
+                    )
                     return False
 
                 return self._is_successful_upload_boundary_response(

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flashforge-python-api
-Version: 1.3.0
+Version: 1.3.2
 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
@@ -57,6 +57,8 @@ Python library for controlling FlashForge 3D printers with async support for the
 | Adventurer 5M | Full |
 | Adventurer 5M Pro | Full |
 | AD5X | Full |
+| Creator 5 | Full (HTTP-only) |
+| Creator 5 Pro | Full (HTTP-only) |
 | Adventurer 3 / 4 | Dedicated TCP clients |
 
 ## Installation
@@ -138,9 +140,9 @@ asyncio.run(main())
 - printer status and machine information
 - job control
 - file listing, uploads, and thumbnails
-- temperature and motion control
+- temperature and motion control, including per-nozzle and chamber temperature control (Creator 5)
 - LED, camera, and filtration control where supported
-- AD5X-specific job and material-station support
+- AD5X and Creator 5 / Creator 5 Pro material-station, slot configuration, and material mapping
 
 ## Documentation
 

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

@@ -1,16 +1,16 @@
-flashforge/__init__.py,sha256=T-Rf3whhvd9klW5n-Jwbo422twqFEVXH3pyShkw5JgU,5336
-flashforge/client.py,sha256=y2LjwfBhlS8fwIFEITybvq1Wi_9JdIiJ4pEzw0OdqEo,20463
+flashforge/__init__.py,sha256=0PGa08cJ2RjAlIyJqX4MW3w1I-FUIg8ftaJ6I-A5cc0,5336
+flashforge/client.py,sha256=CwgRq58JZNuFSNdp3x49kUs6tyxD7KHJGifjPH4_oEw,21321
 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=hB0OF4sOrf7bVy3n4cPocJkfr8uM1MHRRg4ccCd6xfU,8780
-flashforge/api/controls/files.py,sha256=BhSQxXMt8MX2acyWtRzyNXfPYHsy6IkCwH04ksMCIp4,7114
-flashforge/api/controls/info.py,sha256=fQ5ICxAfIK4VojcSee_TYM8H585oPJWRDAgwv8MH5Mk,17029
-flashforge/api/controls/job_control.py,sha256=uLZQgtzto15AOauUgNg-031cSy_m1W28p9H8y3vZi9M,31955
-flashforge/api/controls/temp_control.py,sha256=x9KWkkk6dgdOFR1DAWj2fW7tn-PH0ne-xyrB0XidsTo,12865
+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/filament/__init__.py,sha256=isT2dl0hzUS0xMTXMm4Tip0GTG1gCsm8LKWa9xPu4Y8,104
 flashforge/api/filament/filament.py,sha256=TtcC2G2nD9Sq4cOrCZzFLZ6Q0Ve-zfrfuEF9uQ8M3eE,1214
 flashforge/api/misc/__init__.py,sha256=1AG7vOMRBZQtHp6QUzfr9alcJPeNv3JpU44NrznxDHs,211
@@ -20,28 +20,28 @@ flashforge/api/network/__init__.py,sha256=G5fBoAlq-NQPDkWp579mFIqsj0v7B1Lb2TAzO6
 flashforge/api/network/fnet_code.py,sha256=BR2niVKKk4ZfXtizUDIMXzDhlCxPHzqWg5AQQIcoj3g,402
 flashforge/api/network/utils.py,sha256=Q5-Vj_1VN611QV_TGpDzrrZ2X8PqaGT0j00BhSHv5MM,2096
 flashforge/discovery/__init__.py,sha256=G0WiP70EhfHdjXR1RNlv6xjhyHOdo-HWyOm9J0ds4SM,828
-flashforge/discovery/discovery.py,sha256=c_lT8pgegEAp9LV5seljp5TQLjNxEQcE8CXAAOvpWQ4,27566
+flashforge/discovery/discovery.py,sha256=-hOmVIpn8gu-rPYo8FRBfhKb_tBqwamLfmoPVYaDzLI,27614
 flashforge/models/__init__.py,sha256=hdcK0E4KeDfv_A8Y2aPOHgHziwTjP1RPb_VP-89dOzQ,1086
-flashforge/models/machine_info.py,sha256=wqVOTkxhRf2zrt0yr3SGJGr8SRnMXYiqEBZzQBLJHc0,17064
-flashforge/models/responses.py,sha256=q5DtcTys0g_QIdn_CeYMykQrzyg5TGo11B7T5OCYj-A,9654
+flashforge/models/machine_info.py,sha256=UD-BQ-VzceSIoFFrpuFPJLpaisdgxBRxVD8SZ20mF4E,19384
+flashforge/models/responses.py,sha256=10-8yFfZtLuDmH1TK2xVYl-Uf-zT2WEJnpb2H5ZK3ZU,10637
 flashforge/tcp/__init__.py,sha256=hpnqoWHeRtTwJPzdsVlwGt1njKbAkrgIHKADkLSIRec,1317
-flashforge/tcp/a3_client.py,sha256=a1jdDcBnTSNrzJFKTuVV13fSLbZmxKEZ94n3cGf3wOA,15603
-flashforge/tcp/a4_client.py,sha256=0KH5zfsbWaPRd7xSKb7YA3oZTkCVdsdcTA9LPl3S55Q,11167
+flashforge/tcp/a3_client.py,sha256=Aqb6MuKkjnNUVdE2LbZKd7bPlFK8XPIm17C_BG_PuNU,15867
+flashforge/tcp/a4_client.py,sha256=snmAvTCpSWFjxb8h6V7H4tk5yOoMqKEzKoBY_1JaaPs,11213
 flashforge/tcp/ff_client.py,sha256=CJXk0Qei2FVSpbXxZhiEQgAEcTJaBab1ouooqyC4OL4,20235
-flashforge/tcp/tcp_client.py,sha256=KjymxUXiXgEp9y7mjr5tNO_Y2-bsGEyP-oG5en7rCCs,16996
+flashforge/tcp/tcp_client.py,sha256=Ae5Z5rLJFoDYxP3T6Q_PtVNkUr94QqFEWPKtgFyMIJw,17027
 flashforge/tcp/gcode/__init__.py,sha256=tFGlqCPFxVJNizXsIG4pMOK7IPFNnc_vIEMciULYkMY,271
 flashforge/tcp/gcode/a3_gcode_controller.py,sha256=x84_xo_Ll5k6hMAwDWuNUo54znV-BBIfwnmeOiEa9Fs,3688
 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=4jTtodJiiAVeeU8Z5daFtETm8ExPGo5P1CQWZ9KYrfg,9815
-flashforge/tcp/parsers/location_info.py,sha256=n1lUUmbk4kuuuBUbIA65dlPa4tsVGUJFlwnoeRW0yx8,2865
-flashforge/tcp/parsers/print_status.py,sha256=4q9ZlJfO0c7_t1o15tgxbguMxpDjEW9pMyaFU6a0Nfk,6164
-flashforge/tcp/parsers/printer_info.py,sha256=QY6LECfcOhVHSIdsvQZwJago0OjXroUwiX0H-uQaH2A,5411
-flashforge/tcp/parsers/temp_info.py,sha256=9Waf68tt-4QBcChyUwfMHDwWdIzM4mmDpZAKeAzklgs,7908
-flashforge/tcp/parsers/thumbnail_info.py,sha256=ZmxdEbVFOzqR1AfhXXZyjENVI66BdRdE7Q8LQ8an9FY,10201
-flashforge_python_api-1.3.0.dist-info/METADATA,sha256=q_OdV2PHGRx3TxqoMPIfQ5mC8th-g28-wMLFFHJWkDs,4787
-flashforge_python_api-1.3.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-flashforge_python_api-1.3.0.dist-info/entry_points.txt,sha256=AkOxlsLvQ7cvMLxn7tlzfKp_DCH2hXhbVceHIXxawpU,66
-flashforge_python_api-1.3.0.dist-info/licenses/LICENSE,sha256=-cTA-hrmvlb3pqlQrBZQXUnKayhUjsLJMPb7TD91frM,1067
-flashforge_python_api-1.3.0.dist-info/RECORD,,
+flashforge/tcp/parsers/endstop_status.py,sha256=4OWwE5cyBFhmTPmp18hU4lRr6YSA7sm7U13pHxI1ZJ0,9845
+flashforge/tcp/parsers/location_info.py,sha256=0fbqCmQ2EQQe8z9fiX0zP1YsnuVayTs81zmF3_HuGZM,2895
+flashforge/tcp/parsers/print_status.py,sha256=GdmRvkQKMq-JdefsateMYdlTrlEB16wm29DNUQAbiXA,6194
+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_python_api-1.3.0.dist-info → flashforge_python_api-1.3.2.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.30.1
+Generator: hatchling 1.31.0
 Root-Is-Purelib: true
 Tag: py3-none-any