Skip to main content

Compare Files (zeysdk compare)

Compare local files with their server versions to detect differences in content and properties.

zeysdk compare [files...] [options]

Parameters

ParameterDescriptionRequiredExample
filesSpecific files to compareservices/backup.ixml weblets/dashboard.ixml

Options

OptionDescriptionDefault
--verboseShow detailed comparison progressfalse

Status Indicators

SymbolMeaning
+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

ErrorDescriptionResolution
Missing sync.jsonNo sync configurationRun zeysdk link first
Invalid sync.jsonMissing id/urlRelink instance
Diff tool errorTool launch failedSelect alternative tool
Server errorCannot fetch remoteCheck connection/auth
Parse errorInvalid file contentCheck file format