Backport #16532 Co-authored-by: Matti R <matti@mdranta.net>
1.4 KiB
Vendored
Migration Guide (v3.2.1)
Starting from v3.2.1, the import path has changed from github.com/dgrijalva/jwt-go
to github.com/golang-jwt/jwt
. Future releases will be using the github.com/golang-jwt/jwt
import path and continue the existing versioning scheme of v3.x.x+incompatible
. Backwards-compatible patches and fixes will be done on the v3
release branch, where as new build-breaking features will be developed in a v4
release, possibly including a SIV-style import path.
go.mod replacement
In a first step, the easiest way is to use go mod edit
to issue a replacement.
go mod edit -replace github.com/dgrijalva/jwt-go=github.com/golang-jwt/jwt@v3.2.1+incompatible
go mod tidy
This will still keep the old import path in your code but replace it with the new package and also introduce a new indirect dependency to github.com/golang-jwt/jwt
. Try to compile your project; it should still work.
Cleanup
If your code still consistently builds, you can replace all occurences of github.com/dgrijalva/jwt-go
with github.com/golang-jwt/jwt
, either manually or by using tools such as sed
. Finally, the replace
directive in the go.mod
file can be removed.
Older releases (before v3.2.0)
The original migration guide for older releases can be found at https://github.com/dgrijalva/jwt-go/blob/master/MIGRATION_GUIDE.md.