blob: 6507b535836b80ddb8d575ec2e5a8cc53e7d8e06 [file] [log] [blame] [view]
Overview
========
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'.
The properties library supports both ISO-8859-1 and UTF-8 encoded data.
Install
-------
$ go get github.com/magiconair/properties
Documentation
-------------
See [![GoDoc](https://godoc.org/github.com/magiconair/properties?status.png)](https://godoc.org/github.com/magiconair/properties)
History
-------
v1.1.0, 20 Jan 2014
-------------------
* 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
v1.0.0, 7 Jan 2014
------------------
* Initial release
License
-------
2 clause BSD license. See LICENSE file for details.
ToDo
----
* Add MustGet ... functions
* Add support for int and uint
* Dump contents to stdout with passwords and secrets obscured
* panic on non-existent key
* log non-existent key