Viper Files

[!WARNING] This release includes a few minor breaking changes. Read the upgrade guide for details.

What's Changed

Exciting New Features 🎉

• New encoding layer by @sagikazarmark in https://github.com/spf13/viper/pull/1869

Enhancements 🚀

• Drop Go 1.20 support by @sagikazarmark in https://github.com/spf13/viper/pull/1846
• Drop slog shim by @sagikazarmark in https://github.com/spf13/viper/pull/1848
• Replace file searching API with a finder by @sagikazarmark in https://github.com/spf13/viper/pull/1849
• Finder feature flag by @sagikazarmark in https://github.com/spf13/viper/pull/1852
• Allow setting options on the global Viper instance by @sagikazarmark in https://github.com/spf13/viper/pull/1856
• Add experimental flag for bind struct by @sagikazarmark in https://github.com/spf13/viper/pull/1854
• Make the remote package a separate module by @sagikazarmark in https://github.com/spf13/viper/pull/1860
• Add decoder hook option by @sagikazarmark in https://github.com/spf13/viper/pull/1872
• Encoder improvements by @sagikazarmark in https://github.com/spf13/viper/pull/1885
• Get uint8 by @martinconic in https://github.com/spf13/viper/pull/1894

Bug Fixes 🐛

• Fix missing config type when reading from a buffer by @sagikazarmark in https://github.com/spf13/viper/pull/1857
• fix: do not allow setting dependencies to nil values by @sagikazarmark in https://github.com/spf13/viper/pull/1871
• feat: copy keydelim from parent chart in viper.Sub() by @obs-gh-alexlew in https://github.com/spf13/viper/pull/1887

Breaking Changes 🛠

• Drop encoding formats: HCL, Java properties, INI by @sagikazarmark in https://github.com/spf13/viper/pull/1870

Dependency Updates ⬆️

