PlestyLib

PlestyLib is the core Python library in the PLESTY ecosystem for building standardized device APIs for laboratory and experimental automation.

It provides reusable abstractions for:

Device lifecycle and synchronous device models
Transport/traffic management (Serial, VISA, TCP/IP)
Command and operation solvers (for example SCPI and operation-message protocols)
Parameter and function metadata systems
Auto testing helpers, logging, and error-handling utilities

Requirements

Python 3.12+

Installation

Install from package index:

pip install plesty-lib
# or 
uv add plesty-lib

Optional dependencies

Features that need a heavy or platform-specific package keep it out of the base install and behind an extra. Without the extra the feature raises an ImportError naming it; nothing else is affected.

Extra	Adds	Enables
`hdf5`	`h5py`	`convert_to_hdf5` — packs saved results into one HDF5 archive
`fit`	`scipy`	`SpectrumFit` analyzer — Gaussian / Lorentzian / Voigt spectrum fits

pip install "plesty-lib[hdf5]"
# or
uv add "plesty-lib[hdf5]"

For development, install from source and sync the dev dependency group:

uv sync --group dev
# or
pip install -e .
pip install plesty-sdk

Quick Start

1. Create a device class from a base device

from plesty.lib.device.base_visa_scpi_device import BaseVisaScpiDevice


class PowermeterDevice(BaseVisaScpiDevice):
	def __init__(self, address: str):
		super().__init__(address)
		self.register_config("POWER", dtype=float, read_only=True, command="MEAS:SCAL:POW")
		self.register_config("WAVELENGTH", dtype=int, unit="nm", command="SENS:CORR:WAV")

2. Use the device

# replace the serial number P0000001 with that of your own device
address = "USB0::0x1313::0x8078::P0000001::INSTR"

with PowermeterDevice(address) as dev:
	print(dev.identity())
	print(dev.query("POWER"))

Architecture Overview

PlestyLib encourages a layered device API design:

Base device model: operation entry points and parameter/function systems
Command/operation solver: map standardized calls to protocol payloads
Traffic manager: transport-specific I/O with real hardware
Optional wrappers: async and TCP/IP service/client patterns

This separation keeps implementations testable and easier to maintain.

License

Plesty is licensed under the GNU Lesser General Public License v3.0 or later (LGPL-3.0-or-later). See the LICENSE file.

Release files for plesty-lib 0.5.0.dev4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for plesty-lib 0.5.0.dev4
File	Size	Uploaded
plesty_lib-0.5.0.dev4.tar.gz	773.1 kB	Sep 17, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for plesty-lib 0.5.0.dev4
File	Interpreter	ABI	Platform	Reset
plesty_lib-0.5.0.dev4-py3-none-any.whl 442.2 kB Sep 17, 2026	Python 3	none	any	Details

Total release size: 1.2 MB

Release files / plesty_lib-0.5.0.dev4.tar.gz

Download URL	plesty_lib-0.5.0.dev4.tar.gz
Size	773.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`1d593eb19db12f5c8f84a1a9180b1c436b44d655b5244fd81592a313ccd6313c`
BLAKE2b-256 checksum How to use checksums	`11bdfbaa8ca2af6eb0a4fc980ca6e19554cde5f8ab3bc88ad58d9882503fbb6f`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / plesty_lib-0.5.0.dev4-py3-none-any.whl

Download URL	plesty_lib-0.5.0.dev4-py3-none-any.whl
Size	442.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9854f7256ab96403715d07df06d0719431cf64293480ccc03a3a8fa987d79b75`
BLAKE2b-256 checksum How to use checksums	`d95d496b2d5e08028e11c2259f095aefc63ed41d660ca2d4109d1487a2c9a5b2`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`