12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927 |
- from __future__ import annotations
- import asyncio
- import copy
- import datetime
- import functools
- import json
- import os
- import sys
- from typing import Any, Dict, Generator, List, Optional, Union
- from unittest.mock import AsyncMock, Mock
- import pytest
- from plotly.graph_objects import Figure
- import reflex as rx
- from reflex.app import App
- from reflex.base import Base
- from reflex.constants import CompileVars, RouteVar, SocketEvent
- from reflex.event import Event, EventHandler
- from reflex.state import (
- BaseState,
- ImmutableStateError,
- LockExpiredError,
- MutableProxy,
- OnLoadInternalState,
- RouterData,
- State,
- StateManager,
- StateManagerMemory,
- StateManagerRedis,
- StateProxy,
- StateUpdate,
- _substate_key,
- )
- from reflex.utils import format, prerequisites, types
- from reflex.utils.format import json_dumps
- from reflex.vars import BaseVar, ComputedVar
- from .states import GenState
- CI = bool(os.environ.get("CI", False))
- LOCK_EXPIRATION = 2000 if CI else 300
- LOCK_EXPIRE_SLEEP = 2.5 if CI else 0.4
- formatted_router = {
- "session": {"client_token": "", "client_ip": "", "session_id": ""},
- "headers": {
- "host": "",
- "origin": "",
- "upgrade": "",
- "connection": "",
- "pragma": "",
- "cache_control": "",
- "user_agent": "",
- "sec_websocket_version": "",
- "sec_websocket_key": "",
- "sec_websocket_extensions": "",
- "accept_encoding": "",
- "accept_language": "",
- },
- "page": {
- "host": "",
- "path": "",
- "raw_path": "",
- "full_path": "",
- "full_raw_path": "",
- "params": {},
- },
- }
- class Object(Base):
- """A test object fixture."""
- prop1: int = 42
- prop2: str = "hello"
- class TestState(BaseState):
- """A test state."""
- # Set this class as not test one
- __test__ = False
- num1: int
- num2: float = 3.14
- key: str
- map_key: str = "a"
- array: List[float] = [1, 2, 3.14]
- mapping: Dict[str, List[int]] = {"a": [1, 2, 3], "b": [4, 5, 6]}
- obj: Object = Object()
- complex: Dict[int, Object] = {1: Object(), 2: Object()}
- fig: Figure = Figure()
- dt: datetime.datetime = datetime.datetime.fromisoformat("1989-11-09T18:53:00+01:00")
- @ComputedVar
- def sum(self) -> float:
- """Dynamically sum the numbers.
- Returns:
- The sum of the numbers.
- """
- return self.num1 + self.num2
- @ComputedVar
- def upper(self) -> str:
- """Uppercase the key.
- Returns:
- The uppercased key.
- """
- return self.key.upper()
- def do_something(self):
- """Do something."""
- pass
- class ChildState(TestState):
- """A child state fixture."""
- value: str
- count: int = 23
- def change_both(self, value: str, count: int):
- """Change both the value and count.
- Args:
- value: The new value.
- count: The new count.
- """
- self.value = value.upper()
- self.count = count * 2
- class ChildState2(TestState):
- """A child state fixture."""
- value: str
- class ChildState3(TestState):
- """A child state fixture."""
- value: str
- class GrandchildState(ChildState):
- """A grandchild state fixture."""
- value2: str
- def do_nothing(self):
- """Do something."""
- pass
- class GrandchildState2(ChildState2):
- """A grandchild state fixture."""
- @rx.cached_var
- def cached(self) -> str:
- """A cached var.
- Returns:
- The value.
- """
- return self.value
- class GrandchildState3(ChildState3):
- """A great grandchild state fixture."""
- @rx.var
- def computed(self) -> str:
- """A computed var.
- Returns:
- The value.
- """
- return self.value
- class DateTimeState(BaseState):
- """A State with some datetime fields."""
- d: datetime.date = datetime.date.fromisoformat("1989-11-09")
- dt: datetime.datetime = datetime.datetime.fromisoformat("1989-11-09T18:53:00+01:00")
- t: datetime.time = datetime.time.fromisoformat("18:53:00+01:00")
- td: datetime.timedelta = datetime.timedelta(days=11, minutes=11)
- @pytest.fixture
- def test_state() -> TestState:
- """A state.
- Returns:
- A test state.
- """
- return TestState() # type: ignore
- @pytest.fixture
- def child_state(test_state) -> ChildState:
- """A child state.
- Args:
- test_state: A test state.
- Returns:
- A test child state.
- """
- child_state = test_state.get_substate(["child_state"])
- assert child_state is not None
- return child_state
- @pytest.fixture
- def child_state2(test_state) -> ChildState2:
- """A second child state.
- Args:
- test_state: A test state.
- Returns:
- A second test child state.
- """
- child_state2 = test_state.get_substate(["child_state2"])
- assert child_state2 is not None
- return child_state2
- @pytest.fixture
- def grandchild_state(child_state) -> GrandchildState:
- """A state.
- Args:
- child_state: A child state.
- Returns:
- A test state.
- """
- grandchild_state = child_state.get_substate(["grandchild_state"])
- assert grandchild_state is not None
- return grandchild_state
- def test_base_class_vars(test_state):
- """Test that the class vars are set correctly.
- Args:
- test_state: A state.
- """
- fields = test_state.get_fields()
- cls = type(test_state)
- for field in fields:
- if field in test_state.get_skip_vars():
- continue
- prop = getattr(cls, field)
- assert isinstance(prop, BaseVar)
- assert prop._var_name == field
- assert cls.num1._var_type == int
- assert cls.num2._var_type == float
- assert cls.key._var_type == str
- def test_computed_class_var(test_state):
- """Test that the class computed vars are set correctly.
- Args:
- test_state: A state.
- """
- cls = type(test_state)
- vars = [(prop._var_name, prop._var_type) for prop in cls.computed_vars.values()]
- assert ("sum", float) in vars
- assert ("upper", str) in vars
- def test_class_vars(test_state):
- """Test that the class vars are set correctly.
- Args:
- test_state: A state.
- """
- cls = type(test_state)
- assert cls.vars.keys() == {
- "router",
- "num1",
- "num2",
- "key",
- "map_key",
- "array",
- "mapping",
- "obj",
- "complex",
- "sum",
- "upper",
- "fig",
- "dt",
- }
- def test_event_handlers(test_state):
- """Test that event handler is set correctly.
- Args:
- test_state: A state.
- """
- expected_keys = (
- "do_something",
- "set_array",
- "set_complex",
- "set_fig",
- "set_key",
- "set_mapping",
- "set_num1",
- "set_num2",
- "set_obj",
- )
- cls = type(test_state)
- assert all(key in cls.event_handlers for key in expected_keys)
- def test_default_value(test_state):
- """Test that the default value of a var is correct.
- Args:
- test_state: A state.
- """
- assert test_state.num1 == 0
- assert test_state.num2 == 3.14
- assert test_state.key == ""
- assert test_state.sum == 3.14
- assert test_state.upper == ""
- def test_computed_vars(test_state):
- """Test that the computed var is computed correctly.
- Args:
- test_state: A state.
- """
- test_state.num1 = 1
- test_state.num2 = 4
- assert test_state.sum == 5
- test_state.key = "hello world"
- assert test_state.upper == "HELLO WORLD"
- def test_dict(test_state):
- """Test that the dict representation of a state is correct.
- Args:
- test_state: A state.
- """
- substates = {
- "test_state",
- "test_state.child_state",
- "test_state.child_state.grandchild_state",
- "test_state.child_state2",
- "test_state.child_state2.grandchild_state2",
- "test_state.child_state3",
- "test_state.child_state3.grandchild_state3",
- }
- test_state_dict = test_state.dict()
- assert set(test_state_dict) == substates
- assert set(test_state_dict[test_state.get_name()]) == set(test_state.vars)
- assert set(test_state.dict(include_computed=False)[test_state.get_name()]) == set(
- test_state.base_vars
- )
- def test_default_setters(test_state):
- """Test that we can set default values.
- Args:
- test_state: A state.
- """
- for prop_name in test_state.base_vars:
- # Each base var should have a default setter.
- assert hasattr(test_state, f"set_{prop_name}")
- def test_class_indexing_with_vars():
- """Test that we can index into a state var with another var."""
- prop = TestState.array[TestState.num1]
- assert str(prop) == "{test_state.array.at(test_state.num1)}"
- prop = TestState.mapping["a"][TestState.num1]
- assert str(prop) == '{test_state.mapping["a"].at(test_state.num1)}'
- prop = TestState.mapping[TestState.map_key]
- assert str(prop) == "{test_state.mapping[test_state.map_key]}"
- def test_class_attributes():
- """Test that we can get class attributes."""
- prop = TestState.obj.prop1
- assert str(prop) == "{test_state.obj.prop1}"
- prop = TestState.complex[1].prop1
- assert str(prop) == "{test_state.complex[1].prop1}"
- def test_get_parent_state():
- """Test getting the parent state."""
- assert TestState.get_parent_state() is None
- assert ChildState.get_parent_state() == TestState
- assert ChildState2.get_parent_state() == TestState
- assert GrandchildState.get_parent_state() == ChildState
- def test_get_substates():
- """Test getting the substates."""
- assert TestState.get_substates() == {ChildState, ChildState2, ChildState3}
- assert ChildState.get_substates() == {GrandchildState}
- assert ChildState2.get_substates() == {GrandchildState2}
- assert GrandchildState.get_substates() == set()
- assert GrandchildState2.get_substates() == set()
- def test_get_name():
- """Test getting the name of a state."""
- assert TestState.get_name() == "test_state"
- assert ChildState.get_name() == "child_state"
- assert ChildState2.get_name() == "child_state2"
- assert GrandchildState.get_name() == "grandchild_state"
- def test_get_full_name():
- """Test getting the full name."""
- assert TestState.get_full_name() == "test_state"
- assert ChildState.get_full_name() == "test_state.child_state"
- assert ChildState2.get_full_name() == "test_state.child_state2"
- assert GrandchildState.get_full_name() == "test_state.child_state.grandchild_state"
- def test_get_class_substate():
- """Test getting the substate of a class."""
- assert TestState.get_class_substate(("child_state",)) == ChildState
- assert TestState.get_class_substate(("child_state2",)) == ChildState2
- assert ChildState.get_class_substate(("grandchild_state",)) == GrandchildState
- assert (
- TestState.get_class_substate(("child_state", "grandchild_state"))
- == GrandchildState
- )
- with pytest.raises(ValueError):
- TestState.get_class_substate(("invalid_child",))
- with pytest.raises(ValueError):
- TestState.get_class_substate(
- (
- "child_state",
- "invalid_child",
- )
- )
- def test_get_class_var():
- """Test getting the var of a class."""
- assert TestState.get_class_var(("num1",)).equals(TestState.num1)
- assert TestState.get_class_var(("num2",)).equals(TestState.num2)
- assert ChildState.get_class_var(("value",)).equals(ChildState.value)
- assert GrandchildState.get_class_var(("value2",)).equals(GrandchildState.value2)
- assert TestState.get_class_var(("child_state", "value")).equals(ChildState.value)
- assert TestState.get_class_var(
- ("child_state", "grandchild_state", "value2")
- ).equals(
- GrandchildState.value2,
- )
- assert ChildState.get_class_var(("grandchild_state", "value2")).equals(
- GrandchildState.value2,
- )
- with pytest.raises(ValueError):
- TestState.get_class_var(("invalid_var",))
- with pytest.raises(ValueError):
- TestState.get_class_var(
- (
- "child_state",
- "invalid_var",
- )
- )
- def test_set_class_var():
- """Test setting the var of a class."""
- with pytest.raises(AttributeError):
- TestState.num3 # type: ignore
- TestState._set_var(
- BaseVar(_var_name="num3", _var_type=int)._var_set_state(TestState)
- )
- var = TestState.num3 # type: ignore
- assert var._var_name == "num3"
- assert var._var_type == int
- assert var._var_state == TestState.get_full_name()
- def test_set_parent_and_substates(test_state, child_state, grandchild_state):
- """Test setting the parent and substates.
- Args:
- test_state: A state.
- child_state: A child state.
- grandchild_state: A grandchild state.
- """
- assert len(test_state.substates) == 3
- assert set(test_state.substates) == {"child_state", "child_state2", "child_state3"}
- assert child_state.parent_state == test_state
- assert len(child_state.substates) == 1
- assert set(child_state.substates) == {"grandchild_state"}
- assert grandchild_state.parent_state == child_state
- assert len(grandchild_state.substates) == 0
- def test_get_child_attribute(test_state, child_state, child_state2, grandchild_state):
- """Test getting the attribute of a state.
- Args:
- test_state: A state.
- child_state: A child state.
- child_state2: A child state.
- grandchild_state: A grandchild state.
- """
- assert test_state.num1 == 0
- assert child_state.value == ""
- assert child_state2.value == ""
- assert child_state.count == 23
- assert grandchild_state.value2 == ""
- with pytest.raises(AttributeError):
- test_state.invalid
- with pytest.raises(AttributeError):
- test_state.child_state.invalid
- with pytest.raises(AttributeError):
- test_state.child_state.grandchild_state.invalid
- def test_set_child_attribute(test_state, child_state, grandchild_state):
- """Test setting the attribute of a state.
- Args:
- test_state: A state.
- child_state: A child state.
- grandchild_state: A grandchild state.
- """
- test_state.num1 = 10
- assert test_state.num1 == 10
- assert child_state.num1 == 10
- assert grandchild_state.num1 == 10
- grandchild_state.num1 = 5
- assert test_state.num1 == 5
- assert child_state.num1 == 5
- assert grandchild_state.num1 == 5
- child_state.value = "test"
- assert child_state.value == "test"
- assert grandchild_state.value == "test"
- grandchild_state.value = "test2"
- assert child_state.value == "test2"
- assert grandchild_state.value == "test2"
- grandchild_state.value2 = "test3"
- assert grandchild_state.value2 == "test3"
- def test_get_substate(test_state, child_state, child_state2, grandchild_state):
- """Test getting the substate of a state.
- Args:
- test_state: A state.
- child_state: A child state.
- child_state2: A child state.
- grandchild_state: A grandchild state.
- """
- assert test_state.get_substate(("child_state",)) == child_state
- assert test_state.get_substate(("child_state2",)) == child_state2
- assert (
- test_state.get_substate(("child_state", "grandchild_state")) == grandchild_state
- )
- assert child_state.get_substate(("grandchild_state",)) == grandchild_state
- with pytest.raises(ValueError):
- test_state.get_substate(("invalid",))
- with pytest.raises(ValueError):
- test_state.get_substate(("child_state", "invalid"))
- with pytest.raises(ValueError):
- test_state.get_substate(("child_state", "grandchild_state", "invalid"))
- def test_set_dirty_var(test_state):
- """Test changing state vars marks the value as dirty.
- Args:
- test_state: A state.
- """
- # Initially there should be no dirty vars.
- assert test_state.dirty_vars == set()
- # Setting a var should mark it as dirty.
- test_state.num1 = 1
- assert test_state.dirty_vars == {"num1", "sum"}
- # Setting another var should mark it as dirty.
- test_state.num2 = 2
- assert test_state.dirty_vars == {"num1", "num2", "sum"}
- # Cleaning the state should remove all dirty vars.
- test_state._clean()
- assert test_state.dirty_vars == set()
- def test_set_dirty_substate(test_state, child_state, child_state2, grandchild_state):
- """Test changing substate vars marks the value as dirty.
- Args:
- test_state: A state.
- child_state: A child state.
- child_state2: A child state.
- grandchild_state: A grandchild state.
- """
- # Initially there should be no dirty vars.
- assert test_state.dirty_vars == set()
- assert child_state.dirty_vars == set()
- assert child_state2.dirty_vars == set()
- assert grandchild_state.dirty_vars == set()
- # Setting a var should mark it as dirty.
- child_state.value = "test"
- assert child_state.dirty_vars == {"value"}
- assert test_state.dirty_substates == {"child_state"}
- assert child_state.dirty_substates == set()
- # Cleaning the parent state should remove the dirty substate.
- test_state._clean()
- assert test_state.dirty_substates == set()
- assert child_state.dirty_vars == set()
- # Setting a var on the grandchild should bubble up.
- grandchild_state.value2 = "test2"
- assert child_state.dirty_substates == {"grandchild_state"}
- assert test_state.dirty_substates == {"child_state"}
- # Cleaning the middle state should keep the parent state dirty.
- child_state._clean()
- assert test_state.dirty_substates == {"child_state"}
- assert child_state.dirty_substates == set()
- assert grandchild_state.dirty_vars == set()
- def test_reset(test_state, child_state):
- """Test resetting the state.
- Args:
- test_state: A state.
- child_state: A child state.
- """
- # Set some values.
- test_state.num1 = 1
- test_state.num2 = 2
- child_state.value = "test"
- # Reset the state.
- test_state.reset()
- # The values should be reset.
- assert test_state.num1 == 0
- assert test_state.num2 == 3.14
- assert child_state.value == ""
- expected_dirty_vars = {
- "num1",
- "num2",
- "obj",
- "upper",
- "complex",
- "fig",
- "key",
- "sum",
- "array",
- "map_key",
- "mapping",
- "dt",
- }
- # The dirty vars should be reset.
- assert test_state.dirty_vars == expected_dirty_vars
- assert child_state.dirty_vars == {"count", "value"}
- # The dirty substates should be reset.
- assert test_state.dirty_substates == {"child_state", "child_state2", "child_state3"}
- @pytest.mark.asyncio
- async def test_process_event_simple(test_state):
- """Test processing an event.
- Args:
- test_state: A state.
- """
- assert test_state.num1 == 0
- event = Event(token="t", name="set_num1", payload={"value": 69})
- update = await test_state._process(event).__anext__()
- # The event should update the value.
- assert test_state.num1 == 69
- # The delta should contain the changes, including computed vars.
- # assert update.delta == {"test_state": {"num1": 69, "sum": 72.14}}
- assert update.delta == {
- "test_state": {"num1": 69, "sum": 72.14, "upper": ""},
- "test_state.child_state3.grandchild_state3": {"computed": ""},
- }
- assert update.events == []
- @pytest.mark.asyncio
- async def test_process_event_substate(test_state, child_state, grandchild_state):
- """Test processing an event on a substate.
- Args:
- test_state: A state.
- child_state: A child state.
- grandchild_state: A grandchild state.
- """
- # Events should bubble down to the substate.
- assert child_state.value == ""
- assert child_state.count == 23
- event = Event(
- token="t", name="child_state.change_both", payload={"value": "hi", "count": 12}
- )
- update = await test_state._process(event).__anext__()
- assert child_state.value == "HI"
- assert child_state.count == 24
- assert update.delta == {
- "test_state": {"sum": 3.14, "upper": ""},
- "test_state.child_state": {"value": "HI", "count": 24},
- "test_state.child_state3.grandchild_state3": {"computed": ""},
- }
- test_state._clean()
- # Test with the granchild state.
- assert grandchild_state.value2 == ""
- event = Event(
- token="t",
- name="child_state.grandchild_state.set_value2",
- payload={"value": "new"},
- )
- update = await test_state._process(event).__anext__()
- assert grandchild_state.value2 == "new"
- assert update.delta == {
- "test_state": {"sum": 3.14, "upper": ""},
- "test_state.child_state.grandchild_state": {"value2": "new"},
- "test_state.child_state3.grandchild_state3": {"computed": ""},
- }
- @pytest.mark.asyncio
- async def test_process_event_generator():
- """Test event handlers that generate multiple updates."""
- gen_state = GenState() # type: ignore
- event = Event(
- token="t",
- name="go",
- payload={"c": 5},
- )
- gen = gen_state._process(event)
- count = 0
- async for update in gen:
- count += 1
- if count == 6:
- assert update.delta == {}
- assert update.final
- else:
- assert gen_state.value == count
- assert update.delta == {
- "gen_state": {"value": count},
- }
- assert not update.final
- assert count == 6
- def test_get_client_token(test_state, router_data):
- """Test that the token obtained from the router_data is correct.
- Args:
- test_state: The test state.
- router_data: The router data fixture.
- """
- test_state.router = RouterData(router_data)
- assert (
- test_state.router.session.client_token == "b181904c-3953-4a79-dc18-ae9518c22f05"
- )
- def test_get_sid(test_state, router_data):
- """Test getting session id.
- Args:
- test_state: A state.
- router_data: The router data fixture.
- """
- test_state.router = RouterData(router_data)
- assert test_state.router.session.session_id == "9fpxSzPb9aFMb4wFAAAH"
- def test_get_headers(test_state, router_data, router_data_headers):
- """Test getting client headers.
- Args:
- test_state: A state.
- router_data: The router data fixture.
- router_data_headers: The expected headers.
- """
- test_state.router = RouterData(router_data)
- assert test_state.router.headers.dict() == {
- format.to_snake_case(k): v for k, v in router_data_headers.items()
- }
- def test_get_client_ip(test_state, router_data):
- """Test getting client IP.
- Args:
- test_state: A state.
- router_data: The router data fixture.
- """
- test_state.router = RouterData(router_data)
- assert test_state.router.session.client_ip == "127.0.0.1"
- def test_get_current_page(test_state):
- assert test_state.router.page.path == ""
- route = "mypage/subpage"
- test_state.router = RouterData({RouteVar.PATH: route})
- assert test_state.router.page.path == route
- def test_get_query_params(test_state):
- assert test_state.router.page.params == {}
- params = {"p1": "a", "p2": "b"}
- test_state.router = RouterData({RouteVar.QUERY: params})
- assert dict(test_state.router.page.params) == params
- def test_add_var():
- class DynamicState(BaseState):
- pass
- ds1 = DynamicState()
- assert "dynamic_int" not in ds1.__dict__
- assert not hasattr(ds1, "dynamic_int")
- ds1.add_var("dynamic_int", int, 42)
- # Existing instances get the BaseVar
- assert ds1.dynamic_int.equals(DynamicState.dynamic_int) # type: ignore
- # New instances get an actual value with the default
- assert DynamicState().dynamic_int == 42
- ds1.add_var("dynamic_list", List[int], [5, 10])
- assert ds1.dynamic_list.equals(DynamicState.dynamic_list) # type: ignore
- ds2 = DynamicState()
- assert ds2.dynamic_list == [5, 10]
- ds2.dynamic_list.append(15)
- assert ds2.dynamic_list == [5, 10, 15]
- assert DynamicState().dynamic_list == [5, 10]
- ds1.add_var("dynamic_dict", Dict[str, int], {"k1": 5, "k2": 10})
- assert ds1.dynamic_dict.equals(DynamicState.dynamic_dict) # type: ignore
- assert ds2.dynamic_dict.equals(DynamicState.dynamic_dict) # type: ignore
- assert DynamicState().dynamic_dict == {"k1": 5, "k2": 10}
- assert DynamicState().dynamic_dict == {"k1": 5, "k2": 10}
- def test_add_var_default_handlers(test_state):
- test_state.add_var("rand_int", int, 10)
- assert "set_rand_int" in test_state.event_handlers
- assert isinstance(test_state.event_handlers["set_rand_int"], EventHandler)
- class InterdependentState(BaseState):
- """A state with 3 vars and 3 computed vars.
- x: a variable that no computed var depends on
- v1: a varable that one computed var directly depeneds on
- _v2: a backend variable that one computed var directly depends on
- v1x2: a computed var that depends on v1
- v2x2: a computed var that depends on backend var _v2
- v1x2x2: a computed var that depends on computed var v1x2
- """
- x: int = 0
- v1: int = 0
- _v2: int = 1
- @rx.cached_var
- def v1x2(self) -> int:
- """Depends on var v1.
- Returns:
- Var v1 multiplied by 2
- """
- return self.v1 * 2
- @rx.cached_var
- def v2x2(self) -> int:
- """Depends on backend var _v2.
- Returns:
- backend var _v2 multiplied by 2
- """
- return self._v2 * 2
- @rx.cached_var
- def v1x2x2(self) -> int:
- """Depends on ComputedVar v1x2.
- Returns:
- ComputedVar v1x2 multiplied by 2
- """
- return self.v1x2 * 2 # type: ignore
- @rx.cached_var
- def _v3(self) -> int:
- """Depends on backend var _v2.
- Returns:
- The value of the backend variable.
- """
- return self._v2
- @rx.cached_var
- def v3x2(self) -> int:
- """Depends on ComputedVar _v3.
- Returns:
- ComputedVar _v3 multiplied by 2
- """
- return self._v3 * 2
- @pytest.fixture
- def interdependent_state() -> BaseState:
- """A state with varying dependency between vars.
- Returns:
- instance of InterdependentState
- """
- s = InterdependentState()
- s.dict() # prime initial relationships by accessing all ComputedVars
- return s
- def test_not_dirty_computed_var_from_var(interdependent_state):
- """Set Var that no ComputedVar depends on, expect no recalculation.
- Args:
- interdependent_state: A state with varying Var dependencies.
- """
- interdependent_state.x = 5
- assert interdependent_state.get_delta() == {
- interdependent_state.get_full_name(): {"x": 5},
- }
- def test_dirty_computed_var_from_var(interdependent_state):
- """Set Var that ComputedVar depends on, expect recalculation.
- The other ComputedVar depends on the changed ComputedVar and should also be
- recalculated. No other ComputedVars should be recalculated.
- Args:
- interdependent_state: A state with varying Var dependencies.
- """
- interdependent_state.v1 = 1
- assert interdependent_state.get_delta() == {
- interdependent_state.get_full_name(): {"v1": 1, "v1x2": 2, "v1x2x2": 4},
- }
- def test_dirty_computed_var_from_backend_var(interdependent_state):
- """Set backend var that ComputedVar depends on, expect recalculation.
- Args:
- interdependent_state: A state with varying Var dependencies.
- """
- interdependent_state._v2 = 2
- assert interdependent_state.get_delta() == {
- interdependent_state.get_full_name(): {"v2x2": 4, "v3x2": 4},
- }
- assert "_v3" in InterdependentState.backend_vars
- def test_per_state_backend_var(interdependent_state):
- """Set backend var on one instance, expect no affect in other instances.
- Args:
- interdependent_state: A state with varying Var dependencies.
- """
- s2 = InterdependentState()
- assert s2._v2 == interdependent_state._v2
- interdependent_state._v2 = 2
- assert s2._v2 != interdependent_state._v2
- s3 = InterdependentState()
- assert s3._v2 != interdependent_state._v2
- # both s2 and s3 should still have the default value
- assert s2._v2 == s3._v2
- # changing s2._v2 should not affect others
- s2._v2 = 4
- assert s2._v2 != interdependent_state._v2
- assert s2._v2 != s3._v2
- def test_child_state():
- """Test that the child state computed vars can reference parent state vars."""
- class MainState(BaseState):
- v: int = 2
- class ChildState(MainState):
- @ComputedVar
- def rendered_var(self):
- return self.v
- ms = MainState()
- cs = ms.substates[ChildState.get_name()]
- assert ms.v == 2
- assert cs.v == 2
- assert cs.rendered_var == 2
- def test_conditional_computed_vars():
- """Test that computed vars can have conditionals."""
- class MainState(BaseState):
- flag: bool = False
- t1: str = "a"
- t2: str = "b"
- @ComputedVar
- def rendered_var(self) -> str:
- if self.flag:
- return self.t1
- return self.t2
- ms = MainState()
- # Initially there are no dirty computed vars.
- assert ms._dirty_computed_vars(from_vars={"flag"}) == {"rendered_var"}
- assert ms._dirty_computed_vars(from_vars={"t2"}) == {"rendered_var"}
- assert ms._dirty_computed_vars(from_vars={"t1"}) == {"rendered_var"}
- assert ms.computed_vars["rendered_var"]._deps(objclass=MainState) == {
- "flag",
- "t1",
- "t2",
- }
- def test_event_handlers_convert_to_fns(test_state, child_state):
- """Test that when the state is initialized, event handlers are converted to fns.
- Args:
- test_state: A state with event handlers.
- child_state: A child state with event handlers.
- """
- # The class instances should be event handlers.
- assert isinstance(TestState.do_something, EventHandler)
- assert isinstance(ChildState.change_both, EventHandler)
- # The object instances should be fns.
- test_state.do_something()
- child_state.change_both(value="goose", count=9)
- assert child_state.value == "GOOSE"
- assert child_state.count == 18
- def test_event_handlers_call_other_handlers():
- """Test that event handlers can call other event handlers."""
- class MainState(BaseState):
- v: int = 0
- def set_v(self, v: int):
- self.v = v
- def set_v2(self, v: int):
- self.set_v(v)
- class SubState(MainState):
- def set_v3(self, v: int):
- self.set_v2(v)
- class SubSubState(SubState):
- def set_v4(self, v: int):
- self.set_v(v)
- ms = MainState()
- ms.set_v2(1)
- assert ms.v == 1
- # ensure handler can be called from substate
- ms.substates[SubState.get_name()].set_v3(2)
- assert ms.v == 2
- # ensure handler can be called from substate (referencing grandparent handler)
- ms.get_substate(tuple(SubSubState.get_full_name().split("."))).set_v4(3)
- assert ms.v == 3
- def test_computed_var_cached():
- """Test that a ComputedVar doesn't recalculate when accessed."""
- comp_v_calls = 0
- class ComputedState(BaseState):
- v: int = 0
- @rx.cached_var
- def comp_v(self) -> int:
- nonlocal comp_v_calls
- comp_v_calls += 1
- return self.v
- cs = ComputedState()
- assert cs.dict()[cs.get_full_name()]["v"] == 0
- assert comp_v_calls == 1
- assert cs.dict()[cs.get_full_name()]["comp_v"] == 0
- assert comp_v_calls == 1
- assert cs.comp_v == 0
- assert comp_v_calls == 1
- cs.v = 1
- assert comp_v_calls == 1
- assert cs.comp_v == 1
- assert comp_v_calls == 2
- def test_computed_var_cached_depends_on_non_cached():
- """Test that a cached_var is recalculated if it depends on non-cached ComputedVar."""
- class ComputedState(BaseState):
- v: int = 0
- @rx.var
- def no_cache_v(self) -> int:
- return self.v
- @rx.cached_var
- def dep_v(self) -> int:
- return self.no_cache_v # type: ignore
- @rx.cached_var
- def comp_v(self) -> int:
- return self.v
- cs = ComputedState()
- assert cs.dirty_vars == set()
- assert cs.get_delta() == {cs.get_name(): {"no_cache_v": 0, "dep_v": 0}}
- cs._clean()
- assert cs.dirty_vars == set()
- assert cs.get_delta() == {cs.get_name(): {"no_cache_v": 0, "dep_v": 0}}
- cs._clean()
- assert cs.dirty_vars == set()
- cs.v = 1
- assert cs.dirty_vars == {"v", "comp_v", "dep_v", "no_cache_v"}
- assert cs.get_delta() == {
- cs.get_name(): {"v": 1, "no_cache_v": 1, "dep_v": 1, "comp_v": 1}
- }
- cs._clean()
- assert cs.dirty_vars == set()
- assert cs.get_delta() == {cs.get_name(): {"no_cache_v": 1, "dep_v": 1}}
- cs._clean()
- assert cs.dirty_vars == set()
- assert cs.get_delta() == {cs.get_name(): {"no_cache_v": 1, "dep_v": 1}}
- cs._clean()
- assert cs.dirty_vars == set()
- def test_computed_var_depends_on_parent_non_cached():
- """Child state cached_var that depends on parent state un cached var is always recalculated."""
- counter = 0
- class ParentState(BaseState):
- @rx.var
- def no_cache_v(self) -> int:
- nonlocal counter
- counter += 1
- return counter
- class ChildState(ParentState):
- @rx.cached_var
- def dep_v(self) -> int:
- return self.no_cache_v # type: ignore
- ps = ParentState()
- cs = ps.substates[ChildState.get_name()]
- assert ps.dirty_vars == set()
- assert cs.dirty_vars == set()
- dict1 = ps.dict()
- assert dict1[ps.get_full_name()] == {
- "no_cache_v": 1,
- "router": formatted_router,
- }
- assert dict1[cs.get_full_name()] == {"dep_v": 2}
- dict2 = ps.dict()
- assert dict2[ps.get_full_name()] == {
- "no_cache_v": 3,
- "router": formatted_router,
- }
- assert dict2[cs.get_full_name()] == {"dep_v": 4}
- dict3 = ps.dict()
- assert dict3[ps.get_full_name()] == {
- "no_cache_v": 5,
- "router": formatted_router,
- }
- assert dict3[cs.get_full_name()] == {"dep_v": 6}
- assert counter == 6
- @pytest.mark.parametrize("use_partial", [True, False])
- def test_cached_var_depends_on_event_handler(use_partial: bool):
- """A cached_var that calls an event handler calculates deps correctly.
- Args:
- use_partial: if true, replace the EventHandler with functools.partial
- """
- counter = 0
- class HandlerState(BaseState):
- x: int = 42
- def handler(self):
- self.x = self.x + 1
- @rx.cached_var
- def cached_x_side_effect(self) -> int:
- self.handler()
- nonlocal counter
- counter += 1
- return counter
- if use_partial:
- HandlerState.handler = functools.partial(HandlerState.handler.fn)
- assert isinstance(HandlerState.handler, functools.partial)
- else:
- assert isinstance(HandlerState.handler, EventHandler)
- s = HandlerState()
- assert "cached_x_side_effect" in s._computed_var_dependencies["x"]
- assert s.cached_x_side_effect == 1
- assert s.x == 43
- s.handler()
- assert s.cached_x_side_effect == 2
- assert s.x == 45
- def test_computed_var_dependencies():
- """Test that a ComputedVar correctly tracks its dependencies."""
- class ComputedState(BaseState):
- v: int = 0
- w: int = 0
- x: int = 0
- y: List[int] = [1, 2, 3]
- _z: List[int] = [1, 2, 3]
- @rx.cached_var
- def comp_v(self) -> int:
- """Direct access.
- Returns:
- The value of self.v.
- """
- return self.v
- @rx.cached_var
- def comp_w(self):
- """Nested lambda.
- Returns:
- A lambda that returns the value of self.w.
- """
- return lambda: self.w
- @rx.cached_var
- def comp_x(self):
- """Nested function.
- Returns:
- A function that returns the value of self.x.
- """
- def _():
- return self.x
- return _
- @rx.cached_var
- def comp_y(self) -> List[int]:
- """Comprehension iterating over attribute.
- Returns:
- A list of the values of self.y.
- """
- return [round(y) for y in self.y]
- @rx.cached_var
- def comp_z(self) -> List[bool]:
- """Comprehension accesses attribute.
- Returns:
- A list of whether the values 0-4 are in self._z.
- """
- return [z in self._z for z in range(5)]
- cs = ComputedState()
- assert cs._computed_var_dependencies["v"] == {"comp_v"}
- assert cs._computed_var_dependencies["w"] == {"comp_w"}
- assert cs._computed_var_dependencies["x"] == {"comp_x"}
- assert cs._computed_var_dependencies["y"] == {"comp_y"}
- assert cs._computed_var_dependencies["_z"] == {"comp_z"}
- def test_backend_method():
- """A method with leading underscore should be callable from event handler."""
- class BackendMethodState(BaseState):
- def _be_method(self):
- return True
- def handler(self):
- assert self._be_method()
- bms = BackendMethodState()
- bms.handler()
- assert bms._be_method()
- def test_setattr_of_mutable_types(mutable_state):
- """Test that mutable types are converted to corresponding Reflex wrappers.
- Args:
- mutable_state: A test state.
- """
- array = mutable_state.array
- hashmap = mutable_state.hashmap
- test_set = mutable_state.test_set
- assert isinstance(array, MutableProxy)
- assert isinstance(array, list)
- assert isinstance(array[1], MutableProxy)
- assert isinstance(array[1], list)
- assert isinstance(array[2], MutableProxy)
- assert isinstance(array[2], dict)
- assert isinstance(hashmap, MutableProxy)
- assert isinstance(hashmap, dict)
- assert isinstance(hashmap["key"], MutableProxy)
- assert isinstance(hashmap["key"], list)
- assert isinstance(hashmap["third_key"], MutableProxy)
- assert isinstance(hashmap["third_key"], dict)
- assert isinstance(test_set, MutableProxy)
- assert isinstance(test_set, set)
- assert isinstance(mutable_state.custom, MutableProxy)
- assert isinstance(mutable_state.custom.array, MutableProxy)
- assert isinstance(mutable_state.custom.array, list)
- assert isinstance(mutable_state.custom.hashmap, MutableProxy)
- assert isinstance(mutable_state.custom.hashmap, dict)
- assert isinstance(mutable_state.custom.test_set, MutableProxy)
- assert isinstance(mutable_state.custom.test_set, set)
- assert isinstance(mutable_state.custom.custom, MutableProxy)
- mutable_state.reassign_mutables()
- array = mutable_state.array
- hashmap = mutable_state.hashmap
- test_set = mutable_state.test_set
- assert isinstance(array, MutableProxy)
- assert isinstance(array, list)
- assert isinstance(array[1], MutableProxy)
- assert isinstance(array[1], list)
- assert isinstance(array[2], MutableProxy)
- assert isinstance(array[2], dict)
- assert isinstance(hashmap, MutableProxy)
- assert isinstance(hashmap, dict)
- assert isinstance(hashmap["mod_key"], MutableProxy)
- assert isinstance(hashmap["mod_key"], list)
- assert isinstance(hashmap["mod_third_key"], MutableProxy)
- assert isinstance(hashmap["mod_third_key"], dict)
- assert isinstance(test_set, MutableProxy)
- assert isinstance(test_set, set)
- def test_error_on_state_method_shadow():
- """Test that an error is thrown when an event handler shadows a state method."""
- with pytest.raises(NameError) as err:
- class InvalidTest(BaseState):
- def reset(self):
- pass
- assert (
- err.value.args[0]
- == f"The event handler name `reset` shadows a builtin State method; use a different name instead"
- )
- @pytest.mark.asyncio
- async def test_state_with_invalid_yield(capsys):
- """Test that an error is thrown when a state yields an invalid value.
- Args:
- capsys: Pytest fixture for capture standard streams.
- """
- class StateWithInvalidYield(BaseState):
- """A state that yields an invalid value."""
- def invalid_handler(self):
- """Invalid handler.
- Yields:
- an invalid value.
- """
- yield 1
- invalid_state = StateWithInvalidYield()
- async for update in invalid_state._process(
- rx.event.Event(token="fake_token", name="invalid_handler")
- ):
- assert not update.delta
- assert update.events == rx.event.fix_events(
- [rx.window_alert("An error occurred. See logs for details.")],
- token="",
- )
- captured = capsys.readouterr()
- assert "must only return/yield: None, Events or other EventHandlers" in captured.out
- @pytest.fixture(scope="function", params=["in_process", "redis"])
- def state_manager(request) -> Generator[StateManager, None, None]:
- """Instance of state manager parametrized for redis and in-process.
- Args:
- request: pytest request object.
- Yields:
- A state manager instance
- """
- state_manager = StateManager.create(state=TestState)
- if request.param == "redis":
- if not isinstance(state_manager, StateManagerRedis):
- pytest.skip("Test requires redis")
- else:
- # explicitly NOT using redis
- state_manager = StateManagerMemory(state=TestState)
- assert not state_manager._states_locks
- yield state_manager
- if isinstance(state_manager, StateManagerRedis):
- asyncio.get_event_loop().run_until_complete(state_manager.close())
- @pytest.fixture()
- def substate_token(state_manager, token):
- """A token + substate name for looking up in state manager.
- Args:
- state_manager: A state manager instance.
- token: A token.
- Returns:
- Token concatenated with the state_manager's state full_name.
- """
- return _substate_key(token, state_manager.state)
- @pytest.mark.asyncio
- async def test_state_manager_modify_state(
- state_manager: StateManager, token: str, substate_token: str
- ):
- """Test that the state manager can modify a state exclusively.
- Args:
- state_manager: A state manager instance.
- token: A token.
- substate_token: A token + substate name for looking up in state manager.
- """
- async with state_manager.modify_state(substate_token) as state:
- if isinstance(state_manager, StateManagerRedis):
- assert await state_manager.redis.get(f"{token}_lock")
- elif isinstance(state_manager, StateManagerMemory):
- assert token in state_manager._states_locks
- assert state_manager._states_locks[token].locked()
- # Should be able to write proxy objects inside mutables
- complex_1 = state.complex[1]
- assert isinstance(complex_1, MutableProxy)
- state.complex[3] = complex_1
- # lock should be dropped after exiting the context
- if isinstance(state_manager, StateManagerRedis):
- assert (await state_manager.redis.get(f"{token}_lock")) is None
- elif isinstance(state_manager, StateManagerMemory):
- assert not state_manager._states_locks[token].locked()
- # separate instances should NOT share locks
- sm2 = StateManagerMemory(state=TestState)
- assert sm2._state_manager_lock is state_manager._state_manager_lock
- assert not sm2._states_locks
- if state_manager._states_locks:
- assert sm2._states_locks != state_manager._states_locks
- @pytest.mark.asyncio
- async def test_state_manager_contend(
- state_manager: StateManager, token: str, substate_token: str
- ):
- """Multiple coroutines attempting to access the same state.
- Args:
- state_manager: A state manager instance.
- token: A token.
- substate_token: A token + substate name for looking up in state manager.
- """
- n_coroutines = 10
- exp_num1 = 10
- async with state_manager.modify_state(substate_token) as state:
- state.num1 = 0
- async def _coro():
- async with state_manager.modify_state(substate_token) as state:
- await asyncio.sleep(0.01)
- state.num1 += 1
- tasks = [asyncio.create_task(_coro()) for _ in range(n_coroutines)]
- for f in asyncio.as_completed(tasks):
- await f
- assert (await state_manager.get_state(substate_token)).num1 == exp_num1
- if isinstance(state_manager, StateManagerRedis):
- assert (await state_manager.redis.get(f"{token}_lock")) is None
- elif isinstance(state_manager, StateManagerMemory):
- assert token in state_manager._states_locks
- assert not state_manager._states_locks[token].locked()
- @pytest.fixture(scope="function")
- def state_manager_redis() -> Generator[StateManager, None, None]:
- """Instance of state manager for redis only.
- Yields:
- A state manager instance
- """
- state_manager = StateManager.create(TestState)
- if not isinstance(state_manager, StateManagerRedis):
- pytest.skip("Test requires redis")
- yield state_manager
- asyncio.get_event_loop().run_until_complete(state_manager.close())
- @pytest.fixture()
- def substate_token_redis(state_manager_redis, token):
- """A token + substate name for looking up in state manager.
- Args:
- state_manager_redis: A state manager instance.
- token: A token.
- Returns:
- Token concatenated with the state_manager's state full_name.
- """
- return _substate_key(token, state_manager_redis.state)
- @pytest.mark.asyncio
- async def test_state_manager_lock_expire(
- state_manager_redis: StateManager, token: str, substate_token_redis: str
- ):
- """Test that the state manager lock expires and raises exception exiting context.
- Args:
- state_manager_redis: A state manager instance.
- token: A token.
- substate_token_redis: A token + substate name for looking up in state manager.
- """
- state_manager_redis.lock_expiration = LOCK_EXPIRATION
- async with state_manager_redis.modify_state(substate_token_redis):
- await asyncio.sleep(0.01)
- with pytest.raises(LockExpiredError):
- async with state_manager_redis.modify_state(substate_token_redis):
- await asyncio.sleep(LOCK_EXPIRE_SLEEP)
- @pytest.mark.asyncio
- async def test_state_manager_lock_expire_contend(
- state_manager_redis: StateManager, token: str, substate_token_redis: str
- ):
- """Test that the state manager lock expires and queued waiters proceed.
- Args:
- state_manager_redis: A state manager instance.
- token: A token.
- substate_token_redis: A token + substate name for looking up in state manager.
- """
- exp_num1 = 4252
- unexp_num1 = 666
- state_manager_redis.lock_expiration = LOCK_EXPIRATION
- order = []
- async def _coro_blocker():
- async with state_manager_redis.modify_state(substate_token_redis) as state:
- order.append("blocker")
- await asyncio.sleep(LOCK_EXPIRE_SLEEP)
- state.num1 = unexp_num1
- async def _coro_waiter():
- while "blocker" not in order:
- await asyncio.sleep(0.005)
- async with state_manager_redis.modify_state(substate_token_redis) as state:
- order.append("waiter")
- assert state.num1 != unexp_num1
- state.num1 = exp_num1
- tasks = [
- asyncio.create_task(_coro_blocker()),
- asyncio.create_task(_coro_waiter()),
- ]
- with pytest.raises(LockExpiredError):
- await tasks[0]
- await tasks[1]
- assert order == ["blocker", "waiter"]
- assert (await state_manager_redis.get_state(substate_token_redis)).num1 == exp_num1
- @pytest.fixture(scope="function")
- def mock_app(monkeypatch, state_manager: StateManager) -> rx.App:
- """Mock app fixture.
- Args:
- monkeypatch: Pytest monkeypatch object.
- state_manager: A state manager.
- Returns:
- The app, after mocking out prerequisites.get_app()
- """
- app = App(state=TestState)
- app_module = Mock()
- setattr(app_module, CompileVars.APP, app)
- app.state = TestState
- app._state_manager = state_manager
- app.event_namespace.emit = AsyncMock() # type: ignore
- def _mock_get_app(*args, **kwargs):
- return app_module
- monkeypatch.setattr(prerequisites, "get_app", _mock_get_app)
- return app
- @pytest.mark.asyncio
- async def test_state_proxy(grandchild_state: GrandchildState, mock_app: rx.App):
- """Test that the state proxy works.
- Args:
- grandchild_state: A grandchild state.
- mock_app: An app that will be returned by `get_app()`
- """
- child_state = grandchild_state.parent_state
- assert child_state is not None
- parent_state = child_state.parent_state
- assert parent_state is not None
- if isinstance(mock_app.state_manager, StateManagerMemory):
- mock_app.state_manager.states[
- parent_state.router.session.client_token
- ] = parent_state
- sp = StateProxy(grandchild_state)
- assert sp.__wrapped__ == grandchild_state
- assert sp._self_substate_path == grandchild_state.get_full_name().split(".")
- assert sp._self_app is mock_app
- assert not sp._self_mutable
- assert sp._self_actx is None
- # cannot use normal contextmanager protocol
- with pytest.raises(TypeError), sp:
- pass
- with pytest.raises(ImmutableStateError):
- # cannot directly modify state proxy outside of async context
- sp.value2 = "16"
- with pytest.raises(ImmutableStateError):
- # Cannot get_state
- await sp.get_state(ChildState)
- with pytest.raises(ImmutableStateError):
- # Cannot access get_substate
- sp.get_substate([])
- with pytest.raises(ImmutableStateError):
- # Cannot access parent state
- sp.parent_state.get_name()
- with pytest.raises(ImmutableStateError):
- # Cannot access substates
- sp.substates[""]
- async with sp:
- assert sp._self_actx is not None
- assert sp._self_mutable # proxy is mutable inside context
- if isinstance(mock_app.state_manager, StateManagerMemory):
- # For in-process store, only one instance of the state exists
- assert sp.__wrapped__ is grandchild_state
- else:
- # When redis is used, a new+updated instance is assigned to the proxy
- assert sp.__wrapped__ is not grandchild_state
- sp.value2 = "42"
- assert not sp._self_mutable # proxy is not mutable after exiting context
- assert sp._self_actx is None
- assert sp.value2 == "42"
- # Get the state from the state manager directly and check that the value is updated
- gotten_state = await mock_app.state_manager.get_state(
- _substate_key(grandchild_state.router.session.client_token, grandchild_state)
- )
- if isinstance(mock_app.state_manager, StateManagerMemory):
- # For in-process store, only one instance of the state exists
- assert gotten_state is parent_state
- else:
- assert gotten_state is not parent_state
- gotten_grandchild_state = gotten_state.get_substate(sp._self_substate_path)
- assert gotten_grandchild_state is not None
- assert gotten_grandchild_state.value2 == "42"
- # ensure state update was emitted
- assert mock_app.event_namespace is not None
- mock_app.event_namespace.emit.assert_called_once()
- mcall = mock_app.event_namespace.emit.mock_calls[0]
- assert mcall.args[0] == str(SocketEvent.EVENT)
- assert json.loads(mcall.args[1]) == StateUpdate(
- delta={
- parent_state.get_full_name(): {
- "upper": "",
- "sum": 3.14,
- },
- grandchild_state.get_full_name(): {
- "value2": "42",
- },
- GrandchildState3.get_full_name(): {
- "computed": "",
- },
- }
- )
- assert mcall.kwargs["to"] == grandchild_state.router.session.session_id
- class BackgroundTaskState(BaseState):
- """A state with a background task."""
- order: List[str] = []
- dict_list: Dict[str, List[int]] = {"foo": [1, 2, 3]}
- @rx.var
- def computed_order(self) -> List[str]:
- """Get the order as a computed var.
- Returns:
- The value of 'order' var.
- """
- return self.order
- @rx.background
- async def background_task(self):
- """A background task that updates the state."""
- async with self:
- assert not self.order
- self.order.append("background_task:start")
- assert isinstance(self, StateProxy)
- with pytest.raises(ImmutableStateError):
- self.order.append("bad idea")
- with pytest.raises(ImmutableStateError):
- # Even nested access to mutables raises an exception.
- self.dict_list["foo"].append(42)
- with pytest.raises(ImmutableStateError):
- # Direct calling another handler that modifies state raises an exception.
- self.other()
- with pytest.raises(ImmutableStateError):
- # Calling other methods that modify state raises an exception.
- self._private_method()
- # wait for some other event to happen
- while len(self.order) == 1:
- await asyncio.sleep(0.01)
- async with self:
- pass # update proxy instance
- async with self:
- # Methods on ImmutableMutableProxy should return their wrapped return value.
- assert self.dict_list.pop("foo") == [1, 2, 3]
- self.order.append("background_task:stop")
- self.other() # direct calling event handlers works in context
- self._private_method()
- @rx.background
- async def background_task_reset(self):
- """A background task that resets the state."""
- with pytest.raises(ImmutableStateError):
- # Resetting the state should be explicitly blocked.
- self.reset()
- async with self:
- self.order.append("foo")
- self.reset()
- assert not self.order
- async with self:
- self.order.append("reset")
- @rx.background
- async def background_task_generator(self):
- """A background task generator that does nothing.
- Yields:
- None
- """
- yield
- def other(self):
- """Some other event that updates the state."""
- self.order.append("other")
- def _private_method(self):
- """Some private method that updates the state."""
- self.order.append("private")
- async def bad_chain1(self):
- """Test that a background task cannot be chained."""
- await self.background_task()
- async def bad_chain2(self):
- """Test that a background task generator cannot be chained."""
- async for _foo in self.background_task_generator():
- pass
- @pytest.mark.asyncio
- async def test_background_task_no_block(mock_app: rx.App, token: str):
- """Test that a background task does not block other events.
- Args:
- mock_app: An app that will be returned by `get_app()`
- token: A token.
- """
- router_data = {"query": {}}
- mock_app.state_manager.state = mock_app.state = BackgroundTaskState
- async for update in rx.app.process( # type: ignore
- mock_app,
- Event(
- token=token,
- name=f"{BackgroundTaskState.get_name()}.background_task",
- router_data=router_data,
- payload={},
- ),
- sid="",
- headers={},
- client_ip="",
- ):
- # background task returns empty update immediately
- assert update == StateUpdate()
- # wait for the coroutine to start
- await asyncio.sleep(0.5 if CI else 0.1)
- assert len(mock_app.background_tasks) == 1
- # Process another normal event
- async for update in rx.app.process( # type: ignore
- mock_app,
- Event(
- token=token,
- name=f"{BackgroundTaskState.get_name()}.other",
- router_data=router_data,
- payload={},
- ),
- sid="",
- headers={},
- client_ip="",
- ):
- # other task returns delta
- assert update == StateUpdate(
- delta={
- BackgroundTaskState.get_name(): {
- "order": [
- "background_task:start",
- "other",
- ],
- "computed_order": [
- "background_task:start",
- "other",
- ],
- }
- }
- )
- # Explicit wait for background tasks
- for task in tuple(mock_app.background_tasks):
- await task
- assert not mock_app.background_tasks
- exp_order = [
- "background_task:start",
- "other",
- "background_task:stop",
- "other",
- "private",
- ]
- assert (
- await mock_app.state_manager.get_state(
- _substate_key(token, BackgroundTaskState)
- )
- ).order == exp_order
- assert mock_app.event_namespace is not None
- emit_mock = mock_app.event_namespace.emit
- first_ws_message = json.loads(emit_mock.mock_calls[0].args[1])
- assert first_ws_message["delta"]["background_task_state"].pop("router") is not None
- assert first_ws_message == {
- "delta": {
- "background_task_state": {
- "order": ["background_task:start"],
- "computed_order": ["background_task:start"],
- }
- },
- "events": [],
- "final": True,
- }
- for call in emit_mock.mock_calls[1:5]:
- assert json.loads(call.args[1]) == {
- "delta": {
- "background_task_state": {"computed_order": ["background_task:start"]}
- },
- "events": [],
- "final": True,
- }
- assert json.loads(emit_mock.mock_calls[-2].args[1]) == {
- "delta": {
- "background_task_state": {
- "order": exp_order,
- "computed_order": exp_order,
- "dict_list": {},
- }
- },
- "events": [],
- "final": True,
- }
- assert json.loads(emit_mock.mock_calls[-1].args[1]) == {
- "delta": {
- "background_task_state": {
- "computed_order": exp_order,
- },
- },
- "events": [],
- "final": True,
- }
- @pytest.mark.asyncio
- async def test_background_task_reset(mock_app: rx.App, token: str):
- """Test that a background task calling reset is protected by the state proxy.
- Args:
- mock_app: An app that will be returned by `get_app()`
- token: A token.
- """
- router_data = {"query": {}}
- mock_app.state_manager.state = mock_app.state = BackgroundTaskState
- async for update in rx.app.process( # type: ignore
- mock_app,
- Event(
- token=token,
- name=f"{BackgroundTaskState.get_name()}.background_task_reset",
- router_data=router_data,
- payload={},
- ),
- sid="",
- headers={},
- client_ip="",
- ):
- # background task returns empty update immediately
- assert update == StateUpdate()
- # Explicit wait for background tasks
- for task in tuple(mock_app.background_tasks):
- await task
- assert not mock_app.background_tasks
- assert (
- await mock_app.state_manager.get_state(
- _substate_key(token, BackgroundTaskState)
- )
- ).order == [
- "reset",
- ]
- @pytest.mark.asyncio
- async def test_background_task_no_chain():
- """Test that a background task cannot be chained."""
- bts = BackgroundTaskState()
- with pytest.raises(RuntimeError):
- await bts.bad_chain1()
- with pytest.raises(RuntimeError):
- await bts.bad_chain2()
- def test_mutable_list(mutable_state):
- """Test that mutable lists are tracked correctly.
- Args:
- mutable_state: A test state.
- """
- assert not mutable_state.dirty_vars
- def assert_array_dirty():
- assert mutable_state.dirty_vars == {"array"}
- mutable_state._clean()
- assert not mutable_state.dirty_vars
- # Test all list operations
- mutable_state.array.append(42)
- assert_array_dirty()
- mutable_state.array.extend([1, 2, 3])
- assert_array_dirty()
- mutable_state.array.insert(0, 0)
- assert_array_dirty()
- mutable_state.array.pop()
- assert_array_dirty()
- mutable_state.array.remove(42)
- assert_array_dirty()
- mutable_state.array.clear()
- assert_array_dirty()
- mutable_state.array += [1, 2, 3]
- assert_array_dirty()
- mutable_state.array.reverse()
- assert_array_dirty()
- mutable_state.array.sort()
- assert_array_dirty()
- mutable_state.array[0] = 666
- assert_array_dirty()
- del mutable_state.array[0]
- assert_array_dirty()
- # Test nested list operations
- mutable_state.array[0] = [1, 2, 3]
- assert_array_dirty()
- mutable_state.array[0].append(4)
- assert_array_dirty()
- assert isinstance(mutable_state.array[0], MutableProxy)
- # Test proxy returned from __iter__
- mutable_state.array = [{}]
- assert_array_dirty()
- assert isinstance(mutable_state.array[0], MutableProxy)
- for item in mutable_state.array:
- assert isinstance(item, MutableProxy)
- item["foo"] = "bar"
- assert_array_dirty()
- def test_mutable_dict(mutable_state):
- """Test that mutable dicts are tracked correctly.
- Args:
- mutable_state: A test state.
- """
- assert not mutable_state.dirty_vars
- def assert_hashmap_dirty():
- assert mutable_state.dirty_vars == {"hashmap"}
- mutable_state._clean()
- assert not mutable_state.dirty_vars
- # Test all dict operations
- mutable_state.hashmap.update({"new_key": 43})
- assert_hashmap_dirty()
- assert mutable_state.hashmap.setdefault("another_key", 66) == "another_value"
- assert_hashmap_dirty()
- assert mutable_state.hashmap.setdefault("setdefault_key", 67) == 67
- assert_hashmap_dirty()
- assert mutable_state.hashmap.setdefault("setdefault_key", 68) == 67
- assert_hashmap_dirty()
- assert mutable_state.hashmap.pop("new_key") == 43
- assert_hashmap_dirty()
- mutable_state.hashmap.popitem()
- assert_hashmap_dirty()
- mutable_state.hashmap.clear()
- assert_hashmap_dirty()
- mutable_state.hashmap["new_key"] = 42
- assert_hashmap_dirty()
- del mutable_state.hashmap["new_key"]
- assert_hashmap_dirty()
- if sys.version_info >= (3, 9):
- mutable_state.hashmap |= {"new_key": 44}
- assert_hashmap_dirty()
- # Test nested dict operations
- mutable_state.hashmap["array"] = []
- assert_hashmap_dirty()
- mutable_state.hashmap["array"].append(1)
- assert_hashmap_dirty()
- mutable_state.hashmap["dict"] = {}
- assert_hashmap_dirty()
- mutable_state.hashmap["dict"]["key"] = 42
- assert_hashmap_dirty()
- mutable_state.hashmap["dict"]["dict"] = {}
- assert_hashmap_dirty()
- mutable_state.hashmap["dict"]["dict"]["key"] = 43
- assert_hashmap_dirty()
- # Test proxy returned from `setdefault` and `get`
- mutable_value = mutable_state.hashmap.setdefault("setdefault_mutable_key", [])
- assert_hashmap_dirty()
- assert mutable_value == []
- assert isinstance(mutable_value, MutableProxy)
- mutable_value.append("foo")
- assert_hashmap_dirty()
- mutable_value_other_ref = mutable_state.hashmap.get("setdefault_mutable_key")
- assert isinstance(mutable_value_other_ref, MutableProxy)
- assert mutable_value is not mutable_value_other_ref
- assert mutable_value == mutable_value_other_ref
- assert not mutable_state.dirty_vars
- mutable_value_other_ref.append("bar")
- assert_hashmap_dirty()
- # `pop` should NOT return a proxy, because the returned value is no longer in the dict
- mutable_value_third_ref = mutable_state.hashmap.pop("setdefault_mutable_key")
- assert not isinstance(mutable_value_third_ref, MutableProxy)
- assert_hashmap_dirty()
- mutable_value_third_ref.append("baz")
- assert not mutable_state.dirty_vars
- # Unfortunately previous refs still will mark the state dirty... nothing doing about that
- assert mutable_value.pop()
- assert_hashmap_dirty()
- def test_mutable_set(mutable_state):
- """Test that mutable sets are tracked correctly.
- Args:
- mutable_state: A test state.
- """
- assert not mutable_state.dirty_vars
- def assert_set_dirty():
- assert mutable_state.dirty_vars == {"test_set"}
- mutable_state._clean()
- assert not mutable_state.dirty_vars
- # Test all set operations
- mutable_state.test_set.add(42)
- assert_set_dirty()
- mutable_state.test_set.update([1, 2, 3])
- assert_set_dirty()
- mutable_state.test_set.remove(42)
- assert_set_dirty()
- mutable_state.test_set.discard(3)
- assert_set_dirty()
- mutable_state.test_set.pop()
- assert_set_dirty()
- mutable_state.test_set.intersection_update([1, 2, 3])
- assert_set_dirty()
- mutable_state.test_set.difference_update([99])
- assert_set_dirty()
- mutable_state.test_set.symmetric_difference_update([102, 99])
- assert_set_dirty()
- mutable_state.test_set |= {1, 2, 3}
- assert_set_dirty()
- mutable_state.test_set &= {2, 3, 4}
- assert_set_dirty()
- mutable_state.test_set -= {2}
- assert_set_dirty()
- mutable_state.test_set ^= {42}
- assert_set_dirty()
- mutable_state.test_set.clear()
- assert_set_dirty()
- def test_mutable_custom(mutable_state):
- """Test that mutable custom types derived from Base are tracked correctly.
- Args:
- mutable_state: A test state.
- """
- assert not mutable_state.dirty_vars
- def assert_custom_dirty():
- assert mutable_state.dirty_vars == {"custom"}
- mutable_state._clean()
- assert not mutable_state.dirty_vars
- mutable_state.custom.foo = "bar"
- assert_custom_dirty()
- mutable_state.custom.array.append(42)
- assert_custom_dirty()
- mutable_state.custom.hashmap["key"] = 68
- assert_custom_dirty()
- mutable_state.custom.test_set.add(42)
- assert_custom_dirty()
- mutable_state.custom.custom.bar = "baz"
- assert_custom_dirty()
- def test_mutable_backend(mutable_state):
- """Test that mutable backend vars are tracked correctly.
- Args:
- mutable_state: A test state.
- """
- assert not mutable_state.dirty_vars
- def assert_custom_dirty():
- assert mutable_state.dirty_vars == {"_be_custom"}
- mutable_state._clean()
- assert not mutable_state.dirty_vars
- mutable_state._be_custom.foo = "bar"
- assert_custom_dirty()
- mutable_state._be_custom.array.append(42)
- assert_custom_dirty()
- mutable_state._be_custom.hashmap["key"] = 68
- assert_custom_dirty()
- mutable_state._be_custom.test_set.add(42)
- assert_custom_dirty()
- mutable_state._be_custom.custom.bar = "baz"
- assert_custom_dirty()
- @pytest.mark.parametrize(
- ("copy_func",),
- [
- (copy.copy,),
- (copy.deepcopy,),
- ],
- )
- def test_mutable_copy(mutable_state, copy_func):
- """Test that mutable types are copied correctly.
- Args:
- mutable_state: A test state.
- copy_func: A copy function.
- """
- ms_copy = copy_func(mutable_state)
- assert ms_copy is not mutable_state
- for attr in ("array", "hashmap", "test_set", "custom"):
- assert getattr(ms_copy, attr) == getattr(mutable_state, attr)
- assert getattr(ms_copy, attr) is not getattr(mutable_state, attr)
- ms_copy.custom.array.append(42)
- assert "custom" in ms_copy.dirty_vars
- if copy_func is copy.copy:
- assert "custom" in mutable_state.dirty_vars
- else:
- assert not mutable_state.dirty_vars
- @pytest.mark.parametrize(
- ("copy_func",),
- [
- (copy.copy,),
- (copy.deepcopy,),
- ],
- )
- def test_mutable_copy_vars(mutable_state, copy_func):
- """Test that mutable types are copied correctly.
- Args:
- mutable_state: A test state.
- copy_func: A copy function.
- """
- for attr in ("array", "hashmap", "test_set", "custom"):
- var_orig = getattr(mutable_state, attr)
- var_copy = copy_func(var_orig)
- assert var_orig is not var_copy
- assert var_orig == var_copy
- # copied vars should never be proxies, as they by definition are no longer attached to the state.
- assert not isinstance(var_copy, MutableProxy)
- def test_duplicate_substate_class(mocker):
- mocker.patch("reflex.state.is_testing_env", lambda: False)
- with pytest.raises(ValueError):
- class TestState(BaseState):
- pass
- class ChildTestState(TestState): # type: ignore # noqa
- pass
- class ChildTestState(TestState): # type: ignore # noqa
- pass
- return TestState
- class Foo(Base):
- """A class containing a list of str."""
- tags: List[str] = ["123", "456"]
- def test_json_dumps_with_mutables():
- """Test that json.dumps works with Base vars inside mutable types."""
- class MutableContainsBase(BaseState):
- items: List[Foo] = [Foo()]
- dict_val = MutableContainsBase().dict()
- assert isinstance(dict_val[MutableContainsBase.get_full_name()]["items"][0], dict)
- val = json_dumps(dict_val)
- f_items = '[{"tags": ["123", "456"]}]'
- f_formatted_router = str(formatted_router).replace("'", '"')
- assert (
- val
- == f'{{"{MutableContainsBase.get_full_name()}": {{"items": {f_items}, "router": {f_formatted_router}}}}}'
- )
- def test_reset_with_mutables():
- """Calling reset should always reset fields to a copy of the defaults."""
- default = [[0, 0], [0, 1], [1, 1]]
- copied_default = copy.deepcopy(default)
- class MutableResetState(BaseState):
- items: List[List[int]] = default
- instance = MutableResetState()
- assert instance.items.__wrapped__ is not default # type: ignore
- assert instance.items == default == copied_default
- instance.items.append([3, 3])
- assert instance.items != default
- assert instance.items != copied_default
- instance.reset()
- assert instance.items.__wrapped__ is not default # type: ignore
- assert instance.items == default == copied_default
- instance.items.append([3, 3])
- assert instance.items != default
- assert instance.items != copied_default
- instance.reset()
- assert instance.items.__wrapped__ is not default # type: ignore
- assert instance.items == default == copied_default
- instance.items.append([3, 3])
- assert instance.items != default
- assert instance.items != copied_default
- class Custom1(Base):
- """A custom class with a str field."""
- foo: str
- def set_foo(self, val: str):
- """Set the attribute foo.
- Args:
- val: The value to set.
- """
- self.foo = val
- def double_foo(self) -> str:
- """Concantenate foo with foo.
- Returns:
- foo + foo
- """
- return self.foo + self.foo
- class Custom2(Base):
- """A custom class with a Custom1 field."""
- c1: Optional[Custom1] = None
- c1r: Custom1
- def set_c1r_foo(self, val: str):
- """Set the foo attribute of the c1 field.
- Args:
- val: The value to set.
- """
- self.c1r.set_foo(val)
- class Custom3(Base):
- """A custom class with a Custom2 field."""
- c2: Optional[Custom2] = None
- c2r: Custom2
- def test_state_union_optional():
- """Test that state can be defined with Union and Optional vars."""
- class UnionState(BaseState):
- int_float: Union[int, float] = 0
- opt_int: Optional[int]
- c3: Optional[Custom3]
- c3i: Custom3 # implicitly required
- c3r: Custom3 = Custom3(c2r=Custom2(c1r=Custom1(foo="")))
- custom_union: Union[Custom1, Custom2, Custom3] = Custom1(foo="")
- assert UnionState.c3.c2._var_name == "c3?.c2" # type: ignore
- assert UnionState.c3.c2.c1._var_name == "c3?.c2?.c1" # type: ignore
- assert UnionState.c3.c2.c1.foo._var_name == "c3?.c2?.c1?.foo" # type: ignore
- assert UnionState.c3.c2.c1r.foo._var_name == "c3?.c2?.c1r.foo" # type: ignore
- assert UnionState.c3.c2r.c1._var_name == "c3?.c2r.c1" # type: ignore
- assert UnionState.c3.c2r.c1.foo._var_name == "c3?.c2r.c1?.foo" # type: ignore
- assert UnionState.c3.c2r.c1r.foo._var_name == "c3?.c2r.c1r.foo" # type: ignore
- assert UnionState.c3i.c2._var_name == "c3i.c2" # type: ignore
- assert UnionState.c3r.c2._var_name == "c3r.c2" # type: ignore
- assert UnionState.custom_union.foo is not None # type: ignore
- assert UnionState.custom_union.c1 is not None # type: ignore
- assert UnionState.custom_union.c1r is not None # type: ignore
- assert UnionState.custom_union.c2 is not None # type: ignore
- assert UnionState.custom_union.c2r is not None # type: ignore
- assert types.is_optional(UnionState.opt_int._var_type) # type: ignore
- assert types.is_union(UnionState.int_float._var_type) # type: ignore
- def test_set_base_field_via_setter():
- """When calling a setter on a Base instance, also track changes."""
- class BaseFieldSetterState(BaseState):
- c1: Custom1 = Custom1(foo="")
- c2: Custom2 = Custom2(c1r=Custom1(foo=""))
- bfss = BaseFieldSetterState()
- assert "c1" not in bfss.dirty_vars
- # Non-mutating function, not dirty
- bfss.c1.double_foo()
- assert "c1" not in bfss.dirty_vars
- # Mutating function, dirty
- bfss.c1.set_foo("bar")
- assert "c1" in bfss.dirty_vars
- bfss.dirty_vars.clear()
- assert "c1" not in bfss.dirty_vars
- # Mutating function from Base, dirty
- bfss.c1.set(foo="bar")
- assert "c1" in bfss.dirty_vars
- bfss.dirty_vars.clear()
- assert "c1" not in bfss.dirty_vars
- # Assert identity of MutableProxy
- mp = bfss.c1
- assert isinstance(mp, MutableProxy)
- mp2 = mp.set()
- assert mp is mp2
- mp3 = bfss.c1.set()
- assert mp is not mp3
- # Since none of these set calls had values, the state should not be dirty
- assert not bfss.dirty_vars
- # Chained Mutating function, dirty
- bfss.c2.set_c1r_foo("baz")
- assert "c2" in bfss.dirty_vars
- def exp_is_hydrated(state: State, is_hydrated: bool = True) -> Dict[str, Any]:
- """Expected IS_HYDRATED delta that would be emitted by HydrateMiddleware.
- Args:
- state: the State that is hydrated.
- is_hydrated: whether the state is hydrated.
- Returns:
- dict similar to that returned by `State.get_delta` with IS_HYDRATED: is_hydrated
- """
- return {state.get_full_name(): {CompileVars.IS_HYDRATED: is_hydrated}}
- class OnLoadState(State):
- """A test state with no return in handler."""
- num: int = 0
- def test_handler(self):
- """Test handler."""
- self.num += 1
- class OnLoadState2(State):
- """A test state with return in handler."""
- num: int = 0
- name: str
- def test_handler(self):
- """Test handler that calls another handler.
- Returns:
- Chain of EventHandlers
- """
- self.num += 1
- return self.change_name
- def change_name(self):
- """Test handler to change name."""
- self.name = "random"
- class OnLoadState3(State):
- """A test state with async handler."""
- num: int = 0
- async def test_handler(self):
- """Test handler."""
- self.num += 1
- @pytest.mark.asyncio
- @pytest.mark.parametrize(
- "test_state, expected",
- [
- (OnLoadState, {"on_load_state": {"num": 1}}),
- (OnLoadState2, {"on_load_state2": {"num": 1}}),
- (OnLoadState3, {"on_load_state3": {"num": 1}}),
- ],
- )
- async def test_preprocess(app_module_mock, token, test_state, expected, mocker):
- """Test that a state hydrate event is processed correctly.
- Args:
- app_module_mock: The app module that will be returned by get_app().
- token: A token.
- test_state: State to process event.
- expected: Expected delta.
- mocker: pytest mock object.
- """
- mocker.patch(
- "reflex.state.State.class_subclasses", {test_state, OnLoadInternalState}
- )
- app = app_module_mock.app = App(
- state=State, load_events={"index": [test_state.test_handler]}
- )
- state = State()
- updates = []
- async for update in rx.app.process(
- app=app,
- event=Event(
- token=token,
- name=f"{state.get_name()}.{CompileVars.ON_LOAD_INTERNAL}",
- router_data={RouteVar.PATH: "/", RouteVar.ORIGIN: "/", RouteVar.QUERY: {}},
- ),
- sid="sid",
- headers={},
- client_ip="",
- ):
- assert isinstance(update, StateUpdate)
- updates.append(update)
- assert len(updates) == 1
- assert updates[0].delta["state"].pop("router") is not None
- assert updates[0].delta == exp_is_hydrated(state, False)
- events = updates[0].events
- assert len(events) == 2
- assert (await state._process(events[0]).__anext__()).delta == {
- test_state.get_full_name(): {"num": 1}
- }
- assert (await state._process(events[1]).__anext__()).delta == exp_is_hydrated(state)
- @pytest.mark.asyncio
- async def test_preprocess_multiple_load_events(app_module_mock, token, mocker):
- """Test that a state hydrate event for multiple on-load events is processed correctly.
- Args:
- app_module_mock: The app module that will be returned by get_app().
- token: A token.
- mocker: pytest mock object.
- """
- mocker.patch(
- "reflex.state.State.class_subclasses", {OnLoadState, OnLoadInternalState}
- )
- app = app_module_mock.app = App(
- state=State,
- load_events={"index": [OnLoadState.test_handler, OnLoadState.test_handler]},
- )
- state = State()
- updates = []
- async for update in rx.app.process(
- app=app,
- event=Event(
- token=token,
- name=f"{state.get_full_name()}.{CompileVars.ON_LOAD_INTERNAL}",
- router_data={RouteVar.PATH: "/", RouteVar.ORIGIN: "/", RouteVar.QUERY: {}},
- ),
- sid="sid",
- headers={},
- client_ip="",
- ):
- assert isinstance(update, StateUpdate)
- updates.append(update)
- assert len(updates) == 1
- assert updates[0].delta["state"].pop("router") is not None
- assert updates[0].delta == exp_is_hydrated(state, False)
- events = updates[0].events
- assert len(events) == 3
- assert (await state._process(events[0]).__anext__()).delta == {
- OnLoadState.get_full_name(): {"num": 1}
- }
- assert (await state._process(events[1]).__anext__()).delta == {
- OnLoadState.get_full_name(): {"num": 2}
- }
- assert (await state._process(events[2]).__anext__()).delta == exp_is_hydrated(state)
- @pytest.mark.asyncio
- async def test_get_state(mock_app: rx.App, token: str):
- """Test that a get_state populates the top level state and delta calculation is correct.
- Args:
- mock_app: An app that will be returned by `get_app()`
- token: A token.
- """
- mock_app.state_manager.state = mock_app.state = TestState
- # Get instance of ChildState2.
- test_state = await mock_app.state_manager.get_state(
- _substate_key(token, ChildState2)
- )
- assert isinstance(test_state, TestState)
- if isinstance(mock_app.state_manager, StateManagerMemory):
- # All substates are available
- assert tuple(sorted(test_state.substates)) == (
- "child_state",
- "child_state2",
- "child_state3",
- )
- else:
- # Sibling states are only populated if they have computed vars
- assert tuple(sorted(test_state.substates)) == ("child_state2", "child_state3")
- # Because ChildState3 has a computed var, it is always dirty, and always populated.
- assert (
- test_state.substates["child_state3"].substates["grandchild_state3"].computed
- == ""
- )
- # Get the child_state2 directly.
- child_state2_direct = test_state.get_substate(["child_state2"])
- child_state2_get_state = await test_state.get_state(ChildState2)
- # These should be the same object.
- assert child_state2_direct is child_state2_get_state
- # Get arbitrary GrandchildState.
- grandchild_state = await child_state2_get_state.get_state(GrandchildState)
- assert isinstance(grandchild_state, GrandchildState)
- # Now the original root should have all substates populated.
- assert tuple(sorted(test_state.substates)) == (
- "child_state",
- "child_state2",
- "child_state3",
- )
- # ChildState should be retrievable
- child_state_direct = test_state.get_substate(["child_state"])
- child_state_get_state = await test_state.get_state(ChildState)
- # These should be the same object.
- assert child_state_direct is child_state_get_state
- # GrandchildState instance should be the same as the one retrieved from the child_state2.
- assert grandchild_state is child_state_direct.get_substate(["grandchild_state"])
- grandchild_state.value2 = "set_value"
- assert test_state.get_delta() == {
- TestState.get_full_name(): {
- "sum": 3.14,
- "upper": "",
- },
- GrandchildState.get_full_name(): {
- "value2": "set_value",
- },
- GrandchildState3.get_full_name(): {
- "computed": "",
- },
- }
- # Get a fresh instance
- new_test_state = await mock_app.state_manager.get_state(
- _substate_key(token, ChildState2)
- )
- assert isinstance(new_test_state, TestState)
- if isinstance(mock_app.state_manager, StateManagerMemory):
- # In memory, it's the same instance
- assert new_test_state is test_state
- test_state._clean()
- # All substates are available
- assert tuple(sorted(new_test_state.substates)) == (
- "child_state",
- "child_state2",
- "child_state3",
- )
- else:
- # With redis, we get a whole new instance
- assert new_test_state is not test_state
- # Sibling states are only populated if they have computed vars
- assert tuple(sorted(new_test_state.substates)) == (
- "child_state2",
- "child_state3",
- )
- # Set a value on child_state2, should update cached var in grandchild_state2
- child_state2 = new_test_state.get_substate(("child_state2",))
- child_state2.value = "set_c2_value"
- assert new_test_state.get_delta() == {
- TestState.get_full_name(): {
- "sum": 3.14,
- "upper": "",
- },
- ChildState2.get_full_name(): {
- "value": "set_c2_value",
- },
- GrandchildState2.get_full_name(): {
- "cached": "set_c2_value",
- },
- GrandchildState3.get_full_name(): {
- "computed": "",
- },
- }
- @pytest.mark.asyncio
- async def test_get_state_from_sibling_not_cached(mock_app: rx.App, token: str):
- """A test simulating update_vars_internal when setting cookies with computed vars.
- In that case, a sibling state, UpdateVarsInternalState handles the fetching
- of states that need to have values set. Only the states that have a computed
- var are pre-fetched (like Child3 in this test), so `get_state` needs to
- avoid refetching those already-cached states when getting substates,
- otherwise the set values will be overridden by the freshly deserialized
- version and lost.
- Explicit regression test for https://github.com/reflex-dev/reflex/issues/2851.
- Args:
- mock_app: An app that will be returned by `get_app()`
- token: A token.
- """
- class Parent(BaseState):
- """A root state like rx.State."""
- parent_var: int = 0
- class Child(Parent):
- """A state simulating UpdateVarsInternalState."""
- pass
- class Child2(Parent):
- """An unconnected child state."""
- pass
- class Child3(Parent):
- """A child state with a computed var causing it to be pre-fetched.
- If child3_var gets set to a value, and `get_state` erroneously
- re-fetches it from redis, the value will be lost.
- """
- child3_var: int = 0
- @rx.var
- def v(self):
- pass
- class Grandchild3(Child3):
- """An extra layer of substate to catch an issue discovered in
- _determine_missing_parent_states while writing the regression test where
- invalid parent state names were being constructed.
- """
- pass
- class GreatGrandchild3(Grandchild3):
- """Fetching this state wants to also fetch Child3 as a missing parent.
- However, Child3 should already be cached in the state tree because it
- has a computed var.
- """
- pass
- mock_app.state_manager.state = mock_app.state = Parent
- # Get the top level state via unconnected sibling.
- root = await mock_app.state_manager.get_state(_substate_key(token, Child))
- # Set value in parent_var to assert it does not get refetched later.
- root.parent_var = 1
- if isinstance(mock_app.state_manager, StateManagerRedis):
- # When redis is used, only states with computed vars are pre-fetched.
- assert "child2" not in root.substates
- assert "child3" in root.substates # (due to @rx.var)
- # Get the unconnected sibling state, which will be used to `get_state` other instances.
- child = root.get_substate(Child.get_full_name().split("."))
- # Get an uncached child state.
- child2 = await child.get_state(Child2)
- assert child2.parent_var == 1
- # Set value on already-cached Child3 state (prefetched because it has a Computed Var).
- child3 = await child.get_state(Child3)
- child3.child3_var = 1
- # Get uncached great_grandchild3 state.
- great_grandchild3 = await child.get_state(GreatGrandchild3)
- # Assert that we didn't re-fetch the parent and child3 state from redis
- assert great_grandchild3.parent_var == 1
- assert great_grandchild3.child3_var == 1
- # Save a reference to the rx.State to shadow the name State for testing.
- RxState = State
- def test_potentially_dirty_substates():
- """Test that potentially_dirty_substates returns the correct substates.
- Even if the name "State" is shadowed, it should still work correctly.
- """
- class State(RxState):
- @ComputedVar
- def foo(self) -> str:
- return ""
- class C1(State):
- @ComputedVar
- def bar(self) -> str:
- return ""
- assert RxState._potentially_dirty_substates() == {State}
- assert State._potentially_dirty_substates() == {C1}
- assert C1._potentially_dirty_substates() == set()
- @pytest.mark.asyncio
- async def test_setvar(mock_app: rx.App, token: str):
- """Test that setvar works correctly.
- Args:
- mock_app: An app that will be returned by `get_app()`
- token: A token.
- """
- state = await mock_app.state_manager.get_state(_substate_key(token, TestState))
- # Set Var in same state (with Var type casting)
- for event in rx.event.fix_events(
- [TestState.setvar("num1", 42), TestState.setvar("num2", "4.2")], token
- ):
- async for update in state._process(event):
- print(update)
- assert state.num1 == 42
- assert state.num2 == 4.2
- # Set Var in parent state
- for event in rx.event.fix_events([GrandchildState.setvar("array", [43])], token):
- async for update in state._process(event):
- print(update)
- assert state.array == [43]
- # Cannot setvar for non-existant var
- with pytest.raises(AttributeError):
- TestState.setvar("non_existant_var")
- # Cannot setvar for computed vars
- with pytest.raises(AttributeError):
- TestState.setvar("sum")
- # Cannot setvar with non-string
- with pytest.raises(ValueError):
- TestState.setvar(42, 42)
|