diff --git a/pep-3108.txt b/pep-3108.txt index 664f88b72..ee5a192d5 100644 --- a/pep-3108.txt +++ b/pep-3108.txt @@ -351,7 +351,8 @@ Modules to Rename 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 @@ test.test_support test.support ================= =============================== +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 @@ will be accomplished by using the ``as`` keyword in import statments 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.