Usage
=====

Create a server, add a GATT tree, then start advertising:

.. code-block:: python

   import asyncio
   from bless import (
       BlessServer,
       GATTCharacteristicProperties,
       GATTAttributePermissions,
   )

   async def run(loop):
       gatt = {
           "A07498CA-AD5B-474E-940D-16F1FBE7E8CD": {
               "51FF12BB-3ED8-46E5-B4F9-D64E2FEC021B": {
                   "Properties": (
                       GATTCharacteristicProperties.read
                       | GATTCharacteristicProperties.write
                   ),
                   "Permissions": (
                       GATTAttributePermissions.readable
                       | GATTAttributePermissions.writable
                   ),
                   "Value": None,
               }
           }
       }

       server = BlessServer(name="Bless Example", loop=loop)
       await server.add_gatt(gatt)
       await server.start()

   loop = asyncio.get_event_loop()
   loop.run_until_complete(run(loop))

Callback Priority
=================

Bless routes callbacks in the following order:

1. Characteristic-specific callbacks (for example, `characteristic.on_read`)
2. Server-wide callbacks (for example, `server.on_read`)
3. Default handling if no callbacks are defined

Default handling currently returns the characteristic value for reads. Writes,
subscriptions, and unsubscriptions are no-ops unless a callback is defined.