refactor: Update config and clean up code

- Change naming in the config
- Add a template for config
- Try to fix an issue with «multi-line» vs «single-line» comments

Signed-off-by: Matej Focko <mfocko@redhat.com>

docs/cpp_config.yml

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

docs/haskell_config.yml

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

docs/python_config.yml

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

docs/template.yml

@@ -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"

src/core/comments.go

@@ -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)
 }
 

src/core/configuration.go

@@ -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"`