chore(deps): updated module github.com/pelletier/go-toml from v1.9.5 to v2 by paketo-bot · Pull Request #492 · paketo-buildpacks/jam

This new minor release brings back the commented struct field tag from go-toml v1. It makes it easier to generate default or example configuration files. For instance:

type TLS struct {
	Cipher  string `toml:"cipher"`
	Version string `toml:"version"`
}
type Config struct {
	Host string `toml:"host" comment:"Host IP to connect to."`
	Port int    `toml:"port" comment:"Port of the remote server."`
	Tls  TLS    `toml:"TLS,commented" comment:"Encryption parameters (optional)"`
}
example := Config{
	Host: "127.0.0.1",
	Port: 4242,
	Tls: TLS{
		Cipher:  "AEAD-AES128-GCM-SHA256",
		Version: "TLS 1.3",
	},
}
out, err := toml.Marshal(example)

generates this TOML document:

# Host IP to connect to.
host = '127.0.0.1'

# Port of the remote server.
port = 4242

# Encryption parameters (optional)

# [TLS]
# cipher = 'AEAD-AES128-GCM-SHA256'

# version = 'TLS 1.3'

This feature was often mentioned as a blocker to upgrading from go-toml v1. Hopefully bringing it back in scope will help folks make the transition!

An other noteworthy improvement is on type mismatch errors. They now include the human-readable context, and include the struct field name of the faulty value if applicable.

Before:

toml: cannot store TOML string into a Go int

After:

1| [server]
2| path = "/my/path"
3| port = "bad"
 |        ~~~~~ cannot decode TOML string into struct field toml_test.Server.Port of type int

What's Changed

What's new

Encoder: add back the commented option by @pelletier in #893

Fixed bugs

Decode: fix panic when parsing '0' as a float by @ocean2811 in #887
Encode: fix ignored indent of array tables by @pelletier in #889
Unstable/parser: add raw to integers by @pelletier in #890
Decode: improve errors on integers and strings by @pelletier in #891
Decode: fix wrong indention for comments on tables by @Felixoid in #892

Other changes

Add support for Go 1.21 by @michalbiesek in #885

New Contributors

@michalbiesek made their first contribution in #885
@ocean2811 made their first contribution in #887

Full Changelog: pelletier/go-toml@v2.0.9...v2.1.0

`v2.0.9`

Compare Source

What's Changed

Fixed bugs

Encode: fix support for arrays by @MrJetBOX in #876
Decode: assign empty struct to empty defined sections by @dbarrosop in #879

Other changes

build(deps): bump github.com/stretchr/testify from 1.8.3 to 1.8.4 by @dependabot in #877

New Contributors

@MrJetBOX made their first contribution in #876
@dbarrosop made their first contribution in #879

Full Changelog: pelletier/go-toml@v2.0.8...v2.0.9

`v2.0.8`

Compare Source

What's Changed

What's new

Support MarshalText/UnmarshalText for map keys by @gordon-klotho in #863
Experimental: comments support in unstable/Parser by @pelletier in #860

Fixed bugs

Decode: fix decode into unsettable structs by @pelletier in #868

Documentation

Add example on how to use TextUnmarshaler by @pelletier in #867

New Contributors

@manunio made their first contribution in #861
@gordon-klotho made their first contribution in #863

Full Changelog: pelletier/go-toml@v2.0.7...v2.0.8

`v2.0.7`

Compare Source

What's Changed

Fixed bugs

Encode: fix inline table first key value whitespace by @cuonglm in #837
Decode: allow integers to be unmarshaled into floats by @PotatoesFall in #841
Decode: fix error reporting of type mismatch on inline tables by @pelletier in #853
Decode: fix panic when unmarshaling into a map twice by @pelletier in #854

Documentation

Fix typos by @deining in #849

New Contributors

@DavidKorczynski made their first contribution in #831
@cuonglm made their first contribution in #837
@PotatoesFall made their first contribution in #841
@deining made their first contribution in #849

