Update docs to use go 1.24 tool dependencies

Author: deitrix

.github/ISSUE_TEMPLATE.md

@@ -5,5 +5,5 @@
 ### Minimal graphql.schema and models to reproduce
 
 ### versions
- - `go run github.com/99designs/gqlgen version`?
+ - `go tool gqlgen version`?
  - `go version`?

.github/workflows/check-init

@@ -5,17 +5,15 @@ export GO111MODULE=on
 gqlgen_dir=$(pwd)
 cd "$(mktemp -d)"
 go mod init inittest
-printf '//go:build tools\npackage tools\nimport _ "github.com/99designs/gqlgen"' | gofmt > tools.go
-go mod tidy
+go get -tool github.com/99designs/gqlgen
 go mod edit -replace=github.com/99designs/gqlgen="$gqlgen_dir"
-go mod tidy
 
-if ! go run github.com/99designs/gqlgen init ; then
+if ! go tool gqlgen init ; then
     echo "gqlgen init failed"
     exit 125
 fi
 
-if ! go run github.com/99designs/gqlgen generate ; then
+if ! go tool gqlgen generate ; then
     echo "gqlgen generate failed"
     exit 125
 fi

README.md

@@ -22,18 +22,16 @@ cd example
 go mod init example
 ```
 
-2. Add `github.com/99designs/gqlgen` to your [project's tools.go](https://go.dev/wiki/Modules#how-can-i-track-tool-dependencies-for-a-module)
+2. Add `github.com/99designs/gqlgen` to your project, as a [tool dependency](https://go.dev/doc/modules/managing-dependencies#tools)
 
 ```shell
-printf '//go:build tools\npackage tools\nimport (_ "github.com/99designs/gqlgen"\n _ "github.com/99designs/gqlgen/graphql/introspection")' | gofmt > tools.go
-go mod tidy
+go get -tool github.com/99designs/gqlgen
 ```
 
 3. Initialise gqlgen config and generate models
 
 ```shell
-go run github.com/99designs/gqlgen init
-go mod tidy
+go tool gqlgen init
 ```
 
 4. Start the graphql server

_examples/mini-habr-with-subscriptions/README.md

@@ -226,8 +226,6 @@ For testing the API, you can use any GraphQL clients, such as Insomnia, Postman,
 `│       └──` [`interface.go`](./internal/storage/interface.go)            (Interface for data storage (PostgreSQL, in-memory))<br>
 `├── migrations/`<br>
 `│   └──` [`001_create_tables.up.sql`](./migrations/001_create_tables.up.sql)    (SQL script for database migration (creating tables))<br>
-`├── tools/`<br>
-`│    └──` [`tools.go`](./tools/tools.go)                   (Tools for gqlgen code generation)<br>
 `├──` [`.env`](./.env)                            (Environment variables file (database settings, Redis, etc.))<br>
 `├──` [`.gitignore`](./.gitignore)                      (List of ignored files and directories for Git)<br>
 `├──` [`docker-compose.yml`](./docker-compose.yml)              (Docker Compose configuration for launching the application and dependencies)<br>
@@ -246,4 +244,4 @@ For testing the API, you can use any GraphQL clients, such as Insomnia, Postman,
   * GraphQL (gqlgen)
   * PostgreSQL 17
   * Redis 9
-  * Docker & Docker Compose
+  * Docker & Docker Compose

docs/content/getting-started.md

@@ -24,36 +24,23 @@ cd gqlgen-todos
 go mod init github.com/[username]/gqlgen-todos
 ```
 
-Next, create a `tools.go` file and add gqlgen as a [tool dependency for your module](https://go.dev/wiki/Modules#how-can-i-track-tool-dependencies-for-a-module).
+Next, add `github.com/99designs/gqlgen` to your project, as a [tool dependency](https://go.dev/doc/modules/managing-dependencies#tools).
 
-```go
-//go:build tools
-
-package tools
-
-import (
-	_ "github.com/99designs/gqlgen"
-)
-```
-
-To automatically add the dependency to your `go.mod` run
 ```shell
-go mod tidy
+go get -tool github.com/99designs/gqlgen
 ```
 
 By default you'll be using the latest version of gqlgen, but if you want to specify a particular version you can use `go get` (replacing `VERSION` with the particular version desired)
 ```shell
-go get -d github.com/99designs/gqlgen@VERSION
+go get -tool github.com/99designs/gqlgen@VERSION
 ```
 
-
-
 ## Building the server
 
 ### Create the project skeleton
 
 ```shell
-go run github.com/99designs/gqlgen init
+go tool gqlgen init
 ```
 
 This will create our suggested package layout. You can modify these paths in gqlgen.yml if you need to.
@@ -239,10 +226,7 @@ type Todo struct {
 }
 ```
 
-And run `go run github.com/99designs/gqlgen generate`.
-
->
-> If you run into this error `package github.com/99designs/gqlgen: no Go files` while executing the `generate` command above, follow the instructions in [this](https://github.com/99designs/gqlgen/issues/800#issuecomment-888908950) comment for a possible solution.
+And run `go tool gqlgen generate`.
 
 Now if we look in `graph/schema.resolvers.go` we can see a new resolver, lets implement it and fix `CreateTodo`.
 ```go
@@ -267,7 +251,7 @@ func (r *todoResolver) User(ctx context.Context, obj *model.Todo) (*model.User,
 At the top of our `resolver.go`, between `package` and `import`, add the following line:
 
 ```go
-//go:generate go run github.com/99designs/gqlgen generate
+//go:generate go tool gqlgen generate
 ```
 
 This magic comment tells `go generate` what command to run when we want to regenerate our code. To run go generate recursively over your entire project, use this command:

docs/content/recipes/federation.md

@@ -35,7 +35,7 @@ federation:
 For each server to be federated we will create a new gqlgen project.
 
 ```bash
-go run github.com/99designs/gqlgen
+go tool gqlgen generate
 ```
 
 Update the schema to reflect the federated example
@@ -61,7 +61,7 @@ extend type Product @key(fields: "upc") {
 and regenerate
 
 ```bash
-go run github.com/99designs/gqlgen
+go tool gqlgen generate
 ```
 
 then implement the resolvers

docs/content/recipes/modelgen-hook.md

@@ -64,7 +64,7 @@ func main() {
 }
 ```
 
-In `resolver.go`, add `//go:generate go run generate.go` (or replace `//go:generate go run github.com/99designs/gqlgen generate` if you have it there). 
+In `resolver.go`, add `//go:generate go run generate.go` (or replace `//go:generate go tool gqlgen` if you have it there).
 
 Now you can run `go generate ./...` to generate the code.
 

docs/content/recipes/subscriptions.md

@@ -158,7 +158,7 @@ type Subscription {
 
 ## Implementing your Resolver
 
-After regenerating your code with `go run github.com/99designs/gqlgen generate` you'll find a
+After regenerating your code with `go tool gqlgen generate` you'll find a
 new resolver for your subscription. It will look like any other resolver, except it expects
 a `<-chan *model.Time` (or whatever your type is). This is a
 [channel](https://go.dev/tour/concurrency/2). Channels in Go are used to send objects to a

docs/content/reference/plugins.md

@@ -49,7 +49,9 @@ func main() {
 
 ```
 
-In `resolver.go`, add `//go:generate go run generate.go`. Now you can run `go generate ./...` instead of `go run github.com/99designs/gqlgen generate` to generate the code.
+In `resolver.go`, add `//go:generate go run generate.go` (or replace `//go:generate go tool gqlgen` if you have it there).
+
+Now you can run `go generate ./...` to generate code using your plugin.
 
 ## Writing a plugin