---
id: pytest-embedded-idf
version: "2.8.1"
license: unclear
license_treatment: permissive
maintenance: active
---

# pytest-embedded-idf — Make pytest-embedded plugin work with ESP-IDF.

License: permissive · Maintenance: active · Downloads: 121.1K/mo

## What it is and what it does

pytest-embedded-idf is a pytest plugin that extends pytest-embedded to work with Espressif's ESP-IDF embedded development framework. It provides ESP-IDF-aware binary parsing and optional automated flashing of built binaries to target boards during test execution. The plugin integrates with the pytest-embedded ecosystem and depends on esp-idf-panic-decoder and esp-bool-parser for enhanced error handling and parsing capabilities.

The package is designed for developers testing ESP-IDF projects who want to automate board flashing and leverage pytest's testing framework. It parses built binaries according to IDF rules to gather additional context, and when the optional pytest-embedded-serial-esp extra is activated, it can automatically flash the binary to the target board at the start of test runs. This reduces manual setup steps and integrates hardware testing into a standard pytest workflow.

Use it for:

- Automate flashing and testing of Espressif microcontroller firmware during CI/CD pipelines
- Parse ESP-IDF binary artifacts to extract metadata and validate build outputs in test suites
- Run integration tests on embedded devices without manual board preparation between test runs
- Combine panic decoder and boolean parser output with pytest test results for comprehensive embedded debugging

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A pytest plugin that integrates ESP-IDF embedded systems testing with pytest-embedded, enabling binary parsing and optional automated flashing to target boards.

Yes. The package is actively maintained, has no known vulnerabilities, uses a permissive MIT license, and offers low-friction installation. It fills a specific niche for ESP-IDF developers who need pytest-based testing with hardware automation. Install it if you are testing ESP-IDF projects and want to integrate board flashing into your pytest workflow.

## Install

pip install pytest-embedded-idf
uv add pytest-embedded-idf
poetry add pytest-embedded-idf

## Installing pytest-embedded-idf

Before you install: Low friction installation as a pure Python wheel. Actively maintained with recent commits and a stable release cycle; last release 59 days ago with the repository actively developed.

License in practice: MIT license (permissive) means you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install pytest-embedded-idf

import pytest_embedded_idf
# Use within pytest fixtures or test functions with pytest-embedded

Requires Python 3.10 or later; depends on pytest-embedded, esp-idf-panic-decoder, and esp-bool-parser being installed and available.

Verify before relying:

- Whether auto-flashing works with all Espressif board types or only specific models
- Performance impact of binary parsing on large or complex ESP-IDF projects
- Compatibility with pytest-embedded-serial-esp when that extra is not activated

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 121.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

esp-idf pytest testing, embedded systems test automation, embedded board flashing pytest, idf binary parsing testing, embedded device test framework, esp-idf, embedded-systems, hardware-testing

[View on SkillFed](https://skillfed.io/packages/pytest-embedded-idf) · [View on PyPI](https://pypi.org/project/pytest-embedded-idf/)