parkit syncapi¶
Moves local HPC_DME_APIs to its target ref and refreshes the HPC-DME token.
The target is the latest stable release: the highest-numbered releases/X.Y.Z branch merged into master (HPC_DME_APIs no longer publishes GitHub tags or releases), unless a tag or branch is pinned.
Syntax¶
parkit syncapi [--repo /path/to/HPC_DME_APIs] [--ref TAG_OR_BRANCH]
--ref: sync to a specific tag or branch (X.Y.Zis shorthand forreleases/X.Y.Z). Defaults to$HPC_DME_APIs_REFwhen set.
What It Does¶
- Resolves the API repo path and the target ref.
- Moves the repo to the target without merge commits:
- branch: local branch of the same name tracking
origin(fast-forwarded if it exists) - tag: detached
HEADat the tag commit - never downgrades automatically; an explicit
--refmay downgrade (with a warning) - aborts on uncommitted changes to tracked files or local-only commits; untracked/ignored files such as
utils/hpcdme.propertiesare kept - Verifies
HEADis at the target commit. - Sources API functions and runs
dm_generate_tokeninteractively.
Exit codes: 0 success, 1 sync or token failure, 2 configuration error.
Typical Use¶
parkit checkapisync
parkit syncapi
parkit checkapisync
Pin a specific release:
parkit syncapi --ref 3.31.0
export HPC_DME_APIs_REF=3.31.0 # keep checkapisync/projark on the same ref