rra/dropship
2
1
Fork 0
Code Issues 11 Pull Requests Releases Wiki Activity

Document async wrangling

Browse Source
This commit is contained in:
Luke Murphy 2020-09-20 16:33:53 +02:00
parent 9975ff8163
commit ba8dd8f611
No known key found for this signature in database
GPG Key ID: 5E2EF5A63E3718CC
1 changed files with 16 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
README.md
View File

@ -24,6 +24,22 @@ _(click for video)_
`python3 dropship.py`
## development notes:
### How we handle asynchronous actions
We use the [Trio guest
mode](https://trio.readthedocs.io/en/latest/reference-lowlevel.html#using-guest-mode-to-run-trio-on-top-of-other-event-loops)
instead of relying on threads because those are hard to manage. Running two
loops (Gtk and Trio) has disadvantages but overall, it offers a very clear way
of organising and executing asynchronous operations.
In practice, this means you need to arrange the following:
1. Wire up your usual hook (`self.drop_box.connect("drag-data-received", self.on_drop)`)
2. In your hook function, call your asynchronous function via the `self.nursery.start_soon` API
3. Define your asynchronous function with `async def` and use the `await` keyword as usual
## operations:
### github mirror: