Metadata-Version: 2.1
Name: sifi-bridge-py
Version: 1.0.2
Summary: Python bindings over the sifi_bridge program.
Author-Email: SiFi Labs <gabrielg@sifilabs.com>
License: MIT
Requires-Python: >=3.10
Requires-Dist: numpy>=1.26.4
Requires-Dist: requests>=2.32.3
Requires-Dist: semantic-version>=2.10.0
Requires-Dist: matplotlib>=3.9.0; extra == "examples"
Provides-Extra: examples
Description-Content-Type: text/markdown

# SiFi Bridge Python

[![PyPI - Version](https://img.shields.io/pypi/v/sifi_bridge_py)](https://pypi.org/project/sifi-bridge-py/)
[![License](https://img.shields.io/github/license/SiFiLabs/sifi-bridge-py)](https://github.com/SiFiLabs/sifi-bridge-py/blob/main/LICENSE)
[![pdm-managed](https://img.shields.io/badge/pdm-managed-blueviolet)](https://pdm-project.org)

SiFi Bridge Python is a convenient wrapper over [SiFi Bridge CLI](https://github.com/SiFiLabs/sifi-bridge-pub).

The Python wrapper opens the CLI tool in a subprocess. Thus, it is highly recommended to implement threading, since reading from standard input is a blocking operation. To use the wrapper, start by instantiating a SiFiBridge() object. All relevant usage documentation is delivered via inline doc-strings.

## Documentation

Inline documentation is provided. Sphinx API documentation will be coming shortly.

## Examples

Examples are available in the `examples/` directory of this project.

## Installing

`pip install sifi_bridge_py` should work for most use cases.

## Versioning

The wrapper is updated for every SiFi Bridge version. Major and minor versions will always be kept in sync, while the patch version will vary for language-specific bug fixes.

## Deployment

To deploy to PyPI, push a tag to the `main` branch. The tag must respect semantic versioning format: `x.y.z`.