ex4nicegui 0.6.6__py3-none-any.whl → 0.6.8__py3-none-any.whl

ex4nicegui/reactive/officials/number.py

@@ -6,11 +6,9 @@ from typing import (
     Dict,
     Union,
 )
-from ex4nicegui.reactive.utils import ParameterClassifier
-from ex4nicegui.utils.apiEffect import ui_effect
-
+from ex4nicegui.reactive.services.reactive_service import ParameterClassifier
 from ex4nicegui.utils.signals import (
-    ReadonlyRef,
+    TGetterOrReadonlyRef,
     _TMaybeRef as TMaybeRef,
     to_value,
 )
@@ -20,6 +18,10 @@ from .base import BindableUi
 T = TypeVar("T")
 
 
+def _default_vmodel_args_getter(e):
+    return e.sender.value
+
+
 class NumberBindableUi(BindableUi[ui.number]):
     def __init__(
         self,
@@ -29,6 +31,7 @@ class NumberBindableUi(BindableUi[ui.number]):
         value: Optional[Union[TMaybeRef[float], TMaybeRef[int]]] = None,
         min: Optional[TMaybeRef[float]] = None,
         max: Optional[TMaybeRef[float]] = None,
+        precision: Optional[TMaybeRef[int]] = None,
         step: Optional[TMaybeRef[float]] = None,
         prefix: Optional[TMaybeRef[str]] = None,
         suffix: Optional[TMaybeRef[str]] = None,
@@ -44,6 +47,7 @@ class NumberBindableUi(BindableUi[ui.number]):
                 "value",
                 "min",
                 "max",
+                "precision",
                 "step",
                 "prefix",
                 "suffix",
@@ -52,10 +56,10 @@ class NumberBindableUi(BindableUi[ui.number]):
             ],
             v_model=("value", "on_change"),
             events=["on_change"],
+            v_model_arg_getter=_default_vmodel_args_getter,
         )
 
         value_kws = pc.get_values_kws()
-
         element = ui.number(**value_kws)
         super().__init__(element)  # type: ignore
 
@@ -66,15 +70,26 @@ class NumberBindableUi(BindableUi[ui.number]):
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: ReadonlyRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "value":
             return self.bind_value(ref_ui)
 
+        if prop == "precision":
+            return self._bind_precision(ref_ui)
+
         return super().bind_prop(prop, ref_ui)
 
-    def bind_value(self, ref_ui: ReadonlyRef[float]):
-        @ui_effect
+    def bind_value(self, ref_ui: TGetterOrReadonlyRef[float]):
+        @self._ui_effect
         def _():
             self.element.set_value(to_value(ref_ui))
 
         return self
+
+    def _bind_precision(self, ref_ui: TGetterOrReadonlyRef[int]):
+        @self._ui_signal_on(ref_ui, onchanges=True)
+        def _():
+            self.element.precision = to_value(ref_ui)
+            self.element.sanitize()
+
+        return self

ex4nicegui/reactive/officials/radio.py

@@ -8,11 +8,9 @@ from typing import (
     Dict,
     Union,
 )
-from ex4nicegui.reactive.utils import ParameterClassifier
-from ex4nicegui.utils.apiEffect import ui_effect
-
+from ex4nicegui.reactive.services.reactive_service import ParameterClassifier
 from ex4nicegui.utils.signals import (
-    ReadonlyRef,
+    TGetterOrReadonlyRef,
     _TMaybeRef as TMaybeRef,
     to_value,
 )
@@ -53,7 +51,7 @@ class RadioBindableUi(BindableUi[ui.radio]):
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: ReadonlyRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "value":
             return self.bind_value(ref_ui)
 
@@ -62,15 +60,15 @@ class RadioBindableUi(BindableUi[ui.radio]):
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_options(self, ref_ui: ReadonlyRef):
-        @ui_effect
+    def bind_options(self, ref_ui: TGetterOrReadonlyRef):
+        @self._ui_effect
         def _():
             self.element.set_options(to_value(ref_ui))
 
         return self
 
