Baixar Cue 0.16.0 per a Windows

Changes which may break some users are marked below with: ⚠️
Language
As a reminder, we have two ongoing language experiments since v0.15; a replacement for struct embedding and a rework of aliases. Please give these a try and report any issues or feedback!
⚠️ The cmdreferencepkg global experiment is now stable, meaning that CUE_EXPERIMENT=cmdreferencepkg is always enabled.
#"""# is now accepted as a string literal quoting a double quote, ".
Multiline string literals now require a trailing newline, matching the language spec.
The new try experiment
This release introduces the try experiment, which adds a try clause in comprehensions as well as the use of ? in field selectors. This addition to the language is intended to provide a more concise syntax for handling optional fields without the risk of unintentionally swallowing errors.
This experiment also introduces the else clause for if and try comprehensions, and the fallback clause for for comprehensions, which trigger when a comprehension produces zero values.
You can try this experiment by following our how-to guides on the try clause and the else clause. For more information, see the proposal on GitHub and the spec change patch.
Evaluator
Performance
Further improve the use of caching in the typochecker algorithm; this provides speed-ups of up to 80% on some large projects.
Very large structs (tested with 20,000 fields) are up to 80% faster now, as we were repeating some work unnecessarily.
A great deal of effort has gone into reducing the allocations and memory usage across a number of projects. For some of these, memory usage is down by as much as 60%.
These improvements were possible thanks to our Unity service, letting us analyze CUE's performance and test for regressions on third party projects. Contact @mvdan on Discord, Slack, or via the Unity page to ensure that your project is included or you are running into slowness.
A number of changes were made to improve support for using cue.Values concurrently; see Issue #2733 for more details and ongoing progress.
Other changes
Fix a regression introduced in v0.13 where the or built-in with literal arguments could stop behaving like a disjunction.
A number of panics and other bugs in the evaluator which were reported since v0.15.0 have been fixed; thank you to all who reported these.
cmd/cue
Add support for $DOCKER_AUTH_CONFIG to directly provide the contents of $DOCKER_CONFIG/config.json to authenticate with module registries, matching Docker's current behavior.
The --outfile flag now works when given non-regular files such as named pipes or sockets.
⚠️ cue mod publish no longer ignores sub-directories containing a go.mod file.
⚠️ Using cue inside the cue.mod directory now fails consistently with a clear error message to not place CUE code there. Previously, some commands worked while others failed with confusing errors.
⚠️ The global --verbose and --trace flags have been moved to the cue get go and cue trim commands respectively, as they were the only ones actually using those flags, and this could be confusing to users.
Fix a bug where loading ./...:pkgname could lead to loading directories without CUE files as instances, which could cause poor performance for CUE packages with multiple parent directories.
cue exp writefs gains an encoding optional field for regular files, to specify an encoding rather than infer it from the filename extension.
LSP server
Initial LSP support for editing embedded JSON and YAML files. This feature provides completions and hover-docs when editing JSON or YAML files which are embedded into CUE via the @embed attribute. A teaser video is available on YouTube.
Code Actions: two code actions are now provided, Add surrounding struct braces and Remove surrounding struct braces, which convert between
a: b: c
and
a: {
b: c
}
with the cursor on b.
A complete overhaul of how the LSP server suggests code completions. This solves the previous naïve implementation which would only make suggestions after a field name or path had been started. Now completions are available from within whitespace.
Embedded paths with mutual dependencies: embedded paths with multiple components (e.g. a.b.c) can in some cases only be fully resolved after the resolution of other embedded paths. The LSP server can now correctly handle these dependencies.
The LSP server now implements LSP Document Symbols functionality. This is often used by editors to provide light-weight breadcrumb navigation within a file.
Some preliminary diagnostics are now sent from the LSP server back to the editor. Initially this mainly indicates syntax errors in CUE files, but this can be extended in the future.
Many bug fixes, including better behaviour for files and directories with spaces; improvements for value aliases (foo: L=x); LSP rename now provides placeholder text; improved jump-to-definition behaviour for package-level fields; fixed issues around imports; path resolution; formatting of standalone CUE files; and others.
See our Getting Started wiki page for instructions on how to set it up with your editor.
Please report any bugs or missing features you encounter via the Issue tracker or via the #lsp channels on Discord or Slack.
Encodings
Add support for encoding YAML tags like key: !Custom value by using CUE attributes like key: "value" @yaml(,tag="!Custom").
cue get go now detects which Go packages use Kubernetes type semantics via // +k8s:openapi-gen=true and obeys the field annotations // +optional and // +nullable.
cue get go gains a --codec flag to configure the use and priority of Go struct field tags like json or yaml.
Fix a bug where cue get go could skip over fields whose type implements one of the supported marshaling interfaces.
Fix a few bugs where cue get go could result in invalid or failing CUE code.
JSON Schema's Config.OpenOnlyWhenExplicit option is now exposed for the CLI via the filetype tag jsonschema+openOnlyWhenExplicit.
JSON Schema now properly encodes hash references for better compatibility with other tools.
Standard library
The strconv package adds ParseNumber, like ParseInt or ParseFloat but allowing other CUE number strings such as 1Ki.
The net package adds InCIDR to test whether an IP is contained by a CIDR string.
The net package adds ParseCIDR to extract useful information from a CIDR string.
The net package adds CompareIP to compare two IP addresses, which can be useful for computing with IP ranges.
The net/http package adds Serve as an experimental API to listen on a port and serve HTTP requests.
The tool/file package adds Symlink to create symbolic links.
Go API
cue.Value.Decode now supports the new cue.Unmarshaler interface, allowing Go types to implement their own CUE value decoding logic via an UnmarshalCUE(cue.Value) error method.
The new cue.IsIncomplete function reports whether the given value is a CUE incomplete error.
cue/ast gains the NewPredeclared and Ident.IsPredeclared to mark and detect identifiers referencing predeclared names like error or int rather than fields which may shadow those names in the current scope.
⚠️ cue.Value.Decode now uses cue.IsIncomplete to not treat incomplete errors as fatal, allowing the decoding to continue.
Fix a bug where cue.Value.Decode could behave incorrectly when decoding a CUE null or incomplete value.
⚠️ cue/token.Compare now sorts absolute paths before relative ones, to ensure consistent behavior between Unix-like systems and Windows.
⚠️ The long-deprecated cue/ast.Node.Comments and cue/ast.Node.AddComment interface methods are now removed; use cue/ast.Comments and cue/ast.AddComment respectively.
⚠️ The long-deprecated and unused cue/parser.FromVersion and cue/parser.DeprecationError APIs are now removed.
⚠️ The long-deprecated and hidden cue.Instance.Eval method is now removed.
Full list of changes since v0.15.0
- internal/ci: use OIDC with the Central Registry for the e2e tests by @mvdan in de47a5e
- re-enable staticcheck's SA4000 and SA4003 checks by @mvdan in 771e253
- internal: bump staticcheck to v0.7.0 for Go 1.26 support by @mvdan in e1de78e
- lsp/eval: correct resolution of package-level fields by @cuematthew in e3306a9
- lsp/eval: add test showing bad behaviour by @cuematthew in da5d43a
- lsp/server: make "Remove surrounding struct braces" preferred by @cuematthew in 5f20a71
- doc/ref: clarify who maintains this document by @mvdan in 3ee970f
- allow more commands in Claude by @mvdan in 6d50284
- lspaux/protocol: initial implementation for protocol by @cuematthew in 3ee106b
- cue/load: check some errors that were ignored by @rogpeppe in 13fdcdb
- doc/ref: fix three mistakes in the matchIf examples by @mvdan in 000506e
- cue/load: do not panic when load.Instances(args, nil) fails very early by @mvdan in cd6a481
- cmd/cue: add a test case for issue 4286 by @mvdan in edc89df
- lsp/eval: add support for comprehension else/fallback by @cuematthew in e2d8f7b
- cmd/cue: support explicit encodings in exp writefs by @mvdan in d0eca3f
- cmd/cue: rewrite exp writefs with internal/filetypes and internal/encoding by @mvdan in 766668d
- cmd/cue: add first exp writefs testscript by @mvdan in 00eddbf
- internal/core/adt: missed missing missing by @mpvl in 8732213
- cue/parser: simplify else/fallback clause rules by @mpvl in 0cbc9a1
- cue/parser: restrict else to single clause only by @mpvl in 28f0246
- cue: add fallback keyword for for comprehensions by @mpvl in fe9f503
- cue/testdata: rename out/eval to out/evalalpha when appropriate by @rogpeppe in c76dc5a
- cue/build: fix stale identifier resolution across instances by @mvdan in dd7361a
- cmd/cue: add regression test for issue 4275 by @mvdan in 791e697
- encoding/yaml: improve ast.StructLit and ListLit positions by @cuematthew in cde471e
- cmd/cue: be more helpful when publishing a module without source by @mvdan in 3dfa50a
- encoding/jsonschema: remove net/url.Parse workaround for Go 1.26 by @mvdan in 6cce9bc