Release Name: 2.0.0
Notes:
This+package+makes+sourcing+information+from+configuration+files+robust%0Aand+easy!++It%3A%0A*+Allows+programmers+to+specify+the+type+of+data+that+should+be+loaded%0A++from+a+configuration+file.++The+toolkit+automatically+will+validate%0A++the+file's+data+against+this+specification+when+loading+the+file%2C+ensuring%0A++that+the+specification+always+is+obeyed+and+saving+the+programmer+the%0A++tedious+chore+of+writing+validation+code.%0A*+Automagically+generates+parameter+accessor+methods+(getters%2C+setters%2C+and%0A++predicates+to+test+for+presence)%2C+an+equality+operator%2C+and+a+%2Bto_s%2B+method%0A++from+the+configuration's+specification.%0A*+Allows+programmers+to+create+configuration+files%2C%0A++easily+and+programatically.%0A*+Provides+a+class+that+can+load+Ruby+configuration+files+(allowing+the%0A++full+power+of+Ruby+to+be+used+within+configuration+files).%0A*+Provides+classes+that+can+load+from+and+dump+to+YAML+and+key-value%0A++configuration+files.%0A*+Provides+classes+that+can+load+from+and+dump+to+Hashes.%0A*+Is+very+extensible%2C+allowing+the+engine+to+be+used+with+custom+format%0A++configuration+files+and+with+custom+data+validation+rules.
Changes:
%3D%3D%3D+2.0.0+%2F+2008-07-03%0AThis+version+of+the+ConfigToolkit+has+a+ton+of+enhancements.++I+really+would%0Awelcome+input+from+the+community+about+it!%0A*+IMPORTANT+INTERFACE+CHANGE%3A+ConfigToolkit%3A%3ABaseConfig%23load_group+now%0A++returns+a+Hash+mapping+Symbols+to+config+instances%2C+not%0A++a+Hash+mapping+Strings+to+config+instances.%0A*+IMPORTANT+INTERFACE+CHANGE%3A+The+Hash+passed+to+ConfigToolkit%3A%3AWriter%23write%0A++uses+Symbols+instead+of+Strings+for+parameter+names%2C+unless%0A++the+writer+returns+%2Bfalse%2B+from%0A++ConfigToolkit%3A%3AWriter%23require_symbol_parameter_names%3F.%0A*+IMPORTANT+INTERFACE+CHANGE%3A+ConfigToolkit%3A%3AWriter%23write+must%0A++accept+two+arguments%2C+the+configuration+hash+and+the+containing%0A++object+name.%0A*+Add+support+for+Ruby+configuration+files+through+the%0A++ConfigToolkit%3A%3ARubyReader+class+(allowing+the+full+power+of+Ruby+to+be%0A++used+within+configuration+files%3B+the+format+is+very+similar+to+that+used+by%0A++some+of+the+Rails+configuration+files).++See+Ruby.txt+for+more+details.%0A*+Add+support+for+key-value+configuration+files+through+the%0A++ConfigToolkit%3A%3AKeyValueReader+and+the+ConfigToolkit%3A%3AKeyValueWriter.%0A++See+KeyValue.txt+for+more+details.%0A*+Add+support+for+loading+and+dumping+configurations+directly+to+and+from%0A++Hashes+through+the+ConfigToolkit%3A%3AHashReader+and+ConfigToolkit%3A%3AHashWriter%0A++(allowing+configurations+to+be+loaded+programatically).%0A++See+Hash.txt+for+more+details.%0A*+Provide+a+way+for+%2Brdoc%2B+to+detect+and+generate+documentation+for+each%0A++parameter+in+a+configuration+class%2C+just+as+it+does+for+attributes+(see%0A++FAQ.txt+for+how+to+enable+this).%0A*+Allow+a+block+to+be+passed+to+ConfigToolkit%3A%3ABaseConfig.new+for%0A++initialization+of+the+configuration+parameters.%0A*+Allow+optional+parameters+to+not+have+default+values%2C+meaning+that%0A++optional+parameters+sometimes+can+be+absent.++A+method+to+delete%0A++the+value+of+an+optional+parameter+now+is+generated+for+each+optional%0A++parameter+(%2Bclear_param_name%2B).%0A*+A+predicate+method+now+is+generated+for+each+parameter+that+returns%0A++whether+or+not+a+value+for+the+parameter+is+present+(%2Bparam_name%3F%2B).%0A*+Greatly+improve+the+documentation.++The+YAML+configuration+file+format%0A++is+described+by+YAML.txt%3B+the+key-value+configuration+file+format+is%0A++described+by+KeyValue.txt%3B+the+Ruby+configuration+file+format+is+described%0A++by+Ruby.txt%3B+programatically+loading+configurations+from+and+dumping%0A++configurations+to+Hashes+is+described+in+Hash.txt.%0A*+Many+example+programs+exist+in+the+%2Bexamples%2B+subdirectory+(and+are%0A++integrated+into+the+documentation).
|