Add snapshot lifecycle hooks - #1
Conversation
There was a problem hiding this comment.
Pull request overview
Adds opt-in snapclass lifecycle hooks to provide explicit extension points after snapshot attachment (__snapclass_ready__) and after file data has been loaded/applied (__snapclass_loaded__), primarily to support migration/transient initialization flows.
Changes:
- Introduces internal lifecycle hook helpers in
schemas.pyand triggers them after snapshot attachment and afterSnapshot.load()completes. - Updates snapshot creation/collection APIs to call the new “ready” hook after attachment.
- Adds tests covering hook ordering, sidecar visibility, suppression of autosave loops during hooks, and error wrapping.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| tests/test_sidecar.py | Adds regression test ensuring sidecar constructor values are visible when __snapclass_ready__ runs. |
| tests/test_behavior_contracts.py | Adds contract tests for ready/loaded hook ordering, autosave suppression during hooks, and error message context. |
| src/snapclass/snapshots.py | Calls ready hook after attaching a snapshot via create_snapshot(). |
| src/snapclass/schemas.py | Implements lifecycle hook invocation, hook suppression context, and calls ready/loaded hooks from init/sync/load paths. |
| src/snapclass/collections.py | Ensures collection instantiation paths call the ready hook before initial load. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: c10f6286ee
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 4fc4688f1d
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 67f22d37b0
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 8fb3705c4b
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 1bcbfc1c28
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: b51f26d40e
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 8ffc7a4458
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 463af9d62a
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
Summary
Adds opt-in snapshot lifecycle hooks for migration paths that need transient object setup around attachment and load boundaries.
__snapclass_ready__(self, *, snapshot)after snapshot attachment, mutable wrapping, and sidecar constructor values are settled__snapclass_loaded__(self, *, snapshot, path)afterSnapshot.load()applies file data, wraps mutables, and records loaded stateSnapclassErrorwith hook name and path context when availableWhy
Downstream migrations need a reliable place to initialize transient fields before normal object use, plus a separate hook once file data has been applied. The previous lifecycle had attachment and load behavior, but no explicit extension points for those phases.
Validation
python.exe -m pytestvia ErrorHelp: 317 passedgit diff --check: clean, aside from existing CRLF normalization warnings