Full Changelog: pelletier/go-toml@v2.0.6...v2.0.7

`v2.0.6`

Compare Source

What's Changed

What's new

Expose parser API as unstable by @pelletier in #827

Performance

Reduce init time allocation when declaring types used for reflect by @dolmen in #821

Other changes

refactor: Use typeMismatchError rather than raw string error by @jidicula in #826
build(deps): bump github.com/stretchr/testify from 1.8.0 to 1.8.1 by @dependabot in #825
build(deps): bump actions/setup-go from 2 to 3 by @dependabot in #820

New Contributors

@dolmen made their first contribution in #821

Full Changelog: pelletier/go-toml@v2.0.5...v2.0.6

`v2.0.5`

Compare Source

What's Changed

Fixed bugs

Fix reflect.Pointer backward compatibility by @pelletier in #813

Full Changelog: pelletier/go-toml@v2.0.4...v2.0.5

`v2.0.4`

Compare Source

This version has compatibility issues with Go <= 1.17. Though go-toml doesn't officially support Go less than 2 versions old, a new version has been released with a backward-compatible fix: https://github.com/pelletier/go-toml/releases/tag/v2.0.5.

What's Changed

Fixed bugs

Decode: don't crash on embedded nil pointers by @pelletier in #808
Add back missing build tag needed for Go 1.16 and earlier by @piotrbulinski in #809
Decode: don't break on non-struct embed field by @pelletier in #810

New Contributors

@piotrbulinski made their first contribution in #809

Full Changelog: pelletier/go-toml@v2.0.3...v2.0.4

`v2.0.3`

Compare Source

What's Changed

Fixed bugs

Encode: define and fix newlines behavior when using omitempty by @pelletier in #798
Encode: don't inherit omitempty by @pelletier in #803
Decode: error on array table mismatched type by @pelletier in #804

Other changes

build(deps): bump github.com/stretchr/testify from 1.7.2 to 1.8.0 by @dependabot in #793 #794 #795
Go 1.19 by @pelletier in #802

Full Changelog: pelletier/go-toml@v2.0.2...v2.0.3

`v2.0.2`

Compare Source

What's Changed

Fixed bugs

Encode: add bound check for uint64 > math.Int64 by @pelletier in #785

Other changes

Build arm + arm64 binaries for linux and windows by @pelletier in #790

Full Changelog: pelletier/go-toml@v2.0.1...v2.0.2

`v2.0.1`

Compare Source

What's Changed

Fixed bugs

Encode: fix embedded struct with explicit field name by @pelletier in #773
Encode: fix multiline comment by @pelletier in #775
Encode: support comment on array tables by @pelletier in #776
Decode: check max uint on 32 bit platforms by @pelletier in #778

Documentation

Typo in README.md fix by @fnork in #770

New Contributors

@fnork made their first contribution in #770

Full Changelog: pelletier/go-toml@v2.0.0...v2.0.1

`v2.0.0`

Compare Source

It is finally here! go-toml v2 is now stable. 🎉

Only just over one year after I started working on it. This version of go-toml has been rebuilt from the ground up. It respects the latest TOML specification. Countless bugs have been fixed. It behaves more like the standard library. And it is much faster. Special attention was given to keeping the public API to a minimum. Continuing the strict policy of backward compatibility, the next breaking change will be in another 5 years!

Thank you to everybody who contributed to this new version, as well as folks willing to try out the intermediate beta versions. Shout out to @moorereason for reporting many issues during the development process using differential fuzzing, as well as @bep for running a beta on the popular Hugo project!

