r251 - in packages: . libconfig-tiny-perl libconfig-tiny-perl/branches libconfig-tiny-perl/branches/upstream libconfig-tiny-perl/branches/upstream/current libconfig-tiny-perl/branches/upstream/current/lib libconfig-tiny-perl/branches/upstream/current/lib/Config libconfig-tiny-perl/branches/upstream/current/t
Allard Hoeve
hoeve-guest@haydn.debian.org
Thu, 17 Jun 2004 11:47:12 -0600
Author: hoeve-guest
Date: 2004-06-17 11:47:09 -0600 (Thu, 17 Jun 2004)
New Revision: 251
Added:
packages/libconfig-tiny-perl/
packages/libconfig-tiny-perl/branches/
packages/libconfig-tiny-perl/branches/upstream/
packages/libconfig-tiny-perl/branches/upstream/current/
packages/libconfig-tiny-perl/branches/upstream/current/Changes
packages/libconfig-tiny-perl/branches/upstream/current/LICENSE
packages/libconfig-tiny-perl/branches/upstream/current/MANIFEST
packages/libconfig-tiny-perl/branches/upstream/current/META.yml
packages/libconfig-tiny-perl/branches/upstream/current/Makefile.PL
packages/libconfig-tiny-perl/branches/upstream/current/README
packages/libconfig-tiny-perl/branches/upstream/current/lib/
packages/libconfig-tiny-perl/branches/upstream/current/lib/Config/
packages/libconfig-tiny-perl/branches/upstream/current/lib/Config/Tiny.pm
packages/libconfig-tiny-perl/branches/upstream/current/t/
packages/libconfig-tiny-perl/branches/upstream/current/t/01_main.t
packages/libconfig-tiny-perl/branches/upstream/current/test.conf
packages/libconfig-tiny-perl/tags/
Log:
[svn-inject] Installing original source of libconfig-tiny-perl
Added: packages/libconfig-tiny-perl/branches/upstream/current/Changes
===================================================================
--- packages/libconfig-tiny-perl/branches/upstream/current/Changes 2004-06-17 17:31:07 UTC (rev 250)
+++ packages/libconfig-tiny-perl/branches/upstream/current/Changes 2004-06-17 17:47:09 UTC (rev 251)
@@ -0,0 +1,43 @@
+Revision history for Perl extension Config::Tiny
+
+1.6 Mon Mar 1 2004
+ - Bug fix: Sections without keys didn't appear at all in the parsed struct
+
+1.5 Wed Jan 7 2004
+ - Updating documentation to provide a correct location to send bug reports
+
+1.4 Web Dec 24 2003
+ - Caught a warning when trying to parse an undefined string.
+ Returns undef in that case.
+ - Merry Christmas and a productive New Year to you all!
+
+1.3 Fri Nov 7 2003
+ - Slightly altered a regex so that trailing whitespace in properties
+ is dropped.
+
+1.2 Wed Aug 12 15:51:12 2003
+ - Applied a variety of small changed designed to reduce the number of
+ opcodes generated, without changing the functionality.
+ This should save a few K in load overhead.
+
+1.1 Wed Apr 23 22:56:21 2003
+ - When reporting a bad line, put single quotes around the
+ lines contents in the error message.
+ - Small updates to the pod documentation
+
+1.0 Sat Dec 21 11:53:51 2002
+ - Removed file locking, since we read/write virtually atomically now
+ - Removed mode support from ->write() it was erroneous
+ - Removed dependency on Fcntl
+ - Added the read_string() method
+ - Other minor tweaks to shrink the code
+
+0.3 Mon Dec 09 00:44:21 2002
+ - Upgraded tests to Test::More, to deep test the structs
+ - Added Fcntl to the required modules
+
+0.2 Tue Nov 26 21:51:34 2002
+ - Don't import Fcntl symbols
+
+0.1 Wed Nov 13 16:50:23 2002
+ - original version
Added: packages/libconfig-tiny-perl/branches/upstream/current/LICENSE
===================================================================
--- packages/libconfig-tiny-perl/branches/upstream/current/LICENSE 2004-06-17 17:31:07 UTC (rev 250)
+++ packages/libconfig-tiny-perl/branches/upstream/current/LICENSE 2004-06-17 17:47:09 UTC (rev 251)
@@ -0,0 +1,377 @@
+Terms of Perl itself
+
+a) the GNU General Public License as published by the Free
+ Software Foundation; either version 1, or (at your option) any
+ later version, or
+b) the "Artistic License"
+
+----------------------------------------------------------------------------
+
+The General Public License (GPL)
+Version 2, June 1991
+
+Copyright (C) 1989, 1991 Free Software Foundation, Inc. 675 Mass Ave,
+Cambridge, MA 02139, USA. Everyone is permitted to copy and distribute
+verbatim copies of this license document, but changing it is not allowed.
+
+Preamble
+
+The licenses for most software are designed to take away your freedom to share
+and change it. By contrast, the GNU General Public License is intended to
+guarantee your freedom to share and change free software--to make sure the
+software is free for all its users. This General Public License applies to most of
+the Free Software Foundation's software and to any other program whose
+authors commit to using it. (Some other Free Software Foundation software is
+covered by the GNU Library General Public License instead.) You can apply it to
+your programs, too.
+
+When we speak of free software, we are referring to freedom, not price. Our
+General Public Licenses are designed to make sure that you have the freedom
+to distribute copies of free software (and charge for this service if you wish), that
+you receive source code or can get it if you want it, that you can change the
+software or use pieces of it in new free programs; and that you know you can do
+these things.
+
+To protect your rights, we need to make restrictions that forbid anyone to deny
+you these rights or to ask you to surrender the rights. These restrictions
+translate to certain responsibilities for you if you distribute copies of the
+software, or if you modify it.
+
+For example, if you distribute copies of such a program, whether gratis or for a
+fee, you must give the recipients all the rights that you have. You must make
+sure that they, too, receive or can get the source code. And you must show
+them these terms so they know their rights.
+
+We protect your rights with two steps: (1) copyright the software, and (2) offer
+you this license which gives you legal permission to copy, distribute and/or
+modify the software.
+
+Also, for each author's protection and ours, we want to make certain that
+everyone understands that there is no warranty for this free software. If the
+software is modified by someone else and passed on, we want its recipients to
+know that what they have is not the original, so that any problems introduced by
+others will not reflect on the original authors' reputations.
+
+Finally, any free program is threatened constantly by software patents. We wish
+to avoid the danger that redistributors of a free program will individually obtain
+patent licenses, in effect making the program proprietary. To prevent this, we
+have made it clear that any patent must be licensed for everyone's free use or
+not licensed at all.
+
+The precise terms and conditions for copying, distribution and modification
+follow.
+
+GNU GENERAL PUBLIC LICENSE
+TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND
+MODIFICATION
+
+0. This License applies to any program or other work which contains a notice
+placed by the copyright holder saying it may be distributed under the terms of
+this General Public License. The "Program", below, refers to any such program
+or work, and a "work based on the Program" means either the Program or any
+derivative work under copyright law: that is to say, a work containing the
+Program or a portion of it, either verbatim or with modifications and/or translated
+into another language. (Hereinafter, translation is included without limitation in
+the term "modification".) Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not covered by
+this License; they are outside its scope. The act of running the Program is not
+restricted, and the output from the Program is covered only if its contents
+constitute a work based on the Program (independent of having been made by
+running the Program). Whether that is true depends on what the Program does.
+
+1. You may copy and distribute verbatim copies of the Program's source code as
+you receive it, in any medium, provided that you conspicuously and appropriately
+publish on each copy an appropriate copyright notice and disclaimer of warranty;
+keep intact all the notices that refer to this License and to the absence of any
+warranty; and give any other recipients of the Program a copy of this License
+along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and you may at
+your option offer warranty protection in exchange for a fee.
+
+2. You may modify your copy or copies of the Program or any portion of it, thus
+forming a work based on the Program, and copy and distribute such
+modifications or work under the terms of Section 1 above, provided that you also
+meet all of these conditions:
+
+a) You must cause the modified files to carry prominent notices stating that you
+changed the files and the date of any change.
+
+b) You must cause any work that you distribute or publish, that in whole or in
+part contains or is derived from the Program or any part thereof, to be licensed
+as a whole at no charge to all third parties under the terms of this License.
+
+c) If the modified program normally reads commands interactively when run, you
+must cause it, when started running for such interactive use in the most ordinary
+way, to print or display an announcement including an appropriate copyright
+notice and a notice that there is no warranty (or else, saying that you provide a
+warranty) and that users may redistribute the program under these conditions,
+and telling the user how to view a copy of this License. (Exception: if the
+Program itself is interactive but does not normally print such an announcement,
+your work based on the Program is not required to print an announcement.)
+
+These requirements apply to the modified work as a whole. If identifiable
+sections of that work are not derived from the Program, and can be reasonably
+considered independent and separate works in themselves, then this License,
+and its terms, do not apply to those sections when you distribute them as
+separate works. But when you distribute the same sections as part of a whole
+which is a work based on the Program, the distribution of the whole must be on
+the terms of this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest your rights to
+work written entirely by you; rather, the intent is to exercise the right to control
+the distribution of derivative or collective works based on the Program.
+
+In addition, mere aggregation of another work not based on the Program with the
+Program (or with a work based on the Program) on a volume of a storage or
+distribution medium does not bring the other work under the scope of this
+License.
+
+3. You may copy and distribute the Program (or a work based on it, under
+Section 2) in object code or executable form under the terms of Sections 1 and 2
+above provided that you also do one of the following:
+
+a) Accompany it with the complete corresponding machine-readable source
+code, which must be distributed under the terms of Sections 1 and 2 above on a
+medium customarily used for software interchange; or,
+
+b) Accompany it with a written offer, valid for at least three years, to give any
+third party, for a charge no more than your cost of physically performing source
+distribution, a complete machine-readable copy of the corresponding source
+code, to be distributed under the terms of Sections 1 and 2 above on a medium
+customarily used for software interchange; or,
+
+c) Accompany it with the information you received as to the offer to distribute
+corresponding source code. (This alternative is allowed only for noncommercial
+distribution and only if you received the program in object code or executable
+form with such an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for making
+modifications to it. For an executable work, complete source code means all the
+source code for all modules it contains, plus any associated interface definition
+files, plus the scripts used to control compilation and installation of the
+executable. However, as a special exception, the source code distributed need
+not include anything that is normally distributed (in either source or binary form)
+with the major components (compiler, kernel, and so on) of the operating system
+on which the executable runs, unless that component itself accompanies the
+executable.
+
+If distribution of executable or object code is made by offering access to copy
+from a designated place, then offering equivalent access to copy the source
+code from the same place counts as distribution of the source code, even though
+third parties are not compelled to copy the source along with the object code.
+
+4. You may not copy, modify, sublicense, or distribute the Program except as
+expressly provided under this License. Any attempt otherwise to copy, modify,
+sublicense or distribute the Program is void, and will automatically terminate
+your rights under this License. However, parties who have received copies, or
+rights, from you under this License will not have their licenses terminated so long
+as such parties remain in full compliance.
+
+5. You are not required to accept this License, since you have not signed it.
+However, nothing else grants you permission to modify or distribute the Program
+or its derivative works. These actions are prohibited by law if you do not accept
+this License. Therefore, by modifying or distributing the Program (or any work
+based on the Program), you indicate your acceptance of this License to do so,
+and all its terms and conditions for copying, distributing or modifying the
+Program or works based on it.
+
+6. Each time you redistribute the Program (or any work based on the Program),
+the recipient automatically receives a license from the original licensor to copy,
+distribute or modify the Program subject to these terms and conditions. You
+may not impose any further restrictions on the recipients' exercise of the rights
+granted herein. You are not responsible for enforcing compliance by third parties
+to this License.
+
+7. If, as a consequence of a court judgment or allegation of patent infringement
+or for any other reason (not limited to patent issues), conditions are imposed on
+you (whether by court order, agreement or otherwise) that contradict the
+conditions of this License, they do not excuse you from the conditions of this
+License. If you cannot distribute so as to satisfy simultaneously your obligations
+under this License and any other pertinent obligations, then as a consequence
+you may not distribute the Program at all. For example, if a patent license would
+not permit royalty-free redistribution of the Program by all those who receive
+copies directly or indirectly through you, then the only way you could satisfy
+both it and this License would be to refrain entirely from distribution of the
+Program.
+
+If any portion of this section is held invalid or unenforceable under any particular
+circumstance, the balance of the section is intended to apply and the section as
+a whole is intended to apply in other circumstances.
+
+It is not the purpose of this section to induce you to infringe any patents or other
+property right claims or to contest validity of any such claims; this section has
+the sole purpose of protecting the integrity of the free software distribution
+system, which is implemented by public license practices. Many people have
+made generous contributions to the wide range of software distributed through
+that system in reliance on consistent application of that system; it is up to the
+author/donor to decide if he or she is willing to distribute software through any
+other system and a licensee cannot impose that choice.
+
+This section is intended to make thoroughly clear what is believed to be a
+consequence of the rest of this License.
+
+8. If the distribution and/or use of the Program is restricted in certain countries
+either by patents or by copyrighted interfaces, the original copyright holder who
+places the Program under this License may add an explicit geographical
+distribution limitation excluding those countries, so that distribution is permitted
+only in or among countries not thus excluded. In such case, this License
+incorporates the limitation as if written in the body of this License.
+
+9. The Free Software Foundation may publish revised and/or new versions of the
+General Public License from time to time. Such new versions will be similar in
+spirit to the present version, but may differ in detail to address new problems or
+concerns.
+
+Each version is given a distinguishing version number. If the Program specifies a
+version number of this License which applies to it and "any later version", you
+have the option of following the terms and conditions either of that version or of
+any later version published by the Free Software Foundation. If the Program does
+not specify a version number of this License, you may choose any version ever
+published by the Free Software Foundation.
+
+10. If you wish to incorporate parts of the Program into other free programs
+whose distribution conditions are different, write to the author to ask for
+permission. For software which is copyrighted by the Free Software Foundation,
+write to the Free Software Foundation; we sometimes make exceptions for this.
+Our decision will be guided by the two goals of preserving the free status of all
+derivatives of our free software and of promoting the sharing and reuse of
+software generally.
+
+NO WARRANTY
+
+11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS
+NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE
+COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM
+"AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
+IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE
+ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
+PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE,
+YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR
+CORRECTION.
+
+12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED
+TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY
+WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS
+PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES
+ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM
+(INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
+RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY
+OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS
+BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+END OF TERMS AND CONDITIONS
+
+
+----------------------------------------------------------------------------
+
+The Artistic License
+
+Preamble
+
+The intent of this document is to state the conditions under which a Package
+may be copied, such that the Copyright Holder maintains some semblance of
+artistic control over the development of the package, while giving the users of the
+package the right to use and distribute the Package in a more-or-less customary
+fashion, plus the right to make reasonable modifications.
+
+Definitions:
+
+- "Package" refers to the collection of files distributed by the Copyright
+ Holder, and derivatives of that collection of files created through textual
+ modification.
+- "Standard Version" refers to such a Package if it has not been modified,
+ or has been modified in accordance with the wishes of the Copyright
+ Holder.
+- "Copyright Holder" is whoever is named in the copyright or copyrights for
+ the package.
+- "You" is you, if you're thinking about copying or distributing this Package.
+- "Reasonable copying fee" is whatever you can justify on the basis of
+ media cost, duplication charges, time of people involved, and so on. (You
+ will not be required to justify it to the Copyright Holder, but only to the
+ computing community at large as a market that must bear the fee.)
+- "Freely Available" means that no fee is charged for the item itself, though
+ there may be fees involved in handling the item. It also means that
+ recipients of the item may redistribute it under the same conditions they
+ received it.
+
+1. You may make and give away verbatim copies of the source form of the
+Standard Version of this Package without restriction, provided that you duplicate
+all of the original copyright notices and associated disclaimers.
+
+2. You may apply bug fixes, portability fixes and other modifications derived from
+the Public Domain or from the Copyright Holder. A Package modified in such a
+way shall still be considered the Standard Version.
+
+3. You may otherwise modify your copy of this Package in any way, provided
+that you insert a prominent notice in each changed file stating how and when
+you changed that file, and provided that you do at least ONE of the following:
+
+ a) place your modifications in the Public Domain or otherwise
+ make them Freely Available, such as by posting said modifications
+ to Usenet or an equivalent medium, or placing the modifications on
+ a major archive site such as ftp.uu.net, or by allowing the
+ Copyright Holder to include your modifications in the Standard
+ Version of the Package.
+
+ b) use the modified Package only within your corporation or
+ organization.
+
+ c) rename any non-standard executables so the names do not
+ conflict with standard executables, which must also be provided,
+ and provide a separate manual page for each non-standard
+ executable that clearly documents how it differs from the Standard
+ Version.
+
+ d) make other distribution arrangements with the Copyright Holder.
+
+4. You may distribute the programs of this Package in object code or executable
+form, provided that you do at least ONE of the following:
+
+ a) distribute a Standard Version of the executables and library
+ files, together with instructions (in the manual page or equivalent)
+ on where to get the Standard Version.
+
+ b) accompany the distribution with the machine-readable source of
+ the Package with your modifications.
+
+ c) accompany any non-standard executables with their
+ corresponding Standard Version executables, giving the
+ non-standard executables non-standard names, and clearly
+ documenting the differences in manual pages (or equivalent),
+ together with instructions on where to get the Standard Version.
+
+ d) make other distribution arrangements with the Copyright Holder.
+
+5. You may charge a reasonable copying fee for any distribution of this Package.
+You may charge any fee you choose for support of this Package. You may not
+charge a fee for this Package itself. However, you may distribute this Package in
+aggregate with other (possibly commercial) programs as part of a larger
+(possibly commercial) software distribution provided that you do not advertise
+this Package as a product of your own.
+
+6. The scripts and library files supplied as input to or produced as output from
+the programs of this Package do not automatically fall under the copyright of this
+Package, but belong to whomever generated them, and may be sold
+commercially, and may be aggregated with this Package.
+
+7. C or perl subroutines supplied by you and linked into this Package shall not
+be considered part of this Package.
+
+8. The name of the Copyright Holder may not be used to endorse or promote
+products derived from this software without specific prior written permission.
+
+9. THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.
+
+The End
+
+
Added: packages/libconfig-tiny-perl/branches/upstream/current/MANIFEST
===================================================================
--- packages/libconfig-tiny-perl/branches/upstream/current/MANIFEST 2004-06-17 17:31:07 UTC (rev 250)
+++ packages/libconfig-tiny-perl/branches/upstream/current/MANIFEST 2004-06-17 17:47:09 UTC (rev 251)
@@ -0,0 +1,9 @@
+Changes
+lib/Config/Tiny.pm
+LICENSE
+Makefile.PL
+MANIFEST This list of files
+README
+t/01_main.t
+test.conf
+META.yml Module meta-data (added by MakeMaker)
Added: packages/libconfig-tiny-perl/branches/upstream/current/META.yml
===================================================================
--- packages/libconfig-tiny-perl/branches/upstream/current/META.yml 2004-06-17 17:31:07 UTC (rev 250)
+++ packages/libconfig-tiny-perl/branches/upstream/current/META.yml 2004-06-17 17:47:09 UTC (rev 251)
@@ -0,0 +1,12 @@
+# http://module-build.sourceforge.net/META-spec.html
+#XXXXXXX This is a prototype!!! It will change in the future!!! XXXXX#
+name: Config-Tiny
+version: 1.6
+version_from: lib/Config/Tiny.pm
+installdirs: site
+requires:
+ FindBin: 0
+ Test::More: 0
+
+distribution_type: module
+generated_by: ExtUtils::MakeMaker version 6.16
Added: packages/libconfig-tiny-perl/branches/upstream/current/Makefile.PL
===================================================================
--- packages/libconfig-tiny-perl/branches/upstream/current/Makefile.PL 2004-06-17 17:31:07 UTC (rev 250)
+++ packages/libconfig-tiny-perl/branches/upstream/current/Makefile.PL 2004-06-17 17:47:09 UTC (rev 251)
@@ -0,0 +1,15 @@
+require 5.000;
+use ExtUtils::MakeMaker;
+WriteMakefile(
+ 'NAME' => 'Config::Tiny',
+ 'VERSION_FROM' => 'lib/Config/Tiny.pm',
+ 'PREREQ_PM' => {
+ Test::More => 0,
+ FindBin => 0,
+
+ },
+ ($] >= 5.005) ? (
+ 'AUTHOR' => 'Adam Kennedy (cpan@ali.as)',
+ 'ABSTRACT' => 'Read/Write .ini style files with as little code as possible',
+ ) : (),
+);
Added: packages/libconfig-tiny-perl/branches/upstream/current/README
===================================================================
--- packages/libconfig-tiny-perl/branches/upstream/current/README 2004-06-17 17:31:07 UTC (rev 250)
+++ packages/libconfig-tiny-perl/branches/upstream/current/README 2004-06-17 17:47:09 UTC (rev 251)
@@ -0,0 +1,123 @@
+NAME
+ Config::Tiny - Read/Write .ini style files with as little code as
+ possible
+
+SYNOPSIS
+ # In your configuration file
+ rootproperty=blah
+
+ [section]
+ one=twp
+ three= four
+ Foo =Bar
+ empty=
+
+ # In your program
+ use Config::Tiny;
+
+ # Create a config
+ my $Config = Config::Tiny->new();
+
+ # Open the config
+ $Config = Config::Tiny->read( 'file.conf' );
+
+ # Reading properties
+ my $rootproperty = $Config->{_}->{rootproperty};
+ my $one = $Config->{section}->{one};
+ my $Foo = $Config->{section}->{Foo};
+
+ # Changing data
+ $Config->{newsection} = { this => 'that' }; # Add a section
+ $Config->{section}->{Foo} = 'Not Bar!'; # Change a value
+ delete $Config->{_}; # Delete a value or section
+
+ # Save a config
+ $Config->write( 'file.conf' );
+
+DESCRIPTION
+ Config::Tiny is a perl class to read and write .ini style configuration
+ files with as little code as possible, reducing load time and memory
+ overhead. Memory usage is normally scoffed at in Perl, but in my opinion
+ should be at least kept in mind.
+
+ This module is primarily for reading human written files, and anything
+ we write shouldn't need to have documentation/comments. If you need
+ something with more power, move up to Config::Simple, Config::General or
+ one of the many other Config:: modules. To rephrase, Config::Tiny does
+ not preserve your comments, whitespace, or the order of your config
+ file.
+
+CONFIGURATION FILE SYNTAX
+ Files are the same as windows .ini files, for example.
+
+ [section]
+ var1=value1
+ var2=value2
+
+ If a property is outside of a section, it will be assigned to the root
+ section, available at "$Config->{_}".
+
+ Lines starting with '#' or ';' are comments, and blank lines are
+ ignored.
+
+ When writing back to the config file, any comments are discarded.
+
+METHODS
+ new
+ The constructor "new" creates and returns an empty Config::Tiny object.
+
+ read $filename
+ The "read" constructor reads a config file, and returns a new
+ Config::Tiny object containing the properties in the file.
+
+ Returns the object on success, or "undef" on error.
+
+ read_string $string;
+ The "read_string()" takes as argument the contents of a config file as a
+ string and returns the Config::Tiny object for it.
+
+ write
+ The "write $filename" generates the file for the properties, and writes
+ it to disk.
+
+ Returns true on success or "undef" on error.
+
+ write_string
+ Generates the file for the object and returns it as a string.
+
+ errstr
+ When an error occurs, you can retrieve the error message either from the
+ $Config::Tiny::errstr variable, or using the "errstr()" method.
+
+SUPPORT
+ Bugs should be reported via the CPAN bug tracker at
+
+ http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Config%3A%3ATiny
+
+ For other issues, contact the author
+
+TO DO
+ I'm debating adding a get and set method to get or set a section.key
+ based value...
+
+ Implementation is left as an exercise for the reader.
+
+AUTHOR
+ Adam Kennedy ( maintainer )
+ cpan@ali.as
+ http://ali.as/
+
+ Thanks to Sherzod Ruzmetov <sherzodr@cpan.org> for Config::Simple, which
+ inspired this module.
+
+SEE ALSO
+ Config::Simple, Config::General
+
+COPYRIGHT
+ Copyright 2002-2004 Adam Kennedy. All rights reserved. This program is
+ free software; you can redistribute it and/or modify it under the same
+ terms as Perl itself.
+
+ The full text of the license can be found in the LICENSE file included
+ with this module.
+
Added: packages/libconfig-tiny-perl/branches/upstream/current/lib/Config/Tiny.pm
===================================================================
--- packages/libconfig-tiny-perl/branches/upstream/current/lib/Config/Tiny.pm 2004-06-17 17:31:07 UTC (rev 250)
+++ packages/libconfig-tiny-perl/branches/upstream/current/lib/Config/Tiny.pm 2004-06-17 17:47:09 UTC (rev 251)
@@ -0,0 +1,251 @@
+package Config::Tiny;
+
+# If you thought Config::Simple was small...
+
+require 5.005;
+use strict;
+
+use vars qw{$VERSION $errstr};
+BEGIN {
+ $VERSION = 1.6;
+ $errstr = '';
+}
+
+# Create an empty object
+sub new { bless {}, shift }
+
+# Create an object from a file
+sub read {
+ my $class = shift;
+
+ # Check the file
+ my $file = shift or return $class->_error( 'You did not specify a file name' );
+ return $class->_error( "File '$file' does not exist" ) unless -e $file;
+ return $class->_error( "'$file' is a directory, not a file" ) unless -f $file;
+ return $class->_error( "Insufficient permissions to read '$file'" ) unless -r $file;
+
+ # Slurp in the file
+ local $/ = undef;
+ open( CFG, $file ) or return $class->_error( "Failed to open file '$file': $!" );
+ my $contents = <CFG>;
+ close( CFG );
+
+ $class->read_string( $contents );
+}
+
+# Create an object from a string
+sub read_string {
+ return undef unless defined $_[1];
+ my $self = bless {}, shift;
+
+ # Parse the file
+ my $ns = '_';
+ my $counter = 0;
+ foreach ( split /(?:\015\012|\015|\012)/, shift ) {
+ $counter++;
+
+ # Skip comments and empty lines
+ next if /^\s*(?:\#|\;)/ || /^\s*$/;
+
+ # Handle section headers
+ if ( /^\s*\[(.+?)\]\s*/ ) {
+ $ns = $1;
+
+ # Create the sub-hash if it doesn't exist.
+ # Without this sections without keys will not
+ # appear at all in the completed struct.
+ $self->{$ns} ||= {};
+
+ next;
+ }
+
+ # Handle properties
+ if ( /^\s*([^=]+?)\s*=\s*(.*?)\s*$/ ) {
+ $self->{$ns}->{$1} = $2;
+ next;
+ }
+
+ return $self->_error( "Syntax error at line $counter: '$_'" );
+ }
+
+ $self;
+}
+
+# Save an object to a file
+sub write {
+ my $self = shift;
+ my $file = shift or return $self->_error( 'No file name provided' );
+
+ # Write it to the file
+ open( CFG, ">$file" )
+ or return $self->_error( "Failed to open file '$file' for writing: $!" );
+ print CFG $self->write_string;
+ close( CFG );
+
+ 1;
+}
+
+# Save an object to a string
+sub write_string {
+ my $self = shift;
+
+ my $contents = '';
+ foreach my $section ( sort { (($b eq '_') <=> ($a eq '_')) || ($a cmp $b) } keys %$self ) {
+ my $block = $self->{$section};
+ $contents .= "\n" if length $contents;
+ $contents .= "[$section]\n" unless $section eq '_';
+ foreach my $property ( sort keys %$block ) {
+ $contents .= "$property=$block->{$property}\n";
+ }
+ }
+
+ $contents;
+}
+
+# Error handling
+sub errstr { $errstr }
+sub _error { $errstr = $_[1]; undef }
+
+1;
+
+__END__
+
+=pod
+
+=head1 NAME
+
+Config::Tiny - Read/Write .ini style files with as little code as possible
+
+=head1 SYNOPSIS
+
+ # In your configuration file
+ rootproperty=blah
+
+ [section]
+ one=twp
+ three= four
+ Foo =Bar
+ empty=
+
+ # In your program
+ use Config::Tiny;
+
+ # Create a config
+ my $Config = Config::Tiny->new();
+
+ # Open the config
+ $Config = Config::Tiny->read( 'file.conf' );
+
+ # Reading properties
+ my $rootproperty = $Config->{_}->{rootproperty};
+ my $one = $Config->{section}->{one};
+ my $Foo = $Config->{section}->{Foo};
+
+ # Changing data
+ $Config->{newsection} = { this => 'that' }; # Add a section
+ $Config->{section}->{Foo} = 'Not Bar!'; # Change a value
+ delete $Config->{_}; # Delete a value or section
+
+ # Save a config
+ $Config->write( 'file.conf' );
+
+=head1 DESCRIPTION
+
+Config::Tiny is a perl class to read and write .ini style configuration files
+with as little code as possible, reducing load time and memory overhead.
+Memory usage is normally scoffed at in Perl, but in my opinion should be
+at least kept in mind.
+
+This module is primarily for reading human written files, and anything we
+write shouldn't need to have documentation/comments. If you need something
+with more power, move up to Config::Simple, Config::General or one of the
+many other Config:: modules. To rephrase, Config::Tiny does not preserve
+your comments, whitespace, or the order of your config file.
+
+=head1 CONFIGURATION FILE SYNTAX
+
+Files are the same as windows .ini files, for example.
+
+ [section]
+ var1=value1
+ var2=value2
+
+If a property is outside of a section, it will be assigned to the root
+section, available at C<$Config-E<gt>{_}>.
+
+Lines starting with '#' or ';' are comments, and blank lines are ignored.
+
+When writing back to the config file, any comments are discarded.
+
+=head1 METHODS
+
+=head2 new
+
+The constructor C<new> creates and returns an empty Config::Tiny object.
+
+=head2 read $filename
+
+The C<read> constructor reads a config file, and returns a new Config::Tiny
+object containing the properties in the file.
+
+Returns the object on success, or C<undef> on error.
+
+=head2 read_string $string;
+
+The C<read_string()> takes as argument the contents of a config file as a string
+and returns the Config::Tiny object for it.
+
+=head2 write
+
+The C<write $filename> generates the file for the properties, and writes it
+to disk.
+
+Returns true on success or C<undef> on error.
+
+=head2 write_string
+
+Generates the file for the object and returns it as a string.
+
+=head2 errstr
+
+When an error occurs, you can retrieve the error message either from the
+C<$Config::Tiny::errstr> variable, or using the C<errstr()> method.
+
+=head1 SUPPORT
+
+Bugs should be reported via the CPAN bug tracker at
+
+ http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Config%3A%3ATiny
+
+For other issues, contact the author
+
+=head1 TO DO
+
+I'm debating adding a get and set method to get or set a section.key based
+value...
+
+Implementation is left as an exercise for the reader.
+
+=head1 AUTHOR
+
+ Adam Kennedy ( maintainer )
+ cpan@ali.as
+ http://ali.as/
+
+Thanks to Sherzod Ruzmetov <sherzodr@cpan.org> for Config::Simple,
+which inspired this module.
+
+=head1 SEE ALSO
+
+L<Config::Simple>, L<Config::General>
+
+=head1 COPYRIGHT
+
+Copyright 2002-2004 Adam Kennedy. All rights reserved.
+This program is free software; you can redistribute
+it and/or modify it under the same terms as Perl itself.
+
+The full text of the license can be found in the
+LICENSE file included with this module.
+
+=cut
Added: packages/libconfig-tiny-perl/branches/upstream/current/t/01_main.t
===================================================================
--- packages/libconfig-tiny-perl/branches/upstream/current/t/01_main.t 2004-06-17 17:31:07 UTC (rev 250)
+++ packages/libconfig-tiny-perl/branches/upstream/current/t/01_main.t 2004-06-17 17:47:09 UTC (rev 251)
@@ -0,0 +1,127 @@
+#!/usr/bin/perl
+
+# Formal testing for Config::Tiny
+
+use strict;
+use lib '../../modules'; # For development testing
+use lib '../lib'; # For installation testing
+use UNIVERSAL 'isa';
+use Test::More tests => 23;
+
+# Set up any needed globals
+use vars qw{$loaded};
+BEGIN {
+ $loaded = 0;
+ $| = 1;
+}
+
+
+
+
+# Check their perl version
+BEGIN {
+ ok( $] >= 5.005, "Your perl is new enough" );
+}
+
+
+
+
+
+# Does the module load
+END { ok( 0, 'Config::Tiny loads' ) unless $loaded; }
+use Config::Tiny;
+$loaded = 1;
+ok( 1, 'Config::Tiny loads' );
+
+
+
+
+# Test trivial creation
+my $Trivial = Config::Tiny->new();
+ok( $Trivial, '->new returns true' );
+ok( ref $Trivial, '->new returns a reference' );
+ok( isa( $Trivial, 'HASH' ), '->new returns a hash reference' );
+ok( isa( $Trivial, 'Config::Tiny' ), '->new returns a Config::Tiny object' );
+ok( scalar keys %$Trivial == 0, '->new returns an empty object' );
+
+# Try to read in a config
+my $Config = Config::Tiny->read( './test.conf' );
+ok( $Config, '->read returns true' );
+ok( ref $Config, '->read returns a reference' );
+ok( isa( $Config, 'HASH' ), '->read returns a hash reference' );
+ok( isa( $Config, 'Config::Tiny' ), '->read returns a Config::Tiny object' );
+
+# Check the structure of the config
+my $expected = {
+ '_' => {
+ root => 'something',
+ },
+ section => {
+ one => 'two',
+ Foo => 'Bar',
+ this => 'Your Mother!',
+ blank => '',
+ },
+ 'Section Two' => {
+ 'something else' => 'blah',
+ 'remove' => 'whitespace',
+ },
+ };
+bless $expected, 'Config::Tiny';
+is_deeply( $Config, $expected, 'Config structure matches expected' );
+
+# Add some stuff to the trivial config and check write_string() for it
+$Trivial->{_} = { root1 => 'root2' };
+$Trivial->{section} = {
+ foo => 'bar',
+ this => 'that',
+ blank => '',
+ };
+$Trivial->{section2} = {
+ 'this little piggy' => 'went to market'
+ };
+my $string = <<END;
+root1=root2
+
+[section]
+blank=
+foo=bar
+this=that
+
+[section2]
+this little piggy=went to market
+END
+
+# Test read_string
+my $Read = Config::Tiny->read_string( $string );
+ok( $Read, '->read_string returns true' );
+is_deeply( $Read, $Trivial, '->read_string returns expected value' );
+
+my $generated = $Trivial->write_string();
+ok( length $generated, '->write_string returns something' );
+ok( $generated eq $string, '->write_string returns the correct file contents' );
+
+# Try to write a file
+my $rv = $Trivial->write( './test2.conf' );
+ok( $rv, '->write returned true' );
+ok( -e 'test2.conf', '->write actually created a file' );
+
+# Try to read the config back in
+$Read = Config::Tiny->read( './test2.conf' );
+ok( $Read, '->read of what we wrote returns true' );
+ok( ref $Read, '->read of what we wrote returns a reference' );
+ok( isa( $Read, 'HASH' ), '->read of what we wrote returns a hash reference' );
+ok( isa( $Read, 'Config::Tiny' ), '->read of what we wrote returns a Config::Tiny object' );
+
+# Check the structure of what we read back in
+is_deeply( $Read, $Trivial, 'What we read matches what we wrote out' );
+
+
+
+
+
+END {
+ # Clean up
+ unlink './test2.conf';
+}
+1;
Added: packages/libconfig-tiny-perl/branches/upstream/current/test.conf
===================================================================
--- packages/libconfig-tiny-perl/branches/upstream/current/test.conf 2004-06-17 17:31:07 UTC (rev 250)
+++ packages/libconfig-tiny-perl/branches/upstream/current/test.conf 2004-06-17 17:47:09 UTC (rev 251)
@@ -0,0 +1,11 @@
+root=something
+
+[section]
+one=two
+Foo=Bar
+this=Your Mother!
+blank=
+
+[Section Two]
+something else=blah
+ remove = whitespace
\ No newline at end of file