dbi-dbrc 1.1.8-x86-mingw32 → 1.1.9-x86-mingw32

data/CHANGES

@@ -1,141 +1,145 @@
-== 1.1.8 - 7-Oct-2010
-* Fixed a logic bug in the constructor that primarily affected MS Windows with
-  regards to determining the user's home directory.
-
-== 1.1.7 - 6-Oct-2010
-* More robust file decryption/encryption for MS Windows.
-* Better platform checking for MS Windows.
-* Refactored the Rakefile. Removed the old installation tasks and replaced
-  them with a series of gem tasks.
-* Updated the win32 library dependencies.
-
-== 1.1.6 - 10-Sep-2009
-* Fixed validation for dbrc_dir argument.
-* Added a test for bogus dbrc_dir arguments.
-
-== 1.1.5 - 3-Sep-2009
-* License changed to Artistic 2.0.
-* Some gemspec updates, including the license and description.
-* Renamed the test files. The ts_all.rb file was removed.
-* Added win32-process as a dependency on MS Windows.
-* Added test-unit as a development dependency. Some tests were refactored
-  to use features from test-unit 2.x.
-* Added the 'test_xml' and 'test_yml' rake tasks.
-* Refactored the main test task.
-* Added explicit copyright and warranty to the README file.
-
-== 1.1.4 - 10-Nov-2008
-* Added a custom inspect method which filters the password.
-
-== 1.1.3 - 21-Jul-2008
-* More RUBY_PLATFORM changes that I missed in the last release.
-* Added inline RDOC for the accessors and updated the documentation
-  for the constructor.
-* Added the DBI::DBRC#dbrc_dir and DBI::DBRC#dbrc_file methods.
-* More tests.
-
-== 1.1.2 - 18-Jul-2008
-* Changed platform checking from RUBY_PLATFORM to Config::CONFIG['host_os']
-  so that other implementations won't choke.
-* Updated the gemspec to add the sys-admin dependency.
-* Added a rubyforge_project to the gemspec.
-* Now has a separate gem for MS Windows.
-
-== 1.1.1 - 2-Aug-2007
-* DBRCError is now DBRC::Error.
-* Added a Rakefile with tasks for installation and testing.
-* Added the win32-dir library as a prerequisite for MS Windows.
-* Removed the install.rb file. That's now handled by the Rakefile.
-* Some refactoring in the constructor, including the elimination of
-  warnings that appeared when run with -w.
-* Some doc and test updates.
-
-== 1.1.0 - 19-Oct-2005
-* Bug fix for MS Windows (there's no Win32 namespace for win32/file).
-* Changed platform detection mechanism.
-
-== 1.0.1 - 7-Oct-2005
-* Improved the error message when an entry isn't found.
-
-== 1.0.0 - 15-Jun-2005
-* Ditches the use of 'etc'.  Now requires the 'sys-admin' package as its
-  replacement (for all platforms).
-* Moved project to RubyForge.
-* Minor updates to tests, README and gemspec.
-* Now hosted on RubyForge.
-
-== 0.5.1 - 17-Mar-2005
-* Removed the 'doc' directory completely, and moved the primary
-  documentation into the README file.
-* Removed the INSTALL file.  Moved the installation directions into the
-  README file.
-* Moved the examples into a toplevel 'examples' directory.
-* Made the README and CHANGES files rdoc friendly.
-* Added a gemspec.
-
-== 0.5.0 - 15-Oct-2004
-* Added a YAML subclass.  Use this if you want to store your information in
-  the .dbrc file in YAML format.
-* On Win32 systems, the .dbrc file must now be "hidden".  Also, it will
-  automatically decrypt/encrypt the file if it is encrypted.  This also
-  means that the win32-file package is also required on Win32 systems.
-* Massive refactoring of the XML subclass.  It should work better now.
-* Moved the YML and XML subclasses directly into the dbrc.rb file.
-* For the aliases, you can now write as well as read.
-* In lieu of the namespace fix for "timeout" in 1.8, I have renamed "time_out"
-  to simply "timeout".  For backwards compatability, I have created an alias,
-  so you may still use the old method name.  However, this means that you
-  should only use this package with 1.8.0 or later.
-* Removed the dbrc.html file.  You can generate this on your own if you wish
-  using rdtool.
-* Test suite changes.
-
-== 0.4.0 - 3-Sep-2004
-* Removed redundant error handling for cases when the database and/or login
-  are not found.
-* Added an XML subclass.  Use this if you want to store your information in
-  the .dbrc file in XML format.
-
-== 0.3.0 - 26-Oct-2003
-* Win32 support added.  Requires the win32-etc package.
-* rd doc separated from source.  Moved to 'doc' directory.
-* Documentation updates and corrections.
-* Minor test suite tweaks for Win32 systems.
-
-== 0.2.1 - 28-Aug-2003
-* Removed VERSION class method.  Just use the constant.
-* Bug fix with regards to split and Ruby 1.8.  Thanks Michael Garriss.
-* Changed 'changelog' to 'CHANGES'.
-* Added a vanilla test script (test.rb)
-* Minor code optimization (IO.foreach)
-* Test unit cleanup
-* Minor internal directory layout and doc changes
-
-== 0.2.0 - 13-Jan-2003
-* DBRC class now under the DBI module namespace
-* Changed "timeout" to "time_out" to avoid confusion with the timeout
-  module.
-* The 'time_out', 'max_reconn', and 'interval' methods now return Integers,
-  rather than Strings.
-* Only the database, user and password fields are required now within the
-  .dbrc file.  The driver, time_out and max_reconn entries can be left blank
-  without causing an error.  Note that the 'dsn' method will return 'nil'
-  if the driver isn't set.
-* Added a DBRCException class instead of just raising an error string.
-* Changed 'db' method to 'database' (but 'db' is an alias)
-* Changed 'max_reconn' method to 'maximum_reconnects' (but 'max_reconn'
-  is an alias')
-* Added 'passwd' alias for 'password' method 
-* Added a VERSION class method
-* Methods that should have been private are now private
-* Internal directory layout change
-* Tests added
-* Install script improved
-* Documentation additions, including plain text doc
-
-== 0.1.1 - 26-Jul-2002
-* Added 'dsn()' method
-* Minor documentation additions
-
-== 0.1.0 - 26-Jul-2002
-* Initial release
+== 1.1.9 - 10-Jan-2013
+* Fixed an unused variable warning.
+* Changed the way I check for MS Windows.
+
+== 1.1.8 - 7-Oct-2010
+* Fixed a logic bug in the constructor that primarily affected MS Windows with
+  regards to determining the user's home directory.
+
+== 1.1.7 - 6-Oct-2010
+* More robust file decryption/encryption for MS Windows.
+* Better platform checking for MS Windows.
+* Refactored the Rakefile. Removed the old installation tasks and replaced
+  them with a series of gem tasks.
+* Updated the win32 library dependencies.
+
+== 1.1.6 - 10-Sep-2009
+* Fixed validation for dbrc_dir argument.
+* Added a test for bogus dbrc_dir arguments.
+
+== 1.1.5 - 3-Sep-2009
+* License changed to Artistic 2.0.
+* Some gemspec updates, including the license and description.
+* Renamed the test files. The ts_all.rb file was removed.
+* Added win32-process as a dependency on MS Windows.
+* Added test-unit as a development dependency. Some tests were refactored
+  to use features from test-unit 2.x.
+* Added the 'test_xml' and 'test_yml' rake tasks.
+* Refactored the main test task.
+* Added explicit copyright and warranty to the README file.
+
+== 1.1.4 - 10-Nov-2008
+* Added a custom inspect method which filters the password.
+
+== 1.1.3 - 21-Jul-2008
+* More RUBY_PLATFORM changes that I missed in the last release.
+* Added inline RDOC for the accessors and updated the documentation
+  for the constructor.
+* Added the DBI::DBRC#dbrc_dir and DBI::DBRC#dbrc_file methods.
+* More tests.
+
+== 1.1.2 - 18-Jul-2008
+* Changed platform checking from RUBY_PLATFORM to Config::CONFIG['host_os']
+  so that other implementations won't choke.
+* Updated the gemspec to add the sys-admin dependency.
+* Added a rubyforge_project to the gemspec.
+* Now has a separate gem for MS Windows.
+
+== 1.1.1 - 2-Aug-2007
+* DBRCError is now DBRC::Error.
+* Added a Rakefile with tasks for installation and testing.
+* Added the win32-dir library as a prerequisite for MS Windows.
+* Removed the install.rb file. That's now handled by the Rakefile.
+* Some refactoring in the constructor, including the elimination of
+  warnings that appeared when run with -w.
+* Some doc and test updates.
+
+== 1.1.0 - 19-Oct-2005
+* Bug fix for MS Windows (there's no Win32 namespace for win32/file).
+* Changed platform detection mechanism.
+
+== 1.0.1 - 7-Oct-2005
+* Improved the error message when an entry isn't found.
+
+== 1.0.0 - 15-Jun-2005
+* Ditches the use of 'etc'.  Now requires the 'sys-admin' package as its
+  replacement (for all platforms).
+* Moved project to RubyForge.
+* Minor updates to tests, README and gemspec.
+* Now hosted on RubyForge.
+
+== 0.5.1 - 17-Mar-2005
+* Removed the 'doc' directory completely, and moved the primary
+  documentation into the README file.
+* Removed the INSTALL file.  Moved the installation directions into the
+  README file.
+* Moved the examples into a toplevel 'examples' directory.
+* Made the README and CHANGES files rdoc friendly.
+* Added a gemspec.
+
+== 0.5.0 - 15-Oct-2004
+* Added a YAML subclass.  Use this if you want to store your information in
+  the .dbrc file in YAML format.
+* On Win32 systems, the .dbrc file must now be "hidden".  Also, it will
+  automatically decrypt/encrypt the file if it is encrypted.  This also
+  means that the win32-file package is also required on Win32 systems.
+* Massive refactoring of the XML subclass.  It should work better now.
+* Moved the YML and XML subclasses directly into the dbrc.rb file.
+* For the aliases, you can now write as well as read.
+* In lieu of the namespace fix for "timeout" in 1.8, I have renamed "time_out"
+  to simply "timeout".  For backwards compatability, I have created an alias,
+  so you may still use the old method name.  However, this means that you
+  should only use this package with 1.8.0 or later.
+* Removed the dbrc.html file.  You can generate this on your own if you wish
+  using rdtool.
+* Test suite changes.
+
+== 0.4.0 - 3-Sep-2004
+* Removed redundant error handling for cases when the database and/or login
+  are not found.
+* Added an XML subclass.  Use this if you want to store your information in
+  the .dbrc file in XML format.
+
+== 0.3.0 - 26-Oct-2003
+* Win32 support added.  Requires the win32-etc package.
+* rd doc separated from source.  Moved to 'doc' directory.
+* Documentation updates and corrections.
+* Minor test suite tweaks for Win32 systems.
+
+== 0.2.1 - 28-Aug-2003
+* Removed VERSION class method.  Just use the constant.
+* Bug fix with regards to split and Ruby 1.8.  Thanks Michael Garriss.
+* Changed 'changelog' to 'CHANGES'.
+* Added a vanilla test script (test.rb)
+* Minor code optimization (IO.foreach)
+* Test unit cleanup
+* Minor internal directory layout and doc changes
+
+== 0.2.0 - 13-Jan-2003
+* DBRC class now under the DBI module namespace
+* Changed "timeout" to "time_out" to avoid confusion with the timeout
+  module.
+* The 'time_out', 'max_reconn', and 'interval' methods now return Integers,
+  rather than Strings.
+* Only the database, user and password fields are required now within the
+  .dbrc file.  The driver, time_out and max_reconn entries can be left blank
+  without causing an error.  Note that the 'dsn' method will return 'nil'
+  if the driver isn't set.
+* Added a DBRCException class instead of just raising an error string.
+* Changed 'db' method to 'database' (but 'db' is an alias)
+* Changed 'max_reconn' method to 'maximum_reconnects' (but 'max_reconn'
+  is an alias')
+* Added 'passwd' alias for 'password' method 
+* Added a VERSION class method
+* Methods that should have been private are now private
+* Internal directory layout change
+* Tests added
+* Install script improved
+* Documentation additions, including plain text doc
+
+== 0.1.1 - 26-Jul-2002
+* Added 'dsn()' method
+* Minor documentation additions
+
+== 0.1.0 - 26-Jul-2002
+* Initial release

data/MANIFEST

@@ -1,15 +1,15 @@
-* MANIFEST
-* CHANGES
-* README
-* Rakefile
-* dbi-dbrc.gemspec
-* lib/dbi/dbrc.rb
-* examples/plain/.dbrc
-* examples/plain/test.rb
-* examples/xml_examples/.dbrc
-* examples/xml_examples/test_xml.rb
-* examples/yml_examples/.dbrc
-* examples/yml_examples/test_yml.rb
-* test/test_dbi_dbrc.rb
-* test/test_dbi_dbrc_xml.rb
-* test/test_dbi_dbrc_yml.rb
+* MANIFEST
+* CHANGES
+* README
+* Rakefile
+* dbi-dbrc.gemspec
+* lib/dbi/dbrc.rb
+* examples/plain/.dbrc
+* examples/plain/test.rb
+* examples/xml_examples/.dbrc
+* examples/xml_examples/test_xml.rb
+* examples/yml_examples/.dbrc
+* examples/yml_examples/test_yml.rb
+* test/test_dbi_dbrc.rb
+* test/test_dbi_dbrc_xml.rb
+* test/test_dbi_dbrc_yml.rb

data/README

@@ -1,260 +1,260 @@
-== Description
-   This is a supplement to the dbi module, allowing you to avoid hard-coding
-   passwords in your programs that make database connections. It can also
-   be used as a general password storage mechanism for other types of
-   connections, e.g. ssh, ftp, etc.
-
-== Requirements
-   * Ruby 1.8.2 or later
-   * sys-admin
-   * win32-file (MS Windows only)
-   * win32-dir (MS Windows only)
-
-== Installation
-   gem install dbi-dbrc
-
-== Synopsis
-   require 'dbi/dbrc'
-   include DBI
-
-   dbrc = DBRC.new('mydb')
-
-   or
-
-   dbrc = DBRC.new('mydb', 'someUser')
-
-   puts dbrc.db
-   puts dbrc.user
-   puts dbrc.driver
-   puts dbrc.timeout
-   puts dbrc.max_reconn
-   puts dbrc.interval
-   puts dbrc.dsn
-
-== Notes on the .dbrc file
-   This module relies on a file in your home directory called ".dbrc", and it
-   is meant to be analogous to the ".netrc" file used by programs such as
-   telnet. The .dbrc file has several conditions that must be met by the
-   module or it will fail:
-
-   * Permissions must be set to 600 (Unix only).
-   * Must be hidden (MS Windows only).
-   * Must be owned by the current user.
-   * Must have database, user and password. Other fields are optional.
-   * Must be in the following space-separated format (in the 'plain' version):
-
-   database user password driver timeout maximum_reconnects interval
-
-   e.g. mydb     dan    mypass     oracle   10        2         30
-
-   You may include comments in the .dbrc file by starting the line with a
-   "#" symbol.
-
-   A failure in any of the rules mentioned above will result in a DBRC::Error
-   being raised. In addition, the file may also be encrypted on MS Windows
-   systems, in which case the file will automatically be (temporarily)
-   decrypted.
-
-   The format for XML (using the example above) is as follows:
-
-   <dbrc>
-      <database name="mydb">
-         <user>dan</user>
-         <password>mypass</password>
-         <driver>oracle</driver>
-         <interval>30</interval>
-         <timeout>10</timeout>
-         <maximum_reconnects>2</maximum_reconnects>
-      </database>
-   </dbrc>
-
-   The format for YAML is as follows:
-
-   - mydb:
-      user: dan
-      password: mypass
-      driver: oracle
-      interval: 30
-      timeout: 10
-      max_reconn: 2
-   
-== Constants
-VERSION
-   The current version of this library, returned as a String.
-    
-== Class Methods
-DBRC.new(db, user=nil, dir=nil)
-   The constructor takes one to three arguments. The first argument is the
-   database name. This *must* be provided. If only the database name is
-   passed, the module will look for the first database entry in the .dbrc
-   file that matches.
-
-   The second argument, a user name, is optional. If it is passed, the
-   module will look for the first entry in the .dbrc file where both the
-   database *and* user name match.
-
-   The third argument, also optional, specifies the directory where DBRC will
-   look for the .dbrc file. By default, it looks in the pwuid (present
-   working user id) home directory. The rules for a .dbrc file still apply.
-    
-   MS Windows users should read the "Notes" section for how your home directory
-   is determined.
-    
-== Instance Methods
-DBRC#database
-   The name of the database. Note that the same entry can appear more than
-   once, presumably because you have multiple user id's for the same
-   database.
-    
-DBRC#db
-   An alias for DBRC#database.
-    
-DBRC#database=(database)
-   Sets the database to +database+.  This is generally discouraged because
-   it does not automatically reset the dsn.
-    
-DBRC#db=(database)
-   An alias for DBRC#database=.
-   
-DBRC#user
-   A valid user name for that database.
-    
-DBRC#user=(user)
-   Sets the user name to +user+.
-    
-DBRC#password
-   The password for that user.
-    
-DBRC#passwd
-   An alias for DBRC#password.
-    
-DBRC#password=(password)
-   Sets the password to +password+.
-
-DBRC#passwd=(password)
-   An alias for DBRC#password=.
-    
-DBRC#driver
-   The driver type for that database (Oracle, MySql, etc).
-    
-DBRC#driver=(driver)
-   Sets the driver to +driver+.  This use is discouraged because it does
-   not reset the dsn.
-    
-DBRC#timeout
-   The timeout period for a connection before the attempt is dropped.
-   
-DBRC#time_out
-   An alias for DBRC#timeout, provided purely for the sake of backwards
-   compatability.
-    
-DBRC#timeout=(int)
-   Sets the timeout value to +int+.
-   
-DBRC#maximum_reconnects
-   The maximum number of reconnect attempts that should be made for the the
-   database.  Presumablly, you would use this with a "retry" within a rescue
-   block.
-
-DBRC#max_reconn
-   An alias for DBRC#maximum_reconnects.
-   
-DBRC#maximum_reconnects=(max)
-   Sets the maximum number of reconnect attempts to +max+.
-
-DBRC#max_reconn=(max)
-   An alias for DBRC#maximum_reconnects.
-    
-DBRC#interval
-   The number of seconds to wait before attempting to reconnect to the database
-   again should a network/database glitch occur.
-    
-DBRC#interval=(int)
-   Sets the interval seconds between connection attempts.
-    
-DBRC#dsn
-   Returns a string in "dbi:<driver>:<database>" format.
-    
-DBRC#dsn=(dsn)
-   Sets the dsn string to +dsn+.  This method is discouraged because it does
-   not automatically reset the driver or database.
-    
-== Canonical Example
-   # This is a basic template for how I do things:
-
-   require 'dbi/dbrc'
-   require 'timeout'
-
-   db = DBI::DBRC.new("somedb")
-   n = db.max_reconn
-
-   begin
-      Timeout.timeout(db.timeout){
-         DBI.connect(db.dsn, db.user, db.passwd)
-      }
-   rescue DBI::Error
-      n -= 1
-      if n > 0
-         sleep db.interval
-         retry
-      end
-      raise
-   rescue TimeoutError
-      # handle timeout error
-   end
-
-== Notes for MS Windows Users
-   The 'home' directory for Win32 users is determined by ENV['USERPROFILE'].
-   If that is not set, ENV['HOME'] is used. If that is not set, then
-   'C:\Documents and Settings\user_name' is used.
-
-   To make your file hidden, right click on the .dbrc file in your Explorer
-   window, select "Properties" and check the "Hidden" checkbox.
-
-   I was going to require that the .dbrc file be encrypted on MS Windows,
-   but that may require an official "certificate", assigned to you by a third
-   party, which is a bit much to expect. However, if the file is encrypted,
-   DBRC will attempt to decrypt it, parse it, and encrypt it again when done
-   parsing.
-
-== Notes on running the test suite
-   I cannot guarantee that the .dbrc files under the +examples+
-   subdirectories maintain the appropriate properties. This can cause
-   failures for the test suite (which uses these files).
-   
-   The only solution is to perform a 'chmod 600 .dbrc' (on Unix) or set
-   the properties to 'hidden' (on MS Windows) manually, for the file in
-   question.
-   
-== Summary
-   These "methods" don't really do anything. They're simply meant as a
-   convenience mechanism for you dbi connections, plus a little bit of
-   obfuscation (for passwords).
-
-== Adding your own configuration
-   If you want to add your own type of configuration file, you can still use
-   the dbi-dbrc library. All you need to do is:
-
-   * subclass DBRC
-   * redefine the +parse_dbrc_config_file+ method (a private method).
-
-   Take a look at the XML and YML subclasses in dbrc.rb for two examples that
-   you can work from.
-   
-== Future Plans
-   Add DBI::DBRC::JSON.
-   
-== Known Bugs
-   I'm not positive about the dsn strings for databases other than Oracle.
-   If it's not correct, please let me know.
-   
-== Copyright
-   (C) Copyright 2002-2009, Daniel J. Berger, all rights reserved.
-   
-= Warranty
-   This package is provided "as is" and without any express or
-   implied warranties, including, without limitation, the implied
-   warranties of merchantability and fitness for a particular purpose
-   
-== Author
-   Daniel J. Berger
+== Description
+   This is a supplement to the dbi module, allowing you to avoid hard-coding
+   passwords in your programs that make database connections. It can also
+   be used as a general password storage mechanism for other types of
+   connections, e.g. ssh, ftp, etc.
+
+== Requirements
+   * sys-admin
+   * win32-file (MS Windows only)
+   * win32-dir (MS Windows only)
+   * win32-process (MS Windows only)
+
+== Installation
+   gem install dbi-dbrc
+
+== Synopsis
+   require 'dbi/dbrc'
+   include DBI
+
+   dbrc = DBRC.new('mydb')
+
+   or
+
+   dbrc = DBRC.new('mydb', 'someUser')
+
+   puts dbrc.db
+   puts dbrc.user
+   puts dbrc.driver
+   puts dbrc.timeout
+   puts dbrc.max_reconn
+   puts dbrc.interval
+   puts dbrc.dsn
+
+== Notes on the .dbrc file
+   This module relies on a file in your home directory called ".dbrc", and it
+   is meant to be analogous to the ".netrc" file used by programs such as
+   telnet. The .dbrc file has several conditions that must be met by the
+   module or it will fail:
+
+   * Permissions must be set to 600 (Unix only).
+   * Must be hidden (MS Windows only).
+   * Must be owned by the current user.
+   * Must have database, user and password. Other fields are optional.
+   * Must be in the following space-separated format (in the 'plain' version):
+
+   database user password driver timeout maximum_reconnects interval
+
+   e.g. mydb     dan    mypass     oracle   10        2         30
+
+   You may include comments in the .dbrc file by starting the line with a
+   "#" symbol.
+
+   A failure in any of the rules mentioned above will result in a DBRC::Error
+   being raised. In addition, the file may also be encrypted on MS Windows
+   systems, in which case the file will automatically be (temporarily)
+   decrypted.
+
+   The format for XML (using the example above) is as follows:
+
+   <dbrc>
+      <database name="mydb">
+         <user>dan</user>
+         <password>mypass</password>
+         <driver>oracle</driver>
+         <interval>30</interval>
+         <timeout>10</timeout>
+         <maximum_reconnects>2</maximum_reconnects>
+      </database>
+   </dbrc>
+
+   The format for YAML is as follows:
+
+   - mydb:
+      user: dan
+      password: mypass
+      driver: oracle
+      interval: 30
+      timeout: 10
+      max_reconn: 2
+   
+== Constants
+VERSION
+   The current version of this library, returned as a String.
+    
+== Class Methods
+DBRC.new(db, user=nil, dir=nil)
+   The constructor takes one to three arguments. The first argument is the
+   database name. This *must* be provided. If only the database name is
+   passed, the module will look for the first database entry in the .dbrc
+   file that matches.
+
+   The second argument, a user name, is optional. If it is passed, the
+   module will look for the first entry in the .dbrc file where both the
+   database *and* user name match.
+
+   The third argument, also optional, specifies the directory where DBRC will
+   look for the .dbrc file. By default, it looks in the pwuid (present
+   working user id) home directory. The rules for a .dbrc file still apply.
+    
+   MS Windows users should read the "Notes" section for how your home directory
+   is determined.
+    
+== Instance Methods
+DBRC#database
+   The name of the database. Note that the same entry can appear more than
+   once, presumably because you have multiple user id's for the same
+   database.
+    
+DBRC#db
+   An alias for DBRC#database.
+    
+DBRC#database=(database)
+   Sets the database to +database+.  This is generally discouraged because
+   it does not automatically reset the dsn.
+    
+DBRC#db=(database)
+   An alias for DBRC#database=.
+   
+DBRC#user
+   A valid user name for that database.
+    
+DBRC#user=(user)
+   Sets the user name to +user+.
+    
+DBRC#password
+   The password for that user.
+    
+DBRC#passwd
+   An alias for DBRC#password.
+    
+DBRC#password=(password)
+   Sets the password to +password+.
+
+DBRC#passwd=(password)
+   An alias for DBRC#password=.
+    
+DBRC#driver
+   The driver type for that database (Oracle, MySql, etc).
+    
+DBRC#driver=(driver)
+   Sets the driver to +driver+.  This use is discouraged because it does
+   not reset the dsn.
+    
+DBRC#timeout
+   The timeout period for a connection before the attempt is dropped.
+   
+DBRC#time_out
+   An alias for DBRC#timeout, provided purely for the sake of backwards
+   compatability.
+    
+DBRC#timeout=(int)
+   Sets the timeout value to +int+.
+   
+DBRC#maximum_reconnects
+   The maximum number of reconnect attempts that should be made for the the
+   database.  Presumablly, you would use this with a "retry" within a rescue
+   block.
+
+DBRC#max_reconn
+   An alias for DBRC#maximum_reconnects.
+   
+DBRC#maximum_reconnects=(max)
+   Sets the maximum number of reconnect attempts to +max+.
+
+DBRC#max_reconn=(max)
+   An alias for DBRC#maximum_reconnects.
+    
+DBRC#interval
+   The number of seconds to wait before attempting to reconnect to the database
+   again should a network/database glitch occur.
+    
+DBRC#interval=(int)
+   Sets the interval seconds between connection attempts.
+    
+DBRC#dsn
+   Returns a string in "dbi:<driver>:<database>" format.
+    
+DBRC#dsn=(dsn)
+   Sets the dsn string to +dsn+.  This method is discouraged because it does
+   not automatically reset the driver or database.
+    
+== Canonical Example
+   # This is a basic template for how I do things:
+
+   require 'dbi/dbrc'
+   require 'timeout'
+
+   db = DBI::DBRC.new("somedb")
+   n = db.max_reconn
+
+   begin
+      Timeout.timeout(db.timeout){
+         DBI.connect(db.dsn, db.user, db.passwd)
+      }
+   rescue DBI::Error
+      n -= 1
+      if n > 0
+         sleep db.interval
+         retry
+      end
+      raise
+   rescue TimeoutError
+      # handle timeout error
+   end
+
+== Notes for MS Windows Users
+   The 'home' directory for Win32 users is determined by ENV['USERPROFILE'].
+   If that is not set, ENV['HOME'] is used. If that is not set, then
+   the directory found by the sys-admin library is used.
+
+   To make your file hidden, right click on the .dbrc file in your Explorer
+   window, select "Properties" and check the "Hidden" checkbox.
+
+   I was going to require that the .dbrc file be encrypted on MS Windows,
+   but that may require an official "certificate", assigned to you by a third
+   party, which is a bit much to expect. However, if the file is encrypted,
+   DBRC will attempt to decrypt it, parse it, and encrypt it again when done
+   parsing.
+
+== Notes on running the test suite
+   I cannot guarantee that the .dbrc files under the +examples+
+   subdirectories maintain the appropriate properties. This can cause
+   failures for the test suite (which uses these files).
+   
+   The only solution is to perform a 'chmod 600 .dbrc' (on Unix) or set
+   the properties to 'hidden' (on MS Windows) manually, for the file in
+   question.
+   
+== Summary
+   These "methods" don't really do anything. They're simply meant as a
+   convenience mechanism for you dbi connections, plus a little bit of
+   obfuscation (for passwords).
+
+== Adding your own configuration
+   If you want to add your own type of configuration file, you can still use
+   the dbi-dbrc library. All you need to do is:
+
+   * subclass DBRC
+   * redefine the +parse_dbrc_config_file+ method (a private method).
+
+   Take a look at the XML and YML subclasses in dbrc.rb for two examples that
+   you can work from.
+   
+== Future Plans
+   Add DBI::DBRC::JSON.
+   
+== Known Bugs
+   I'm not positive about the dsn strings for databases other than Oracle.
+   If it's not correct, please let me know.
+   
+== Copyright
+   (C) Copyright 2002-2013, Daniel J. Berger, all rights reserved.
+   
+= Warranty
+   This package is provided "as is" and without any express or
+   implied warranties, including, without limitation, the implied
+   warranties of merchantability and fitness for a particular purpose
+   
+== Author
+   Daniel J. Berger