v0.4.6 Pre-release Thread

[masenf]

Try out the Prerelease

Please report any problems you encounter in this discussion thread or as separate issues on reflex-dev/reflex.

pip install 'reflex~=0.4.6a'

Schedule

2024-03-29 10:00 PDT: 0.4.6a1 is released for general testing
2024-04-01 11:35 PDT: 0.4.6a2 is published with minor fixes
2024-04-01 12:08 PDT 0.4.6a3 is published with typer re-relaxed
2024-04-01 16:00 PDT: 0.4.6a4 is published, removing add_importsAPI and types-tabulate package
2024-04-01 16:45 PDT: General availability of 0.4.6 (No Joke 😁)

Release Notes

Breaking Changes

Use dill instead of cloudpickle

In reflex-0.4.6, existing states persisted in redis are not compatible. Redis should be cleared and existing states/sessions discarded after upgrading.

• [REF-2089] Use dill instead of cloudpickle for serialization by @masenf in [REF-2089] Use dill instead of cloudpickle for serialization #2922

New Features

reflex component share CLI

Simplify sharing of custom 3rd party components to the Reflex Component Gallery.

• [REF-2168] Add share options to custom component commands by @martinxu9 in [REF-2168] Add share options to custom component commands #2883

rx.ComponentState

An easy way to define per-component State.

import reflex as rx

class CounterButton(rx.ComponentState):
    count: int

    def increment(self):
        self.count += 1

    def decrement(self):
        self.count -= 1

    @classmethod
    def get_component(cls, *children, **props):
        return rx.button(
            f"Counter {cls.count}",
            on_click=cls.increment,
            on_context_menu=cls.decrement.prevent_default,
        )

counter_button = CounterButton.create

@rx.page()
def index():
    return rx.vstack(
        *[counter_button() for _ in range(10)]
    )

app = rx.App()

• [REF-2265] ComponentState: scaffold for copying State per Component instance by @masenf in [REF-2265] ComponentState: scaffold for copying State per Component instance #2923

Automatically Select Next Available Port

When the configured port is not available, automatically select the next sequential port until one is available

• added feature to automatically change port by @wassafshahzad in added feature to automatically change port #2867

Expanding Textarea

New props on rx.el.textarea and rx.text_area allow the field to expand to match content and submit the form when Enter is pressed (shift+enter to create a new line)

• textarea: expose auto_height and enter_key_submit props by @masenf in textarea: expose auto_height and enter_key_submit props #2884

rx.scroll_to event

Scroll the viewpoint to show a given element by ID.

• Scroll to feature by @Yummy-Yums in Scroll to feature #2948

Improvements

Simplify Component Wrapping API

[REF-2269] Add add_imports API for component class by @martinxu9 in #2937

The add_imports API allows a component to specify additional imports to include without overriding default import tracking behavior from the specified library and lib_dependencies fields.

[REF-2272] Support declaring EventHandlers directly in component by @martinxu9 in #2952

Props typed as rx.EventHandler can be used to define event triggers without overriding get_event_triggers method. The argument of the type specifies the JS to Python mapping: on_click: rx.EventTrigger[lambda e: [e]].

generate pyi files when building/publishing 3rd party component by @Lendemor in #2945

Third-party components will now have .pyi files generated for them to improve IDE completion, similar to the built in Reflex components.

Updated Lucide Icons

The latest icons available on https://lucide.dev are now usable in Reflex. Some icon names have changed, these will print a deprecation warning pointing to the new name. The old names will be removed in 0.5.0.

• Update LUCIDE_ICON_LIST with newest Icon names by @luccavp12 in Update LUCIDE_ICON_LIST with newest Icon names #2891

Loosen Requirement Pins

Reflex is now compatible with a wider range of dependencies. Notably, it can be used with packages that depend on Pydantic v2 (although the framework itself is still using v1).

