How yossiwolfe/tabs-group-sync works
Tab Groups Project is a FastAPI service for storing and syncing tab groups across devices. Clients call the group API to create, update, delete, or retrieve groups; retrieval can filter by modification time, and deletion is represented by a flag. The API validates request and response data with Pydantic schemas and uses SQLAlchemy sessions to persist ORM models in SQLite. The README describes real-time syncing, but the sampled implementation exposes timestamp-filtered HTTP retrieval rather than a real-time transport; tab schemas and models exist without sampled tab endpoints.
Main entry points: main.py Group API · database.py DB Sessions · models.py Tab Models · schemas.py API Schemas
Components 6
HTTP API
- Group API
src/tab_groups_proj/main.py
Data Contracts
- API Schemas
src/tab_groups_proj/schemas.py
Persistence
- Tab Models
src/tab_groups_proj/models.py - DB Sessions
src/tab_groups_proj/database.py - SQLite Store
Other components
- Sync Client
Connections 7
- Sync Client → Group API: sends requests
src/tab_groups_proj/main.py - Group API → API Schemas: validates and serializes
src/tab_groups_proj/main.py - Group API → DB Sessions: gets sessions
src/tab_groups_proj/main.py - Group API → Tab Models: queries and mutates
src/tab_groups_proj/main.py - DB Sessions → Tab Models: creates tables
src/tab_groups_proj/database.py - DB Sessions → SQLite Store: opens and persists
src/tab_groups_proj/database.py - Group API → Sync Client: returns group data
src/tab_groups_proj/main.py