mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-08-19 00:00:48 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

[3.12] Docs: mark up dbm.open() with param list (GH-114601) (#114604)

Browse source 
Also consolidate following paragraphs regarding database objects.

(cherry picked from commit 0bd8297a22)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
This commit is contained in:
Miss Islington (bot) 2024-01-26 16:18:10 +01:00 • committed by GitHub
parent 9726cabfb6
commit 61f8f58f81
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 26 additions and 26 deletions
Download patch file Download diff file Expand all files Collapse all files

52
Doc/library/dbm.rst
View file

@ -58,41 +58,33 @@ the Oracle Berkeley DB.
.. function:: open(file, flag='r', mode=0o666) .. function:: open(file, flag='r', mode=0o666)
Open the database file *file* and return a corresponding object. Open a database and return the corresponding database object.
If the database file already exists, the :func:`whichdb` function is used to :param file:
determine its type and the appropriate module is used; if it does not exist, The database file to open.
the first module listed above that can be imported is used.
The optional *flag* argument can be: If the database file already exists, the :func:`whichdb` function is used to
determine its type and the appropriate module is used; if it does not exist,
the first submodule listed above that can be imported is used.
:type file: :term:`path-like object`
.. csv-table:: :param str flag:
:header: "Value", "Meaning" * ``'r'`` (default), |flag_r|
* ``'w'``, |flag_w|
* ``'c'``, |flag_c|
* ``'n'``, |flag_n|
``'r'`` (default), |flag_r| :param int mode:
``'w'``, |flag_w| The Unix file access mode of the file (default: octal ``0o666``),
``'c'``, |flag_c| used only when the database has to be created.
``'n'``, |flag_n|
The optional *mode* argument is the Unix mode of the file, used only when the
database has to be created. It defaults to octal ``0o666`` (and will be
modified by the prevailing umask).
.. versionchanged:: 3.11 .. versionchanged:: 3.11
*file* accepts a :term:`path-like object`. *file* accepts a :term:`path-like object`.
The object returned by :func:`~dbm.open` supports the same basic functionality as a
The object returned by :func:`open` supports the same basic functionality as a
:class:`dict`; keys and their corresponding values can be stored, retrieved, and :class:`dict`; keys and their corresponding values can be stored, retrieved, and
deleted, and the :keyword:`in` operator and the :meth:`!keys` method are deleted, and the :keyword:`in` operator and the :meth:`!keys` method are
available, as well as :meth:`!get` and :meth:`!setdefault`. available, as well as :meth:`!get` and :meth:`!setdefault` methods.
.. versionchanged:: 3.2
:meth:`!get` and :meth:`!setdefault` are now available in all database modules.
.. versionchanged:: 3.8
Deleting a key from a read-only database raises database module specific error
instead of :exc:`KeyError`.
Key and values are always stored as :class:`bytes`. This means that when Key and values are always stored as :class:`bytes`. This means that when
strings are used they are implicitly converted to the default encoding before strings are used they are implicitly converted to the default encoding before
@ -101,9 +93,17 @@ being stored.
These objects also support being used in a :keyword:`with` statement, which These objects also support being used in a :keyword:`with` statement, which
will automatically close them when done. will automatically close them when done.
.. versionchanged:: 3.2
:meth:`!get` and :meth:`!setdefault` methods are now available for all
:mod:`dbm` backends.
.. versionchanged:: 3.4 .. versionchanged:: 3.4
Added native support for the context management protocol to the objects Added native support for the context management protocol to the objects
returned by :func:`.open`. returned by :func:`~dbm.open`.
.. versionchanged:: 3.8
Deleting a key from a read-only database raises a database module specific exception
instead of :exc:`KeyError`.
The following example records some hostnames and a corresponding title, and The following example records some hostnames and a corresponding title, and
then prints out the contents of the database:: then prints out the contents of the database::