tour 05 mixins

%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%22sqler%22%2C%20%22marimo%22%5D%0A%23%20%2F%2F%2F%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%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%20SQLer%20Tour%3A%20Mixins%0A%0A%20%20%20%20This%20notebook%20covers%20SQLer's%20built-in%20mixins%20that%20add%20common%20functionality%0A%20%20%20%20to%20your%20models%20without%20writing%20boilerplate%20code.%0A%0A%20%20%20%20You'll%20learn%3A%0A%0A%20%20%20%201.%20%60TimestampMixin%60%20-%20Automatic%20created_at%2Fupdated_at%20fields%0A%20%20%20%202.%20%60SoftDeleteMixin%60%20-%20Soft%20delete%20instead%20of%20permanent%20deletion%0A%20%20%20%203.%20%60HooksMixin%60%20-%20Lifecycle%20hooks%20(before%2Fafter%20save%2Fdelete)%0A%20%20%20%204.%20%60FullMixin%60%20-%20All%20mixins%20combined%0A%0A%20%20%20%20Let's%20explore!%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%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_()%3A%0A%20%20%20%20from%20datetime%20import%20datetime%2C%20timezone%0A%0A%20%20%20%20from%20sqler%20import%20SQLerDB%2C%20SQLerModel%0A%20%20%20%20from%20sqler.models%20import%20FullMixin%2C%20HooksMixin%2C%20SoftDeleteMixin%2C%20TimestampMixin%0A%20%20%20%20from%20sqler.models.mixins%20import%20AuditLogMixin%2C%20AuditMixin%0A%20%20%20%20from%20sqler.query%20import%20SQLerField%20as%20F%0A%0A%20%20%20%20db%20%3D%20SQLerDB.in_memory()%0A%20%20%20%20print(%22Database%20connected!%22)%0A%20%20%20%20print(%22%5CnAvailable%20mixins%3A%22)%0A%20%20%20%20print(%22%20%20-%20TimestampMixin%3A%20created_at%2C%20updated_at%22)%0A%20%20%20%20print(%22%20%20-%20SoftDeleteMixin%3A%20soft%20delete%20with%20deleted_at%22)%0A%20%20%20%20print(%22%20%20-%20HooksMixin%3A%20before_save%2C%20after_save%2C%20before_delete%2C%20after_delete%22)%0A%20%20%20%20print(%22%20%20-%20FullMixin%3A%20all%20of%20the%20above%20combined%22)%0A%20%20%20%20print(%22%20%20-%20AuditMixin%3A%20track%20created_by%2C%20updated_by%22)%0A%20%20%20%20print(%22%20%20-%20AuditLogMixin%3A%20full%20change%20history%20logging%22)%0A%20%20%20%20return%20(%0A%20%20%20%20%20%20%20%20AuditLogMixin%2C%0A%20%20%20%20%20%20%20%20AuditMixin%2C%0A%20%20%20%20%20%20%20%20F%2C%0A%20%20%20%20%20%20%20%20FullMixin%2C%0A%20%20%20%20%20%20%20%20HooksMixin%2C%0A%20%20%20%20%20%20%20%20SQLerModel%2C%0A%20%20%20%20%20%20%20%20SoftDeleteMixin%2C%0A%20%20%20%20%20%20%20%20TimestampMixin%2C%0A%20%20%20%20%20%20%20%20datetime%2C%0A%20%20%20%20%20%20%20%20db%2C%0A%20%20%20%20%20%20%20%20timezone%2C%0A%20%20%20%20)%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.%20TimestampMixin%0A%0A%20%20%20%20Adds%20%60created_at%60%20and%20%60updated_at%60%20fields%20to%20track%20when%20records%20are%0A%20%20%20%20created%20and%20modified.%20You%20need%20to%20set%20these%20in%20your%20%60save()%60%20override%3A%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(SQLerModel%2C%20TimestampMixin%2C%20datetime%2C%20db%2C%20timezone)%3A%0A%20%20%20%20from%20typing%20import%20Self%0A%0A%20%20%20%20class%20Post(TimestampMixin%2C%20SQLerModel)%3A%0A%20%20%20%20%20%20%20%20_table%20%3D%20%22posts%22%0A%20%20%20%20%20%20%20%20title%3A%20str%0A%20%20%20%20%20%20%20%20content%3A%20str%0A%0A%20%20%20%20%20%20%20%20def%20save(self)%20-%3E%20Self%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%22%22%22Override%20save%20to%20set%20timestamps%20automatically.%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20now%20%3D%20datetime.now(timezone.utc)%0A%20%20%20%20%20%20%20%20%20%20%20%20if%20self._id%20is%20None%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20self.created_at%20%3D%20now%0A%20%20%20%20%20%20%20%20%20%20%20%20self.updated_at%20%3D%20now%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20super().save()%0A%0A%20%20%20%20Post.set_db(db)%0A%20%20%20%20print(%22Post%20model%20with%20TimestampMixin%20ready!%22)%0A%20%20%20%20return%20(Post%2C)%0A%0A%0A%40app.cell%0Adef%20_(Post)%3A%0A%20%20%20%20import%20time%0A%0A%20%20%20%20%23%20Create%20a%20post%0A%20%20%20%20post%20%3D%20Post(title%3D%22Hello%20World%22%2C%20content%3D%22My%20first%20post%22)%0A%20%20%20%20post.save()%0A%0A%20%20%20%20print(f%22Created%20post%3A%20'%7Bpost.title%7D'%22)%0A%20%20%20%20print(f%22%20%20created_at%3A%20%7Bpost.created_at%7D%22)%0A%20%20%20%20print(f%22%20%20updated_at%3A%20%7Bpost.updated_at%7D%22)%0A%0A%20%20%20%20%23%20Wait%20a%20moment%20and%20update%0A%20%20%20%20time.sleep(0.1)%0A%20%20%20%20post.content%20%3D%20%22Updated%20content!%22%0A%20%20%20%20post.save()%0A%0A%20%20%20%20print(%22%5CnAfter%20update%3A%22)%0A%20%20%20%20print(f%22%20%20created_at%3A%20%7Bpost.created_at%7D%20(unchanged)%22)%0A%20%20%20%20print(f%22%20%20updated_at%3A%20%7Bpost.updated_at%7D%20(updated)%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%203.%20SoftDeleteMixin%0A%0A%20%20%20%20Instead%20of%20permanently%20deleting%20records%2C%20soft%20delete%20marks%20them%20as%20deleted%0A%20%20%20%20by%20setting%20a%20%60deleted_at%60%20timestamp.%20The%20data%20remains%20in%20the%20database%0A%20%20%20%20for%20audit%20trails%20or%20potential%20recovery.%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(SQLerModel%2C%20SoftDeleteMixin%2C%20db)%3A%0A%20%20%20%20class%20Document(SoftDeleteMixin%2C%20SQLerModel)%3A%0A%20%20%20%20%20%20%20%20_table%20%3D%20%22documents%22%0A%20%20%20%20%20%20%20%20name%3A%20str%0A%20%20%20%20%20%20%20%20content%3A%20str%0A%0A%20%20%20%20Document.set_db(db)%0A%20%20%20%20print(%22Document%20model%20with%20SoftDeleteMixin%20ready!%22)%0A%20%20%20%20print(%22%5CnSoftDeleteMixin%20provides%3A%22)%0A%20%20%20%20print(%22%20%20-%20deleted_at%3A%20Optional%5Bdatetime%5D%20field%22)%0A%20%20%20%20print(%22%20%20-%20is_deleted%3A%20property%20(True%20if%20deleted_at%20is%20set)%22)%0A%20%20%20%20print(%22%20%20-%20soft_delete()%3A%20Mark%20as%20deleted%22)%0A%20%20%20%20print(%22%20%20-%20restore()%3A%20Undelete%22)%0A%20%20%20%20print(%22%20%20-%20hard_delete()%3A%20Permanently%20delete%22)%0A%20%20%20%20return%20(Document%2C)%0A%0A%0A%40app.cell%0Adef%20_(Document%2C%20F)%3A%0A%20%20%20%20%23%20Create%20some%20documents%0A%20%20%20%20doc1%20%3D%20Document(name%3D%22report.pdf%22%2C%20content%3D%22Annual%20report%22).save()%0A%20%20%20%20doc2%20%3D%20Document(name%3D%22notes.txt%22%2C%20content%3D%22Meeting%20notes%22).save()%0A%20%20%20%20doc3%20%3D%20Document(name%3D%22draft.doc%22%2C%20content%3D%22Draft%20proposal%22).save()%0A%0A%20%20%20%20print(%22Created%203%20documents%22)%0A%20%20%20%20print(f%22Total%20in%20database%3A%20%7BDocument.query().count()%7D%22)%0A%0A%20%20%20%20%23%20Soft%20delete%20one%20document%0A%20%20%20%20doc2.soft_delete()%0A%20%20%20%20print(f%22%5CnSoft%20deleted%20'%7Bdoc2.name%7D'%22)%0A%20%20%20%20print(f%22%20%20is_deleted%3A%20%7Bdoc2.is_deleted%7D%22)%0A%20%20%20%20print(f%22%20%20deleted_at%3A%20%7Bdoc2.deleted_at%7D%22)%0A%0A%20%20%20%20%23%20The%20document%20still%20exists%20in%20the%20database!%0A%20%20%20%20print(f%22%5CnTotal%20in%20database%3A%20%7BDocument.query().count()%7D%22)%0A%0A%20%20%20%20%23%20Filter%20to%20get%20only%20active%20documents%0A%20%20%20%20active%20%3D%20Document.query().filter(F(%22deleted_at%22).is_null()).all()%0A%20%20%20%20print(f%22Active%20documents%3A%20%7B%5Bd.name%20for%20d%20in%20active%5D%7D%22)%0A%0A%20%20%20%20%23%20Filter%20to%20get%20only%20deleted%20documents%0A%20%20%20%20deleted%20%3D%20Document.query().filter(F(%22deleted_at%22).is_not_null()).all()%0A%20%20%20%20print(f%22Deleted%20documents%3A%20%7B%5Bd.name%20for%20d%20in%20deleted%5D%7D%22)%0A%20%20%20%20return%20(doc2%2C)%0A%0A%0A%40app.cell%0Adef%20_(Document%2C%20doc2)%3A%0A%20%20%20%20%23%20Restore%20a%20soft-deleted%20document%0A%20%20%20%20print(f%22Before%20restore%3A%20is_deleted%20%3D%20%7Bdoc2.is_deleted%7D%22)%0A%0A%20%20%20%20doc2.restore()%0A%0A%20%20%20%20print(f%22After%20restore%3A%20is_deleted%20%3D%20%7Bdoc2.is_deleted%7D%22)%0A%20%20%20%20print(f%22deleted_at%3A%20%7Bdoc2.deleted_at%7D%22)%0A%0A%20%20%20%20%23%20Now%20hard%20delete%20(permanent)%0A%20%20%20%20doc2.hard_delete()%0A%20%20%20%20print(f%22%5CnAfter%20hard_delete%3A%20Document%20count%20%3D%20%7BDocument.query().count()%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%204.%20HooksMixin%0A%0A%20%20%20%20Adds%20lifecycle%20hooks%20that%20are%20**automatically%20called**%20by%20%60save()%60%20and%20%60delete()%60%3A%0A%20%20%20%20-%20%60before_save()%60%20-%20Called%20before%20saving%2C%20return%20False%20to%20abort%0A%20%20%20%20-%20%60after_save()%60%20-%20Called%20after%20successful%20save%0A%20%20%20%20-%20%60before_delete()%60%20-%20Called%20before%20deleting%2C%20return%20False%20to%20abort%0A%20%20%20%20-%20%60after_delete()%60%20-%20Called%20after%20successful%20delete%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(HooksMixin%2C%20SQLerModel%2C%20db)%3A%0A%20%20%20%20class%20User(HooksMixin%2C%20SQLerModel)%3A%0A%20%20%20%20%20%20%20%20_table%20%3D%20%22users%22%0A%20%20%20%20%20%20%20%20name%3A%20str%0A%20%20%20%20%20%20%20%20email%3A%20str%0A%0A%20%20%20%20%20%20%20%20def%20before_save(self)%20-%3E%20bool%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%22%22%22Normalize%20email%20before%20saving.%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20original%20%3D%20self.email%0A%20%20%20%20%20%20%20%20%20%20%20%20self.email%20%3D%20self.email.lower().strip()%0A%20%20%20%20%20%20%20%20%20%20%20%20if%20original%20!%3D%20self.email%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20print(f%22%20%20%5Bbefore_save%5D%20Normalized%20email%3A%20%7Boriginal%7D%20-%3E%20%7Bself.email%7D%22)%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20True%20%20%23%20Continue%20with%20save%0A%0A%20%20%20%20%20%20%20%20def%20after_save(self)%20-%3E%20None%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%22%22%22Log%20after%20successful%20save.%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20print(f%22%20%20%5Bafter_save%5D%20Saved%20user%20%7Bself.name%7D%20(id%3D%7Bself._id%7D)%22)%0A%0A%20%20%20%20%20%20%20%20def%20before_delete(self)%20-%3E%20bool%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%22%22%22Confirm%20deletion.%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20print(f%22%20%20%5Bbefore_delete%5D%20About%20to%20delete%3A%20%7Bself.name%7D%22)%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20True%20%20%23%20Continue%20with%20delete%0A%0A%20%20%20%20%20%20%20%20def%20after_delete(self)%20-%3E%20None%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%22%22%22Log%20after%20deletion.%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20print(f%22%20%20%5Bafter_delete%5D%20Deleted%20user%20%7Bself.name%7D%22)%0A%0A%20%20%20%20User.set_db(db)%0A%20%20%20%20print(%22User%20model%20with%20HooksMixin%20ready!%22)%0A%20%20%20%20return%20(User%2C)%0A%0A%0A%40app.cell%0Adef%20_(User)%3A%0A%20%20%20%20print(%22Creating%20user%20with%20messy%20email...%22)%0A%20%20%20%20user%20%3D%20User(name%3D%22Alice%22%2C%20email%3D%22%20%20ALICE%40Example.COM%20%20%22)%0A%20%20%20%20user.save()%20%20%23%20Hooks%20are%20called%20automatically!%0A%0A%20%20%20%20print(f%22%5CnFinal%20email%3A%20%7Buser.email%7D%22)%0A%20%20%20%20return%20(user%2C)%0A%0A%0A%40app.cell%0Adef%20_(user)%3A%0A%20%20%20%20print(%22%5CnDeleting%20user...%22)%0A%20%20%20%20user.delete()%20%20%23%20Delete%20hooks%20are%20called%20automatically!%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.%20Aborting%20Operations%20with%20Hooks%0A%0A%20%20%20%20Return%20%60False%60%20from%20%60before_save%60%20or%20%60before_delete%60%20to%20abort%20the%20operation%3A%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(HooksMixin%2C%20SQLerModel%2C%20db)%3A%0A%20%20%20%20class%20ProtectedRecord(HooksMixin%2C%20SQLerModel)%3A%0A%20%20%20%20%20%20%20%20_table%20%3D%20%22protected_records%22%0A%20%20%20%20%20%20%20%20data%3A%20str%0A%20%20%20%20%20%20%20%20locked%3A%20bool%20%3D%20False%0A%0A%20%20%20%20%20%20%20%20def%20before_delete(self)%20-%3E%20bool%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%22%22%22Prevent%20deletion%20of%20locked%20records.%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20if%20self.locked%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20print(%22%20%20%5Bbefore_delete%5D%20BLOCKED%3A%20Record%20is%20locked!%22)%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20return%20False%20%20%23%20Abort%20the%20delete%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20True%0A%0A%20%20%20%20ProtectedRecord.set_db(db)%0A%0A%20%20%20%20%23%20Create%20a%20locked%20record%0A%20%20%20%20_record%20%3D%20ProtectedRecord(data%3D%22Important%20data%22%2C%20locked%3DTrue).save()%0A%20%20%20%20print(f%22Created%20locked%20record%3A%20%7B_record.data%7D%22)%0A%0A%20%20%20%20%23%20Try%20to%20delete%20it%0A%20%20%20%20print(%22%5CnAttempting%20to%20delete%20locked%20record...%22)%0A%20%20%20%20try%3A%0A%20%20%20%20%20%20%20%20_record.delete()%20%20%23%20This%20will%20be%20blocked%0A%20%20%20%20%20%20%20%20print(%22Deleted%20(unexpected!)%22)%0A%20%20%20%20except%20RuntimeError%20as%20_e%3A%0A%20%20%20%20%20%20%20%20print(f%22Delete%20blocked%3A%20%7B_e%7D%22)%0A%0A%20%20%20%20%23%20Verify%20it%20still%20exists%0A%20%20%20%20_still_exists%20%3D%20ProtectedRecord.from_id(_record._id)%0A%20%20%20%20print(f%22Record%20still%20exists%3A%20%7B_still_exists%20is%20not%20None%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%206.%20FullMixin%3A%20All%20Combined%0A%0A%20%20%20%20%60FullMixin%60%20combines%20all%20three%20mixins%20for%20maximum%20functionality%3A%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(FullMixin%2C%20SQLerModel%2C%20datetime%2C%20db%2C%20timezone)%3A%0A%0A%20%20%20%20class%20Task(FullMixin%2C%20SQLerModel)%3A%0A%20%20%20%20%20%20%20%20_table%20%3D%20%22tasks%22%0A%20%20%20%20%20%20%20%20title%3A%20str%0A%20%20%20%20%20%20%20%20description%3A%20str%20%3D%20%22%22%0A%20%20%20%20%20%20%20%20priority%3A%20int%20%3D%200%0A%0A%20%20%20%20%20%20%20%20def%20before_save(self)%20-%3E%20bool%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%22%22%22Set%20timestamps%20in%20before_save%20hook.%22%22%22%0A%20%20%20%20%20%20%20%20%20%20%20%20now%20%3D%20datetime.now(timezone.utc)%0A%20%20%20%20%20%20%20%20%20%20%20%20if%20self._id%20is%20None%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20self.created_at%20%3D%20now%0A%20%20%20%20%20%20%20%20%20%20%20%20self.updated_at%20%3D%20now%0A%20%20%20%20%20%20%20%20%20%20%20%20print(f%22%20%20%5Bbefore_save%5D%20Task%3A%20%7Bself.title%7D%22)%0A%20%20%20%20%20%20%20%20%20%20%20%20return%20True%0A%0A%20%20%20%20%20%20%20%20def%20after_save(self)%20-%3E%20None%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20print(f%22%20%20%5Bafter_save%5D%20Saved%20with%20id%3D%7Bself._id%7D%22)%0A%0A%20%20%20%20Task.set_db(db)%0A%20%20%20%20print(%22Task%20model%20with%20FullMixin%20ready!%22)%0A%20%20%20%20print(%22%5CnFullMixin%20provides%3A%22)%0A%20%20%20%20print(%22%20%20-%20TimestampMixin%3A%20created_at%2C%20updated_at%22)%0A%20%20%20%20print(%22%20%20-%20SoftDeleteMixin%3A%20soft_delete()%2C%20restore()%2C%20hard_delete()%22)%0A%20%20%20%20print(%22%20%20-%20HooksMixin%3A%20before%2Fafter%20save%2Fdelete%20hooks%22)%0A%20%20%20%20return%20(Task%2C)%0A%0A%0A%40app.cell%0Adef%20_(Task)%3A%0A%20%20%20%20%23%20Create%20a%20task%0A%20%20%20%20task%20%3D%20Task(title%3D%22Learn%20SQLer%22%2C%20description%3D%22Complete%20all%20tutorials%22%2C%20priority%3D1)%0A%20%20%20%20task.save()%0A%0A%20%20%20%20print(f%22%5CnTask%3A%20%7Btask.title%7D%22)%0A%20%20%20%20print(f%22%20%20priority%3A%20%7Btask.priority%7D%22)%0A%20%20%20%20print(f%22%20%20created_at%3A%20%7Btask.created_at%7D%22)%0A%20%20%20%20print(f%22%20%20is_deleted%3A%20%7Btask.is_deleted%7D%22)%0A%0A%20%20%20%20%23%20Soft%20delete%20the%20task%0A%20%20%20%20print(%22%5CnSoft%20deleting%20task...%22)%0A%20%20%20%20task.soft_delete()%0A%20%20%20%20print(f%22%20%20is_deleted%3A%20%7Btask.is_deleted%7D%22)%0A%20%20%20%20print(f%22%20%20deleted_at%3A%20%7Btask.deleted_at%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.%20Querying%20with%20SoftDeleteMixin%0A%0A%20%20%20%20Common%20patterns%20for%20querying%20soft-deletable%20models%3A%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(F%2C%20Task)%3A%0A%20%20%20%20%23%20Create%20more%20tasks%20for%20querying%0A%20%20%20%20Task(title%3D%22Task%20A%22%2C%20priority%3D1).save()%0A%20%20%20%20Task(title%3D%22Task%20B%22%2C%20priority%3D2).save()%0A%20%20%20%20task_c%20%3D%20Task(title%3D%22Task%20C%22%2C%20priority%3D3).save()%0A%20%20%20%20task_c.soft_delete()%0A%0A%20%20%20%20print(%22Query%20patterns%20for%20soft-deletable%20models%3A%5Cn%22)%0A%0A%20%20%20%20%23%20All%20records%20(including%20deleted)%0A%20%20%20%20all_tasks%20%3D%20Task.query().all()%0A%20%20%20%20print(f%22All%20tasks%3A%20%7Blen(all_tasks)%7D%22)%0A%0A%20%20%20%20%23%20Only%20active%20(not%20deleted)%0A%20%20%20%20active_tasks%20%3D%20Task.query().filter(F(%22deleted_at%22).is_null()).all()%0A%20%20%20%20print(f%22Active%20tasks%3A%20%7B%5Bt.title%20for%20t%20in%20active_tasks%5D%7D%22)%0A%0A%20%20%20%20%23%20Only%20deleted%0A%20%20%20%20deleted_tasks%20%3D%20Task.query().filter(F(%22deleted_at%22).is_not_null()).all()%0A%20%20%20%20print(f%22Deleted%20tasks%3A%20%7B%5Bt.title%20for%20t%20in%20deleted_tasks%5D%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.%20AuditMixin%3A%20Track%20Who%20Changed%20What%0A%0A%20%20%20%20%60AuditMixin%60%20tracks%20which%20user%20created%2Fupdated%20records.%20Set%20the%20current%0A%20%20%20%20user%20via%20%60AuditMixin.set_current_user()%60%3A%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(AuditMixin%2C%20SQLerModel%2C%20db)%3A%0A%20%20%20%20class%20Article(AuditMixin%2C%20SQLerModel)%3A%0A%20%20%20%20%20%20%20%20_table%20%3D%20%22articles%22%0A%20%20%20%20%20%20%20%20title%3A%20str%0A%20%20%20%20%20%20%20%20content%3A%20str%0A%0A%20%20%20%20Article.set_db(db)%0A%0A%20%20%20%20%23%20Set%20the%20current%20user%20(typically%20done%20in%20middleware)%0A%20%20%20%20AuditMixin.set_current_user(%22alice%40example.com%22)%0A%0A%20%20%20%20article%20%3D%20Article(title%3D%22Hello%20World%22%2C%20content%3D%22First%20post!%22).save()%0A%20%20%20%20print(f%22Created%20by%3A%20%7Barticle.created_by%7D%22)%0A%20%20%20%20print(f%22Updated%20by%3A%20%7Barticle.updated_by%7D%22)%0A%20%20%20%20print(f%22Created%20at%3A%20%7Barticle.created_at%7D%22)%0A%0A%20%20%20%20%23%20Different%20user%20updates%20the%20article%0A%20%20%20%20AuditMixin.set_current_user(%22bob%40example.com%22)%0A%20%20%20%20article.content%20%3D%20%22Updated%20content%22%0A%20%20%20%20article.save()%0A%0A%20%20%20%20print(%22%5CnAfter%20update%20by%20Bob%3A%22)%0A%20%20%20%20print(f%22%20%20Created%20by%3A%20%7Barticle.created_by%7D%20(unchanged)%22)%0A%20%20%20%20print(f%22%20%20Updated%20by%3A%20%7Barticle.updated_by%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.%20AuditLogMixin%3A%20Full%20Change%20History%0A%0A%20%20%20%20%60AuditLogMixin%60%20logs%20every%20change%20to%20a%20separate%20audit%20table%2C%20creating%0A%20%20%20%20a%20complete%20history%20of%20all%20modifications%3A%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_(AuditLogMixin%2C%20AuditMixin%2C%20SQLerModel%2C%20db)%3A%0A%20%20%20%20class%20Product(AuditLogMixin%2C%20SQLerModel)%3A%0A%20%20%20%20%20%20%20%20_table%20%3D%20%22products%22%0A%20%20%20%20%20%20%20%20name%3A%20str%0A%20%20%20%20%20%20%20%20price%3A%20float%0A%20%20%20%20%20%20%20%20in_stock%3A%20bool%20%3D%20True%0A%0A%20%20%20%20Product.set_db(db)%0A%0A%20%20%20%20%23%20Set%20user%20for%20audit%20log%0A%20%20%20%20AuditMixin.set_current_user(%22admin%40shop.com%22)%0A%0A%20%20%20%20%23%20Create%20a%20product%0A%20%20%20%20prod%20%3D%20Product(name%3D%22Widget%22%2C%20price%3D29.99).save()%0A%20%20%20%20print(f%22Created%3A%20%7Bprod.name%7D%20%40%20%24%7Bprod.price%7D%22)%0A%0A%20%20%20%20%23%20Make%20some%20changes%0A%20%20%20%20prod.price%20%3D%2024.99%0A%20%20%20%20prod.save()%0A%20%20%20%20print(f%22Updated%20price%20to%20%24%7Bprod.price%7D%22)%0A%0A%20%20%20%20prod.in_stock%20%3D%20False%0A%20%20%20%20prod.save()%0A%20%20%20%20print(%22Marked%20out%20of%20stock%22)%0A%0A%20%20%20%20%23%20View%20the%20audit%20log%0A%20%20%20%20print(%22%5Cn---%20Audit%20Log%20---%22)%0A%20%20%20%20logs%20%3D%20prod.get_audit_log()%0A%20%20%20%20for%20log%20in%20logs%3A%0A%20%20%20%20%20%20%20%20print(f%22%7Blog%5B'action'%5D%7D%20at%20%7Blog%5B'timestamp'%5D%5B%3A19%5D%7D%20by%20%7Blog%5B'user'%5D%7D%22)%0A%20%20%20%20%20%20%20%20if%20log%5B%22changes%22%5D%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20for%20field%2C%20change%20in%20log%5B%22changes%22%5D.items()%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20%20print(f%22%20%20%7Bfield%7D%3A%20%7Bchange%5B'old'%5D%7D%20-%3E%20%7Bchange%5B'new'%5D%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%20SQLer%20mixins%20add%20common%20functionality%20without%20boilerplate%3A%0A%0A%20%20%20%20%7C%20Mixin%20%7C%20Features%20%7C%0A%20%20%20%20%7C-------%7C----------%7C%0A%20%20%20%20%7C%20%60TimestampMixin%60%20%7C%20%60created_at%60%2C%20%60updated_at%60%20fields%20%7C%0A%20%20%20%20%7C%20%60SoftDeleteMixin%60%20%7C%20%60deleted_at%60%2C%20%60is_deleted%60%2C%20%60soft_delete()%60%2C%20%60restore()%60%2C%20%60hard_delete()%60%20%7C%0A%20%20%20%20%7C%20%60HooksMixin%60%20%7C%20%60before_save()%60%2C%20%60after_save()%60%2C%20%60before_delete()%60%2C%20%60after_delete()%60%20%7C%0A%20%20%20%20%7C%20%60FullMixin%60%20%7C%20Timestamps%20%2B%20SoftDelete%20%2B%20Hooks%20combined%20%7C%0A%20%20%20%20%7C%20%60AuditMixin%60%20%7C%20%60created_by%60%2C%20%60updated_by%60%20user%20tracking%20%7C%0A%20%20%20%20%7C%20%60AuditLogMixin%60%20%7C%20Full%20change%20history%20with%20%60get_audit_log()%60%20%7C%0A%0A%20%20%20%20**Usage%20Pattern%3A**%0A%20%20%20%20%60%60%60python%0A%20%20%20%20class%20MyModel(SomeMixin%2C%20SQLerModel)%3A%0A%20%20%20%20%20%20%20%20_table%20%3D%20%22my_table%22%0A%20%20%20%20%20%20%20%20%23%20your%20fields...%0A%20%20%20%20%60%60%60%0A%0A%20%20%20%20**Important%3A**%20Mixins%20come%20BEFORE%20%60SQLerModel%60%20in%20the%20inheritance%20list!%0A%0A%20%20%20%20**Next%20up%3A**%20Tour%2006%20covers%20Advanced%20Features%20(bulk%20ops%2C%20integrity%20policies)!%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