Kevin Veen-Birkenbach 1807949c6f Add mirror management commands and refactor CLI parser into modules
- Implement new mirror actions:
  - list_mirrors: show mirrors from config, MIRRORS file, or merged view
  - diff_mirrors: compare config mirrors with MIRRORS file (ONLY IN CONFIG,
    ONLY IN FILE, URL MISMATCH, OK)
  - merge_mirrors: merge mirrors between config and MIRRORS file in both
    directions, with preview mode and user config writing via save_user_config
  - setup_mirrors: prepare local Git remotes (ensure origin) and print
    provider-URL suggestions for remote repositories
- Introduce mirror utilities:
  - RepoMirrorContext with resolved_mirrors (config + file, file wins)
  - load_config_mirrors supporting dict and list-of-dicts shapes
  - read/write MIRRORS file with simple "name url" format and preview mode
  - helper for building default SSH URLs from provider/account/repository
- Wire mirror commands into CLI:
  - Add handle_mirror_command and integrate "mirror" into dispatch
  - Add dedicated CLI parser modules under pkgmgr.cli.parser:
    * common, install_update, config_cmd, navigation_cmd,
      branch_cmd, release_cmd, version_cmd, changelog_cmd,
      list_cmd, make_cmd, mirror_cmd
  - Replace old flat cli/parser.py with modular parser package and
    SortedSubParsersAction in common.py
- Update TODO.md to mark MIRROR as implemented
- Add E2E tests for mirror commands:
  - test_mirror_help
  - test_mirror_list_preview_all
  - test_mirror_diff_preview_all
  - test_mirror_merge_config_to_file_preview_all
  - test_mirror_setup_preview_all

https://chatgpt.com/share/693adee0-aa3c-800f-b72a-98473fdaf760
2025-12-11 16:10:19 +01:00
2025-12-10 22:56:04 +01:00
2025-03-04 13:17:09 +01:00
2025-12-11 15:46:45 +01:00

Package Manager🤖📦

GitHub Sponsors Patreon Buy Me a Coffee PayPal GitHub license GitHub repo size

Kevins's Package Manager is a configurable Python tool designed to manage multiple repositories via Bash. It automates common Git operations such as clone, pull, push, status, and more. Additionally, it handles the creation of executable wrappers and alias links for your repositories.

Features 🚀

  • Installation & Setup:
    Create executable wrappers with auto-detected commands (e.g. main.sh or main.py).

  • Git Operations:
    Easily perform git pull, push, status, commit, diff, add, show, and checkout with extra parameters passed through.

  • Configuration Management:
    Manage repository configurations via a default file (config/defaults.yaml) and a user-specific file (config/config.yaml). Initialize, add, delete, or ignore entries using subcommands.

  • Path & Listing:
    Display repository paths or list all configured packages with their details.

  • Custom Aliases:
    Generate and manage custom aliases for easy command invocation.

Architecture & Setup Map 🗺️

The following diagram provides a full overview of PKGMGRs package structure, installation layers, and setup controller flow:

PKGMGR Architecture

Diagram status: Stand: 11. Dezember 2025
Always-up-to-date version: https://s.veen.world/pkgmgrmp

Installation ⚙️

Clone the repository and ensure your ~/.local/bin is in your system PATH:

git clone https://github.com/kevinveenbirkenbach/package-manager.git
cd package-manager

Install make and pip if not installed yet:

pacman -S make python-pip

Then, run the following command to set up the project:

make setup

The make setup command will:

  • Make main.py executable.
  • Install required packages from requirements.txt.
  • Execute python main.py install to complete the installation.

License 📄

This project is licensed under the MIT License.

Author 👤

Kevin Veen-Birkenbach
https://www.veen.world

Description
No description provided
Readme MIT 8.9 MiB
Languages
Python 90.9%
Shell 7.6%
Makefile 0.7%
Nix 0.5%
Dockerfile 0.2%
Other 0.1%