Public HubPublic

Errors

Error Handling

Understand the most common rawctx CLI and Python error cases.

Errors

Keep failure handling explicit

Goal: make it clear whether the issue is auth, installability, validation, or cache state instead of relying on ambiguous CLI text.

Common CLI cases
  • rawctx.yaml not found: the package root does not contain the manifest file.
  • name must match @scope/package: package names are lowercase and only allow letters, numbers, and hyphen.
  • version must be a SemVer string (X.Y.Z): prerelease-style or shortened versions fail strict validation.
  • model file not found: a path listed in models does not exist where the manifest says it does.
  • Authentication required: the current action needs publish, claim, favorites, settings, or private access.
  • preview-only package cannot be downloaded: inspect the preview or move to the upstream source.
  • version already exists: bump the version and publish again.
Typed Python errors
RawctxErrorUsageErrorAuthRequiredErrorRegistryErrorValidationErrorOfflineCacheMissError