Add sync progress bar demo scripts and documentation

[Copilot]

Provides reference implementations for P4.Progress callbacks during sync operations.

Files

• simple_sync_progress.py (112 lines) - Minimal example with ASCII progress bar
• p4_sync_progress_demo.py (362 lines) - Full implementation with CLI args, basic/tqdm modes
• SYNC_PROGRESS_EXAMPLES.md - P4.Progress API reference, constants, patterns
• QUICK_START.md - Common use cases and customization examples

Usage

import P4

class SimpleProgressBar(P4.Progress):
    def setTotal(self, total):
        self.total = total
    
    def update(self, position):
        percent = (position / self.total) * 100
        print(f'[{"="*40}] {percent:.1f}%')

p4 = P4.P4()
p4.progress = SimpleProgressBar()
p4.connect()
p4.run_sync("//...")

Command-line:

python simple_sync_progress.py
python p4_sync_progress_demo.py --tqdm --path //depot/main/...

Implementation

Both scripts extend P4.Progress base class:

• init(type) - Operation start (TYPE_SENDFILE/RECEIVEFILE/TRANSFER/COMPUTATION)
• setDescription(desc, unit) - Set description and unit type (PERCENT/FILES/KBYTES/MBYTES)
• setTotal(total) - Total items to process
• update(position) - Current position
• done(fail) - Completion callback

No changes to existing p4python code.

Original prompt

Analyse the codebase of this repo and write my a python test script allowing me to do a sync and display a progress bar.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.