Metadata-Version: 2.1
Name: gitforge
Version: 0.0.2
Summary: Git Forge API Client..
Home-page: https://github.com/tslight/gitforge
Author: Toby Slight
Author-email: tslight@pm.me
License: UNKNOWN
Description: # 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](https://github.com/settings/tokens).
        
        Generate a **GitLab** *Personal Access Token* [here](https://gitlab.com/profile/personal_access_tokens).
        
        ## OPTIONS
        
        ### GITHUB
        
        ``` text
        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
        
        ``` text
        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
        ```
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: ISC License (ISCL)
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
