Java properties scanner for Go
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
assert Update copyright. May 15, 2018
.travis.yml Test with go 1.10.x May 15, 2018 Release 1.8.0 May 15, 2018
LICENSE Update LICENSE Feb 14, 2018 Add codeship badge to README Feb 17, 2018
benchmark_test.go Fix gometalinter complaints Jan 13, 2017
decode.go Update copyright. May 15, 2018
decode_test.go Update copyright. May 15, 2018
doc.go Update copyright. May 15, 2018
example_test.go Update copyright. May 15, 2018
integrate.go Update copyright. May 15, 2018
integrate_test.go Update copyright. May 15, 2018
lex.go Update copyright. May 15, 2018
load_test.go Update copyright. May 15, 2018
parser.go Update copyright. May 15, 2018
properties.go Update copyright. May 15, 2018
properties_test.go Update copyright. May 15, 2018
rangecheck.go Update copyright. May 15, 2018

Travis CI Status Codeship CI Status License GoDoc


Please run git pull --tags to update the tags. See below why.

properties is a Go library for reading and writing properties files.

It supports reading from multiple files or URLs 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}/

Properties can be decoded into structs, maps, arrays and values through struct tags.

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.

Read the full documentation on GoDoc GoDoc

Getting Started

import (

func main() {
	// init from a file
	p := properties.MustLoadFile("${HOME}/", properties.UTF8)

	// or multiple files
	p = properties.MustLoadFiles([]string{
		}, properties.UTF8, true)

	// or from a map
	p = properties.LoadMap(map[string]string{"key": "value", "abc": "def"})

	// or from a string
	p = properties.MustLoadString("key=value\nabc=def")

	// or from a URL
	p = properties.MustLoadURL("http://host/path")

	// or from multiple URLs
	p = properties.MustLoadURL([]string{
		}, true)

	// or from flags

	// get values through getters
	host := p.MustGetString("host")
	port := p.GetInt("port", 8080)

	// or through Decode
	type Config struct {
		Host    string        `properties:"host"`
		Port    int           `properties:"port,default=9000"`
		Accept  []string      `properties:"accept,default=image/png;image;gif"`
		Timeout time.Duration `properties:"timeout,default=5s"`
	var cfg Config
	if err := p.Decode(&cfg); err != nil {

Installation and Upgrade

$ go get -u


2 clause BSD license. See LICENSE file for details.


  • Dump contents with passwords and secrets obscured

Updated Git tags

13 Feb 2018

I realized that all of the git tags I had pushed before v1.7.5 were lightweight tags and I've only recently learned that this doesn't play well with git describe 😞

I have replaced all lightweight tags with signed tags using this script which should retain the commit date, name and email address. Please run git pull --tags to update them.

Worst case you have to reclone the repo.

echo "Updating $tag"
date=$(git show ${tag}^0 --format=%aD | head -1)
email=$(git show ${tag}^0 --format=%aE | head -1)
name=$(git show ${tag}^0 --format=%aN | head -1)
GIT_COMMITTER_DATE="$date" GIT_COMMITTER_NAME="$name" GIT_COMMITTER_EMAIL="$email" git tag -s -f ${tag} ${tag}^0 -m ${tag}

I apologize for the inconvenience.