Google Git
Sign in
cue / cue / 2156c81f1fd99176374cf960d2371f95dfc8ec2a
commit2156c81f1fd99176374cf960d2371f95dfc8ec2a[log] [tgz]
authorMarcel van Lohuizen <mpvl@golang.org>Mon Dec 10 16:05:07 2018 +0100
committerMarcel van Lohuizen <mpvl@golang.org>Tue Dec 11 19:37:53 2018 +0100
treed021fb593146a396f543729e3a47c47370156f91
parent07ee2ab589c223a6aef1c243dcdb18d88a2b497d [diff]
internal/third_party/yaml: parse into CUE ast

Also:
- remove support for parsing into Go-structs
- remove support for encoding
- add comment parsing
- port non-standard test harness to standard go
- add testdata
- fix some bugs related to merging

Change-Id: I7fbd2bed6f76bb5da8a309f8d3fb3fb6228048ab
19 files changed
tree: d021fb593146a396f543729e3a47c47370156f91
  1. cue/
  2. doc/
  3. internal/
  4. AUTHORS
  5. CONTRIBUTING.md
  6. LICENSE
  7. README.md
README.md

The CUE Configuration Language

Configure, Unify, Execute

CUE is an open source configuration language which aims to make complex configurations more manageable and usable.

CUE is a constrained-based language. Constraints provide a powerful yet simple alternative to inheritance, a common source of complexity with other languages. The CUE tooling also provides powerful integrated scripting aimed at improving the overall experience of putting configurations to good use.

Some highlights:

  • JSON superset: get started quickly
  • convert existing YAML and JSON
  • arbitrary-precision arithmetic
  • reformatter
  • automatically simplify configurations
  • powerful scripting
  • rich APIs designed for automated tooling
  • a formalism conducive to automated reasoning
  • generate CUE templates from source code

Download and Install

Install From Source

If you already have Go installed, the short version is:

go get -u cuelang.org/go/cmd/cue

This will install the cue command line tool.

For more details see [Installing CUE][./doc/install.md].

Learning CUE

A demonstration of how to convert and restructure and existing set of Kubernetes configurations is available in [written form][./doc/demo/kubernetes/Readme.md] or as video.

References

  • [Language Specification][./doc/ref/spec.md]: official CUE Language specification.

  • API: the API on godoc.org

  • Builtin packages: builtins available from CUE programs

  • [cue Command line reference][./doc/cmd/cue.md]: the cue command

Contributing

Our canonical Git repository is located at https://cue.googlesource.com.

To contribute, please read the [Contribution Guidelines][./CONTRIBUTING.md]

Note that we do not accept pull requests and that we use the issue tracker for bug reports and proposals only.

Unless otherwise noted, the CUE source files are distributed under the Apache 2.0 license found in the LICENSE file.