docs #4

Merged
mfocko merged 3 commits from docs into main 2021-09-11 23:57:55 +02:00
6 changed files with 43 additions and 17 deletions
Showing only changes of commit ae40226d94 - Show all commits

View file

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

View file

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

View file

@ -4,7 +4,7 @@ gitea:
repository: "testing-repo"
language:
separate_opening: false
opening: "##"
on_separate_line: false
opening: "## "
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,17 +10,19 @@ import (
)
func GetSeparatorForMultiline(config *Config) string {
if config.Language.OpeningOnSeparateLine {
if config.Language.OnSeparateLine {
return "\n"
}
return ""
}
func FormatComment(config *Config, body string, beenWrapped bool) string {
if beenWrapped && !config.Language.OpeningOnSeparateLine {
if beenWrapped {
if !config.Language.OnSeparateLine {
body = strings.TrimPrefix(body, config.Language.Continuation)
}
body = strings.TrimRightFunc(body, unicode.IsSpace)
}
return fmt.Sprintf("%s%s%s", config.Language.Opening, body, config.Language.Closing)
}
@ -39,6 +41,12 @@ func ProcessComment(config *Config, wrapper *wrap.Wrapper, comment *gitea.PullRe
strings.TrimRightFunc(config.Language.Continuation, unicode.IsSpace)+"\n",
-1,
)
body = strings.Replace(
body,
config.Language.Opening+"\n",
strings.TrimRightFunc(config.Language.Opening, unicode.IsSpace)+"\n",
-1,
)
comment.Body = FormatComment(config, body, beenWrapped)
}

View file

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