glp/README.md

51 lines
1.7 KiB
Markdown
Raw Permalink Normal View History

2020-02-06 15:09:25 +05:00
# GLP
GLP stands for Go Licensing Processor. It is an utility that parses application's dependencies, gets their licenses and copyright information and writing gathered data into report file.
2020-02-06 15:13:25 +05:00
## Supported languages
2020-02-07 21:34:42 +05:00
* Go (dep and modules)
2020-02-06 15:13:25 +05:00
2020-02-06 15:09:25 +05:00
## Supported report file formats
2020-02-06 15:13:25 +05:00
* CSV
2020-02-06 15:09:25 +05:00
2020-02-06 15:13:25 +05:00
## Supported VCS and sites
2020-02-06 15:09:25 +05:00
2020-02-08 13:04:56 +05:00
It was tested for git repositories with various sites (github.com, gitlab.com, self-hosted Gitea, even [my giredore](https://sources.dev.pztrn.name/pztrn/giredore)). It will work with any hosting that supports ``?go-get=1`` URL parameter and which outputs go-import and go-source meta lines.
But there are some caveats appeared:
* Github most of times will not add ``go-source`` meta line in HTML's ``<head>`` tag. There are a workaround for that [here](https://sources.dev.pztrn.name/pztrn/glp/src/branch/master/structs/vcsdata.go).
2020-02-06 15:09:25 +05:00
## Installation
It is enough to issue:
```bash
go get -u go.dev.pztrn.name/glp/cmd/glp
```
2020-02-08 13:04:56 +05:00
## Usage
See `glp -h` for a list of possible options.
### Example usage
```bash
glp -config ./.glp.yaml -pkgs /home/pztrn/projects/go/src/go.dev.pztrn.name/discordrone,/home/pztrn/projects/go/src/go.dev.pztrn.name/opensaps -outfile /home/pztrn/deps-test.csv
```
2020-02-06 15:09:25 +05:00
## Configuration
2020-02-08 13:04:56 +05:00
For now you can configure only debug output for logging. See ToDo below.
## ToDo
* Ability to overwrite all things about dependency, like copyrights, license URL and so on via configuration file.
* Ability to use it as library.
* Ability to use it in CI with alerts about bad licenses.
* Ability to use it for projects written in other languages than Go (javascript, python, java, and so on).
* More outputters - PDF, xlsx and so on.
* (Maybe) Use ``go list`` output for gathering dependencies.