rename: Maybe[] instead of MaybeMissing[]

Author: gadenbuie

shiny/express/ui/_cm_components.py

@@ -8,7 +8,7 @@
 
 from ... import ui
 from ..._docstring import add_example, no_example
-from ...types import DEPRECATED, MISSING, MISSING_TYPE, MaybeMissing
+from ...types import DEPRECATED, MISSING, MISSING_TYPE, Maybe
 from ...ui._accordion import AccordionPanel
 from ...ui._card import CardItem
 from ...ui._layout_columns import BreakpointsUser
@@ -1080,11 +1080,11 @@ def navset_bar(
     navbar_options: Optional[NavbarOptions] = None,
     fluid: bool = True,
     # Deprecated ----
-    position: MaybeMissing[NavbarOptionsPositionT] = DEPRECATED,
-    bg: MaybeMissing[str | None] = DEPRECATED,
-    inverse: MaybeMissing[bool] = DEPRECATED,
-    underline: MaybeMissing[bool] = DEPRECATED,
-    collapsible: MaybeMissing[bool] = DEPRECATED,
+    position: Maybe[NavbarOptionsPositionT] = DEPRECATED,
+    bg: Maybe[str | None] = DEPRECATED,
+    inverse: Maybe[bool] = DEPRECATED,
+    underline: Maybe[bool] = DEPRECATED,
+    collapsible: Maybe[bool] = DEPRECATED,
 ) -> RecallContextManager[NavSetBar]:
     """
     Context manager for a set of nav items as a tabset inside a card container.

shiny/types.py

@@ -46,7 +46,7 @@ class MISSING_TYPE:
 
 MISSING: MISSING_TYPE = MISSING_TYPE()
 DEPRECATED: MISSING_TYPE = MISSING_TYPE()  # A MISSING that communicates deprecation
-MaybeMissing = Union[T, MISSING_TYPE]
+Maybe = Union[T, MISSING_TYPE]
 
 ListOrTuple = Union[List[T], Tuple[T, ...]]
 

shiny/ui/_navs.py

@@ -22,7 +22,7 @@
 from .._docstring import add_example
 from .._namespaces import resolve_id_or_none
 from .._utils import private_random_int
-from ..types import DEPRECATED, MISSING, MaybeMissing, NavSetArg, is_missing
+from ..types import DEPRECATED, MISSING, Maybe, NavSetArg, is_missing
 from ._bootstrap import column, row
 from ._card import CardItem, WrapperCallable, card, card_body, card_footer, card_header
 from ._html_deps_shinyverse import components_dependencies
@@ -1013,11 +1013,11 @@ class NavbarOptions:
     def __init__(
         self,
         *,
-        position: MaybeMissing[NavbarOptionsPositionT] = MISSING,
-        bg: MaybeMissing[str | None] = MISSING,
-        theme: MaybeMissing[NavbarOptionsThemeT] = MISSING,
-        underline: MaybeMissing[bool] = MISSING,
-        collapsible: MaybeMissing[bool] = MISSING,
+        position: Maybe[NavbarOptionsPositionT] = MISSING,
+        bg: Maybe[str | None] = MISSING,
+        theme: Maybe[NavbarOptionsThemeT] = MISSING,
+        underline: Maybe[bool] = MISSING,
+        collapsible: Maybe[bool] = MISSING,
         **attrs: TagAttrValue,
     ):
         self._is_default = {}
@@ -1070,11 +1070,11 @@ def __repr__(self):
 
 @add_example()
 def navbar_options(
-    position: MaybeMissing[NavbarOptionsPositionT] = MISSING,
-    bg: MaybeMissing[str | None] = MISSING,
-    theme: MaybeMissing[NavbarOptionsThemeT] = MISSING,
-    underline: MaybeMissing[bool] = MISSING,
-    collapsible: MaybeMissing[bool] = MISSING,
+    position: Maybe[NavbarOptionsPositionT] = MISSING,
+    bg: Maybe[str | None] = MISSING,
+    theme: Maybe[NavbarOptionsThemeT] = MISSING,
+    underline: Maybe[bool] = MISSING,
+    collapsible: Maybe[bool] = MISSING,
     **attrs: TagAttrValue,
 ) -> NavbarOptions:
     """
@@ -1120,11 +1120,11 @@ def navbar_options(
 
 def navbar_options_resolve_deprecated(
     options_user: Optional[NavbarOptions] = None,
-    position: MaybeMissing[NavbarOptionsPositionT] = DEPRECATED,
-    bg: MaybeMissing[str | None] = DEPRECATED,
-    inverse: MaybeMissing[bool] = DEPRECATED,
-    underline: MaybeMissing[bool] = DEPRECATED,
-    collapsible: MaybeMissing[bool] = DEPRECATED,
+    position: Maybe[NavbarOptionsPositionT] = DEPRECATED,
+    bg: Maybe[str | None] = DEPRECATED,
+    inverse: Maybe[bool] = DEPRECATED,
+    underline: Maybe[bool] = DEPRECATED,
+    collapsible: Maybe[bool] = DEPRECATED,
     fn_caller: str = "navset_bar",
 ) -> NavbarOptions:
     options_user = options_user if options_user is not None else navbar_options()
@@ -1375,11 +1375,11 @@ def navset_bar(
     navbar_options: Optional[NavbarOptions] = None,
     fluid: bool = True,
     # Deprecated -- v1.3.0 2025-01 ----
-    position: MaybeMissing[NavbarOptionsPositionT] = DEPRECATED,
-    bg: MaybeMissing[str | None] = DEPRECATED,
-    inverse: MaybeMissing[bool] = DEPRECATED,
-    underline: MaybeMissing[bool] = DEPRECATED,
-    collapsible: MaybeMissing[bool] = DEPRECATED,
+    position: Maybe[NavbarOptionsPositionT] = DEPRECATED,
+    bg: Maybe[str | None] = DEPRECATED,
+    inverse: Maybe[bool] = DEPRECATED,
+    underline: Maybe[bool] = DEPRECATED,
+    collapsible: Maybe[bool] = DEPRECATED,
 ) -> NavSetBar:
     """
     Render nav items as a navbar.

shiny/ui/_page.py

@@ -31,7 +31,7 @@
 
 from .._docstring import add_example, no_example
 from .._namespaces import resolve_id_or_none
-from ..types import DEPRECATED, MISSING, MISSING_TYPE, MaybeMissing, NavSetArg
+from ..types import DEPRECATED, MISSING, MISSING_TYPE, Maybe, NavSetArg
 from ._bootstrap import panel_title
 from ._html_deps_external import Theme, ThemeProvider, shiny_page_theme_deps
 from ._html_deps_py_shiny import page_output_dependency
@@ -175,13 +175,13 @@ def page_navbar(
     lang: Optional[str] = None,
     theme: Optional[str | Path | Theme | ThemeProvider] = None,
     # Deprecated -- v1.3.0 2025-01 ----
-    position: MaybeMissing[
+    position: Maybe[
         Literal["static-top", "fixed-top", "fixed-bottom"]
     ] = DEPRECATED,
-    bg: MaybeMissing[str | None] = DEPRECATED,
-    inverse: MaybeMissing[bool] = DEPRECATED,
-    underline: MaybeMissing[bool] = DEPRECATED,
-    collapsible: MaybeMissing[bool] = DEPRECATED,
+    bg: Maybe[str | None] = DEPRECATED,
+    inverse: Maybe[bool] = DEPRECATED,
+    underline: Maybe[bool] = DEPRECATED,
+    collapsible: Maybe[bool] = DEPRECATED,
 ) -> Tag:
     """
     Create a page with a navbar and a title.