How jacebrowning/gitman works
Project type and purpose
• This is a language-agnostic, command-line dependency manager (“Gitman”) written in Python.
• It reads a YAML config file (gitman.yml/.gitman.yml), fetches and checks out Git repos, sets up links, runs post-install scripts, and records locked SHAs.
File structure
• bin/: CLI shim scripts (checksum, open, verchew) that invoke the internal gitman module.
• gitman/:
• __main__.py – module entry point
• cli.py – argument parsing, help text
• commands.py – implementations of commands (update, install, uninstall, list, init, etc.)
• models/ – data models (Config, Group, Source)
• git.py – wrapper around Git CLI calls
• shell.py – abstraction for running shell commands
• plugin.py & decorators.py – plugin framework and extension hooks
• common.py, settings.py – shared utilities and defaults
• docs/ & mkdocs.yml – documentation site source.
• tests/ & gitman/tests/ – unit tests for both CLI/API and internal modules.
• configuration files (.gitignore, pyproject.toml, Makefile, CI configs).
README for additional insights
• Describes major workflows: init, update, install, list, uninstall.
• Illustrates features: recursive working trees, links, locking SHAs, post-install scripts.