e2m
/
dispatch
4
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
dispatch/Godeps/_workspace/src/github.com/magiconair/properties
History
Ken-Håvard Lieng 61aa5880d3 Add config file, handle it with Viper, add a command to open it in an editor 2015-05-25 04:00:21 +02:00
..
.gitignore Add config file, handle it with Viper, add a command to open it in an editor 2015-05-25 04:00:21 +02:00
.travis.yml Add config file, handle it with Viper, add a command to open it in an editor 2015-05-25 04:00:21 +02:00
LICENSE Add config file, handle it with Viper, add a command to open it in an editor 2015-05-25 04:00:21 +02:00
README.md Add config file, handle it with Viper, add a command to open it in an editor 2015-05-25 04:00:21 +02:00
benchmark_test.go Add config file, handle it with Viper, add a command to open it in an editor 2015-05-25 04:00:21 +02:00
doc.go Add config file, handle it with Viper, add a command to open it in an editor 2015-05-25 04:00:21 +02:00
example_test.go Add config file, handle it with Viper, add a command to open it in an editor 2015-05-25 04:00:21 +02:00
lex.go Add config file, handle it with Viper, add a command to open it in an editor 2015-05-25 04:00:21 +02:00
load.go Add config file, handle it with Viper, add a command to open it in an editor 2015-05-25 04:00:21 +02:00
load_test.go Add config file, handle it with Viper, add a command to open it in an editor 2015-05-25 04:00:21 +02:00
parser.go Add config file, handle it with Viper, add a command to open it in an editor 2015-05-25 04:00:21 +02:00
properties.go Add config file, handle it with Viper, add a command to open it in an editor 2015-05-25 04:00:21 +02:00
properties_test.go Add config file, handle it with Viper, add a command to open it in an editor 2015-05-25 04:00:21 +02:00
rangecheck.go Add config file, handle it with Viper, add a command to open it in an editor 2015-05-25 04:00:21 +02:00

README.md

Overview Build Status

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.

Getting Started

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 GoDoc

Installation and Upgrade

$ go get -u github.com/magiconair/properties

For testing and debugging you need the go-check library

$ go get -u gopkg.in/check.v1

History

v1.5.2, 10 Apr 2015

v1.5.1, 08 Dec 2014

v1.5.0, 18 Nov 2014

  • 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

v1.4.2, 15 Nov 2014

  • Issue #2: Fixed goroutine leak in parser which created two lexers but cleaned up only one

v1.4.1, 13 Nov 2014

  • Issue #1: Fixed bug in Keys() method which returned an empty string

v1.4.0, 23 Sep 2014

v1.3.0, 18 Mar 2014

  • Added support for time.Duration
  • Made MustXXX() failure behavior configurable (log.Fatal, panic, custom)
  • Changed default of MustXXX() failure from panic to log.Fatal

v1.2.0, 05 Mar 2014

  • Added MustGet... functions
  • Added support for int and uint with range checks on 32 bit platforms

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

  • Dump contents with passwords and secrets obscured