• [REF-2127] Loosen requirements by @mahrz24 in [REF-2127] Loosen requirements #2796

Avoid content flicker when using State.is_hydrated

is_hydrated is set to False immediately when a navigation event starts, and is set back to True after all on_load events have executed. This avoids content flickering into view before a loading spinner is displayed when the spinner is conditional on the value of State.is_hydrated.

Additionally, the WiFi off connection error pulser is only displayed when connection errors are detected (before it was displayed whenever the page was not hydrated).

• Set is_hydrated=False at route onChangeStart by @masenf in Set is_hydrated=False at route onChangeStart #2949

Miscellaneous

• [REF-1982] state: Warn if redis state is "too big" by @masenf in [REF-1982] state: Warn if redis state is "too big" #2868
• use radix box instead of chakra one for responsive elements by @Lendemor in use radix box instead of chakra one for responsive elements #2921
• [REF-2229]Dedupe deprecation warnings by @ElijahAhianyo in [REF-2229]Dedupe deprecation warnings #2871
• fix hook order to use ref inside user hooks by @Lendemor in fix hook order to use ref inside user hooks #2906
  • Ensure user-defined hooks can always access refs
• [REF-2302] When a Var points to a model, prefer access to model fields. by @masenf in [REF-2302] When a Var points to a model, prefer access to model fields. #2893

Bug Fixes

• [REF-2117]:rx.color_mode_cond to work in f-strings by @ElijahAhianyo in [REF-2117]:rx.color_mode_cond to work in f-strings #2775
• Default to None if bun/fnm version is Invalid by @ElijahAhianyo in Default to None if bun/fnm version is Invalid #2940
• remove inheritance from Flex for list components by @Lendemor in remove inheritance from Flex for list components #2936
  • Fix markdown rendering of lists
• parse_args_spec: resolve annotations with typing.get_type_hints by @masenf in parse_args_spec: resolve annotations with typing.get_type_hints #2849
• [REF-2219] Avoid refetching states that are already cached by @masenf in [REF-2219] Avoid refetching states that are already cached #2953
  • Fix issue affecting Cookie/LocalStorage values when substates contained computed vars
• [REF-2306] Include twine in dependencies on pyproject.toml by @martinxu9 in [REF-2306] Include twine in dependencies on pyproject.toml #2895

Other Changes

• Fix Handle quote marks ' " in PR titles in benchmark CI #2877, PR title not available for push/PR merge by @martinxu9 in Fix #2877, PR title not available for push/PR merge #2889
• [REF-2284]Benchmark add extra info on publishing data by @ElijahAhianyo in [REF-2284]Benchmark add extra info on publishing data #2864
• Revert "add precommit check added large files and git lfs rules (add precommit check added large files and git lfs rules #2866)" by @picklelo in Revert "add precommit check added large files and git lfs rules (#2866)" #2905
• [REF-1682][REF-1683][REF-1684][REF-2283]Benchmark reflex package size and .web folder by @ElijahAhianyo in [REF-1682][REF-1683][REF-1684][REF-2283]Benchmark reflex package size and .web folder #2880
• fix AppHarness reloading by @benedikt-bartscher in fix AppHarness reloading #2916
• Remove page.pyi: it's out of date, and not necessary by @masenf in Remove page.pyi: it's out of date, and not necessary #2924
• [REF-2416] Pass shell=True when starting AppHarness on Windows by @masenf in [REF-2416] Pass shell=True when starting AppHarness on Windows #2944
• updated watchdog dep by @Yummy-Yums in updated watchdog dep #2946
• Update README.md by @ChicIceCream in Update README.md #2963

New Contributors

• @luccavp12 made their first contribution in Update LUCIDE_ICON_LIST with newest Icon names #2891
• @mahrz24 made their first contribution in [REF-2127] Loosen requirements #2796
• @ChicIceCream made their first contribution in Update README.md #2963

Full Changelog: v0.4.5...reflex-0.4.6