74 lines
1.8 KiB
Markdown
74 lines
1.8 KiB
Markdown
|
# Gitto
|
||
|
|
||
|
For lack of a better title.
|
||
|
|
||
|
My simple utility to keep track of all the git repositories I have on
|
||
|
my computer(s). Also an experiment in writing scheme.
|
||
|
|
||
|
Written for `guile` 2.0.x
|
||
|
|
||
|
## Installation
|
||
|
|
||
|
Installing `gitto` is not really necessary, but it *is* more
|
||
|
convenient. In order to install it just run:
|
||
|
|
||
|
# make install
|
||
|
|
||
|
This will install `gitto` to `/usr/local/`, if you would like it
|
||
|
somewhere else you could use the `DESTDIR` variable:
|
||
|
|
||
|
# make install DESTDIR=/some/other/place
|
||
|
|
||
|
This will install `gitto` to `/some/other/place/`.
|
||
|
|
||
|
## Removal
|
||
|
|
||
|
If you're fed up with `gitto` and want it gone, and I do mean **now**,
|
||
|
you can run:
|
||
|
|
||
|
# make uninstall
|
||
|
|
||
|
This will remove any `gitto` installed files from `/usr/local/`, if
|
||
|
you used the `DESTDIR` variable during installation, you should give
|
||
|
it the same value here, like:
|
||
|
|
||
|
# make uninstall DESTDIR=/some/other/place
|
||
|
|
||
|
This will remove any `gitto` installed files from
|
||
|
`/some/other/place/`.
|
||
|
|
||
|
## Usage
|
||
|
|
||
|
Usage is, hopefully, simple, first you have to register some repos:
|
||
|
|
||
|
$ gitto -r ~/projects/project1
|
||
|
$ gitto -r ~/projects/project2
|
||
|
$ gitto -r ~/projects/project3
|
||
|
|
||
|
Then you can call `gitto` without any argument to see a list of your
|
||
|
repos and their statuses:
|
||
|
|
||
|
$ gitto
|
||
|
project1: 0 to push, 0 to pull and is dirty
|
||
|
project2: 5 to push, 2 to pull and is not dirty
|
||
|
project3: 0 to push, 1 to pull and is not dirty
|
||
|
|
||
|
If you're done with one of your projects and no longer wish to track
|
||
|
their status you can unregister them:
|
||
|
|
||
|
$ gitto -R ~/projects/project1
|
||
|
|
||
|
|
||
|
If you require further assistance:
|
||
|
|
||
|
$ gitto -h
|
||
|
|
||
|
### `run-gitto`
|
||
|
|
||
|
As I mentioned, it is not completely necessary to install gitto, I
|
||
|
have added a utility to run it straight from je project directory,
|
||
|
although mostly for testing purposes.
|
||
|
|
||
|
Using `run-gitto` works exactly the same as using `gitto` when it is
|
||
|
installed.
|