Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jwlodek/pyautogit

A TUI for working with git repositories written in python using py_cui.
https://github.com/jwlodek/pyautogit

command-line command-line-interface command-line-tool cui git python terminal tui

Last synced: about 2 months ago
JSON representation

A TUI for working with git repositories written in python using py_cui.

Host: GitHub
URL: https://github.com/jwlodek/pyautogit
Owner: jwlodek
License: bsd-3-clause
Created: 2019-10-01T13:27:24.000Z (almost 5 years ago)
Default Branch: master
Last Pushed: 2020-07-05T18:43:06.000Z (about 4 years ago)
Last Synced: 2024-07-06T03:51:36.844Z (3 months ago)
Topics: command-line, command-line-interface, command-line-tool, cui, git, python, terminal, tui
Language: Python
Homepage: https://jwlodek.github.io/pyautogit-docs
Size: 901 KB
Stars: 96
Watchers: 5
Forks: 8
Open Issues: 3
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

awesome-tuis - pyautogit
awesome - jwlodek/pyautogit - A TUI for working with git repositories written in python using py_cui. (Python)

README

# pyautogit ![](https://travis-ci.org/jwlodek/pyautogit.svg?branch=master) [![Downloads](https://pepy.tech/badge/pyautogit)](https://pepy.tech/project/pyautogit) [![PyPI version](https://badge.fury.io/py/pyautogit.svg)](https://badge.fury.io/py/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. You will also require python 3.4+, and
`python3` and `python` must be reachable on your system `PATH` for operations that require git credentials.
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.

### Demo

Below is a quick demo of using `pyautogit` to do some common git actions.

### 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.

Use the keyboard shortcut descriptions listed in the status bar at the bottom of the window to navigate the interface and menus.

### License

BSD 3-Clause License