Compare Files (zeysdk compare)
Compare local files with their server versions to detect differences in content and properties.
zeysdk compare [files...] [options]
Parameters
| Parameter | Description | Required | Example |
|---|---|---|---|
files | Specific files to compare | ❌ | services/backup.ixml weblets/dashboard.ixml |
Options
| Option | Description | Default |
|---|---|---|
--verbose | Show detailed comparison progress | false |
Status Indicators
| Symbol | Meaning |
|---|---|
| + | Created locally |
| + | Added on server |
| - | Deleted locally |
| - | Deleted on server |
| ~ | Modified locally |
| ~ | Modified on server |
| ! | Conflict (modified both locally and on server) |
| ⟷ | Property conflict |
| → | Local changes to be pushed |
| ← | Server changes to be pulled |
Comparison Categories
Enhancement Sync
Settings
| config.json ~ modified locally
property: "old" → "new"
Services
| backup.ixml ! content modified locally and on server
interval: 30 ⟷ 60
Resources
| logo.png + created locally
Weblets
| dashboard.ixml ~ content modified on server
The output is organized by asset type:
- Settings
- Services
- Resources
- Weblets
Examples
# Compare all files
zeysdk compare
# Compare specific files
zeysdk compare services/backup.ixml weblets/dashboard.ixml
# Compare with detailed output
zeysdk compare --verbose
Example output:
Enhancement Sync
Services
| backup.ixml ~ content modified locally
schedule: "0900" → "1200"
interval: 30 ← 60
Resources
| logo.png ! content modified locally and on server
public: 0 ⟷ 1
Error Handling
| Error | Description | Resolution |
|---|---|---|
| Missing sync.json | No sync configuration | Run zeysdk link first |
| Invalid sync.json | Missing id/url | Relink instance |
| Diff tool error | Tool launch failed | Select alternative tool |
| Server error | Cannot fetch remote | Check connection/auth |
| Parse error | Invalid file content | Check file format |