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

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:

<repository>
  <id>clojars.org</id>
  <url>http://clojars.org/repo</url>
</repository>

With Leiningen:

With Maven:

<dependency>
  <groupId>clojurewerkz</groupId>
  <artifactId>propertied</artifactId>
  <version>1.2.0</version>
</dependency>

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.

clojurewerkz.propertied.properties/load-from is a polymorphic function that instantiates a property list from an input (e.g. a map or property file).

clojurewerkz.propertied.properties/store-to takes a map and stores it into a .properties file (an output stream or anything else that can be coerced to java.io.Writer).

clojurewerkz.propertied.properties/properties->map is a function that converts a java.util.Properties to an immutable map. clojurewerkz.propertied.properties/map->properties converts the opposite way.

(require '[clojurewerkz.propertied.properties :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 '[clojure.java.io :as io])

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

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

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

Propertied requires Clojure 1.5.

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

• Langohr
• Elastisch
• Cassaforte
• Monger
• Neocons
• Quartzite

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-2016 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.