Add DigitDisplay widget

CHANGELOG.md

@@ -13,6 +13,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 - Added the ability to run async methods as thread workers https://github.com/Textualize/textual/pull/2938
 - Added `App.stop_animation` https://github.com/Textualize/textual/issues/2786
 - Added `Widget.stop_animation` https://github.com/Textualize/textual/issues/2786
+- Added DigitDisplay widget https://github.com/Textualize/textual/pull/2995
 
 ### Changed
 

Makefile

@@ -10,7 +10,7 @@ unit-test:
 
 .PHONY: test-snapshot-update
 test-snapshot-update:
-	$(run) pytest --cov-report term-missing --cov=textual tests/ -vv --snapshot-update
+	$(run) pytest --cov-report term-missing --cov=textual tests/ -vv --snapshot-update $(PYTEST_ARGS)
 
 .PHONY: typecheck
 typecheck:

docs/examples/widgets/digit_display.py

@@ -0,0 +1,24 @@
+from textual.app import App, ComposeResult
+from textual.widgets import Label
+from textual.widgets import DigitDisplay
+
+
+class MyApp(App):
+    BINDINGS = []
+
+    def compose(self) -> ComposeResult:
+        yield Label("Digits: 0123456789")
+        yield DigitDisplay("0123456789")
+
+        punctuation = " .+,XYZ^*/-="
+        yield Label("Punctuation: " + punctuation)
+        yield DigitDisplay(punctuation)
+
+        equation = "x = y^2 + 3.14159*y + 10"
+        yield Label("Equation: " + equation)
+        yield DigitDisplay(equation)
+
+
+if __name__ == "__main__":
+    app = MyApp()
+    app.run()

docs/examples/widgets/digit_display_reacting.py

@@ -0,0 +1,20 @@
+from textual.app import App, ComposeResult
+from textual.widgets import Input
+from textual.widgets import DigitDisplay
+
+
+class MyApp(App):
+    BINDINGS = []
+
+    def compose(self) -> ComposeResult:
+        yield Input(placeholder="Type something:")
+        yield DigitDisplay("")
+
+    def on_input_changed(self, event: Input.Changed) -> None:
+        display: DigitDisplay = self.query_one(DigitDisplay)
+        display.digits = "".join(d for d in event.value if d in DigitDisplay.supported_digits)
+
+
+if __name__ == "__main__":
+    app = MyApp()
+    app.run()

docs/widget_gallery.md

@@ -52,6 +52,15 @@ A powerful data table, with configurable cursors.
 ```{.textual path="docs/examples/widgets/data_table.py"}
 ```
 
+## DigitDisplay
+
+A widget to display digits and basic arithmetic operators using Unicode blocks.
+
+[DigitDisplay reference](./widgets/digit_display.md){ .md-button .md-button--primary }
+
+```{.textual path="docs/examples/widgets/digit_display.py"}
+```
+
 ## DirectoryTree
 
 A tree view of files and folders.

docs/widgets/digit_display.md

@@ -0,0 +1,71 @@
+# DigitDisplay
+
+A widget to display digits and basic arithmetic operators using Unicode blocks.
+
+- [ ] Focusable
+- [ ] Container
+
+## Examples
+
+
+### Static display example
+
+=== "Screenshot"
+
+    ```{.textual path="docs/examples/widgets/digit_display.py"}
+    ```
+
+=== "digit_display.py"
+
+    ```python
+    --8<-- "docs/examples/widgets/digit_display.py"
+    ```
+
+
+### Reacting to an input
+
+=== "Screenshot"
+
+    ```{.textual path="docs/examples/widgets/digit_display_reacting.py" press="1,2,3"}
+    ```
+
+=== "digit_display_reacting.py"
+
+    ```python
+    --8<-- "docs/examples/widgets/digit_display_reacting.py"
+    ```
+
+## Reactive attributes
+
+| Name     | Type   | Default | Description                                    |
+| ------   | ------ | ------- | ---------------------------------------------- |
+| `digits` | `str`  | `""`    | Use this to update the digits to be displayed. |
+
+
+## Read-only attributes
+
+| Name               | Type             | Description                                       |
+| ------             | ------           | -----------------------------------------         |
+| `supported_digits` | `frozenset[str]` | Contains the list of supported digits/characters. |
+
+## Messages
+
+This widget sends no messages.
+
+
+## Bindings
+
+This widget defines no bindings.
+
+
+## Component classes
+
+This widget provides no component classes.
+
+
+---
+
+
+::: textual.widgets.DigitDisplay
+    options:
+      heading_level: 2

src/textual/widgets/__init__.py

@@ -40,13 +40,15 @@
     from ._tooltip import Tooltip
     from ._tree import Tree
     from ._welcome import Welcome
+    from ._digit_display import DigitDisplay
 
 
 __all__ = [
     "Button",
     "Checkbox",
     "ContentSwitcher",
     "DataTable",
+    "DigitDisplay",
     "DirectoryTree",
     "Footer",
     "Header",