flashforge-python-api 1.1.0__tar.gz → 1.2.1__tar.gz

{flashforge_python_api-1.1.0 → flashforge_python_api-1.2.1}/.claude/settings.local.json

@@ -13,7 +13,8 @@
       "Bash(robocopy:*)",
       "Bash(mypy:*)",
       "Bash(ruff check:*)",
-      "Bash(ruff format:*)"
+      "Bash(ruff format:*)",
+      "Bash(timeout:*)"
     ],
     "deny": [],
     "ask": []

{flashforge_python_api-1.1.0 → flashforge_python_api-1.2.1}/.github/workflows/publish.yml

@@ -78,11 +78,28 @@ jobs:
           ls -lh dist/
           twine check dist/*
 
+      - name: Extract changelog for this version
+        id: changelog
+        run: |
+          VERSION="${{ steps.validate.outputs.version }}"
+          # Extract the section for this version from CHANGELOG.md
+          # Matches from "## [X.Y.Z]" until the next "## [" or end of file
+          CHANGELOG=$(awk "/^## \[$VERSION\]/{found=1; next} /^## \[/{if(found) exit} found{print}" CHANGELOG.md)
+
+          if [ -z "$CHANGELOG" ]; then
+            echo "Warning: No changelog entry found for version $VERSION"
+            CHANGELOG="No changelog entry found. See [CHANGELOG.md](https://github.com/GhostTypes/ff-5mp-api-py/blob/main/CHANGELOG.md) for details."
+          fi
+
+          # Write to file to preserve multiline content
+          echo "$CHANGELOG" > /tmp/changelog_body.md
+
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v2
         with:
           tag_name: v${{ steps.validate.outputs.version }}
           name: Release ${{ steps.validate.outputs.version }}
+          body_path: /tmp/changelog_body.md
           files: dist/*
           generate_release_notes: true
           draft: false

{flashforge_python_api-1.1.0 → flashforge_python_api-1.2.1}/CHANGELOG.md

@@ -5,18 +5,58 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [1.2.1] - 2026-03-23
+
+### Fixed
+
+- Increased `currentPrintSpeed` and `printSpeedAdjust` validation limit from 200 to 1000 to support AD5X printers reporting speeds up to 500 (contributed by @spawnegit)
+- Replaced per-request `aiohttp.ClientSession()` creation with shared HTTP session across all control modules (`control.py`, `files.py`, `info.py`, `job_control.py`), fixing connection churn and respecting the configured timeout
+- Increased default HTTP timeout from 5s to 15s to prevent timeouts during print operations
+
+### Changed
+
+- Extracted duplicate `try/except aiohttp.ContentTypeError` JSON parsing pattern into a shared `json_from_response()` helper in `api/network/utils.py`
+- Release workflow now includes curated changelog entry alongside auto-generated commit notes in GitHub Releases
+
+## [1.2.0] - 2026-03-21
+
+### Added
+
+- `CAMERA_STREAM_PORT` - exported constant for the known FlashForge OEM MJPEG stream port
+- `FlashForgeClient.detect_camera_stream()` - probes `http://<printer-ip>:8080/?action=stream` and falls back from `HEAD` to `GET` when firmware does not report `camera_stream_url`
+- Pytest coverage for camera stream probing success, `HEAD` timeout fallback, and no-camera behavior
+- `FlashForgeA4Client` - dedicated Adventurer 4 Lite / Pro TCP client aligned with the documented M601 and M115 protocol behavior
+- `A4BuildVolume`, `A4FileEntry`, and `A4PrinterInfo` for typed Adventurer 4 responses
+
+### Changed
+
+- Discovery PID fallback now recognizes Adventurer 4 Lite (`0x0016`) as well as Adventurer 4 Pro (`0x001E`)
+- README guidance now points Adventurer 3 / 4 users at the dedicated TCP clients instead of only the generic legacy layer
+
+## [1.1.1] - 2026-03-09
+
+### Fixed
+
+- Fixed AD5X `/detail` response parsing for newer firmware fields including `camera`, `clearFanStatus`, `coordinate`, `extrudeCtrl`, and `moveCtrl`
+- Made raw printer detail parsing tolerant of additional future firmware fields instead of failing validation
+- Added regression coverage for extended AD5X detail payloads
+
 ## [1.1.0] - 2026-03-08
 
 ### Added
-- `FlashForgeA3Client` — full Adventurer 3 TCP client with dedicated G-code protocol support
-- `A3GCodeController` — A3-specific G-code command controller
-- `FlashForgeClient.camera_stream_url` — caches the OEM camera stream URL reported by the printer in machine-info responses
+
+- `FlashForgeA3Client` — full Adventurer 3 TCP client with dedicated G-code protocol support
+- `A3GCodeController` — A3-specific G-code command controller
+- `FlashForgeClient.camera_stream_url` — caches the OEM camera stream URL reported by the printer in machine-info responses
 - `thumbnail_info` parser for handling printer thumbnail responses
 - New G-code commands in `gcodes.py` for broader printer compatibility
 - Test coverage for A3 client, camera stream URL caching, and machine-info model parity
 - mypy exclude configuration for tests and examples
 
 ### Changed
+
 - Major refactor of `discovery.py` for improved reliability and cross-printer compatibility
 - `tcp_client.py` substantially reworked for better connection handling and parser coverage
 - Parsers (`endstop_status`, `location_info`, `print_status`, `printer_info`, `temp_info`) updated for improved type safety and correctness
@@ -28,18 +68,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - TCP module exports updated to expose A3 client and controller
 
 ### Fixed
+
 - Discovery reliability improvements from `discovery.py` refactor
 - TCP client parser edge cases addressed across all response types
 
 ## [1.0.2] - 2025-12-26
 
 ### Added
+
 - Added LAN-only mode requirement notice in README Quick Start section with link to official FlashForge documentation
 - Added dependency badges for aiohttp, pydantic, netifaces, requests, and pillow to README header
 - Added readme-generator skill for maintaining consistent documentation formatting
 - Added comprehensive developer documentation sections to CLAUDE.md
 
 ### Changed
+
 - Completely rewrote main README.md with modern centered table-based formatting
 - Modernized docs/README.md as comprehensive documentation hub entry point
 - Expanded CLAUDE.md from basic PyPI notes to comprehensive developer guide with architecture documentation
@@ -49,10 +92,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Made version input required (X.Y.Z format) for releases
 
 ### Fixed
+
 - Fixed release workflow changelog duplication issue caused by orphaned timestamped commits
 - Fixed `format_time_from_seconds` function to properly handle float values for `estimated_time`
 
 ### Removed
+
 - Removed redundant Architecture and Requirements sections from README
 - Removed complex timestamp versioning logic from release workflow
 - Deleted orphaned timestamped tag `v1.0.0-20251122005123`
@@ -60,11 +105,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [1.0.1] - 2025-12-24
 
 ### Fixed
+
 - Fixed Pydantic validation error for `estimated_time` field in `FFPrinterDetail` and `FFMachineInfo` models. Changed type from `int` to `float` to handle printer API responses that return fractional time values.
 
 ## [1.0.0] - 2025-01-02
 
 ### Added
+
 - Initial release of FlashForge Python API
 - HTTP API client for modern FlashForge printers
 - TCP/G-code client for legacy communication
@@ -72,22 +119,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Comprehensive async/await support throughout
 - Full type safety with Pydantic models
 - Control modules:
-  - `Control` - Movement, LED, filtration, camera control
-  - `JobControl` - Print job management (start/pause/resume/cancel)
-  - `Info` - Status and machine information retrieval
-  - `Files` - File upload/download/management
-  - `TempControl` - Temperature settings
+- `Control` - Movement, LED, filtration, camera control
+- `JobControl` - Print job management (start/pause/resume/cancel)
+- `Info` - Status and machine information retrieval
+- `Files` - File upload/download/management
+- `TempControl` - Temperature settings
 - Support for FlashForge Adventurer 5M Series and Adventurer 4
 - Model-specific feature detection (LED, filtration, camera)
 - Comprehensive error handling and logging
 - Example scripts and documentation
 
 ### Documentation
+
 - Complete README with usage examples
 - API reference documentation
 - Type hints for all public APIs
 - Inline code documentation
 
+[Unreleased]: https://github.com/GhostTypes/ff-5mp-api-py/compare/v1.2.1...HEAD
+[1.2.1]: https://github.com/GhostTypes/ff-5mp-api-py/compare/v1.2.0...v1.2.1
+[1.2.0]: https://github.com/GhostTypes/ff-5mp-api-py/compare/v1.1.1...v1.2.0
+[1.1.1]: https://github.com/GhostTypes/ff-5mp-api-py/releases/tag/v1.1.1
 [1.0.2]: https://github.com/GhostTypes/ff-5mp-api-py/releases/tag/v1.0.2
 [1.0.1]: https://github.com/GhostTypes/ff-5mp-api-py/releases/tag/v1.0.1
 [1.0.0]: https://github.com/GhostTypes/ff-5mp-api-py/releases/tag/v1.0.0

flashforge_python_api-1.2.1/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.4
+Name: flashforge-python-api
+Version: 1.2.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.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
+
+# FlashForge Python API
+
+Python library for controlling FlashForge 3D printers with async support for the modern HTTP API and the legacy TCP protocol.
+
+## Supported Printers
+
+| Printer | Support |
+| --- | --- |
+| Adventurer 5M | Full |
+| Adventurer 5M Pro | Full |
+| AD5X | Full |
+| Adventurer 3 / 4 | Dedicated TCP clients |
+
+## Installation
+
+```bash
+pip install flashforge-python-api
+```
+
+## Quick Start
+
+Modern LAN-mode HTTP printers require:
+
+- printer IP address
+- serial number
+- check code
+
+```python
+import asyncio
+from flashforge import FlashForgeClient, PrinterDiscovery
+
+
+async def main():
+    discovery = PrinterDiscovery()
+    printers = await discovery.discover()
+
+    if not printers:
+        print("No printers found")
+        return
+
+    printer = printers[0]
+
+    async with FlashForgeClient(
+        printer.ip_address,
+        printer.serial_number or "SERIAL_NUMBER",
+        "CHECK_CODE",
+    ) as client:
+        if not await client.initialize():
+            return
+
+        await client.init_control()
+
+        status = await client.get_printer_status()
+        print(f"Printer: {client.printer_name}")
+        print(f"State: {status.machine_state if status else 'unknown'}")
+
+        await client.control.home_axes()
+
+
+asyncio.run(main())
+```
+
+## Main Entry Points
+
+- `FlashForgeClient`: primary client for modern printers
+- `PrinterDiscovery`: recommended discovery API
+- `FlashForgeA4Client`: documented TCP client for Adventurer 4 Lite / Pro printers
+- `FlashForgeA3Client`: documented TCP client for Adventurer 3 printers
+- `FlashForgeTcpClient` and `client.tcp_client`: lower-level TCP access for direct commands and generic legacy workflows
+
+## Capabilities
+
+- printer discovery
+- printer status and machine information
+- job control
+- file listing, uploads, and thumbnails
+- temperature and motion control
+- LED, camera, and filtration control where supported
+- AD5X-specific job and material-station support
+
+## Documentation
+
+- [docs/README.md](docs/README.md)
+- [docs/client.md](docs/client.md)
+- [docs/protocols.md](docs/protocols.md)
+- [docs/api_reference.md](docs/api_reference.md)

flashforge_python_api-1.2.1/README.md

@@ -0,0 +1,86 @@
+# FlashForge Python API
+
+Python library for controlling FlashForge 3D printers with async support for the modern HTTP API and the legacy TCP protocol.
+
+## Supported Printers
+
+| Printer | Support |
+| --- | --- |
+| Adventurer 5M | Full |
+| Adventurer 5M Pro | Full |
+| AD5X | Full |
+| Adventurer 3 / 4 | Dedicated TCP clients |
+
+## Installation
+
+```bash
+pip install flashforge-python-api
+```
+
+## Quick Start
+
+Modern LAN-mode HTTP printers require:
+
+- printer IP address
+- serial number
+- check code
+
+```python
+import asyncio
+from flashforge import FlashForgeClient, PrinterDiscovery
+
+
+async def main():
+    discovery = PrinterDiscovery()
+    printers = await discovery.discover()
+
+    if not printers:
+        print("No printers found")
+        return
+
+    printer = printers[0]
+
+    async with FlashForgeClient(
+        printer.ip_address,
+        printer.serial_number or "SERIAL_NUMBER",
+        "CHECK_CODE",
+    ) as client:
+        if not await client.initialize():
+            return
+
+        await client.init_control()
+
+        status = await client.get_printer_status()
+        print(f"Printer: {client.printer_name}")
+        print(f"State: {status.machine_state if status else 'unknown'}")
+
+        await client.control.home_axes()
+
+
+asyncio.run(main())
+```
+
+## Main Entry Points
+
+- `FlashForgeClient`: primary client for modern printers
+- `PrinterDiscovery`: recommended discovery API
+- `FlashForgeA4Client`: documented TCP client for Adventurer 4 Lite / Pro printers
+- `FlashForgeA3Client`: documented TCP client for Adventurer 3 printers
+- `FlashForgeTcpClient` and `client.tcp_client`: lower-level TCP access for direct commands and generic legacy workflows
+
+## Capabilities
+
+- printer discovery
+- printer status and machine information
+- job control
+- file listing, uploads, and thumbnails
+- temperature and motion control
+- LED, camera, and filtration control where supported
+- AD5X-specific job and material-station support
+
+## Documentation
+
+- [docs/README.md](docs/README.md)
+- [docs/client.md](docs/client.md)
+- [docs/protocols.md](docs/protocols.md)
+- [docs/api_reference.md](docs/api_reference.md)

flashforge_python_api-1.2.1/docs/README.md

@@ -0,0 +1,56 @@
+# FlashForge Python API Documentation
+
+This documentation covers the Python surface for `flashforge-python-api`.
+
+## Before You Start
+
+This repository and `@ghosttypes/ff-api` share the same protocol/domain baseline, but they do not promise strict 1:1 public API parity.
+
+Read [parity.md](parity.md) first if you are comparing both libraries or maintaining downstream integrations across both languages.
+
+## Documentation Structure
+
+- [Getting Started](client.md)
+- [Parity Notes](parity.md)
+- [API Reference](api_reference.md)
+- [Data Models](models.md)
+- [Protocols](protocols.md)
+- [Advanced Usage](advanced.md)
+
+## Recommended Entry Points
+
+- `FlashForgeClient` for modern printer access
+- `PrinterDiscovery` for new discovery code
+- `FlashForgePrinterDiscovery` only when you need compatibility with older Python callers
+
+## Quick Example
+
+```python
+import asyncio
+from flashforge import FlashForgeClient, PrinterDiscovery
+
+
+async def main():
+    discovery = PrinterDiscovery()
+    printers = await discovery.discover()
+
+    if not printers:
+        print("No printers found")
+        return
+
+    printer = printers[0]
+
+    async with FlashForgeClient(
+        printer.ip_address,
+        printer.serial_number or "SERIAL_NUMBER",
+        "CHECK_CODE",
+    ) as client:
+        if not await client.initialize():
+            return
+
+        status = await client.get_printer_status()
+        print(status.machine_state)
+
+
+asyncio.run(main())
+```

{flashforge_python_api-1.1.0 → flashforge_python_api-1.2.1}/docs/advanced.md

@@ -1,5 +1,7 @@
 # Advanced Topics
 
+This page documents advanced Python usage patterns. If you are comparing this library with the TypeScript API, read [parity.md](parity.md) first.
+
 ## Async/Await Patterns
 
 The FlashForge API is fully asynchronous, leveraging Python's `asyncio` library. All network operations are non-blocking, ensuring your application remains responsive while communicating with the printer.
@@ -278,19 +280,21 @@ async with client:
 
 **Finding your credentials:**
 
-The serial number and check code are printer-specific. Use the discovery method first to automatically retrieve these values:
+The serial number and check code are printer-specific. For new code, prefer the modern `PrinterDiscovery` API:
 
 ```python
-from flashforge import FlashForgePrinterDiscovery
+from flashforge import PrinterDiscovery
 
-discovery = FlashForgePrinterDiscovery()
-printers = await discovery.discover_printers_async()
+discovery = PrinterDiscovery()
+printers = await discovery.discover()
 
 for printer in printers:
     print(f"IP: {printer.ip_address}")
     print(f"Serial: {printer.serial_number}")
 ```
 
+If you need compatibility with older Python callers, `FlashForgePrinterDiscovery` is still exported as a reduced wrapper.
+
 ## Type Hints & Safety
 
 This library uses comprehensive Python type hints and Pydantic models for data validation. All responses are strongly typed, providing excellent IDE autocompletion and static analysis support.

{flashforge_python_api-1.1.0 → flashforge_python_api-1.2.1}/docs/api_reference.md

@@ -2,6 +2,8 @@
 
 This document provides a comprehensive reference for the FlashForge Python API, including all classes, methods, and data models.
 
+For recommended modern entry points, use `FlashForgeClient` and `PrinterDiscovery`. `FlashForgePrinterDiscovery` remains available as a compatibility wrapper.
+
 ## Core Client
 
 ### `flashforge.FlashForgeClient`
@@ -90,9 +92,18 @@ async with FlashForgeClient(ip, serial, check_code) as client:
 
 ## Discovery
 
+### `flashforge.PrinterDiscovery`
+
+Typed UDP discovery API for modern and legacy FlashForge models.
+
+#### Methods
+
+- `async discover(options: DiscoveryOptions | None = None) -> list[DiscoveredPrinter]`
+- `monitor(options: DiscoveryOptions | None = None) -> DiscoveryMonitor`
+
 ### `flashforge.FlashForgePrinterDiscovery`
 
-Handles UDP-based printer discovery on the local network.
+Backward-compatible wrapper around `PrinterDiscovery`.
 
 #### Methods
 
@@ -545,10 +556,10 @@ async with FlashForgeClient("192.168.1.100", "SERIAL", "CHECK_CODE") as client:
 ### Discovery
 
 ```python
-from flashforge import FlashForgePrinterDiscovery
+from flashforge import PrinterDiscovery
 
-discovery = FlashForgePrinterDiscovery()
-printers = await discovery.discover_printers_async()
+discovery = PrinterDiscovery()
+printers = await discovery.discover()
 
 for printer in printers:
     print(f"{printer.name} at {printer.ip_address}")

flashforge_python_api-1.2.1/docs/client.md

@@ -0,0 +1,130 @@
+# Getting Started
+
+This guide covers the recommended modern Python API surface.
+
+## Installation
+
+```bash
+pip install flashforge-python-api
+```
+
+## Discovery
+
+For new code, prefer `PrinterDiscovery`.
+
+```python
+import asyncio
+from flashforge import PrinterDiscovery
+
+
+async def discover():
+    discovery = PrinterDiscovery()
+    printers = await discovery.discover()
+
+    for printer in printers:
+        print(f"{printer.name} at {printer.ip_address}")
+
+    return printers
+
+
+printers = asyncio.run(discover())
+```
+
+If you need the older Python compatibility surface, `FlashForgePrinterDiscovery` is still exported, but it only returns the reduced legacy wrapper objects.
+
+## Connect to a Printer
+
+Modern LAN-mode HTTP printers require the printer IP address, serial number, and check code.
+
+```python
+import asyncio
+from flashforge import FlashForgeClient
+
+
+async def connect():
+    async with FlashForgeClient(
+        ip_address="192.168.1.100",
+        serial_number="SERIAL_NUMBER",
+        check_code="CHECK_CODE",
+    ) as client:
+        if not await client.initialize():
+            return
+
+        await client.init_control()
+
+        print(f"Connected to {client.printer_name}")
+        print(f"Firmware: {client.firmware_version}")
+
+
+asyncio.run(connect())
+```
+
+## Basic Operations
+
+### Get Printer Status
+
+```python
+async with FlashForgeClient(ip, serial, check_code) as client:
+    await client.initialize()
+    status = await client.get_printer_status()
+    print(status.machine_state)
+```
+
+### Control Temperature
+
+```python
+async with FlashForgeClient(ip, serial, check_code) as client:
+    await client.initialize()
+    await client.init_control()
+
+    await client.temp_control.set_extruder_temp(200)
+    await client.temp_control.set_bed_temp(60)
+```
+
+### Control Motion and Jobs
+
+```python
+async with FlashForgeClient(ip, serial, check_code) as client:
+    await client.initialize()
+    await client.init_control()
+
+    await client.control.home_axes()
+    await client.job_control.pause_print_job()
+    await client.job_control.resume_print_job()
+    await client.job_control.cancel_print_job()
+```
+
+Python also exposes some convenience wrappers on the top-level client, such as `pause_print()`, `resume_print()`, and `home_all_axes()`. These helpers are Python-specific and are not part of a strict cross-language parity contract.
+
+### Detect OEM Camera Stream
+
+```python
+async with FlashForgeClient(ip, serial, check_code) as client:
+    await client.initialize()
+
+    if client.camera_stream_url:
+        print(f"OEM camera stream: {client.camera_stream_url}")
+```
+
+### List Files
+
+```python
+async with FlashForgeClient(ip, serial, check_code) as client:
+    await client.initialize()
+
+    files = await client.files.get_file_list()
+    recent = await client.files.get_recent_file_list()
+```
+
+## Compatibility Notes
+
+- `FlashForgePrinterDiscovery` remains available for older Python callers.
+- `PrinterDiscovery` is the preferred discovery API for new code.
+- `init_control()` is still the correct method name in Python.
+- Python convenience helpers and compatibility shims should not be assumed to exist in TypeScript.
+
+## Next Steps
+
+- [API Reference](api_reference.md)
+- [Advanced Topics](advanced.md)
+- [Parity Notes](parity.md)