Go module

Un modul Go este o unitate versionabilă alcătuită din unul sau mai multe pachete. Este fundamentul sistemului modern de dependență (Go 1.11+): nu mai sunt GOPATH, nu mai sunt vendor obligatorii, dependențe explicite și reproductibile.

go.mod: manifestul modulului

module example.com/myapp

go 1.22

require (
    github.com/google/uuid v1.6.0
    golang.org/x/time     v0.5.0
)

Trei directive principale:

• module <path> — calea de import a modulului. Toate pachetele interne sunt importate ca example.com/myapp/sub/pkg. Nu trebuie să fie o adresă URL reală, dar pentru a publica prin go get trebuie să se rezolve.
• go <version> — versiunea Go minimă necesară (utilizată și pentru a controla caracteristicile de limbă permise, de exemplu, range-over-func în 1.23).
• require — dependențele directe cu versiunea lor exactă.

Alte directive: replace (înlocuiește un dep cu o bifurcătură sau o cale locală), exclude, retract.

go.sum: fișierul de blocare criptografic

Alături de go.mod, go.sum conține un hash criptografic al FIECARE versiune descărcată (inclusiv dependențe tranzitive). Garantează reproductibilitatea: dacă cineva modifică o versiune publicată, construirea eșuează.

Comitați-l întotdeauna. Este actualizat automat prin comenzi go.

Comenzi esențiale

go mod init example.com/myapp        # create go.mod
go get github.com/google/uuid        # add the dep at its latest version
go get github.com/google/uuid@v1.5.0 # specific version
go get -u ./...                      # upgrade every dep
go mod tidy                          # remove unused deps, add missing ones
go mod download                      # download everything into the cache
go mod why github.com/x/y            # explain why a dep is included
go mod graph                         # full dependency graph

go mod tidy este cel pe care îl rulați după fiecare modificare a importurilor: garantează că go.mod reflectă exact pachetele utilizate efectiv.

Versiune de import semantic (SIV)

Versiunile urmează SemVer: v1.2.3 = MAJOR.MINOR.PATCH. Partea interesantă este major v2+:

• Major v0 și v1 → cale normală: github.com/foo/bar.
• Major v2 sau mai târziu → calea include versiunea majoră: github.com/foo/bar/v2.

import "github.com/foo/bar/v2"

Aceasta vă permite să importați atât v1 cât și v2 ale aceleiași biblioteci în același timp (util în timpul migrărilor progresive).

Importați căi și pachete interne

Dacă modulul dvs. este example.com/myapp, un subdosar utils/ este importat ca:

import "example.com/myapp/utils"

Calea depinde doar de numele declarat în go.mod, nu de locația de pe disc: același cod dintr-un folder diferit continuă să funcționeze.

Modul spațiu de lucru (Go 1.18+)

Pentru a lucra pe mai multe module care se referă unul la celălalt în același timp (de exemplu, o bibliotecă și o aplicație care o folosește):

go work init ./lib ./app

Aceasta creează go.work: go build va folosi versiunea locală a ./lib în loc să o descarce pe cea publicată. Nu comite go.work (este un mediu de dezvoltare).

Exerciții

$ go mod ???