Comiks is a command line tool to retrieve authors informations (names and emails) in the repositories commits of a given user.
You can install the latest tagged version from PyPI.
$ pip install comiks
Or install the latest version from GitHub (branch master
).
$ pip install git+https://github.com/b0oml/Comiks
The first time comiks
runs, it will generate a config file .config/comiks/config.toml
in your home directory. This will be the default configuration file used when using comiks.
By default, only Github provider is enabled, other providers needs an API key/access token. To enable and configure others providers, you can update the configuration file in your home directory.
It is also possible to load the configuration file from another path with option -c, --config
.
$ comiks -c ./path/to/config.toml username
If you wan to create your own configuration file, you can take example on this one.
$ comiks --help
usage: comiks [-h] [-c CONFIG] [-l HIGHLIGHT] [-p TAGS] [-sb] username
Retrieve authors informations from commits.
positional arguments:
username Username for which to scan commits.
optional arguments:
-h, --help show this help message and exit
-c CONFIG, --config CONFIG
Custom config file (default is ~/.config/comiks/config.toml).
-l HIGHLIGHT, --highlight HIGHLIGHT
Strings to highlight in output, separated by a comma (default is username).
-p TAGS, --providers TAGS
Comma-sperated list of tags to select which providers to enable (default is in
config).
-sb, --show-branches Show in which branches authors have been found.
Normal scan, use config in home directory.
$ comiks b0oml
Scan using another config.
$ comiks -c my_config.toml b0oml
In tables output, comiks try to highlight names and emails similar to the given username. You can highlight based on other strings than the username by giving a comma-separated list of strings.
$ comiks -l john b0oml
$ comiks -l john,doe,something b0oml
You can enable/disable availables providers by updating config.toml. Now, let's imagine you have configured all the providers. But, for a given username, you only want to launch one of the providers. Rather than modifying the config each time this happens, you can select which provider to launch with tags.
$ comiks -p github,bitbucket b0oml
$ comiks -p gitlab b0oml
Below is listed all providers currently implemented.
Name | Url | Authentication | Enabled by default | Tags |
---|---|---|---|---|
GitHub | github.com | Not needed, but allows to get a higher API rate limit | yes | github |
GitLab | gitlab.com | Needed | no | gitlab |
Bitbucket | bitbucket.org | Needed | no | bitbucket |