gitforge 0.0.2

Git Forge API Client..

GIT FORGE API CLIENTS

W.I.P. API clients for GitHub & GitLab.

Run commands or query api on all projects or groups of an authenticated GitLab or GitHub user.

So far only GitLab & GitHub are supported and the commands - sync (clone a repository, or pull from it if already cloned) or status (show the local status of the repository).

Coming soon - A wider array of forges, commands and configuration...

INSTALLATION

pip install gitforge

CONFIGURATION

Add personal access tokens and desired destination directories to ~/.config/gitforge/config. These defaults can be overridden on the command line with the --token and --destination arguments. See below for more details.

AUTHENTICATION

Generate a GitHub Personal Access Token here.

Generate a GitLab Personal Access Token here.

OPTIONS

GITHUB

usage: github [-h] [-r REPO [REPO ...]] [-d DESTINATION] [-t TOKEN]
              [-p SSH/HTTP] [-i] [-c COMMAND] [-v]

CLI GitHub API Client

optional arguments:
  -h, --help            show this help message and exit
  -r REPO [REPO ...], --repos REPO [REPO ...]
                        github repo names
  -d DESTINATION, --destination DESTINATION
                        destination path
  -t TOKEN, --token TOKEN
                        github personal access token
  -p SSH/HTTP, --protocol SSH/HTTP
                        protocol to use - ssh or http (defaults to ssh)
  -i, --interactive     choose repos interactively
  -c COMMAND, --command COMMAND
                        command to run - sync or status (defaults to sync)
  -v                    increase verbosity

GITLAB

usage: gitlab [-h] [-p PROJECT [PROJECT ...] | -g GROUP [GROUP ...]]
              [-d DESTINATION] [-t TOKEN] [-P SSH/HTTP] [-i] [-r COMMAND] [-v]

CLI GitLab API Client

optional arguments:
  -h, --help            show this help message and exit
  -p PROJECT [PROJECT ...], --projects PROJECT [PROJECT ...]
                        gitlab project names
  -g GROUP [GROUP ...], --groups GROUP [GROUP ...]
                        gitlab group names
  -d DESTINATION, --destination DESTINATION
                        destination path
  -t TOKEN, --token TOKEN
                        gitlab personal access token
  -P SSH/HTTP, --protocol SSH/HTTP
                        protocol to use - ssh or http (defaults to ssh)
  -i, --interactive     choose projects interactively
  -r COMMAND, --run COMMAND
                        command to run - sync or status (defaults to sync)
  -v                    increase verbosity