Skip to content

docs: keep an in-use SQLite database out of sync folders - #95

Merged
stevevanhooser merged 1 commit into
mainfrom
claude/docs-sync-folder-note
Oct 24, 2026
Merged

stevevanhooser merged 1 commit into
mainfrom
claude/docs-sync-folder-note

Conversation

@stevevanhooser

Copy link
Copy Markdown
Contributor

Follow-up to #94, docs only, no behaviour change.

#94 catches a database file that is replaced during a write. Sync clients (Dropbox, OneDrive, iCloud Drive, Google Drive) can also damage an open database in ways nothing inside DID can see:

  • overwriting the file in place;
  • uploading it half-written while a write is under way;
  • splitting it into conflicted copies.

Changes

  • docs/sqlitedb.md gets a new section, "Where to keep the database file". It covers:
    • keeping an in-use database, and its files/ directory, outside sync-managed folders;
    • what DID catches (a replaced file, checked before a write starts and again just before it commits) and what it can't;
    • how to share or back up a database: db.close() in every process, then copy the .sqlite file and files/ together.
  • SQLiteDB docstring: a short version of the same advice, pointing to that section.

Locally: black --check, ruff check, pytest (800 passed) and check_bridge_coverage.py (0 problems).


Generated by Claude Code

#94 catches a database file replaced during a write. Sync clients can
also overwrite the file in place, upload it half-written, or fork it into
conflicted copies, and nothing inside DID can see those. Add a "Where to
keep the database file" section to docs/sqlitedb.md:
- what each of those does;
- what DID does and doesn't catch;
- how to share or back up a database safely (close it, then copy the
  .sqlite file and its files/ directory together).

Point to it from the SQLiteDB docstring.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012Dn4gCNCU2jUGdmfPVCAGK
@stevevanhooser
stevevanhooser merged commit 98c09e8 into main Oct 24, 2026
7 checks passed
@stevevanhooser
stevevanhooser deleted the claude/docs-sync-folder-note branch October 24, 2026 14:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants