Metadata-Version: 2.1
Name: pyautogit
Version: 0.0.1
Summary: A command line interface for working with git written in python with the help of py_cui.
Home-page: https://github.com/jwlodek/pyautogit
Author: Jakub Wlodek
Author-email: jwlodek.dev@gmail.com
License: BSD 3-Clause
Description: # pyautogit
        
        A command line interface for working with git written in python with the help of [py_cui](https://github.com/jwlodek/py_cui).
        
        ### Installation
        
        An obvious prerequisit to installing `pyautogit` is to have `git` installed and in your system path. Once this is done, you may install the module.
        
        To install `pyautogit`, it is recommended to use `pip`:
        ```
        pip install pyautogit
        ```
        This will also install `py_cui`, the Command Line UI builder library upon which the project is based, and `windows-curses` if running on windows, which is a `curses` emulator for the win32 platform.
        
        Alternatively, you can install from source. Clone this repository and use `pip` to install:
        ```
        git clone https://github.com/jwlodek/pyautogit
        cd pyautogit
        pip install .
        ```
        If `pyautogit` is already installed and you would like to update it, use:
        ```
        pip install --upgrade pyautogit
        ```
        or
        ```
        cd pyautogit
        git pull
        pip install --upgrade .
        ```
        if updating a local version.
        
        
        Note that you may require root access for installing with `pip` depending on your system's python configuration.
        
        ### Usage
        
        Once `pyautogit` is installed, open a command line client (note that Windows Terminal is not yet supported), then navigate to a directory and type:
        ```
        pyautogit
        ```
        You can also specify an external directory:
        ```
        pyautogit -w /home/jwlodek/repos
        ```
        If you open `pyautogit` in a directory that contains a `.git` folder, it will treat it as a repository, while if it cannot find said folder, the target location will be treated as a workspace.
        
        **Repository Screen**
        
        
        From the repository screen, you manage the local opened repository. You may create commits, tags, push and pull, and manage branches. For more detailed information on using the Repository Screen, please check the documentation. 
        
        **Workspace Screen**
        
        The workspace screen allows for managing multiple `git` repositories at once. From here, all subdirectories that are identified as git repositories are listed, and you may open their respectiver repository screens. Also, you may clone new repositories, as well as create new blank repositories.
        
        **Credential Management**
        
        When an action is performed that requires credentials (ex. git push), `pyautogit` will ask for your git remote username and password. These are then stored as environment variables for the running process, and are used with `git askpass` to perform operations. As a result, if you open an editor after credentials are entered (ex. VSCode), and use the integrated terminal to process `git` commands, you will not have to enter credentials again. Credentials are stored only for the duration the window is open, and must be re-entered after each restart.
        
        ### License
        
        BSD 3-Clause License
        
        Copyright (c) 2020, Jakub Wlodek
        All rights reserved.
Keywords: git command-line cli cui curses
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Description-Content-Type: text/markdown
Provides-Extra: test
