semvec/pypi-packages huggingface dataset:
git-grab 0.7.0
Git Helper Tool
License: MIT
Requires Python: <4.0,>=3.9

# Git Grab

Git Helper Tool used to quickly add repo's to the users system for an external source.
With not having to worry about were the repo is being stored.

Initial Goals of the project

-   Create a tool to help download git repos
-   Repos are sorted by which site and user they belong to.
```
code
└── github.com
    └── Boomatang
      ├── dotfiles
      └── git-grab
```

## Installation

To install grab, run this command in your terminal:

`git` needs to be installed before using `git-grab`

```
$ pipx install git-grab
```

## Usage

### Overview
```
grab <url-to-repo>
grab -r <url-to-remote-repo>
grab --help
```

### Configuring
The environment variable `GARB_PATH` can be set to insure the default local of for storing the repos.
At any time the environment variable can be overridden by the `-p` flag.

### Cloning a repo
To cloning a repo can be done using both the ssh or https routes.
When cloning, the data is stored in the path defined in `GRAB_PATH`.
```shell
grab <repo route>
```
To override the path at run time the `-p` flag can be used.
```shell
grab <repo route> -p <some/other/path>
```

### Adding remotes to repos.
The `-r` flag can be used to say the repo path is a remote of an existing repo.
```shell
grab -r <repo route>
```
This adds the `repo route` to all cloned repos in the path where the repo name matches.
Using the `-p` flag allows setting the path where to search for repos.
```shell
grab -r <repo route> -p <some/other/path>
```

## Warning
All the functions are case-sensitive.
This can be problematic when adding remotes to existing cloned repos.

## Dev
### Creating the changelog

On new changes a news fragment is required.
This can be created by and news fragments to the `changes` directory.
These files are should have the following naming schema `<issue id>.<feature|bugfix|dic|removal|misc>`.
Using `towncrier create -c "change message" <file name>` will also create the file for you in the correct location.


# Git_Grab 0.7.0 (2025-03-22)

### Features

- Update the version display to use built in features (#18)
- Configuration of MyPy, now there is strict types (#26)

### Bugfixes

- Fix fetch on origin not being configured during the initial setup (#23)

### Improved Documentation

- Configure towncrier for the changelog (#12)

### Deprecations and Removals

- Remove support for python 3.8 (#20)

### Misc

- #13, #14, #19