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

#6969: make it explicit that configparser writes/reads text files, and fix the example.

Browse source
This commit is contained in:
Georg Brandl 2009-09-22 13:53:14 +00:00
parent 8355e7c4a5
commit 73753d354b
1 changed files with 9 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

15
Doc/library/configparser.rst
View file

@ -231,9 +231,11 @@ RawConfigParser Objects
.. method:: RawConfigParser.readfp(fp, filename=None) .. method:: RawConfigParser.readfp(fp, filename=None)
Read and parse configuration data from the file or file-like object in *fp* Read and parse configuration data from the file or file-like object in *fp*
(only the :meth:`readline` method is used). If *filename* is omitted and *fp* (only the :meth:`readline` method is used). The file-like object must
has a :attr:`name` attribute, that is used for *filename*; the default is operate in text mode, i.e. return strings from :meth:`readline`.
``<???>``.
If *filename* is omitted and *fp* has a :attr:`name` attribute, that is used
for *filename*; the default is ``<???>``.
.. method:: RawConfigParser.get(section, option) .. method:: RawConfigParser.get(section, option)
@ -279,8 +281,9 @@ RawConfigParser Objects
.. method:: RawConfigParser.write(fileobject) .. method:: RawConfigParser.write(fileobject)
Write a representation of the configuration to the specified file object. This Write a representation of the configuration to the specified file object,
representation can be parsed by a future :meth:`read` call. which must be opened in text mode (accepting strings). This representation
can be parsed by a future :meth:`read` call.
.. method:: RawConfigParser.remove_option(section, option) .. method:: RawConfigParser.remove_option(section, option)
@ -370,7 +373,7 @@ An example of writing to a configuration file::
config.set('Section1', 'foo', '%(bar)s is %(baz)s!') config.set('Section1', 'foo', '%(bar)s is %(baz)s!')
# Writing our configuration file to 'example.cfg' # Writing our configuration file to 'example.cfg'
with open('example.cfg', 'wb') as configfile: with open('example.cfg', 'w') as configfile:
config.write(configfile) config.write(configfile)
An example of reading the configuration file again:: An example of reading the configuration file again::