Auto-Git 🚀

Auto-Git is a set of command-line utilities for managing GitHub repositories and their contents directly from the terminal. It simplifies common GitHub tasks such as creating, deleting, and listing repositories, as well as listing the contents of those repositories.

Table of Contents 📚

1. Installation
2. Install Dependencies
3. Setup
4. Examples
5. Requirements
6. Exit Status Codes
7. Authors
8. Bugs and Feedback
9. Generate Personal Access Token

---

Commands

Here’s a list of the available commands and their descriptions:

Command	Description
gls	Lists the repository.
gmkdir	Creates a new directory and adds it to Git.
grmdir	Removes a directory and its contents from Git.
gpush	Commits and pushes changes to the remote repo.
gls + reponame	Lists the contents of the specified repository.

Installation 🛠

Follow these steps to install Auto-Git:

Step 1: Clone the Repository

Clone this repository to your local machine by running:

git clone https://github.com/Acrsahil/Auto-Git.git
cd Auto-Git

Step 2: Install Dependencies

Make sure you have python3 and pip installed

Setup Instructions ⚙️

Before using Git-Auto, ensure that you have configured your GitHub access token for authentication.

Generate GitHub Personal Access Token

Visit your GitHub Personal Access Tokens page.
Click Generate new token.
Select the necessary permissions (e.g., repo for full repository access).
Save the token securely.

Step 3: Run to install

./install.py

It will ask you to input your GitHub access token.

Examples

Create a Repository:📂

gmkdir new-awesome-project

This will create a new repository named new-awesome-project.

Delete Repositories:🗑

grmdir repo1 repo2

This will delete the repositories repo1 and repo2 from your GitHub account.

List Repositories:📜

gls

This will list all the repositories in your GitHub account.

List Repositories Contents:📁

gls repo1 repo2

This will list all the contents inside your repo1 and repo2.

Requirements 📌

Python 3.x
GitHub Personal Access Token with appropriate permissions
requests library (Install with pip install requests)

Exit Status Codes 🚦

0: Success ✅
1: General error ❌
2: Authentication failure 🔐
3: Invalid repository name ⚠️

Authors 👨‍💻👩‍💻

Sahil Acharya : Creator and Lead Developer 💻

Bugs and Feedback 🐞

If you encounter any issues or have suggestions for improvements, please open an issue on the GitHub Repository. We'd love to hear from you! 😄

Happy automating! 🚀