feat(navbar_options): Consolidate options and use in navset_bar()

Author: gadenbuie

shiny/express/ui/__init__.py

@@ -108,6 +108,7 @@
     notification_show,
     notification_remove,
     nav_spacer,
+    navbar_options,
     Progress,
     Theme,
     value_box_theme,
@@ -282,6 +283,7 @@
     "navset_pill_list",
     "navset_tab",
     "navset_underline",
+    "navbar_options",
     "value_box",
     "panel_well",
     "panel_conditional",

shiny/types.py

@@ -31,24 +31,30 @@
 from htmltools import TagChild
 
 from ._docstring import add_example
-from ._typing_extensions import NotRequired, TypedDict
+from ._typing_extensions import NotRequired, TypedDict, TypeIs
 
 if TYPE_CHECKING:
     from matplotlib.figure import Figure
 
+T = TypeVar("T")
+
 
 # Sentinel value - indicates a missing value in a function call.
 class MISSING_TYPE:
     pass
 
 
 MISSING: MISSING_TYPE = MISSING_TYPE()
+DEPRECATED: MISSING_TYPE = MISSING_TYPE()  # A MISSING that communicates deprecation
+MaybeMissing = Union[T, MISSING_TYPE]
 
-
-T = TypeVar("T")
 ListOrTuple = Union[List[T], Tuple[T, ...]]
 
 
+def is_missing(x: Any) -> TypeIs[MISSING_TYPE]:
+    return x is MISSING or isinstance(x, MISSING_TYPE)
+
+
 # Information about a single file, with a structure like:
 #   {'name': 'mtcars.csv', 'size': 1303, 'type': 'text/csv', 'datapath: '/...../mtcars.csv'}
 # The incoming data doesn't include 'datapath'; that field is added by the

shiny/ui/__init__.py

@@ -115,6 +115,7 @@
     nav_menu,
     nav_panel,
     nav_spacer,
+    navbar_options,
     navset_bar,
     navset_card_pill,
     navset_card_tab,
@@ -291,6 +292,7 @@
     "navset_pill_list",
     "navset_hidden",
     "navset_bar",
+    "navbar_options",
     # _notification
     "notification_show",
     "notification_remove",