docs #4

Merged
mfocko merged 3 commits from docs into main 2021-09-11 23:57:55 +02:00
7 changed files with 59 additions and 22 deletions

15
README.md Normal file
View file

@ -0,0 +1,15 @@
# `frag-review`
This tool allows syncing reviews from pull requests back into the source files.
## Configuration
For each repository you should have separate config that decides which repository is the upstream and
how are the review comments to be formatted.
## Environment variables
### `GITEA_TOKEN`
`GITEA_TOKEN` is the only environment variable that is used for Gitea API of the specific instance
configured in config.

View file

@ -4,7 +4,7 @@ gitea:
repository: "testing-repo" repository: "testing-repo"
language: language:
separate_opening: true on_separate_line: true
opening: "/**" opening: "/** "
continuation: " ** " continuation: " ** "
closing: " **/\n" closing: "\n **/\n"

View file

@ -4,7 +4,7 @@ gitea:
repository: "testing-repo" repository: "testing-repo"
language: language:
separate_opening: false on_separate_line: false
opening: "-- #" opening: "-- # "
continuation: "-- # " continuation: "-- # "
closing: "" closing: "\n"

View file

@ -4,7 +4,7 @@ gitea:
repository: "testing-repo" repository: "testing-repo"
language: language:
separate_opening: false on_separate_line: false
opening: "##" opening: "## "
continuation: "## " continuation: "## "
closing: "" closing: "\n"

18
docs/template.yml Normal file
View file

@ -0,0 +1,18 @@
gitea:
# instance URL with both protocol and port, if necessary
instance_url: "fill in"
# owner of the repository, usually user's login, i.e. namespace of the repository
owner: "fill in"
# repository name
repository: "fill in"
language:
# boolean value that is used to decide if multiline review comments have opening and closing
# symbols on the separate line
on_separate_line: true
# sequence that opens comment
opening: "/** "
# sequence that is used for multiline comments, i.e. prefixing the lines
continuation: " ** "
# sequence that closes off the comment, including newline
closing: "\n **/\n"

View file

@ -10,18 +10,18 @@ import (
) )
func GetSeparatorForMultiline(config *Config) string { func GetSeparatorForMultiline(config *Config) string {
if config.Language.OpeningOnSeparateLine { if config.Language.OnSeparateLine {
return "\n" return "\n"
} }
return " " return ""
} }
func FormatComment(config *Config, body string, beenWrapped bool) string { func FormatComment(config *Config, body string, beenWrapped bool) string {
if beenWrapped && !config.Language.OpeningOnSeparateLine { if beenWrapped {
body = " " + strings.TrimPrefix(body, " "+config.Language.Continuation) if !config.Language.OnSeparateLine {
} body = strings.TrimPrefix(body, config.Language.Continuation)
if !beenWrapped && !config.Language.OpeningOnSeparateLine && !strings.HasSuffix(body, "\n") { }
body = body + "\n" body = strings.TrimRightFunc(body, unicode.IsSpace)
} }
return fmt.Sprintf("%s%s%s", config.Language.Opening, body, config.Language.Closing) return fmt.Sprintf("%s%s%s", config.Language.Opening, body, config.Language.Closing)
} }
@ -32,8 +32,6 @@ func ProcessComment(config *Config, wrapper *wrap.Wrapper, comment *gitea.PullRe
beenWrapped := len(body)+len(config.Language.Opening)+len(config.Language.Closing) > 100 beenWrapped := len(body)+len(config.Language.Opening)+len(config.Language.Closing) > 100
if beenWrapped { if beenWrapped {
body = GetSeparatorForMultiline(config) + wrapper.Wrap(body, 100) body = GetSeparatorForMultiline(config) + wrapper.Wrap(body, 100)
} else {
body = " " + body
} }
body = strings.Replace(body, "\r", "", -1) body = strings.Replace(body, "\r", "", -1)
@ -43,6 +41,12 @@ func ProcessComment(config *Config, wrapper *wrap.Wrapper, comment *gitea.PullRe
strings.TrimRightFunc(config.Language.Continuation, unicode.IsSpace)+"\n", strings.TrimRightFunc(config.Language.Continuation, unicode.IsSpace)+"\n",
-1, -1,
) )
body = strings.Replace(
body,
config.Language.Opening+"\n",
strings.TrimRightFunc(config.Language.Opening, unicode.IsSpace)+"\n",
-1,
)
comment.Body = FormatComment(config, body, beenWrapped) comment.Body = FormatComment(config, body, beenWrapped)
} }

View file

@ -14,10 +14,10 @@ type Config struct {
Token string Token string
} `yaml:"gitea"` } `yaml:"gitea"`
Language struct { Language struct {
OpeningOnSeparateLine bool `yaml:"separate_opening"` OnSeparateLine bool `yaml:"on_separate_line"`
Opening string `yaml:"opening"` Opening string `yaml:"opening"`
Continuation string `yaml:"continuation"` Continuation string `yaml:"continuation"`
Closing string `yaml:"closing"` Closing string `yaml:"closing"`
} `yaml:"language"` } `yaml:"language"`
} }