Metadata-Version: 2.1
Name: quickclone
Version: 0.3.0
Summary: Command line utility for quickly cloning remote SCM repositories as succintly as possible.
Home-page: https://github.com/RenoirTan/QuickClone
Author: RenoirTan
Author-email: renoirtan2005@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Version Control
Classifier: Topic :: Utilities
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE

# QuickClone
Command line utility for quickly cloning remote SCM repositories as succintly as possible.

This project is a prime example of spending 24 hours to save 2 seconds.

## Notes

Currently, only git is supported. I might add mercurial and then subversion
later.

## Installation

From source:

```shell
git clone https://github.com/RenoirTan/QuickClone.git
cd QuickClone
pip install .
```

From [PYPI](https://pypi.org):

```shell
pip install quickclone
```

Both ways should install `qkln` and `quickclone` to PATH, meaning you don't have
to call quickclone using `python -m quickclone`. `qkln` and `quickclone` are
both entry points to the same *main* function, so you can call either command.

## Configuration

You can configure QuickClone by editing `~/.config/quickclone.toml`.


## Examples

```shell
qkln RenoirTan/QuickClone
```

If `options.local.remotes_dir` is defined, QuickClone will clone the repo into
a folder in that directory. For example, if `options.local.remotes_dir` is
defined as `~/Code/remote`, the repo will be cloned to
`~/Code/remote/github.com/RenoirTan/QuickClone`.

You can also override `options.local.remotes_dir` by specifying the destination
path or adding the `-Id` flag to the command.

```shell
qkln RenoirTan/QuickClone ~/Desktop/destination
```

```shell
qkln RenoirTan/QuickClone -Id
```

In the latter example, QuickClone will ignore `options.local.remotes_dir` and
clone to `./QuickClone`.