There is still some work that could be done to improve the performance of the library (#758 and #669 for instance). But I am confident that the library is in a good-enough place at the moment for folks to reap the benefits of the rewrite. The major feature removal is the sort-of-AST that v1 provided. It allowed manipulating an arbitrary document and writing it back out. This was done to cut down the scope of the project, removing a feature that had unclear use-cases. The v2 parser creates some intermediate AST so that if somebody is up to design a Document API the tools should be available to do so. Please reach out if you are interested!

The readme contains a list of differences between v1 and v2 to be aware of when upgrading. Please report any issue you may have with the new version in the bug tracker 🐞, provide feedback, and ask questions in Discussions 💬.
With this release, go-toml v1 will not be receiving any updates. This is required to keep maintenance of the project to a minimum.

Hopefully, this change doesn't break your thing!

Full commit log: pelletier/go-toml@c9a09d8...v2

Thank you contributors: @pelletier @oschwald @moorereason @xwjdsh @kkHAIKE @RiyaJohn @jidicula @zostay @mmorel-35.

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

If you want to rebase/retry this PR, check this box

This PR has been generated by Renovate Bot.

pacostas · 2025-12-22T10:28:52Z

@dependabot recreate

…to v2

paketo-bot · 2026-03-06T04:58:48Z

Edited/Blocked Notification

Renovate will not automatically rebase this PR, because it does not recognize the last commit author and assumes somebody else may have edited the PR.

You can manually request rebase by checking the rebase/retry box above.

⚠️ Warning: custom changes will be lost.

paketo-bot added dependencies semver:patch A change requiring a patch version bump labels Dec 20, 2025

paketo-bot requested review from a team as code owners December 20, 2025 04:41

paketo-bot requested review from ForestEckhardt and modulo11 December 20, 2025 04:41

paketo-bot added semver:patch A change requiring a patch version bump dependencies labels Dec 20, 2025

github-actions bot removed go labels Dec 22, 2025

chore(deps): updated module github.com/pelletier/go-toml from v1.9.5 …

5f9ed1f

…to v2

pacostas force-pushed the renovate/github.com-pelletier-go-toml-2.x branch from b7d6a1a to 5f9ed1f Compare December 22, 2025 10:29

pacostas previously approved these changes Mar 5, 2026

View reviewed changes

Merge branch 'main' into renovate/github.com-pelletier-go-toml-2.x

53a7c53

pacostas dismissed their stale review via 53a7c53 March 5, 2026 12:01

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

chore(deps): updated module github.com/pelletier/go-toml from v1.9.5 to v2#492

chore(deps): updated module github.com/pelletier/go-toml from v1.9.5 to v2#492
paketo-bot wants to merge 2 commits intomainfrom
renovate/github.com-pelletier-go-toml-2.x

paketo-bot commented Dec 20, 2025 •

edited

Loading

Uh oh!

pacostas commented Dec 22, 2025

Uh oh!

paketo-bot commented Mar 6, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

paketo-bot commented Dec 20, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Release Notes

Highlight

What's Changed

Documentation

Other changes

New Contributors

What's Changed

What's new

Performance

Fixed bugs

Documentation

Other changes

New Contributors

What's Changed

Fixed bugs

New Contributors

What's Changed

Fixed bugs

New Contributors

What's Changed

What's new

Fixed bugs

Documentation

Other changes

New Contributors

What's Changed

Fixed bugs

New Contributors

What's Changed

What's new

Fixed bugs

Other changes

New Contributors

What's Changed

Fixed bugs

Other changes

New Contributors

What's Changed

What's new

Fixed bugs

Documentation

New Contributors

What's Changed

Fixed bugs

Documentation

New Contributors

What's Changed

What's new

Performance

Other changes

New Contributors

What's Changed

Fixed bugs

What's Changed

Fixed bugs

New Contributors

What's Changed

Fixed bugs

Other changes

What's Changed

Fixed bugs

Other changes

What's Changed

Fixed bugs

Documentation

New Contributors

Configuration

Uh oh!

pacostas commented Dec 22, 2025

Uh oh!

paketo-bot commented Mar 6, 2026

Edited/Blocked Notification

Uh oh!

Reviewers

Assignees

Labels

Projects

paketo-bot commented Dec 20, 2025 •

edited

Loading