Skip to content


Repository files navigation

What is Propertied

Propertied is a tiny Clojure library that deals with Java property lists.

Project Maturity

Propertied is not a young project and unlikely to radically change (it is too small in scope).


Propertied artifacts are released to Clojars. If you are using Maven, add the following repository definition to your pom.xml:


The Most Recent Release

With Leiningen:

Clojars Project

With Maven:


Documentation & Examples

Propertied makes it easy to convert property lists (java.util.Properties) into Clojure maps and vice versa. Thus working with property lists is generally as straightforward as working with maps. is a polymorphic function that instantiates a property list from an input (e.g. a map or property file). takes a map and stores it into a .properties file (an output stream or anything else that can be coerced to>map is a function that converts a java.util.Properties to an immutable map.>properties converts the opposite way.

(require '[ :as p])

(p/load-from {"a key" "a value"})
;= {"a key" "a value"}
(class (p/load-from {"a key" "a value"}))
;= java.util.Properties
(let [pl (p/load-from {"a key" "a value"})]
  (p/properties->map pl))
;= {"a key" "a value"}

;; converting keys to keywords
(let [pl (p/load-from {"key" "a value"})]
  (p/properties->map pl true))
;= {:key "a value"}

;; loading from files and InputStreams
(require '[ :as io])

(p/load-from (io/resource "resource/on/"))
(p/load-from (io/file "resource/on/"))

;; storing to property files (.properties)
(p/store-to {"name" "Michael" "age" "28"} "/tmp/")
(p/store-to {"name" "Michael" "age" "28"} (io/file "/tmp/"))
(p/store-to {"name" "Michael" "age" "28"} ( "michael" ".properties"))


To subscribe for announcements of releases, important changes and so on, please follow @ClojureWerkz on Twitter.

Supported Clojure Versions

Propertied requires Clojure 1.6.

Continuous Integration Status

Continuous Integration status

Propertied Is a ClojureWerkz Project

Propertied is part of the group of Clojure libraries known as ClojureWerkz, together with

and several others.


propertied uses Leiningen 2. Make sure you have it installed and then run tests against supported Clojure versions using

lein all test

Then create a branch and make your changes on it. Once you are done with your changes and all tests pass, submit a pull request on GitHub.


Copyright (C) 2013-2017 Michael S. Klishin, Alex Petrov, and the ClojureWerkz team.

Double licensed under the Eclipse Public License (the same as Clojure) or the Apache Public License 2.0.


Tiny Clojure library for working with Java property lists (java.util.Properties)







No packages published