flashforge-python-api 1.0.1__py3-none-any.whl → 1.1.0__py3-none-any.whl

flashforge_python_api-1.1.0.dist-info/METADATA

@@ -0,0 +1,305 @@
+Metadata-Version: 2.4
+Name: flashforge-python-api
+Version: 1.1.0
+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
+Project-URL: Repository, https://github.com/GhostTypes/ff-5mp-api-py.git
+Project-URL: Issues, https://github.com/GhostTypes/ff-5mp-api-py/issues
+Author-email: GhostTypes <notghosttypes@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: 3d-printer,api,async,control,flashforge,python
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Hardware :: Hardware Drivers
+Requires-Python: >=3.11
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: netifaces>=0.11.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: requests>=2.31.0
+Provides-Extra: all
+Requires-Dist: black>=23.0.0; extra == 'all'
+Requires-Dist: mypy>=1.0.0; extra == 'all'
+Requires-Dist: pillow>=10.0.0; extra == 'all'
+Requires-Dist: pre-commit>=3.0.0; extra == 'all'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'all'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'all'
+Requires-Dist: pytest>=7.0.0; extra == 'all'
+Requires-Dist: ruff>=0.1.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: imaging
+Requires-Dist: pillow>=10.0.0; extra == 'imaging'
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# FlashForge Python API
+
+**A comprehensive Python library for controlling FlashForge 3D printers**
+
+![PyPI](https://img.shields.io/pypi/v/flashforge-python-api?style=flat&color=3776ab) ![Python](https://img.shields.io/badge/Python-3.11%2B-3776ab?style=flat) ![License](https://img.shields.io/badge/License-MIT-brightgreen?style=flat) ![Status](https://img.shields.io/badge/Status-Stable-brightgreen?style=flat)
+
+![aiohttp](https://img.shields.io/badge/aiohttp-%E2%89%A53.8.0-blue?style=flat) ![pydantic](https://img.shields.io/badge/pydantic-%E2%89%A52.0.0-e92063?style=flat) ![netifaces](https://img.shields.io/badge/netifaces-%E2%89%A50.11.0-orange?style=flat) ![requests](https://img.shields.io/badge/requests-%E2%89%A52.31.0-blue?style=flat) ![pillow](https://img.shields.io/badge/pillow-%E2%89%A510.0.0-yellow?style=flat)
+
+**Dual-protocol support with modern async/await architecture for seamless printer control and monitoring**
+
+</div>
+
+---
+
+<div align="center">
+
+## Features
+
+| Capability | Details |
+| --- | --- |
+| **Dual Protocol Support** | Modern HTTP REST API for Adventurer 5M/5X series • Legacy TCP G-code protocol for all networked FlashForge printers |
+| **Printer Discovery** | Automatic UDP broadcast discovery • Returns printer name, serial number, and IP address |
+| **Full Control** | Movement and homing • Temperature control • Fan speed adjustment • LED lighting • Camera control • Air filtration system |
+| **Real-time Monitoring** | Printer status and machine state • Current and target temperatures • Print progress and layer tracking • Estimated time remaining |
+| **Job Management** | Start, pause, resume, and cancel print jobs • Progress monitoring |
+| **File Operations** | List, upload, and download files • Extract print thumbnails • File metadata retrieval |
+| **Async Architecture** | Native async/await implementation • Non-blocking network operations • Concurrent operations support |
+| **Type Safety** | Full type hints for IDE autocomplete • Pydantic models for data validation • mypy strict mode compatible |
+| **Model Detection** | Automatic capability detection • Runtime camera stream detection via `camera_stream_url` • Graceful degradation for older models |
+
+</div>
+
+---
+
+<div align="center">
+
+## Printer Testing & Coverage
+
+| Printer Model | Support Status | Testing Status | API Type |
+| --- | --- | --- | --- |
+| **AD5X** | Full | Tested | HTTP (New) + TCP |
+| **Adventurer 5M/Pro** | Full | Tested | HTTP (New) + TCP |
+| **Adventurer 3/4** | Partial | Partial | TCP (Legacy) |
+
+</div>
+
+---
+
+<div align="center">
+
+## Installation
+
+| Method | Command |
+| --- | --- |
+| **PyPI (Recommended)** | `pip install flashforge-python-api` |
+| **Development Install** | `pip install -e ".[dev]"` |
+| **With Imaging Support** | `pip install flashforge-python-api[imaging]` |
+| **All Optional Dependencies** | `pip install flashforge-python-api[all]` |
+
+</div>
+
+---
+
+## Quick Start
+
+<div align="center">
+
+**Important: LAN-Only Mode Required**
+
+Your printer must be in **LAN-only mode** to communicate with this library. See the [official FlashForge guide](https://wiki.flashforge.com/en/Orca-Flashforge-and-Flashmaker/orca-flashforge-quick-start-guide#connect-via-lan-only-mode) for setup instructions and to obtain your check code.
+
+</div>
+
+### Printer Discovery
+
+Discover FlashForge printers on your local network automatically:
+
+```python
+from flashforge import FlashForgePrinterDiscovery
+import asyncio
+
+async def discover():
+    discovery = FlashForgePrinterDiscovery()
+    printers = await discovery.discover_printers_async()
+
+    for printer in printers:
+        print(f"Found: {printer.name} at {printer.ip_address}")
+        print(f"Serial: {printer.serial_number}")
+
+asyncio.run(discover())
+```
+
+### Basic Printer Control
+
+Connect to a printer and perform basic operations:
+
+```python
+from flashforge import FlashForgeClient
+import asyncio
+
+async def control_printer():
+    # Initialize client with printer credentials
+    client = FlashForgeClient("192.168.1.100", "SERIAL_NUMBER", "CHECK_CODE")
+
+    # Always initialize before operations
+    if await client.initialize():
+        print(f"Connected to {client.printer_name}")
+        print(f"Firmware: {client.firmware_version}")
+
+        # Set temperatures
+        await client.temp_control.set_bed_temp(60)
+        await client.temp_control.set_extruder_temp(220)
+
+        # Home all axes
+        await client.control.home_xyz()
+
+        # Turn on LED lights (AD5M/5X only)
+        if client.is_ad5x:
+            await client.control.set_led_on()
+
+        # Clean up
+        await client.dispose()
+
+asyncio.run(control_printer())
+```
+
+### Real-time Status Monitoring
+
+Monitor printer status, temperatures, and print progress:
+
+```python
+from flashforge import FlashForgeClient
+import asyncio
+
+async def monitor_printer():
+    async with FlashForgeClient("192.168.1.100", "SERIAL", "CODE") as client:
+        # Get comprehensive status via HTTP
+        status = await client.get_printer_status()
+        print(f"State: {status.machine_state}")
+        print(f"Progress: {status.print_progress}%")
+
+        # Get real-time temperatures via TCP
+        temps = await client.tcp_client.get_temp_info()
+        if temps:
+            bed = temps.get_bed_temp()
+            extruder = temps.get_extruder_temp()
+            print(f"Bed: {bed.get_current()}°C / {bed.get_target()}°C")
+            print(f"Extruder: {extruder.get_current()}°C / {extruder.get_target()}°C")
+
+        # Check print progress via TCP
+        layer_p, sd_p, current_layer = await client.tcp_client.get_print_progress()
+        print(f"Layer Progress: {layer_p}% (Layer {current_layer})")
+
+asyncio.run(monitor_printer())
+```
+
+### Camera Stream Detection
+
+Use the printer-reported runtime camera stream URL as the OEM camera source of truth:
+
+```python
+from flashforge import FlashForgeClient
+import asyncio
+
+async def check_camera():
+    async with FlashForgeClient("192.168.1.100", "SERIAL", "CODE") as client:
+        if not await client.initialize():
+            return
+
+        if client.camera_stream_url:
+            print(f"OEM camera stream: {client.camera_stream_url}")
+        else:
+            print("Printer is not reporting an active OEM camera stream")
+
+        # Camera power control remains Pro-only.
+        if client.is_pro:
+            await client.control.turn_camera_on()
+
+asyncio.run(check_camera())
+```
+
+### File Operations and Thumbnails
+
+List files and extract G-code thumbnails:
+
+```python
+from flashforge import FlashForgeClient
+import asyncio
+
+async def file_operations():
+    async with FlashForgeClient("192.168.1.100", "SERIAL", "CODE") as client:
+        # List all files on printer
+        files = await client.files.get_file_list()
+        print(f"Found {len(files)} files")
+
+        for filename in files:
+            print(f"\nFile: {filename}")
+
+            # Extract thumbnail image
+            thumb = await client.tcp_client.get_thumbnail(filename)
+            if thumb and thumb.has_image_data():
+                print(f"Thumbnail: {len(thumb.get_image_bytes())} bytes")
+
+                # Save thumbnail to disk
+                thumb.save_to_file_sync(f"{filename}.png")
+                print(f"Saved thumbnail as {filename}.png")
+
+asyncio.run(file_operations())
+```
+
+---
+
+<div align="center">
+
+## Documentation
+
+| Resource | Description |
+| --- | --- |
+| **[Client API Reference](docs/client.md)** | Complete API reference for `FlashForgeClient` and all control modules |
+| **[Data Models](docs/models.md)** | Pydantic model documentation for status objects and responses |
+| **[Protocols (HTTP/TCP)](docs/protocols.md)** | Understanding the dual-protocol architecture and when to use each |
+| **[Advanced Usage](docs/advanced.md)** | Async patterns, error handling, concurrent operations, and best practices |
+| **[Complete API Reference](docs/api_reference.md)** | Full class hierarchy and method listing |
+
+</div>
+
+---
+
+<div align="center">
+
+## Development
+
+| Task | Command | Description |
+| --- | --- | --- |
+| **Setup Environment** | `python -m venv .venv && .venv\Scripts\activate` | Create and activate virtual environment |
+| **Install Dependencies** | `pip install -e ".[dev]"` | Install package with development tools |
+| **Run Tests** | `pytest` | Execute test suite |
+| **Type Check** | `mypy flashforge/` | Run strict type checking with mypy |
+| **Format Code** | `black flashforge/ tests/` | Format code with Black (line length: 100) |
+| **Lint** | `ruff check flashforge/ tests/` | Lint code with Ruff |
+| **Coverage Report** | `pytest --cov=flashforge --cov-report=html` | Generate test coverage report |
+| **Build Package** | `python -m build` | Build distribution packages |
+| **Run Pre-commit** | `pre-commit run --all-files` | Execute all pre-commit hooks |
+
+</div>
+
+---
+
+<div align="center">
+
+## License
+
+**MIT License** - See [LICENSE](LICENSE) for details
+
+</div>
+

flashforge_python_api-1.1.0.dist-info/RECORD

@@ -0,0 +1,45 @@
+flashforge/__init__.py,sha256=k67UUBpSPMCRlexqn43RRHIh8XyNb9Bq5yXOpwChsFo,5170
+flashforge/client.py,sha256=XP_l5FsaUXKWjkRMWxbz7F1d7_8Xdh7oD5zpThtBFhM,15462
+flashforge/api/__init__.py,sha256=vQz-DkG6LTH39bI4fyiUc0D9jQzemLh45pORLptSOlg,335
+flashforge/api/constants/__init__.py,sha256=Q0HL2tqSBYPd4Oz49VHLS3qUvRuv__GCvTGecaLrQ-Y,163
+flashforge/api/constants/commands.py,sha256=S9cBgU3pBXQm-dp3Bv4795NL059pmTY1NtxWzPA5gWU,329
+flashforge/api/constants/endpoints.py,sha256=3CSCvilBJ1uAM_dZiY5NgbYl4rub1RsZZRpCBRZCqH4,271
+flashforge/api/controls/__init__.py,sha256=53s-H25Pjwr0kvPk8MZ2Twy8VHGqGcO6Q6uBphhEOh4,293
+flashforge/api/controls/control.py,sha256=hifFWRPs2fRvNaJMSLgDJ4ytkHrEMGqzgCazuAC6ewA,11787
+flashforge/api/controls/files.py,sha256=fFjxOCVbK7q1P4GM9RcgB2tsJsywT_HiTBcL3-U0_Yo,7749
+flashforge/api/controls/info.py,sha256=r_gi20ZlgpdtCJVqtoyncV714-MQcDjg4Qg4xeTWHNA,12969
+flashforge/api/controls/job_control.py,sha256=uhuQE3weXJPvWBER0P7lvqWEzAVHXFNXWWBFfnZwtR8,23656
+flashforge/api/controls/temp_control.py,sha256=TGkX63WHygVA9DeYfLARbktZ0o-bYX6MNyYOX6V_RB4,3034
+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/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
+flashforge/api/network/fnet_code.py,sha256=BR2niVKKk4ZfXtizUDIMXzDhlCxPHzqWg5AQQIcoj3g,402
+flashforge/api/network/utils.py,sha256=jwqyJaByr4q80_MJOTwS0nX8I8FZ54T_CHBwkKTXptA,1519
+flashforge/discovery/__init__.py,sha256=G0WiP70EhfHdjXR1RNlv6xjhyHOdo-HWyOm9J0ds4SM,828
+flashforge/discovery/discovery.py,sha256=qlyLxITY9JMKY_quONdWeZ5sbsF_pXfqRXqk7DwDGfs,26042
+flashforge/models/__init__.py,sha256=MNpnXdS6Yah5kSwBB7cbA2Hd-8azffE62pgUrrKSZk4,984
+flashforge/models/machine_info.py,sha256=tMec0qSq9iTVfUvLl72vL5jlDrBW2mn132dzL8842mA,14602
+flashforge/models/responses.py,sha256=befMeXAc7XXiK7emF8Ep2cd1GuhZ-zyYPbbPqS2lcQI,7214
+flashforge/tcp/__init__.py,sha256=g0xAZf0ZDKnH2g79tK5FeAATRo90GfDB7Lkws1LsZxU,1145
+flashforge/tcp/a3_client.py,sha256=n7Kw0Dn9MYjjj0r2GPEiQFBKZfzuE9lboziuRt2bKgM,15411
+flashforge/tcp/ff_client.py,sha256=CJXk0Qei2FVSpbXxZhiEQgAEcTJaBab1ouooqyC4OL4,20235
+flashforge/tcp/tcp_client.py,sha256=KjymxUXiXgEp9y7mjr5tNO_Y2-bsGEyP-oG5en7rCCs,16996
+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.1.0.dist-info/METADATA,sha256=H9Lv3ThMilNw6H-BMtsi2-vdsL0u6f4u7QtGkh-6vlQ,11038
+flashforge_python_api-1.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+flashforge_python_api-1.1.0.dist-info/entry_points.txt,sha256=AkOxlsLvQ7cvMLxn7tlzfKp_DCH2hXhbVceHIXxawpU,66
+flashforge_python_api-1.1.0.dist-info/licenses/LICENSE,sha256=-cTA-hrmvlb3pqlQrBZQXUnKayhUjsLJMPb7TD91frM,1067
+flashforge_python_api-1.1.0.dist-info/RECORD,,

{flashforge_python_api-1.0.1.dist-info → flashforge_python_api-1.1.0.dist-info}/WHEEL

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

{flashforge_python_api-1.0.1.dist-info → flashforge_python_api-1.1.0.dist-info}/licenses/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 GhostTypes
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 GhostTypes
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

flashforge_python_api-1.0.1.dist-info/METADATA

@@ -1,211 +0,0 @@
-Metadata-Version: 2.4
-Name: flashforge-python-api
-Version: 1.0.1
-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
-Project-URL: Repository, https://github.com/GhostTypes/ff-5mp-api-py.git
-Project-URL: Issues, https://github.com/GhostTypes/ff-5mp-api-py/issues
-Author-email: GhostTypes <notghosttypes@gmail.com>
-License-Expression: MIT
-License-File: LICENSE
-Keywords: 3d-printer,api,async,control,flashforge,python
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Scientific/Engineering
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: System :: Hardware :: Hardware Drivers
-Requires-Python: >=3.8
-Requires-Dist: aiohttp>=3.8.0
-Requires-Dist: netifaces>=0.11.0
-Requires-Dist: pydantic>=2.0.0
-Requires-Dist: requests>=2.31.0
-Provides-Extra: all
-Requires-Dist: black>=23.0.0; extra == 'all'
-Requires-Dist: mypy>=1.0.0; extra == 'all'
-Requires-Dist: pillow>=10.0.0; extra == 'all'
-Requires-Dist: pre-commit>=3.0.0; extra == 'all'
-Requires-Dist: pytest-asyncio>=0.21.0; extra == 'all'
-Requires-Dist: pytest-cov>=4.0.0; extra == 'all'
-Requires-Dist: pytest>=7.0.0; extra == 'all'
-Requires-Dist: ruff>=0.1.0; extra == 'all'
-Provides-Extra: dev
-Requires-Dist: black>=23.0.0; extra == 'dev'
-Requires-Dist: mypy>=1.0.0; extra == 'dev'
-Requires-Dist: pre-commit>=3.0.0; extra == 'dev'
-Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
-Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
-Requires-Dist: pytest>=7.0.0; extra == 'dev'
-Requires-Dist: ruff>=0.1.0; extra == 'dev'
-Provides-Extra: imaging
-Requires-Dist: pillow>=10.0.0; extra == 'imaging'
-Description-Content-Type: text/markdown
-
-<div align="center">
-
-# FlashForge Python API
-
-A comprehensive Python library for controlling FlashForge 3D printers.
-
-[![PyPI](https://img.shields.io/pypi/v/flashforge-python-api?style=for-the-badge&logo=pypi&logoColor=white)](https://pypi.org/project/flashforge-python-api/)
-[![Python](https://img.shields.io/badge/Python-3.8%2B-blue?style=for-the-badge&logo=python&logoColor=white)](https://www.python.org/)
-[![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge&logo=opensourceinitiative&logoColor=white)](LICENSE)
-
-</div>
-
-<div align="center">
-
-## Features & Capabilities
-
-| Feature | Description |
-| :--- | :--- |
-| **Printer Discovery** | Automatic UDP broadcast discovery of printers on the network |
-| **Full Control** | Movement (G1), Homing (G28), Temperature (M104/M140), Fans, LED |
-| **Real-time Monitoring** | Live status (M119), Temperatures (M105), Print Progress (M27) |
-| **Job Management** | Start, Pause, Resume, Cancel, File Upload & Listing |
-| **Advanced Parsing** | Thumbnail extraction (M662), Endstop monitoring, Machine state |
-| **Dual Protocol** | Modern HTTP API + Legacy TCP G-code support |
-| **Async Support** | Native async/await implementation for all operations |
-| **Type Safety** | Full type hints and Pydantic models for robust development |
-
-<br>
-
-## Supported Hardware
-
-| Model | Support Level | Connection Type |
-| :--- | :--- | :--- |
-| **FlashForge Adventurer 5M / 5M Pro** | Full Support | HTTP + TCP |
-| **FlashForge Adventurer 5X** | Full Support | HTTP + TCP |
-| **FlashForge Adventurer 3 / 4** | Partial Support | TCP (Legacy) |
-| **Other Networked FlashForge Printers** | Experimental | TCP (Generic) |
-
-<br>
-
-## Compatible Slicers
-
-| Slicer | Compatibility | Notes |
-| :--- | :--- | :--- |
-| **OrcaSlicer** | High | Recommended for Adventurer 5M series |
-| **FlashPrint** | Full | Official FlashForge slicer |
-| **Orca-FlashForge** | High | Optimized for FlashForge printers |
-| **Cura / PrusaSlicer** | Basic | Requires correct G-code flavor |
-
-<br>
-
-## Installation
-
-| Command |
-| :--- |
-| `pip install flashforge-python-api` |
-
-</div>
-
-<div align="center">
-<h2>Usage Examples</h2>
-</div>
-
-<div align="center">
-<h3>Printer Discovery</h3>
-Discover printers on your local network automatically.
-</div>
-
-```python
-from flashforge import FlashForgePrinterDiscovery
-import asyncio
-
-async def discover():
-    discovery = FlashForgePrinterDiscovery()
-    printers = await discovery.discover_printers_async()
-    for printer in printers:
-        print(f"Found: {printer.name} at {printer.ip_address}")
-
-asyncio.run(discover())
-```
-
-<div align="center">
-<h3>Basic Control</h3>
-Connect to a printer and perform basic operations like setting temperature and homing.
-</div>
-
-```python
-from flashforge import FlashForgeClient
-import asyncio
-
-async def control_printer():
-    # Initialize client with printer details
-    client = FlashForgeClient("192.168.1.100", "SERIAL_NUMBER", "CHECK_CODE")
-
-    if await client.initialize():
-        print(f"Connected to {client.printer_name}")
-
-        # Set bed temperature to 60°C
-        await client.temp_control.set_bed_temp(60)
-
-        # Home all axes
-        await client.control.home_xyz()
-
-        await client.dispose()
-
-asyncio.run(control_printer())
-```
-
-<div align="center">
-<h3>Real-time Status Monitoring</h3>
-Monitor printer status, temperatures, and print progress.
-</div>
-
-```python
-from flashforge import FlashForgeClient
-import asyncio
-
-async def monitor_printer():
-    async with FlashForgeClient("192.168.1.100", "SERIAL", "CODE") as client:
-        # Get comprehensive status
-        status = await client.get_printer_status()
-        print(f"Machine State: {status.machine_state}")
-
-        # Get temperatures via TCP
-        temps = await client.tcp_client.get_temp_info()
-        if temps:
-            bed = temps.get_bed_temp()
-            extruder = temps.get_extruder_temp()
-            print(f"Bed: {bed.get_current()}°C / {bed.get_target()}°C")
-            print(f"Extruder: {extruder.get_current()}°C / {extruder.get_target()}°C")
-
-        # Check print progress
-        layer_p, sd_p, current_layer = await client.tcp_client.get_print_progress()
-        print(f"Progress: {layer_p}% (Layer {current_layer})")
-
-asyncio.run(monitor_printer())
-```
-
-<div align="center">
-<h3>File Operations & Thumbnails</h3>
-List files on the printer and extract thumbnails.
-</div>
-
-```python
-from flashforge import FlashForgeClient
-import asyncio
-
-async def file_ops():
-    async with FlashForgeClient("192.168.1.100", "SERIAL", "CODE") as client:
-        # List files
-        files = await client.files.get_file_list()
-        for filename in files:
-            print(f"File: {filename}")
-
-            # Get thumbnail
-            thumb = await client.tcp_client.get_thumbnail(filename)
-            if thumb and thumb.has_image_data():
-                print(f"Thumbnail found: {len(thumb.get_image_bytes())} bytes")
-                # thumb.save_to_file_sync(f"{filename}.png")
-
-asyncio.run(file_ops())
-```

flashforge_python_api-1.0.1.dist-info/RECORD

@@ -1,43 +0,0 @@
-flashforge/__init__.py,sha256=YwiGqt8E6Q5s3_iWxT0skY-468iQwKi2bRmj9pmdDhE,4302
-flashforge/client.py,sha256=dkzIGgFQW37cstXKAAJEg4wmyuQiNdWxHbMgPHOsqxA,12805
-flashforge/api/__init__.py,sha256=Syz3l0UO1ryK5bMKnI_Neh1PTmlkl8iKgzZrdWhArc0,334
-flashforge/api/constants/__init__.py,sha256=JyFtW3DcynTD_VWzw3T7MCs6BYaf9Xkypi_WYUgqFA4,162
-flashforge/api/constants/commands.py,sha256=tcCyAueNYZ7CrYxVy92r9alF6f5AcapErBBgGL1Xqwk,328
-flashforge/api/constants/endpoints.py,sha256=aGDxZk2f_Qsfi_QeIujP8ocDux_wiBBYldaGUuyg8BA,270
-flashforge/api/controls/__init__.py,sha256=5nHCY3U6KJIknYY_VnPjLFQIiPmEEAA6QlkC14AjAzY,292
-flashforge/api/controls/control.py,sha256=4PEYVeHkJTvsIYq2ck_rJ9kGkozsSgJUPkFHvFEfJNk,12061
-flashforge/api/controls/files.py,sha256=ieQI3IaWPNwyxLoIP3Ea_xtg_bTmZkleSM460yhFgIk,7626
-flashforge/api/controls/info.py,sha256=5Vv879QL8Qxx6xFyGjIh4xjLzwcQlLdfjeNkxPxZgbw,12496
-flashforge/api/controls/job_control.py,sha256=iC3bmK00r4rS7fsAuRZR-RNWguJ8rl8dCDV1L1a-leM,23169
-flashforge/api/controls/temp_control.py,sha256=H4fdJXXrnRMQvvZhslhNAtAR78S-4Nk79OxDqOEHRM0,3108
-flashforge/api/filament/__init__.py,sha256=isT2dl0hzUS0xMTXMm4Tip0GTG1gCsm8LKWa9xPu4Y8,104
-flashforge/api/filament/filament.py,sha256=TtcC2G2nD9Sq4cOrCZzFLZ6Q0Ve-zfrfuEF9uQ8M3eE,1214
-flashforge/api/misc/__init__.py,sha256=IaHcsUieaMEYEFAWTyj-X6N7JRLiLiU7D58Cl-DttJs,211
-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=BjrtwAMLGJ6_Q4LrZZM9KP1gfYXq4V8uHro_AxmUhD8,163
-flashforge/api/network/fnet_code.py,sha256=BR2niVKKk4ZfXtizUDIMXzDhlCxPHzqWg5AQQIcoj3g,402
-flashforge/api/network/utils.py,sha256=gpRU24eYtOajV-lWEjMdanjs110xG-jn2EirD5gIoWA,1607
-flashforge/discovery/__init__.py,sha256=1Dz3zqh5ltsv34ZhugWkoC4MKp8qbz3SWpxNkPSIlMU,277
-flashforge/discovery/discovery.py,sha256=fAY8EFw5u8R-wlh21_GrXHLL2KpAxkp0EQi8fNbgJbU,15172
-flashforge/models/__init__.py,sha256=qRV-iuENmwyeiO63cQYA6qFB-UYG36HadSMzgZabGPA,983
-flashforge/models/machine_info.py,sha256=Y7nfCepE6sc8slpPsFCFOGXdzxMzUA2Dtod3WHGk7TU,12108
-flashforge/models/responses.py,sha256=LbRiT74j31fra86xorcuUmeWtV27KCj6mysERlUJzZI,5143
-flashforge/tcp/__init__.py,sha256=JYbv_ATMJL1vJ1VP-KPcxdMM7V_aapDkZrCUhPaWLtQ,835
-flashforge/tcp/ff_client.py,sha256=58z6qzfolIOovtzW-C3GwgrOxZV67cOMC5vGjYnsZ7c,20787
-flashforge/tcp/tcp_client.py,sha256=GcTp_PAykH4n5NFf8uqCV5H7OfExJFPWordMtgujREU,17331
-flashforge/tcp/gcode/__init__.py,sha256=PhRg0RVxZoWQaB8lpHXSEsY1C5ZvJ29QIAUOi0vr5OY,195
-flashforge/tcp/gcode/gcode_controller.py,sha256=RKUwxDZkRxtn9TL4w8VS4A6xhi8kHwTche3YPJz-6tw,10053
-flashforge/tcp/gcode/gcodes.py,sha256=exPqr7EJbJYgtJ9aQNm8Ut7WfjPCx1i2fLnu7NpgG9c,3392
-flashforge/tcp/parsers/__init__.py,sha256=lOxmHv1ECvZ8npm_lfO8gwG23L6QlVSE0TRuOAw64bk,730
-flashforge/tcp/parsers/endstop_status.py,sha256=tuHgBjXv9bQzUdMGC6_DHU6RsF5-6LGzjSjUkoMJK64,10374
-flashforge/tcp/parsers/location_info.py,sha256=SfdW02nAB5Zlf-l7cPx4EetMFopJrz_IF5IxsjWwi1U,2445
-flashforge/tcp/parsers/print_status.py,sha256=75KlzAMMjvpR4hCvK0LbHKwE_7hm2jExCFeHO1v4Kgs,6536
-flashforge/tcp/parsers/printer_info.py,sha256=qur6zekWsTY_RsCt6Nndc1eElvJIhSXCpUfX0Z40ONQ,5443
-flashforge/tcp/parsers/temp_info.py,sha256=YaDNCJZvwYhqD3li1aJl-66nVrZ2_lkoQVgiA1x35_w,8276
-flashforge/tcp/parsers/thumbnail_info.py,sha256=hi-e3Dy8h8Vw1Uu5SVAodQKSJEhP0-z1NhnO3rOuYMo,9282
-flashforge_python_api-1.0.1.dist-info/METADATA,sha256=aI0TqrnzqTEM8P0eujjh2_wcXlNdFXIO3LCfr870Dso,7202
-flashforge_python_api-1.0.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-flashforge_python_api-1.0.1.dist-info/entry_points.txt,sha256=AkOxlsLvQ7cvMLxn7tlzfKp_DCH2hXhbVceHIXxawpU,66
-flashforge_python_api-1.0.1.dist-info/licenses/LICENSE,sha256=lW2RvsgnKpSECUO1251Wj_EMkdmuA6Vlxea-eje7wuM,1088
-flashforge_python_api-1.0.1.dist-info/RECORD,,