Start doc comments with the name being declared.

This commit is contained in:
verytable 2020-02-02 01:14:20 +03:00
parent 7d8f8fcb31
commit ff809b73c3
3 changed files with 13 additions and 13 deletions

View file

@ -5,9 +5,8 @@ import (
"strings"
)
// List all _test.go files in given directory including the ones with "private" build tag.
//
// Returns absolute paths.
// listTestFiles returns absolute paths for all _test.go files of the package
// including the ones with "private" build tag.
func listTestFiles(rootPackage string) []string {
files := getPackageFiles(rootPackage, []string{"-tags", "private"})
var tests []string
@ -21,9 +20,8 @@ func listTestFiles(rootPackage string) []string {
return tests
}
// List all .go source files in given directory protected by "!change" build tag.
//
// Returns absolute paths.
// listProtectedFiles returns absolute paths for all files of the package
// protected by "!change" build tag.
func listProtectedFiles(rootPackage string) []string {
allFiles := getPackageFiles(rootPackage, nil)
allFilesWithoutProtected := getPackageFiles(rootPackage, []string{"-tags", "change"})
@ -39,6 +37,8 @@ func listProtectedFiles(rootPackage string) []string {
return protectedFiles
}
// listPrivateFiles returns absolute paths for all files of the package
// protected by "private,solution" build tag.
func listPrivateFiles(rootPackage string) []string {
allFiles := getPackageFiles(rootPackage, []string{})
allWithPrivate := getPackageFiles(rootPackage, []string{"-tags", "private,solution"})
@ -52,4 +52,4 @@ func listPrivateFiles(rootPackage string) []string {
sort.Strings(files)
return files
}
}

View file

@ -140,12 +140,12 @@ func copyDir(src, dst string) {
}
}
// copyDir recursively copies src contents to dst.
// copyContents recursively copies src contents to dst.
func copyContents(src, dst string) {
copyDir(src+"/", dst)
}
// Copy files preserving directory structure relative to baseDir.
// copyFiles copies files preserving directory structure relative to baseDir.
//
// Existing files get replaced.
func copyFiles(baseDir string, relPaths []string, dst string) {
@ -165,7 +165,7 @@ func copyFiles(baseDir string, relPaths []string, dst string) {
}
}
// Run all test in directory with race detector.
// runTests runs all tests in directory with race detector.
func runTests(testDir string) {
cmd := exec.Command("go", "test", "-v", "-mod", "readonly", "-tags", "private", "-race", "./...")
cmd.Env = append(os.Environ(), "GOFLAGS=")
@ -182,7 +182,7 @@ func runTests(testDir string) {
}
}
// Get absolute paths for all files in rootPackage and it's subpackages
// getPackageFiles returns absolute paths for all files in rootPackage and it's subpackages
// including tests and non-go files.
func getPackageFiles(rootPackage string, buildFlags []string) map[string]struct{} {
cfg := &packages.Config{
@ -213,7 +213,7 @@ func getPackageFiles(rootPackage string, buildFlags []string) map[string]struct{
return files
}
// Convert paths to relative (to the baseDir) ones.
// relPaths converts paths to relative (to the baseDir) ones.
func relPaths(baseDir string, paths []string) []string {
ret := make([]string, len(paths))
for i, p := range paths {

View file

@ -11,7 +11,7 @@ import (
"github.com/stretchr/testify/require"
)
// List directories in given directory.
// listDirs lists directories in given directory.
func listDirs(dir string) ([]string, error) {
files, err := ioutil.ReadDir(dir)
if err != nil {