I work on a lot of FOSS projects, it's literally part of my job. Unfortunately this means that moving around my project directories (especially my GOPATH) can get insanely burdensome. So I wrote this CLI to basically emulate my much beloved projectile tool in Emacs. This CLI can be viewed as a "no setup" required version of mr (myrepos). But a bit more flexible than that.
You can install projector from crates.io via cargo:
cargo install projector
Or you can build it locally with:
git clone https://github.com/chasinglogic/projector $PATH_TO_PROJECTOR
cd $PATH_TO_PROJECTOR
cargon install --path .
``` projector 0.1.0 Mathew Robinson chasinglogic@gmail.com
USAGE: projector [OPTIONS] [SUBCOMMAND]
FLAGS: -h, --help Prints help information -V, --version Prints version information
OPTIONS:
-c, --code-dir
SUBCOMMANDS: help Prints this message or the help of the given subcommand(s) list run ```
Projector considers any git repo as a "project". In future versions I will
expand this definition but it works for me now so that's the way it is.
Additionally, projector operates off of the assumption that you have all of your
code / projects under one directory. For myself I use ~/Code.
Projector has two functions: list and run.
list will literally print a list of the projects under your code directory.
You may be wondering, what would I use this for? The answer is quickly moving around!
You can create a bash function in your bashrc like this:
function sp() {
cd $(projector list | grep -i $1)
}
Now if you source your bashrc and type sp $name_of_a_project you will
instantly be transported to your project directory. For example:
Users/chasinglogic λ . .bashrc
Users/chasinglogic λ sp projector
Code/projector master λ sp dfm
chasinglogic/dfm master λ pwd
/Users/chasinglogic/Code/go/src/github.com/chasinglogic/dfm
chasinglogic/dfm master λ
Optionally, if you have another tool I'm fond of called FZF you can take this a step further and make a fuzzy searchable list of your projects:
function sp() {
cd $(projector list | fzf)
}
Now you get something like this:
``` /Users/chasinglogic/Code/mongodb/mongo-tools /Users/chasinglogic/Code/mongodb/kernel-tools /Users/chasinglogic/Code/mongodb/evergreen-packer /Users/chasinglogic/Code/mongodb/chef-repo /Users/chasinglogic/Code/mongodb/mongo-release-tools /Users/chasinglogic/Code/website /Users/chasinglogic/Code/python/praelatus /Users/chasinglogic/Code/python/praelatus/.venv/src/elasticutils /Users/chasinglogic/Code/python/projector /Users/chasinglogic/Code/archive/projector /Users/chasinglogic/Code/projector /Users/chasinglogic/Code/go/src/github.com/pkg/errors /Users/chasinglogic/Code/go/src/github.com/praelatus/praelatus /Users/chasinglogic/Code/go/src/github.com/praelatus/praelatus-poc /Users/chasinglogic/Code/go/src/github.com/chasinglogic/dfm /Users/chasinglogic/Code/go/src/github.com/chasinglogic/fireplace /Users/chasinglogic/Code/go/src/github.com/mattn/go-zglob /Users/chasinglogic/Code/go/src/github.com/josharian/impl /Users/chasinglogic/Code/go/src/github.com/jstemmer/gotags /Users/chasinglogic/Code/go/src/github.com/dgrijalva/jwt-go /Users/chasinglogic/Code/go/src/github.com/fatih/motion /Users/chasinglogic/Code/go/src/github.com/fatih/gomodifytags /Users/chasinglogic/Code/go/src/github.com/dominikh/go-tools /Users/chasinglogic/Code/go/src/github.com/goreleaser/goreleaser /Users/chasinglogic/Code/go/src/github.com/goreleaser/archive /Users/chasinglogic/Code/go/src/github.com/nsf/gocode /Users/chasinglogic/Code/go/src/github.com/davidrjenni/reftools /Users/chasinglogic/Code/go/src/github.com/alecthomas/gometalinter /Users/chasinglogic/Code/go/src/github.com/kisielk/errcheck /Users/chasinglogic/Code/go/src/github.com/kisielk/gotool /Users/chasinglogic/Code/go/src/github.com/zmb3/gogetdoc /Users/chasinglogic/Code/go/src/github.com/google/go-github /Users/chasinglogic/Code/go/src/github.com/google/go-querystring /Users/chasinglogic/Code/go/src/github.com/golang/lint /Users/chasinglogic/Code/go/src/github.com/rogpeppe/godef /Users/chasinglogic/Code/go/src/github.com/apex/log /Users/chasinglogic/Code/go/src/github.com/urfave/cli /Users/chasinglogic/Code/go/src/github.com/klauspost/asmfmt /Users/chasinglogic/Code/go/src/github.com/gorilla/mux /Users/chasinglogic/Code/go/src/golang.org/x/sync /Users/chasinglogic/Code/go/src/golang.org/x/oauth2 /Users/chasinglogic/Code/go/src/golang.org/x/net /Users/chasinglogic/Code/go/src/golang.org/x/tools /Users/chasinglogic/Code/go/src/golang.org/x/crypto /Users/chasinglogic/Code/go/src/honnef.co/go/tools /Users/chasinglogic/Code/go/src/gopkg.in/mgo.v2
/Users/chasinglogic/Code/go/src/gopkg.in/yaml.v2 56/56
```
and you can search and select using FZF's awesome interface:
```
/Users/chasinglogic/Code/archive/projector /Users/chasinglogic/Code/python/projector /Users/chasinglogic/Code/projector 3/56 projector ```
Enter and voila!:
Users/chasinglogic λ sp
Code/projector master λ pwd
/Users/chasinglogic/Code/projector
Code/projector master λ
Run allows you to run shell commands in all of your projects. For example if you wanted to run git status on every project:
``` Code/projector master λ projector run git status nothing to commit, working tree clean On branch emacs-26 Your branch is up-to-date with 'origin/emacs-26'.
Untracked files:
(use "git add
update.sh
nothing added to commit but untracked files present (use "git add" to track) On branch master Your branch is up-to-date with 'origin/master'.
Changes not staged for commit:
(use "git add
modified: Cargo.lock
no changes added to commit (use "git add" and/or "git commit -a") On branch master Your branch is up-to-date with 'origin/master'.
nothing to commit, working tree clean On branch master Your branch is up-to-date with 'origin/master'.
nothing to commit, working tree clean Code/projector master λ ```
Any flags you pass after the program will get passed to the program so you can type the command just like you would normally, no weird shell quoting!
Copyright 2018 Mathew Robinson <chasinglogic@gmail.com>. All rights reserved.
Use of this source code is governed by the GPLv3 license that can be found in
the LICENSE file.