Concierge repository projects management CLI.
Project description
Companion CLI for Concierge, the Configuration management & CI solution for aligning your multitude of Git repositories. Allows you to bulk-manage properties of your Git repository projects. Currently, GitLab is supported.
Why Should I Use This Tool?
Concierge-cli helps you analyze and bulk-update the repository projects you manage (e.g. set topics on projects, generate project lists for ModuleSync).
Installation
From PyPI:
$ pip install concierge-cli
Note: You need Python >= 3.6, otherwise your installation will not succeed (python-gitlab v2.0.0 dropped support for older Pythons). You can use Pipenv to work around this limitation:
$ pip install pipenv
$ pipenv shell --three
$ pip install concierge-cli
Preparation
You need an access token of a GitLab user to access resources through the API. For groups and group membership this needs to be an administrator user. You may also want to disable notifications of the user(s) you plan to perform bulk updates on, to avoid sending out massive amounts of emails.
Set the GitLab URI and TOKEN as environment variables (if you want to avoid using the --token and/or --uri options):
$ export CONCIERGE_GITLAB_URI=https://git.example.com/
$ export CONCIERGE_GITLAB_TOKEN=<redacted>
Usage Patterns
Manage project topics
List projects by topic
List (and merge) merge requests by project
Manage group membership and permissions
Manage topics
List all projects (for a private GitLab) that have no topics yet:
$ concierge-cli gitlab --uri https://git.vs.hn topics --empty
List all projects “foo” or similar in group “bar” or similar: (on GitLab.com)
$ concierge-cli gitlab topics bar/foo --empty
Set topics on all those projects:
$ concierge-cli gitlab topics bar/foo --empty --set-topic Puppet --set-topic Ansible
List all projects with topics now: (double-check)
$ concierge-cli gitlab topics bar/foo
List projects
Print a YAML list of all projects matching a topic:
$ concierge-cli gitlab projects --topic Puppet
Update the list of modules Concierge manages with a specific configuration:
$ concierge-cli gitlab projects --topic Puppet > configs/foo-bar/managed_modules.yml
$ git add -v configs/foo-bar/managed_modules.yml
$ git status && git commit -m 'Added ...' && git push
Merge requests
List of all merge requests of a project, optionally matching labels:
$ concierge-cli gitlab mrs mygroup/myproject --label mylabel
Add --merge yes to trigger merging all found requests.
Group membership
List all groups where user is not yet a member of:
$ concierge-cli gitlab groups --no-member my.user.name
Add user to all those groups:
$ concierge-cli gitlab groups --no-member my.user.name \
--set-permission maintainer
List a user’s group memberships and permissions:
$ concierge-cli gitlab groups my.user.name
Remove a user from selected groups:
$ concierge-cli gitlab groups my.user.name \
--group-filter a-group-name \
--set-permission none
Found a bug? Need a new feature?
Please see our Contribution Guide if you want to help out!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file concierge-cli-1.7.2.tar.gz
.
File metadata
- Download URL: concierge-cli-1.7.2.tar.gz
- Upload date:
- Size: 11.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.8.16
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2f854d542df501167abde94b8bba436be61bc11a27678f445f513ffc1837a94f |
|
MD5 | 1bf425134c65f21c811ccbdb0354f5f1 |
|
BLAKE2b-256 | ecbfa6f14ee89a00af52f8b52e89bbd9646a1980787482663fdd846c38e6a79c |
File details
Details for the file concierge_cli-1.7.2-py3-none-any.whl
.
File metadata
- Download URL: concierge_cli-1.7.2-py3-none-any.whl
- Upload date:
- Size: 11.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.8.16
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | ea945389c2784fac866c7e3dff5c26c7b2e69d835f5f8ddd14d7712cadf599ee |
|
MD5 | 3dfdd5ebcea73c95b0d0195de4713947 |
|
BLAKE2b-256 | d00660cd9bb1868847a324c6c2e81bd55ffcce7470b8e0a582e7525d876c4957 |