Comment ouvrir votre propre bibliothèque Go

Lorsque nous développons des projets Go, nous utilisons souvent des packages de dépendances externes. Ils ont généralement la forme <code style="letter-spacing: 1px; word-spacing: 3px; text-align: left; font-size: 14px; overflow-wrap: break-word; padding: 2px 4px; border-radius: 4px; margin-right: 2px; margin-left: 2px; font-family: " operator mono consolas monaco menlo monospace word-break: break-all background: rgba><span style="font-size: 15px;">go get example.com/xxx</span>的命令形式获取到本地使用。

本着开源精神，如果我们想将自己开发的包共享出去，让其他人也能使用<span style="font-size: 15px;">go get</span>allez chercher example.com/xxx formulaire de commande pour obtenir une utilisation locale.

Dans l'esprit de l'open source, si nous souhaitons partager les packages que nous développons afin que d'autres puissent les utiliser

go get

commande pour les récupérer, que dois-je faire ?

Cet article prendra l'open source sur la plateforme Github comme exemple pour montrer le processus.

Créer un entrepôt

Tout d'abord, créez un entrepôt sur la plateforme github et définissez le nom de la bibliothèque Go que vous souhaitez ouvrir en source. Ici, le nom du projet est publidemo et le statut est Public.

🎜🎜Développer le code du module🎜🎜🎜🎜Tirez l'entrepôt créé vers le développement local via la commande git clone. 🎜🎜

$ git clone git@github.com:golangShare/publishdemo.git

En ce moment, dans le répertoire racine du projet<code style="font-size: 14px;overflow-wrap: break-word;padding: 2px 4px;border-radius: 4px;margin-right: 2px;margin-left: 2px;font-family: " operator mono consolas monaco menlo monospace break-all rgba><span style="font-size: 15px;">publishdemo/</span>下，仅包含了 LICENSE 和 README 文件，不包含任何 Go 代码。

$ ls
LICENSE   README.md

为项目初始化 mod 文件

$ go mod init github.com/golangShare/publishdemo

假设，我们想开源的 Go 工具类的库，此时准备先提供的是对字符串相关的操作。因此在<code style="font-size: 14px;overflow-wrap: break-word;padding: 2px 4px;border-radius: 4px;margin-right: 2px;margin-left: 2px;font-family: " operator mono consolas monaco menlo monospace break-all rgba><span style="font-size: 15px;">publishdemo/</span>目录下，我们新增<span style="font-size: 15px;">stringutil/</span>publishdemo/, seuls les fichiers LICENSE et README sont inclus, et aucun code Go n'est inclus.

package stringutil

// Reverse returns its argument string reversed rune-wise left to right.
func Reverse(s string) string {
 r := []rune(s)
 for i, j := 0, len(r)-1; i < len(r)/2; i, j = i+1, j-1 {
  r[i], r[j] = r[j], r[i]
 }
 return string(r)
}

Initialisez le fichier mod du projet

package stringutil

import "testing"

func TestReverse(t *testing.T) {
 for _, c := range []struct {
  in, want string
 }{
  {"Hello, world", "dlrow ,olleH"},
  {"Hello, 世界", "界世 ,olleH"},
  {"", ""},
 } {
  got := Reverse(c.in)
  if got != c.want {
   t.Errorf("Reverse(%q) == %q, want %q", c.in, got, c.want)
  }
 }
}

Supposons que nous souhaitions ouvrir la bibliothèque de classes d'outils Go À ce stade, nous allons d'abord fournir les opérations liées aux chaînes. Donc dans

<p data-tool="mdnice编辑器" style="padding-top: 8px;padding-bottom: 8px;line-height: 26px;font-size: 17px;word-spacing: 3px;letter-spacing: 1px;">publishdemo/<span style="font-size: 15px;"></span></p>Sous le répertoire, nous avons ajouté <p data-tool="mdnice编辑器" style="padding-top: 8px;padding-bottom: 8px;line-height: 26px;font-size: 17px;word-spacing: 3px;letter-spacing: 1px;">stringutil/<span style="font-size: 15px;"></span></p>sous-répertoire, ajouter dans le sous-répertoire reverse. go fichier, son contenu est le suivant.

.
├── LICENSE
├── README.md
├── go.mod
└── stringutil
    ├── reverse.go
    └── reverse_test.go

1 directory, 5 files

C'est très simple, ce que nous voulons fournir est une fonction flip string.

Bien sûr, nous devons également fournir du code de test. Ajoutez le fichier reverse_test.go dans le répertoire de même niveau avec le contenu suivant.

$ go test ./...
ok   github.com/golangShare/publishdemo/stringutil 0.005s

Retournez au répertoire racine du projet À l'heure actuelle, la structure du code est la suivante

$ go mod tidy

Le code de test a également été développé par

$ git commit -m "add Reverse: for v0.1.0"
$ git tag v0.1.0

, et nous pouvons partager la bibliothèque d'outils.

🎜🎜🎜Release🎜🎜🎜🎜Afin d'éviter que des dépendances inutiles ne soient enregistrées dans le module, exécutez go mod spice pour les supprimer. 🎜🎜

$ git push origin v0.1.0

🎜🎜Utilisez la commande git tag pour marquer les informations de version🎜🎜

$ go get github.com/golangShare/publishdemo@v0.1.0

🎜🎜Push-le vers le référentiel distant🎜🎜

$ git push origin v0.1.0

使用

发布之后，其他项目就可以通过以下命令获取我们开源的 Go 包了。

$ go get github.com/golangShare/publishdemo@v0.1.0

此时项目 go.mod 文件中，将会增加以下一行记录

require github.com/golangShare/publishdemo v0.1.0

和其他三方库一样的方式使用即可

package main

import (
 "fmt"
 "github.com/golangShare/publishdemo/stringutil"
)

func main() {
 s := stringutil.Reverse("hello gopher")
 fmt.Println(s)
}

总结

看完了上述流程，可以发现：开源自己的 Go 库，其实非常简单。

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!