tour 02 relationships lite

%23%20%2F%2F%2F%20script%0A%23%20requires-python%20%3D%20%22%3E%3D3.12%22%0A%23%20dependencies%20%3D%20%5B%22marimo%22%5D%0A%23%20%2F%2F%2F%0A%22%22%22SQLer%20Lite%20Tour%3A%20Relationships%20-%20Works%20in%20Pyodide%2FWASM!%22%22%22%0A%0Aimport%20marimo%0A%0A__generated_with%20%3D%20%220.20.4%22%0Aapp%20%3D%20marimo.App(width%3D%22medium%22)%0A%0A%0A%40app.cell%0Adef%20_()%3A%0A%20%20%20%20%23%20---%20marimo%20scaffolding%20(please%20ignore)%20---%0A%20%20%20%20import%20marimo%20as%20mo%0A%0A%20%20%20%20return%20(mo%2C)%0A%0A%0A%40app.cell%0Aasync%20def%20_()%3A%0A%20%20%20%20%23%20---%20WASM%20scaffolding%20(please%20ignore)%20---%0A%20%20%20%20%23%20Loads%20sqlite3%20%2B%20sqler%20in%20Pyodide%2Fbrowser%20environments.%0A%20%20%20%20%23%20Not%20needed%20when%20running%20locally%20with%20%60marimo%20edit%60.%0A%20%20%20%20import%20sys%0A%0A%20%20%20%20pyodide_sqlite3_ready%20%3D%20True%0A%20%20%20%20sqler_ready%20%3D%20True%0A%20%20%20%20if%20sys.platform%20%3D%3D%20%22emscripten%22%3A%0A%20%20%20%20%20%20%20%20pyodide_sqlite3_ready%20%3D%20False%0A%20%20%20%20%20%20%20%20sqler_ready%20%3D%20False%0A%20%20%20%20%20%20%20%20try%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20import%20pyodide%0A%0A%20%20%20%20%20%20%20%20%20%20%20%20await%20pyodide.loadPackage(%22sqlite3%22)%0A%20%20%20%20%20%20%20%20%20%20%20%20pyodide_sqlite3_ready%20%3D%20True%0A%20%20%20%20%20%20%20%20except%20Exception%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20try%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20import%20js%0A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20await%20js.pyodide.loadPackage(%22sqlite3%22)%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20pyodide_sqlite3_ready%20%3D%20True%0A%20%20%20%20%20%20%20%20%20%20%20%20except%20Exception%20as%20exc%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20print(%22Failed%20to%20load%20sqlite3%20in%20Pyodide%3A%22%2C%20exc)%0A%0A%20%20%20%20%20%20%20%20import%20importlib.util%20as%20importlib_util%0A%0A%20%20%20%20%20%20%20%20if%20importlib_util.find_spec(%22sqler%22)%20is%20not%20None%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20sqler_ready%20%3D%20True%0A%20%20%20%20%20%20%20%20else%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20try%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20import%20micropip%0A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20await%20micropip.install(%22sqler%22)%0A%20%20%20%20%20%20%20%20%20%20%20%20except%20Exception%20as%20exc%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20print(%22Failed%20to%20install%20sqler%20in%20Pyodide%3A%22%2C%20exc)%0A%20%20%20%20%20%20%20%20%20%20%20%20else%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20if%20importlib_util.find_spec(%22sqler%22)%20is%20not%20None%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20sqler_ready%20%3D%20True%0A%20%20%20%20return%20pyodide_sqlite3_ready%2C%20sqler_ready%0A%0A%0A%40app.cell%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%20SQLer%20Lite%20Tour%3A%20Relationships%0A%0A%20%20%20%20This%20notebook%20covers%20how%20to%20define%20and%20work%20with%20relationships%20between%20models%0A%20%20%20%20in%20SQLer%20Lite%20(Pyodide%2FWASM%20compatible).%20You'll%20learn%3A%0A%0A%20%20%20%201.%20Defining%20relationships%20between%20models%0A%20%20%20%202.%20Saving%20related%20models%0A%20%20%20%203.%20Automatic%20hydration%20(loading%20related%20data)%0A%20%20%20%204.%20Working%20with%20references%0A%0A%20%20%20%20Let's%20get%20started!%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%201.%20Setting%20Up%0A%0A%20%20%20%20We'll%20create%20a%20database%20and%20define%20two%20related%20models%3A%20%60Author%60%20and%20%60Book%60.%0A%20%20%20%20A%20book%20has%20an%20author%20(many-to-one%20relationship).%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(pyodide_sqlite3_ready%2C%20sqler_ready)%3A%0A%20%20%20%20if%20not%20pyodide_sqlite3_ready%3A%0A%20%20%20%20%20%20%20%20raise%20RuntimeError(%0A%20%20%20%20%20%20%20%20%20%20%20%20%22sqlite3%20is%20required%20in%20Pyodide%3B%20failed%20to%20load%20package%20'sqlite3'.%22%0A%20%20%20%20%20%20%20%20)%0A%20%20%20%20if%20not%20sqler_ready%3A%0A%20%20%20%20%20%20%20%20raise%20RuntimeError(%0A%20%20%20%20%20%20%20%20%20%20%20%20%22sqler%20is%20required%20in%20Pyodide%3B%20failed%20to%20install%20sqler%20wheel.%22%0A%20%20%20%20%20%20%20%20)%0A%0A%20%20%20%20import%20importlib%0A%20%20%20%20from%20dataclasses%20import%20dataclass%0A%20%20%20%20from%20typing%20import%20Optional%0A%0A%20%20%20%20_sqler%20%3D%20importlib.import_module(%22sqler%22)%0A%20%20%20%20F%20%3D%20_sqler.F%0A%20%20%20%20SQLerDB%20%3D%20_sqler.SQLerDB%0A%20%20%20%20SQLerLiteModel%20%3D%20_sqler.SQLerLiteModel%0A%0A%20%20%20%20db%20%3D%20SQLerDB.in_memory()%0A%20%20%20%20print(%22Database%20connected!%22)%0A%20%20%20%20return%20Optional%2C%20SQLerLiteModel%2C%20dataclass%2C%20db%0A%0A%0A%40app.cell%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%202.%20Defining%20Related%20Models%0A%0A%20%20%20%20To%20create%20a%20relationship%2C%20simply%20use%20one%20model%20as%20a%20type%20hint%20in%20another.%0A%20%20%20%20SQLer%20stores%20a%20reference%20(the%20related%20model's%20%60_id%60)%20and%20automatically%0A%20%20%20%20hydrates%20(loads)%20the%20full%20object%20when%20you%20query.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(Optional%2C%20SQLerLiteModel%2C%20dataclass%2C%20db)%3A%0A%20%20%20%20%40dataclass%0A%20%20%20%20class%20Author(SQLerLiteModel)%3A%0A%20%20%20%20%20%20%20%20__tablename__%20%3D%20%22authors%22%0A%20%20%20%20%20%20%20%20name%3A%20str%0A%20%20%20%20%20%20%20%20country%3A%20str%0A%0A%20%20%20%20%40dataclass%0A%20%20%20%20class%20Book(SQLerLiteModel)%3A%0A%20%20%20%20%20%20%20%20__tablename__%20%3D%20%22books%22%0A%20%20%20%20%20%20%20%20title%3A%20str%0A%20%20%20%20%20%20%20%20year%3A%20int%0A%20%20%20%20%20%20%20%20author%3A%20Optional%5BAuthor%5D%20%3D%20None%20%20%23%20Relationship%20to%20Author%0A%0A%20%20%20%20%23%20Register%20both%20models%0A%20%20%20%20Author.set_db(db)%0A%20%20%20%20Book.set_db(db)%0A%20%20%20%20print(%22Models%20registered!%22)%0A%20%20%20%20return%20Author%2C%20Book%0A%0A%0A%40app.cell%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%203.%20Creating%20Related%20Data%0A%0A%20%20%20%20When%20you%20save%20a%20model%20with%20a%20relationship%2C%20SQLer%20stores%20just%20the%20reference%0A%20%20%20%20(the%20%60_id%60%20of%20the%20related%20model).%20The%20related%20model%20must%20be%20saved%20first.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(Author%2C%20Book)%3A%0A%20%20%20%20%23%20Create%20and%20save%20authors%20first%0A%20%20%20%20alice%20%3D%20Author(name%3D%22Alice%20Smith%22%2C%20country%3D%22USA%22)%0A%20%20%20%20alice.save()%0A%0A%20%20%20%20bob%20%3D%20Author(name%3D%22Bob%20Jones%22%2C%20country%3D%22UK%22)%0A%20%20%20%20bob.save()%0A%0A%20%20%20%20print(f%22Created%20authors%3A%20Alice%20(id%3D%7Balice._id%7D)%2C%20Bob%20(id%3D%7Bbob._id%7D)%22)%0A%0A%20%20%20%20%23%20Now%20create%20books%20with%20author%20relationships%0A%20%20%20%20book1%20%3D%20Book(title%3D%22Python%20Mastery%22%2C%20year%3D2023%2C%20author%3Dalice)%0A%20%20%20%20book1.save()%0A%0A%20%20%20%20book2%20%3D%20Book(title%3D%22Web%20Development%22%2C%20year%3D2024%2C%20author%3Dalice)%0A%20%20%20%20book2.save()%0A%0A%20%20%20%20book3%20%3D%20Book(title%3D%22Database%20Design%22%2C%20year%3D2022%2C%20author%3Dbob)%0A%20%20%20%20book3.save()%0A%0A%20%20%20%20print(%22%5CnCreated%20books%3A%22)%0A%20%20%20%20print(f%22%20%20-%20%7Bbook1.title%7D%20by%20%7Bbook1.author.name%7D%22)%0A%20%20%20%20print(f%22%20%20-%20%7Bbook2.title%7D%20by%20%7Bbook2.author.name%7D%22)%0A%20%20%20%20print(f%22%20%20-%20%7Bbook3.title%7D%20by%20%7Bbook3.author.name%7D%22)%0A%20%20%20%20return%20alice%2C%20book1%0A%0A%0A%40app.cell%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%204.%20Automatic%20Hydration%0A%0A%20%20%20%20When%20you%20query%20for%20books%2C%20SQLer%20automatically%20%22hydrates%22%20the%20relationships%2C%0A%20%20%20%20loading%20the%20full%20%60Author%60%20object%20instead%20of%20just%20the%20ID%20reference.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(Book)%3A%0A%20%20%20%20%23%20Query%20all%20books%20-%20relationships%20are%20automatically%20hydrated%0A%20%20%20%20all_books%20%3D%20Book.all()%0A%0A%20%20%20%20print(%22All%20books%20with%20hydrated%20authors%3A%22)%0A%20%20%20%20for%20_b%20in%20all_books%3A%0A%20%20%20%20%20%20%20%20author_name%20%3D%20_b.author.name%20if%20_b.author%20else%20%22Unknown%22%0A%20%20%20%20%20%20%20%20author_country%20%3D%20_b.author.country%20if%20_b.author%20else%20%22%3F%22%0A%20%20%20%20%20%20%20%20print(f%22%20%20'%7B_b.title%7D'%20(%7B_b.year%7D)%20by%20%7Bauthor_name%7D%20from%20%7Bauthor_country%7D%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%205.%20How%20References%20Work%0A%0A%20%20%20%20Under%20the%20hood%2C%20SQLer%20stores%20relationships%20as%20reference%20dictionaries%20with%0A%20%20%20%20the%20table%20name%20and%20ID.%20Let's%20peek%20at%20the%20raw%20data.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(db)%3A%0A%20%20%20%20import%20json%0A%0A%20%20%20%20%23%20Look%20at%20the%20raw%20data%20in%20the%20database%0A%20%20%20%20raw%20%3D%20db.adapter.execute(%22SELECT%20_id%2C%20data%20FROM%20books%20LIMIT%201%22).fetchone()%0A%20%20%20%20data%20%3D%20json.loads(raw%5B1%5D)%0A%20%20%20%20print(%22Raw%20book%20data%20in%20database%3A%22)%0A%20%20%20%20print(json.dumps(data%2C%20indent%3D2))%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20Notice%20the%20%60author%60%20field%20contains%20%60%7B%22_table%22%3A%20%22authors%22%2C%20%22_id%22%3A%201%7D%60%20-%20this%0A%20%20%20%20is%20the%20reference%20format%20SQLer%20uses.%20When%20you%20query%2C%20it%20automatically%20looks%0A%20%20%20%20up%20this%20reference%20and%20replaces%20it%20with%20the%20full%20Author%20object.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%206.%20Loading%20Individual%20Records%0A%0A%20%20%20%20When%20you%20load%20a%20book%20by%20ID%2C%20relationships%20are%20automatically%20resolved%3A%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(Book%2C%20book1)%3A%0A%20%20%20%20%23%20Load%20a%20book%20by%20ID%0A%20%20%20%20loaded_book%20%3D%20Book.from_id(book1._id)%0A%20%20%20%20print(f%22Loaded%20book%3A%20%7Bloaded_book.title%7D%22)%0A%20%20%20%20print(f%22%20%20Author%3A%20%7Bloaded_book.author.name%7D%22)%0A%20%20%20%20print(f%22%20%20Author's%20country%3A%20%7Bloaded_book.author.country%7D%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%207.%20Updating%20Related%20Data%0A%0A%20%20%20%20When%20you%20update%20a%20related%20model%20and%20save%20it%2C%20you%20need%20to%20call%20%60.refresh()%60%0A%20%20%20%20on%20the%20parent%20model%20to%20see%20the%20changes%3A%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(alice%2C%20book1)%3A%0A%20%20%20%20print(f%22Before%3A%20%7Bbook1.author.name%7D%22)%0A%0A%20%20%20%20%23%20Update%20the%20author%0A%20%20%20%20alice.name%20%3D%20%22Alice%20Smith-Johnson%22%0A%20%20%20%20alice.save()%0A%0A%20%20%20%20%23%20The%20book%20still%20has%20the%20old%20data%20in%20memory%0A%20%20%20%20print(f%22Book%20still%20shows%3A%20%7Bbook1.author.name%7D%22)%0A%0A%20%20%20%20%23%20Refresh%20the%20book%20to%20get%20updated%20data%0A%20%20%20%20book1.refresh()%0A%20%20%20%20print(f%22After%20refresh%3A%20%7Bbook1.author.name%7D%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%208.%20Multiple%20Relationships%0A%0A%20%20%20%20Models%20can%20have%20multiple%20relationships.%20Let's%20add%20a%20%60Publisher%60%20model%3A%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(Author%2C%20Optional%2C%20SQLerLiteModel%2C%20dataclass%2C%20db)%3A%0A%20%20%20%20%40dataclass%0A%20%20%20%20class%20Publisher(SQLerLiteModel)%3A%0A%20%20%20%20%20%20%20%20__tablename__%20%3D%20%22publishers%22%0A%20%20%20%20%20%20%20%20name%3A%20str%0A%20%20%20%20%20%20%20%20location%3A%20str%0A%0A%20%20%20%20%40dataclass%0A%20%20%20%20class%20Magazine(SQLerLiteModel)%3A%0A%20%20%20%20%20%20%20%20__tablename__%20%3D%20%22magazines%22%0A%20%20%20%20%20%20%20%20title%3A%20str%0A%20%20%20%20%20%20%20%20issue%3A%20int%0A%20%20%20%20%20%20%20%20editor%3A%20Optional%5BAuthor%5D%20%3D%20None%0A%20%20%20%20%20%20%20%20publisher%3A%20Optional%5BPublisher%5D%20%3D%20None%0A%0A%20%20%20%20Publisher.set_db(db)%0A%20%20%20%20Magazine.set_db(db)%0A%0A%20%20%20%20%23%20Create%20data%0A%20%20%20%20pub%20%3D%20Publisher(name%3D%22TechMedia%22%2C%20location%3D%22San%20Francisco%22)%0A%20%20%20%20pub.save()%0A%0A%20%20%20%20%23%20Reuse%20existing%20author%20as%20editor%0A%20%20%20%20editor%20%3D%20Author.from_id(1)%20%20%23%20Alice%0A%0A%20%20%20%20mag%20%3D%20Magazine(title%3D%22Code%20Weekly%22%2C%20issue%3D42%2C%20editor%3Deditor%2C%20publisher%3Dpub)%0A%20%20%20%20mag.save()%0A%0A%20%20%20%20print(f%22Created%20magazine%3A%20%7Bmag.title%7D%20%23%7Bmag.issue%7D%22)%0A%20%20%20%20print(f%22%20%20Editor%3A%20%7Bmag.editor.name%7D%22)%0A%20%20%20%20print(f%22%20%20Publisher%3A%20%7Bmag.publisher.name%7D%20(%7Bmag.publisher.location%7D)%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%209.%20Self-Referential%20Relationships%0A%0A%20%20%20%20Models%20can%20even%20reference%20themselves%20(e.g.%2C%20for%20tree%20structures)%3A%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(Optional%2C%20SQLerLiteModel%2C%20dataclass%2C%20db)%3A%0A%20%20%20%20%40dataclass%0A%20%20%20%20class%20Category(SQLerLiteModel)%3A%0A%20%20%20%20%20%20%20%20__tablename__%20%3D%20%22categories%22%0A%20%20%20%20%20%20%20%20name%3A%20str%0A%20%20%20%20%20%20%20%20parent%3A%20Optional%5B%22Category%22%5D%20%3D%20None%0A%0A%20%20%20%20Category.set_db(db)%0A%0A%20%20%20%20%23%20Create%20a%20category%20tree%0A%20%20%20%20root%20%3D%20Category(name%3D%22Electronics%22)%0A%20%20%20%20root.save()%0A%0A%20%20%20%20computers%20%3D%20Category(name%3D%22Computers%22%2C%20parent%3Droot)%0A%20%20%20%20computers.save()%0A%0A%20%20%20%20laptops%20%3D%20Category(name%3D%22Laptops%22%2C%20parent%3Dcomputers)%0A%20%20%20%20laptops.save()%0A%0A%20%20%20%20print(%22Category%20hierarchy%3A%22)%0A%20%20%20%20print(f%22%20%20%7Broot.name%7D%22)%0A%20%20%20%20print(f%22%20%20%20%20-%20%7Bcomputers.name%7D%22)%0A%20%20%20%20print(f%22%20%20%20%20%20%20%20%20-%20%7Blaptops.name%7D%22)%0A%0A%20%20%20%20%23%20Verify%20relationships%20work%0A%20%20%20%20fetched%20%3D%20Category.from_id(laptops._id)%0A%20%20%20%20print(f%22%5CnFetched%20'%7Bfetched.name%7D'%2C%20parent%20is%20'%7Bfetched.parent.name%7D'%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%23%20Summary%0A%0A%20%20%20%20You've%20learned%20how%20to%20work%20with%20relationships%20in%20SQLer%20Lite%3A%0A%0A%20%20%20%20%7C%20Concept%20%7C%20How%20To%20%7C%0A%20%20%20%20%7C---------%7C--------%7C%0A%20%20%20%20%7C%20Define%20relationship%20%7C%20Use%20related%20model%20as%20type%20hint%3A%20%60author%3A%20Optional%5BAuthor%5D%20%3D%20None%60%20%7C%0A%20%20%20%20%7C%20Save%20related%20%7C%20Save%20child%20first%2C%20then%20parent%20with%20reference%20%7C%0A%20%20%20%20%7C%20Auto%20hydration%20%7C%20Relationships%20are%20loaded%20automatically%20%7C%0A%20%20%20%20%7C%20Update%20related%20%7C%20Modify%20%2B%20save%20related%2C%20then%20%60.refresh()%60%20parent%20%7C%0A%0A%20%20%20%20**Key%20difference%20from%20Pydantic%20version%3A**%0A%20%20%20%20-%20Use%20%60%40dataclass%60%20decorator%20on%20your%20model%20classes%0A%20%20%20%20-%20Use%20%60Optional%5BModelType%5D%60%20for%20nullable%20relationships%0A%20%20%20%20-%20Works%20identically%20otherwise!%0A%0A%20%20%20%20**Next%20up%3A**%20Tour%2003%20covers%20Safe%20Models%20with%20optimistic%20locking!%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(db)%3A%0A%20%20%20%20db.close()%0A%20%20%20%20print(%22Database%20closed!%22)%0A%20%20%20%20return%0A%0A%0Aif%20__name__%20%3D%3D%20%22__main__%22%3A%0A%20%20%20%20app.run()%0A