Metadata-Version: 2.1
Name: RepMan
Version: 1.0.4
Summary: RepMan: Repository Manager (alias: Project Manager)
Author-email: Soumyo Deep Gupta <deep.main.ac@gmail.com>
Maintainer-email: Soumyo Deep Gupta <deep.main.ac@gmail.com>
License: MIT License
        
        Copyright (c) 2024 Soumyo Deep Gupta
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: GitHub, https://github.com/d33pster/RepMan
Project-URL: Issues, https://github.com/d33pster/RepMan/issues
Project-URL: Homepage, https://d33pster.github.io/RepMan/
Keywords: d33pster,repman,RepMan,Repo Man,Repository Manager
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: optioner>=1.4.5
Requires-Dist: termcolor
Requires-Dist: gdown
Requires-Dist: tk
Requires-Dist: pandas
Requires-Dist: tabulate
Requires-Dist: requests

![PyPI - Version](https://img.shields.io/pypi/v/RepMan?color=bright%20green)
![PyPI - Wheel](https://img.shields.io/pypi/wheel/RepMan)
![GitHub License](https://img.shields.io/github/license/d33pster/RepMan)
![Python Version from PEP 621 TOML](https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2Fd33pster%2FRepMan%2Fmain%2Fpyproject.toml)
[![Build status](https://ci.appveyor.com/api/projects/status/bbptf69j4n86fthj?svg=true)](https://ci.appveyor.com/project/d33pster/repman)

# Overview

RepMan or Repository Manager is written on python to serve as GitHub Repo Manager for the end users.

Have a lot of repositories you've been working on? Is it a hassle? RepMan is your solution.

## What RepMan offers

- RepMan will organize all the github repos you have under one management.
- RepMan will help you find your repositories and update them (add, commit and push the changes.)
- RepMan will help you start working on your project right away with just one command.
- More to come.

## Requirements

- python>=3.9

### Note

- Currently supports only Visual Studio Code as the default editor.
- In MacOS arm64 and Debian Linux aarch64, if vscode and git are not installed, it will be automatically installed using `-i` or `--init` option of RepMan.
- In other Operating Systems, it is recommended to have Visual Studio Code and Git pre-installed.

- Git Installations
    ```bash
    # for Debian Linux,
    sudo apt install git

    # for macOS, use homebrew or other package managers

    # for windows, download the windows installer from the git-scm website.

    # for installation using homebrew
    brew install git
    ```
    For Other Operating systems, visit the official site of [ [git](https://git-scm.com/downloads) ] to download respective supported versions of git.

- Visual Studio Code Installation

    ```bash
    # if you have home brew
    brew install --cask visual-studio-code
    ```
    Else, Go to [ [Visual Studio Code](https://code.visualstudio.com/download) ] to download for your OS.

- Supports all versions of Apple Laptops with Apple Silicon chip and arm64 architecture.

### Git setup Note

Git requires git credential manager to log in to your account so that you can clone private repositories. In windows, it is by default installed while installing git using the gui installer. But in other Operating Systems, it needs to be installed and configured manually.

I'd suggest to use GitHub Cli instead to manage your credentials.

- Installation:
    ```bash
    # using homebrew,
    brew install gh

    # or in debian Linux,
    sudo apt install gh
    ```
- setup
    ```bash
    # run the following command in terminal and follow the steps 
    gh auth login
    ```

## Installation

RepMan is very easy to install.

```bash
# install using pip

pip install RepMan
```
```bash
# install by cloning this git repository.

git clone https://github.com/d33pster/RepMan.git
cd RepMan
pip install .
```

After installation, run the following command. (make sure to install vscode and git if you're not using the supported OS.)
```bash
repman -i

# or

repman --init
```

## Usage

For usage, run

```bash
repman -h

# or

repman --help
```

For option specific help, run

```bash
repman <option> -h

# or 

repman <option> --help
```

## Usage screenshots

<img src='images/update.png'>

## Supported OS and architectures and notes
- MacOS (Apple Silicon Chip - M series) (Arch - arm64) (Requires Homebrew)
- Linux (Debian) (Arch - aarch64)
- **If your OS and arch is not listed here, just make sure to install VSCode and git on your own, rest is same.**

## Uninstall

Uninstall using pip
```bash
pip uninstall RepMan
```
