Command line utility for quickly cloning remote SCM repositories as succintly as possible.
Project description
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:
git clone https://github.com/RenoirTan/QuickClone.git
cd QuickClone
pip install .
From PYPI:
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
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.
qkln RenoirTan/QuickClone ~/Desktop/destination
qkln RenoirTan/QuickClone -Id
In the latter example, QuickClone will ignore options.local.remotes_dir and
clone to ./QuickClone.
After cloning the remote repository, QuickClone will save where the repository was cloned to locally in a cache file. You can then use this command to see where the last repository was cloned to:
qkln -L
and then cd into that directory:
cd $(qkln -L)
As of version 0.6, QuickClone stores a history of previously cloned repositories instead of just one. You can specify which repository's path to print by specifying its index in QuickClone's history:
cd $(qkln -LZ 1) # to clone the second item
If the --last-clones-index/-Z flag is set to -1, then the list of previously
stored repositories is printed.
qkln -LZ -1
