Review and provide feedback.

[Traap]

@lervag - Hello Karl,

I have invited you to participate with gits, a simple tool to manage groups of git repositories. If you have between 15 to 30 mins to test gits and provide me feedback it is appreciated -- Traap

Quick overview:

1. https://github.com/Traap/gits/blob/master/README.md outlines the dependencies, install and uninstall processes.
2. gits install.sh and uninstall.sh requires sudo privileges to run. Both scripts have been designed a straight forward as possible.
3. install.sh will copy gits to /usr/local/bin, add Python3 and its dependencies, and add $HOME/.config/gits/repository_locations.yml.
4. Uninstall.sh removes /usr/local/bin/gits and $HOME/.config/gits/repository_locations.yml but does not remove Python3 or dependencies.

Sample commands:
Display usage

gits -h

List repository location group name in $HOME/.config/gits/repository_locations.yml

gits -l

Without any arguments, List git status for all repositories in all repository group names.

gits

**Clone all repositories listed in all repository group names. **

git -c 

Delete all repositories listed in all repository group names.

gits -d 

Pull all repositories listed in all repository group names.

gits -p

Print repository status for all repositories listed in all repository group names.

gits -s

Convert UTF-16 to UTF-8 files for all repositories listed in all repository group names.

gits -u

Remove all untracked files for all repositories listed in all repository group names.

gits -x

Note all the commands above can target a repository group by using the -r modifier.

List repositories within a repository location group plugins.

gits -l -r plugins

[lervag]

Hi! Nice to "meet" you again!

I have invited you to participate with gits, a simple tool to manage groups of git repositories. If you have between 15 to 30 mins to test gits and provide me feedback it is appreciated -- Traap

Thanks for the invitation! To be honest, I'm struggling to keep up with my other projects, so I'm not sure if I'm up to the task of engaging in a new project. But I'm happy to look at this and let you know my thoughts!

First, I'm curious, are you aware of myrepos? It seems as a tool that does more or less exactly the same? It is written in Perl and I've been using it for a very long time. It does feel more mature to me, so perhaps it would be interesting to you as well?

In any case, this really does seem like a very nice project for learning to make good python tools. And if you give it love and continue to develop it, I could consider switching from myrepos in the future :)

Now, some feedback on gits.

---

First, I would strongly suggest that you wrap your project with uv. That is, make it a uv python project. It's quite easy, and it would make it easier to install or test the tool and you would no longer need the install and uninstall scripts. See https://docs.astral.sh/uv/getting-started/ for a relatively quick guide on how to use it.

With uv it would also be trivial to add dependencies.

Next, I think it would be better if the cli uses subcommands instead of arguments. This may require some refactoring, but it would make it easier to e.g. add specific options for subcommands. There are quite a few libraries for this. Some useful ones might be:

• https://github.com/docopt/docopt
• https://google.github.io/python-fire/
• https://typer.tiangolo.com/
• https://github.com/Textualize/textual (very nice if you want to make more fancy features)

Next, I find you are building the tool around the idea or concept of groups. And it seems the target paths are currently not configurable and instead rely on the group name and the repo alias or repo name. I would recommend adding support for specifying the target names.

I notice that myrepos does not have any concept of groups. When I think about it, I do see that the group idea is not so bad. But I think I would recommend to reconsider it: instead of creating groups of repos, I think having a flat list of repos with tags and target paths would give the same flexibility while keeping the possibiliy of working on groups of repos.

I would also update the example to add ssh based url's as well as https urls.

[Traap]

Hi Karl,

Thank you for your feedback, tips, suggestions, and references to other work. This will definitely help me mature this work.

I was not aware of myrepos. I will have to study it too.

Again, thank you.

[lervag]

My pleasure; and good luck!

[Traap]

@lervag - FYI

I did refactor this project to use uv. repository_locations.yml has been restructured as as seen below. This version does not support tags, but I did add root_dir, repositories, and do_no_delete.

My personal repository_locations.yml file has bout 112 repositories for home or work. I am envisioning an attribute that allows enabled which could be dynamically set per repository based work or home. For example, I have a root_dir representing bootstrapping whose content changes based on the computer system I am configuring.

Thank you again for you feedback.

editor:
  - root_dir: ~/editor
  - repositories:
    - alias: LazyVim
      url: https://github.com/LazyVim/starter
    - alias: lazy.nvim
      url: https://github.com/folke/lazy.nvim
    - alias: neovim
      url: https://github.com/neovim/neovim

fzf:
  - root_dir: ~/fzf
  - repositories:
    - alias: fzf
      url: https://github.com/junegunn/fzf-git.sh
    - alias: everything
      url: https://github.com/junegunn/everything.fzf

hyprland:
  - root_dir: ~/hyprland
  - repositories:
    - alias: Dots
      url: https://github.com/JaKooLit/Hyprland-Dots
    - alias: Arch
      url: https://github.com/JaKooLit/Arch-Hyprland

plugins:
  - root_dir: ~/plugins
  - repositories:
    - alias: neo-tree
      url: https://github.com/nvim-neo-tree/neo-tree.nvim
    - alias: telescope
      url: https://github.com/nvim-telescope/telescope.nvim
    - alias: fugitive
      url: https://github.com/tpope/vim-fugitive

traap:
  - root_dir: ~/traap
  - repositories:
    - alias: archlinux
      url: git@github.com:Traap/bootstrap-archlinux
    - alias: gits
      url: git@github.com:Traap/gits
      do_not_delete: true
    - alias: nvims
      url: git@github.com:Traap/nvims
      do_not_delete: true
    - alias: vimtex
      url: https://github.com/lervag/vimtex
      do_not_delete: false

[lervag]

Cool, thanks for the update. Glad to see your progress!

I did refactor this project to use uv. repository_locations.yml has been restructured as as seen below. This version does not support tags, but I did add root_dir, repositories, and do_no_delete.

Since you are still relying on the grouping feature, I would also suggest that you allow to specify some of the options at group level to set different group defaults.

Thank you again for you feedback.

No problem; and again, good luck!

[Traap]

@lervag - I just wrapped up v0.2.4. I've been been making minor adjustments as I use gits both personally and professionally on five different computers. README.md has sample output for all commands. I am now preparing a few YouTube videos before I add more features.

I do reference vimtex in repository_locations.yml. I am assuming you will not mind a shout-out, do let me know if you feel otherwise.

[lervag]

Cool, congrats! It seems your project is coming along nicely!

And of course, I don't mind references/shout-outs, so feel free! 😊

[Traap]

And of course, I don't mind references/shout-outs, so feel free! 😊

Thanks.

https://youtu.be/J-x72eWIDUw

[lervag]

Cool, this is really improving and coming along. And as before, the video is great. Easy to follow, good sound quality, and good content. Well done!