pyjavaproperties Python replacement for java.util.Properties. ================ pyjavaproperties ================ * Project hosting: <http://bitbucket.org/jnoller/pyjavaproperties/> .. contents:: About ------------------ This is a "fork" of the "python replacement for java.util.Properties" recipe on ASPN: <http://code.activestate.com/recipes/496795/> and uploaded by Anand Balachandran Pillai. The project is primarily maintained by Jesse Noller. License ------------------ As with all ASPN recipes not otherwise licensed, the original recipe is under the MIT License. For more information, see the ASPN terms of service here: <http://code.activestate.com/help/terms/> This project continues with the MIT License. No sense in changing it. What this is ------------------ This module is designed to be a python equivalent to the `java.util.Properties <http://java.sun.com/j2se/1.5.0/docs/api/java/util/Properties.html>`_ class. Currently, the basic input/output methods are supported, and there are plans to add the XML input/output methods found in J2SE 5.0. Fundamentally, this module is designed so that users can easily parse and manipulate Java Properties files - that's it. There's a fair number of us pythonistas who work in multi-language shops, and constantly writing your own parsing mechanism is just painful. Not to mention Java guys are notoriously unwilling to use anything which is cross-language for configuration, unless it's XML, which is a form of self-punishment. :) Plans ------------------ Here is a rough plan of features: - Keep/maintain blank lines and comments found in the original file - Make the module compatible with the new methods in J2SE 5.0 - Switch to/add python property access rather than direct dictionary get/set - Add unit tests - Add unicode support - When-Pigs-Fly: If running within Jython, switch to java.util.Properties under the hood - Coercion/conversion to python types for values Usage ------------------ This is the easy part:: from pyjavaproperties import Properties p = Properties() p.load(open('test2.properties')) p.list() print p print p.items() print p['name3'] p['name3'] = 'changed = value' print p['name3'] p['new key'] = 'new value' p.store(open('test2.properties','w')) See also the Properties.list() method, which will return an iterator over the property keys Changes & News -------------- 0.3: - Keys that are added which were not part of the original file are simply appended to the index. Shenanigans. 0.2: - Added an internal list (self._keyorder) to keep an ordered index of keys as they are encountered, so the file can we written-back out in the same order. 0.1: - Initial release/fork. - Added setup/packaging and doc - added in {foo} style references for previous properties, thanks to N B on ASPN. Jesse Noller 04d149a1ac4a07b5dd411965b329da86536244dc 0.3