Metadata-Version: 2.1
Name: robotframework-pyserial
Version: 1.1.0
Summary: Robotframework implementation of beloved pyserial module
Home-page: https://reharish.github.io/cv
Author: reharish
Author-email: rengarajharish@gmail.com
License: Apache License 2.0
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: robotframework
Requires-Dist: pyserial

# Robot Framework - SerialLibrary

## Overview

PySerial Robot Framework Library is a Python library for interacting with serial devices using Robot Framework. This library provides keywords for connecting to serial devices, reading and writing data, setting timeouts, and more.

## Installation

```bash
pip install robotframework-pyserial
```

## Documentation

For detailed documentation of each keyword and usage examples, refer to the documentation in the below link,

https://reharish.github.io/robotframework-pyserial

## Project Inspiration

- [zilogic-systems/parrot](https://github.com/zilogic-systems/parrot) - Embedded Test Automation Framework, based on Robot Framework.

- [pySerial](https://github.com/pyserial/pyserial) - Python serial port access library

## Usage

To use the PySerial Robot Framework Library in your Robot Framework test suites, you need to import it at the beginning of your test suite file:

```robot
*** Settings ***
Library    SerialLibrary

*** Test Cases ***
Example Test
    Connect to Serial    COM1    9600
    Set Timeout    5
    Write    Hello, world!
    ${data}=    Read
    Should Be Equal    ${data}    Hello, world!
    Disconnect from Serial
```

## Keywords

| Keyword                  | Description                                    |
|--------------------------|------------------------------------------------|
| **Connect to Serial**    | Connects to a serial device.                   |
| **Disconnect from Serial** | Disconnects from the serial device.           |
| **Set Timeout**          | Sets the read timeout for the serial device.   |
| **Set Write Timeout**    | Sets the write timeout for the serial device.  |
| **Set Unicode**          | Sets the Unicode encoding for data communication. |
| **Read**                 | Reads data from the serial device.             |
| **Write**                | Writes data to the serial device.              |
| **Read until**           | Reads data from the serial device until a specified string is encountered. |
| **Read All**             | Reads all the data from the input buffer.      |
| **Reset Input Buffer**   | Clear the input buffer for the serial device.  |
| **Reset Output Buffer**  | Clear the output buffer for the serial device. |
| **Save buffer to file**  | Saves the data buffer into a file.             |


## Contributors

- Harishbabu Rengaraj([@reharish](https://github.com/reharish))
- Abisheak Kumarasamy ([@abi-sheak](https://github.com/abi-sheak))


## License

- See the `LICENSE` file for details.
