🐛 Bug Fixes

• Fix regression of --data-value-file flag (#680)

📂 Files Checksum

3eaa8fcb3526a2a305a4845196bbffe7e1b0f3ea57fcd90daad94c855139df86  ./ytt-linux-arm64
460bd29d673fd31eb98b44126527b95d99f18b37a0cb0948cd518e772f24b2cd  ./ytt-windows-arm64.exe
4d1e9152d9fc00250215f921f562e9a509c22c04831ed657608cdd6b777e9f68  ./ytt-windows-amd64.exe
6405e481eaac650e25f640a1be6190953d03f51981972b29aacc91e43b5c1498  ./ytt-darwin-arm64
65dbc4f3a4a2ed84296dd1b323e8e7bd77e488fa7540d12dd36cf7fb2fc77c03  ./ytt-linux-amd64
c370fab22081b17b780d4ec37fb664edb58fe6f28d635ad4beccbac7997586f9  ./ytt-darwin-amd64

🛑 Patch Release Available

This version contains a regression. We recommend you use the latest, instead.

✨ What's new

• Schema Validations #561 (experimental) — announcement blog post
• Enable new experiments (validations) through environment variable #658
• Add hint to symlink error message #647
• Allow : character in --data-values-file path #609
• Accept all types of input for the --data-value-file and --data-values-file #670 #486

🐛 Bug Fixes

• Decode TOML array of tables #652
• Have data.list("/") read from root of library as expected #661

🔈 Callouts

Thanks to...

• Víctor Martínez Bevià @vicmarbev 🙏🏻

For your contributions to this release!

📂 Files Checksum

270d76a9a67fc6c375f52beb538533c2228f2553ce96b0cb50fe366d00d7e291  ./ytt-darwin-arm64
5027def0ee7c08c3426dac2c19974fb736e16fddb2ea4ed2456940a2c4266491  ./ytt-linux-amd64
856dff6263488d25546ab7eff3574cfca973e641ff4f58f39bfb703235352ec3  ./ytt-windows-amd64.exe
8b1a61ef55905d9b0fb737cb2fc3dfb1716965eddb6314942afcb382527e447b  ./ytt-windows-arm64.exe
a0848c9965ad01ae2f169f100fca855e4b0a2c53f195bf54f5d28db5f95b5694  ./ytt-linux-arm64
e35e24b12d9c99309758682392ae159f113b93a226fd9f567980c0c186f7caad  ./ytt-darwin-amd64

🐛 Bug Fixes

894983a Update go mod example

📂 Files Checksum

046066aee0b4ded04a613093667cb2301c07471e679f88c72817a75710bce43a  ./ytt-windows-arm64.exe
11222665c627b8f0a1443534a3dde3c9b3aac08b322d28e91f0e011e3aeb7df5  ./ytt-linux-amd64
8923b1caee0bbe8783876f95fa2bdfee8840a85151870ec60b46c36905efbcb1  ./ytt-windows-amd64.exe
a478eb4a6a88a8e3de9dd2e97c1fb96ca7a65c74525f2e132e6a5b333803f7c8  ./ytt-darwin-arm64
c5d2f033b375ee87414b51d16c324d7a441de2f256865b5c774c4d5aea30ef60  ./ytt-linux-arm64
d46dba5e729e2fe36c369e96eaa2eb5354fb1bf7cf9184f9bfa829b8e5558b94  ./ytt-darwin-amd64

(There is no code/behavior difference between v0.40.0 and this release.
This is mostly a cosmetic release. Without it GitHub was reporting our "latest" release as v0.37.1 [which is incorrect: our latest release is v0.40.0].
We decided the lowest-risk move would be to include this tiny patch as a release.)

🐛 Bug Fixes

• (backport of issue fixed in v0.39.0) Schema files are merged out-of-order when in different sub-directories #589
  Full Changelog: https://github.com/vmware-tanzu/carvel-ytt/compare/v0.37.0...v0.37.1

📂 Files Checksum

0c76d16119ca9ca32a4201f34e19cc7cd990f76103e9aaa407a81e7e77f2b18d  ./ytt-darwin-arm64
28abca53629f9d5f281504f1144658a90b1d79c4113e31805a3efb1d78a510c6  ./ytt-windows-arm64.exe
53b2c25d212e51f9fdfb9f083f484e6ac94e9756e39166a55f875114c6ef306c  ./ytt-linux-amd64
9121a98a055b4f325f0203a9f04dbe8d5edbc47c63497f8061b3a985e0a5d914  ./ytt-darwin-amd64
96135e336b703d143a6f17f13424c6d479a3d63a3a9ae0522cb82df7f751b1d4  ./ytt-windows-amd64.exe
dc16331f5f73dee4a0cca3ab2c5ca53509a4b29ce52a0368981d6973ac273204  ./ytt-linux-arm64

✨ What's New

• ❗ Breaking Change Go module renamed from github.com/k14s/ytt to github.com/vmware-tanzu/carvel-ytt

📂 Files Checksum

04ab81f008300ca386c037a3d1c8be5a63b040c5de16ad691cc9ce8b1f9dc364  ./ytt-linux-arm64
1f3d6cc66dd86b3f47ae6a062fea380f5e7e498887698948130203181c276b42  ./ytt-linux-amd64
3b3e3cb5d05afe97f53f7b8c93edba97821d4d03561056e9c3f2d69cc45b51f5  ./ytt-darwin-arm64
912e7c7e64b685e9beb7f2afa5133df4cccdac29f7ee9d016cb10e7997ba5ed0  ./ytt-darwin-amd64
9245c8fedd5db503fef1f9c9e607099b5578c23156b1bcb3a13e9b0bbacbc579  ./ytt-windows-arm64.exe
ca8ccc863b2adee07d40b742132994b2b55fc8421becdacb1d797b5b3586836d  ./ytt-windows-amd64.exe

✨ What's new

• ❗ Add assert.equals package #218
• Export data values schema in OpenAPI v3 format new features:
  • Add title key with @schema/title annotation #573
  • Add example and x-example-description keys with @schema/examples annotation #580
  • Add deprecated key with @schema/deprecated annotation #596
  • Establish order for openAPI keys #595
• ❗ Add plain merge of data values into a library with lib.with_data_values(data.values, plain=True) #568
• Various error and quality of life improvements:
  • Improve various error messages #543, #569, #582
  • Include @schema/... annotation context in error messages #552
  • Refactor to help code management #570, #519
  • Add docs about integrating with ytt #513

🐛 Bug Fixes

• Fix prevents Schema annotations on nested keys annotated with any type #562
• Fix Schema files being merged out-of-order #589

🔈 Callouts

Thanks to Nicholas Seemiller @seemiller for helping out with this release.

📂 Files Checksum

54b6a3df11c686f56129d560e2ea0ed977145628aa3d11b3e6fc207492ecd2ba  ./ytt-windows-amd64.exe
64e2bfd870d5b5249f3f261bc9224dbe870877f35cd3040c2ec46c3aaca94d43  ./ytt-linux-arm64
723224d36471a9bcf160e2754554ba109cff2015ea01b87a9177826a839b7425  ./ytt-darwin-arm64
7a472b8c62bfec5c12586bb39065beda42c6fe43cf24271275e4dbc0a04acb8b  ./ytt-linux-amd64
9cd89e3295ce5e430f7385b695e4d2127b833cadf59c1dbe84a8c8ad56c21942  ./ytt-windows-arm64.exe
b188f6a6f0c44ef8d3cf07d5237dcfa79d04b8c2823d697b58de7236034fb03a  ./ytt-darwin-amd64

✨ What's new

• ❗ Export a data values schema in OpenAPI v3 format Docs
  • Add description key with @schema/desc annotation #469
• Explicitly set schema default values with @schema/default for arrays or other types #295
• ❗ TOML built-in library Docs #259
• Schema error message key suggestions #547

🐛 Bug Fixes

• Fix prevents Schema validation on nested keys annotated with any type #523
• Output % properly in fmt command #370

🔈 Callouts

Thanks to

• Stéphane Este-Gracias @sestegra for the toml library
• Rashed K @rashedkvm docs improvements

For helping out with this release

📂 Files Checksum

029678ab1c95d42ec559dcde854fcd3f89669cf2af83ca3d24603d45e4036202  ./ytt-darwin-arm64
080bb2a166ad21568c722822768ca0985aba010082e590a202af12c4b4f2c887  ./ytt-windows-amd64.exe
1f84e26457a5efd2470df408072bf2f182c939414e4958f82e19e122d2ee120c  ./ytt-darwin-amd64
2ca800c561464e0b252e5ee5cacff6aa53831e65e2fb9a09cf388d764013c40d  ./ytt-linux-amd64
c4939a3de0518b802a2c75bf61e837d2c2137289261433eaa101760cee793d04  ./ytt-linux-arm64
e5237ec574c7af18384f6206af91299d76a152f18e11a470e0f51cf01fcd119d  ./ytt-windows-arm64.exe

✨ What's new

• added assert.try_to() in #474 (docs)
• new module: @ytt:ip for parsing Internet Protocol data in #433 (docs)
• add shell completion via "completion" command (via cobra 1.2.1) in #451 (see ytt completion --help for details)

🐛 Bug Fixes

• Parse floats correctly in #483
  Full Changelog: https://github.com/vmware-tanzu/carvel-ytt/compare/v0.36.0...v0.37.0

🔈 Callouts

Thanks to:

• Tyler Schultz @tylerschultz
• Christian Ang @christianang
• Mikael Manukyan @mike1808
• Edwin Xie @flawedmatrix

For your significant contributions to the ytt standard library in this release.

📂 Files Checksum

1aad12386f6bae1a78197acdc7ec9e60c441f82c4ca944df8d3c78625750fe59  ./ytt-linux-amd64
532bd5471cf791b9fef1401b036ac1d63a74540d5fdf28f0529b766546ce8f38  ./ytt-darwin-arm64
5eef9da11dd4f714495e2cf47041fc6fd413c8c393af4cc5bf3869e075b4e936  ./ytt-darwin-amd64
cd54f82398383cef6e07db7854d78991918fa9185ad92108a1d87ab3cb5c913d  ./ytt-windows-amd64.exe
ebf1970b3cf1ad34746f90727b85142fa9403049683da303c5622358376ae544  ./ytt-linux-arm64

✨ What's new

• Improved error messages when data values schema documents are unused #462
• Include violating data value in library schema error messages #472

🔈 Callouts

Thanks to

• @DennisDenuto for naming refactors to improve code readability #375

📂 Files Checksum

d81ecf6c47209f6ac527e503a6fd85e999c3c2f8369e972794047bddc7e5fbe2  ./ytt-linux-amd64
9662e3f8e30333726a03f7a5ae6231fbfb2cebb6c1aa3f545b253d7c695487e6  ./ytt-darwin-amd64
b4e9a4e6d6089b41811b6fef57b946aef38a34802c6dda88721fb9239f368e1a  ./ytt-windows-amd64.exe
114544b3070fed72dfc6d40b59ca85e73ed2afddff61383133554af6ae37caee  ./ytt-linux-arm64
c970b2c13d4059f0bee3bf3ceaa09bd0674a62c24550453d90b284d885a06b7b  ./ytt-darwin-arm64

🐛 Bug Fixes

• Fixed: Broken ytt website command #456

📂 Files Checksum

0aa78f7b5f5a0a4c39bddfed915172880344270809c26b9844e9d0cbf6437030  ./ytt-linux-amd64
1f2b61d02f6d8184889719d5e0277a1ea82219f96873345157e81075ca59808e  ./ytt-darwin-amd64
39383355b2ddd671c1cfb69ca3c6e10cbef490ad0eee0f306107ed9e7f6ed61c  ./ytt-windows-amd64.exe
acc4e759fce0489a7d6fdb7521a6db05047c1073af4e6497dc18c860146593ad  ./ytt-darwin-arm64
d7f7686600c617efa611acb5d3e0825f58a60088dd5956cc412f718ed2162e3f  ./ytt-linux-arm64

✨ What's new

• Schema v1 GA 🎉 🚀 #283
  • this feature is now enabled by default (--enable-experiment-schema flag has been removed).
  • to get started, see How to Use Data Values with Schema
  • includes a guide for migrating to Schema
• Indent JSON strings from json.encode by including optional indent= keyword argument. #410

🔈 Callouts

Thanks to

• All of those who participated in our Schema usability testing, including @jorgemoralespou; your feedback had a big impact on the finished product. 👏🏻
• @tylerschultz + @mcwumbly for making all our JSONs prettier! {💄 }

🐛 Bug Fixes

• Fixed regression: #431

📂 Files Checksum

425c5a66c6d1cb765fff11b670081dbe9c63679d25129e4f566f37242cef324d  ./ytt-darwin-amd64
3304f422c7192ea20790ae5ad8246d8310dbe1766901a73fe72b9a8ba32b982c  ./ytt-darwin-arm64
23718f9b92b952f53b8ee603981031e3d2a54d9ad2aaf933da692d8e07a33c90  ./ytt-linux-amd64
11ed09e6b842029f47cea376c7f0c54110f3a015ae41a2c8a505d448cb69019a  ./ytt-linux-arm64
b8c7f4d92bd5c1491f0f5b14455415df7ea8c5fa3f9e2e2fcea98c105b2ab19a  ./ytt-windows-amd64.exe

✨ What's new

• (experimental) Enhancements to Schema (#283):
  • Schema can be overlay'ed #294
  • Schema node can be annotated to allow any type #315
• Accept Data Values as a plain YAML file #381 (pre-release)

🐛 Bug Fixes

• (experimental) Fixes to Schema (#283):
  • Integer Data Value from overlay'ed Starlark expression type checks successfully #394
  • Mismatched Type Error omits "found" portion of error message when Data Value's value comes from a Starlark expression #393

📂 Files Checksum

a874395924e670f2c89160efeffc35b94a9bcf4e515e49935cb1ceb22be7f08a  ./ytt-darwin-amd64
9be18b3c6f2d6d5c270e69e2c696250f064039b640ae5d76c80e1c3c2b3b680a  ./ytt-darwin-arm64
49741ac5540fc64da8566f3d1c9538f4f0fec22c62b8ba83e5e3d8efb91ee170  ./ytt-linux-amd64
6a3011af3597d978896290de9e2bc9a6ed5154595abb79e758869f50b6c7f02a  ./ytt-linux-arm64
16a2007775d50247981b9007db52f7ef4414fa19c3748b47940aab117bba3900  ./ytt-windows-amd64.exe

✨ What's new

• add parse() function to the @ytt:url module that eases parsing URLs (per RFC 3986). #366
• (experimental) In Schema, when type checking fails due to providing a collection when expecting a scalar, a useful error message is now provided. #351

🔈 Callouts

Thanks to

• Hanlin Shi @hanlins — for contributing an entire new function to our url module (described, above).

📂 Files Checksum

7783d2b8a2087b18179674685dcac0de463cdc50269c676dbd365c590114d0ba  ./ytt-darwin-amd64
afa1020ba17b6adafb9a40e53701089fa0b2bbd12ee71b78baaa41ece1138922  ./ytt-darwin-arm64
de20cb812f6c5f66feeb66cfcc82607d21c2b726cb54cfd0eaddd112f062e5ca  ./ytt-linux-amd64
cbdccb39ba051d8136180ca90d9de95e6605302575566e5399e468c346a7ccd7  ./ytt-linux-arm64
576cad089cdbf8e952c2f0e0bc877138ade4298f45c3e97859aabd18abd7a67e  ./ytt-windows-amd64.exe

✨ What's new

• Array items are appended by default during overlay #301
• Allow null values to be overlayed #322
• Skip processing plain YAML files marked as template #324
• arm64 architecture support, binaries included below #346
• Experimental schema support: #103
  • Use feature flag --enable-experiment-schema to enable
  • Use schema file as a base for Data Values #265
  • Support using schema in ytt libraries #269
  • Schema supports float types #352
  • Schema type-checks command line data values #353
  • For those curious, check out schema_test.go for details of what exactly is supported

🚀 Improvements

• Add warning when non YAML file is provided without output options #264
• Improved error message when overlaying docsets #264
• Support multiple exclude file marks #369

🔈 Callouts

• Added informational ytt YouTube video to README: Adrian Sales @adriens

📂 Files Checksum

bfd60b38f74fd532e99cff2d2d309aea1b1e00d9d5faaf414ebd30ea9c1a7a43  ./ytt-darwin-amd64
42470495f35fbbe66a0c40ab516519839448475e0e24477b1f33f69d38834175  ./ytt-darwin-arm64
1a8f30e0b86b9daa649433e6092a4a1c6fc9c88400b6842af357c7380924bbc6  ./ytt-linux-amd64
95e5bf9c1c4d972edfa656311ed3ce6b6d745638aad94003bee5807736fe32e3  ./ytt-linux-arm64
bfe937df42faa81e42c49bab3e68e836eae981d7591669f410d2bbf1d2d71bae  ./ytt-windows-amd64.exe

✨ What's new

• Added a code of conduct
• YAML merge operator (<<:) is now supported
• Add --implicit-map-key-overrides to configure whether implicit map keys overrides are allowed
• library module supports configuration options: ['alias', 'ignore_unknown_comments', 'implicit_map_key_overrides', 'implicit-map-key-overrides', 'strict']
• The regexp module now supports replace function #191
• Structs are iterable and can use index notation #208
• Experimental schema support: #103
  • Use feature flag --enable-experiment-schema to enable
  • Supports type checking and #@schema/nullable
  • For those curious, check out schema_test.go for details of what exactly is supported

🚀 Improvements

• Make overlay error order deterministic #256 Thanks to Hanlin Shi @hanlins
• Playground example adding a map to an array #236 Thanks to Ankur Sethi @amalagaura
• Improved error messages for plain yaml comments #226
• Improved warning message when templates are not rendered to output #132

🔈 Callouts

Thanks to

• docs improvements: @stoned, German Lashevich @Zebradil, and Jaskanwal Pawar @jspawar

For helping out with this release

📂 Files Checksum

bf85381a12954793d5a18f252579cb1bc043aada2c34ac0974e2ab8cf03a1de3  ./ytt-darwin-amd64
32e7cdc38202b49fe673442bd22cb2b130e13f0f05ce724222a06522d7618395  ./ytt-linux-amd64
7259acfee248fa027b0843399abad1a1dee839b568eb08edd967fb18e100a91c  ./ytt-windows-amd64.exe

• Disable YAML line folding to avoid surprising users
• Fix use of / within load paths on Windows

a1a56c3292e355b9891b2c4ce7525d78f0e1ffd8630b856d300e9a7f383e707c  ./ytt-darwin-amd64
456e58c70aef5cd4946d29ed106c2b2acbb4d0d5e99129e526ecb4a859a36145  ./ytt-linux-amd64
338648d23ca77aba4ea02d96fb17916245121e208f7631042337fad10e56ffc5  ./ytt-windows-amd64.exe

(Installation instructions: https://k14s.io/#install-from-github-release)

• [breaking] Rename --output-directory to --dangerous-emptied-output-directory flag (docs)
  • This was done to more clearly indicate that output directory is cleared before use
• Add --output-files flag to write out output files into existing directory (docs)
• Add when= keyword argument to overlay/match to conditionally match
• Add ability to specify data values for libraries (docs)
• Error if extra args are given to a ytt command

be16d964964d17b463984d72ed2ec62b691b675441b38ab3ed6ea97f3fc73645  ./ytt-darwin-amd64
52c36853999a378f21f9cf93a443e4d0e405965c3b7d2b8e499ed5fd8d6873ab  ./ytt-linux-amd64
5754d48571de4464fc61ad764e3023e0896f6a2db5567abfb8d89ddfc417dd62  ./ytt-windows-amd64.exe

(Installation instructions: https://k14s.io/#install-from-github-release)

• Provide actual scalar values to overlay/match matchers
  • Previously scalars were wrapped in yamlfragment (similar to maps, and arrays)

0e1ee9487e09ce2f2e18be6637f69e41af2158ff3cb53737d5607b55f0326659  ./ytt-darwin-amd64
64bcc36df4270e3413fd26b68683a353089c3b15c411904307e93c12f80556ab  ./ytt-linux-amd64
ae749687b5a076e0e8ac8c02620d018c65b0bebce29fe5a35f6db05f0a36ae4f  ./ytt-windows-amd64.exe

(Installation instructions: https://k14s.io/#install-from-github-release)

• Revert data.list() and data.read(...) breaking change introduced in v0.27.0
  • instead introduce data.list("/") and data.read("/...") to access content relative to library root

f1c86e48452e9e2be8ffa9ad0fb53bfcf431fd70821f9f261418a72844163d66  ./ytt-darwin-amd64
b53674a21d99576b8d69483113e1ec73d9a3ed7381170a421c9afcf8aa551f15  ./ytt-linux-amd64
319c1099a46732ce82e9755a25d9b18e1de3733e42ee374278bf4bdef440cee6  ./ytt-windows-amd64.exe

(Installation instructions: https://k14s.io/#install-from-github-release)

• Fix overlay.map_key() to be correctly equivalent to by="..."
• [fix] [breaking] data.list() and data.read(...) return results in context of library root
  • potentially breaking as previously provided functions only iterated over "current" directory unlike data.values which was built based on data/values from the entire library

96cc4cd6131849964feebf0b82ed4302453af015a6b0edfb29a3af672ad6715d  ./ytt-darwin-amd64
addd3f27dbffca09a8c7e7610e48dc53d127b08a91eb2b1097544327a6629a8c  ./ytt-linux-amd64
d3332913be93caadfef4cec66bb360e67c5f61c656a788c8daa93178ff487de4  ./ytt-windows-amd64.exe

(Installation instructions: https://k14s.io/#install-from-github-release)