• chore: update mapstructure by @sagikazarmark in https://github.com/spf13/viper/pull/1723
• chore: update crypt by @sagikazarmark in https://github.com/spf13/viper/pull/1834
• build(deps): bump github/codeql-action from 3.25.7 to 3.25.8 by @dependabot in https://github.com/spf13/viper/pull/1853
• Revert to go-difflib and go-spew releases by @skitt in https://github.com/spf13/viper/pull/1861
• build(deps): bump actions/dependency-review-action from 4.3.2 to 4.3.3 by @dependabot in https://github.com/spf13/viper/pull/1862
• build(deps): bump github/codeql-action from 3.25.8 to 3.25.10 by @dependabot in https://github.com/spf13/viper/pull/1865
• build(deps): bump actions/checkout from 4.1.6 to 4.1.7 by @dependabot in https://github.com/spf13/viper/pull/1864
• chore: update crypt by @sagikazarmark in https://github.com/spf13/viper/pull/1866
• build(deps): bump github/codeql-action from 3.25.10 to 3.25.11 by @dependabot in https://github.com/spf13/viper/pull/1876
• build(deps): bump google.golang.org/grpc from 1.64.0 to 1.64.1 in /remote by @dependabot in https://github.com/spf13/viper/pull/1878
• build(deps): bump actions/setup-go from 5.0.1 to 5.0.2 by @dependabot in https://github.com/spf13/viper/pull/1879
• build(deps): bump actions/dependency-review-action from 4.3.3 to 4.3.4 by @dependabot in https://github.com/spf13/viper/pull/1881
• build(deps): bump github/codeql-action from 3.25.11 to 3.25.12 by @dependabot in https://github.com/spf13/viper/pull/1880
• build(deps): bump github/codeql-action from 3.25.12 to 3.25.13 by @dependabot in https://github.com/spf13/viper/pull/1883
• chore(deps): update crypt by @sagikazarmark in https://github.com/spf13/viper/pull/1884
• chore: update dependencies by @sagikazarmark in https://github.com/spf13/viper/pull/1888
• build(deps): bump github.com/go-viper/mapstructure/v2 from 2.0.0 to 2.1.0 by @dependabot in https://github.com/spf13/viper/pull/1901
• build(deps): bump github.com/spf13/cast from 1.6.0 to 1.7.0 by @dependabot in https://github.com/spf13/viper/pull/1899
• build(deps): bump github/codeql-action from 3.25.13 to 3.26.0 by @dependabot in https://github.com/spf13/viper/pull/1897
• build(deps): bump golangci/golangci-lint-action from 6.0.1 to 6.1.0 by @dependabot in https://github.com/spf13/viper/pull/1893
• build(deps): bump github/codeql-action from 3.26.0 to 3.26.2 by @dependabot in https://github.com/spf13/viper/pull/1903
• build(deps): bump github/codeql-action from 3.26.2 to 3.26.3 by @dependabot in https://github.com/spf13/viper/pull/1905
• build(deps): bump github/codeql-action from 3.26.3 to 3.26.5 by @dependabot in https://github.com/spf13/viper/pull/1909
• Update Go by @sagikazarmark in https://github.com/spf13/viper/pull/1913
• chore: update crypt package by @sagikazarmark in https://github.com/spf13/viper/pull/1914
• build(deps): bump github/codeql-action from 3.26.5 to 3.26.6 by @dependabot in https://github.com/spf13/viper/pull/1915
• build(deps): bump mheap/github-action-required-labels from 5.4.1 to 5.4.2 by @dependabot in https://github.com/spf13/viper/pull/1916
• build(deps): bump cachix/install-nix-action from 27 to 28 by @dependabot in https://github.com/spf13/viper/pull/1919
• build(deps): bump github/codeql-action from 3.26.6 to 3.26.7 by @dependabot in https://github.com/spf13/viper/pull/1920
• chore: update crypt by @sagikazarmark in https://github.com/spf13/viper/pull/1921
• build(deps): bump github/codeql-action from 3.26.7 to 3.26.8 by @dependabot in https://github.com/spf13/viper/pull/1923
• build(deps): bump github.com/go-viper/mapstructure/v2 from 2.1.0 to 2.2.1 by @dependabot in https://github.com/spf13/viper/pull/1925
• build(deps): bump github/codeql-action from 3.26.8 to 3.26.11 by @dependabot in https://github.com/spf13/viper/pull/1932
• build(deps): bump golangci/golangci-lint-action from 6.1.0 to 6.1.1 by @dependabot in https://github.com/spf13/viper/pull/1930
• build(deps): bump actions/checkout from 4.1.7 to 4.2.0 by @dependabot in https://github.com/spf13/viper/pull/1928
• build(deps): bump actions/checkout from 4.2.0 to 4.2.1 by @dependabot in https://github.com/spf13/viper/pull/1936
• build(deps): bump github/codeql-action from 3.26.11 to 3.27.2 by @dependabot in https://github.com/spf13/viper/pull/1948
• build(deps): bump github.com/fsnotify/fsnotify from 1.7.0 to 1.8.0 by @dependabot in https://github.com/spf13/viper/pull/1944
• build(deps): bump actions/setup-go from 5.0.2 to 5.1.0 by @dependabot in https://github.com/spf13/viper/pull/1942
• build(deps): bump actions/dependency-review-action from 4.3.4 to 4.4.0 by @dependabot in https://github.com/spf13/viper/pull/1943
• build(deps): bump actions/checkout from 4.2.1 to 4.2.2 by @dependabot in https://github.com/spf13/viper/pull/1941
• build(deps): bump github/codeql-action from 3.27.2 to 3.27.3 by @dependabot in https://github.com/spf13/viper/pull/1949
• build(deps): bump github/codeql-action from 3.27.3 to 3.27.7 by @dependabot in https://github.com/spf13/viper/pull/1958
• build(deps): bump mheap/github-action-required-labels from 5.4.2 to 5.5.0 by @dependabot in https://github.com/spf13/viper/pull/1957
• build(deps): bump actions/dependency-review-action from 4.4.0 to 4.5.0 by @dependabot in https://github.com/spf13/viper/pull/1953
• build(deps): bump actions/setup-go from 5.1.0 to 5.2.0 by @dependabot in https://github.com/spf13/viper/pull/1959
• build(deps): bump github.com/stretchr/testify from 1.9.0 to 1.10.0 by @dependabot in https://github.com/spf13/viper/pull/1954
• build(deps): bump golang.org/x/crypto from 0.27.0 to 0.31.0 in /remote by @dependabot in https://github.com/spf13/viper/pull/1960
• build(deps): bump github/codeql-action from 3.27.7 to 3.27.9 by @dependabot in https://github.com/spf13/viper/pull/1964
• chore: update afero by @sagikazarmark in https://github.com/spf13/viper/pull/1973
• build(deps): bump github.com/spf13/cast from 1.7.0 to 1.7.1 by @dependabot in https://github.com/spf13/viper/pull/1968
• build(deps): bump github.com/spf13/pflag from 1.0.5 to 1.0.6 by @dependabot in https://github.com/spf13/viper/pull/1979
• ci: add Go 1.24 to the test matrix by @sagikazarmark in https://github.com/spf13/viper/pull/1983

Other Changes

• refactor: move remote code to separate file by @sagikazarmark in https://github.com/spf13/viper/pull/1847
• refactor: cleanup unused encoding code by @sagikazarmark in https://github.com/spf13/viper/pull/1889
• Fix issues reported by testifylint by @deining in https://github.com/spf13/viper/pull/1965
• docs: add update instructions for 1.20 by @sagikazarmark in https://github.com/spf13/viper/pull/1992

New Contributors

• @obs-gh-alexlew made their first contribution in https://github.com/spf13/viper/pull/1887
• @martinconic made their first contribution in https://github.com/spf13/viper/pull/1894
• @deining made their first contribution in https://github.com/spf13/viper/pull/1965

Full Changelog: https://github.com/spf13/viper/compare/v1.19.0...v1.20.0