chumicro-knobs 0.1.1__tar.gz → 0.1.2__tar.gz

{chumicro_knobs-0.1.1 → chumicro_knobs-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: chumicro-knobs
-Version: 0.1.1
+Version: 0.1.2
 Summary: Rotary encoders and analog knobs, read as a position that holds still
 Project-URL: Homepage, https://github.com/ChuMicro/ChuMicro
 Project-URL: Documentation, https://chumicro.com/ChuMicro/knobs/stable/

chumicro_knobs-0.1.2/VERSION

@@ -0,0 +1 @@
+0.1.2

{chumicro_knobs-0.1.1 → chumicro_knobs-0.1.2}/docs/index.md

@@ -23,6 +23,23 @@ while True:
 
 `just_moved` is true for exactly one pass of the loop, so you can read it as often as you like without it firing twice.  `bounds` walks the number between 0 and 20 and stops it at both ends.
 
+In a program with more going on, hand the loop to `chumicro-runner` and let the callback do the reading:
+
+```python
+from chumicro_runner import Runner
+
+volume.on_change = lambda detents: print("volume", volume.position)
+
+runner = Runner()
+runner.add(volume)
+
+while True:
+    now = runner.tick()
+    runner.wait(now)
+```
+
+Every service in your program shares those same two lines.
+
 ## Documentation
 
 - [User Guide](guide.md): wiring an encoder, bounds and wrap, reading a potentiometer, the deadband that holds it still, callbacks, and wiring into a runner

chumicro_knobs-0.1.1/VERSION

@@ -1 +0,0 @@
-0.1.1