## 6.2.2 ConfigSection Objects

class `ConfigSection``(`name, data={ }`)`

  Instantiate a `ConfigSection` object.

  name is the name of the section.

  data, if specified, is the dictionary of data to initalize the section contents with.

`ConfigSection` objects are rarely instantiated manually. They are generally created using the `ConfigManager` API (either the direct methods or the Python dictionary syntax).

`data`

  dictionary that contains the option instances. This is only accessed if you want to retrieve the real option instances. Normally, you would use standard dictionary key access syntax on the section itself to retrieve the option values.

`name`

  the name given to the section.

`copy``(``)`

  make a deep copy of the section object.

`defaults``(``)`

  return the dictionary of default options associated with the parent `ConfigManager`.

`get``(`option, raw=0, vars={ }`)`

  retrieve the value of option. Setting raw to true prevents any string interpolation from occurring in that value. vars is a dictionary of addition value to use when interpolating values into the option.

  Note: You can alsouse the alternative dictionary syntax: section.get(option).

`getboolean``(`section, option`)`

  retrieve the specified value and cast it to a boolean

`__getitem__``(`key`)`

  retrieve the value of an option. This method allows you to use Python’s dictionary syntax on a section as shown below.

      # Print the value of the 'optionname' option
      print mysection['optionname']

`getint``(`section, option`)`

  retrieve the specified value and cast it to and integer

`getfloat``(`section, option`)`

  retrieve the specified value and cast it to a float

`getraw``(`section, option`)`

  return the raw (i.e. un-interpolated) value of the option

`parent`

  a reference to the parent `ConfigManager` object.

`__repr__``(``)`

  return a string containing an INI file representation of the section.

`set``(`option, value`)`

  create a new option or set an existing option with the name option and the value of value. If the given value is already an option instance, it is simply inserted into the section. If it is not an option instance, an appropriate type of option is chosen for the given type.

`__setitem__``(`key, value`)`

  create a new option or set an existing option with the name key and the value of value. This method allows you to use Python’s dictionary syntax to set options as shown below.

      # Create a new option called 'optionname'
      mysection['optionname'] = 10

`__str__``(``)`

  return a string containing an INI file representation of the section. Options set from Python code are not included in this representation.

`to_string``(`[source]`)`

  return a string containing an INI file representation of the section. The source option allows you to only display options from certain sources. See the `ConfigManager.source()` method for more information.