gito
git helper tool to clone/open/auto-install/edit a git project with a one-liner.
> gito cesarferreira/dryrun -e
Features
- Quickly clone any git project and changes directory.
- Can automatically open the folder in
finder
. - Can automatically open the project in any editor.
- Can clone the project into a system temporary folder.
- Auto detects project type and auto installs dependencies accordingly.
- The project type detections can be added without releasing a new
gem
version.
Usage
🚙 git clones this url: https://github.com/cesarferreira/dryrun
$ gito cesarferreira/dryrun
🚕 git clone, install, open and edit the project
$ gito cesarferreira/dryrun --edit --open
🚗 git clone on a operating system /temp/ folder, install, and edit the project
$ gito cesarferreira/dryrun --edit --temp
🚓 set the editor to be 'subl' from now on
$ gito cesarferreira/dryrun -s subl
🚕 git clone, install, open and edit the project from github on a temp folder
$ gito https://github.com/cesarferreira/dryrun -e -o -t
🏎 git clone, install from another git source
$ gito https://bitbucket.org/username/project
Installation
$ gem install gito
Help
$ gito -h
Usage: gito GIT_URL [OPTIONS]
Options
-s, --set-editor EDITOR Set a custom editor to open the project (e.g. "atom", "subl", "vim", etc.
-e, --edit Open the project on an editor
-o, --open Open the project on Finder
-d, --dryrun Does not install the dependencies
-t, --temp Clones the project into a temporary folder
-k, --keep Clones the whole git history and not just the last snapshot
-h, --help Displays help
-v, --version Displays the version
Supported type detections/auto-installs
So far it auto-installs these types:
- Ruby
- Gradle
- node.js
- C/C++
- Elixir
- Python
- Go (Govendor, Glide)
- Cocoapods
- Carthage
- Swift Package Manager
- Rust
- Haskell
Create a pull request by editing detector.json file if you want more types to be added.
Why?
A lot of times I find myself wanting to try some code from github and in order to do so I have to copy the git URL, go to the terminal, git clone, find out the folder name, go to the folder and based on the type of project I need to bundle install
, ./gradlew assemble
, npm install
, pip install .
, mix deps.get
, make install
, you name it. And after that, opening it in my text editor of choice manually... Not anymore!
Contributing
I welcome and encourage all pull requests. It usually will take me within 24-48 hours to respond to any issue or request. Here are some basic rules to follow to ensure timely addition of your request:
- If its a feature, bugfix, or anything please only change code to what you specify.
- Please keep PR titles easy to read and descriptive of changes, this will make them easier to merge :)
- Pull requests must be made against
develop
branch. Any other branch (unless specified by the maintainers) will get rejected. - Check for existing issues first, before filing an issue.
- Have fun!