all_types example (from placeholder)

Author: Mike Prosser

examples/all_types/README.md

@@ -0,0 +1,15 @@
+## All Types Example
+
+This is a nipanel example that demonstrates all supported data types
+
+### Feature
+
+- Demonstrates support for all data types
+
+### Required Software
+
+- Python 3.9 or later
+
+### Usage
+
+Run `poetry run examples/all_types/all_types.py`

examples/all_types/all_types.py

@@ -0,0 +1,23 @@
+"""example script for nipanel package demonstrating various data types."""
+
+from pathlib import Path
+
+from define_types import all_types_with_values
+
+import nipanel
+
+panel_script_path = Path(__file__).with_name("all_types_panel.py")
+panel = nipanel.create_panel(panel_script_path)
+
+print("Setting values")
+for name, value in all_types_with_values.items():
+    print(f"{name:>15}   {value}")
+    panel.set_value(name, value)
+
+print()
+print("Getting values")
+for name in all_types_with_values.keys():
+    the_value = panel.get_value(name)
+    print(f"{name:>20}   {the_value}")
+
+print(f"Panel URL: {panel.panel_url}")

examples/all_types/all_types_panel.py

@@ -0,0 +1,19 @@
+"""A Streamlit panel to demonstrate various types and their values."""
+
+import streamlit as st
+from define_types import all_types_with_values
+
+import nipanel
+
+panel = nipanel.initialize_panel()
+
+st.title("All Types")
+
+for name in all_types_with_values.keys():
+    col1, col2 = st.columns([0.4, 0.6])
+
+    with col1:
+        st.write(name)
+
+    with col2:
+        st.write(panel.get_value(name))

examples/all_types/define_types.py

@@ -0,0 +1,55 @@
+"""Define types."""
+
+import enum
+
+
+class MyIntFlags(enum.IntFlag):
+    """Example of an IntFlag enum."""
+
+    VALUE1 = 1
+    VALUE2 = 2
+    VALUE4 = 4
+
+
+class MyIntEnum(enum.IntEnum):
+    """Example of an IntEnum enum."""
+
+    VALUE10 = 10
+    VALUE20 = 20
+    VALUE30 = 30
+
+
+class MyStrEnum(str, enum.Enum):
+    """Example of a mixin string enum."""
+
+    VALUE1 = "value1"
+    VALUE2 = "value2"
+    VALUE3 = "value3"
+
+
+all_types_with_values = {
+    # supported scalar types
+    "bool_scalar": True,
+    "bytes_scalar": b"robotext",
+    "float_scalar": 13.12,
+    "int_scalar": 42,
+    "str_scalar": "sample string",
+    # supported collection types
+    "bool_collection": [True, False, True],
+    "bytes_collection": [b"one", b"two", b"three"],
+    "float_collection": [1.1, 2.2, 3.3],
+    "int_collection": [1, 2, 3],
+    "str_collection": ["one", "two", "three"],
+    # supported enum and flag types
+    "intflags_scalar": MyIntFlags.VALUE1 | MyIntFlags.VALUE4,
+    "intenum_scalar": MyIntEnum.VALUE20,
+    "strenum_scalar": MyStrEnum.VALUE3,
+    "intflags_collection": [MyIntFlags.VALUE1, MyIntFlags.VALUE2, MyIntFlags.VALUE4],
+    "intenum_collection": [MyIntEnum.VALUE10, MyIntEnum.VALUE20, MyIntEnum.VALUE30],
+    "strenum_collection": [MyStrEnum.VALUE1, MyStrEnum.VALUE2, MyStrEnum.VALUE3],
+    # supported collections
+    "list": [1, 2, 3],
+    "tuple": (4, 5, 6),
+    "set": {7, 8, 9},
+    "frozenset": frozenset([10, 11, 12]),
+}

examples/placeholder.py

@@ -1,16 +1,12 @@
 """This example demonstrates how to open/update a Streamlit application using nipanel package."""
 
-import pathlib
+from pathlib import Path
 
 import nipanel
 
-script_path = pathlib.Path(__file__)
-panel_script_path = str(script_path.with_name("sample_panel.py"))
+panel_script_path = Path(__file__).with_name("sample_panel.py")
+panel = nipanel.create_panel(panel_script_path)
 
-panel = nipanel.StreamlitPanel(
-    panel_id="sample_panel",
-    streamlit_script_path=panel_script_path,
-)
 panel.set_value("sample_string", "Hello, World!")
 panel.set_value("sample_int", 42)
 panel.set_value("sample_float", 3.14)