Add backend parameter to dbm.open() and shelve.open() for explicit DBM backend selection
Personne n'a encore pris cette issue.
- Langage dominant
- Python
- Étoiles
- 77.2k
- Forks
- 35.9k
- Métriques de merge des PR
- Métriques de PR en attente
Description
Feature or enhancement
Proposal:
Summary
Add an optional backend parameter to dbm.open() and shelve.open() functions to allow explicit selection of DBM backend implementations, improving compatibility and predictability across different systems.
Motivation
Currently, Python's DBM module automatically selects an available backend implementation in priority order (dbm.sqlite3, dbm.gnu, dbm.ndbm, dbm.dumb). This can cause compatibility issues when:
- Custom serializers work with some backends but not others (e.g., gdbm type restrictions)
- Cross-platform consistency is needed across different environments
- Predictable behavior is required regardless of which backends are installed
- Testing needs to validate behavior with specific backends
Real-world example
# This works with dbm.sqlite3 but fails with dbm.gnu
def custom_serializer(obj, protocol):
if protocol == 5 and isinstance(obj, bytearray):
return obj # Causes "gdbm mappings have bytes or string indices only"
return pickle.dumps(obj, protocol)
# Currently no way to ensure consistent backend
with shelve.open('data.db', serializer=custom_serializer) as shelf:
shelf['key'] = bytearray(b'data') # May fail depending on system
See: https://github.com/python/cpython/issues/137829
Proposed Solution
Add an optional backend parameter to both functions:
# dbm.open()
dbm.open(file, flag='r', mode=0o666, backend=None)
# shelve.open()
shelve.open(filename, flag='c', protocol=None, writeback=False,
backend=None, *, serializer=None, deserializer=None)
Usage Examples:
import dbm
import shelve
# Explicit backend selection
with dbm.open('data.db', 'c', backend='dbm.dumb') as db:
db[b'key'] = b'value'
# Cross-platform consistency
with shelve.open('data.shelf', backend='dbm.sqlite3') as shelf:
shelf['key'] = complex_object
# Testing with specific backends
for backend in ['dbm.gnu', 'dbm.ndbm', 'dbm.dumb']:
with shelve.open(f'test_{backend}.db', backend=backend) as shelf:
test_serialization_compatibility(shelf)
Has this already been discussed elsewhere?
This is a minor feature, which does not need previous discussion elsewhere
Links to previous discussion of this feature:
No response
Linked PRs
- gh-137882
- gh-138007
Guide de contribution
Ouvrir le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Piste de recherche
Commencez par examiner les points d’entrée dbm.open() et shelve.open() ainsi que le comportement existant de sélection du backend décrit dans l’issue. Consultez les PRs liés gh-137882 et gh-138007 avant de commencer, car ils indiquent que le travail a déjà été déplacé ailleurs. Le travail sera considéré comme terminé lorsqu’une API de sélection du backend aura été approuvée et qu’une couverture des choix explicites de backend sera disponible pour toutes les implémentations prises en charge.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Évaluation
- Stack technique
- python
- Domaine
- databases
- Type d'issue
- Fonctionnalité
- Difficulté
- 5/5
- Temps estimé
- Plus d'une semaine
- Activité
- À l'abandon
- Clarté
- Plutôt claire
- Accessibilité débutants
- 25/100