[Python-checkins] r60184 - peps/trunk/pep-3108.txt

[brett.cannon]

Author: brett.cannon
Date: Mon Jan 21 23:18:06 2008
New Revision: 60184

Modified:
   peps/trunk/pep-3108.txt
Log:
Add dbm package.


Modified: peps/trunk/pep-3108.txt
==============================================================================
--- peps/trunk/pep-3108.txt	(original)
+++ peps/trunk/pep-3108.txt	Mon Jan 21 23:18:06 2008
@@ -351,7 +351,8 @@
 Along with the stdlib gaining some modules that are no longer
 relevant, there is also the issue of naming.  Many modules existed in
 the stdlib before PEP 8 came into existence [#pep-0008]_.  This has
-led to some naming inconsistencies that should be addressed.
+led to some naming inconsistencies and namespace bloat that should be
+addressed.
 
 Any module that has been suggested for removal and does not meet the
 required naming scheme is *not* listed below.
@@ -464,6 +465,35 @@
 =================  ===============================
 
 
+Grouping of modules
+-------------------
+
+As the stdlib has grown, several areas within it have expanded to
+include multiple modules (e.g., dbm support). Thus some new packages
+make sense where the renaming makes a module's name easier to work
+with.
+
+
+dbm package
+///////////
+
+The ``dbm`` package is to collect all dbm-related modules. Do note
+that both ``anydbm`` and ``whichdb`` are merged into a single module.
+This was done as both modules currently have minimal functionality and
+have no name conflicts.
+
+=================  ===============================
+Current Name       Replacement Name
+=================  ===============================
+anydbm             dbm.tools
+dbhash             dbm.db
+dbm                dbm.ndbm
+dumbdm             dbm.dumb
+gdbm               dbm.gnu
+whichdb            dbm.tools
+=================  ===============================
+
+
 Transition Plan
 ===============
 
@@ -496,7 +526,7 @@
 to bind in the module namespace to the old name while importing based
 on the new name.
 
-All the database related modules will be moved to a database package.
+All database related modules will be moved to a database package.
 These modules include:  bsddb, dbm, gdbm, sqlite,
 anydbm, dbhash, dumbdbm, whichdb.