polyrepo 0.3.2

Last updated:

0 purchases

polyrepo 0.3.2 Image
polyrepo 0.3.2 Images
Add to Cart

Description:

polyrepo 0.3.2

PolyRepo
Keep repos organized locally the same as on GitLab
Bird icons created by Mihimihi - Flaticon
Installation and Use
As a WIP, PolyRepo supports only the groups command, which lists a group and all its subgroups.
To install: pipx install polyrepo
To configure, create a ~/.polyrepo.yml file that looks like this:
gitlab:
host: gitlab.com
token: glpat-aaaaaaaaaaaaaaaaaaaa

(The token is optional if you're just pulling public groups/subgroups)
Then:
polyrepo groups gitlab-org

... with the path to the group you want to examine.
Proposed functionality
polyrepo sync steampunk-wizard

In a subdirectory called steampunk-wizard, clone all its subgroups and projects.
If a subdirectory doesn't exist, create it to hold the clone.
If a subdirectory exists for a project:

Confirm that the default git remote points to the correct path in GitLab
Optionally, fetch everything, including tags

If a subdirectory exists that does NOT correspond to a GitLab repo, remove it?
Output in text
/steampunk-wizard/busy Created
/steampunk-wizard/labcrawler Disjoin
/steampunk-wizard/mypyref Correct Changed
/steampunk-wizard/sandbox/ci-sandbox Fetched
/steampunk-wizard/sandbox/play-around Missing

Statuses:

Created The repo did not previously exist locally, and now has been cloned and fetched.
Fetched The repo did exist, and has been fetched
Correct Was already up to date; no changes
Missing There is no repo in GitLab, but there's a local folder with content
Disjoin A local directory exists, but either isn't a git repo or has the wrong default remote

Then Changed means local changes exist, which could include

Local branches still to be pushed
Commits in a branch beyond what was fetched
Local changes to be committed

Note that PolyRepo doesn't pull or merge anything, doesn't touch the working directory except in the case of creation, and ...
There's a .polyrepo file (optional) to specify the subgroups/repos to consider.
Questions

How to handle moves of repos between namespaces?
Any operation to polyrepo every namespace the user can access?

Development
make clear
poetry install
export GITLAB_TOKEN=$(op item get "Gitlab.com (personal) [2FA]" --fields label=/steampunk-wizard)
python -m polyrepo --config test/files/.polyrepo.yml groups steampunk-wizard

License:

For personal and professional use. You cannot resell or redistribute these repositories in their original state.

Customer Reviews

There are no reviews.