-    def bind_value(self, ref_ui: ReadonlyRef):
-        @ui_effect
+    def bind_value(self, ref_ui: TGetterOrReadonlyRef):
+        @self._ui_effect
         def _():
             cast(ValueElement, self.element).set_value(to_value(ref_ui))
 

ex4nicegui/reactive/officials/row.py

@@ -1,7 +1,7 @@
 from typing import (
     Any,
 )
-from ex4nicegui.reactive.utils import ParameterClassifier
+from ex4nicegui.reactive.services.reactive_service import ParameterClassifier
 from ex4nicegui.utils.signals import (
     _TMaybeRef as TMaybeRef,
 )

ex4nicegui/reactive/officials/select.py

@@ -8,11 +8,9 @@ from typing import (
     Dict,
     Union,
 )
-from ex4nicegui.reactive.utils import ParameterClassifier
-from ex4nicegui.utils.apiEffect import ui_effect
-
+from ex4nicegui.reactive.services.reactive_service import ParameterClassifier
 from ex4nicegui.utils.signals import (
-    ReadonlyRef,
+    TGetterOrReadonlyRef,
     _TMaybeRef as TMaybeRef,
     to_value,
 )
@@ -75,7 +73,7 @@ class SelectBindableUi(BindableUi[ui.select]):
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: ReadonlyRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "value":
             return self.bind_value(ref_ui)
 
@@ -84,15 +82,15 @@ class SelectBindableUi(BindableUi[ui.select]):
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_options(self, ref_ui: ReadonlyRef):
-        @ui_effect()
+    def bind_options(self, ref_ui: TGetterOrReadonlyRef):
+        @self._ui_effect()
         def _():
             self.element.set_options(to_value(ref_ui))
 
         return self
 
-    def bind_value(self, ref_ui: ReadonlyRef):
-        @ui_effect()
+    def bind_value(self, ref_ui: TGetterOrReadonlyRef):
+        @self._ui_effect()
         def _():
             cast(ValueElement, self.element).set_value(to_value(ref_ui) or None)
 

ex4nicegui/reactive/officials/slider.py

@@ -5,11 +5,9 @@ from typing import (
     TypeVar,
     cast,
 )
