github.com/Khan/genqlient

This release fixes a bug introduced in v0.8.0 breaking path resolution on Windows, along with some other small features and bugs.

New features:

• Added @genqlient(alias) directive to customize field names without requiring GraphQL aliases (fixes #367)
• Added auto_camel_case config option to automatically convert snake_case to camelCase in both field names and type names

Bug fixes:

• fixed path resolution on Windows
• fixed documentation link in introduction.md
• upgraded version of alexflint/go-arg from 1.4.2 to 1.5.1
• fixed a typo in the struct + fragment error message

This release fixes a bug introduced in v0.8.0 breaking path resolution on Windows, along with some other small features and bugs.

New features:

• Added @genqlient(alias) directive to customize field names without requiring GraphQL aliases (fixes #367)
• Added auto_camel_case config option to automatically convert snake_case to camelCase in both field names and type names

Bug fixes:

• fixed path resolution on Windows
• fixed documentation link in introduction.md
• upgraded version of alexflint/go-arg from 1.4.2 to 1.5.1
• fixed a typo in the struct + fragment error message
• avoid error when a subscription message is received without a subscription ID
• avoid closing subscription channels more than once, which could cause a panic in some cases

This release adds support for genqlient subscriptions; see the documentation for more, and thanks to @matthieu4294967296moineau for the original implementation and @HaraldNordgren for additional testing and improvements.

Note that genqlient now requires Go 1.22.5 or higher, and is tested through Go 1.23.3.

Breaking changes:

• genqlient now forbids omitempty: false (including implicit behaviour) when using pointer on non-null input field.
• The error text for HTTP errors has changed slightly. If you were parsing it, switch to As-ing to graphql.HTTPError.

New features:

• genqlient now supports subscriptions; the websocket protocol is by default graphql-transport-ws but can be set to another value.
  See the documentation for more details on how to use subscriptions.
• genqlient now supports double-star globs for schema and query files; see genqlient.yaml docs for more.
• genqlient now generates slices containing all enum values for each enum type.
• genqlient now returns Is/As-able errors when the HTTP request returns a non-200 status.

Bug fixes:

• omitempty validation:
  • allow omitempty on non-nullable input field, if the field has a default
  • allow omitempty: false on an input field, even when it is non-nullable
• don't do omitempty and pointer input types validation when use_struct_reference is used, as the generated type is often not compatible with validation logic.
• the allow_broken_features option, which no longer did anything, has been removed

This release adds support for genqlient subscriptions; see the documentation for more, and thanks to @matthieu4294967296moineau for the original implementation and @HaraldNordgren for additional testing and improvements.

Note that genqlient now requires Go 1.22.5 or higher, and is tested through Go 1.23.3.

Breaking changes:

• genqlient now forbids omitempty: false (including implicit behaviour) when using pointer on non-null input field.
• The error text for HTTP errors has changed slightly. If you were parsing it, switch to As-ing to graphql.HTTPError.

New features:

• genqlient now supports subscriptions; the websocket protocol is by default graphql-transport-ws but can be set to another value. See the documentation for more details on how to use subscriptions.
• genqlient now supports double-star globs for schema and query files; see genqlient.yaml docs for more.
• genqlient now generates slices containing all enum values for each enum type.
• genqlient now returns Is/As-able errors when the HTTP request returns a non-200 status.

Bug fixes:

• omitempty validation:
  • allow omitempty on non-nullable input field, if the field has a default
  • allow omitempty: false on an input field, even when it is non-nullable
• don't do omitempty and pointer input types validation when use_struct_reference is used, as the generated type is often not compatible with validation logic.
• the allow_broken_features option, which no longer did anything, has been removed

In addition to several new features and bugfixes, along with this release comes reorganized documentation for genqlient. Note that genqlient now requires Go 1.20 or higher, and is tested through Go 1.22.

What's Changed

• Add "generic" option to the "optional" configuration for handling nullable types by @DylanRJohnston in #252
• Documentation tweaks relating to releases by @benjaminjkraft in #271
• Add some better tests for use_struct_references by @benjaminjkraft in #273
• Add an option to handle enums with ugly casing by @benjaminjkraft in #270
• Add some more tests for config validation, and fix some gaps by @benjaminjkraft in #274
• Add consideration for pointer false directive when optional: pointer configuration option is used by @spencermurray in #280
• Update gqlparser and gqlgen dependencies by @StevenACoffman in #282
• Update gqlparser to omit comments by @StevenACoffman in #284
• bugfix: local variable 'data' colliding with argument name by @zholti in #291
• Pin lint workflow's Go version by @benjaminjkraft in #311
• Upgrade golangci-lint and which go we run it with by @benjaminjkraft in #314
• fix implementation type generation for fragment on a union by @zzh8829 in #310
• Support more valid graphql file extensions by @zzh8829 in #309
• Add tests on Go 1.22, and upgrade x/tools to make them work by @benjaminjkraft in #315
• Update gqlgen to latest by @StevenACoffman in #317
• move genqlient Go module to 1.20 by @StevenACoffman in #318
• Improve package-sniffing and bind correctly to types in the same package by @benjaminjkraft in #316
• Reorganize and improve documentation by @benjaminjkraft in #322
• Fix non-deterministic generated code involving interfaces and fragments. by @csilvers in #323
• Release v0.7.0 by @benjaminjkraft in #324

New Contributors

• @DylanRJohnston made their first contribution in #252
• @spencermurray made their first contribution in #280
• @zholti made their first contribution in #291
• @zzh8829 made their first contribution in #310

Full Changelog: v0.6.0...v0.7.0

In addition to several new features and bugfixes, along with this release comes reorganized documentation for genqlient. Note that genqlient now requires Go 1.20 or higher, and is tested through Go 1.22.

New features:

• The new optional: generic allows using a generic type to represent optionality. See the documentation for details.
• The new optional: pointer_omitempty allows using a pointer that is also annotated with omitempty. See the documentation for details.
• For schemas with enum values that differ only in casing, it's now possible to disable smart-casing in genqlient.yaml; see the documentation for casing for details.
• genqlient now supports .graphqls and .gql file extensions for schemas and queries.
• More accurately guess the package name for generated code (and warn if the config option -- now almost never needed -- looks wrong).

Bug fixes:

• Negative pointer directives, i.e., # @genqlient(pointer: false) are now respected even in the when optional: pointer is set in the configuration file.
• Made name collisions between query/mutation arguments and local function variables less likely.
• Fix generation issue related to golang type implementation of complex graphql union fragments.
• Bind correctly to types in the same package as the generated code.
• Fix non-deterministic generated code when querying graphql interfaces via named fragments.

Version 0.6.0 includes some small features and bugfixes. Note that genqlient now requires Go 1.18 or higher, and is tested through Go 1.20.

What's Changed

• Add configuration AutoBindings method by @NuVivo314 in #169
• Mention how to update the snapshot tests by @benjaminjkraft in #210
• make output deterministic for graphql interfaces by @vikstrous2 in #209
• Add more information about updating snapshots by @benjaminjkraft in #211
• Fix incorrectly formatted error string by @breml in #213
• Bump golangci-lint and (max) Go versions by @benjaminjkraft in #219
• Give a better error if package_bindings is a file by @benjaminjkraft in #221
• Move changelog entry to the right version by @benjaminjkraft in #217
• Fix documentation for optional: value by @benjaminjkraft in #229
• Support package-names with dashes in them by @benjaminjkraft in #232
• fixed "for" directive documentation by @bafko in #235
• Expose the graphql operation as a constant in the generated genqlient file by @csilvers in #238
• Rename the query constant to have an underscore in it. by @csilvers in #241
• Automatically update generated files if UPDATE_SNAPSHOTS=1 by @benjaminjkraft in #243
• PR 239 update: Adding more logging for the initial generate setup by @StevenACoffman in #246
• Fix minor mistake in code sample in README by @omarkohl in #253
• Bump golang.org/x/sys from 0.0.0-20220319134239-a9b59b0215f8 to 0.1.0 by @dependabot in #259
• Bump minimum Go version to 1.18 by @benjaminjkraft in #262
• Update gqlgen to latest by @StevenACoffman in #268
• fix: premarshal structs get generated with omitempty tag by @kevinmichaelchen in #267
• Release v0.6.0 by @benjaminjkraft in #269

New Contributors

• @NuVivo314 made their first contribution in #169
• @vikstrous2 made their first contribution in #209
• @breml made their first contribution in #213
• @bafko made their first contribution in #235
• @omarkohl made their first contribution in #253
• @dependabot made their first contribution in #259
• @kevinmichaelchen made their first contribution in #267

Full Changelog: v0.5.0...v0.6.0

Version 0.6.0 includes some small features and bugfixes. Note that genqlient now requires Go 1.18 or higher, and is tested through Go 1.20.

New features:

• You can now bind all types from a package in genqlient.yaml using the new package_bindings option.
• The graphql operation (query or mutation) as sent over the wire is now exposed via a constant in the generated genqlient .go file.

Bug fixes:

• Fixed non-deterministic generated code when querying graphql interfaces.
• Fixed generated code when last component of package name is not a valid identifier (e.g. "path/to/my-package").
• Fixed incorrect documentation of for directive.
• Fixed bug where omitempty JSON tags were not being correctly applied to __premarshal structs.