github.com/spf13/viper
v1.21.0
#68 most downloaded on Go modules
spf13/viper
What this package is like to depend on
Last release 10 months ago
15 Oct 2025
Ships fairly regularly
a new release about every 2 weeks
Rarely documented
notes for 3 of 38 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
647 releases · first in 2014
9 releases in the last 12 months
see the full history below
Release timeline
647 releases · Apr 2014 to Oct 2025Releases
latest 60 of 647-
v1.21.1-0.20251015212001-528f7416c4b515 Oct 2025 pre-releaseNothing published for this version
-
v1.21.1-0.20251002202827-0525738e5e7f02 Oct 2025 pre-releaseNothing published for this version
-
v1.21.1-0.20250926200203-2220648d158226 Sep 2025 pre-releaseNothing published for this version
-
v1.21.1-0.20250918194929-e66ee1a10ee018 Sep 2025 pre-releaseNothing published for this version
-
v1.21.1-0.20250912172359-7a5ad96afc0d12 Sep 2025 pre-releaseNothing published for this version
-
v1.21.1-0.20250908165741-0b6c29e0b76b08 Sep 2025 pre-releaseNothing published for this version
-
v1.21.008 Sep 2025Release notes
Open source →What's Changed
Enhancements 🚀
- Add support for flags pflag.BoolSlice, pflag.UintSlice and pflag.Float64Slice by @nmvalera in #2015
- feat: use maintained yaml library by @sagikazarmark in #2040
Bug Fixes 🐛
- fix(config): get config type from v.configType or config file ext by @GuillaumeBAECHLER in #2003
- fix: config type check when loading any config by @sagikazarmark in #2007
Dependency Updates ⬆️
- Update dependencies by @sagikazarmark in #1993
- build(deps): bump github.com/spf13/cast from 1.7.1 to 1.8.0 by @dependabot[bot] in #2017
- build(deps): bump github.com/pelletier/go-toml/v2 from 2.2.3 to 2.2.4 by @dependabot[bot] in #2013
- build(deps): bump github.com/sagikazarmark/locafero from 0.8.0 to 0.9.0 by @dependabot[bot] in #2008
- build(deps): bump golang.org/x/net from 0.37.0 to 0.38.0 in /remote by @dependabot[bot] in #2016
- build(deps): bump github.com/spf13/cast from 1.8.0 to 1.9.2 by @dependabot[bot] in #2020
- build(deps): bump github.com/go-viper/mapstructure/v2 from 2.2.1 to 2.3.0 by @dependabot[bot] in #2028
- build(deps): bump github.com/go-viper/mapstructure/v2 from 2.3.0 to 2.4.0 by @dependabot[bot] in #2035
- build(deps): bump github.com/spf13/pflag from 1.0.6 to 1.0.7 by @dependabot[bot] in #2036
- build(deps): bump github.com/fsnotify/fsnotify from 1.8.0 to 1.9.0 by @dependabot[bot] in #2012
- build(deps): bump github.com/stretchr/testify from 1.10.0 to 1.11.1 by @dependabot[bot] in #2052
- build(deps): bump github.com/go-viper/mapstructure/v2 from 2.3.0 to 2.4.0 in /remote by @dependabot[bot] in #2048
- build(deps): bump github.com/spf13/pflag from 1.0.7 to 1.0.10 by @dependabot[bot] in #2056
- chore: update dependencies by @sagikazarmark in #2057
Other Changes
- Update update guide with
mapstructurepackage replacement. by @aldas in #2004 - refactor: use the built-in max/min to simplify the code by @yingshanghuangqiao in #2029
New Contributors
- @GuillaumeBAECHLER made their first contribution in #2003
- @aldas made their first contribution in #2004
- @nmvalera made their first contribution in #2015
- @yingshanghuangqiao made their first contribution in #2029
- @ccoVeille made their first contribution in #2046
- @spacez320 made their first contribution in #2050
Full Changelog: v1.20.0...v1.21.0
-
v1.20.2-0.20250326173141-8bf8e1d6c54526 Mar 2025 pre-releaseNothing published for this version
-
v1.20.126 Mar 2025Release notes
Open source →What's Changed
Bug Fixes 🐛
- Backport config type fixes to 1.20.x by @sagikazarmark in #2005
Full Changelog: v1.20.0...v1.20.1
-
v1.20.1-0.20250816071711-b74c7ee1e5e916 Aug 2025 pre-releaseNothing published for this version
-
v1.20.1-0.20250816011001-35c2854c771316 Aug 2025 pre-releaseNothing published for this version
-
v1.20.1-0.20250816003738-010479baba0316 Aug 2025 pre-releaseNothing published for this version
-
v1.20.1-0.20250801125934-4df8a66f9eea01 Aug 2025 pre-releaseNothing published for this version
-
v1.20.1-0.20250729140337-b7b990446f1229 Jul 2025 pre-releaseNothing published for this version
-
v1.20.1-0.20250729135358-5204d838441629 Jul 2025 pre-releaseNothing published for this version
-
v1.20.1-0.20250616221757-8fd6b8123b5f16 Jun 2025 pre-releaseNothing published for this version
-
v1.20.1-0.20250603092335-260b8e9a3c7503 Jun 2025 pre-releaseNothing published for this version
-
v1.20.1-0.20250519175512-2183a3ce3c9819 May 2025 pre-releaseNothing published for this version
-
v1.20.1-0.20250326172511-1508a7ba447826 Mar 2025 pre-releaseNothing published for this version
-
v1.20.1-0.20250326064321-4ddd7c091cc026 Mar 2025 pre-releaseNothing published for this version
-
v1.20.1-0.20250326064321-39ab9050284c26 Mar 2025 pre-releaseNothing published for this version
-
v1.20.1-0.20250321024200-d319333b0ffd21 Mar 2025 pre-releaseNothing published for this version
-
v1.20.1-0.20250315150647-4fcec8d629a315 Mar 2025 pre-releaseNothing published for this version
-
v1.20.1-0.20250315150437-d50e7f625e4d15 Mar 2025 pre-releaseNothing published for this version
-
v1.20.015 Mar 2025Release notes
Open source →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 #1869
Enhancements 🚀
- Drop Go 1.20 support by @sagikazarmark in #1846
- Drop slog shim by @sagikazarmark in #1848
- Replace file searching API with a finder by @sagikazarmark in #1849
- Finder feature flag by @sagikazarmark in #1852
- Allow setting options on the global Viper instance by @sagikazarmark in #1856
- Add experimental flag for bind struct by @sagikazarmark in #1854
- Make the remote package a separate module by @sagikazarmark in #1860
- Add decoder hook option by @sagikazarmark in #1872
- Encoder improvements by @sagikazarmark in #1885
- Get uint8 by @martinconic in #1894
Bug Fixes 🐛
- Fix missing config type when reading from a buffer by @sagikazarmark in #1857
- fix: do not allow setting dependencies to nil values by @sagikazarmark in #1871
- feat: copy keydelim from parent chart in viper.Sub() by @obs-gh-alexlew in #1887
Breaking Changes 🛠
- Drop encoding formats: HCL, Java properties, INI by @sagikazarmark in #1870
Dependency Updates ⬆️
- chore: update mapstructure by @sagikazarmark in #1723
- chore: update crypt by @sagikazarmark in #1834
- build(deps): bump github/codeql-action from 3.25.7 to 3.25.8 by @dependabot in #1853
- Revert to go-difflib and go-spew releases by @skitt in #1861
- build(deps): bump actions/dependency-review-action from 4.3.2 to 4.3.3 by @dependabot in #1862
- build(deps): bump github/codeql-action from 3.25.8 to 3.25.10 by @dependabot in #1865
- build(deps): bump actions/checkout from 4.1.6 to 4.1.7 by @dependabot in #1864
- chore: update crypt by @sagikazarmark in #1866
- build(deps): bump github/codeql-action from 3.25.10 to 3.25.11 by @dependabot in #1876
- build(deps): bump google.golang.org/grpc from 1.64.0 to 1.64.1 in /remote by @dependabot in #1878
- build(deps): bump actions/setup-go from 5.0.1 to 5.0.2 by @dependabot in #1879
- build(deps): bump actions/dependency-review-action from 4.3.3 to 4.3.4 by @dependabot in #1881
- build(deps): bump github/codeql-action from 3.25.11 to 3.25.12 by @dependabot in #1880
- build(deps): bump github/codeql-action from 3.25.12 to 3.25.13 by @dependabot in #1883
- chore(deps): update crypt by @sagikazarmark in #1884
- chore: update dependencies by @sagikazarmark in #1888
- build(deps): bump github.com/go-viper/mapstructure/v2 from 2.0.0 to 2.1.0 by @dependabot in #1901
- build(deps): bump github.com/spf13/cast from 1.6.0 to 1.7.0 by @dependabot in #1899
- build(deps): bump github/codeql-action from 3.25.13 to 3.26.0 by @dependabot in #1897
- build(deps): bump golangci/golangci-lint-action from 6.0.1 to 6.1.0 by @dependabot in #1893
- build(deps): bump github/codeql-action from 3.26.0 to 3.26.2 by @dependabot in #1903
- build(deps): bump github/codeql-action from 3.26.2 to 3.26.3 by @dependabot in #1905
- build(deps): bump github/codeql-action from 3.26.3 to 3.26.5 by @dependabot in #1909
- Update Go by @sagikazarmark in #1913
- chore: update crypt package by @sagikazarmark in #1914
- build(deps): bump github/codeql-action from 3.26.5 to 3.26.6 by @dependabot in #1915
- build(deps): bump mheap/github-action-required-labels from 5.4.1 to 5.4.2 by @dependabot in #1916
- build(deps): bump cachix/install-nix-action from 27 to 28 by @dependabot in #1919
- build(deps): bump github/codeql-action from 3.26.6 to 3.26.7 by @dependabot in #1920
- chore: update crypt by @sagikazarmark in #1921
- build(deps): bump github/codeql-action from 3.26.7 to 3.26.8 by @dependabot in #1923
- build(deps): bump github.com/go-viper/mapstructure/v2 from 2.1.0 to 2.2.1 by @dependabot in #1925
- build(deps): bump github/codeql-action from 3.26.8 to 3.26.11 by @dependabot in #1932
- build(deps): bump golangci/golangci-lint-action from 6.1.0 to 6.1.1 by @dependabot in #1930
- build(deps): bump actions/checkout from 4.1.7 to 4.2.0 by @dependabot in #1928
- build(deps): bump actions/checkout from 4.2.0 to 4.2.1 by @dependabot in #1936
- build(deps): bump github/codeql-action from 3.26.11 to 3.27.2 by @dependabot in #1948
- build(deps): bump github.com/fsnotify/fsnotify from 1.7.0 to 1.8.0 by @dependabot in #1944
- build(deps): bump actions/setup-go from 5.0.2 to 5.1.0 by @dependabot in #1942
- build(deps): bump actions/dependency-review-action from 4.3.4 to 4.4.0 by @dependabot in #1943
- build(deps): bump actions/checkout from 4.2.1 to 4.2.2 by @dependabot in #1941
- build(deps): bump github/codeql-action from 3.27.2 to 3.27.3 by @dependabot in #1949
- build(deps): bump github/codeql-action from 3.27.3 to 3.27.7 by @dependabot in #1958
- build(deps): bump mheap/github-action-required-labels from 5.4.2 to 5.5.0 by @dependabot in #1957
- build(deps): bump actions/dependency-review-action from 4.4.0 to 4.5.0 by @dependabot in #1953
- build(deps): bump actions/setup-go from 5.1.0 to 5.2.0 by @dependabot in #1959
- build(deps): bump github.com/stretchr/testify from 1.9.0 to 1.10.0 by @dependabot in #1954
- build(deps): bump golang.org/x/crypto from 0.27.0 to 0.31.0 in /remote by @dependabot in #1960
- build(deps): bump github/codeql-action from 3.27.7 to 3.27.9 by @dependabot in #1964
- chore: update afero by @sagikazarmark in #1973
- build(deps): bump github.com/spf13/cast from 1.7.0 to 1.7.1 by @dependabot in #1968
- build(deps): bump github.com/spf13/pflag from 1.0.5 to 1.0.6 by @dependabot in #1979
- ci: add Go 1.24 to the test matrix by @sagikazarmark in #1983
Other Changes
- refactor: move remote code to separate file by @sagikazarmark in #1847
- refactor: cleanup unused encoding code by @sagikazarmark in #1889
- Fix issues reported by testifylint by @deining in #1965
- docs: add update instructions for 1.20 by @sagikazarmark in #1992
New Contributors
- @obs-gh-alexlew made their first contribution in #1887
- @martinconic made their first contribution in #1894
- @deining made their first contribution in #1965
Full Changelog: v1.19.0...v1.20.0
-
v1.20.0-alpha.6.0.20250315145818-c33d6fc76e1015 Mar 2025 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20250218150643-9c07e0f0633c18 Feb 2025 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20250217005313-66e3e2877d2a17 Feb 2025 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20250212010142-17b96ac0d54012 Feb 2025 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20250109134504-8b223a45cef109 Jan 2025 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20241213232416-a5ea569d2e3c13 Dec 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20241212001248-54f2089833b612 Dec 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20241114090510-60e5c445378914 Nov 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20241113133547-30f38f63600513 Nov 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20241015061040-76d3bebef58815 Oct 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20241006083302-70cfc59c979206 Oct 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20240923171347-b5cf74cc017c23 Sep 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20240922224646-975fbb420a1f22 Sep 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20240922224550-c107952d90f322 Sep 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20240916130823-cbe1cf13d23316 Sep 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20240913122017-80361e88839913 Sep 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20240903103719-273543ce823703 Sep 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20240829180929-523595b102bd29 Aug 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20240828215253-d56d426333ca28 Aug 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20240822075027-e7db72c995b722 Aug 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20240815124806-79c5dd006db815 Aug 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20240813113131-b950f553d14613 Aug 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.6.0.20240723180819-cc53fac0374723 Jul 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.623 Jul 2024 pre-releaseRelease notes
Open source →What's Changed
Enhancements 🚀
- Encoder improvements by @sagikazarmark in #1885
Bug Fixes 🐛
- feat: copy keydelim from parent chart in viper.Sub() by @obs-gh-alexlew in #1887
Dependency Updates ⬆️
- build(deps): bump google.golang.org/grpc from 1.64.0 to 1.64.1 in /remote by @dependabot in #1878
- build(deps): bump actions/setup-go from 5.0.1 to 5.0.2 by @dependabot in #1879
- build(deps): bump actions/dependency-review-action from 4.3.3 to 4.3.4 by @dependabot in #1881
- build(deps): bump github/codeql-action from 3.25.11 to 3.25.12 by @dependabot in #1880
- build(deps): bump github/codeql-action from 3.25.12 to 3.25.13 by @dependabot in #1883
- chore(deps): update crypt by @sagikazarmark in #1884
- chore: update dependencies by @sagikazarmark in #1888
Other Changes
- refactor: cleanup unused encoding code by @sagikazarmark in #1889
New Contributors
- @obs-gh-alexlew made their first contribution in #1887
Full Changelog: v1.20.0-alpha.5...v1.20.0-alpha.6
-
v1.20.0-alpha.5.0.20240723180642-e2ab48ad877a23 Jul 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.5.0.20240723174518-3268cbdcf41a23 Jul 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.5.0.20240720131356-3c40652f77cc20 Jul 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.5.0.20240715191239-551e8939be1e15 Jul 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.5.0.20240710123712-a0ece6a20fd510 Jul 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.5.0.20240701041314-3f40d9a463ca01 Jul 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.501 Jul 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.4.0.20240701041117-e32d9f3d968601 Jul 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.4.0.20240624182309-e71d7bf15cb024 Jun 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.424 Jun 2024 pre-releaseNothing published for this version
-
v1.20.0-alpha.3.0.20240624163141-d2458a2abcf924 Jun 2024 pre-releaseNothing published for this version