mix workspace.status (Workspace v0.4.2)

View Source

Similar to git status but on a workspace level.

$ mix workspace.status

For projects affected by their :affected_by paths, the matched paths and the corresponding changed files are also printed:

$ mix workspace.status
Affected projects:
  :nif nif/mix.exs
    affected by native/common
      untracked native/common/lib.rs

Command line options

Workspace status options

Status is retrieved from the files changed on --head since it diverged from --base, similar to git diff base...head, and any uncommitted or untracked files. Knowing the changed files we can limit the execution of workspace commands only to relevant projects.

  • --base (string) - The base git reference to compare the head to. Applied only when --affected or --modified are set.
  • --head (string) - A reference to the git head. Applied only if --base is set for getting the changed files [default: "HEAD"]

Global workspace options

  • --config-path (string) - The path to the workspace config to be used, relative to the workspace path [default: ".workspace.exs"]
  • --workspace-path (string) - If set it specifies the root workspace path, defaults to current directory