Aller: Comment inclure une bibliothèque externe et exclure les dépendances inutiles

TL; DR: générateur de code.

Imaginez que vous développiez une bibliothèque prenant en charge divers pilotes de stockage: Postgresql, Scylla, JSON et quelques autres.

Chacun de ces pilotes a des dépendances externes sur d'autres bibliothèques. Postgresql - base de données / sql, github.com/lib/pq. Scylla - github.com/scylladb/gocql ou standard github.com/gocql/gocql. JSON - github.com/mailru/easyjson ou github.com/json-iterator/go, ou encoding / json.

.

, : Postgres , , .

, .

, . : sql.go, cql.go, json.go.

, .

pkger .

pkger —

    files := make([]string, 0)

    if *cql {
        files = append(files, pkger.Include("/cql.go"))
    }

    if *json {
        files = append(files, pkger.Include("/json.go"))
    }

    if *sql {
        files = append(files, pkger.Include("/sql.go"))
    }

pkger -o <   >

, .

go generate

//go:generate pkger -o <   >

, .

— Go, .

    for i := range files {
        _, filename := filepath.Split(files[i])

        in, err := pkger.Open(files[i])
        if err != nil {
            panic(err)
        }

        src := []byte(fmt.Sprintf(genStr, strings.Join(os.Args[1:], " ")))

        reader := bufio.NewReader(in)

        for {
            line, err := reader.ReadBytes('\n')
            if strings.HasPrefix(string(line), "package ") {
                line = []byte(fmt.Sprintf("package %s\n", *pkgName))
            }

            src = append(src, line...)

            if err == io.EOF {
                break
            }

            if err != nil {
                panic(err)
            }
        }

        if err := ioutil.WriteFile(filename, src, 0644); err != nil {
            panic(err)
        }

        in.Close()
    }

“cmd/< >”. , .

go get github.com/< >/< >/<  >

Et puis lance le générateur de code dans son projet

<    > -sql

Lorsque vous avez besoin de mettre à jour votre bibliothèque - l'utilisateur met à jour le générateur de code

go get -u github.com/< >/< >/<  >

Et puis ça recommence la génération.

Un exemple de cette approche d'utilisation des dépendances est I et crekerimplémentée dans la bibliothèque nan : vous pouvez travailler avec la bibliothèque à la fois dans le mode habituel, via l'importation, et dans la version de génération de code.