-from ex4nicegui.reactive.utils import ParameterClassifier
-from ex4nicegui.utils.apiEffect import ui_effect
-
+from ex4nicegui.reactive.services.reactive_service import ParameterClassifier
 from ex4nicegui.utils.signals import (
-    ReadonlyRef,
+    TGetterOrReadonlyRef,
     Ref,
     _TMaybeRef as TMaybeRef,
     is_setter_ref,
@@ -60,14 +58,14 @@ class SliderBindableUi(
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: ReadonlyRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "value":
             return self.bind_value(ref_ui)
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_value(self, ref_ui: ReadonlyRef[float]):
-        @ui_effect
+    def bind_value(self, ref_ui: TGetterOrReadonlyRef[float]):
+        @self._ui_effect
         def _():
             self.element.set_value(to_value(ref_ui))
             self.element.update()
@@ -95,7 +93,7 @@ class LazySliderBindableUi(SliderBindableUi):
             ref = cast(Ref, org_value)
             ele = self.element
 
-            @ui_effect
+            @self._ui_effect
             def _():
                 ele.value = ref.value
 

ex4nicegui/reactive/officials/switch.py

@@ -4,11 +4,9 @@ from typing import (
     Optional,
     TypeVar,
 )
-from ex4nicegui.reactive.utils import ParameterClassifier
-from ex4nicegui.utils.apiEffect import ui_effect
-
+from ex4nicegui.reactive.services.reactive_service import ParameterClassifier
 from ex4nicegui.utils.signals import (
-    ReadonlyRef,
+    TGetterOrReadonlyRef,
     _TMaybeRef as TMaybeRef,
     to_value,
 )
@@ -49,14 +47,14 @@ class SwitchBindableUi(BindableUi[ui.switch]):
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: ReadonlyRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "value":
             return self.bind_value(ref_ui)
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_value(self, ref_ui: ReadonlyRef[bool]):
-        @ui_effect
+    def bind_value(self, ref_ui: TGetterOrReadonlyRef[bool]):
+        @self._ui_effect
         def _():
             self.element.set_value(to_value(ref_ui))
 

ex4nicegui/reactive/officials/tab.py

@@ -1,5 +1,5 @@
 from typing import Dict, Optional
-from ex4nicegui.reactive.utils import ParameterClassifier
+from ex4nicegui.reactive.services.reactive_service import ParameterClassifier
 from ex4nicegui.utils.signals import (
     to_value,
     _TMaybeRef as TMaybeRef,

ex4nicegui/reactive/officials/tab_panel.py

@@ -1,4 +1,4 @@
-from ex4nicegui.reactive.utils import ParameterClassifier
+from ex4nicegui.reactive.services.reactive_service import ParameterClassifier
 from ex4nicegui.utils.signals import (
     _TMaybeRef as TMaybeRef,
 )

ex4nicegui/reactive/officials/tab_panels.py

@@ -1,6 +1,7 @@
 from typing import Any, Callable, Optional
-from ex4nicegui.reactive.utils import ParameterClassifier
+from ex4nicegui.reactive.services.reactive_service import ParameterClassifier
 from ex4nicegui.utils.signals import (
+    TGetterOrReadonlyRef,
     to_value,
     _TMaybeRef as TMaybeRef,
 )
@@ -17,6 +18,17 @@ class TabPanelsBindableUi(BindableUi[ui.tab_panels]):
         animated: TMaybeRef[bool] = True,
         keep_alive: TMaybeRef[bool] = True,
     ) -> None:
+        """Tab Panels
+
+        @see - https://github.com/CrystalWindSnake/ex4nicegui/blob/main/README.en.md#tab_panels
+        @中文文档 - https://gitee.com/carson_add/ex4nicegui/tree/main/#tab_panels
+
+        Args:
+            value (TMaybeRef[str], optional): The value of the tab panel. Defaults to None.
+            on_change (Callable[..., Any], optional): The callback function when the value of the tab panel changes. Defaults to None.
+            animated (TMaybeRef[bool], optional): Whether to animate the tab panel. Defaults to True.
+            keep_alive (TMaybeRef[bool], optional): Whether to keep the tab panel alive. Defaults to True.
+        """
         pc = ParameterClassifier(
             locals(),
             maybeRefs=["value", "animated", "keep_alive"],
@@ -34,13 +46,13 @@ class TabPanelsBindableUi(BindableUi[ui.tab_panels]):
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: TMaybeRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "value":
             return self.bind_value(ref_ui)
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_value(self, ref_ui: TMaybeRef):
+    def bind_value(self, ref_ui: TGetterOrReadonlyRef):
         @self._ui_effect
         def _():
             self.element.set_value(to_value(ref_ui))

ex4nicegui/reactive/officials/table.py

@@ -6,17 +6,19 @@ from typing import (
     Dict,
 )
 from typing_extensions import Literal
-from ex4nicegui.reactive.utils import ParameterClassifier, dataframe2col_str
+from ex4nicegui.reactive.services.reactive_service import ParameterClassifier
+from ex4nicegui.reactive.services.pandas_service import dataframe2col_str
+
 import ex4nicegui.utils.common as utils_common
 from ex4nicegui.utils.signals import (
-    ReadonlyRef,
+    TGetterOrReadonlyRef,
+    TReadonlyRef,
     is_ref,
     ref_computed,
     to_ref,
     _TMaybeRef as TMaybeRef,
     to_value,
     to_raw,
-    on,
     RefWrapper,
 )
 from nicegui import ui
@@ -66,7 +68,7 @@ class TableBindableUi(BindableUi[ui.table]):
 
         self._arg_selection = selection
         self._arg_row_key = row_key
-        self._selection_ref: ReadonlyRef[List[Any]] = to_ref([])  # type: ignore
+        self._selection_ref: TReadonlyRef[List[Any]] = to_ref([])  # type: ignore
 
         def on_selection(_):
             self._selection_ref.value = self.element.selected  # type: ignore
@@ -143,7 +145,7 @@ class TableBindableUi(BindableUi[ui.table]):
         ]
         return cls(cols, rows, **other_kws)
 
-    def bind_prop(self, prop: str, ref_ui: ReadonlyRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "dataframe":
             return self.bind_dataframe(ref_ui)
 
@@ -155,7 +157,7 @@ class TableBindableUi(BindableUi[ui.table]):
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_dataframe(self, ref_df: ReadonlyRef):
+    def bind_dataframe(self, ref_df: TGetterOrReadonlyRef):
         @ref_computed
         def cp_converted_df():
             df = ref_df.value
@@ -180,8 +182,8 @@ class TableBindableUi(BindableUi[ui.table]):
 
         return self
 
-    def bind_rows(self, ref_ui: ReadonlyRef[List[Dict]]):
-        @on(ref_ui, deep=True)
+    def bind_rows(self, ref_ui: TGetterOrReadonlyRef[List[Dict]]):
+        @self._ui_signal_on(ref_ui, deep=True)
         def _():
             ele = self.element
             ele._props["rows"] = list(to_raw(to_value(ref_ui)))
@@ -189,8 +191,8 @@ class TableBindableUi(BindableUi[ui.table]):
 
         return self
 
-    def bind_columns(self, ref_ui: ReadonlyRef[List[Dict]]):
-        @on(ref_ui, deep=True)
+    def bind_columns(self, ref_ui: TGetterOrReadonlyRef[List[Dict]]):
+        @self._ui_signal_on(ref_ui, deep=True)
         def _():
             ele = self.element
             ele._props["columns"] = list(to_raw(to_value(ref_ui)))

ex4nicegui/reactive/officials/tabs.py

@@ -1,6 +1,7 @@
 from typing import Any, Callable, Optional
-from ex4nicegui.reactive.utils import ParameterClassifier
+from ex4nicegui.reactive.services.reactive_service import ParameterClassifier
 from ex4nicegui.utils.signals import (
+    TGetterOrReadonlyRef,
     to_value,
     _TMaybeRef as TMaybeRef,
 )
@@ -31,13 +32,13 @@ class TabsBindableUi(BindableUi[ui.tabs]):
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: TMaybeRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "value":
             return self.bind_value(ref_ui)
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_value(self, ref_ui: TMaybeRef):
+    def bind_value(self, ref_ui: TGetterOrReadonlyRef):
         @self._ui_effect
         def _():
             self.element.set_value(to_value(ref_ui))

ex4nicegui/reactive/officials/textarea.py

@@ -5,13 +5,11 @@ from typing import (
     Dict,
     cast,
 )
-from ex4nicegui.reactive.utils import ParameterClassifier
-from ex4nicegui.utils.apiEffect import ui_effect
+from ex4nicegui.reactive.services.reactive_service import ParameterClassifier
 from ex4nicegui.utils.signals import (
-    ReadonlyRef,
+    TGetterOrReadonlyRef,
     Ref,
     _TMaybeRef as TMaybeRef,
-    effect,
     is_setter_ref,
     to_value,
 )
@@ -54,14 +52,14 @@ class TextareaBindableUi(BindableUi[ui.textarea]):
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: ReadonlyRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "value":
             return self.bind_value(ref_ui)
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_value(self, ref_ui: ReadonlyRef[str]):
-        @ui_effect
+    def bind_value(self, ref_ui: TGetterOrReadonlyRef[str]):
+        @self._ui_effect
         def _():
             self.element.set_value(to_value(ref_ui))
 
@@ -95,7 +93,7 @@ class LazyTextareaBindableUi(TextareaBindableUi):
             ref = cast(Ref, org_value)
             ele = self.element
 
-            @effect
+            @self._ui_effect
             def _():
                 ele.value = ref.value
 

ex4nicegui/reactive/officials/upload.py

@@ -11,7 +11,7 @@ from ex4nicegui.utils.signals import (
 from nicegui import ui
 from nicegui.events import handle_event
 from .base import BindableUi
-from .utils import _convert_kws_ref2value
+from ex4nicegui.reactive.systems.reactive_system import convert_kws_ref2value
 
 
 class UploadResult:
@@ -57,7 +57,7 @@ class UploadBindableUi(BindableUi[ui.upload]):
             "auto_upload": auto_upload,
         }
 
-        value_kws = _convert_kws_ref2value(kws)
+        value_kws = convert_kws_ref2value(kws)
 
         self._on_upload_callbacks = []
 

ex4nicegui/reactive/q_pagination.py

@@ -1,8 +1,9 @@
 from typing import Any, Optional, Callable
-from ex4nicegui.reactive.utils import ParameterClassifier
+from ex4nicegui.reactive.services.reactive_service import ParameterClassifier
 from ex4nicegui.utils.signals import (
+    TGetterOrReadonlyRef,
     to_value,
-    _TMaybeRef as TMaybeRef,
+    TMaybeRef,
 )
 from nicegui import ui
 from ex4nicegui.reactive.officials.base import BindableUi
@@ -35,13 +36,13 @@ class PaginationBindableUi(BindableUi[ui.pagination]):
     def value(self):
         return self.element.value
 
-    def bind_prop(self, prop: str, ref_ui: TMaybeRef):
+    def bind_prop(self, prop: str, ref_ui: TGetterOrReadonlyRef):
         if prop == "value":
             return self.bind_value(ref_ui)
 
         return super().bind_prop(prop, ref_ui)
 
-    def bind_value(self, ref_ui: TMaybeRef[int]):
+    def bind_value(self, ref_ui: TGetterOrReadonlyRef[int]):
         @self._ui_effect
         def _():
             self.element.set_value(to_value(ref_ui))

ex4nicegui/reactive/scopedStyle.js

@@ -0,0 +1,55 @@
+
+const REGEX_NEWLINE = /[\r\n]/g;
+const REGEX_START_SPACES = /^\s+/gm;
+
+function getClasses(id) {
+    return `ex4ng-scoped-style-${id}`;
+}
+
+function removeInvalidChars(str) {
+    str = str.replace(REGEX_START_SPACES, '');
+    return str.replace(REGEX_NEWLINE, '');
+}
+
+function appendCSS(styleElement, cssText) {
+    // 获取已有的 CSS 内容
+    let existingCSS = styleElement.textContent || '';
+
+    // 如果已有的 CSS 内容不为空，添加一个空行作为分隔符
+    if (existingCSS.trim() !== '') {
+        existingCSS += '\n';
+    }
+
+    // 拼接新的 CSS 内容
+    existingCSS += cssText;
+
+    // 将新的 CSS 内容设置回 style 标签
+    styleElement.textContent = existingCSS;
+}
+
+export default {
+    template: `<template></template>`,
+    methods: {
+        createStyle(id, css) {
+            css = removeInvalidChars(css);
+
+            const classes = getClasses(id);
+            const target = document.querySelector(`style.${classes}`);
+            if (target) {
+                appendCSS(target, css);
+            } else {
+                const style = document.createElement('style');
+                style.classList.add(classes);
+                style.innerHTML = css;
+                document.head.appendChild(style);
+            }
+        },
+        removeStyle(id) {
+            const classes = getClasses(id);
+            const target = document.querySelector(`style.${classes}`);
+            if (target) {
+                target.remove();
+            }
+        },
+    },
+};

ex4nicegui/reactive/scopedStyle.py

@@ -0,0 +1,22 @@
+from nicegui.element import Element
+from ex4nicegui.helper import client_instance_locker
+
+
+class ScopedStyle(Element, component="scopedStyle.js"):
+    pass
+
+    @staticmethod
+    def get():
+        return _scoped_style_factory.get_object()
+
+    def create_style(self, element: Element, css: str):
+        element_id = f"c{element.id}"
+
+        self.run_method("createStyle", element_id, css)
+
+    def remove_style(self, element: Element):
+        element_id = f"c{element.id}"
+        self.run_method("removeStyle", element_id)
+
+
+_scoped_style_factory = client_instance_locker.ClientInstanceLocker(ScopedStyle)

ex4nicegui/reactive/services/color_service.py

@@ -0,0 +1,56 @@
+from __future__ import annotations
+from typing import TYPE_CHECKING, Literal, cast
+from ex4nicegui.utils.signals import to_value
+from nicegui.elements.mixins.color_elements import (
+    TextColorElement,
+    QUASAR_COLORS,
+    TAILWIND_COLORS,
+)
+
+if TYPE_CHECKING:
+    from ex4nicegui.reactive.officials.base import BindableUi
+    from ex4nicegui import TGetterOrReadonlyRef
+
+
+_color_sys_type = Literal["QUASAR", "TAILWIND", "STYLE"]
+_color_attr_name = "data-ex4ng-color"
+
+
+def bind_color(bindable_ui: BindableUi, ref_ui: TGetterOrReadonlyRef):
+    @bindable_ui._ui_effect
+    def _():
+        ele = cast(TextColorElement, bindable_ui.element)
+        color = to_value(ref_ui)
+
+        # get exists color
+        # e.g 'QUASAR:red'
+        pre_color = ele._props.get(_color_attr_name)  # type: str | None
+        if pre_color:
+            color_sys, value = pre_color.split(":")  # type: ignore
+            color_sys: _color_sys_type
+
+            if color_sys == "QUASAR":
+                del ele._props[ele.TEXT_COLOR_PROP]
+            elif color_sys == "TAILWIND":
+                ele.classes(remove=value)
+            else:
+                del ele._style["color"]
+
+        cur_sys: _color_sys_type = "STYLE"
+        cur_color = color
+
+        if color in QUASAR_COLORS:
+            ele._props[ele.TEXT_COLOR_PROP] = color
+            cur_sys = "QUASAR"
+        elif color in TAILWIND_COLORS:
+            cur_color = f"text-{color}"
+            ele.classes(replace=cur_color)
+            cur_sys = "TAILWIND"
+        elif color is not None:
+            ele._style["color"] = color
+
+        ele._props[_color_attr_name] = f"{cur_sys}:{color}"
+
+        ele.update()
+
+    return bindable_ui

ex4nicegui/reactive/services/pandas_service.py

@@ -0,0 +1,31 @@
+try:
+    import pandas as pd
+except ImportError:
+    pass
+
+
+def dataframe2col_str(df, copy=True):
+    if isinstance(df.columns, pd.MultiIndex):
+        raise ValueError(
+            "MultiIndex columns are not supported. "
+            "You can convert them to strings using something like "
+            '`df.columns = ["_".join(col) for col in df.columns.values]`.'
+        )
+
+    date_cols = df.columns[df.dtypes == "datetime64[ns]"]
+    time_cols = df.columns[df.dtypes == "timedelta64[ns]"]
+    complex_cols = df.columns[df.dtypes == "complex128"]
+    period_cols = df.columns[df.dtypes == "period[M]"]
+    if (
+        len(date_cols) != 0
+        or len(time_cols) != 0
+        or len(complex_cols) != 0
+        or len(period_cols) != 0
+    ):
+        df = df.copy() if copy else df
+        df[date_cols] = df[date_cols].astype(str)
+        df[time_cols] = df[time_cols].astype(str)
+        df[complex_cols] = df[complex_cols].astype(str)
+        df[period_cols] = df[period_cols].astype(str)
+
+    return df