Skip to content

Commit

Permalink
Merge pull request #780 from vmware-tanzu/bumpgo_v0.43.0
Browse files Browse the repository at this point in the history
Bumpgo v0.43.0
  • Loading branch information
pivotaljohn committed Dec 5, 2022
2 parents e03f2a5 + 21de6be commit 0fdabd4
Show file tree
Hide file tree
Showing 13 changed files with 207 additions and 203 deletions.
2 changes: 1 addition & 1 deletion go.mod
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
module github.com/vmware-tanzu/carvel-ytt

go 1.17
go 1.19

require (
github.com/BurntSushi/toml v1.1.0
Expand Down
1 change: 0 additions & 1 deletion go.sum
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,6 @@ github.com/spf13/pflag v1.0.5/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An
github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=
github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
github.com/stretchr/testify v1.7.2/go.mod h1:R6va5+xMeoiuVRoj+gSkQ7d3FALtqAAGI1FQKckRals=
github.com/stretchr/testify v1.8.0 h1:pSgiaMZlXftHpm5L7V1+rVB+AZJydKsMxsQBIJw4PKk=
github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=
github.com/vito/go-interact v0.0.0-20171111012221-fa338ed9e9ec/go.mod h1:wPlfmglZmRWMYv/qJy3P+fK/UnoQB5ISk4txfNd9tDo=
Expand Down
2 changes: 1 addition & 1 deletion pkg/cmd/doc.go
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ A cobra.Command is the starting point of execution.
For a list of commands run:
$ ytt help
$ ytt help
The default command is "template".
*/
Expand Down
275 changes: 137 additions & 138 deletions pkg/doc.go
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ degree absolutely required.
In the inventory, below, individual packages are named alongside their coupling
with the other packages in the codebase.
(# of dependents) => <package name> => (# of dependencies)
(# of dependents) => <package name> => (# of dependencies)
Where "# of dependents" is the count of packages that import the named package
and "# of dependencies" is the count of packages that this named package
Expand All @@ -23,82 +23,82 @@ This is output from the tool https://github.com/jtigger/go-orient.
From top-down (http://www.catb.org/~esr/writings/taoup/html/ch04s03.html), ytt
code is layered in this way:
Entry Point
# Entry Point
ytt is built into two executable formats:
./cmd/ytt // a command-line tool
./cmd/ytt-lambda-website // an AWS Lambda function
./cmd/ytt // a command-line tool
./cmd/ytt-lambda-website // an AWS Lambda function
ytt's contains a mini website that is the "Playground".
(1) => pkg/website => (0)
(1) => pkg/website => (0)
Commands
# Commands
There are half-a-dozen commands ytt implements. The most commonly used and most
complex is "template".
(1) => pkg/cmd => (8)
(2) => pkg/cmd/template => (10)
(1) => pkg/cmd => (8)
(2) => pkg/cmd/template => (10)
The Workspace
# The Workspace
ytt processing can be thought of as a sequence of steps: schema "pre-processing",
data values "pre-processing", template evaluation, and overlay "post-processing".
All of these steps are executed over a collection of files we call a
workspace.Library.
(1) => pkg/workspace => (14)
(2) => pkg/workspace/datavalues => (6)
(3) => pkg/workspace/ref => (2)
(4) => pkg/files => (1)
(10) => pkg/filepos => (0)
(1) => pkg/workspace => (14)
(2) => pkg/workspace/datavalues => (6)
(3) => pkg/workspace/ref => (2)
(4) => pkg/files => (1)
(10) => pkg/filepos => (0)
Templating
# Templating
The heart of ytt's action is structural templating. There are two flavors of
templates: templating on a YAML structure and templating on text. Each source
template file is "compiled" into a Starlark program whose job is to build-up
the output.
(9) => pkg/template => (2)
(9) => pkg/template/core => (1)
(3) => pkg/yamltemplate => (6)
(2) => pkg/texttemplate => (2)
(9) => pkg/template => (2)
(9) => pkg/template/core => (1)
(3) => pkg/yamltemplate => (6)
(2) => pkg/texttemplate => (2)
Standard Library
# Standard Library
ytt injects a collection of "standard" modules into Starlark executions.
These modules support serialization, hashing, parsing of special kinds
of values, and programmatic access to some of ytt's core capabilities. This
collection is known as a library (not to be confused with the workspace.Library
concept).
(2) => pkg/yttlibrary => (5)
(2) => pkg/yttlibrary => (5)
The implementation for ytt's other fundamental feature -- Overlays -- lives
within this standard library. This allows for both template authors and ytt
itself to use this powerful editing feature.
(3) => pkg/yttlibrary/overlay => (5)
(3) => pkg/yttlibrary/overlay => (5)
"Standard Library" modules that have Go dependencies are included as
"extensions" to minimize the set of transitive dependencies that come from the
github.com/vmware-tanzu/carvel-ytt module.
(1) => pkg/yttlibraryext => (1)
(1) => pkg/yttlibraryext/toml => (4)
(1) => pkg/yttlibraryext => (1)
(1) => pkg/yttlibraryext/toml => (4)
YAML Enhancements
# YAML Enhancements
ytt can enrich a YAML structure with more fine-grained data typing and
user-defined constraints on values.
(3) => pkg/schema => (5)
(1) => pkg/assertions => (5)
(3) => pkg/schema => (5)
(1) => pkg/assertions => (5)
YAML Structures
# YAML Structures
At the heart of ytt is the ability to parse annotated YAML.
Expand All @@ -109,131 +109,130 @@ hints, etc.). It does this by converting the output from the standard YAML
parser into a composite tree of its own yamlmeta.Node structure that can
hold that metadata.
(11) => pkg/yamlmeta => (3)
(1) => pkg/yamlmeta/internal/yaml.v2 => (0)
(11) => pkg/yamlmeta => (3)
(1) => pkg/yamlmeta/internal/yaml.v2 => (0)
Utilities
# Utilities
Finally, there is a collection of supporting features.
One of which provides the implementation of the "fmt" command:
(1) => pkg/yamlfmt => (1)
(1) => pkg/yamlfmt => (1)
The remainder are domain-agnostic utilities that provide either an
application-level capability or a specialized piece of logic.
(5) => pkg/cmd/ui => (0)
(5) => pkg/orderedmap => (0)
(2) => pkg/version => (0)
(2) => pkg/feature => (0)
(1) => pkg/spell => (0)
(5) => pkg/cmd/ui => (0)
(5) => pkg/orderedmap => (0)
(2) => pkg/version => (0)
(2) => pkg/feature => (0)
(1) => pkg/spell => (0)
Dependencies
# Dependencies
Each package's dependencies on other packages within this module are as follows
(if a package is not listed, it has no dependencies on other packages within
this module):
pkg/cmd/template:
- pkg/workspace
- pkg/workspace/datavalues
- pkg/schema
- pkg/workspace/ref
- pkg/yttlibrary/overlay
- pkg/files
- pkg/cmd/ui
- pkg/template
- pkg/filepos
- pkg/yamlmeta
pkg/workspace:
- pkg/assertions
- pkg/texttemplate
- pkg/workspace/datavalues
- pkg/yttlibrary
- pkg/schema
- pkg/workspace/ref
- pkg/yamltemplate
- pkg/yttlibrary/overlay
- pkg/files
- pkg/cmd/ui
- pkg/template
- pkg/template/core
- pkg/filepos
- pkg/yamlmeta
pkg/assertions:
- pkg/feature
- pkg/yamltemplate
- pkg/template
- pkg/filepos
- pkg/yamlmeta
pkg/yamltemplate:
- pkg/texttemplate
- pkg/orderedmap
- pkg/template
- pkg/template/core
- pkg/filepos
- pkg/yamlmeta
pkg/texttemplate:
- pkg/template
- pkg/filepos
pkg/template:
- pkg/template/core
- pkg/filepos
pkg/template/core:
- pkg/orderedmap
pkg/yamlmeta:
- pkg/yamlmeta/internal/yaml.v2
- pkg/orderedmap
- pkg/filepos
pkg/workspace/datavalues:
- pkg/schema
- pkg/workspace/ref
- pkg/template
- pkg/template/core
- pkg/filepos
- pkg/yamlmeta
pkg/schema:
- pkg/spell
- pkg/template
- pkg/template/core
- pkg/filepos
- pkg/yamlmeta
pkg/workspace/ref:
- pkg/template
- pkg/template/core
pkg/yttlibrary:
- pkg/version
- pkg/yttlibrary/overlay
- pkg/orderedmap
- pkg/template/core
- pkg/yamlmeta
pkg/yttlibrary/overlay:
- pkg/yamltemplate
- pkg/template
- pkg/template/core
- pkg/filepos
- pkg/yamlmeta
pkg/files:
- pkg/cmd/ui
pkg/cmd:
- pkg/website
- pkg/yamlfmt
- pkg/yttlibraryext
- pkg/cmd/template
- pkg/version
- pkg/files
- pkg/cmd/ui
- pkg/yamlmeta
pkg/yamlfmt:
- pkg/yamlmeta
pkg/yttlibraryext:
- pkg/yttlibraryext/toml
pkg/yttlibraryext/toml:
- pkg/yttlibrary
- pkg/orderedmap
- pkg/template/core
- pkg/yamlmeta
pkg/cmd/template:
- pkg/workspace
- pkg/workspace/datavalues
- pkg/schema
- pkg/workspace/ref
- pkg/yttlibrary/overlay
- pkg/files
- pkg/cmd/ui
- pkg/template
- pkg/filepos
- pkg/yamlmeta
pkg/workspace:
- pkg/assertions
- pkg/texttemplate
- pkg/workspace/datavalues
- pkg/yttlibrary
- pkg/schema
- pkg/workspace/ref
- pkg/yamltemplate
- pkg/yttlibrary/overlay
- pkg/files
- pkg/cmd/ui
- pkg/template
- pkg/template/core
- pkg/filepos
- pkg/yamlmeta
pkg/assertions:
- pkg/feature
- pkg/yamltemplate
- pkg/template
- pkg/filepos
- pkg/yamlmeta
pkg/yamltemplate:
- pkg/texttemplate
- pkg/orderedmap
- pkg/template
- pkg/template/core
- pkg/filepos
- pkg/yamlmeta
pkg/texttemplate:
- pkg/template
- pkg/filepos
pkg/template:
- pkg/template/core
- pkg/filepos
pkg/template/core:
- pkg/orderedmap
pkg/yamlmeta:
- pkg/yamlmeta/internal/yaml.v2
- pkg/orderedmap
- pkg/filepos
pkg/workspace/datavalues:
- pkg/schema
- pkg/workspace/ref
- pkg/template
- pkg/template/core
- pkg/filepos
- pkg/yamlmeta
pkg/schema:
- pkg/spell
- pkg/template
- pkg/template/core
- pkg/filepos
- pkg/yamlmeta
pkg/workspace/ref:
- pkg/template
- pkg/template/core
pkg/yttlibrary:
- pkg/version
- pkg/yttlibrary/overlay
- pkg/orderedmap
- pkg/template/core
- pkg/yamlmeta
pkg/yttlibrary/overlay:
- pkg/yamltemplate
- pkg/template
- pkg/template/core
- pkg/filepos
- pkg/yamlmeta
pkg/files:
- pkg/cmd/ui
pkg/cmd:
- pkg/website
- pkg/yamlfmt
- pkg/yttlibraryext
- pkg/cmd/template
- pkg/version
- pkg/files
- pkg/cmd/ui
- pkg/yamlmeta
pkg/yamlfmt:
- pkg/yamlmeta
pkg/yttlibraryext:
- pkg/yttlibraryext/toml
pkg/yttlibraryext/toml:
- pkg/yttlibrary
- pkg/orderedmap
- pkg/template/core
- pkg/yamlmeta
*/
package pkg
Loading

0 comments on commit 0fdabd4

Please sign in to comment.