Author: ehuelsmann
Date: Sat Jan 19 16:14:36 2008
New Revision: 13
Added:
branches/1.0.x/
- copied from r12, trunk/
Modified:
branches/1.0.x/README
branches/1.0.x/py-configparser.asd
branches/1.0.x/tests/py-configparser-tests.asd
trunk/README
trunk/py-configparser.asd
Log:
Branch for 1.0.
Modified: branches/1.0.x/README
==============================================================================
--- trunk/README (original)
+++ branches/1.0.x/README Sat Jan 19 16:14:36 2008
@@ -1,3 +1,52 @@
+$URL$
+$Id$
-<This file is *not* intentionally left empty! >
+py-configparser
+===============
+
+This package provides the same functionality as the Python configparser module,
+implemented in pure Common Lisp.
+
+
+Differences between the two
+===========================
+
+The CL version makes a strong distinction in the parser on one hand and the in-memory
+storage management on the other hand. Because of it, the CL version doesn't call its
+objects 'Parser', but 'config' instead.
+
+The parser/writer part of the package provides the three functions READ-STREAM,
+READ-FILES and WRITE-STREAM, which map from the python variants 'readfp', 'read'
+and 'write'.
+
+
+API mapping
+===========
+
+The functions provided in the Python module (which are all methods of the ConfigParser
+class):
+
+ConfigParser() -> (make-config)
+defaults() -> (defaults <config>)
+sections() -> (sections <config>)
+add_section(name) -> (add-section <config> name)
+has_section(name) -> (has-section-p <config> name)
+options(section_name) -> (options <config> section-name)
+has_option(section_name, name) -> (has-option-p <config> section-name name)
+read(filenames) -> (read-files <config> filenames)
+readfd(fp) -> (read-stream <config> stream)
+get(section, option[, raw[, vars]]) ->
+ (get-option <config> section option &key expand defaults type)
+getint(section, option) -> [folded into get-option using 'type' key]
+getfloat(section, option) -> [folded into get-option using 'type' key]
+getboolean(section, option) -> [folded into get-option using 'type' key]
+items(section_name[, raw[, vars]]) -> (items <config> section-name &key expand defaults)
+set(section, option, value) -> (set-option <config> section-name option-name value)
+write(fp) -> (write-stream <config> stream)
+remove_option(section, option) -> (remove-option <config> section-name option-name)
+remove_section(section) -> (remove-section <config> section-name)
+
+Note that the above is just a simple mapping table, but is all you need to get
+you started. Documentation from the ConfigParser module should sufficiently document
+this package. However minor differences in parameter and method naming may occur.
Modified: branches/1.0.x/py-configparser.asd
==============================================================================
--- trunk/py-configparser.asd (original)
+++ branches/1.0.x/py-configparser.asd Sat Jan 19 16:14:36 2008
@@ -10,7 +10,7 @@
(defsystem py-configparser
:name "py-configparser"
:author "Erik Huelsmann"
- :version "1.0-dev"
+ :version "1.0.1-dev"
:license "MIT"
:description "Common Lisp implementation of the Python ConfigParser module"
:depends-on (#:parse-number)
Modified: branches/1.0.x/tests/py-configparser-tests.asd
==============================================================================
--- trunk/tests/py-configparser-tests.asd (original)
+++ branches/1.0.x/tests/py-configparser-tests.asd Sat Jan 19 16:14:36 2008
@@ -10,7 +10,7 @@
(defsystem py-configparser-tests
:name "py-configparser-tests"
:author "Erik Huelsmann"
- :version "1.0-dev"
+ :version "1.0.1-dev"
:license "MIT"
:description "Tests for 'Common Lisp implementation of the Python ConfigParser module'"
:depends-on (#:py-configparser)
Modified: trunk/README
==============================================================================
--- trunk/README (original)
+++ trunk/README Sat Jan 19 16:14:36 2008
@@ -1,3 +1,52 @@
+$URL$
+$Id$
-<This file is *not* intentionally left empty! >
+py-configparser
+===============
+
+This package provides the same functionality as the Python configparser module,
+implemented in pure Common Lisp.
+
+
+Differences between the two
+===========================
+
+The CL version makes a strong distinction in the parser on one hand and the in-memory
+storage management on the other hand. Because of it, the CL version doesn't call its
+objects 'Parser', but 'config' instead.
+
+The parser/writer part of the package provides the three functions READ-STREAM,
+READ-FILES and WRITE-STREAM, which map from the python variants 'readfp', 'read'
+and 'write'.
+
+
+API mapping
+===========
+
+The functions provided in the Python module (which are all methods of the ConfigParser
+class):
+
+ConfigParser() -> (make-config)
+defaults() -> (defaults <config>)
+sections() -> (sections <config>)
+add_section(name) -> (add-section <config> name)
+has_section(name) -> (has-section-p <config> name)
+options(section_name) -> (options <config> section-name)
+has_option(section_name, name) -> (has-option-p <config> section-name name)
+read(filenames) -> (read-files <config> filenames)
+readfd(fp) -> (read-stream <config> stream)
+get(section, option[, raw[, vars]]) ->
+ (get-option <config> section option &key expand defaults type)
+getint(section, option) -> [folded into get-option using 'type' key]
+getfloat(section, option) -> [folded into get-option using 'type' key]
+getboolean(section, option) -> [folded into get-option using 'type' key]
+items(section_name[, raw[, vars]]) -> (items <config> section-name &key expand defaults)
+set(section, option, value) -> (set-option <config> section-name option-name value)
+write(fp) -> (write-stream <config> stream)
+remove_option(section, option) -> (remove-option <config> section-name option-name)
+remove_section(section) -> (remove-section <config> section-name)
+
+Note that the above is just a simple mapping table, but is all you need to get
+you started. Documentation from the ConfigParser module should sufficiently document
+this package. However minor differences in parameter and method naming may occur.
Modified: trunk/py-configparser.asd
==============================================================================
--- trunk/py-configparser.asd (original)
+++ trunk/py-configparser.asd Sat Jan 19 16:14:36 2008
@@ -10,7 +10,7 @@
(defsystem py-configparser
:name "py-configparser"
:author "Erik Huelsmann"
- :version "1.0-dev"
+ :version "1.1-dev"
:license "MIT"
:description "Common Lisp implementation of the Python ConfigParser module"
:depends-on (#:parse-number)