properties is a Go library for reading and writing properties files.
It supports reading from multiple files and Spring style recursive property
expansion of expressions like ${key}
to their corresponding value.
Value expressions can refer to other keys like in ${key}
or to
environment variables like in ${USER}
.
Filenames can also contain environment variables like in
/home/${USER}/myapp.properties
.
Comments and the order of keys are preserved. Comments can be modified and can be written to the output.
The properties library supports both ISO-8859-1 and UTF-8 encoded data.
Starting from version 1.3.0 the behavior of the MustXXX() functions is
configurable by providing a custom ErrorHandler
function. The default has
changed from panic
to log.Fatal
but this is configurable and custom
error handling functions can be provided. See the package documentation for
details.
import "github.com/magiconair/properties"
func main() {
p := properties.MustLoadFile("${HOME}/config.properties", properties.UTF8)
host := p.MustGetString("host")
port := p.GetInt("port", 8080)
}
Read the full documentation on GoDoc
$ go get -u github.com/magiconair/properties
- Vendored in gopkg.in/check.v1
- Pull Request #6: Add Delete method to remove keys including comments. (@gerbenjacobs)
- Issue #5: Allow disabling of property expansion DisableExpansion. When property expansion is disabled Properties become a simple key/value store and don't check for circular references.
- Issue #4: Maintain key order in Filter(), FilterPrefix() and FilterRegexp()
- Issue #3: Don't print comments in WriteComment() if they are all empty
- Add clickable links to README
- Added GetParsedDuration() and MustGetParsedDuration() for values specified compatible with time.ParseDuration().
- Added support for single and multi-line comments (reading, writing and updating)
- The order of keys is now preserved
- Calling Set() with an empty key now silently ignores the call and does not create a new entry
- Added a MustSet() method
- Migrated test library from launchpad.net/gocheck to gopkg.in/check.v1
- Issue #2: Fixed goroutine leak in parser which created two lexers but cleaned up only one
- Issue #1: Fixed bug in Keys() method which returned an empty string
- Added Keys() to get the keys
- Added Filter(), FilterRegexp() and FilterPrefix() to get a subset of the properties
- Added support for time.Duration
- Made MustXXX() failure behavior configurable (log.Fatal, panic, custom)
- Changed default of MustXXX() failure from panic to log.Fatal
- Added MustGet... functions
- Added support for int and uint with range checks on 32 bit platforms
- Renamed from goproperties to properties
- Added support for expansion of environment vars in filenames and value expressions
- Fixed bug where value expressions were not at the start of the string
- Initial release
2 clause BSD license. See LICENSE file for details.
- Dump contents with passwords and secrets obscured