Skip to content

Commit

Permalink
Merge pull request #50 from kevincar/develop
Browse files Browse the repository at this point in the history
Develop
  • Loading branch information
kevincar authored Jun 18, 2021
2 parents 9cfd3be + 878bb44 commit 8cca9cc
Show file tree
Hide file tree
Showing 2 changed files with 32 additions and 12 deletions.
38 changes: 28 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,23 @@
# Bless

Bless is an extension of [Bleak](https://github.com/hbldh/bleak).
[![Build, Lint, and
Test](https://github.com/kevincar/bless/actions/workflows/build-and-test.yml/badge.svg)
](https://github.com/kevincar/bless/actions/workflows/build-and-test.yml)
[![PyPI version](https://badge.fury.io/py/bless.svg)](https://badge.fury.io/py/bless)
![PyPI - Downloads](https://img.shields.io/pypi/dm/bless)
[![Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

Bless is an acronym for Bluetooth Low Energy Server Supplement since this
library intends to supplement the [Bleak](https://github.com/hbldh/bleak)
client library
Bless is an acronym for Bluetooth Low Energy (BLE) Server Supplement.

Bless provides an OS-independent python package for creating a BLE Generic
Attribute Profile (GATT) server to broadcast user-defined services and
characteristics. This is particularly useful when prototyping and testing
servers on different devices with the goal of ensuring that expected behavior
matches across all systems.

Bless's code roughly follows a similar style to
[Bleak](https://github.com/hbldh/bleak) in order to ease development of client
and server programs.

# Installation

Expand All @@ -14,13 +27,18 @@ pip install bless

# Features

|OS|Implemented|
|--|---------|
|MacOS|:white_check_mark:|
|Windows|:white_check_mark:|
|Linux|:white_check_mark:|
Bless enables reading, writing, and notifying of BLE characteristic values.
Developers can provide callback functions to manipulate data that is sent out
for reading or delivered for writing prior to processing the underlying
commands.

# Examples

See our [Server
See example code for setting up a BLE server where read and write
characteristic can be be probed by BLE clients (central devices)

[Basic Server
Example](https://github.com/kevincar/bless/blob/master/examples/server.py)

[GATT Tree Server
Example](https://github.com/kevincar/bless/blob/master/examples/gattserver.py)
6 changes: 4 additions & 2 deletions setup.py
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@

setuptools.setup(
name="bless",
version="0.2.0",
version="0.2.1",
author="Kevin Davis",
author_email="kevincarrolldavis@gmail.com",
description="A Bluetooth Low Energy Server supplement to Bleak",
Expand All @@ -16,7 +16,9 @@
packages=setuptools.find_packages(exclude=("test", "examples")),
include_package_data=True,
install_requires=[
"bleak"
"bleak",
"twisted; platform_system == 'Linux' ",
"txdbus; platform_system == 'Linux'"
],
classifiers=[
"Programming Language :: Python :: 3",
Expand Down

0 comments on commit 8cca9cc

Please sign in to comment.