wcheck 0.3.0

Manage a workspace of git repositories

wcheck

Manage a workspace of git repositories

wcheck compares different workspaces of git repositories and reports their differences. It supports:

• Local workspaces - directories containing multiple git repositories
• Configuration files - YAML files defining expected repository versions (vcstool format)

Features

• 🔍 Check status of all repositories in a workspace
• 📊 Compare workspace against configuration files
• 🔄 Compare multiple configuration files
• 📈 Track version changes across git branches
• 🖥️ Optional GUI for branch management

Installation

Using uv (recommended):

uv tool install wcheck

Using pip:

pip install wcheck

With GUI support:

pip install wcheck[gui]

Quick Start

Check Workspace Status

wcheck status

Output:

┏━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Repo Name             ┃ Current Workspace         ┃
┡━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ my-project (2M 1U)    │ feature/new-feature       │
│ another-repo (1↑)     │ main                      │
└───────────────────────┴───────────────────────────┘

Status indicators:

• U - Untracked files
• M - Modified files
• S - Staged files
• ↑ - Commits to push
• ↓ - Commits to pull

Compare with Configuration

wcheck wconfig -c workspace.yaml

Compare Multiple Configs

wcheck config-list -c robot_a.yaml -c robot_b.yaml

Compare Across Branches

wcheck config-versions -c workspace.yaml

Commands

Command	Description
status	Check status of repositories in workspace
wconfig	Compare workspace to configuration file
config-list	Compare multiple configuration files
config-versions	Compare config across git branches

Common Options

Option	Description
-w, --workspace-directory	Workspace path (default: current dir)
-c, --config	Configuration file path
-f, --full	Show all repos, not just differences
-v, --verbose	Verbose output
--show-time	Show time since last commit
--fetch	Fetch remotes before checking
--gui	Launch graphical interface

Configuration File Format

wcheck uses vcstool-compatible YAML files:

repositories:
  my-project:
    type: git
    url: [e-mail]:user/my-project.git
    version: main
  
  another-repo:
    type: git
    url: https://github.com/user/another-repo.git
    version: v1.0.0

Similar Projects

• vcstool - Version control system tool for managing multiple repositories
• myrepos - Tool to manage all your version control repos
• repo - Google's tool for managing multiple Git repositories
• gita - Manage multiple Git repos with ease
• mu-repo - Tool to work with multiple Git repositories

Documentation

📖 Full documentation: https://dpastorm.github.io/wcheck/

• Installation Guide
• Quick Start
• CLI Reference
• Configuration Files
• API Reference

Development

# Clone repository
git clone https://github.com/dpastorm/wcheck.git
cd wcheck

# Install with dev dependencies
uv sync --extra dev

# Run tests
uv run pytest

# Build documentation locally
uv sync --extra docs
uv run mkdocs serve

License

MIT License - see LICENSE for details.

Author

Daniel Pastor ([e-mail])