Expand description
Version-control-agnostic identity resolution.
wipe stores its board in a repo, but that repo isn’t always git: teams on
Plastic SCM (Unity VCS), Mercurial, SVN, Fossil, or Jujutsu should still get
real attribution instead of “unknown”. This module detects the VCS in use and
asks it who the current user is, shelling out to each tool best-effort (a
missing tool or non-repo simply yields None, never an error).
Enums§
- Vcs
- A recognized version-control system hosting the repo.
Functions§
- authors
- Distinct historical authors as
(name, email), best-effort. Only git and Mercurial expose this cheaply; others return an empty list. - detect
- Walk up from
startlooking for a VCS marker. The first match wins;.gitand.plasticare checked together at each level so a nested layout resolves to the closest enclosing workspace. - identity
- The current user’s identity as reported by the repo’s VCS (
Name <email>when available), orNoneif there’s no VCS, the tool is missing, or it’s unset. - system_
user - The OS account name (
$USERNAMEon Windows,$USERelsewhere), a last-ditch identity when no VCS can supply one.