How joewil08/p2p-file-synchronization-group-3 works
Project type and purpose
• This is a Python‑based, CLI peer‑to‑peer file synchronization application for a local network that uses a central tracker for peer discovery. Users register, share public/private files, send messages, and manage trusted peers.
File structure
• Top‑level scripts
– main.py → CLI entrypoint, shows main menu and orchestrates user commands
– file_sync.py → handles sending/receiving files (public/private)
– files_directory.py → manages local file index and metadata (IDs, access control)
– message.py → messaging service (send, receive, reply)
– peer.py → peer discovery & registration messages
– subscription.py → subscribe/unsubscribe logic for tracker broadcasts
• utils/
– generate_peer_id.py → creates unique peer IDs
– get_host_ip.py → retrieves local host IP for announcements
– validate_peers.py → checks peer liveness/trust lists
• .venv, .DS_Store, README.md
Architectural hints:
– Modular services (file sync, messaging, peer discovery)
– Central tracker role for peer registration/discovery
– CLI frontend driving these services
README for additional insights
• Central server used only for peer discovery
• Public files broadcast to all, private only to “trusted peers”
• Messaging center with one‑at‑a‑time anti‑spam
• Automatic background peer discovery and file sharing
• Users register/deregister with network broadcasts
Detailed but focused
• Trust list gating private file transfers
• Background vs user‑initiated flows