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

# pytest-embedded-serial — Make pytest-embedded plugin work with Serial.

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

## What it is and what it does

pytest-embedded-serial is a pytest plugin that extends the pytest-embedded framework specifically for serial port communication with embedded devices. It provides fixtures like `Dut` (Device Under Test) that allow you to send commands to and capture output from devices connected via serial, using pattern matching methods like `expect()` and `expect_exact()` to validate device behavior.

The plugin is designed for testing embedded systems where you need to interact with hardware over serial connections. It depends on pytest-embedded for core functionality and pyserial for low-level serial port access. The plugin supports semantic versioning and is actively maintained, with support for modern Python versions (3.10 through 3.14).

Use it for:

- Test firmware output from microcontroller boards connected via USB serial
- Validate command-response behavior of embedded devices during CI/CD pipelines
- Automate serial port interaction testing for IoT device prototypes
- Capture and assert on device debug logs and diagnostic output over serial
- Integration testing of embedded applications with real hardware or emulation

## Worth the install?

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

A pytest plugin that enables serial port testing for embedded systems, providing fixtures and utilities to interact with and validate device behavior over serial connections.

Yes. This is a stable, actively maintained plugin for a specific but important use case: testing embedded systems over serial connections. Low install friction, permissive license, no known vulnerabilities, and recent activity make it a reliable choice if you need pytest-based serial device testing.

## Install

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

## Installing pytest-embedded-serial

Before you install: Low friction install with a pure-Python wheel. Actively maintained with a recent release; last commit on 2026-08-10 and 59 days since the latest release indicate steady development.

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

Quickstart:

pip install pytest-embedded-serial

from pytest_embedded import Dut

def test_serial_device(dut: Dut):
    dut.expect('expected_output')
    dut.expect_exact('exact_match')

Requires Python 3.10 or later; pyserial must be available for serial port access.

Verify before relying:

- Whether the serial service is automatically enabled or requires --embedded-services serial flag
- Specific serial port configuration requirements (baud rate, timeout defaults)
- Whether pyserial is bundled or must be installed separately for serial functionality

## Package facts

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

## Tags

pytest serial port testing, embedded device testing pytest, serial communication testing, pytest embedded fixtures, device serial interaction testing, embedded systems test automation, pytest serial device validation, embedded-systems, serial-testing, hardware-testing

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