losalamos.tools.manage_vault#

Top-level vault manager with three-level navigation.

Reads a tool config file (YAML, TOML, or JSON) listing one or more vaults. Navigation flows from vault → branch → project → document management. When only one vault is configured the vault selection screen is skipped and the tool opens directly at the branch picker. Adding a project writes a temporary config file and delegates to losalamos.tools.new_project.run().

Shell usage

python -m losalamos.tools.manage_vault --config path/to/config.toml

Tool config keys

Each entry in the vaults array supports:

  • name (str, required) — display name shown in the vault list.

  • path (str, required) — root directory where branch folders live.

  • folder_system (str, optional) — "default" or "alphanumerical". Defaults to "default".

  • separator (str, optional) — string between branch name and number in the default system. Defaults to "".

  • sources (str, optional) — path to a shared sources config file.

  • language (str, optional) — language tag (e.g. "pt-br").

[[vaults]]
name      = "Client Projects"
path      = "C:/My Drive/projects"
folder_system = "default"
separator = "_"
sources   = "C:/vault/sources.toml"
language  = "pt-br"

[[vaults]]
name      = "Research"
path      = "C:/research"
folder_system = "alphanumerical"

vaults:
  - name:          Client Projects
    path:          C:/My Drive/projects
    folder_system: default
    separator:     "_"
    sources:       C:/vault/sources.toml
    language:      pt-br

  - name:          Research
    path:          C:/research
    folder_system: alphanumerical

{
  "vaults": [
    {
      "name":          "Client Projects",
      "path":          "C:/My Drive/projects",
      "folder_system": "default",
      "separator":     "_",
      "sources":       "C:/vault/sources.toml",
      "language":      "pt-br"
    },
    {
      "name":          "Research",
      "path":          "C:/research",
      "folder_system": "alphanumerical"
    }
  ]
}

Functions

get_arguments()

Parse command-line arguments.

main()

run(config_path)

Start the vault manager.
losalamos.tools.manage_vault.get_arguments()[source]#

Parse command-line arguments.

Returns:

Parsed argument namespace with a config attribute.

losalamos.tools.manage_vault.run(config_path: str) → None[source]#

Start the vault manager.

Parameters:

config_path (str) – Path to the tool config file.

losalamos.tools.manage_vault.main() → None[source]#