Skip to content

Commit 8cca9cc

Browse files
authored
Merge pull request #50 from kevincar/develop
Develop
2 parents 9cfd3be + 878bb44 commit 8cca9cc

File tree

2 files changed

+32
-12
lines changed

2 files changed

+32
-12
lines changed

README.md

Lines changed: 28 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,23 @@
11
# Bless
22

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

5-
Bless is an acronym for Bluetooth Low Energy Server Supplement since this
6-
library intends to supplement the [Bleak](https://github.com/hbldh/bleak)
7-
client library
10+
Bless is an acronym for Bluetooth Low Energy (BLE) Server Supplement.
11+
12+
Bless provides an OS-independent python package for creating a BLE Generic
13+
Attribute Profile (GATT) server to broadcast user-defined services and
14+
characteristics. This is particularly useful when prototyping and testing
15+
servers on different devices with the goal of ensuring that expected behavior
16+
matches across all systems.
17+
18+
Bless's code roughly follows a similar style to
19+
[Bleak](https://github.com/hbldh/bleak) in order to ease development of client
20+
and server programs.
821

922
# Installation
1023

@@ -14,13 +27,18 @@ pip install bless
1427

1528
# Features
1629

17-
|OS|Implemented|
18-
|--|---------|
19-
|MacOS|:white_check_mark:|
20-
|Windows|:white_check_mark:|
21-
|Linux|:white_check_mark:|
30+
Bless enables reading, writing, and notifying of BLE characteristic values.
31+
Developers can provide callback functions to manipulate data that is sent out
32+
for reading or delivered for writing prior to processing the underlying
33+
commands.
2234

2335
# Examples
2436

25-
See our [Server
37+
See example code for setting up a BLE server where read and write
38+
characteristic can be be probed by BLE clients (central devices)
39+
40+
[Basic Server
2641
Example](https://github.com/kevincar/bless/blob/master/examples/server.py)
42+
43+
[GATT Tree Server
44+
Example](https://github.com/kevincar/bless/blob/master/examples/gattserver.py)

setup.py

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55

66
setuptools.setup(
77
name="bless",
8-
version="0.2.0",
8+
version="0.2.1",
99
author="Kevin Davis",
1010
author_email="kevincarrolldavis@gmail.com",
1111
description="A Bluetooth Low Energy Server supplement to Bleak",
@@ -16,7 +16,9 @@
1616
packages=setuptools.find_packages(exclude=("test", "examples")),
1717
include_package_data=True,
1818
install_requires=[
19-
"bleak"
19+
"bleak",
20+
"twisted; platform_system == 'Linux' ",
21+
"txdbus; platform_system == 'Linux'"
2022
],
2123
classifiers=[
2224
"Programming Language :: Python :: 3",

0 commit comments

Comments
 (0)