/usr/share/doc/python-configobj/api/configobj-pysrc.html is in python-configobj 4.7.2+ds-4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233 1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256 1257 1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338 1339 1340 1341 1342 1343 1344 1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 1376 1377 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387 1388 1389 1390 1391 1392 1393 1394 1395 1396 1397 1398 1399 1400 1401 1402 1403 1404 1405 1406 1407 1408 1409 1410 1411 1412 1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 1423 1424 1425 1426 1427 1428 1429 1430 1431 1432 1433 1434 1435 1436 1437 1438 1439 1440 1441 1442 1443 1444 1445 1446 1447 1448 1449 1450 1451 1452 1453 1454 1455 1456 1457 1458 1459 1460 1461 1462 1463 1464 1465 1466 1467 1468 1469 1470 1471 1472 1473 1474 1475 1476 1477 1478 1479 1480 1481 1482 1483 1484 1485 1486 1487 1488 1489 1490 1491 1492 1493 1494 1495 1496 1497 1498 1499 1500 1501 1502 1503 1504 1505 1506 1507 1508 1509 1510 1511 1512 1513 1514 1515 1516 1517 1518 1519 1520 1521 1522 1523 1524 1525 1526 1527 1528 1529 1530 1531 1532 1533 1534 1535 1536 1537 1538 1539 1540 1541 1542 1543 1544 1545 1546 1547 1548 1549 1550 1551 1552 1553 1554 1555 1556 1557 1558 1559 1560 1561 1562 1563 1564 1565 1566 1567 1568 1569 1570 1571 1572 1573 1574 1575 1576 1577 1578 1579 1580 1581 1582 1583 1584 1585 1586 1587 1588 1589 1590 1591 1592 1593 1594 1595 1596 1597 1598 1599 1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610 1611 1612 1613 1614 1615 1616 1617 1618 1619 1620 1621 1622 1623 1624 1625 1626 1627 1628 1629 1630 1631 1632 1633 1634 1635 1636 1637 1638 1639 1640 1641 1642 1643 1644 1645 1646 1647 1648 1649 1650 1651 1652 1653 1654 1655 1656 1657 1658 1659 1660 1661 1662 1663 1664 1665 1666 1667 1668 1669 1670 1671 1672 1673 1674 1675 1676 1677 1678 1679 1680 1681 1682 1683 1684 1685 1686 1687 1688 1689 1690 1691 1692 1693 1694 1695 1696 1697 1698 1699 1700 1701 1702 1703 1704 1705 1706 1707 1708 1709 1710 1711 1712 1713 1714 1715 1716 1717 1718 1719 1720 1721 1722 1723 1724 1725 1726 1727 1728 1729 1730 1731 1732 1733 1734 1735 1736 1737 1738 1739 1740 1741 1742 1743 1744 1745 1746 1747 1748 1749 1750 1751 1752 1753 1754 1755 1756 1757 1758 1759 1760 1761 1762 1763 1764 1765 1766 1767 1768 1769 1770 1771 1772 1773 1774 1775 1776 1777 1778 1779 1780 1781 1782 1783 1784 1785 1786 1787 1788 1789 1790 1791 1792 1793 1794 1795 1796 1797 1798 1799 1800 1801 1802 1803 1804 1805 1806 1807 1808 1809 1810 1811 1812 1813 1814 1815 1816 1817 1818 1819 1820 1821 1822 1823 1824 1825 1826 1827 1828 1829 1830 1831 1832 1833 1834 1835 1836 1837 1838 1839 1840 1841 1842 1843 1844 1845 1846 1847 1848 1849 1850 1851 1852 1853 1854 1855 1856 1857 1858 1859 1860 1861 1862 1863 1864 1865 1866 1867 1868 1869 1870 1871 1872 1873 1874 1875 1876 1877 1878 1879 1880 1881 1882 1883 1884 1885 1886 1887 1888 1889 1890 1891 1892 1893 1894 1895 1896 1897 1898 1899 1900 1901 1902 1903 1904 1905 1906 1907 1908 1909 1910 1911 1912 1913 1914 1915 1916 1917 1918 1919 1920 1921 1922 1923 1924 1925 1926 1927 1928 1929 1930 1931 1932 1933 1934 1935 1936 1937 1938 1939 1940 1941 1942 1943 1944 1945 1946 1947 1948 1949 1950 1951 1952 1953 1954 1955 1956 1957 1958 1959 1960 1961 1962 1963 1964 1965 1966 1967 1968 1969 1970 1971 1972 1973 1974 1975 1976 1977 1978 1979 1980 1981 1982 1983 1984 1985 1986 1987 1988 1989 1990 1991 1992 1993 1994 1995 1996 1997 1998 1999 2000 2001 2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 2014 2015 2016 2017 2018 2019 2020 2021 2022 2023 2024 2025 2026 2027 2028 2029 2030 2031 2032 2033 2034 2035 2036 2037 2038 2039 2040 2041 2042 2043 2044 2045 2046 2047 2048 2049 2050 2051 2052 2053 2054 2055 2056 2057 2058 2059 2060 2061 2062 2063 2064 2065 2066 2067 2068 2069 2070 2071 2072 2073 2074 2075 2076 2077 2078 2079 2080 2081 2082 2083 2084 2085 2086 2087 2088 2089 2090 2091 2092 2093 2094 2095 2096 2097 2098 2099 2100 2101 2102 2103 2104 2105 2106 2107 2108 2109 2110 2111 2112 2113 2114 2115 2116 2117 2118 2119 2120 2121 2122 2123 2124 2125 2126 2127 2128 2129 2130 2131 2132 2133 2134 2135 2136 2137 2138 2139 2140 2141 2142 2143 2144 2145 2146 2147 2148 2149 2150 2151 2152 2153 2154 2155 2156 2157 2158 2159 2160 2161 2162 2163 2164 2165 2166 2167 2168 2169 2170 2171 2172 2173 2174 2175 2176 2177 2178 2179 2180 2181 2182 2183 2184 2185 2186 2187 2188 2189 2190 2191 2192 2193 2194 2195 2196 2197 2198 2199 2200 2201 2202 2203 2204 2205 2206 2207 2208 2209 2210 2211 2212 2213 2214 2215 2216 2217 2218 2219 2220 2221 2222 2223 2224 2225 2226 2227 2228 2229 2230 2231 2232 2233 2234 2235 2236 2237 2238 2239 2240 2241 2242 2243 2244 2245 2246 2247 2248 2249 2250 2251 2252 2253 2254 2255 2256 2257 2258 2259 2260 2261 2262 2263 2264 2265 2266 2267 2268 2269 2270 2271 2272 2273 2274 2275 2276 2277 2278 2279 2280 2281 2282 2283 2284 2285 2286 2287 2288 2289 2290 2291 2292 2293 2294 2295 2296 2297 2298 2299 2300 2301 2302 2303 2304 2305 2306 2307 2308 2309 2310 2311 2312 2313 2314 2315 2316 2317 2318 2319 2320 2321 2322 2323 2324 2325 2326 2327 2328 2329 2330 2331 2332 2333 2334 2335 2336 2337 2338 2339 2340 2341 2342 2343 2344 2345 2346 2347 2348 2349 2350 2351 2352 2353 2354 2355 2356 2357 2358 2359 2360 2361 2362 2363 2364 2365 2366 2367 2368 2369 2370 2371 2372 2373 2374 2375 2376 2377 2378 2379 2380 2381 2382 2383 2384 2385 2386 2387 2388 2389 2390 2391 2392 2393 2394 2395 2396 2397 2398 2399 2400 2401 2402 2403 2404 2405 2406 2407 2408 2409 2410 2411 2412 2413 2414 2415 2416 2417 2418 2419 2420 2421 2422 2423 2424 2425 2426 2427 2428 2429 2430 2431 2432 2433 2434 2435 2436 2437 2438 2439 2440 2441 2442 2443 2444 2445 2446 2447 2448 2449 2450 2451 2452 2453 2454 2455 2456 2457 2458 2459 2460 2461 2462 2463 2464 2465 2466 2467 2468 2469 2470 2471 2472 2473 2474 2475 2476 2477 2478 2479 2480 2481 2482 2483 2484 2485 2486 2487 2488 2489 2490 2491 2492 2493 2494 2495 2496 2497 2498 2499 2500 2501 2502 2503 2504 2505 2506 2507 2508 2509 2510 2511 2512 2513 2514 2515 2516 2517 2518 2519 2520 2521 2522 2523 2524 2525 2526 2527 2528 2529 2530 2531 2532 2533 2534 2535 2536 2537 2538 2539 2540 2541 2542 2543 2544 2545 2546 2547 2548 2549 2550 2551 2552 2553 2554 2555 2556 2557 2558 2559 2560 2561 2562 2563 2564 2565 2566 2567 2568 2569 2570 2571 2572 2573 2574 2575 2576 2577 2578 2579 2580 2581 2582 2583 2584 2585 2586 2587 2588 2589 2590 2591 2592 2593 2594 2595 2596 2597 2598 2599 2600 2601 2602 2603 2604 2605 2606 2607 2608 2609 2610 2611 2612 2613 2614 2615 2616 2617 2618 2619 2620 2621 2622 2623 2624 2625 2626 2627 2628 2629 2630 2631 2632 2633 2634 2635 2636 2637 2638 2639 2640 2641 2642 2643 2644 | <?xml version="1.0" encoding="ascii"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<title>configobj</title>
<link rel="stylesheet" href="epydoc.css" type="text/css" />
<script type="text/javascript" src="epydoc.js"></script>
</head>
<body bgcolor="white" text="black" link="blue" vlink="#204080"
alink="#204080">
<!-- ==================== NAVIGATION BAR ==================== -->
<table class="navbar" border="0" width="100%" cellpadding="0"
bgcolor="#a0c0ff" cellspacing="0">
<tr valign="middle">
<!-- Home link -->
<th bgcolor="#70b0f0" class="navbar-select"
> Home </th>
<!-- Tree link -->
<th> <a
href="module-tree.html">Trees</a> </th>
<!-- Index link -->
<th> <a
href="identifier-index.html">Indices</a> </th>
<!-- Help link -->
<th> <a
href="help.html">Help</a> </th>
<!-- Project homepage -->
<th class="navbar" align="right" width="100%">
<table border="0" cellpadding="0" cellspacing="0">
<tr><th class="navbar" align="center"
><a class="navbar" target="_top" href="http://www.voidspace.org.uk/python/configobj.html">ConfigObj</a></th>
</tr></table></th>
</tr>
</table>
<table width="100%" cellpadding="0" cellspacing="0">
<tr valign="top">
<td width="100%">
<span class="breadcrumbs">
Module configobj
</span>
</td>
<td>
<table cellpadding="0" cellspacing="0">
<!-- hide/show private -->
<tr><td align="right"><span class="options">[<a href="javascript:void(0);" class="privatelink"
onclick="toggle_private();">hide private</a>]</span></td></tr>
<tr><td align="right"><span class="options"
>[<a href="frames.html" target="_top">frames</a
>] | <a href="configobj-pysrc.html"
target="_top">no frames</a>]</span></td></tr>
</table>
</td>
</tr>
</table>
<h1 class="epydoc">Source Code for <a href="configobj-module.html">Module configobj</a></h1>
<pre class="py-src">
<a name="L1"></a><tt class="py-lineno"> 1</tt> <tt class="py-line"><tt class="py-comment"># configobj.py</tt> </tt>
<a name="L2"></a><tt class="py-lineno"> 2</tt> <tt class="py-line"><tt class="py-comment"># A config file reader/writer that supports nested sections in config files.</tt> </tt>
<a name="L3"></a><tt class="py-lineno"> 3</tt> <tt class="py-line"><tt class="py-comment"># Copyright (C) 2005-2010 Michael Foord, Nicola Larosa</tt> </tt>
<a name="L4"></a><tt class="py-lineno"> 4</tt> <tt class="py-line"><tt class="py-comment"># E-mail: fuzzyman AT voidspace DOT org DOT uk</tt> </tt>
<a name="L5"></a><tt class="py-lineno"> 5</tt> <tt class="py-line"><tt class="py-comment"># nico AT tekNico DOT net</tt> </tt>
<a name="L6"></a><tt class="py-lineno"> 6</tt> <tt class="py-line"> </tt>
<a name="L7"></a><tt class="py-lineno"> 7</tt> <tt class="py-line"><tt class="py-comment"># ConfigObj 4</tt> </tt>
<a name="L8"></a><tt class="py-lineno"> 8</tt> <tt class="py-line"><tt class="py-comment"># http://www.voidspace.org.uk/python/configobj.html</tt> </tt>
<a name="L9"></a><tt class="py-lineno"> 9</tt> <tt class="py-line"> </tt>
<a name="L10"></a><tt class="py-lineno"> 10</tt> <tt class="py-line"><tt class="py-comment"># Released subject to the BSD License</tt> </tt>
<a name="L11"></a><tt class="py-lineno"> 11</tt> <tt class="py-line"><tt class="py-comment"># Please see http://www.voidspace.org.uk/python/license.shtml</tt> </tt>
<a name="L12"></a><tt class="py-lineno"> 12</tt> <tt class="py-line"> </tt>
<a name="L13"></a><tt class="py-lineno"> 13</tt> <tt class="py-line"><tt class="py-comment"># Scripts maintained at http://www.voidspace.org.uk/python/index.shtml</tt> </tt>
<a name="L14"></a><tt class="py-lineno"> 14</tt> <tt class="py-line"><tt class="py-comment"># For information about bugfixes, updates and support, please join the</tt> </tt>
<a name="L15"></a><tt class="py-lineno"> 15</tt> <tt class="py-line"><tt class="py-comment"># ConfigObj mailing list:</tt> </tt>
<a name="L16"></a><tt class="py-lineno"> 16</tt> <tt class="py-line"><tt class="py-comment"># http://lists.sourceforge.net/lists/listinfo/configobj-develop</tt> </tt>
<a name="L17"></a><tt class="py-lineno"> 17</tt> <tt class="py-line"><tt class="py-comment"># Comments, suggestions and bug reports welcome.</tt> </tt>
<a name="L18"></a><tt class="py-lineno"> 18</tt> <tt class="py-line"> </tt>
<a name="L19"></a><tt class="py-lineno"> 19</tt> <tt class="py-line"><tt class="py-keyword">from</tt> <tt class="py-name">__future__</tt> <tt class="py-keyword">import</tt> <tt class="py-name">generators</tt> </tt>
<a name="L20"></a><tt class="py-lineno"> 20</tt> <tt class="py-line"> </tt>
<a name="L21"></a><tt class="py-lineno"> 21</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">os</tt> </tt>
<a name="L22"></a><tt class="py-lineno"> 22</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">re</tt> </tt>
<a name="L23"></a><tt class="py-lineno"> 23</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">sys</tt> </tt>
<a name="L24"></a><tt class="py-lineno"> 24</tt> <tt class="py-line"> </tt>
<a name="L25"></a><tt class="py-lineno"> 25</tt> <tt class="py-line"><tt class="py-keyword">from</tt> <tt class="py-name">codecs</tt> <tt class="py-keyword">import</tt> <tt class="py-name">BOM_UTF8</tt><tt class="py-op">,</tt> <tt class="py-name">BOM_UTF16</tt><tt class="py-op">,</tt> <tt class="py-name">BOM_UTF16_BE</tt><tt class="py-op">,</tt> <tt class="py-name">BOM_UTF16_LE</tt> </tt>
<a name="L26"></a><tt class="py-lineno"> 26</tt> <tt class="py-line"> </tt>
<a name="L27"></a><tt class="py-lineno"> 27</tt> <tt class="py-line"> </tt>
<a name="L28"></a><tt class="py-lineno"> 28</tt> <tt class="py-line"><tt class="py-comment"># imported lazily to avoid startup performance hit if it isn't used</tt> </tt>
<a name="L29"></a><tt class="py-lineno"> 29</tt> <tt class="py-line"><tt id="link-0" class="py-name" targets="Variable configobj.compiler=configobj-module.html#compiler"><a title="configobj.compiler" class="py-name" href="#" onclick="return doclink('link-0', 'compiler', 'link-0');">compiler</a></tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
<a name="L30"></a><tt class="py-lineno"> 30</tt> <tt class="py-line"> </tt>
<a name="L31"></a><tt class="py-lineno"> 31</tt> <tt class="py-line"><tt class="py-comment"># A dictionary mapping BOM to</tt> </tt>
<a name="L32"></a><tt class="py-lineno"> 32</tt> <tt class="py-line"><tt class="py-comment"># the encoding to decode with, and what to set the</tt> </tt>
<a name="L33"></a><tt class="py-lineno"> 33</tt> <tt class="py-line"><tt class="py-comment"># encoding attribute to.</tt> </tt>
<a name="L34"></a><tt class="py-lineno"> 34</tt> <tt class="py-line"><tt id="link-1" class="py-name" targets="Variable configobj.BOMS=configobj-module.html#BOMS"><a title="configobj.BOMS" class="py-name" href="#" onclick="return doclink('link-1', 'BOMS', 'link-1');">BOMS</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt>
<a name="L35"></a><tt class="py-lineno"> 35</tt> <tt class="py-line"> <tt class="py-name">BOM_UTF8</tt><tt class="py-op">:</tt> <tt class="py-op">(</tt><tt class="py-string">'utf_8'</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt>
<a name="L36"></a><tt class="py-lineno"> 36</tt> <tt class="py-line"> <tt class="py-name">BOM_UTF16_BE</tt><tt class="py-op">:</tt> <tt class="py-op">(</tt><tt class="py-string">'utf16_be'</tt><tt class="py-op">,</tt> <tt class="py-string">'utf_16'</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt>
<a name="L37"></a><tt class="py-lineno"> 37</tt> <tt class="py-line"> <tt class="py-name">BOM_UTF16_LE</tt><tt class="py-op">:</tt> <tt class="py-op">(</tt><tt class="py-string">'utf16_le'</tt><tt class="py-op">,</tt> <tt class="py-string">'utf_16'</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt>
<a name="L38"></a><tt class="py-lineno"> 38</tt> <tt class="py-line"> <tt class="py-name">BOM_UTF16</tt><tt class="py-op">:</tt> <tt class="py-op">(</tt><tt class="py-string">'utf_16'</tt><tt class="py-op">,</tt> <tt class="py-string">'utf_16'</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt>
<a name="L39"></a><tt class="py-lineno"> 39</tt> <tt class="py-line"> <tt class="py-op">}</tt> </tt>
<a name="L40"></a><tt class="py-lineno"> 40</tt> <tt class="py-line"><tt class="py-comment"># All legal variants of the BOM codecs.</tt> </tt>
<a name="L41"></a><tt class="py-lineno"> 41</tt> <tt class="py-line"><tt class="py-comment"># TODO: the list of aliases is not meant to be exhaustive, is there a</tt> </tt>
<a name="L42"></a><tt class="py-lineno"> 42</tt> <tt class="py-line"><tt class="py-comment"># better way ?</tt> </tt>
<a name="L43"></a><tt class="py-lineno"> 43</tt> <tt class="py-line"><tt id="link-2" class="py-name" targets="Variable configobj.BOM_LIST=configobj-module.html#BOM_LIST"><a title="configobj.BOM_LIST" class="py-name" href="#" onclick="return doclink('link-2', 'BOM_LIST', 'link-2');">BOM_LIST</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt>
<a name="L44"></a><tt class="py-lineno"> 44</tt> <tt class="py-line"> <tt class="py-string">'utf_16'</tt><tt class="py-op">:</tt> <tt class="py-string">'utf_16'</tt><tt class="py-op">,</tt> </tt>
<a name="L45"></a><tt class="py-lineno"> 45</tt> <tt class="py-line"> <tt class="py-string">'u16'</tt><tt class="py-op">:</tt> <tt class="py-string">'utf_16'</tt><tt class="py-op">,</tt> </tt>
<a name="L46"></a><tt class="py-lineno"> 46</tt> <tt class="py-line"> <tt class="py-string">'utf16'</tt><tt class="py-op">:</tt> <tt class="py-string">'utf_16'</tt><tt class="py-op">,</tt> </tt>
<a name="L47"></a><tt class="py-lineno"> 47</tt> <tt class="py-line"> <tt class="py-string">'utf-16'</tt><tt class="py-op">:</tt> <tt class="py-string">'utf_16'</tt><tt class="py-op">,</tt> </tt>
<a name="L48"></a><tt class="py-lineno"> 48</tt> <tt class="py-line"> <tt class="py-string">'utf16_be'</tt><tt class="py-op">:</tt> <tt class="py-string">'utf16_be'</tt><tt class="py-op">,</tt> </tt>
<a name="L49"></a><tt class="py-lineno"> 49</tt> <tt class="py-line"> <tt class="py-string">'utf_16_be'</tt><tt class="py-op">:</tt> <tt class="py-string">'utf16_be'</tt><tt class="py-op">,</tt> </tt>
<a name="L50"></a><tt class="py-lineno"> 50</tt> <tt class="py-line"> <tt class="py-string">'utf-16be'</tt><tt class="py-op">:</tt> <tt class="py-string">'utf16_be'</tt><tt class="py-op">,</tt> </tt>
<a name="L51"></a><tt class="py-lineno"> 51</tt> <tt class="py-line"> <tt class="py-string">'utf16_le'</tt><tt class="py-op">:</tt> <tt class="py-string">'utf16_le'</tt><tt class="py-op">,</tt> </tt>
<a name="L52"></a><tt class="py-lineno"> 52</tt> <tt class="py-line"> <tt class="py-string">'utf_16_le'</tt><tt class="py-op">:</tt> <tt class="py-string">'utf16_le'</tt><tt class="py-op">,</tt> </tt>
<a name="L53"></a><tt class="py-lineno"> 53</tt> <tt class="py-line"> <tt class="py-string">'utf-16le'</tt><tt class="py-op">:</tt> <tt class="py-string">'utf16_le'</tt><tt class="py-op">,</tt> </tt>
<a name="L54"></a><tt class="py-lineno"> 54</tt> <tt class="py-line"> <tt class="py-string">'utf_8'</tt><tt class="py-op">:</tt> <tt class="py-string">'utf_8'</tt><tt class="py-op">,</tt> </tt>
<a name="L55"></a><tt class="py-lineno"> 55</tt> <tt class="py-line"> <tt class="py-string">'u8'</tt><tt class="py-op">:</tt> <tt class="py-string">'utf_8'</tt><tt class="py-op">,</tt> </tt>
<a name="L56"></a><tt class="py-lineno"> 56</tt> <tt class="py-line"> <tt class="py-string">'utf'</tt><tt class="py-op">:</tt> <tt class="py-string">'utf_8'</tt><tt class="py-op">,</tt> </tt>
<a name="L57"></a><tt class="py-lineno"> 57</tt> <tt class="py-line"> <tt class="py-string">'utf8'</tt><tt class="py-op">:</tt> <tt class="py-string">'utf_8'</tt><tt class="py-op">,</tt> </tt>
<a name="L58"></a><tt class="py-lineno"> 58</tt> <tt class="py-line"> <tt class="py-string">'utf-8'</tt><tt class="py-op">:</tt> <tt class="py-string">'utf_8'</tt><tt class="py-op">,</tt> </tt>
<a name="L59"></a><tt class="py-lineno"> 59</tt> <tt class="py-line"> <tt class="py-op">}</tt> </tt>
<a name="L60"></a><tt class="py-lineno"> 60</tt> <tt class="py-line"> </tt>
<a name="L61"></a><tt class="py-lineno"> 61</tt> <tt class="py-line"><tt class="py-comment"># Map of encodings to the BOM to write.</tt> </tt>
<a name="L62"></a><tt class="py-lineno"> 62</tt> <tt class="py-line"><tt id="link-3" class="py-name" targets="Variable configobj.BOM_SET=configobj-module.html#BOM_SET"><a title="configobj.BOM_SET" class="py-name" href="#" onclick="return doclink('link-3', 'BOM_SET', 'link-3');">BOM_SET</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt>
<a name="L63"></a><tt class="py-lineno"> 63</tt> <tt class="py-line"> <tt class="py-string">'utf_8'</tt><tt class="py-op">:</tt> <tt class="py-name">BOM_UTF8</tt><tt class="py-op">,</tt> </tt>
<a name="L64"></a><tt class="py-lineno"> 64</tt> <tt class="py-line"> <tt class="py-string">'utf_16'</tt><tt class="py-op">:</tt> <tt class="py-name">BOM_UTF16</tt><tt class="py-op">,</tt> </tt>
<a name="L65"></a><tt class="py-lineno"> 65</tt> <tt class="py-line"> <tt class="py-string">'utf16_be'</tt><tt class="py-op">:</tt> <tt class="py-name">BOM_UTF16_BE</tt><tt class="py-op">,</tt> </tt>
<a name="L66"></a><tt class="py-lineno"> 66</tt> <tt class="py-line"> <tt class="py-string">'utf16_le'</tt><tt class="py-op">:</tt> <tt class="py-name">BOM_UTF16_LE</tt><tt class="py-op">,</tt> </tt>
<a name="L67"></a><tt class="py-lineno"> 67</tt> <tt class="py-line"> <tt class="py-name">None</tt><tt class="py-op">:</tt> <tt class="py-name">BOM_UTF8</tt> </tt>
<a name="L68"></a><tt class="py-lineno"> 68</tt> <tt class="py-line"> <tt class="py-op">}</tt> </tt>
<a name="L69"></a><tt class="py-lineno"> 69</tt> <tt class="py-line"> </tt>
<a name="L70"></a><tt class="py-lineno"> 70</tt> <tt class="py-line"> </tt>
<a name="match_utf8"></a><div id="match_utf8-def"><a name="L71"></a><tt class="py-lineno"> 71</tt> <a class="py-toggle" href="#" id="match_utf8-toggle" onclick="return toggle('match_utf8');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj-module.html#match_utf8">match_utf8</a><tt class="py-op">(</tt><tt class="py-param">encoding</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="match_utf8-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="match_utf8-expanded"><a name="L72"></a><tt class="py-lineno"> 72</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-4" class="py-name"><a title="configobj.BOM_LIST" class="py-name" href="#" onclick="return doclink('link-4', 'BOM_LIST', 'link-2');">BOM_LIST</a></tt><tt class="py-op">.</tt><tt id="link-5" class="py-name" targets="Method configobj.Section.get()=configobj.Section-class.html#get"><a title="configobj.Section.get" class="py-name" href="#" onclick="return doclink('link-5', 'get', 'link-5');">get</a></tt><tt class="py-op">(</tt><tt class="py-name">encoding</tt><tt class="py-op">.</tt><tt class="py-name">lower</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-string">'utf_8'</tt> </tt>
</div><a name="L73"></a><tt class="py-lineno"> 73</tt> <tt class="py-line"> </tt>
<a name="L74"></a><tt class="py-lineno"> 74</tt> <tt class="py-line"> </tt>
<a name="L75"></a><tt class="py-lineno"> 75</tt> <tt class="py-line"><tt class="py-comment"># Quote strings used for writing values</tt> </tt>
<a name="L76"></a><tt class="py-lineno"> 76</tt> <tt class="py-line"><tt id="link-6" class="py-name" targets="Variable configobj.squot=configobj-module.html#squot"><a title="configobj.squot" class="py-name" href="#" onclick="return doclink('link-6', 'squot', 'link-6');">squot</a></tt> <tt class="py-op">=</tt> <tt class="py-string">"'%s'"</tt> </tt>
<a name="L77"></a><tt class="py-lineno"> 77</tt> <tt class="py-line"><tt id="link-7" class="py-name" targets="Variable configobj.dquot=configobj-module.html#dquot"><a title="configobj.dquot" class="py-name" href="#" onclick="return doclink('link-7', 'dquot', 'link-7');">dquot</a></tt> <tt class="py-op">=</tt> <tt class="py-string">'"%s"'</tt> </tt>
<a name="L78"></a><tt class="py-lineno"> 78</tt> <tt class="py-line"><tt id="link-8" class="py-name" targets="Variable configobj.noquot=configobj-module.html#noquot"><a title="configobj.noquot" class="py-name" href="#" onclick="return doclink('link-8', 'noquot', 'link-8');">noquot</a></tt> <tt class="py-op">=</tt> <tt class="py-string">"%s"</tt> </tt>
<a name="L79"></a><tt class="py-lineno"> 79</tt> <tt class="py-line"><tt id="link-9" class="py-name" targets="Variable configobj.wspace_plus=configobj-module.html#wspace_plus"><a title="configobj.wspace_plus" class="py-name" href="#" onclick="return doclink('link-9', 'wspace_plus', 'link-9');">wspace_plus</a></tt> <tt class="py-op">=</tt> <tt class="py-string">' \r\n\v\t\'"'</tt> </tt>
<a name="L80"></a><tt class="py-lineno"> 80</tt> <tt class="py-line"><tt id="link-10" class="py-name" targets="Variable configobj.tsquot=configobj-module.html#tsquot"><a title="configobj.tsquot" class="py-name" href="#" onclick="return doclink('link-10', 'tsquot', 'link-10');">tsquot</a></tt> <tt class="py-op">=</tt> <tt class="py-string">'"""%s"""'</tt> </tt>
<a name="L81"></a><tt class="py-lineno"> 81</tt> <tt class="py-line"><tt id="link-11" class="py-name" targets="Variable configobj.tdquot=configobj-module.html#tdquot"><a title="configobj.tdquot" class="py-name" href="#" onclick="return doclink('link-11', 'tdquot', 'link-11');">tdquot</a></tt> <tt class="py-op">=</tt> <tt class="py-string">"'''%s'''"</tt> </tt>
<a name="L82"></a><tt class="py-lineno"> 82</tt> <tt class="py-line"> </tt>
<a name="L83"></a><tt class="py-lineno"> 83</tt> <tt class="py-line"><tt class="py-comment"># Sentinel for use in getattr calls to replace hasattr</tt> </tt>
<a name="L84"></a><tt class="py-lineno"> 84</tt> <tt class="py-line"><tt id="link-12" class="py-name" targets="Variable configobj.MISSING=configobj-module.html#MISSING"><a title="configobj.MISSING" class="py-name" href="#" onclick="return doclink('link-12', 'MISSING', 'link-12');">MISSING</a></tt> <tt class="py-op">=</tt> <tt class="py-name">object</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L85"></a><tt class="py-lineno"> 85</tt> <tt class="py-line"> </tt>
<a name="L86"></a><tt class="py-lineno"> 86</tt> <tt class="py-line"><tt class="py-name">__version__</tt> <tt class="py-op">=</tt> <tt class="py-string">'4.7.2'</tt> </tt>
<a name="L87"></a><tt class="py-lineno"> 87</tt> <tt class="py-line"> </tt>
<a name="L88"></a><tt class="py-lineno"> 88</tt> <tt class="py-line"><tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
<a name="L89"></a><tt class="py-lineno"> 89</tt> <tt class="py-line"> <tt id="link-13" class="py-name" targets="Function configobj.any()=configobj-module.html#any"><a title="configobj.any" class="py-name" href="#" onclick="return doclink('link-13', 'any', 'link-13');">any</a></tt> </tt>
<a name="L90"></a><tt class="py-lineno"> 90</tt> <tt class="py-line"><tt class="py-keyword">except</tt> <tt class="py-name">NameError</tt><tt class="py-op">:</tt> </tt>
<a name="any"></a><div id="any-def"><a name="L91"></a><tt class="py-lineno"> 91</tt> <a class="py-toggle" href="#" id="any-toggle" onclick="return toggle('any');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj-module.html#any">any</a><tt class="py-op">(</tt><tt class="py-param">iterable</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="any-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="any-expanded"><a name="L92"></a><tt class="py-lineno"> 92</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">in</tt> <tt class="py-name">iterable</tt><tt class="py-op">:</tt> </tt>
<a name="L93"></a><tt class="py-lineno"> 93</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">entry</tt><tt class="py-op">:</tt> </tt>
<a name="L94"></a><tt class="py-lineno"> 94</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt>
<a name="L95"></a><tt class="py-lineno"> 95</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt>
</div><a name="L96"></a><tt class="py-lineno"> 96</tt> <tt class="py-line"> </tt>
<a name="L97"></a><tt class="py-lineno"> 97</tt> <tt class="py-line"> </tt>
<a name="L98"></a><tt class="py-lineno"> 98</tt> <tt class="py-line"><tt class="py-name">__all__</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt> </tt>
<a name="L99"></a><tt class="py-lineno"> 99</tt> <tt class="py-line"> <tt class="py-string">'__version__'</tt><tt class="py-op">,</tt> </tt>
<a name="L100"></a><tt class="py-lineno"> 100</tt> <tt class="py-line"> <tt class="py-string">'DEFAULT_INDENT_TYPE'</tt><tt class="py-op">,</tt> </tt>
<a name="L101"></a><tt class="py-lineno"> 101</tt> <tt class="py-line"> <tt class="py-string">'DEFAULT_INTERPOLATION'</tt><tt class="py-op">,</tt> </tt>
<a name="L102"></a><tt class="py-lineno"> 102</tt> <tt class="py-line"> <tt class="py-string">'ConfigObjError'</tt><tt class="py-op">,</tt> </tt>
<a name="L103"></a><tt class="py-lineno"> 103</tt> <tt class="py-line"> <tt class="py-string">'NestingError'</tt><tt class="py-op">,</tt> </tt>
<a name="L104"></a><tt class="py-lineno"> 104</tt> <tt class="py-line"> <tt class="py-string">'ParseError'</tt><tt class="py-op">,</tt> </tt>
<a name="L105"></a><tt class="py-lineno"> 105</tt> <tt class="py-line"> <tt class="py-string">'DuplicateError'</tt><tt class="py-op">,</tt> </tt>
<a name="L106"></a><tt class="py-lineno"> 106</tt> <tt class="py-line"> <tt class="py-string">'ConfigspecError'</tt><tt class="py-op">,</tt> </tt>
<a name="L107"></a><tt class="py-lineno"> 107</tt> <tt class="py-line"> <tt class="py-string">'ConfigObj'</tt><tt class="py-op">,</tt> </tt>
<a name="L108"></a><tt class="py-lineno"> 108</tt> <tt class="py-line"> <tt class="py-string">'SimpleVal'</tt><tt class="py-op">,</tt> </tt>
<a name="L109"></a><tt class="py-lineno"> 109</tt> <tt class="py-line"> <tt class="py-string">'InterpolationError'</tt><tt class="py-op">,</tt> </tt>
<a name="L110"></a><tt class="py-lineno"> 110</tt> <tt class="py-line"> <tt class="py-string">'InterpolationLoopError'</tt><tt class="py-op">,</tt> </tt>
<a name="L111"></a><tt class="py-lineno"> 111</tt> <tt class="py-line"> <tt class="py-string">'MissingInterpolationOption'</tt><tt class="py-op">,</tt> </tt>
<a name="L112"></a><tt class="py-lineno"> 112</tt> <tt class="py-line"> <tt class="py-string">'RepeatSectionError'</tt><tt class="py-op">,</tt> </tt>
<a name="L113"></a><tt class="py-lineno"> 113</tt> <tt class="py-line"> <tt class="py-string">'ReloadError'</tt><tt class="py-op">,</tt> </tt>
<a name="L114"></a><tt class="py-lineno"> 114</tt> <tt class="py-line"> <tt class="py-string">'UnreprError'</tt><tt class="py-op">,</tt> </tt>
<a name="L115"></a><tt class="py-lineno"> 115</tt> <tt class="py-line"> <tt class="py-string">'UnknownType'</tt><tt class="py-op">,</tt> </tt>
<a name="L116"></a><tt class="py-lineno"> 116</tt> <tt class="py-line"> <tt class="py-string">'flatten_errors'</tt><tt class="py-op">,</tt> </tt>
<a name="L117"></a><tt class="py-lineno"> 117</tt> <tt class="py-line"> <tt class="py-string">'get_extra_values'</tt> </tt>
<a name="L118"></a><tt class="py-lineno"> 118</tt> <tt class="py-line"><tt class="py-op">)</tt> </tt>
<a name="L119"></a><tt class="py-lineno"> 119</tt> <tt class="py-line"> </tt>
<a name="L120"></a><tt class="py-lineno"> 120</tt> <tt class="py-line"><tt id="link-14" class="py-name" targets="Variable configobj.DEFAULT_INTERPOLATION=configobj-module.html#DEFAULT_INTERPOLATION"><a title="configobj.DEFAULT_INTERPOLATION" class="py-name" href="#" onclick="return doclink('link-14', 'DEFAULT_INTERPOLATION', 'link-14');">DEFAULT_INTERPOLATION</a></tt> <tt class="py-op">=</tt> <tt class="py-string">'configparser'</tt> </tt>
<a name="L121"></a><tt class="py-lineno"> 121</tt> <tt class="py-line"><tt id="link-15" class="py-name" targets="Variable configobj.DEFAULT_INDENT_TYPE=configobj-module.html#DEFAULT_INDENT_TYPE"><a title="configobj.DEFAULT_INDENT_TYPE" class="py-name" href="#" onclick="return doclink('link-15', 'DEFAULT_INDENT_TYPE', 'link-15');">DEFAULT_INDENT_TYPE</a></tt> <tt class="py-op">=</tt> <tt class="py-string">' '</tt> </tt>
<a name="L122"></a><tt class="py-lineno"> 122</tt> <tt class="py-line"><tt id="link-16" class="py-name" targets="Variable configobj.MAX_INTERPOL_DEPTH=configobj-module.html#MAX_INTERPOL_DEPTH"><a title="configobj.MAX_INTERPOL_DEPTH" class="py-name" href="#" onclick="return doclink('link-16', 'MAX_INTERPOL_DEPTH', 'link-16');">MAX_INTERPOL_DEPTH</a></tt> <tt class="py-op">=</tt> <tt class="py-number">10</tt> </tt>
<a name="L123"></a><tt class="py-lineno"> 123</tt> <tt class="py-line"> </tt>
<a name="L124"></a><tt class="py-lineno"> 124</tt> <tt class="py-line"><tt id="link-17" class="py-name" targets="Variable configobj.OPTION_DEFAULTS=configobj-module.html#OPTION_DEFAULTS"><a title="configobj.OPTION_DEFAULTS" class="py-name" href="#" onclick="return doclink('link-17', 'OPTION_DEFAULTS', 'link-17');">OPTION_DEFAULTS</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt>
<a name="L125"></a><tt class="py-lineno"> 125</tt> <tt class="py-line"> <tt class="py-string">'interpolation'</tt><tt class="py-op">:</tt> <tt class="py-name">True</tt><tt class="py-op">,</tt> </tt>
<a name="L126"></a><tt class="py-lineno"> 126</tt> <tt class="py-line"> <tt class="py-string">'raise_errors'</tt><tt class="py-op">:</tt> <tt class="py-name">False</tt><tt class="py-op">,</tt> </tt>
<a name="L127"></a><tt class="py-lineno"> 127</tt> <tt class="py-line"> <tt class="py-string">'list_values'</tt><tt class="py-op">:</tt> <tt class="py-name">True</tt><tt class="py-op">,</tt> </tt>
<a name="L128"></a><tt class="py-lineno"> 128</tt> <tt class="py-line"> <tt class="py-string">'create_empty'</tt><tt class="py-op">:</tt> <tt class="py-name">False</tt><tt class="py-op">,</tt> </tt>
<a name="L129"></a><tt class="py-lineno"> 129</tt> <tt class="py-line"> <tt class="py-string">'file_error'</tt><tt class="py-op">:</tt> <tt class="py-name">False</tt><tt class="py-op">,</tt> </tt>
<a name="L130"></a><tt class="py-lineno"> 130</tt> <tt class="py-line"> <tt class="py-string">'configspec'</tt><tt class="py-op">:</tt> <tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
<a name="L131"></a><tt class="py-lineno"> 131</tt> <tt class="py-line"> <tt class="py-string">'stringify'</tt><tt class="py-op">:</tt> <tt class="py-name">True</tt><tt class="py-op">,</tt> </tt>
<a name="L132"></a><tt class="py-lineno"> 132</tt> <tt class="py-line"> <tt class="py-comment"># option may be set to one of ('', ' ', '\t')</tt> </tt>
<a name="L133"></a><tt class="py-lineno"> 133</tt> <tt class="py-line"> <tt class="py-string">'indent_type'</tt><tt class="py-op">:</tt> <tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
<a name="L134"></a><tt class="py-lineno"> 134</tt> <tt class="py-line"> <tt class="py-string">'encoding'</tt><tt class="py-op">:</tt> <tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
<a name="L135"></a><tt class="py-lineno"> 135</tt> <tt class="py-line"> <tt class="py-string">'default_encoding'</tt><tt class="py-op">:</tt> <tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
<a name="L136"></a><tt class="py-lineno"> 136</tt> <tt class="py-line"> <tt class="py-string">'unrepr'</tt><tt class="py-op">:</tt> <tt class="py-name">False</tt><tt class="py-op">,</tt> </tt>
<a name="L137"></a><tt class="py-lineno"> 137</tt> <tt class="py-line"> <tt class="py-string">'write_empty_values'</tt><tt class="py-op">:</tt> <tt class="py-name">False</tt><tt class="py-op">,</tt> </tt>
<a name="L138"></a><tt class="py-lineno"> 138</tt> <tt class="py-line"><tt class="py-op">}</tt> </tt>
<a name="L139"></a><tt class="py-lineno"> 139</tt> <tt class="py-line"> </tt>
<a name="L140"></a><tt class="py-lineno"> 140</tt> <tt class="py-line"> </tt>
<a name="L141"></a><tt class="py-lineno"> 141</tt> <tt class="py-line"> </tt>
<a name="getObj"></a><div id="getObj-def"><a name="L142"></a><tt class="py-lineno"> 142</tt> <a class="py-toggle" href="#" id="getObj-toggle" onclick="return toggle('getObj');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj-module.html#getObj">getObj</a><tt class="py-op">(</tt><tt class="py-param">s</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="getObj-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="getObj-expanded"><a name="L143"></a><tt class="py-lineno"> 143</tt> <tt class="py-line"> <tt class="py-keyword">global</tt> <tt id="link-18" class="py-name"><a title="configobj.compiler" class="py-name" href="#" onclick="return doclink('link-18', 'compiler', 'link-0');">compiler</a></tt> </tt>
<a name="L144"></a><tt class="py-lineno"> 144</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-19" class="py-name"><a title="configobj.compiler" class="py-name" href="#" onclick="return doclink('link-19', 'compiler', 'link-0');">compiler</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L145"></a><tt class="py-lineno"> 145</tt> <tt class="py-line"> <tt class="py-keyword">import</tt> <tt id="link-20" class="py-name"><a title="configobj.compiler" class="py-name" href="#" onclick="return doclink('link-20', 'compiler', 'link-0');">compiler</a></tt> </tt>
<a name="L146"></a><tt class="py-lineno"> 146</tt> <tt class="py-line"> <tt class="py-name">s</tt> <tt class="py-op">=</tt> <tt class="py-string">"a="</tt> <tt class="py-op">+</tt> <tt class="py-name">s</tt> </tt>
<a name="L147"></a><tt class="py-lineno"> 147</tt> <tt class="py-line"> <tt class="py-name">p</tt> <tt class="py-op">=</tt> <tt id="link-21" class="py-name"><a title="configobj.compiler" class="py-name" href="#" onclick="return doclink('link-21', 'compiler', 'link-0');">compiler</a></tt><tt class="py-op">.</tt><tt class="py-name">parse</tt><tt class="py-op">(</tt><tt class="py-name">s</tt><tt class="py-op">)</tt> </tt>
<a name="L148"></a><tt class="py-lineno"> 148</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">p</tt><tt class="py-op">.</tt><tt class="py-name">getChildren</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">getChildren</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">getChildren</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt>
</div><a name="L149"></a><tt class="py-lineno"> 149</tt> <tt class="py-line"> </tt>
<a name="L150"></a><tt class="py-lineno"> 150</tt> <tt class="py-line"> </tt>
<a name="UnknownType"></a><div id="UnknownType-def"><a name="L151"></a><tt class="py-lineno"> 151</tt> <a class="py-toggle" href="#" id="UnknownType-toggle" onclick="return toggle('UnknownType');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="configobj.UnknownType-class.html">UnknownType</a><tt class="py-op">(</tt><tt class="py-base-class">Exception</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="UnknownType-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="UnknownType-expanded"><a name="L152"></a><tt class="py-lineno"> 152</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt>
</div><a name="L153"></a><tt class="py-lineno"> 153</tt> <tt class="py-line"> </tt>
<a name="L154"></a><tt class="py-lineno"> 154</tt> <tt class="py-line"> </tt>
<a name="Builder"></a><div id="Builder-def"><a name="L155"></a><tt class="py-lineno"> 155</tt> <a class="py-toggle" href="#" id="Builder-toggle" onclick="return toggle('Builder');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="configobj.Builder-class.html">Builder</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Builder-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="Builder-expanded"><a name="L156"></a><tt class="py-lineno"> 156</tt> <tt class="py-line"> </tt>
<a name="Builder.build"></a><div id="Builder.build-def"><a name="L157"></a><tt class="py-lineno"> 157</tt> <a class="py-toggle" href="#" id="Builder.build-toggle" onclick="return toggle('Builder.build');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Builder-class.html#build">build</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">o</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Builder.build-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Builder.build-expanded"><a name="L158"></a><tt class="py-lineno"> 158</tt> <tt class="py-line"> <tt class="py-name">m</tt> <tt class="py-op">=</tt> <tt class="py-name">getattr</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-string">'build_'</tt> <tt class="py-op">+</tt> <tt class="py-name">o</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt class="py-name">__name__</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt> </tt>
<a name="L159"></a><tt class="py-lineno"> 159</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">m</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L160"></a><tt class="py-lineno"> 160</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-22" class="py-name" targets="Class configobj.UnknownType=configobj.UnknownType-class.html"><a title="configobj.UnknownType" class="py-name" href="#" onclick="return doclink('link-22', 'UnknownType', 'link-22');">UnknownType</a></tt><tt class="py-op">(</tt><tt class="py-name">o</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt class="py-name">__name__</tt><tt class="py-op">)</tt> </tt>
<a name="L161"></a><tt class="py-lineno"> 161</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">m</tt><tt class="py-op">(</tt><tt class="py-name">o</tt><tt class="py-op">)</tt> </tt>
</div><a name="L162"></a><tt class="py-lineno"> 162</tt> <tt class="py-line"> </tt>
<a name="Builder.build_List"></a><div id="Builder.build_List-def"><a name="L163"></a><tt class="py-lineno"> 163</tt> <a class="py-toggle" href="#" id="Builder.build_List-toggle" onclick="return toggle('Builder.build_List');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Builder-class.html#build_List">build_List</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">o</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Builder.build_List-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Builder.build_List-expanded"><a name="L164"></a><tt class="py-lineno"> 164</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">map</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-23" class="py-name" targets="Method configobj.Builder.build()=configobj.Builder-class.html#build"><a title="configobj.Builder.build" class="py-name" href="#" onclick="return doclink('link-23', 'build', 'link-23');">build</a></tt><tt class="py-op">,</tt> <tt class="py-name">o</tt><tt class="py-op">.</tt><tt class="py-name">getChildren</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
</div><a name="L165"></a><tt class="py-lineno"> 165</tt> <tt class="py-line"> </tt>
<a name="Builder.build_Const"></a><div id="Builder.build_Const-def"><a name="L166"></a><tt class="py-lineno"> 166</tt> <a class="py-toggle" href="#" id="Builder.build_Const-toggle" onclick="return toggle('Builder.build_Const');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Builder-class.html#build_Const">build_Const</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">o</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Builder.build_Const-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Builder.build_Const-expanded"><a name="L167"></a><tt class="py-lineno"> 167</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">o</tt><tt class="py-op">.</tt><tt class="py-name">value</tt> </tt>
</div><a name="L168"></a><tt class="py-lineno"> 168</tt> <tt class="py-line"> </tt>
<a name="Builder.build_Dict"></a><div id="Builder.build_Dict-def"><a name="L169"></a><tt class="py-lineno"> 169</tt> <a class="py-toggle" href="#" id="Builder.build_Dict-toggle" onclick="return toggle('Builder.build_Dict');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Builder-class.html#build_Dict">build_Dict</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">o</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Builder.build_Dict-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Builder.build_Dict-expanded"><a name="L170"></a><tt class="py-lineno"> 170</tt> <tt class="py-line"> <tt class="py-name">d</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
<a name="L171"></a><tt class="py-lineno"> 171</tt> <tt class="py-line"> <tt class="py-name">i</tt> <tt class="py-op">=</tt> <tt class="py-name">iter</tt><tt class="py-op">(</tt><tt class="py-name">map</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-24" class="py-name"><a title="configobj.Builder.build" class="py-name" href="#" onclick="return doclink('link-24', 'build', 'link-23');">build</a></tt><tt class="py-op">,</tt> <tt class="py-name">o</tt><tt class="py-op">.</tt><tt class="py-name">getChildren</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
<a name="L172"></a><tt class="py-lineno"> 172</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">el</tt> <tt class="py-keyword">in</tt> <tt class="py-name">i</tt><tt class="py-op">:</tt> </tt>
<a name="L173"></a><tt class="py-lineno"> 173</tt> <tt class="py-line"> <tt class="py-name">d</tt><tt class="py-op">[</tt><tt class="py-name">el</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">i</tt><tt class="py-op">.</tt><tt class="py-name">next</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L174"></a><tt class="py-lineno"> 174</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">d</tt> </tt>
</div><a name="L175"></a><tt class="py-lineno"> 175</tt> <tt class="py-line"> </tt>
<a name="Builder.build_Tuple"></a><div id="Builder.build_Tuple-def"><a name="L176"></a><tt class="py-lineno"> 176</tt> <a class="py-toggle" href="#" id="Builder.build_Tuple-toggle" onclick="return toggle('Builder.build_Tuple');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Builder-class.html#build_Tuple">build_Tuple</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">o</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Builder.build_Tuple-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Builder.build_Tuple-expanded"><a name="L177"></a><tt class="py-lineno"> 177</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">tuple</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-25" class="py-name" targets="Method configobj.Builder.build_List()=configobj.Builder-class.html#build_List"><a title="configobj.Builder.build_List" class="py-name" href="#" onclick="return doclink('link-25', 'build_List', 'link-25');">build_List</a></tt><tt class="py-op">(</tt><tt class="py-name">o</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
</div><a name="L178"></a><tt class="py-lineno"> 178</tt> <tt class="py-line"> </tt>
<a name="Builder.build_Name"></a><div id="Builder.build_Name-def"><a name="L179"></a><tt class="py-lineno"> 179</tt> <a class="py-toggle" href="#" id="Builder.build_Name-toggle" onclick="return toggle('Builder.build_Name');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Builder-class.html#build_Name">build_Name</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">o</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Builder.build_Name-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Builder.build_Name-expanded"><a name="L180"></a><tt class="py-lineno"> 180</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">o</tt><tt class="py-op">.</tt><tt class="py-name">name</tt> <tt class="py-op">==</tt> <tt class="py-string">'None'</tt><tt class="py-op">:</tt> </tt>
<a name="L181"></a><tt class="py-lineno"> 181</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">None</tt> </tt>
<a name="L182"></a><tt class="py-lineno"> 182</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">o</tt><tt class="py-op">.</tt><tt class="py-name">name</tt> <tt class="py-op">==</tt> <tt class="py-string">'True'</tt><tt class="py-op">:</tt> </tt>
<a name="L183"></a><tt class="py-lineno"> 183</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt>
<a name="L184"></a><tt class="py-lineno"> 184</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">o</tt><tt class="py-op">.</tt><tt class="py-name">name</tt> <tt class="py-op">==</tt> <tt class="py-string">'False'</tt><tt class="py-op">:</tt> </tt>
<a name="L185"></a><tt class="py-lineno"> 185</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt>
<a name="L186"></a><tt class="py-lineno"> 186</tt> <tt class="py-line"> </tt>
<a name="L187"></a><tt class="py-lineno"> 187</tt> <tt class="py-line"> <tt class="py-comment"># An undefined Name</tt> </tt>
<a name="L188"></a><tt class="py-lineno"> 188</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-26" class="py-name"><a title="configobj.UnknownType" class="py-name" href="#" onclick="return doclink('link-26', 'UnknownType', 'link-22');">UnknownType</a></tt><tt class="py-op">(</tt><tt class="py-string">'Undefined Name'</tt><tt class="py-op">)</tt> </tt>
</div><a name="L189"></a><tt class="py-lineno"> 189</tt> <tt class="py-line"> </tt>
<a name="Builder.build_Add"></a><div id="Builder.build_Add-def"><a name="L190"></a><tt class="py-lineno"> 190</tt> <a class="py-toggle" href="#" id="Builder.build_Add-toggle" onclick="return toggle('Builder.build_Add');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Builder-class.html#build_Add">build_Add</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">o</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Builder.build_Add-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Builder.build_Add-expanded"><a name="L191"></a><tt class="py-lineno"> 191</tt> <tt class="py-line"> <tt class="py-name">real</tt><tt class="py-op">,</tt> <tt class="py-name">imag</tt> <tt class="py-op">=</tt> <tt class="py-name">map</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-27" class="py-name" targets="Method configobj.Builder.build_Const()=configobj.Builder-class.html#build_Const"><a title="configobj.Builder.build_Const" class="py-name" href="#" onclick="return doclink('link-27', 'build_Const', 'link-27');">build_Const</a></tt><tt class="py-op">,</tt> <tt class="py-name">o</tt><tt class="py-op">.</tt><tt class="py-name">getChildren</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
<a name="L192"></a><tt class="py-lineno"> 192</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
<a name="L193"></a><tt class="py-lineno"> 193</tt> <tt class="py-line"> <tt class="py-name">real</tt> <tt class="py-op">=</tt> <tt class="py-name">float</tt><tt class="py-op">(</tt><tt class="py-name">real</tt><tt class="py-op">)</tt> </tt>
<a name="L194"></a><tt class="py-lineno"> 194</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">TypeError</tt><tt class="py-op">:</tt> </tt>
<a name="L195"></a><tt class="py-lineno"> 195</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-28" class="py-name"><a title="configobj.UnknownType" class="py-name" href="#" onclick="return doclink('link-28', 'UnknownType', 'link-22');">UnknownType</a></tt><tt class="py-op">(</tt><tt class="py-string">'Add'</tt><tt class="py-op">)</tt> </tt>
<a name="L196"></a><tt class="py-lineno"> 196</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">imag</tt><tt class="py-op">,</tt> <tt class="py-name">complex</tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> <tt class="py-name">imag</tt><tt class="py-op">.</tt><tt class="py-name">real</tt> <tt class="py-op">!=</tt> <tt class="py-number">0.0</tt><tt class="py-op">:</tt> </tt>
<a name="L197"></a><tt class="py-lineno"> 197</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-29" class="py-name"><a title="configobj.UnknownType" class="py-name" href="#" onclick="return doclink('link-29', 'UnknownType', 'link-22');">UnknownType</a></tt><tt class="py-op">(</tt><tt class="py-string">'Add'</tt><tt class="py-op">)</tt> </tt>
<a name="L198"></a><tt class="py-lineno"> 198</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">real</tt><tt class="py-op">+</tt><tt class="py-name">imag</tt> </tt>
</div><a name="L199"></a><tt class="py-lineno"> 199</tt> <tt class="py-line"> </tt>
<a name="Builder.build_Getattr"></a><div id="Builder.build_Getattr-def"><a name="L200"></a><tt class="py-lineno"> 200</tt> <a class="py-toggle" href="#" id="Builder.build_Getattr-toggle" onclick="return toggle('Builder.build_Getattr');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Builder-class.html#build_Getattr">build_Getattr</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">o</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Builder.build_Getattr-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Builder.build_Getattr-expanded"><a name="L201"></a><tt class="py-lineno"> 201</tt> <tt class="py-line"> <tt class="py-name">parent</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-30" class="py-name"><a title="configobj.Builder.build" class="py-name" href="#" onclick="return doclink('link-30', 'build', 'link-23');">build</a></tt><tt class="py-op">(</tt><tt class="py-name">o</tt><tt class="py-op">.</tt><tt class="py-name">expr</tt><tt class="py-op">)</tt> </tt>
<a name="L202"></a><tt class="py-lineno"> 202</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">getattr</tt><tt class="py-op">(</tt><tt class="py-name">parent</tt><tt class="py-op">,</tt> <tt class="py-name">o</tt><tt class="py-op">.</tt><tt class="py-name">attrname</tt><tt class="py-op">)</tt> </tt>
</div><a name="L203"></a><tt class="py-lineno"> 203</tt> <tt class="py-line"> </tt>
<a name="Builder.build_UnarySub"></a><div id="Builder.build_UnarySub-def"><a name="L204"></a><tt class="py-lineno"> 204</tt> <a class="py-toggle" href="#" id="Builder.build_UnarySub-toggle" onclick="return toggle('Builder.build_UnarySub');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Builder-class.html#build_UnarySub">build_UnarySub</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">o</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Builder.build_UnarySub-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Builder.build_UnarySub-expanded"><a name="L205"></a><tt class="py-lineno"> 205</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">-</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-31" class="py-name"><a title="configobj.Builder.build_Const" class="py-name" href="#" onclick="return doclink('link-31', 'build_Const', 'link-27');">build_Const</a></tt><tt class="py-op">(</tt><tt class="py-name">o</tt><tt class="py-op">.</tt><tt class="py-name">getChildren</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
</div><a name="L206"></a><tt class="py-lineno"> 206</tt> <tt class="py-line"> </tt>
<a name="Builder.build_UnaryAdd"></a><div id="Builder.build_UnaryAdd-def"><a name="L207"></a><tt class="py-lineno"> 207</tt> <a class="py-toggle" href="#" id="Builder.build_UnaryAdd-toggle" onclick="return toggle('Builder.build_UnaryAdd');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Builder-class.html#build_UnaryAdd">build_UnaryAdd</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">o</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Builder.build_UnaryAdd-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Builder.build_UnaryAdd-expanded"><a name="L208"></a><tt class="py-lineno"> 208</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-32" class="py-name"><a title="configobj.Builder.build_Const" class="py-name" href="#" onclick="return doclink('link-32', 'build_Const', 'link-27');">build_Const</a></tt><tt class="py-op">(</tt><tt class="py-name">o</tt><tt class="py-op">.</tt><tt class="py-name">getChildren</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
</div></div><a name="L209"></a><tt class="py-lineno"> 209</tt> <tt class="py-line"> </tt>
<a name="L210"></a><tt class="py-lineno"> 210</tt> <tt class="py-line"> </tt>
<a name="L211"></a><tt class="py-lineno"> 211</tt> <tt class="py-line"><tt id="link-33" class="py-name" targets="Variable configobj._builder=configobj-module.html#_builder"><a title="configobj._builder" class="py-name" href="#" onclick="return doclink('link-33', '_builder', 'link-33');">_builder</a></tt> <tt class="py-op">=</tt> <tt id="link-34" class="py-name" targets="Class configobj.Builder=configobj.Builder-class.html"><a title="configobj.Builder" class="py-name" href="#" onclick="return doclink('link-34', 'Builder', 'link-34');">Builder</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L212"></a><tt class="py-lineno"> 212</tt> <tt class="py-line"> </tt>
<a name="L213"></a><tt class="py-lineno"> 213</tt> <tt class="py-line"> </tt>
<a name="unrepr"></a><div id="unrepr-def"><a name="L214"></a><tt class="py-lineno"> 214</tt> <a class="py-toggle" href="#" id="unrepr-toggle" onclick="return toggle('unrepr');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj-module.html#unrepr">unrepr</a><tt class="py-op">(</tt><tt class="py-param">s</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="unrepr-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="unrepr-expanded"><a name="L215"></a><tt class="py-lineno"> 215</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">s</tt><tt class="py-op">:</tt> </tt>
<a name="L216"></a><tt class="py-lineno"> 216</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">s</tt> </tt>
<a name="L217"></a><tt class="py-lineno"> 217</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-35" class="py-name"><a title="configobj._builder" class="py-name" href="#" onclick="return doclink('link-35', '_builder', 'link-33');">_builder</a></tt><tt class="py-op">.</tt><tt id="link-36" class="py-name"><a title="configobj.Builder.build" class="py-name" href="#" onclick="return doclink('link-36', 'build', 'link-23');">build</a></tt><tt class="py-op">(</tt><tt id="link-37" class="py-name" targets="Function configobj.getObj()=configobj-module.html#getObj"><a title="configobj.getObj" class="py-name" href="#" onclick="return doclink('link-37', 'getObj', 'link-37');">getObj</a></tt><tt class="py-op">(</tt><tt class="py-name">s</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
</div><a name="L218"></a><tt class="py-lineno"> 218</tt> <tt class="py-line"> </tt>
<a name="L219"></a><tt class="py-lineno"> 219</tt> <tt class="py-line"> </tt>
<a name="L220"></a><tt class="py-lineno"> 220</tt> <tt class="py-line"> </tt>
<a name="ConfigObjError"></a><div id="ConfigObjError-def"><a name="L221"></a><tt class="py-lineno"> 221</tt> <a class="py-toggle" href="#" id="ConfigObjError-toggle" onclick="return toggle('ConfigObjError');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="configobj.ConfigObjError-class.html">ConfigObjError</a><tt class="py-op">(</tt><tt class="py-base-class">SyntaxError</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObjError-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="ConfigObjError-expanded"><a name="L222"></a><tt class="py-lineno"> 222</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L223"></a><tt class="py-lineno"> 223</tt> <tt class="py-line"><tt class="py-docstring"> This is the base class for all errors that ConfigObj raises.</tt> </tt>
<a name="L224"></a><tt class="py-lineno"> 224</tt> <tt class="py-line"><tt class="py-docstring"> It is a subclass of SyntaxError.</tt> </tt>
<a name="L225"></a><tt class="py-lineno"> 225</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="ConfigObjError.__init__"></a><div id="ConfigObjError.__init__-def"><a name="L226"></a><tt class="py-lineno"> 226</tt> <a class="py-toggle" href="#" id="ConfigObjError.__init__-toggle" onclick="return toggle('ConfigObjError.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObjError-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">message</tt><tt class="py-op">=</tt><tt class="py-string">''</tt><tt class="py-op">,</tt> <tt class="py-param">line_number</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">line</tt><tt class="py-op">=</tt><tt class="py-string">''</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObjError.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObjError.__init__-expanded"><a name="L227"></a><tt class="py-lineno"> 227</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">line</tt> <tt class="py-op">=</tt> <tt class="py-name">line</tt> </tt>
<a name="L228"></a><tt class="py-lineno"> 228</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">line_number</tt> <tt class="py-op">=</tt> <tt class="py-name">line_number</tt> </tt>
<a name="L229"></a><tt class="py-lineno"> 229</tt> <tt class="py-line"> <tt class="py-name">SyntaxError</tt><tt class="py-op">.</tt><tt id="link-38" class="py-name" targets="Method configobj.ConfigObj.__init__()=configobj.ConfigObj-class.html#__init__,Method configobj.ConfigObjError.__init__()=configobj.ConfigObjError-class.html#__init__,Method configobj.InterpolationEngine.__init__()=configobj.InterpolationEngine-class.html#__init__,Method configobj.InterpolationLoopError.__init__()=configobj.InterpolationLoopError-class.html#__init__,Method configobj.MissingInterpolationOption.__init__()=configobj.MissingInterpolationOption-class.html#__init__,Method configobj.ReloadError.__init__()=configobj.ReloadError-class.html#__init__,Method configobj.Section.__init__()=configobj.Section-class.html#__init__,Method configobj.SimpleVal.__init__()=configobj.SimpleVal-class.html#__init__"><a title="configobj.ConfigObj.__init__
configobj.ConfigObjError.__init__
configobj.InterpolationEngine.__init__
configobj.InterpolationLoopError.__init__
configobj.MissingInterpolationOption.__init__
configobj.ReloadError.__init__
configobj.Section.__init__
configobj.SimpleVal.__init__" class="py-name" href="#" onclick="return doclink('link-38', '__init__', 'link-38');">__init__</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">message</tt><tt class="py-op">)</tt> </tt>
</div></div><a name="L230"></a><tt class="py-lineno"> 230</tt> <tt class="py-line"> </tt>
<a name="L231"></a><tt class="py-lineno"> 231</tt> <tt class="py-line"> </tt>
<a name="NestingError"></a><div id="NestingError-def"><a name="L232"></a><tt class="py-lineno"> 232</tt> <a class="py-toggle" href="#" id="NestingError-toggle" onclick="return toggle('NestingError');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="configobj.NestingError-class.html">NestingError</a><tt class="py-op">(</tt><tt class="py-base-class">ConfigObjError</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="NestingError-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="NestingError-expanded"><a name="L233"></a><tt class="py-lineno"> 233</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L234"></a><tt class="py-lineno"> 234</tt> <tt class="py-line"><tt class="py-docstring"> This error indicates a level of nesting that doesn't match.</tt> </tt>
<a name="L235"></a><tt class="py-lineno"> 235</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
</div><a name="L236"></a><tt class="py-lineno"> 236</tt> <tt class="py-line"> </tt>
<a name="L237"></a><tt class="py-lineno"> 237</tt> <tt class="py-line"> </tt>
<a name="ParseError"></a><div id="ParseError-def"><a name="L238"></a><tt class="py-lineno"> 238</tt> <a class="py-toggle" href="#" id="ParseError-toggle" onclick="return toggle('ParseError');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="configobj.ParseError-class.html">ParseError</a><tt class="py-op">(</tt><tt class="py-base-class">ConfigObjError</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ParseError-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="ParseError-expanded"><a name="L239"></a><tt class="py-lineno"> 239</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L240"></a><tt class="py-lineno"> 240</tt> <tt class="py-line"><tt class="py-docstring"> This error indicates that a line is badly written.</tt> </tt>
<a name="L241"></a><tt class="py-lineno"> 241</tt> <tt class="py-line"><tt class="py-docstring"> It is neither a valid ``key = value`` line,</tt> </tt>
<a name="L242"></a><tt class="py-lineno"> 242</tt> <tt class="py-line"><tt class="py-docstring"> nor a valid section marker line.</tt> </tt>
<a name="L243"></a><tt class="py-lineno"> 243</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
</div><a name="L244"></a><tt class="py-lineno"> 244</tt> <tt class="py-line"> </tt>
<a name="L245"></a><tt class="py-lineno"> 245</tt> <tt class="py-line"> </tt>
<a name="ReloadError"></a><div id="ReloadError-def"><a name="L246"></a><tt class="py-lineno"> 246</tt> <a class="py-toggle" href="#" id="ReloadError-toggle" onclick="return toggle('ReloadError');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="configobj.ReloadError-class.html">ReloadError</a><tt class="py-op">(</tt><tt class="py-base-class">IOError</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ReloadError-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="ReloadError-expanded"><a name="L247"></a><tt class="py-lineno"> 247</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L248"></a><tt class="py-lineno"> 248</tt> <tt class="py-line"><tt class="py-docstring"> A 'reload' operation failed.</tt> </tt>
<a name="L249"></a><tt class="py-lineno"> 249</tt> <tt class="py-line"><tt class="py-docstring"> This exception is a subclass of ``IOError``.</tt> </tt>
<a name="L250"></a><tt class="py-lineno"> 250</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="ReloadError.__init__"></a><div id="ReloadError.__init__-def"><a name="L251"></a><tt class="py-lineno"> 251</tt> <a class="py-toggle" href="#" id="ReloadError.__init__-toggle" onclick="return toggle('ReloadError.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ReloadError-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ReloadError.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ReloadError.__init__-expanded"><a name="L252"></a><tt class="py-lineno"> 252</tt> <tt class="py-line"> <tt class="py-name">IOError</tt><tt class="py-op">.</tt><tt id="link-39" class="py-name"><a title="configobj.ConfigObj.__init__
configobj.ConfigObjError.__init__
configobj.InterpolationEngine.__init__
configobj.InterpolationLoopError.__init__
configobj.MissingInterpolationOption.__init__
configobj.ReloadError.__init__
configobj.Section.__init__
configobj.SimpleVal.__init__" class="py-name" href="#" onclick="return doclink('link-39', '__init__', 'link-38');">__init__</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-string">'reload failed, filename is not set.'</tt><tt class="py-op">)</tt> </tt>
</div></div><a name="L253"></a><tt class="py-lineno"> 253</tt> <tt class="py-line"> </tt>
<a name="L254"></a><tt class="py-lineno"> 254</tt> <tt class="py-line"> </tt>
<a name="DuplicateError"></a><div id="DuplicateError-def"><a name="L255"></a><tt class="py-lineno"> 255</tt> <a class="py-toggle" href="#" id="DuplicateError-toggle" onclick="return toggle('DuplicateError');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="configobj.DuplicateError-class.html">DuplicateError</a><tt class="py-op">(</tt><tt class="py-base-class">ConfigObjError</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="DuplicateError-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="DuplicateError-expanded"><a name="L256"></a><tt class="py-lineno"> 256</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L257"></a><tt class="py-lineno"> 257</tt> <tt class="py-line"><tt class="py-docstring"> The keyword or section specified already exists.</tt> </tt>
<a name="L258"></a><tt class="py-lineno"> 258</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
</div><a name="L259"></a><tt class="py-lineno"> 259</tt> <tt class="py-line"> </tt>
<a name="L260"></a><tt class="py-lineno"> 260</tt> <tt class="py-line"> </tt>
<a name="ConfigspecError"></a><div id="ConfigspecError-def"><a name="L261"></a><tt class="py-lineno"> 261</tt> <a class="py-toggle" href="#" id="ConfigspecError-toggle" onclick="return toggle('ConfigspecError');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="configobj.ConfigspecError-class.html">ConfigspecError</a><tt class="py-op">(</tt><tt class="py-base-class">ConfigObjError</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigspecError-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="ConfigspecError-expanded"><a name="L262"></a><tt class="py-lineno"> 262</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L263"></a><tt class="py-lineno"> 263</tt> <tt class="py-line"><tt class="py-docstring"> An error occured whilst parsing a configspec.</tt> </tt>
<a name="L264"></a><tt class="py-lineno"> 264</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
</div><a name="L265"></a><tt class="py-lineno"> 265</tt> <tt class="py-line"> </tt>
<a name="L266"></a><tt class="py-lineno"> 266</tt> <tt class="py-line"> </tt>
<a name="InterpolationError"></a><div id="InterpolationError-def"><a name="L267"></a><tt class="py-lineno"> 267</tt> <a class="py-toggle" href="#" id="InterpolationError-toggle" onclick="return toggle('InterpolationError');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="configobj.InterpolationError-class.html">InterpolationError</a><tt class="py-op">(</tt><tt class="py-base-class">ConfigObjError</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="InterpolationError-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="InterpolationError-expanded"><a name="L268"></a><tt class="py-lineno"> 268</tt> <tt class="py-line"> <tt class="py-docstring">"""Base class for the two interpolation errors."""</tt> </tt>
</div><a name="L269"></a><tt class="py-lineno"> 269</tt> <tt class="py-line"> </tt>
<a name="L270"></a><tt class="py-lineno"> 270</tt> <tt class="py-line"> </tt>
<a name="InterpolationLoopError"></a><div id="InterpolationLoopError-def"><a name="L271"></a><tt class="py-lineno"> 271</tt> <a class="py-toggle" href="#" id="InterpolationLoopError-toggle" onclick="return toggle('InterpolationLoopError');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="configobj.InterpolationLoopError-class.html">InterpolationLoopError</a><tt class="py-op">(</tt><tt class="py-base-class">InterpolationError</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="InterpolationLoopError-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="InterpolationLoopError-expanded"><a name="L272"></a><tt class="py-lineno"> 272</tt> <tt class="py-line"> <tt class="py-docstring">"""Maximum interpolation depth exceeded in string interpolation."""</tt> </tt>
<a name="L273"></a><tt class="py-lineno"> 273</tt> <tt class="py-line"> </tt>
<a name="InterpolationLoopError.__init__"></a><div id="InterpolationLoopError.__init__-def"><a name="L274"></a><tt class="py-lineno"> 274</tt> <a class="py-toggle" href="#" id="InterpolationLoopError.__init__-toggle" onclick="return toggle('InterpolationLoopError.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.InterpolationLoopError-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">option</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="InterpolationLoopError.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="InterpolationLoopError.__init__-expanded"><a name="L275"></a><tt class="py-lineno"> 275</tt> <tt class="py-line"> <tt id="link-40" class="py-name" targets="Class configobj.InterpolationError=configobj.InterpolationError-class.html"><a title="configobj.InterpolationError" class="py-name" href="#" onclick="return doclink('link-40', 'InterpolationError', 'link-40');">InterpolationError</a></tt><tt class="py-op">.</tt><tt id="link-41" class="py-name"><a title="configobj.ConfigObj.__init__
configobj.ConfigObjError.__init__
configobj.InterpolationEngine.__init__
configobj.InterpolationLoopError.__init__
configobj.MissingInterpolationOption.__init__
configobj.ReloadError.__init__
configobj.Section.__init__
configobj.SimpleVal.__init__" class="py-name" href="#" onclick="return doclink('link-41', '__init__', 'link-38');">__init__</a></tt><tt class="py-op">(</tt> </tt>
<a name="L276"></a><tt class="py-lineno"> 276</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">,</tt> </tt>
<a name="L277"></a><tt class="py-lineno"> 277</tt> <tt class="py-line"> <tt class="py-string">'interpolation loop detected in value "%s".'</tt> <tt class="py-op">%</tt> <tt class="py-name">option</tt><tt class="py-op">)</tt> </tt>
</div></div><a name="L278"></a><tt class="py-lineno"> 278</tt> <tt class="py-line"> </tt>
<a name="L279"></a><tt class="py-lineno"> 279</tt> <tt class="py-line"> </tt>
<a name="RepeatSectionError"></a><div id="RepeatSectionError-def"><a name="L280"></a><tt class="py-lineno"> 280</tt> <a class="py-toggle" href="#" id="RepeatSectionError-toggle" onclick="return toggle('RepeatSectionError');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="configobj.RepeatSectionError-class.html">RepeatSectionError</a><tt class="py-op">(</tt><tt class="py-base-class">ConfigObjError</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="RepeatSectionError-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="RepeatSectionError-expanded"><a name="L281"></a><tt class="py-lineno"> 281</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L282"></a><tt class="py-lineno"> 282</tt> <tt class="py-line"><tt class="py-docstring"> This error indicates additional sections in a section with a</tt> </tt>
<a name="L283"></a><tt class="py-lineno"> 283</tt> <tt class="py-line"><tt class="py-docstring"> ``__many__`` (repeated) section.</tt> </tt>
<a name="L284"></a><tt class="py-lineno"> 284</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
</div><a name="L285"></a><tt class="py-lineno"> 285</tt> <tt class="py-line"> </tt>
<a name="L286"></a><tt class="py-lineno"> 286</tt> <tt class="py-line"> </tt>
<a name="MissingInterpolationOption"></a><div id="MissingInterpolationOption-def"><a name="L287"></a><tt class="py-lineno"> 287</tt> <a class="py-toggle" href="#" id="MissingInterpolationOption-toggle" onclick="return toggle('MissingInterpolationOption');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="configobj.MissingInterpolationOption-class.html">MissingInterpolationOption</a><tt class="py-op">(</tt><tt class="py-base-class">InterpolationError</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="MissingInterpolationOption-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="MissingInterpolationOption-expanded"><a name="L288"></a><tt class="py-lineno"> 288</tt> <tt class="py-line"> <tt class="py-docstring">"""A value specified for interpolation was missing."""</tt> </tt>
<a name="MissingInterpolationOption.__init__"></a><div id="MissingInterpolationOption.__init__-def"><a name="L289"></a><tt class="py-lineno"> 289</tt> <a class="py-toggle" href="#" id="MissingInterpolationOption.__init__-toggle" onclick="return toggle('MissingInterpolationOption.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.MissingInterpolationOption-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">option</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="MissingInterpolationOption.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="MissingInterpolationOption.__init__-expanded"><a name="L290"></a><tt class="py-lineno"> 290</tt> <tt class="py-line"> <tt class="py-name">msg</tt> <tt class="py-op">=</tt> <tt class="py-string">'missing option "%s" in interpolation.'</tt> <tt class="py-op">%</tt> <tt class="py-name">option</tt> </tt>
<a name="L291"></a><tt class="py-lineno"> 291</tt> <tt class="py-line"> <tt id="link-42" class="py-name"><a title="configobj.InterpolationError" class="py-name" href="#" onclick="return doclink('link-42', 'InterpolationError', 'link-40');">InterpolationError</a></tt><tt class="py-op">.</tt><tt id="link-43" class="py-name"><a title="configobj.ConfigObj.__init__
configobj.ConfigObjError.__init__
configobj.InterpolationEngine.__init__
configobj.InterpolationLoopError.__init__
configobj.MissingInterpolationOption.__init__
configobj.ReloadError.__init__
configobj.Section.__init__
configobj.SimpleVal.__init__" class="py-name" href="#" onclick="return doclink('link-43', '__init__', 'link-38');">__init__</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">msg</tt><tt class="py-op">)</tt> </tt>
</div></div><a name="L292"></a><tt class="py-lineno"> 292</tt> <tt class="py-line"> </tt>
<a name="L293"></a><tt class="py-lineno"> 293</tt> <tt class="py-line"> </tt>
<a name="UnreprError"></a><div id="UnreprError-def"><a name="L294"></a><tt class="py-lineno"> 294</tt> <a class="py-toggle" href="#" id="UnreprError-toggle" onclick="return toggle('UnreprError');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="configobj.UnreprError-class.html">UnreprError</a><tt class="py-op">(</tt><tt class="py-base-class">ConfigObjError</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="UnreprError-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="UnreprError-expanded"><a name="L295"></a><tt class="py-lineno"> 295</tt> <tt class="py-line"> <tt class="py-docstring">"""An error parsing in unrepr mode."""</tt> </tt>
</div><a name="L296"></a><tt class="py-lineno"> 296</tt> <tt class="py-line"> </tt>
<a name="L297"></a><tt class="py-lineno"> 297</tt> <tt class="py-line"> </tt>
<a name="L298"></a><tt class="py-lineno"> 298</tt> <tt class="py-line"> </tt>
<a name="InterpolationEngine"></a><div id="InterpolationEngine-def"><a name="L299"></a><tt class="py-lineno"> 299</tt> <a class="py-toggle" href="#" id="InterpolationEngine-toggle" onclick="return toggle('InterpolationEngine');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="configobj.InterpolationEngine-class.html">InterpolationEngine</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="InterpolationEngine-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="InterpolationEngine-expanded"><a name="L300"></a><tt class="py-lineno"> 300</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L301"></a><tt class="py-lineno"> 301</tt> <tt class="py-line"><tt class="py-docstring"> A helper class to help perform string interpolation.</tt> </tt>
<a name="L302"></a><tt class="py-lineno"> 302</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt>
<a name="L303"></a><tt class="py-lineno"> 303</tt> <tt class="py-line"><tt class="py-docstring"> This class is an abstract base class; its descendants perform</tt> </tt>
<a name="L304"></a><tt class="py-lineno"> 304</tt> <tt class="py-line"><tt class="py-docstring"> the actual work.</tt> </tt>
<a name="L305"></a><tt class="py-lineno"> 305</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L306"></a><tt class="py-lineno"> 306</tt> <tt class="py-line"> </tt>
<a name="L307"></a><tt class="py-lineno"> 307</tt> <tt class="py-line"> <tt class="py-comment"># compiled regexp to use in self.interpolate()</tt> </tt>
<a name="L308"></a><tt class="py-lineno"> 308</tt> <tt class="py-line"> <tt id="link-44" class="py-name" targets="Variable configobj.ConfigParserInterpolation._KEYCRE=configobj.ConfigParserInterpolation-class.html#_KEYCRE,Variable configobj.InterpolationEngine._KEYCRE=configobj.InterpolationEngine-class.html#_KEYCRE,Variable configobj.TemplateInterpolation._KEYCRE=configobj.TemplateInterpolation-class.html#_KEYCRE"><a title="configobj.ConfigParserInterpolation._KEYCRE
configobj.InterpolationEngine._KEYCRE
configobj.TemplateInterpolation._KEYCRE" class="py-name" href="#" onclick="return doclink('link-44', '_KEYCRE', 'link-44');">_KEYCRE</a></tt> <tt class="py-op">=</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">compile</tt><tt class="py-op">(</tt><tt class="py-string">r"%\(([^)]*)\)s"</tt><tt class="py-op">)</tt> </tt>
<a name="L309"></a><tt class="py-lineno"> 309</tt> <tt class="py-line"> <tt id="link-45" class="py-name" targets="Variable configobj.ConfigParserInterpolation._cookie=configobj.ConfigParserInterpolation-class.html#_cookie,Variable configobj.InterpolationEngine._cookie=configobj.InterpolationEngine-class.html#_cookie,Variable configobj.TemplateInterpolation._cookie=configobj.TemplateInterpolation-class.html#_cookie"><a title="configobj.ConfigParserInterpolation._cookie
configobj.InterpolationEngine._cookie
configobj.TemplateInterpolation._cookie" class="py-name" href="#" onclick="return doclink('link-45', '_cookie', 'link-45');">_cookie</a></tt> <tt class="py-op">=</tt> <tt class="py-string">'%'</tt> </tt>
<a name="L310"></a><tt class="py-lineno"> 310</tt> <tt class="py-line"> </tt>
<a name="InterpolationEngine.__init__"></a><div id="InterpolationEngine.__init__-def"><a name="L311"></a><tt class="py-lineno"> 311</tt> <a class="py-toggle" href="#" id="InterpolationEngine.__init__-toggle" onclick="return toggle('InterpolationEngine.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.InterpolationEngine-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">section</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="InterpolationEngine.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="InterpolationEngine.__init__-expanded"><a name="L312"></a><tt class="py-lineno"> 312</tt> <tt class="py-line"> <tt class="py-comment"># the Section instance that "owns" this engine</tt> </tt>
<a name="L313"></a><tt class="py-lineno"> 313</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">section</tt> <tt class="py-op">=</tt> <tt class="py-name">section</tt> </tt>
</div><a name="L314"></a><tt class="py-lineno"> 314</tt> <tt class="py-line"> </tt>
<a name="L315"></a><tt class="py-lineno"> 315</tt> <tt class="py-line"> </tt>
<a name="InterpolationEngine.interpolate"></a><div id="InterpolationEngine.interpolate-def"><a name="L316"></a><tt class="py-lineno"> 316</tt> <a class="py-toggle" href="#" id="InterpolationEngine.interpolate-toggle" onclick="return toggle('InterpolationEngine.interpolate');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.InterpolationEngine-class.html#interpolate">interpolate</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">key</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="InterpolationEngine.interpolate-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="InterpolationEngine.interpolate-expanded"><a name="L317"></a><tt class="py-lineno"> 317</tt> <tt class="py-line"> <tt class="py-comment"># short-cut</tt> </tt>
<a name="L318"></a><tt class="py-lineno"> 318</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-46" class="py-name"><a title="configobj.ConfigParserInterpolation._cookie
configobj.InterpolationEngine._cookie
configobj.TemplateInterpolation._cookie" class="py-name" href="#" onclick="return doclink('link-46', '_cookie', 'link-45');">_cookie</a></tt> <tt class="py-keyword">in</tt> <tt class="py-name">value</tt><tt class="py-op">:</tt> </tt>
<a name="L319"></a><tt class="py-lineno"> 319</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">value</tt> </tt>
<a name="L320"></a><tt class="py-lineno"> 320</tt> <tt class="py-line"> </tt>
<a name="L321"></a><tt class="py-lineno"> 321</tt> <tt class="py-line"> <tt class="py-keyword">def</tt> <tt class="py-def-name">recursive_interpolate</tt><tt class="py-op">(</tt><tt class="py-param">key</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">,</tt> <tt class="py-param">section</tt><tt class="py-op">,</tt> <tt class="py-param">backtrail</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L322"></a><tt class="py-lineno"> 322</tt> <tt class="py-line"> <tt class="py-docstring">"""The function that does the actual work.</tt> </tt>
<a name="L323"></a><tt class="py-lineno"> 323</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt>
<a name="L324"></a><tt class="py-lineno"> 324</tt> <tt class="py-line"><tt class="py-docstring"> ``value``: the string we're trying to interpolate.</tt> </tt>
<a name="L325"></a><tt class="py-lineno"> 325</tt> <tt class="py-line"><tt class="py-docstring"> ``section``: the section in which that string was found</tt> </tt>
<a name="L326"></a><tt class="py-lineno"> 326</tt> <tt class="py-line"><tt class="py-docstring"> ``backtrail``: a dict to keep track of where we've been,</tt> </tt>
<a name="L327"></a><tt class="py-lineno"> 327</tt> <tt class="py-line"><tt class="py-docstring"> to detect and prevent infinite recursion loops</tt> </tt>
<a name="L328"></a><tt class="py-lineno"> 328</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt>
<a name="L329"></a><tt class="py-lineno"> 329</tt> <tt class="py-line"><tt class="py-docstring"> This is similar to a depth-first-search algorithm.</tt> </tt>
<a name="L330"></a><tt class="py-lineno"> 330</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L331"></a><tt class="py-lineno"> 331</tt> <tt class="py-line"> <tt class="py-comment"># Have we been here already?</tt> </tt>
<a name="L332"></a><tt class="py-lineno"> 332</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">name</tt><tt class="py-op">)</tt> <tt class="py-keyword">in</tt> <tt class="py-name">backtrail</tt><tt class="py-op">:</tt> </tt>
<a name="L333"></a><tt class="py-lineno"> 333</tt> <tt class="py-line"> <tt class="py-comment"># Yes - infinite loop detected</tt> </tt>
<a name="L334"></a><tt class="py-lineno"> 334</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-47" class="py-name" targets="Class configobj.InterpolationLoopError=configobj.InterpolationLoopError-class.html"><a title="configobj.InterpolationLoopError" class="py-name" href="#" onclick="return doclink('link-47', 'InterpolationLoopError', 'link-47');">InterpolationLoopError</a></tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<a name="L335"></a><tt class="py-lineno"> 335</tt> <tt class="py-line"> <tt class="py-comment"># Place a marker on our backtrail so we won't come back here again</tt> </tt>
<a name="L336"></a><tt class="py-lineno"> 336</tt> <tt class="py-line"> <tt class="py-name">backtrail</tt><tt class="py-op">[</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">name</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-number">1</tt> </tt>
<a name="L337"></a><tt class="py-lineno"> 337</tt> <tt class="py-line"> </tt>
<a name="L338"></a><tt class="py-lineno"> 338</tt> <tt class="py-line"> <tt class="py-comment"># Now start the actual work</tt> </tt>
<a name="L339"></a><tt class="py-lineno"> 339</tt> <tt class="py-line"> <tt class="py-name">match</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-48" class="py-name"><a title="configobj.ConfigParserInterpolation._KEYCRE
configobj.InterpolationEngine._KEYCRE
configobj.TemplateInterpolation._KEYCRE" class="py-name" href="#" onclick="return doclink('link-48', '_KEYCRE', 'link-44');">_KEYCRE</a></tt><tt class="py-op">.</tt><tt class="py-name">search</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
<a name="L340"></a><tt class="py-lineno"> 340</tt> <tt class="py-line"> <tt class="py-keyword">while</tt> <tt class="py-name">match</tt><tt class="py-op">:</tt> </tt>
<a name="L341"></a><tt class="py-lineno"> 341</tt> <tt class="py-line"> <tt class="py-comment"># The actual parsing of the match is implementation-dependent,</tt> </tt>
<a name="L342"></a><tt class="py-lineno"> 342</tt> <tt class="py-line"> <tt class="py-comment"># so delegate to our helper function</tt> </tt>
<a name="L343"></a><tt class="py-lineno"> 343</tt> <tt class="py-line"> <tt class="py-name">k</tt><tt class="py-op">,</tt> <tt class="py-name">v</tt><tt class="py-op">,</tt> <tt class="py-name">s</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-49" class="py-name" targets="Method configobj.ConfigParserInterpolation._parse_match()=configobj.ConfigParserInterpolation-class.html#_parse_match,Method configobj.InterpolationEngine._parse_match()=configobj.InterpolationEngine-class.html#_parse_match,Method configobj.TemplateInterpolation._parse_match()=configobj.TemplateInterpolation-class.html#_parse_match"><a title="configobj.ConfigParserInterpolation._parse_match
configobj.InterpolationEngine._parse_match
configobj.TemplateInterpolation._parse_match" class="py-name" href="#" onclick="return doclink('link-49', '_parse_match', 'link-49');">_parse_match</a></tt><tt class="py-op">(</tt><tt class="py-name">match</tt><tt class="py-op">)</tt> </tt>
<a name="L344"></a><tt class="py-lineno"> 344</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">k</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L345"></a><tt class="py-lineno"> 345</tt> <tt class="py-line"> <tt class="py-comment"># That's the signal that no further interpolation is needed</tt> </tt>
<a name="L346"></a><tt class="py-lineno"> 346</tt> <tt class="py-line"> <tt class="py-name">replacement</tt> <tt class="py-op">=</tt> <tt class="py-name">v</tt> </tt>
<a name="L347"></a><tt class="py-lineno"> 347</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L348"></a><tt class="py-lineno"> 348</tt> <tt class="py-line"> <tt class="py-comment"># Further interpolation may be needed to obtain final value</tt> </tt>
<a name="L349"></a><tt class="py-lineno"> 349</tt> <tt class="py-line"> <tt class="py-name">replacement</tt> <tt class="py-op">=</tt> <tt class="py-name">recursive_interpolate</tt><tt class="py-op">(</tt><tt class="py-name">k</tt><tt class="py-op">,</tt> <tt class="py-name">v</tt><tt class="py-op">,</tt> <tt class="py-name">s</tt><tt class="py-op">,</tt> <tt class="py-name">backtrail</tt><tt class="py-op">)</tt> </tt>
<a name="L350"></a><tt class="py-lineno"> 350</tt> <tt class="py-line"> <tt class="py-comment"># Replace the matched string with its final value</tt> </tt>
<a name="L351"></a><tt class="py-lineno"> 351</tt> <tt class="py-line"> <tt class="py-name">start</tt><tt class="py-op">,</tt> <tt class="py-name">end</tt> <tt class="py-op">=</tt> <tt class="py-name">match</tt><tt class="py-op">.</tt><tt class="py-name">span</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L352"></a><tt class="py-lineno"> 352</tt> <tt class="py-line"> <tt class="py-name">value</tt> <tt class="py-op">=</tt> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">[</tt><tt class="py-op">:</tt><tt class="py-name">start</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">replacement</tt><tt class="py-op">,</tt> <tt class="py-name">value</tt><tt class="py-op">[</tt><tt class="py-name">end</tt><tt class="py-op">:</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
<a name="L353"></a><tt class="py-lineno"> 353</tt> <tt class="py-line"> <tt class="py-name">new_search_start</tt> <tt class="py-op">=</tt> <tt class="py-name">start</tt> <tt class="py-op">+</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">replacement</tt><tt class="py-op">)</tt> </tt>
<a name="L354"></a><tt class="py-lineno"> 354</tt> <tt class="py-line"> <tt class="py-comment"># Pick up the next interpolation key, if any, for next time</tt> </tt>
<a name="L355"></a><tt class="py-lineno"> 355</tt> <tt class="py-line"> <tt class="py-comment"># through the while loop</tt> </tt>
<a name="L356"></a><tt class="py-lineno"> 356</tt> <tt class="py-line"> <tt class="py-name">match</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-50" class="py-name"><a title="configobj.ConfigParserInterpolation._KEYCRE
configobj.InterpolationEngine._KEYCRE
configobj.TemplateInterpolation._KEYCRE" class="py-name" href="#" onclick="return doclink('link-50', '_KEYCRE', 'link-44');">_KEYCRE</a></tt><tt class="py-op">.</tt><tt class="py-name">search</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-name">new_search_start</tt><tt class="py-op">)</tt> </tt>
<a name="L357"></a><tt class="py-lineno"> 357</tt> <tt class="py-line"> </tt>
<a name="L358"></a><tt class="py-lineno"> 358</tt> <tt class="py-line"> <tt class="py-comment"># Now safe to come back here again; remove marker from backtrail</tt> </tt>
<a name="L359"></a><tt class="py-lineno"> 359</tt> <tt class="py-line"> <tt class="py-keyword">del</tt> <tt class="py-name">backtrail</tt><tt class="py-op">[</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">name</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt>
<a name="L360"></a><tt class="py-lineno"> 360</tt> <tt class="py-line"> </tt>
<a name="L361"></a><tt class="py-lineno"> 361</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">value</tt> </tt>
</div><a name="L362"></a><tt class="py-lineno"> 362</tt> <tt class="py-line"> </tt>
<a name="L363"></a><tt class="py-lineno"> 363</tt> <tt class="py-line"> <tt class="py-comment"># Back in interpolate(), all we have to do is kick off the recursive</tt> </tt>
<a name="L364"></a><tt class="py-lineno"> 364</tt> <tt class="py-line"> <tt class="py-comment"># function with appropriate starting values</tt> </tt>
<a name="L365"></a><tt class="py-lineno"> 365</tt> <tt class="py-line"> <tt class="py-name">value</tt> <tt class="py-op">=</tt> <tt class="py-name">recursive_interpolate</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">section</tt><tt class="py-op">,</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt> </tt>
<a name="L366"></a><tt class="py-lineno"> 366</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">value</tt> </tt>
</div><a name="L367"></a><tt class="py-lineno"> 367</tt> <tt class="py-line"> </tt>
<a name="L368"></a><tt class="py-lineno"> 368</tt> <tt class="py-line"> </tt>
<a name="InterpolationEngine._fetch"></a><div id="InterpolationEngine._fetch-def"><a name="L369"></a><tt class="py-lineno"> 369</tt> <a class="py-toggle" href="#" id="InterpolationEngine._fetch-toggle" onclick="return toggle('InterpolationEngine._fetch');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.InterpolationEngine-class.html#_fetch">_fetch</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">key</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="InterpolationEngine._fetch-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="InterpolationEngine._fetch-expanded"><a name="L370"></a><tt class="py-lineno"> 370</tt> <tt class="py-line"> <tt class="py-docstring">"""Helper function to fetch values from owning section.</tt> </tt>
<a name="L371"></a><tt class="py-lineno"> 371</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt>
<a name="L372"></a><tt class="py-lineno"> 372</tt> <tt class="py-line"><tt class="py-docstring"> Returns a 2-tuple: the value, and the section where it was found.</tt> </tt>
<a name="L373"></a><tt class="py-lineno"> 373</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L374"></a><tt class="py-lineno"> 374</tt> <tt class="py-line"> <tt class="py-comment"># switch off interpolation before we try and fetch anything !</tt> </tt>
<a name="L375"></a><tt class="py-lineno"> 375</tt> <tt class="py-line"> <tt class="py-name">save_interp</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">main</tt><tt class="py-op">.</tt><tt class="py-name">interpolation</tt> </tt>
<a name="L376"></a><tt class="py-lineno"> 376</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">main</tt><tt class="py-op">.</tt><tt class="py-name">interpolation</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L377"></a><tt class="py-lineno"> 377</tt> <tt class="py-line"> </tt>
<a name="L378"></a><tt class="py-lineno"> 378</tt> <tt class="py-line"> <tt class="py-comment"># Start at section that "owns" this InterpolationEngine</tt> </tt>
<a name="L379"></a><tt class="py-lineno"> 379</tt> <tt class="py-line"> <tt class="py-name">current_section</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">section</tt> </tt>
<a name="L380"></a><tt class="py-lineno"> 380</tt> <tt class="py-line"> <tt class="py-keyword">while</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt>
<a name="L381"></a><tt class="py-lineno"> 381</tt> <tt class="py-line"> <tt class="py-comment"># try the current section first</tt> </tt>
<a name="L382"></a><tt class="py-lineno"> 382</tt> <tt class="py-line"> <tt class="py-name">val</tt> <tt class="py-op">=</tt> <tt class="py-name">current_section</tt><tt class="py-op">.</tt><tt id="link-51" class="py-name"><a title="configobj.Section.get" class="py-name" href="#" onclick="return doclink('link-51', 'get', 'link-5');">get</a></tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<a name="L383"></a><tt class="py-lineno"> 383</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">val</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt> <tt class="py-keyword">and</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">val</tt><tt class="py-op">,</tt> <tt id="link-52" class="py-name" targets="Class configobj.Section=configobj.Section-class.html"><a title="configobj.Section" class="py-name" href="#" onclick="return doclink('link-52', 'Section', 'link-52');">Section</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L384"></a><tt class="py-lineno"> 384</tt> <tt class="py-line"> <tt class="py-keyword">break</tt> </tt>
<a name="L385"></a><tt class="py-lineno"> 385</tt> <tt class="py-line"> <tt class="py-comment"># try "DEFAULT" next</tt> </tt>
<a name="L386"></a><tt class="py-lineno"> 386</tt> <tt class="py-line"> <tt class="py-name">val</tt> <tt class="py-op">=</tt> <tt class="py-name">current_section</tt><tt class="py-op">.</tt><tt id="link-53" class="py-name"><a title="configobj.Section.get" class="py-name" href="#" onclick="return doclink('link-53', 'get', 'link-5');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'DEFAULT'</tt><tt class="py-op">,</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-54" class="py-name"><a title="configobj.Section.get" class="py-name" href="#" onclick="return doclink('link-54', 'get', 'link-5');">get</a></tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<a name="L387"></a><tt class="py-lineno"> 387</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">val</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt> <tt class="py-keyword">and</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">val</tt><tt class="py-op">,</tt> <tt id="link-55" class="py-name"><a title="configobj.Section" class="py-name" href="#" onclick="return doclink('link-55', 'Section', 'link-52');">Section</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L388"></a><tt class="py-lineno"> 388</tt> <tt class="py-line"> <tt class="py-keyword">break</tt> </tt>
<a name="L389"></a><tt class="py-lineno"> 389</tt> <tt class="py-line"> <tt class="py-comment"># move up to parent and try again</tt> </tt>
<a name="L390"></a><tt class="py-lineno"> 390</tt> <tt class="py-line"> <tt class="py-comment"># top-level's parent is itself</tt> </tt>
<a name="L391"></a><tt class="py-lineno"> 391</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">current_section</tt><tt class="py-op">.</tt><tt class="py-name">parent</tt> <tt class="py-keyword">is</tt> <tt class="py-name">current_section</tt><tt class="py-op">:</tt> </tt>
<a name="L392"></a><tt class="py-lineno"> 392</tt> <tt class="py-line"> <tt class="py-comment"># reached top level, time to give up</tt> </tt>
<a name="L393"></a><tt class="py-lineno"> 393</tt> <tt class="py-line"> <tt class="py-keyword">break</tt> </tt>
<a name="L394"></a><tt class="py-lineno"> 394</tt> <tt class="py-line"> <tt class="py-name">current_section</tt> <tt class="py-op">=</tt> <tt class="py-name">current_section</tt><tt class="py-op">.</tt><tt class="py-name">parent</tt> </tt>
<a name="L395"></a><tt class="py-lineno"> 395</tt> <tt class="py-line"> </tt>
<a name="L396"></a><tt class="py-lineno"> 396</tt> <tt class="py-line"> <tt class="py-comment"># restore interpolation to previous value before returning</tt> </tt>
<a name="L397"></a><tt class="py-lineno"> 397</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">main</tt><tt class="py-op">.</tt><tt class="py-name">interpolation</tt> <tt class="py-op">=</tt> <tt class="py-name">save_interp</tt> </tt>
<a name="L398"></a><tt class="py-lineno"> 398</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">val</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L399"></a><tt class="py-lineno"> 399</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-56" class="py-name" targets="Class configobj.MissingInterpolationOption=configobj.MissingInterpolationOption-class.html"><a title="configobj.MissingInterpolationOption" class="py-name" href="#" onclick="return doclink('link-56', 'MissingInterpolationOption', 'link-56');">MissingInterpolationOption</a></tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<a name="L400"></a><tt class="py-lineno"> 400</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">val</tt><tt class="py-op">,</tt> <tt class="py-name">current_section</tt> </tt>
</div><a name="L401"></a><tt class="py-lineno"> 401</tt> <tt class="py-line"> </tt>
<a name="L402"></a><tt class="py-lineno"> 402</tt> <tt class="py-line"> </tt>
<a name="InterpolationEngine._parse_match"></a><div id="InterpolationEngine._parse_match-def"><a name="L403"></a><tt class="py-lineno"> 403</tt> <a class="py-toggle" href="#" id="InterpolationEngine._parse_match-toggle" onclick="return toggle('InterpolationEngine._parse_match');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.InterpolationEngine-class.html#_parse_match">_parse_match</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">match</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="InterpolationEngine._parse_match-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="InterpolationEngine._parse_match-expanded"><a name="L404"></a><tt class="py-lineno"> 404</tt> <tt class="py-line"> <tt class="py-docstring">"""Implementation-dependent helper function.</tt> </tt>
<a name="L405"></a><tt class="py-lineno"> 405</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt>
<a name="L406"></a><tt class="py-lineno"> 406</tt> <tt class="py-line"><tt class="py-docstring"> Will be passed a match object corresponding to the interpolation</tt> </tt>
<a name="L407"></a><tt class="py-lineno"> 407</tt> <tt class="py-line"><tt class="py-docstring"> key we just found (e.g., "%(foo)s" or "$foo"). Should look up that</tt> </tt>
<a name="L408"></a><tt class="py-lineno"> 408</tt> <tt class="py-line"><tt class="py-docstring"> key in the appropriate config file section (using the ``_fetch()``</tt> </tt>
<a name="L409"></a><tt class="py-lineno"> 409</tt> <tt class="py-line"><tt class="py-docstring"> helper function) and return a 3-tuple: (key, value, section)</tt> </tt>
<a name="L410"></a><tt class="py-lineno"> 410</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt>
<a name="L411"></a><tt class="py-lineno"> 411</tt> <tt class="py-line"><tt class="py-docstring"> ``key`` is the name of the key we're looking for</tt> </tt>
<a name="L412"></a><tt class="py-lineno"> 412</tt> <tt class="py-line"><tt class="py-docstring"> ``value`` is the value found for that key</tt> </tt>
<a name="L413"></a><tt class="py-lineno"> 413</tt> <tt class="py-line"><tt class="py-docstring"> ``section`` is a reference to the section where it was found</tt> </tt>
<a name="L414"></a><tt class="py-lineno"> 414</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt>
<a name="L415"></a><tt class="py-lineno"> 415</tt> <tt class="py-line"><tt class="py-docstring"> ``key`` and ``section`` should be None if no further</tt> </tt>
<a name="L416"></a><tt class="py-lineno"> 416</tt> <tt class="py-line"><tt class="py-docstring"> interpolation should be performed on the resulting value</tt> </tt>
<a name="L417"></a><tt class="py-lineno"> 417</tt> <tt class="py-line"><tt class="py-docstring"> (e.g., if we interpolated "$$" and returned "$").</tt> </tt>
<a name="L418"></a><tt class="py-lineno"> 418</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L419"></a><tt class="py-lineno"> 419</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">NotImplementedError</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
</div></div><a name="L420"></a><tt class="py-lineno"> 420</tt> <tt class="py-line"> </tt>
<a name="L421"></a><tt class="py-lineno"> 421</tt> <tt class="py-line"> </tt>
<a name="L422"></a><tt class="py-lineno"> 422</tt> <tt class="py-line"> </tt>
<a name="ConfigParserInterpolation"></a><div id="ConfigParserInterpolation-def"><a name="L423"></a><tt class="py-lineno"> 423</tt> <a class="py-toggle" href="#" id="ConfigParserInterpolation-toggle" onclick="return toggle('ConfigParserInterpolation');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="configobj.ConfigParserInterpolation-class.html">ConfigParserInterpolation</a><tt class="py-op">(</tt><tt class="py-base-class">InterpolationEngine</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigParserInterpolation-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="ConfigParserInterpolation-expanded"><a name="L424"></a><tt class="py-lineno"> 424</tt> <tt class="py-line"> <tt class="py-docstring">"""Behaves like ConfigParser."""</tt> </tt>
<a name="L425"></a><tt class="py-lineno"> 425</tt> <tt class="py-line"> <tt id="link-57" class="py-name"><a title="configobj.ConfigParserInterpolation._cookie
configobj.InterpolationEngine._cookie
configobj.TemplateInterpolation._cookie" class="py-name" href="#" onclick="return doclink('link-57', '_cookie', 'link-45');">_cookie</a></tt> <tt class="py-op">=</tt> <tt class="py-string">'%'</tt> </tt>
<a name="L426"></a><tt class="py-lineno"> 426</tt> <tt class="py-line"> <tt id="link-58" class="py-name"><a title="configobj.ConfigParserInterpolation._KEYCRE
configobj.InterpolationEngine._KEYCRE
configobj.TemplateInterpolation._KEYCRE" class="py-name" href="#" onclick="return doclink('link-58', '_KEYCRE', 'link-44');">_KEYCRE</a></tt> <tt class="py-op">=</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">compile</tt><tt class="py-op">(</tt><tt class="py-string">r"%\(([^)]*)\)s"</tt><tt class="py-op">)</tt> </tt>
<a name="L427"></a><tt class="py-lineno"> 427</tt> <tt class="py-line"> </tt>
<a name="ConfigParserInterpolation._parse_match"></a><div id="ConfigParserInterpolation._parse_match-def"><a name="L428"></a><tt class="py-lineno"> 428</tt> <a class="py-toggle" href="#" id="ConfigParserInterpolation._parse_match-toggle" onclick="return toggle('ConfigParserInterpolation._parse_match');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigParserInterpolation-class.html#_parse_match">_parse_match</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">match</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigParserInterpolation._parse_match-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigParserInterpolation._parse_match-expanded"><a name="L429"></a><tt class="py-lineno"> 429</tt> <tt class="py-line"> <tt class="py-name">key</tt> <tt class="py-op">=</tt> <tt class="py-name">match</tt><tt class="py-op">.</tt><tt class="py-name">group</tt><tt class="py-op">(</tt><tt class="py-number">1</tt><tt class="py-op">)</tt> </tt>
<a name="L430"></a><tt class="py-lineno"> 430</tt> <tt class="py-line"> <tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-name">section</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-59" class="py-name" targets="Method configobj.InterpolationEngine._fetch()=configobj.InterpolationEngine-class.html#_fetch"><a title="configobj.InterpolationEngine._fetch" class="py-name" href="#" onclick="return doclink('link-59', '_fetch', 'link-59');">_fetch</a></tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<a name="L431"></a><tt class="py-lineno"> 431</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-name">section</tt> </tt>
</div></div><a name="L432"></a><tt class="py-lineno"> 432</tt> <tt class="py-line"> </tt>
<a name="L433"></a><tt class="py-lineno"> 433</tt> <tt class="py-line"> </tt>
<a name="L434"></a><tt class="py-lineno"> 434</tt> <tt class="py-line"> </tt>
<a name="TemplateInterpolation"></a><div id="TemplateInterpolation-def"><a name="L435"></a><tt class="py-lineno"> 435</tt> <a class="py-toggle" href="#" id="TemplateInterpolation-toggle" onclick="return toggle('TemplateInterpolation');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="configobj.TemplateInterpolation-class.html">TemplateInterpolation</a><tt class="py-op">(</tt><tt class="py-base-class">InterpolationEngine</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="TemplateInterpolation-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="TemplateInterpolation-expanded"><a name="L436"></a><tt class="py-lineno"> 436</tt> <tt class="py-line"> <tt class="py-docstring">"""Behaves like string.Template."""</tt> </tt>
<a name="L437"></a><tt class="py-lineno"> 437</tt> <tt class="py-line"> <tt id="link-60" class="py-name"><a title="configobj.ConfigParserInterpolation._cookie
configobj.InterpolationEngine._cookie
configobj.TemplateInterpolation._cookie" class="py-name" href="#" onclick="return doclink('link-60', '_cookie', 'link-45');">_cookie</a></tt> <tt class="py-op">=</tt> <tt class="py-string">'$'</tt> </tt>
<a name="L438"></a><tt class="py-lineno"> 438</tt> <tt class="py-line"> <tt id="link-61" class="py-name" targets="Variable configobj.TemplateInterpolation._delimiter=configobj.TemplateInterpolation-class.html#_delimiter"><a title="configobj.TemplateInterpolation._delimiter" class="py-name" href="#" onclick="return doclink('link-61', '_delimiter', 'link-61');">_delimiter</a></tt> <tt class="py-op">=</tt> <tt class="py-string">'$'</tt> </tt>
<a name="L439"></a><tt class="py-lineno"> 439</tt> <tt class="py-line"> <tt id="link-62" class="py-name"><a title="configobj.ConfigParserInterpolation._KEYCRE
configobj.InterpolationEngine._KEYCRE
configobj.TemplateInterpolation._KEYCRE" class="py-name" href="#" onclick="return doclink('link-62', '_KEYCRE', 'link-44');">_KEYCRE</a></tt> <tt class="py-op">=</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">compile</tt><tt class="py-op">(</tt><tt class="py-string">r"""</tt> </tt>
<a name="L440"></a><tt class="py-lineno"> 440</tt> <tt class="py-line"><tt class="py-string"> \$(?:</tt> </tt>
<a name="L441"></a><tt class="py-lineno"> 441</tt> <tt class="py-line"><tt class="py-string"> (?P<escaped>\$) | # Two $ signs</tt> </tt>
<a name="L442"></a><tt class="py-lineno"> 442</tt> <tt class="py-line"><tt class="py-string"> (?P<named>[_a-z][_a-z0-9]*) | # $name format</tt> </tt>
<a name="L443"></a><tt class="py-lineno"> 443</tt> <tt class="py-line"><tt class="py-string"> {(?P<braced>[^}]*)} # ${name} format</tt> </tt>
<a name="L444"></a><tt class="py-lineno"> 444</tt> <tt class="py-line"><tt class="py-string"> )</tt> </tt>
<a name="L445"></a><tt class="py-lineno"> 445</tt> <tt class="py-line"><tt class="py-string"> """</tt><tt class="py-op">,</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">IGNORECASE</tt> <tt class="py-op">|</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">VERBOSE</tt><tt class="py-op">)</tt> </tt>
<a name="L446"></a><tt class="py-lineno"> 446</tt> <tt class="py-line"> </tt>
<a name="TemplateInterpolation._parse_match"></a><div id="TemplateInterpolation._parse_match-def"><a name="L447"></a><tt class="py-lineno"> 447</tt> <a class="py-toggle" href="#" id="TemplateInterpolation._parse_match-toggle" onclick="return toggle('TemplateInterpolation._parse_match');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.TemplateInterpolation-class.html#_parse_match">_parse_match</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">match</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="TemplateInterpolation._parse_match-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="TemplateInterpolation._parse_match-expanded"><a name="L448"></a><tt class="py-lineno"> 448</tt> <tt class="py-line"> <tt class="py-comment"># Valid name (in or out of braces): fetch value from section</tt> </tt>
<a name="L449"></a><tt class="py-lineno"> 449</tt> <tt class="py-line"> <tt class="py-name">key</tt> <tt class="py-op">=</tt> <tt class="py-name">match</tt><tt class="py-op">.</tt><tt class="py-name">group</tt><tt class="py-op">(</tt><tt class="py-string">'named'</tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> <tt class="py-name">match</tt><tt class="py-op">.</tt><tt class="py-name">group</tt><tt class="py-op">(</tt><tt class="py-string">'braced'</tt><tt class="py-op">)</tt> </tt>
<a name="L450"></a><tt class="py-lineno"> 450</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">key</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L451"></a><tt class="py-lineno"> 451</tt> <tt class="py-line"> <tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-name">section</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-63" class="py-name"><a title="configobj.InterpolationEngine._fetch" class="py-name" href="#" onclick="return doclink('link-63', '_fetch', 'link-59');">_fetch</a></tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<a name="L452"></a><tt class="py-lineno"> 452</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-name">section</tt> </tt>
<a name="L453"></a><tt class="py-lineno"> 453</tt> <tt class="py-line"> <tt class="py-comment"># Escaped delimiter (e.g., $$): return single delimiter</tt> </tt>
<a name="L454"></a><tt class="py-lineno"> 454</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">match</tt><tt class="py-op">.</tt><tt class="py-name">group</tt><tt class="py-op">(</tt><tt class="py-string">'escaped'</tt><tt class="py-op">)</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L455"></a><tt class="py-lineno"> 455</tt> <tt class="py-line"> <tt class="py-comment"># Return None for key and section to indicate it's time to stop</tt> </tt>
<a name="L456"></a><tt class="py-lineno"> 456</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-64" class="py-name"><a title="configobj.TemplateInterpolation._delimiter" class="py-name" href="#" onclick="return doclink('link-64', '_delimiter', 'link-61');">_delimiter</a></tt><tt class="py-op">,</tt> <tt class="py-name">None</tt> </tt>
<a name="L457"></a><tt class="py-lineno"> 457</tt> <tt class="py-line"> <tt class="py-comment"># Anything else: ignore completely, just return it unchanged</tt> </tt>
<a name="L458"></a><tt class="py-lineno"> 458</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-name">match</tt><tt class="py-op">.</tt><tt class="py-name">group</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt> </tt>
</div></div><a name="L459"></a><tt class="py-lineno"> 459</tt> <tt class="py-line"> </tt>
<a name="L460"></a><tt class="py-lineno"> 460</tt> <tt class="py-line"> </tt>
<a name="L461"></a><tt class="py-lineno"> 461</tt> <tt class="py-line"><tt id="link-65" class="py-name" targets="Variable configobj.interpolation_engines=configobj-module.html#interpolation_engines"><a title="configobj.interpolation_engines" class="py-name" href="#" onclick="return doclink('link-65', 'interpolation_engines', 'link-65');">interpolation_engines</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt>
<a name="L462"></a><tt class="py-lineno"> 462</tt> <tt class="py-line"> <tt class="py-string">'configparser'</tt><tt class="py-op">:</tt> <tt id="link-66" class="py-name" targets="Class configobj.ConfigParserInterpolation=configobj.ConfigParserInterpolation-class.html"><a title="configobj.ConfigParserInterpolation" class="py-name" href="#" onclick="return doclink('link-66', 'ConfigParserInterpolation', 'link-66');">ConfigParserInterpolation</a></tt><tt class="py-op">,</tt> </tt>
<a name="L463"></a><tt class="py-lineno"> 463</tt> <tt class="py-line"> <tt class="py-string">'template'</tt><tt class="py-op">:</tt> <tt id="link-67" class="py-name" targets="Class configobj.TemplateInterpolation=configobj.TemplateInterpolation-class.html"><a title="configobj.TemplateInterpolation" class="py-name" href="#" onclick="return doclink('link-67', 'TemplateInterpolation', 'link-67');">TemplateInterpolation</a></tt><tt class="py-op">,</tt> </tt>
<a name="L464"></a><tt class="py-lineno"> 464</tt> <tt class="py-line"><tt class="py-op">}</tt> </tt>
<a name="L465"></a><tt class="py-lineno"> 465</tt> <tt class="py-line"> </tt>
<a name="L466"></a><tt class="py-lineno"> 466</tt> <tt class="py-line"> </tt>
<a name="__newobj__"></a><div id="__newobj__-def"><a name="L467"></a><tt class="py-lineno"> 467</tt> <a class="py-toggle" href="#" id="__newobj__-toggle" onclick="return toggle('__newobj__');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj-module.html#__newobj__">__newobj__</a><tt class="py-op">(</tt><tt class="py-param">cls</tt><tt class="py-op">,</tt> <tt class="py-op">*</tt><tt class="py-param">args</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="__newobj__-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="__newobj__-expanded"><a name="L468"></a><tt class="py-lineno"> 468</tt> <tt class="py-line"> <tt class="py-comment"># Hack for pickle</tt> </tt>
<a name="L469"></a><tt class="py-lineno"> 469</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">cls</tt><tt class="py-op">.</tt><tt class="py-name">__new__</tt><tt class="py-op">(</tt><tt class="py-name">cls</tt><tt class="py-op">,</tt> <tt class="py-op">*</tt><tt class="py-name">args</tt><tt class="py-op">)</tt> </tt>
</div><a name="L470"></a><tt class="py-lineno"> 470</tt> <tt class="py-line"> </tt>
<a name="Section"></a><div id="Section-def"><a name="L471"></a><tt class="py-lineno"> 471</tt> <a class="py-toggle" href="#" id="Section-toggle" onclick="return toggle('Section');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="configobj.Section-class.html">Section</a><tt class="py-op">(</tt><tt class="py-base-class">dict</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="Section-expanded"><a name="L472"></a><tt class="py-lineno"> 472</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L473"></a><tt class="py-lineno"> 473</tt> <tt class="py-line"><tt class="py-docstring"> A dictionary-like object that represents a section in a config file.</tt> </tt>
<a name="L474"></a><tt class="py-lineno"> 474</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L475"></a><tt class="py-lineno"> 475</tt> <tt class="py-line"><tt class="py-docstring"> It does string interpolation if the 'interpolation' attribute</tt> </tt>
<a name="L476"></a><tt class="py-lineno"> 476</tt> <tt class="py-line"><tt class="py-docstring"> of the 'main' object is set to True.</tt> </tt>
<a name="L477"></a><tt class="py-lineno"> 477</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L478"></a><tt class="py-lineno"> 478</tt> <tt class="py-line"><tt class="py-docstring"> Interpolation is tried first from this object, then from the 'DEFAULT'</tt> </tt>
<a name="L479"></a><tt class="py-lineno"> 479</tt> <tt class="py-line"><tt class="py-docstring"> section of this object, next from the parent and its 'DEFAULT' section,</tt> </tt>
<a name="L480"></a><tt class="py-lineno"> 480</tt> <tt class="py-line"><tt class="py-docstring"> and so on until the main object is reached.</tt> </tt>
<a name="L481"></a><tt class="py-lineno"> 481</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L482"></a><tt class="py-lineno"> 482</tt> <tt class="py-line"><tt class="py-docstring"> A Section will behave like an ordered dictionary - following the</tt> </tt>
<a name="L483"></a><tt class="py-lineno"> 483</tt> <tt class="py-line"><tt class="py-docstring"> order of the ``scalars`` and ``sections`` attributes.</tt> </tt>
<a name="L484"></a><tt class="py-lineno"> 484</tt> <tt class="py-line"><tt class="py-docstring"> You can use this to change the order of members.</tt> </tt>
<a name="L485"></a><tt class="py-lineno"> 485</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L486"></a><tt class="py-lineno"> 486</tt> <tt class="py-line"><tt class="py-docstring"> Iteration follows the order: scalars, then sections.</tt> </tt>
<a name="L487"></a><tt class="py-lineno"> 487</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L488"></a><tt class="py-lineno"> 488</tt> <tt class="py-line"> </tt>
<a name="L489"></a><tt class="py-lineno"> 489</tt> <tt class="py-line"> </tt>
<a name="Section.__setstate__"></a><div id="Section.__setstate__-def"><a name="L490"></a><tt class="py-lineno"> 490</tt> <a class="py-toggle" href="#" id="Section.__setstate__-toggle" onclick="return toggle('Section.__setstate__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#__setstate__">__setstate__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">state</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.__setstate__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.__setstate__-expanded"><a name="L491"></a><tt class="py-lineno"> 491</tt> <tt class="py-line"> <tt id="link-68" class="py-name" targets="Method configobj.Section.dict()=configobj.Section-class.html#dict"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-68', 'dict', 'link-68');">dict</a></tt><tt class="py-op">.</tt><tt id="link-69" class="py-name" targets="Method configobj.Section.update()=configobj.Section-class.html#update"><a title="configobj.Section.update" class="py-name" href="#" onclick="return doclink('link-69', 'update', 'link-69');">update</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">state</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
<a name="L492"></a><tt class="py-lineno"> 492</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">.</tt><tt id="link-70" class="py-name"><a title="configobj.Section.update" class="py-name" href="#" onclick="return doclink('link-70', 'update', 'link-69');">update</a></tt><tt class="py-op">(</tt><tt class="py-name">state</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
</div><a name="L493"></a><tt class="py-lineno"> 493</tt> <tt class="py-line"> </tt>
<a name="Section.__reduce__"></a><div id="Section.__reduce__-def"><a name="L494"></a><tt class="py-lineno"> 494</tt> <a class="py-toggle" href="#" id="Section.__reduce__-toggle" onclick="return toggle('Section.__reduce__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#__reduce__">__reduce__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.__reduce__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.__reduce__-expanded"><a name="L495"></a><tt class="py-lineno"> 495</tt> <tt class="py-line"> <tt class="py-name">state</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-71" class="py-name"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-71', 'dict', 'link-68');">dict</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">)</tt> </tt>
<a name="L496"></a><tt class="py-lineno"> 496</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt id="link-72" class="py-name" targets="Function configobj.__newobj__()=configobj-module.html#__newobj__"><a title="configobj.__newobj__" class="py-name" href="#" onclick="return doclink('link-72', '__newobj__', 'link-72');">__newobj__</a></tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">,</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">state</tt><tt class="py-op">)</tt> </tt>
</div><a name="L497"></a><tt class="py-lineno"> 497</tt> <tt class="py-line"> </tt>
<a name="L498"></a><tt class="py-lineno"> 498</tt> <tt class="py-line"> </tt>
<a name="Section.__init__"></a><div id="Section.__init__-def"><a name="L499"></a><tt class="py-lineno"> 499</tt> <a class="py-toggle" href="#" id="Section.__init__-toggle" onclick="return toggle('Section.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">parent</tt><tt class="py-op">,</tt> <tt class="py-param">depth</tt><tt class="py-op">,</tt> <tt class="py-param">main</tt><tt class="py-op">,</tt> <tt class="py-param">indict</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">name</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.__init__-expanded"><a name="L500"></a><tt class="py-lineno"> 500</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L501"></a><tt class="py-lineno"> 501</tt> <tt class="py-line"><tt class="py-docstring"> * parent is the section above</tt> </tt>
<a name="L502"></a><tt class="py-lineno"> 502</tt> <tt class="py-line"><tt class="py-docstring"> * depth is the depth level of this section</tt> </tt>
<a name="L503"></a><tt class="py-lineno"> 503</tt> <tt class="py-line"><tt class="py-docstring"> * main is the main ConfigObj</tt> </tt>
<a name="L504"></a><tt class="py-lineno"> 504</tt> <tt class="py-line"><tt class="py-docstring"> * indict is a dictionary to initialise the section with</tt> </tt>
<a name="L505"></a><tt class="py-lineno"> 505</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L506"></a><tt class="py-lineno"> 506</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">indict</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L507"></a><tt class="py-lineno"> 507</tt> <tt class="py-line"> <tt class="py-name">indict</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
<a name="L508"></a><tt class="py-lineno"> 508</tt> <tt class="py-line"> <tt id="link-73" class="py-name"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-73', 'dict', 'link-68');">dict</a></tt><tt class="py-op">.</tt><tt id="link-74" class="py-name"><a title="configobj.ConfigObj.__init__
configobj.ConfigObjError.__init__
configobj.InterpolationEngine.__init__
configobj.InterpolationLoopError.__init__
configobj.MissingInterpolationOption.__init__
configobj.ReloadError.__init__
configobj.Section.__init__
configobj.SimpleVal.__init__" class="py-name" href="#" onclick="return doclink('link-74', '__init__', 'link-38');">__init__</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt> </tt>
<a name="L509"></a><tt class="py-lineno"> 509</tt> <tt class="py-line"> <tt class="py-comment"># used for nesting level *and* interpolation</tt> </tt>
<a name="L510"></a><tt class="py-lineno"> 510</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">parent</tt> <tt class="py-op">=</tt> <tt class="py-name">parent</tt> </tt>
<a name="L511"></a><tt class="py-lineno"> 511</tt> <tt class="py-line"> <tt class="py-comment"># used for the interpolation attribute</tt> </tt>
<a name="L512"></a><tt class="py-lineno"> 512</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">main</tt> <tt class="py-op">=</tt> <tt class="py-name">main</tt> </tt>
<a name="L513"></a><tt class="py-lineno"> 513</tt> <tt class="py-line"> <tt class="py-comment"># level of nesting depth of this Section</tt> </tt>
<a name="L514"></a><tt class="py-lineno"> 514</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">depth</tt> <tt class="py-op">=</tt> <tt class="py-name">depth</tt> </tt>
<a name="L515"></a><tt class="py-lineno"> 515</tt> <tt class="py-line"> <tt class="py-comment"># purely for information</tt> </tt>
<a name="L516"></a><tt class="py-lineno"> 516</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">name</tt> <tt class="py-op">=</tt> <tt class="py-name">name</tt> </tt>
<a name="L517"></a><tt class="py-lineno"> 517</tt> <tt class="py-line"> <tt class="py-comment">#</tt> </tt>
<a name="L518"></a><tt class="py-lineno"> 518</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-75" class="py-name" targets="Method configobj.ConfigObj._initialise()=configobj.ConfigObj-class.html#_initialise,Method configobj.Section._initialise()=configobj.Section-class.html#_initialise"><a title="configobj.ConfigObj._initialise
configobj.Section._initialise" class="py-name" href="#" onclick="return doclink('link-75', '_initialise', 'link-75');">_initialise</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L519"></a><tt class="py-lineno"> 519</tt> <tt class="py-line"> <tt class="py-comment"># we do this explicitly so that __setitem__ is used properly</tt> </tt>
<a name="L520"></a><tt class="py-lineno"> 520</tt> <tt class="py-line"> <tt class="py-comment"># (rather than just passing to ``dict.__init__``)</tt> </tt>
<a name="L521"></a><tt class="py-lineno"> 521</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">entry</tt><tt class="py-op">,</tt> <tt class="py-name">value</tt> <tt class="py-keyword">in</tt> <tt class="py-name">indict</tt><tt class="py-op">.</tt><tt id="link-76" class="py-name" targets="Method configobj.Section.iteritems()=configobj.Section-class.html#iteritems"><a title="configobj.Section.iteritems" class="py-name" href="#" onclick="return doclink('link-76', 'iteritems', 'link-76');">iteritems</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L522"></a><tt class="py-lineno"> 522</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">value</tt> </tt>
</div><a name="L523"></a><tt class="py-lineno"> 523</tt> <tt class="py-line"> </tt>
<a name="L524"></a><tt class="py-lineno"> 524</tt> <tt class="py-line"> </tt>
<a name="Section._initialise"></a><div id="Section._initialise-def"><a name="L525"></a><tt class="py-lineno"> 525</tt> <a class="py-toggle" href="#" id="Section._initialise-toggle" onclick="return toggle('Section._initialise');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#_initialise">_initialise</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section._initialise-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section._initialise-expanded"><a name="L526"></a><tt class="py-lineno"> 526</tt> <tt class="py-line"> <tt class="py-comment"># the sequence of scalar values in this Section</tt> </tt>
<a name="L527"></a><tt class="py-lineno"> 527</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L528"></a><tt class="py-lineno"> 528</tt> <tt class="py-line"> <tt class="py-comment"># the sequence of sections in this Section</tt> </tt>
<a name="L529"></a><tt class="py-lineno"> 529</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L530"></a><tt class="py-lineno"> 530</tt> <tt class="py-line"> <tt class="py-comment"># for comments :-)</tt> </tt>
<a name="L531"></a><tt class="py-lineno"> 531</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">comments</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
<a name="L532"></a><tt class="py-lineno"> 532</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">inline_comments</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
<a name="L533"></a><tt class="py-lineno"> 533</tt> <tt class="py-line"> <tt class="py-comment"># the configspec</tt> </tt>
<a name="L534"></a><tt class="py-lineno"> 534</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">configspec</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
<a name="L535"></a><tt class="py-lineno"> 535</tt> <tt class="py-line"> <tt class="py-comment"># for defaults</tt> </tt>
<a name="L536"></a><tt class="py-lineno"> 536</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">defaults</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L537"></a><tt class="py-lineno"> 537</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">default_values</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
<a name="L538"></a><tt class="py-lineno"> 538</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">extra_values</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L539"></a><tt class="py-lineno"> 539</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_created</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
</div><a name="L540"></a><tt class="py-lineno"> 540</tt> <tt class="py-line"> </tt>
<a name="L541"></a><tt class="py-lineno"> 541</tt> <tt class="py-line"> </tt>
<a name="Section._interpolate"></a><div id="Section._interpolate-def"><a name="L542"></a><tt class="py-lineno"> 542</tt> <a class="py-toggle" href="#" id="Section._interpolate-toggle" onclick="return toggle('Section._interpolate');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#_interpolate">_interpolate</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">key</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section._interpolate-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section._interpolate-expanded"><a name="L543"></a><tt class="py-lineno"> 543</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
<a name="L544"></a><tt class="py-lineno"> 544</tt> <tt class="py-line"> <tt class="py-comment"># do we already have an interpolation engine?</tt> </tt>
<a name="L545"></a><tt class="py-lineno"> 545</tt> <tt class="py-line"> <tt class="py-name">engine</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_interpolation_engine</tt> </tt>
<a name="L546"></a><tt class="py-lineno"> 546</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt>
<a name="L547"></a><tt class="py-lineno"> 547</tt> <tt class="py-line"> <tt class="py-comment"># not yet: first time running _interpolate(), so pick the engine</tt> </tt>
<a name="L548"></a><tt class="py-lineno"> 548</tt> <tt class="py-line"> <tt class="py-name">name</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">main</tt><tt class="py-op">.</tt><tt class="py-name">interpolation</tt> </tt>
<a name="L549"></a><tt class="py-lineno"> 549</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">name</tt> <tt class="py-op">==</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> <tt class="py-comment"># note that "if name:" would be incorrect here</tt> </tt>
<a name="L550"></a><tt class="py-lineno"> 550</tt> <tt class="py-line"> <tt class="py-comment"># backwards-compatibility: interpolation=True means use default</tt> </tt>
<a name="L551"></a><tt class="py-lineno"> 551</tt> <tt class="py-line"> <tt class="py-name">name</tt> <tt class="py-op">=</tt> <tt id="link-77" class="py-name"><a title="configobj.DEFAULT_INTERPOLATION" class="py-name" href="#" onclick="return doclink('link-77', 'DEFAULT_INTERPOLATION', 'link-14');">DEFAULT_INTERPOLATION</a></tt> </tt>
<a name="L552"></a><tt class="py-lineno"> 552</tt> <tt class="py-line"> <tt class="py-name">name</tt> <tt class="py-op">=</tt> <tt class="py-name">name</tt><tt class="py-op">.</tt><tt class="py-name">lower</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-comment"># so that "Template", "template", etc. all work</tt> </tt>
<a name="L553"></a><tt class="py-lineno"> 553</tt> <tt class="py-line"> <tt class="py-name">class_</tt> <tt class="py-op">=</tt> <tt id="link-78" class="py-name"><a title="configobj.interpolation_engines" class="py-name" href="#" onclick="return doclink('link-78', 'interpolation_engines', 'link-65');">interpolation_engines</a></tt><tt class="py-op">.</tt><tt id="link-79" class="py-name"><a title="configobj.Section.get" class="py-name" href="#" onclick="return doclink('link-79', 'get', 'link-5');">get</a></tt><tt class="py-op">(</tt><tt class="py-name">name</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt> </tt>
<a name="L554"></a><tt class="py-lineno"> 554</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">class_</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L555"></a><tt class="py-lineno"> 555</tt> <tt class="py-line"> <tt class="py-comment"># invalid value for self.main.interpolation</tt> </tt>
<a name="L556"></a><tt class="py-lineno"> 556</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">main</tt><tt class="py-op">.</tt><tt class="py-name">interpolation</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L557"></a><tt class="py-lineno"> 557</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">value</tt> </tt>
<a name="L558"></a><tt class="py-lineno"> 558</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L559"></a><tt class="py-lineno"> 559</tt> <tt class="py-line"> <tt class="py-comment"># save reference to engine so we don't have to do this again</tt> </tt>
<a name="L560"></a><tt class="py-lineno"> 560</tt> <tt class="py-line"> <tt class="py-name">engine</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_interpolation_engine</tt> <tt class="py-op">=</tt> <tt class="py-name">class_</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt> </tt>
<a name="L561"></a><tt class="py-lineno"> 561</tt> <tt class="py-line"> <tt class="py-comment"># let the engine do the actual work</tt> </tt>
<a name="L562"></a><tt class="py-lineno"> 562</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">engine</tt><tt class="py-op">.</tt><tt id="link-80" class="py-name" targets="Method configobj.InterpolationEngine.interpolate()=configobj.InterpolationEngine-class.html#interpolate"><a title="configobj.InterpolationEngine.interpolate" class="py-name" href="#" onclick="return doclink('link-80', 'interpolate', 'link-80');">interpolate</a></tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
</div><a name="L563"></a><tt class="py-lineno"> 563</tt> <tt class="py-line"> </tt>
<a name="L564"></a><tt class="py-lineno"> 564</tt> <tt class="py-line"> </tt>
<a name="Section.__getitem__"></a><div id="Section.__getitem__-def"><a name="L565"></a><tt class="py-lineno"> 565</tt> <a class="py-toggle" href="#" id="Section.__getitem__-toggle" onclick="return toggle('Section.__getitem__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#__getitem__">__getitem__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">key</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.__getitem__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.__getitem__-expanded"><a name="L566"></a><tt class="py-lineno"> 566</tt> <tt class="py-line"> <tt class="py-docstring">"""Fetch the item and do string interpolation."""</tt> </tt>
<a name="L567"></a><tt class="py-lineno"> 567</tt> <tt class="py-line"> <tt class="py-name">val</tt> <tt class="py-op">=</tt> <tt id="link-81" class="py-name"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-81', 'dict', 'link-68');">dict</a></tt><tt class="py-op">.</tt><tt id="link-82" class="py-name" targets="Method configobj.Section.__getitem__()=configobj.Section-class.html#__getitem__"><a title="configobj.Section.__getitem__" class="py-name" href="#" onclick="return doclink('link-82', '__getitem__', 'link-82');">__getitem__</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<a name="L568"></a><tt class="py-lineno"> 568</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">main</tt><tt class="py-op">.</tt><tt class="py-name">interpolation</tt><tt class="py-op">:</tt> </tt>
<a name="L569"></a><tt class="py-lineno"> 569</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">val</tt><tt class="py-op">,</tt> <tt class="py-name">basestring</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L570"></a><tt class="py-lineno"> 570</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-83" class="py-name" targets="Method configobj.Section._interpolate()=configobj.Section-class.html#_interpolate"><a title="configobj.Section._interpolate" class="py-name" href="#" onclick="return doclink('link-83', '_interpolate', 'link-83');">_interpolate</a></tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">val</tt><tt class="py-op">)</tt> </tt>
<a name="L571"></a><tt class="py-lineno"> 571</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">val</tt><tt class="py-op">,</tt> <tt class="py-name">list</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L572"></a><tt class="py-lineno"> 572</tt> <tt class="py-line"> <tt class="py-keyword">def</tt> <tt class="py-def-name">_check</tt><tt class="py-op">(</tt><tt class="py-param">entry</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L573"></a><tt class="py-lineno"> 573</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">entry</tt><tt class="py-op">,</tt> <tt class="py-name">basestring</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L574"></a><tt class="py-lineno"> 574</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-84" class="py-name"><a title="configobj.Section._interpolate" class="py-name" href="#" onclick="return doclink('link-84', '_interpolate', 'link-83');">_interpolate</a></tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">entry</tt><tt class="py-op">)</tt> </tt>
<a name="L575"></a><tt class="py-lineno"> 575</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">entry</tt> </tt>
</div><a name="L576"></a><tt class="py-lineno"> 576</tt> <tt class="py-line"> <tt class="py-name">new</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">_check</tt><tt class="py-op">(</tt><tt class="py-name">entry</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">in</tt> <tt class="py-name">val</tt><tt class="py-op">]</tt> </tt>
<a name="L577"></a><tt class="py-lineno"> 577</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">new</tt> <tt class="py-op">!=</tt> <tt class="py-name">val</tt><tt class="py-op">:</tt> </tt>
<a name="L578"></a><tt class="py-lineno"> 578</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">new</tt> </tt>
<a name="L579"></a><tt class="py-lineno"> 579</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">val</tt> </tt>
</div><a name="L580"></a><tt class="py-lineno"> 580</tt> <tt class="py-line"> </tt>
<a name="L581"></a><tt class="py-lineno"> 581</tt> <tt class="py-line"> </tt>
<a name="Section.__setitem__"></a><div id="Section.__setitem__-def"><a name="L582"></a><tt class="py-lineno"> 582</tt> <a class="py-toggle" href="#" id="Section.__setitem__-toggle" onclick="return toggle('Section.__setitem__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#__setitem__">__setitem__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">key</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">,</tt> <tt class="py-param">unrepr</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.__setitem__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.__setitem__-expanded"><a name="L583"></a><tt class="py-lineno"> 583</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L584"></a><tt class="py-lineno"> 584</tt> <tt class="py-line"><tt class="py-docstring"> Correctly set a value.</tt> </tt>
<a name="L585"></a><tt class="py-lineno"> 585</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L586"></a><tt class="py-lineno"> 586</tt> <tt class="py-line"><tt class="py-docstring"> Making dictionary values Section instances.</tt> </tt>
<a name="L587"></a><tt class="py-lineno"> 587</tt> <tt class="py-line"><tt class="py-docstring"> (We have to special case 'Section' instances - which are also dicts)</tt> </tt>
<a name="L588"></a><tt class="py-lineno"> 588</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L589"></a><tt class="py-lineno"> 589</tt> <tt class="py-line"><tt class="py-docstring"> Keys must be strings.</tt> </tt>
<a name="L590"></a><tt class="py-lineno"> 590</tt> <tt class="py-line"><tt class="py-docstring"> Values need only be strings (or lists of strings) if</tt> </tt>
<a name="L591"></a><tt class="py-lineno"> 591</tt> <tt class="py-line"><tt class="py-docstring"> ``main.stringify`` is set.</tt> </tt>
<a name="L592"></a><tt class="py-lineno"> 592</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L593"></a><tt class="py-lineno"> 593</tt> <tt class="py-line"><tt class="py-docstring"> ``unrepr`` must be set when setting a value to a dictionary, without</tt> </tt>
<a name="L594"></a><tt class="py-lineno"> 594</tt> <tt class="py-line"><tt class="py-docstring"> creating a new sub-section.</tt> </tt>
<a name="L595"></a><tt class="py-lineno"> 595</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L596"></a><tt class="py-lineno"> 596</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">basestring</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L597"></a><tt class="py-lineno"> 597</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'The key "%s" is not a string.'</tt> <tt class="py-op">%</tt> <tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<a name="L598"></a><tt class="py-lineno"> 598</tt> <tt class="py-line"> </tt>
<a name="L599"></a><tt class="py-lineno"> 599</tt> <tt class="py-line"> <tt class="py-comment"># add the comment</tt> </tt>
<a name="L600"></a><tt class="py-lineno"> 600</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">key</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">comments</tt><tt class="py-op">:</tt> </tt>
<a name="L601"></a><tt class="py-lineno"> 601</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">comments</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L602"></a><tt class="py-lineno"> 602</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">inline_comments</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-string">''</tt> </tt>
<a name="L603"></a><tt class="py-lineno"> 603</tt> <tt class="py-line"> <tt class="py-comment"># remove the entry from defaults</tt> </tt>
<a name="L604"></a><tt class="py-lineno"> 604</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">key</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">defaults</tt><tt class="py-op">:</tt> </tt>
<a name="L605"></a><tt class="py-lineno"> 605</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">defaults</tt><tt class="py-op">.</tt><tt class="py-name">remove</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<a name="L606"></a><tt class="py-lineno"> 606</tt> <tt class="py-line"> <tt class="py-comment">#</tt> </tt>
<a name="L607"></a><tt class="py-lineno"> 607</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">,</tt> <tt id="link-85" class="py-name"><a title="configobj.Section" class="py-name" href="#" onclick="return doclink('link-85', 'Section', 'link-52');">Section</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L608"></a><tt class="py-lineno"> 608</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">key</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">:</tt> </tt>
<a name="L609"></a><tt class="py-lineno"> 609</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<a name="L610"></a><tt class="py-lineno"> 610</tt> <tt class="py-line"> <tt id="link-86" class="py-name"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-86', 'dict', 'link-68');">dict</a></tt><tt class="py-op">.</tt><tt id="link-87" class="py-name" targets="Method configobj.Section.__setitem__()=configobj.Section-class.html#__setitem__"><a title="configobj.Section.__setitem__" class="py-name" href="#" onclick="return doclink('link-87', '__setitem__', 'link-87');">__setitem__</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
<a name="L611"></a><tt class="py-lineno"> 611</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">,</tt> <tt id="link-88" class="py-name"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-88', 'dict', 'link-68');">dict</a></tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-keyword">not</tt> <tt id="link-89" class="py-name" targets="Function configobj.unrepr()=configobj-module.html#unrepr"><a title="configobj.unrepr" class="py-name" href="#" onclick="return doclink('link-89', 'unrepr', 'link-89');">unrepr</a></tt><tt class="py-op">:</tt> </tt>
<a name="L612"></a><tt class="py-lineno"> 612</tt> <tt class="py-line"> <tt class="py-comment"># First create the new depth level,</tt> </tt>
<a name="L613"></a><tt class="py-lineno"> 613</tt> <tt class="py-line"> <tt class="py-comment"># then create the section</tt> </tt>
<a name="L614"></a><tt class="py-lineno"> 614</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">key</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">:</tt> </tt>
<a name="L615"></a><tt class="py-lineno"> 615</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<a name="L616"></a><tt class="py-lineno"> 616</tt> <tt class="py-line"> <tt class="py-name">new_depth</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">depth</tt> <tt class="py-op">+</tt> <tt class="py-number">1</tt> </tt>
<a name="L617"></a><tt class="py-lineno"> 617</tt> <tt class="py-line"> <tt id="link-90" class="py-name"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-90', 'dict', 'link-68');">dict</a></tt><tt class="py-op">.</tt><tt id="link-91" class="py-name"><a title="configobj.Section.__setitem__" class="py-name" href="#" onclick="return doclink('link-91', '__setitem__', 'link-87');">__setitem__</a></tt><tt class="py-op">(</tt> </tt>
<a name="L618"></a><tt class="py-lineno"> 618</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">,</tt> </tt>
<a name="L619"></a><tt class="py-lineno"> 619</tt> <tt class="py-line"> <tt class="py-name">key</tt><tt class="py-op">,</tt> </tt>
<a name="L620"></a><tt class="py-lineno"> 620</tt> <tt class="py-line"> <tt id="link-92" class="py-name"><a title="configobj.Section" class="py-name" href="#" onclick="return doclink('link-92', 'Section', 'link-52');">Section</a></tt><tt class="py-op">(</tt> </tt>
<a name="L621"></a><tt class="py-lineno"> 621</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">,</tt> </tt>
<a name="L622"></a><tt class="py-lineno"> 622</tt> <tt class="py-line"> <tt class="py-name">new_depth</tt><tt class="py-op">,</tt> </tt>
<a name="L623"></a><tt class="py-lineno"> 623</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">main</tt><tt class="py-op">,</tt> </tt>
<a name="L624"></a><tt class="py-lineno"> 624</tt> <tt class="py-line"> <tt class="py-name">indict</tt><tt class="py-op">=</tt><tt class="py-name">value</tt><tt class="py-op">,</tt> </tt>
<a name="L625"></a><tt class="py-lineno"> 625</tt> <tt class="py-line"> <tt class="py-name">name</tt><tt class="py-op">=</tt><tt class="py-name">key</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
<a name="L626"></a><tt class="py-lineno"> 626</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L627"></a><tt class="py-lineno"> 627</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">key</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">:</tt> </tt>
<a name="L628"></a><tt class="py-lineno"> 628</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<a name="L629"></a><tt class="py-lineno"> 629</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">main</tt><tt class="py-op">.</tt><tt class="py-name">stringify</tt><tt class="py-op">:</tt> </tt>
<a name="L630"></a><tt class="py-lineno"> 630</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-name">basestring</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L631"></a><tt class="py-lineno"> 631</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt>
<a name="L632"></a><tt class="py-lineno"> 632</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">list</tt><tt class="py-op">,</tt> <tt class="py-name">tuple</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L633"></a><tt class="py-lineno"> 633</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">in</tt> <tt class="py-name">value</tt><tt class="py-op">:</tt> </tt>
<a name="L634"></a><tt class="py-lineno"> 634</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">entry</tt><tt class="py-op">,</tt> <tt class="py-name">basestring</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L635"></a><tt class="py-lineno"> 635</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Value is not a string "%s".'</tt> <tt class="py-op">%</tt> <tt class="py-name">entry</tt><tt class="py-op">)</tt> </tt>
<a name="L636"></a><tt class="py-lineno"> 636</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L637"></a><tt class="py-lineno"> 637</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Value is not a string "%s".'</tt> <tt class="py-op">%</tt> <tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
<a name="L638"></a><tt class="py-lineno"> 638</tt> <tt class="py-line"> <tt id="link-93" class="py-name"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-93', 'dict', 'link-68');">dict</a></tt><tt class="py-op">.</tt><tt id="link-94" class="py-name"><a title="configobj.Section.__setitem__" class="py-name" href="#" onclick="return doclink('link-94', '__setitem__', 'link-87');">__setitem__</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
</div><a name="L639"></a><tt class="py-lineno"> 639</tt> <tt class="py-line"> </tt>
<a name="L640"></a><tt class="py-lineno"> 640</tt> <tt class="py-line"> </tt>
<a name="Section.__delitem__"></a><div id="Section.__delitem__-def"><a name="L641"></a><tt class="py-lineno"> 641</tt> <a class="py-toggle" href="#" id="Section.__delitem__-toggle" onclick="return toggle('Section.__delitem__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#__delitem__">__delitem__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">key</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.__delitem__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.__delitem__-expanded"><a name="L642"></a><tt class="py-lineno"> 642</tt> <tt class="py-line"> <tt class="py-docstring">"""Remove items from the sequence when deleting."""</tt> </tt>
<a name="L643"></a><tt class="py-lineno"> 643</tt> <tt class="py-line"> <tt id="link-95" class="py-name"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-95', 'dict', 'link-68');">dict</a></tt><tt class="py-op">.</tt> <tt id="link-96" class="py-name" targets="Method configobj.Section.__delitem__()=configobj.Section-class.html#__delitem__"><a title="configobj.Section.__delitem__" class="py-name" href="#" onclick="return doclink('link-96', '__delitem__', 'link-96');">__delitem__</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<a name="L644"></a><tt class="py-lineno"> 644</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">key</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt><tt class="py-op">:</tt> </tt>
<a name="L645"></a><tt class="py-lineno"> 645</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt><tt class="py-op">.</tt><tt class="py-name">remove</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<a name="L646"></a><tt class="py-lineno"> 646</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L647"></a><tt class="py-lineno"> 647</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">.</tt><tt class="py-name">remove</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<a name="L648"></a><tt class="py-lineno"> 648</tt> <tt class="py-line"> <tt class="py-keyword">del</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">comments</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> </tt>
<a name="L649"></a><tt class="py-lineno"> 649</tt> <tt class="py-line"> <tt class="py-keyword">del</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">inline_comments</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> </tt>
</div><a name="L650"></a><tt class="py-lineno"> 650</tt> <tt class="py-line"> </tt>
<a name="L651"></a><tt class="py-lineno"> 651</tt> <tt class="py-line"> </tt>
<a name="Section.get"></a><div id="Section.get-def"><a name="L652"></a><tt class="py-lineno"> 652</tt> <a class="py-toggle" href="#" id="Section.get-toggle" onclick="return toggle('Section.get');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#get">get</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">key</tt><tt class="py-op">,</tt> <tt class="py-param">default</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.get-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.get-expanded"><a name="L653"></a><tt class="py-lineno"> 653</tt> <tt class="py-line"> <tt class="py-docstring">"""A version of ``get`` that doesn't bypass string interpolation."""</tt> </tt>
<a name="L654"></a><tt class="py-lineno"> 654</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
<a name="L655"></a><tt class="py-lineno"> 655</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> </tt>
<a name="L656"></a><tt class="py-lineno"> 656</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">KeyError</tt><tt class="py-op">:</tt> </tt>
<a name="L657"></a><tt class="py-lineno"> 657</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">default</tt> </tt>
</div><a name="L658"></a><tt class="py-lineno"> 658</tt> <tt class="py-line"> </tt>
<a name="L659"></a><tt class="py-lineno"> 659</tt> <tt class="py-line"> </tt>
<a name="Section.update"></a><div id="Section.update-def"><a name="L660"></a><tt class="py-lineno"> 660</tt> <a class="py-toggle" href="#" id="Section.update-toggle" onclick="return toggle('Section.update');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#update">update</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">indict</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.update-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.update-expanded"><a name="L661"></a><tt class="py-lineno"> 661</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L662"></a><tt class="py-lineno"> 662</tt> <tt class="py-line"><tt class="py-docstring"> A version of update that uses our ``__setitem__``.</tt> </tt>
<a name="L663"></a><tt class="py-lineno"> 663</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L664"></a><tt class="py-lineno"> 664</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">in</tt> <tt class="py-name">indict</tt><tt class="py-op">:</tt> </tt>
<a name="L665"></a><tt class="py-lineno"> 665</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">indict</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> </tt>
</div><a name="L666"></a><tt class="py-lineno"> 666</tt> <tt class="py-line"> </tt>
<a name="L667"></a><tt class="py-lineno"> 667</tt> <tt class="py-line"> </tt>
<a name="Section.pop"></a><div id="Section.pop-def"><a name="L668"></a><tt class="py-lineno"> 668</tt> <a class="py-toggle" href="#" id="Section.pop-toggle" onclick="return toggle('Section.pop');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#pop">pop</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">key</tt><tt class="py-op">,</tt> <tt class="py-param">default</tt><tt class="py-op">=</tt><tt id="link-97" class="py-name"><a title="configobj.MISSING" class="py-name" href="#" onclick="return doclink('link-97', 'MISSING', 'link-12');">MISSING</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.pop-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.pop-expanded"><a name="L669"></a><tt class="py-lineno"> 669</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L670"></a><tt class="py-lineno"> 670</tt> <tt class="py-line"><tt class="py-docstring"> 'D.pop(k[,d]) -> v, remove specified key and return the corresponding value.</tt> </tt>
<a name="L671"></a><tt class="py-lineno"> 671</tt> <tt class="py-line"><tt class="py-docstring"> If key is not found, d is returned if given, otherwise KeyError is raised'</tt> </tt>
<a name="L672"></a><tt class="py-lineno"> 672</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L673"></a><tt class="py-lineno"> 673</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
<a name="L674"></a><tt class="py-lineno"> 674</tt> <tt class="py-line"> <tt class="py-name">val</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> </tt>
<a name="L675"></a><tt class="py-lineno"> 675</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">KeyError</tt><tt class="py-op">:</tt> </tt>
<a name="L676"></a><tt class="py-lineno"> 676</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">default</tt> <tt class="py-keyword">is</tt> <tt id="link-98" class="py-name"><a title="configobj.MISSING" class="py-name" href="#" onclick="return doclink('link-98', 'MISSING', 'link-12');">MISSING</a></tt><tt class="py-op">:</tt> </tt>
<a name="L677"></a><tt class="py-lineno"> 677</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> </tt>
<a name="L678"></a><tt class="py-lineno"> 678</tt> <tt class="py-line"> <tt class="py-name">val</tt> <tt class="py-op">=</tt> <tt class="py-name">default</tt> </tt>
<a name="L679"></a><tt class="py-lineno"> 679</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L680"></a><tt class="py-lineno"> 680</tt> <tt class="py-line"> <tt class="py-keyword">del</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> </tt>
<a name="L681"></a><tt class="py-lineno"> 681</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">val</tt> </tt>
</div><a name="L682"></a><tt class="py-lineno"> 682</tt> <tt class="py-line"> </tt>
<a name="L683"></a><tt class="py-lineno"> 683</tt> <tt class="py-line"> </tt>
<a name="Section.popitem"></a><div id="Section.popitem-def"><a name="L684"></a><tt class="py-lineno"> 684</tt> <a class="py-toggle" href="#" id="Section.popitem-toggle" onclick="return toggle('Section.popitem');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#popitem">popitem</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.popitem-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.popitem-expanded"><a name="L685"></a><tt class="py-lineno"> 685</tt> <tt class="py-line"> <tt class="py-docstring">"""Pops the first (key,val)"""</tt> </tt>
<a name="L686"></a><tt class="py-lineno"> 686</tt> <tt class="py-line"> <tt class="py-name">sequence</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt> <tt class="py-op">+</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">)</tt> </tt>
<a name="L687"></a><tt class="py-lineno"> 687</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">sequence</tt><tt class="py-op">:</tt> </tt>
<a name="L688"></a><tt class="py-lineno"> 688</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">KeyError</tt><tt class="py-op">(</tt><tt class="py-string">": 'popitem(): dictionary is empty'"</tt><tt class="py-op">)</tt> </tt>
<a name="L689"></a><tt class="py-lineno"> 689</tt> <tt class="py-line"> <tt class="py-name">key</tt> <tt class="py-op">=</tt> <tt class="py-name">sequence</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> </tt>
<a name="L690"></a><tt class="py-lineno"> 690</tt> <tt class="py-line"> <tt class="py-name">val</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> </tt>
<a name="L691"></a><tt class="py-lineno"> 691</tt> <tt class="py-line"> <tt class="py-keyword">del</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> </tt>
<a name="L692"></a><tt class="py-lineno"> 692</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">val</tt> </tt>
</div><a name="L693"></a><tt class="py-lineno"> 693</tt> <tt class="py-line"> </tt>
<a name="L694"></a><tt class="py-lineno"> 694</tt> <tt class="py-line"> </tt>
<a name="Section.clear"></a><div id="Section.clear-def"><a name="L695"></a><tt class="py-lineno"> 695</tt> <a class="py-toggle" href="#" id="Section.clear-toggle" onclick="return toggle('Section.clear');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#clear">clear</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.clear-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.clear-expanded"><a name="L696"></a><tt class="py-lineno"> 696</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L697"></a><tt class="py-lineno"> 697</tt> <tt class="py-line"><tt class="py-docstring"> A version of clear that also affects scalars/sections</tt> </tt>
<a name="L698"></a><tt class="py-lineno"> 698</tt> <tt class="py-line"><tt class="py-docstring"> Also clears comments and configspec.</tt> </tt>
<a name="L699"></a><tt class="py-lineno"> 699</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L700"></a><tt class="py-lineno"> 700</tt> <tt class="py-line"><tt class="py-docstring"> Leaves other attributes alone :</tt> </tt>
<a name="L701"></a><tt class="py-lineno"> 701</tt> <tt class="py-line"><tt class="py-docstring"> depth/main/parent are not affected</tt> </tt>
<a name="L702"></a><tt class="py-lineno"> 702</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L703"></a><tt class="py-lineno"> 703</tt> <tt class="py-line"> <tt id="link-99" class="py-name"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-99', 'dict', 'link-68');">dict</a></tt><tt class="py-op">.</tt><tt id="link-100" class="py-name" targets="Method configobj.Section.clear()=configobj.Section-class.html#clear"><a title="configobj.Section.clear" class="py-name" href="#" onclick="return doclink('link-100', 'clear', 'link-100');">clear</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt> </tt>
<a name="L704"></a><tt class="py-lineno"> 704</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L705"></a><tt class="py-lineno"> 705</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L706"></a><tt class="py-lineno"> 706</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">comments</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
<a name="L707"></a><tt class="py-lineno"> 707</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">inline_comments</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
<a name="L708"></a><tt class="py-lineno"> 708</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">configspec</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
<a name="L709"></a><tt class="py-lineno"> 709</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">defaults</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L710"></a><tt class="py-lineno"> 710</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">extra_values</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
</div><a name="L711"></a><tt class="py-lineno"> 711</tt> <tt class="py-line"> </tt>
<a name="L712"></a><tt class="py-lineno"> 712</tt> <tt class="py-line"> </tt>
<a name="Section.setdefault"></a><div id="Section.setdefault-def"><a name="L713"></a><tt class="py-lineno"> 713</tt> <a class="py-toggle" href="#" id="Section.setdefault-toggle" onclick="return toggle('Section.setdefault');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#setdefault">setdefault</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">key</tt><tt class="py-op">,</tt> <tt class="py-param">default</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.setdefault-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.setdefault-expanded"><a name="L714"></a><tt class="py-lineno"> 714</tt> <tt class="py-line"> <tt class="py-docstring">"""A version of setdefault that sets sequence if appropriate."""</tt> </tt>
<a name="L715"></a><tt class="py-lineno"> 715</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
<a name="L716"></a><tt class="py-lineno"> 716</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> </tt>
<a name="L717"></a><tt class="py-lineno"> 717</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">KeyError</tt><tt class="py-op">:</tt> </tt>
<a name="L718"></a><tt class="py-lineno"> 718</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">default</tt> </tt>
<a name="L719"></a><tt class="py-lineno"> 719</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> </tt>
</div><a name="L720"></a><tt class="py-lineno"> 720</tt> <tt class="py-line"> </tt>
<a name="L721"></a><tt class="py-lineno"> 721</tt> <tt class="py-line"> </tt>
<a name="Section.items"></a><div id="Section.items-def"><a name="L722"></a><tt class="py-lineno"> 722</tt> <a class="py-toggle" href="#" id="Section.items-toggle" onclick="return toggle('Section.items');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#items">items</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.items-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.items-expanded"><a name="L723"></a><tt class="py-lineno"> 723</tt> <tt class="py-line"> <tt class="py-docstring">"""D.items() -> list of D's (key, value) pairs, as 2-tuples"""</tt> </tt>
<a name="L724"></a><tt class="py-lineno"> 724</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">zip</tt><tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt> <tt class="py-op">+</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-101" class="py-name" targets="Method configobj.Section.values()=configobj.Section-class.html#values"><a title="configobj.Section.values" class="py-name" href="#" onclick="return doclink('link-101', 'values', 'link-101');">values</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
</div><a name="L725"></a><tt class="py-lineno"> 725</tt> <tt class="py-line"> </tt>
<a name="L726"></a><tt class="py-lineno"> 726</tt> <tt class="py-line"> </tt>
<a name="Section.keys"></a><div id="Section.keys-def"><a name="L727"></a><tt class="py-lineno"> 727</tt> <a class="py-toggle" href="#" id="Section.keys-toggle" onclick="return toggle('Section.keys');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#keys">keys</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.keys-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.keys-expanded"><a name="L728"></a><tt class="py-lineno"> 728</tt> <tt class="py-line"> <tt class="py-docstring">"""D.keys() -> list of D's keys"""</tt> </tt>
<a name="L729"></a><tt class="py-lineno"> 729</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt> <tt class="py-op">+</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">)</tt> </tt>
</div><a name="L730"></a><tt class="py-lineno"> 730</tt> <tt class="py-line"> </tt>
<a name="L731"></a><tt class="py-lineno"> 731</tt> <tt class="py-line"> </tt>
<a name="Section.values"></a><div id="Section.values-def"><a name="L732"></a><tt class="py-lineno"> 732</tt> <a class="py-toggle" href="#" id="Section.values-toggle" onclick="return toggle('Section.values');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#values">values</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.values-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.values-expanded"><a name="L733"></a><tt class="py-lineno"> 733</tt> <tt class="py-line"> <tt class="py-docstring">"""D.values() -> list of D's values"""</tt> </tt>
<a name="L734"></a><tt class="py-lineno"> 734</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">[</tt><tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> <tt class="py-keyword">for</tt> <tt class="py-name">key</tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt> <tt class="py-op">+</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt>
</div><a name="L735"></a><tt class="py-lineno"> 735</tt> <tt class="py-line"> </tt>
<a name="L736"></a><tt class="py-lineno"> 736</tt> <tt class="py-line"> </tt>
<a name="Section.iteritems"></a><div id="Section.iteritems-def"><a name="L737"></a><tt class="py-lineno"> 737</tt> <a class="py-toggle" href="#" id="Section.iteritems-toggle" onclick="return toggle('Section.iteritems');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#iteritems">iteritems</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.iteritems-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.iteritems-expanded"><a name="L738"></a><tt class="py-lineno"> 738</tt> <tt class="py-line"> <tt class="py-docstring">"""D.iteritems() -> an iterator over the (key, value) items of D"""</tt> </tt>
<a name="L739"></a><tt class="py-lineno"> 739</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">iter</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-102" class="py-name" targets="Method configobj.Section.items()=configobj.Section-class.html#items"><a title="configobj.Section.items" class="py-name" href="#" onclick="return doclink('link-102', 'items', 'link-102');">items</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
</div><a name="L740"></a><tt class="py-lineno"> 740</tt> <tt class="py-line"> </tt>
<a name="L741"></a><tt class="py-lineno"> 741</tt> <tt class="py-line"> </tt>
<a name="Section.iterkeys"></a><div id="Section.iterkeys-def"><a name="L742"></a><tt class="py-lineno"> 742</tt> <a class="py-toggle" href="#" id="Section.iterkeys-toggle" onclick="return toggle('Section.iterkeys');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#iterkeys">iterkeys</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.iterkeys-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.iterkeys-expanded"><a name="L743"></a><tt class="py-lineno"> 743</tt> <tt class="py-line"> <tt class="py-docstring">"""D.iterkeys() -> an iterator over the keys of D"""</tt> </tt>
<a name="L744"></a><tt class="py-lineno"> 744</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">iter</tt><tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt> <tt class="py-op">+</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
</div><a name="L745"></a><tt class="py-lineno"> 745</tt> <tt class="py-line"> </tt>
<a name="L746"></a><tt class="py-lineno"> 746</tt> <tt class="py-line"> <tt class="py-name">__iter__</tt> <tt class="py-op">=</tt> <tt id="link-103" class="py-name" targets="Method configobj.Section.iterkeys()=configobj.Section-class.html#iterkeys"><a title="configobj.Section.iterkeys" class="py-name" href="#" onclick="return doclink('link-103', 'iterkeys', 'link-103');">iterkeys</a></tt> </tt>
<a name="L747"></a><tt class="py-lineno"> 747</tt> <tt class="py-line"> </tt>
<a name="L748"></a><tt class="py-lineno"> 748</tt> <tt class="py-line"> </tt>
<a name="Section.itervalues"></a><div id="Section.itervalues-def"><a name="L749"></a><tt class="py-lineno"> 749</tt> <a class="py-toggle" href="#" id="Section.itervalues-toggle" onclick="return toggle('Section.itervalues');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#itervalues">itervalues</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.itervalues-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.itervalues-expanded"><a name="L750"></a><tt class="py-lineno"> 750</tt> <tt class="py-line"> <tt class="py-docstring">"""D.itervalues() -> an iterator over the values of D"""</tt> </tt>
<a name="L751"></a><tt class="py-lineno"> 751</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">iter</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-104" class="py-name"><a title="configobj.Section.values" class="py-name" href="#" onclick="return doclink('link-104', 'values', 'link-101');">values</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
</div><a name="L752"></a><tt class="py-lineno"> 752</tt> <tt class="py-line"> </tt>
<a name="L753"></a><tt class="py-lineno"> 753</tt> <tt class="py-line"> </tt>
<a name="Section.__repr__"></a><div id="Section.__repr__-def"><a name="L754"></a><tt class="py-lineno"> 754</tt> <a class="py-toggle" href="#" id="Section.__repr__-toggle" onclick="return toggle('Section.__repr__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#__repr__">__repr__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.__repr__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.__repr__-expanded"><a name="L755"></a><tt class="py-lineno"> 755</tt> <tt class="py-line"> <tt class="py-docstring">"""x.__repr__() <==> repr(x)"""</tt> </tt>
<a name="L756"></a><tt class="py-lineno"> 756</tt> <tt class="py-line"> <tt class="py-keyword">def</tt> <tt class="py-def-name">_getval</tt><tt class="py-op">(</tt><tt class="py-param">key</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L757"></a><tt class="py-lineno"> 757</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
<a name="L758"></a><tt class="py-lineno"> 758</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> </tt>
<a name="L759"></a><tt class="py-lineno"> 759</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt id="link-105" class="py-name"><a title="configobj.MissingInterpolationOption" class="py-name" href="#" onclick="return doclink('link-105', 'MissingInterpolationOption', 'link-56');">MissingInterpolationOption</a></tt><tt class="py-op">:</tt> </tt>
<a name="L760"></a><tt class="py-lineno"> 760</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-106" class="py-name"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-106', 'dict', 'link-68');">dict</a></tt><tt class="py-op">.</tt><tt id="link-107" class="py-name"><a title="configobj.Section.__getitem__" class="py-name" href="#" onclick="return doclink('link-107', '__getitem__', 'link-82');">__getitem__</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
</div><a name="L761"></a><tt class="py-lineno"> 761</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'{%s}'</tt> <tt class="py-op">%</tt> <tt class="py-string">', '</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-op">(</tt><tt class="py-string">'%s: %s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">repr</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">repr</tt><tt class="py-op">(</tt><tt class="py-name">_getval</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
<a name="L762"></a><tt class="py-lineno"> 762</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">key</tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt> <tt class="py-op">+</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">)</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
</div><a name="L763"></a><tt class="py-lineno"> 763</tt> <tt class="py-line"> </tt>
<a name="L764"></a><tt class="py-lineno"> 764</tt> <tt class="py-line"> <tt class="py-name">__str__</tt> <tt class="py-op">=</tt> <tt id="link-108" class="py-name" targets="Method configobj.ConfigObj.__repr__()=configobj.ConfigObj-class.html#__repr__,Method configobj.Section.__repr__()=configobj.Section-class.html#__repr__"><a title="configobj.ConfigObj.__repr__
configobj.Section.__repr__" class="py-name" href="#" onclick="return doclink('link-108', '__repr__', 'link-108');">__repr__</a></tt> </tt>
<a name="L765"></a><tt class="py-lineno"> 765</tt> <tt class="py-line"> <tt class="py-name">__str__</tt><tt class="py-op">.</tt><tt class="py-name">__doc__</tt> <tt class="py-op">=</tt> <tt class="py-string">"x.__str__() <==> str(x)"</tt> </tt>
<a name="L766"></a><tt class="py-lineno"> 766</tt> <tt class="py-line"> </tt>
<a name="L767"></a><tt class="py-lineno"> 767</tt> <tt class="py-line"> </tt>
<a name="L768"></a><tt class="py-lineno"> 768</tt> <tt class="py-line"> <tt class="py-comment"># Extra methods - not in a normal dictionary</tt> </tt>
<a name="L769"></a><tt class="py-lineno"> 769</tt> <tt class="py-line"> </tt>
<a name="Section.dict"></a><div id="Section.dict-def"><a name="L770"></a><tt class="py-lineno"> 770</tt> <a class="py-toggle" href="#" id="Section.dict-toggle" onclick="return toggle('Section.dict');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#dict">dict</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.dict-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.dict-expanded"><a name="L771"></a><tt class="py-lineno"> 771</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L772"></a><tt class="py-lineno"> 772</tt> <tt class="py-line"><tt class="py-docstring"> Return a deepcopy of self as a dictionary.</tt> </tt>
<a name="L773"></a><tt class="py-lineno"> 773</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L774"></a><tt class="py-lineno"> 774</tt> <tt class="py-line"><tt class="py-docstring"> All members that are ``Section`` instances are recursively turned to</tt> </tt>
<a name="L775"></a><tt class="py-lineno"> 775</tt> <tt class="py-line"><tt class="py-docstring"> ordinary dictionaries - by calling their ``dict`` method.</tt> </tt>
<a name="L776"></a><tt class="py-lineno"> 776</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L777"></a><tt class="py-lineno"> 777</tt> <tt class="py-line"><tt class="py-docstring"> >>> n = a.dict()</tt> </tt>
<a name="L778"></a><tt class="py-lineno"> 778</tt> <tt class="py-line"><tt class="py-docstring"> >>> n == a</tt> </tt>
<a name="L779"></a><tt class="py-lineno"> 779</tt> <tt class="py-line"><tt class="py-docstring"> 1</tt> </tt>
<a name="L780"></a><tt class="py-lineno"> 780</tt> <tt class="py-line"><tt class="py-docstring"> >>> n is a</tt> </tt>
<a name="L781"></a><tt class="py-lineno"> 781</tt> <tt class="py-line"><tt class="py-docstring"> 0</tt> </tt>
<a name="L782"></a><tt class="py-lineno"> 782</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L783"></a><tt class="py-lineno"> 783</tt> <tt class="py-line"> <tt class="py-name">newdict</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
<a name="L784"></a><tt class="py-lineno"> 784</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">:</tt> </tt>
<a name="L785"></a><tt class="py-lineno"> 785</tt> <tt class="py-line"> <tt class="py-name">this_entry</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> </tt>
<a name="L786"></a><tt class="py-lineno"> 786</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">this_entry</tt><tt class="py-op">,</tt> <tt id="link-109" class="py-name"><a title="configobj.Section" class="py-name" href="#" onclick="return doclink('link-109', 'Section', 'link-52');">Section</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L787"></a><tt class="py-lineno"> 787</tt> <tt class="py-line"> <tt class="py-name">this_entry</tt> <tt class="py-op">=</tt> <tt class="py-name">this_entry</tt><tt class="py-op">.</tt><tt id="link-110" class="py-name"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-110', 'dict', 'link-68');">dict</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L788"></a><tt class="py-lineno"> 788</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">this_entry</tt><tt class="py-op">,</tt> <tt class="py-name">list</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L789"></a><tt class="py-lineno"> 789</tt> <tt class="py-line"> <tt class="py-comment"># create a copy rather than a reference</tt> </tt>
<a name="L790"></a><tt class="py-lineno"> 790</tt> <tt class="py-line"> <tt class="py-name">this_entry</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">this_entry</tt><tt class="py-op">)</tt> </tt>
<a name="L791"></a><tt class="py-lineno"> 791</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">this_entry</tt><tt class="py-op">,</tt> <tt class="py-name">tuple</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L792"></a><tt class="py-lineno"> 792</tt> <tt class="py-line"> <tt class="py-comment"># create a copy rather than a reference</tt> </tt>
<a name="L793"></a><tt class="py-lineno"> 793</tt> <tt class="py-line"> <tt class="py-name">this_entry</tt> <tt class="py-op">=</tt> <tt class="py-name">tuple</tt><tt class="py-op">(</tt><tt class="py-name">this_entry</tt><tt class="py-op">)</tt> </tt>
<a name="L794"></a><tt class="py-lineno"> 794</tt> <tt class="py-line"> <tt class="py-name">newdict</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">this_entry</tt> </tt>
<a name="L795"></a><tt class="py-lineno"> 795</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">newdict</tt> </tt>
</div><a name="L796"></a><tt class="py-lineno"> 796</tt> <tt class="py-line"> </tt>
<a name="L797"></a><tt class="py-lineno"> 797</tt> <tt class="py-line"> </tt>
<a name="Section.merge"></a><div id="Section.merge-def"><a name="L798"></a><tt class="py-lineno"> 798</tt> <a class="py-toggle" href="#" id="Section.merge-toggle" onclick="return toggle('Section.merge');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#merge">merge</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">indict</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.merge-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.merge-expanded"><a name="L799"></a><tt class="py-lineno"> 799</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L800"></a><tt class="py-lineno"> 800</tt> <tt class="py-line"><tt class="py-docstring"> A recursive update - useful for merging config files.</tt> </tt>
<a name="L801"></a><tt class="py-lineno"> 801</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L802"></a><tt class="py-lineno"> 802</tt> <tt class="py-line"><tt class="py-docstring"> >>> a = '''[section1]</tt> </tt>
<a name="L803"></a><tt class="py-lineno"> 803</tt> <tt class="py-line"><tt class="py-docstring"> ... option1 = True</tt> </tt>
<a name="L804"></a><tt class="py-lineno"> 804</tt> <tt class="py-line"><tt class="py-docstring"> ... [[subsection]]</tt> </tt>
<a name="L805"></a><tt class="py-lineno"> 805</tt> <tt class="py-line"><tt class="py-docstring"> ... more_options = False</tt> </tt>
<a name="L806"></a><tt class="py-lineno"> 806</tt> <tt class="py-line"><tt class="py-docstring"> ... # end of file'''.splitlines()</tt> </tt>
<a name="L807"></a><tt class="py-lineno"> 807</tt> <tt class="py-line"><tt class="py-docstring"> >>> b = '''# File is user.ini</tt> </tt>
<a name="L808"></a><tt class="py-lineno"> 808</tt> <tt class="py-line"><tt class="py-docstring"> ... [section1]</tt> </tt>
<a name="L809"></a><tt class="py-lineno"> 809</tt> <tt class="py-line"><tt class="py-docstring"> ... option1 = False</tt> </tt>
<a name="L810"></a><tt class="py-lineno"> 810</tt> <tt class="py-line"><tt class="py-docstring"> ... # end of file'''.splitlines()</tt> </tt>
<a name="L811"></a><tt class="py-lineno"> 811</tt> <tt class="py-line"><tt class="py-docstring"> >>> c1 = ConfigObj(b)</tt> </tt>
<a name="L812"></a><tt class="py-lineno"> 812</tt> <tt class="py-line"><tt class="py-docstring"> >>> c2 = ConfigObj(a)</tt> </tt>
<a name="L813"></a><tt class="py-lineno"> 813</tt> <tt class="py-line"><tt class="py-docstring"> >>> c2.merge(c1)</tt> </tt>
<a name="L814"></a><tt class="py-lineno"> 814</tt> <tt class="py-line"><tt class="py-docstring"> >>> c2</tt> </tt>
<a name="L815"></a><tt class="py-lineno"> 815</tt> <tt class="py-line"><tt class="py-docstring"> ConfigObj({'section1': {'option1': 'False', 'subsection': {'more_options': 'False'}}})</tt> </tt>
<a name="L816"></a><tt class="py-lineno"> 816</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L817"></a><tt class="py-lineno"> 817</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">val</tt> <tt class="py-keyword">in</tt> <tt class="py-name">indict</tt><tt class="py-op">.</tt><tt id="link-111" class="py-name"><a title="configobj.Section.items" class="py-name" href="#" onclick="return doclink('link-111', 'items', 'link-102');">items</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L818"></a><tt class="py-lineno"> 818</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">key</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt> <tt class="py-keyword">and</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt id="link-112" class="py-name"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-112', 'dict', 'link-68');">dict</a></tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> </tt>
<a name="L819"></a><tt class="py-lineno"> 819</tt> <tt class="py-line"> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">val</tt><tt class="py-op">,</tt> <tt id="link-113" class="py-name"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-113', 'dict', 'link-68');">dict</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L820"></a><tt class="py-lineno"> 820</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt id="link-114" class="py-name" targets="Method configobj.Section.merge()=configobj.Section-class.html#merge"><a title="configobj.Section.merge" class="py-name" href="#" onclick="return doclink('link-114', 'merge', 'link-114');">merge</a></tt><tt class="py-op">(</tt><tt class="py-name">val</tt><tt class="py-op">)</tt> </tt>
<a name="L821"></a><tt class="py-lineno"> 821</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L822"></a><tt class="py-lineno"> 822</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">val</tt> </tt>
</div><a name="L823"></a><tt class="py-lineno"> 823</tt> <tt class="py-line"> </tt>
<a name="L824"></a><tt class="py-lineno"> 824</tt> <tt class="py-line"> </tt>
<a name="Section.rename"></a><div id="Section.rename-def"><a name="L825"></a><tt class="py-lineno"> 825</tt> <a class="py-toggle" href="#" id="Section.rename-toggle" onclick="return toggle('Section.rename');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#rename">rename</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">oldkey</tt><tt class="py-op">,</tt> <tt class="py-param">newkey</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.rename-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.rename-expanded"><a name="L826"></a><tt class="py-lineno"> 826</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L827"></a><tt class="py-lineno"> 827</tt> <tt class="py-line"><tt class="py-docstring"> Change a keyname to another, without changing position in sequence.</tt> </tt>
<a name="L828"></a><tt class="py-lineno"> 828</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L829"></a><tt class="py-lineno"> 829</tt> <tt class="py-line"><tt class="py-docstring"> Implemented so that transformations can be made on keys,</tt> </tt>
<a name="L830"></a><tt class="py-lineno"> 830</tt> <tt class="py-line"><tt class="py-docstring"> as well as on values. (used by encode and decode)</tt> </tt>
<a name="L831"></a><tt class="py-lineno"> 831</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L832"></a><tt class="py-lineno"> 832</tt> <tt class="py-line"><tt class="py-docstring"> Also renames comments.</tt> </tt>
<a name="L833"></a><tt class="py-lineno"> 833</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L834"></a><tt class="py-lineno"> 834</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">oldkey</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt><tt class="py-op">:</tt> </tt>
<a name="L835"></a><tt class="py-lineno"> 835</tt> <tt class="py-line"> <tt class="py-name">the_list</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt> </tt>
<a name="L836"></a><tt class="py-lineno"> 836</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">oldkey</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">:</tt> </tt>
<a name="L837"></a><tt class="py-lineno"> 837</tt> <tt class="py-line"> <tt class="py-name">the_list</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt> </tt>
<a name="L838"></a><tt class="py-lineno"> 838</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L839"></a><tt class="py-lineno"> 839</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">KeyError</tt><tt class="py-op">(</tt><tt class="py-string">'Key "%s" not found.'</tt> <tt class="py-op">%</tt> <tt class="py-name">oldkey</tt><tt class="py-op">)</tt> </tt>
<a name="L840"></a><tt class="py-lineno"> 840</tt> <tt class="py-line"> <tt class="py-name">pos</tt> <tt class="py-op">=</tt> <tt class="py-name">the_list</tt><tt class="py-op">.</tt><tt class="py-name">index</tt><tt class="py-op">(</tt><tt class="py-name">oldkey</tt><tt class="py-op">)</tt> </tt>
<a name="L841"></a><tt class="py-lineno"> 841</tt> <tt class="py-line"> <tt class="py-comment">#</tt> </tt>
<a name="L842"></a><tt class="py-lineno"> 842</tt> <tt class="py-line"> <tt class="py-name">val</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">oldkey</tt><tt class="py-op">]</tt> </tt>
<a name="L843"></a><tt class="py-lineno"> 843</tt> <tt class="py-line"> <tt id="link-115" class="py-name"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-115', 'dict', 'link-68');">dict</a></tt><tt class="py-op">.</tt><tt id="link-116" class="py-name"><a title="configobj.Section.__delitem__" class="py-name" href="#" onclick="return doclink('link-116', '__delitem__', 'link-96');">__delitem__</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">oldkey</tt><tt class="py-op">)</tt> </tt>
<a name="L844"></a><tt class="py-lineno"> 844</tt> <tt class="py-line"> <tt id="link-117" class="py-name"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-117', 'dict', 'link-68');">dict</a></tt><tt class="py-op">.</tt><tt id="link-118" class="py-name"><a title="configobj.Section.__setitem__" class="py-name" href="#" onclick="return doclink('link-118', '__setitem__', 'link-87');">__setitem__</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">newkey</tt><tt class="py-op">,</tt> <tt class="py-name">val</tt><tt class="py-op">)</tt> </tt>
<a name="L845"></a><tt class="py-lineno"> 845</tt> <tt class="py-line"> <tt class="py-name">the_list</tt><tt class="py-op">.</tt><tt class="py-name">remove</tt><tt class="py-op">(</tt><tt class="py-name">oldkey</tt><tt class="py-op">)</tt> </tt>
<a name="L846"></a><tt class="py-lineno"> 846</tt> <tt class="py-line"> <tt class="py-name">the_list</tt><tt class="py-op">.</tt><tt class="py-name">insert</tt><tt class="py-op">(</tt><tt class="py-name">pos</tt><tt class="py-op">,</tt> <tt class="py-name">newkey</tt><tt class="py-op">)</tt> </tt>
<a name="L847"></a><tt class="py-lineno"> 847</tt> <tt class="py-line"> <tt class="py-name">comm</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">comments</tt><tt class="py-op">[</tt><tt class="py-name">oldkey</tt><tt class="py-op">]</tt> </tt>
<a name="L848"></a><tt class="py-lineno"> 848</tt> <tt class="py-line"> <tt class="py-name">inline_comment</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">inline_comments</tt><tt class="py-op">[</tt><tt class="py-name">oldkey</tt><tt class="py-op">]</tt> </tt>
<a name="L849"></a><tt class="py-lineno"> 849</tt> <tt class="py-line"> <tt class="py-keyword">del</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">comments</tt><tt class="py-op">[</tt><tt class="py-name">oldkey</tt><tt class="py-op">]</tt> </tt>
<a name="L850"></a><tt class="py-lineno"> 850</tt> <tt class="py-line"> <tt class="py-keyword">del</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">inline_comments</tt><tt class="py-op">[</tt><tt class="py-name">oldkey</tt><tt class="py-op">]</tt> </tt>
<a name="L851"></a><tt class="py-lineno"> 851</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">comments</tt><tt class="py-op">[</tt><tt class="py-name">newkey</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">comm</tt> </tt>
<a name="L852"></a><tt class="py-lineno"> 852</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">inline_comments</tt><tt class="py-op">[</tt><tt class="py-name">newkey</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">inline_comment</tt> </tt>
</div><a name="L853"></a><tt class="py-lineno"> 853</tt> <tt class="py-line"> </tt>
<a name="L854"></a><tt class="py-lineno"> 854</tt> <tt class="py-line"> </tt>
<a name="Section.walk"></a><div id="Section.walk-def"><a name="L855"></a><tt class="py-lineno"> 855</tt> <a class="py-toggle" href="#" id="Section.walk-toggle" onclick="return toggle('Section.walk');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#walk">walk</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">function</tt><tt class="py-op">,</tt> <tt class="py-param">raise_errors</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">,</tt> </tt>
<a name="L856"></a><tt class="py-lineno"> 856</tt> <tt class="py-line"> <tt class="py-param">call_on_sections</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">,</tt> <tt class="py-op">**</tt><tt class="py-param">keywargs</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.walk-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.walk-expanded"><a name="L857"></a><tt class="py-lineno"> 857</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L858"></a><tt class="py-lineno"> 858</tt> <tt class="py-line"><tt class="py-docstring"> Walk every member and call a function on the keyword and value.</tt> </tt>
<a name="L859"></a><tt class="py-lineno"> 859</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L860"></a><tt class="py-lineno"> 860</tt> <tt class="py-line"><tt class="py-docstring"> Return a dictionary of the return values</tt> </tt>
<a name="L861"></a><tt class="py-lineno"> 861</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L862"></a><tt class="py-lineno"> 862</tt> <tt class="py-line"><tt class="py-docstring"> If the function raises an exception, raise the errror</tt> </tt>
<a name="L863"></a><tt class="py-lineno"> 863</tt> <tt class="py-line"><tt class="py-docstring"> unless ``raise_errors=False``, in which case set the return value to</tt> </tt>
<a name="L864"></a><tt class="py-lineno"> 864</tt> <tt class="py-line"><tt class="py-docstring"> ``False``.</tt> </tt>
<a name="L865"></a><tt class="py-lineno"> 865</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L866"></a><tt class="py-lineno"> 866</tt> <tt class="py-line"><tt class="py-docstring"> Any unrecognised keyword arguments you pass to walk, will be pased on</tt> </tt>
<a name="L867"></a><tt class="py-lineno"> 867</tt> <tt class="py-line"><tt class="py-docstring"> to the function you pass in.</tt> </tt>
<a name="L868"></a><tt class="py-lineno"> 868</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L869"></a><tt class="py-lineno"> 869</tt> <tt class="py-line"><tt class="py-docstring"> Note: if ``call_on_sections`` is ``True`` then - on encountering a</tt> </tt>
<a name="L870"></a><tt class="py-lineno"> 870</tt> <tt class="py-line"><tt class="py-docstring"> subsection, *first* the function is called for the *whole* subsection,</tt> </tt>
<a name="L871"></a><tt class="py-lineno"> 871</tt> <tt class="py-line"><tt class="py-docstring"> and then recurses into it's members. This means your function must be</tt> </tt>
<a name="L872"></a><tt class="py-lineno"> 872</tt> <tt class="py-line"><tt class="py-docstring"> able to handle strings, dictionaries and lists. This allows you</tt> </tt>
<a name="L873"></a><tt class="py-lineno"> 873</tt> <tt class="py-line"><tt class="py-docstring"> to change the key of subsections as well as for ordinary members. The</tt> </tt>
<a name="L874"></a><tt class="py-lineno"> 874</tt> <tt class="py-line"><tt class="py-docstring"> return value when called on the whole subsection has to be discarded.</tt> </tt>
<a name="L875"></a><tt class="py-lineno"> 875</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L876"></a><tt class="py-lineno"> 876</tt> <tt class="py-line"><tt class="py-docstring"> See the encode and decode methods for examples, including functions.</tt> </tt>
<a name="L877"></a><tt class="py-lineno"> 877</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L878"></a><tt class="py-lineno"> 878</tt> <tt class="py-line"><tt class="py-docstring"> .. admonition:: caution</tt> </tt>
<a name="L879"></a><tt class="py-lineno"> 879</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L880"></a><tt class="py-lineno"> 880</tt> <tt class="py-line"><tt class="py-docstring"> You can use ``walk`` to transform the names of members of a section</tt> </tt>
<a name="L881"></a><tt class="py-lineno"> 881</tt> <tt class="py-line"><tt class="py-docstring"> but you mustn't add or delete members.</tt> </tt>
<a name="L882"></a><tt class="py-lineno"> 882</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L883"></a><tt class="py-lineno"> 883</tt> <tt class="py-line"><tt class="py-docstring"> >>> config = '''[XXXXsection]</tt> </tt>
<a name="L884"></a><tt class="py-lineno"> 884</tt> <tt class="py-line"><tt class="py-docstring"> ... XXXXkey = XXXXvalue'''.splitlines()</tt> </tt>
<a name="L885"></a><tt class="py-lineno"> 885</tt> <tt class="py-line"><tt class="py-docstring"> >>> cfg = ConfigObj(config)</tt> </tt>
<a name="L886"></a><tt class="py-lineno"> 886</tt> <tt class="py-line"><tt class="py-docstring"> >>> cfg</tt> </tt>
<a name="L887"></a><tt class="py-lineno"> 887</tt> <tt class="py-line"><tt class="py-docstring"> ConfigObj({'XXXXsection': {'XXXXkey': 'XXXXvalue'}})</tt> </tt>
<a name="L888"></a><tt class="py-lineno"> 888</tt> <tt class="py-line"><tt class="py-docstring"> >>> def transform(section, key):</tt> </tt>
<a name="L889"></a><tt class="py-lineno"> 889</tt> <tt class="py-line"><tt class="py-docstring"> ... val = section[key]</tt> </tt>
<a name="L890"></a><tt class="py-lineno"> 890</tt> <tt class="py-line"><tt class="py-docstring"> ... newkey = key.replace('XXXX', 'CLIENT1')</tt> </tt>
<a name="L891"></a><tt class="py-lineno"> 891</tt> <tt class="py-line"><tt class="py-docstring"> ... section.rename(key, newkey)</tt> </tt>
<a name="L892"></a><tt class="py-lineno"> 892</tt> <tt class="py-line"><tt class="py-docstring"> ... if isinstance(val, (tuple, list, dict)):</tt> </tt>
<a name="L893"></a><tt class="py-lineno"> 893</tt> <tt class="py-line"><tt class="py-docstring"> ... pass</tt> </tt>
<a name="L894"></a><tt class="py-lineno"> 894</tt> <tt class="py-line"><tt class="py-docstring"> ... else:</tt> </tt>
<a name="L895"></a><tt class="py-lineno"> 895</tt> <tt class="py-line"><tt class="py-docstring"> ... val = val.replace('XXXX', 'CLIENT1')</tt> </tt>
<a name="L896"></a><tt class="py-lineno"> 896</tt> <tt class="py-line"><tt class="py-docstring"> ... section[newkey] = val</tt> </tt>
<a name="L897"></a><tt class="py-lineno"> 897</tt> <tt class="py-line"><tt class="py-docstring"> >>> cfg.walk(transform, call_on_sections=True)</tt> </tt>
<a name="L898"></a><tt class="py-lineno"> 898</tt> <tt class="py-line"><tt class="py-docstring"> {'CLIENT1section': {'CLIENT1key': None}}</tt> </tt>
<a name="L899"></a><tt class="py-lineno"> 899</tt> <tt class="py-line"><tt class="py-docstring"> >>> cfg</tt> </tt>
<a name="L900"></a><tt class="py-lineno"> 900</tt> <tt class="py-line"><tt class="py-docstring"> ConfigObj({'CLIENT1section': {'CLIENT1key': 'CLIENT1value'}})</tt> </tt>
<a name="L901"></a><tt class="py-lineno"> 901</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L902"></a><tt class="py-lineno"> 902</tt> <tt class="py-line"> <tt class="py-name">out</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
<a name="L903"></a><tt class="py-lineno"> 903</tt> <tt class="py-line"> <tt class="py-comment"># scalars first</tt> </tt>
<a name="L904"></a><tt class="py-lineno"> 904</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L905"></a><tt class="py-lineno"> 905</tt> <tt class="py-line"> <tt class="py-name">entry</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> </tt>
<a name="L906"></a><tt class="py-lineno"> 906</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
<a name="L907"></a><tt class="py-lineno"> 907</tt> <tt class="py-line"> <tt class="py-name">val</tt> <tt class="py-op">=</tt> <tt class="py-name">function</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">entry</tt><tt class="py-op">,</tt> <tt class="py-op">**</tt><tt class="py-name">keywargs</tt><tt class="py-op">)</tt> </tt>
<a name="L908"></a><tt class="py-lineno"> 908</tt> <tt class="py-line"> <tt class="py-comment"># bound again in case name has changed</tt> </tt>
<a name="L909"></a><tt class="py-lineno"> 909</tt> <tt class="py-line"> <tt class="py-name">entry</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> </tt>
<a name="L910"></a><tt class="py-lineno"> 910</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">val</tt> </tt>
<a name="L911"></a><tt class="py-lineno"> 911</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">Exception</tt><tt class="py-op">:</tt> </tt>
<a name="L912"></a><tt class="py-lineno"> 912</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">raise_errors</tt><tt class="py-op">:</tt> </tt>
<a name="L913"></a><tt class="py-lineno"> 913</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> </tt>
<a name="L914"></a><tt class="py-lineno"> 914</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L915"></a><tt class="py-lineno"> 915</tt> <tt class="py-line"> <tt class="py-name">entry</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> </tt>
<a name="L916"></a><tt class="py-lineno"> 916</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L917"></a><tt class="py-lineno"> 917</tt> <tt class="py-line"> <tt class="py-comment"># then sections</tt> </tt>
<a name="L918"></a><tt class="py-lineno"> 918</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L919"></a><tt class="py-lineno"> 919</tt> <tt class="py-line"> <tt class="py-name">entry</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> </tt>
<a name="L920"></a><tt class="py-lineno"> 920</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">call_on_sections</tt><tt class="py-op">:</tt> </tt>
<a name="L921"></a><tt class="py-lineno"> 921</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
<a name="L922"></a><tt class="py-lineno"> 922</tt> <tt class="py-line"> <tt class="py-name">function</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">entry</tt><tt class="py-op">,</tt> <tt class="py-op">**</tt><tt class="py-name">keywargs</tt><tt class="py-op">)</tt> </tt>
<a name="L923"></a><tt class="py-lineno"> 923</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">Exception</tt><tt class="py-op">:</tt> </tt>
<a name="L924"></a><tt class="py-lineno"> 924</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">raise_errors</tt><tt class="py-op">:</tt> </tt>
<a name="L925"></a><tt class="py-lineno"> 925</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> </tt>
<a name="L926"></a><tt class="py-lineno"> 926</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L927"></a><tt class="py-lineno"> 927</tt> <tt class="py-line"> <tt class="py-name">entry</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> </tt>
<a name="L928"></a><tt class="py-lineno"> 928</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L929"></a><tt class="py-lineno"> 929</tt> <tt class="py-line"> <tt class="py-comment"># bound again in case name has changed</tt> </tt>
<a name="L930"></a><tt class="py-lineno"> 930</tt> <tt class="py-line"> <tt class="py-name">entry</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> </tt>
<a name="L931"></a><tt class="py-lineno"> 931</tt> <tt class="py-line"> <tt class="py-comment"># previous result is discarded</tt> </tt>
<a name="L932"></a><tt class="py-lineno"> 932</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt id="link-119" class="py-name" targets="Method configobj.Section.walk()=configobj.Section-class.html#walk"><a title="configobj.Section.walk" class="py-name" href="#" onclick="return doclink('link-119', 'walk', 'link-119');">walk</a></tt><tt class="py-op">(</tt> </tt>
<a name="L933"></a><tt class="py-lineno"> 933</tt> <tt class="py-line"> <tt class="py-name">function</tt><tt class="py-op">,</tt> </tt>
<a name="L934"></a><tt class="py-lineno"> 934</tt> <tt class="py-line"> <tt class="py-name">raise_errors</tt><tt class="py-op">=</tt><tt class="py-name">raise_errors</tt><tt class="py-op">,</tt> </tt>
<a name="L935"></a><tt class="py-lineno"> 935</tt> <tt class="py-line"> <tt class="py-name">call_on_sections</tt><tt class="py-op">=</tt><tt class="py-name">call_on_sections</tt><tt class="py-op">,</tt> </tt>
<a name="L936"></a><tt class="py-lineno"> 936</tt> <tt class="py-line"> <tt class="py-op">**</tt><tt class="py-name">keywargs</tt><tt class="py-op">)</tt> </tt>
<a name="L937"></a><tt class="py-lineno"> 937</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">out</tt> </tt>
</div><a name="L938"></a><tt class="py-lineno"> 938</tt> <tt class="py-line"> </tt>
<a name="L939"></a><tt class="py-lineno"> 939</tt> <tt class="py-line"> </tt>
<a name="Section.as_bool"></a><div id="Section.as_bool-def"><a name="L940"></a><tt class="py-lineno"> 940</tt> <a class="py-toggle" href="#" id="Section.as_bool-toggle" onclick="return toggle('Section.as_bool');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#as_bool">as_bool</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">key</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.as_bool-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.as_bool-expanded"><a name="L941"></a><tt class="py-lineno"> 941</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L942"></a><tt class="py-lineno"> 942</tt> <tt class="py-line"><tt class="py-docstring"> Accepts a key as input. The corresponding value must be a string or</tt> </tt>
<a name="L943"></a><tt class="py-lineno"> 943</tt> <tt class="py-line"><tt class="py-docstring"> the objects (``True`` or 1) or (``False`` or 0). We allow 0 and 1 to</tt> </tt>
<a name="L944"></a><tt class="py-lineno"> 944</tt> <tt class="py-line"><tt class="py-docstring"> retain compatibility with Python 2.2.</tt> </tt>
<a name="L945"></a><tt class="py-lineno"> 945</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L946"></a><tt class="py-lineno"> 946</tt> <tt class="py-line"><tt class="py-docstring"> If the string is one of ``True``, ``On``, ``Yes``, or ``1`` it returns </tt> </tt>
<a name="L947"></a><tt class="py-lineno"> 947</tt> <tt class="py-line"><tt class="py-docstring"> ``True``.</tt> </tt>
<a name="L948"></a><tt class="py-lineno"> 948</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L949"></a><tt class="py-lineno"> 949</tt> <tt class="py-line"><tt class="py-docstring"> If the string is one of ``False``, ``Off``, ``No``, or ``0`` it returns </tt> </tt>
<a name="L950"></a><tt class="py-lineno"> 950</tt> <tt class="py-line"><tt class="py-docstring"> ``False``.</tt> </tt>
<a name="L951"></a><tt class="py-lineno"> 951</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L952"></a><tt class="py-lineno"> 952</tt> <tt class="py-line"><tt class="py-docstring"> ``as_bool`` is not case sensitive.</tt> </tt>
<a name="L953"></a><tt class="py-lineno"> 953</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L954"></a><tt class="py-lineno"> 954</tt> <tt class="py-line"><tt class="py-docstring"> Any other input will raise a ``ValueError``.</tt> </tt>
<a name="L955"></a><tt class="py-lineno"> 955</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L956"></a><tt class="py-lineno"> 956</tt> <tt class="py-line"><tt class="py-docstring"> >>> a = ConfigObj()</tt> </tt>
<a name="L957"></a><tt class="py-lineno"> 957</tt> <tt class="py-line"><tt class="py-docstring"> >>> a['a'] = 'fish'</tt> </tt>
<a name="L958"></a><tt class="py-lineno"> 958</tt> <tt class="py-line"><tt class="py-docstring"> >>> a.as_bool('a')</tt> </tt>
<a name="L959"></a><tt class="py-lineno"> 959</tt> <tt class="py-line"><tt class="py-docstring"> Traceback (most recent call last):</tt> </tt>
<a name="L960"></a><tt class="py-lineno"> 960</tt> <tt class="py-line"><tt class="py-docstring"> ValueError: Value "fish" is neither True nor False</tt> </tt>
<a name="L961"></a><tt class="py-lineno"> 961</tt> <tt class="py-line"><tt class="py-docstring"> >>> a['b'] = 'True'</tt> </tt>
<a name="L962"></a><tt class="py-lineno"> 962</tt> <tt class="py-line"><tt class="py-docstring"> >>> a.as_bool('b')</tt> </tt>
<a name="L963"></a><tt class="py-lineno"> 963</tt> <tt class="py-line"><tt class="py-docstring"> 1</tt> </tt>
<a name="L964"></a><tt class="py-lineno"> 964</tt> <tt class="py-line"><tt class="py-docstring"> >>> a['b'] = 'off'</tt> </tt>
<a name="L965"></a><tt class="py-lineno"> 965</tt> <tt class="py-line"><tt class="py-docstring"> >>> a.as_bool('b')</tt> </tt>
<a name="L966"></a><tt class="py-lineno"> 966</tt> <tt class="py-line"><tt class="py-docstring"> 0</tt> </tt>
<a name="L967"></a><tt class="py-lineno"> 967</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L968"></a><tt class="py-lineno"> 968</tt> <tt class="py-line"> <tt class="py-name">val</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> </tt>
<a name="L969"></a><tt class="py-lineno"> 969</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">val</tt> <tt class="py-op">==</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt>
<a name="L970"></a><tt class="py-lineno"> 970</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt>
<a name="L971"></a><tt class="py-lineno"> 971</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">val</tt> <tt class="py-op">==</tt> <tt class="py-name">False</tt><tt class="py-op">:</tt> </tt>
<a name="L972"></a><tt class="py-lineno"> 972</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt>
<a name="L973"></a><tt class="py-lineno"> 973</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L974"></a><tt class="py-lineno"> 974</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
<a name="L975"></a><tt class="py-lineno"> 975</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">val</tt><tt class="py-op">,</tt> <tt class="py-name">basestring</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L976"></a><tt class="py-lineno"> 976</tt> <tt class="py-line"> <tt class="py-comment"># TODO: Why do we raise a KeyError here?</tt> </tt>
<a name="L977"></a><tt class="py-lineno"> 977</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">KeyError</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L978"></a><tt class="py-lineno"> 978</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L979"></a><tt class="py-lineno"> 979</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">main</tt><tt class="py-op">.</tt><tt id="link-120" class="py-name" targets="Variable configobj.ConfigObj._bools=configobj.ConfigObj-class.html#_bools"><a title="configobj.ConfigObj._bools" class="py-name" href="#" onclick="return doclink('link-120', '_bools', 'link-120');">_bools</a></tt><tt class="py-op">[</tt><tt class="py-name">val</tt><tt class="py-op">.</tt><tt class="py-name">lower</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt>
<a name="L980"></a><tt class="py-lineno"> 980</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">KeyError</tt><tt class="py-op">:</tt> </tt>
<a name="L981"></a><tt class="py-lineno"> 981</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'Value "%s" is neither True nor False'</tt> <tt class="py-op">%</tt> <tt class="py-name">val</tt><tt class="py-op">)</tt> </tt>
</div><a name="L982"></a><tt class="py-lineno"> 982</tt> <tt class="py-line"> </tt>
<a name="L983"></a><tt class="py-lineno"> 983</tt> <tt class="py-line"> </tt>
<a name="Section.as_int"></a><div id="Section.as_int-def"><a name="L984"></a><tt class="py-lineno"> 984</tt> <a class="py-toggle" href="#" id="Section.as_int-toggle" onclick="return toggle('Section.as_int');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#as_int">as_int</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">key</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.as_int-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.as_int-expanded"><a name="L985"></a><tt class="py-lineno"> 985</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L986"></a><tt class="py-lineno"> 986</tt> <tt class="py-line"><tt class="py-docstring"> A convenience method which coerces the specified value to an integer.</tt> </tt>
<a name="L987"></a><tt class="py-lineno"> 987</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L988"></a><tt class="py-lineno"> 988</tt> <tt class="py-line"><tt class="py-docstring"> If the value is an invalid literal for ``int``, a ``ValueError`` will</tt> </tt>
<a name="L989"></a><tt class="py-lineno"> 989</tt> <tt class="py-line"><tt class="py-docstring"> be raised.</tt> </tt>
<a name="L990"></a><tt class="py-lineno"> 990</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L991"></a><tt class="py-lineno"> 991</tt> <tt class="py-line"><tt class="py-docstring"> >>> a = ConfigObj()</tt> </tt>
<a name="L992"></a><tt class="py-lineno"> 992</tt> <tt class="py-line"><tt class="py-docstring"> >>> a['a'] = 'fish'</tt> </tt>
<a name="L993"></a><tt class="py-lineno"> 993</tt> <tt class="py-line"><tt class="py-docstring"> >>> a.as_int('a')</tt> </tt>
<a name="L994"></a><tt class="py-lineno"> 994</tt> <tt class="py-line"><tt class="py-docstring"> Traceback (most recent call last):</tt> </tt>
<a name="L995"></a><tt class="py-lineno"> 995</tt> <tt class="py-line"><tt class="py-docstring"> ValueError: invalid literal for int() with base 10: 'fish'</tt> </tt>
<a name="L996"></a><tt class="py-lineno"> 996</tt> <tt class="py-line"><tt class="py-docstring"> >>> a['b'] = '1'</tt> </tt>
<a name="L997"></a><tt class="py-lineno"> 997</tt> <tt class="py-line"><tt class="py-docstring"> >>> a.as_int('b')</tt> </tt>
<a name="L998"></a><tt class="py-lineno"> 998</tt> <tt class="py-line"><tt class="py-docstring"> 1</tt> </tt>
<a name="L999"></a><tt class="py-lineno"> 999</tt> <tt class="py-line"><tt class="py-docstring"> >>> a['b'] = '3.2'</tt> </tt>
<a name="L1000"></a><tt class="py-lineno">1000</tt> <tt class="py-line"><tt class="py-docstring"> >>> a.as_int('b')</tt> </tt>
<a name="L1001"></a><tt class="py-lineno">1001</tt> <tt class="py-line"><tt class="py-docstring"> Traceback (most recent call last):</tt> </tt>
<a name="L1002"></a><tt class="py-lineno">1002</tt> <tt class="py-line"><tt class="py-docstring"> ValueError: invalid literal for int() with base 10: '3.2'</tt> </tt>
<a name="L1003"></a><tt class="py-lineno">1003</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L1004"></a><tt class="py-lineno">1004</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
</div><a name="L1005"></a><tt class="py-lineno">1005</tt> <tt class="py-line"> </tt>
<a name="L1006"></a><tt class="py-lineno">1006</tt> <tt class="py-line"> </tt>
<a name="Section.as_float"></a><div id="Section.as_float-def"><a name="L1007"></a><tt class="py-lineno">1007</tt> <a class="py-toggle" href="#" id="Section.as_float-toggle" onclick="return toggle('Section.as_float');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#as_float">as_float</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">key</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.as_float-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.as_float-expanded"><a name="L1008"></a><tt class="py-lineno">1008</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L1009"></a><tt class="py-lineno">1009</tt> <tt class="py-line"><tt class="py-docstring"> A convenience method which coerces the specified value to a float.</tt> </tt>
<a name="L1010"></a><tt class="py-lineno">1010</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L1011"></a><tt class="py-lineno">1011</tt> <tt class="py-line"><tt class="py-docstring"> If the value is an invalid literal for ``float``, a ``ValueError`` will</tt> </tt>
<a name="L1012"></a><tt class="py-lineno">1012</tt> <tt class="py-line"><tt class="py-docstring"> be raised.</tt> </tt>
<a name="L1013"></a><tt class="py-lineno">1013</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L1014"></a><tt class="py-lineno">1014</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">float</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
</div><a name="L1015"></a><tt class="py-lineno">1015</tt> <tt class="py-line"> </tt>
<a name="L1016"></a><tt class="py-lineno">1016</tt> <tt class="py-line"> </tt>
<a name="Section.as_list"></a><div id="Section.as_list-def"><a name="L1017"></a><tt class="py-lineno">1017</tt> <a class="py-toggle" href="#" id="Section.as_list-toggle" onclick="return toggle('Section.as_list');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#as_list">as_list</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">key</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.as_list-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.as_list-expanded"><a name="L1018"></a><tt class="py-lineno">1018</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L1019"></a><tt class="py-lineno">1019</tt> <tt class="py-line"><tt class="py-docstring"> A convenience method which fetches the specified value, guaranteeing</tt> </tt>
<a name="L1020"></a><tt class="py-lineno">1020</tt> <tt class="py-line"><tt class="py-docstring"> that it is a list.</tt> </tt>
<a name="L1021"></a><tt class="py-lineno">1021</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L1022"></a><tt class="py-lineno">1022</tt> <tt class="py-line"><tt class="py-docstring"> >>> a = ConfigObj()</tt> </tt>
<a name="L1023"></a><tt class="py-lineno">1023</tt> <tt class="py-line"><tt class="py-docstring"> >>> a['a'] = 1</tt> </tt>
<a name="L1024"></a><tt class="py-lineno">1024</tt> <tt class="py-line"><tt class="py-docstring"> >>> a.as_list('a')</tt> </tt>
<a name="L1025"></a><tt class="py-lineno">1025</tt> <tt class="py-line"><tt class="py-docstring"> [1]</tt> </tt>
<a name="L1026"></a><tt class="py-lineno">1026</tt> <tt class="py-line"><tt class="py-docstring"> >>> a['a'] = (1,)</tt> </tt>
<a name="L1027"></a><tt class="py-lineno">1027</tt> <tt class="py-line"><tt class="py-docstring"> >>> a.as_list('a')</tt> </tt>
<a name="L1028"></a><tt class="py-lineno">1028</tt> <tt class="py-line"><tt class="py-docstring"> [1]</tt> </tt>
<a name="L1029"></a><tt class="py-lineno">1029</tt> <tt class="py-line"><tt class="py-docstring"> >>> a['a'] = [1]</tt> </tt>
<a name="L1030"></a><tt class="py-lineno">1030</tt> <tt class="py-line"><tt class="py-docstring"> >>> a.as_list('a')</tt> </tt>
<a name="L1031"></a><tt class="py-lineno">1031</tt> <tt class="py-line"><tt class="py-docstring"> [1]</tt> </tt>
<a name="L1032"></a><tt class="py-lineno">1032</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L1033"></a><tt class="py-lineno">1033</tt> <tt class="py-line"> <tt class="py-name">result</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> </tt>
<a name="L1034"></a><tt class="py-lineno">1034</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">result</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">tuple</tt><tt class="py-op">,</tt> <tt class="py-name">list</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1035"></a><tt class="py-lineno">1035</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">result</tt><tt class="py-op">)</tt> </tt>
<a name="L1036"></a><tt class="py-lineno">1036</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">[</tt><tt class="py-name">result</tt><tt class="py-op">]</tt> </tt>
</div><a name="L1037"></a><tt class="py-lineno">1037</tt> <tt class="py-line"> </tt>
<a name="L1038"></a><tt class="py-lineno">1038</tt> <tt class="py-line"> </tt>
<a name="Section.restore_default"></a><div id="Section.restore_default-def"><a name="L1039"></a><tt class="py-lineno">1039</tt> <a class="py-toggle" href="#" id="Section.restore_default-toggle" onclick="return toggle('Section.restore_default');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#restore_default">restore_default</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">key</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.restore_default-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.restore_default-expanded"><a name="L1040"></a><tt class="py-lineno">1040</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L1041"></a><tt class="py-lineno">1041</tt> <tt class="py-line"><tt class="py-docstring"> Restore (and return) default value for the specified key.</tt> </tt>
<a name="L1042"></a><tt class="py-lineno">1042</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L1043"></a><tt class="py-lineno">1043</tt> <tt class="py-line"><tt class="py-docstring"> This method will only work for a ConfigObj that was created</tt> </tt>
<a name="L1044"></a><tt class="py-lineno">1044</tt> <tt class="py-line"><tt class="py-docstring"> with a configspec and has been validated.</tt> </tt>
<a name="L1045"></a><tt class="py-lineno">1045</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L1046"></a><tt class="py-lineno">1046</tt> <tt class="py-line"><tt class="py-docstring"> If there is no default value for this key, ``KeyError`` is raised.</tt> </tt>
<a name="L1047"></a><tt class="py-lineno">1047</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L1048"></a><tt class="py-lineno">1048</tt> <tt class="py-line"> <tt class="py-name">default</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">default_values</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> </tt>
<a name="L1049"></a><tt class="py-lineno">1049</tt> <tt class="py-line"> <tt id="link-121" class="py-name"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-121', 'dict', 'link-68');">dict</a></tt><tt class="py-op">.</tt><tt id="link-122" class="py-name"><a title="configobj.Section.__setitem__" class="py-name" href="#" onclick="return doclink('link-122', '__setitem__', 'link-87');">__setitem__</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">default</tt><tt class="py-op">)</tt> </tt>
<a name="L1050"></a><tt class="py-lineno">1050</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">key</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">defaults</tt><tt class="py-op">:</tt> </tt>
<a name="L1051"></a><tt class="py-lineno">1051</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">defaults</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<a name="L1052"></a><tt class="py-lineno">1052</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">default</tt> </tt>
</div><a name="L1053"></a><tt class="py-lineno">1053</tt> <tt class="py-line"> </tt>
<a name="L1054"></a><tt class="py-lineno">1054</tt> <tt class="py-line"> </tt>
<a name="Section.restore_defaults"></a><div id="Section.restore_defaults-def"><a name="L1055"></a><tt class="py-lineno">1055</tt> <a class="py-toggle" href="#" id="Section.restore_defaults-toggle" onclick="return toggle('Section.restore_defaults');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.Section-class.html#restore_defaults">restore_defaults</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="Section.restore_defaults-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Section.restore_defaults-expanded"><a name="L1056"></a><tt class="py-lineno">1056</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L1057"></a><tt class="py-lineno">1057</tt> <tt class="py-line"><tt class="py-docstring"> Recursively restore default values to all members</tt> </tt>
<a name="L1058"></a><tt class="py-lineno">1058</tt> <tt class="py-line"><tt class="py-docstring"> that have them.</tt> </tt>
<a name="L1059"></a><tt class="py-lineno">1059</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L1060"></a><tt class="py-lineno">1060</tt> <tt class="py-line"><tt class="py-docstring"> This method will only work for a ConfigObj that was created</tt> </tt>
<a name="L1061"></a><tt class="py-lineno">1061</tt> <tt class="py-line"><tt class="py-docstring"> with a configspec and has been validated.</tt> </tt>
<a name="L1062"></a><tt class="py-lineno">1062</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L1063"></a><tt class="py-lineno">1063</tt> <tt class="py-line"><tt class="py-docstring"> It doesn't delete or modify entries without default values.</tt> </tt>
<a name="L1064"></a><tt class="py-lineno">1064</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L1065"></a><tt class="py-lineno">1065</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">key</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">default_values</tt><tt class="py-op">:</tt> </tt>
<a name="L1066"></a><tt class="py-lineno">1066</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-123" class="py-name" targets="Method configobj.Section.restore_default()=configobj.Section-class.html#restore_default"><a title="configobj.Section.restore_default" class="py-name" href="#" onclick="return doclink('link-123', 'restore_default', 'link-123');">restore_default</a></tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<a name="L1067"></a><tt class="py-lineno">1067</tt> <tt class="py-line"> </tt>
<a name="L1068"></a><tt class="py-lineno">1068</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">section</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">:</tt> </tt>
<a name="L1069"></a><tt class="py-lineno">1069</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">section</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt id="link-124" class="py-name" targets="Method configobj.Section.restore_defaults()=configobj.Section-class.html#restore_defaults"><a title="configobj.Section.restore_defaults" class="py-name" href="#" onclick="return doclink('link-124', 'restore_defaults', 'link-124');">restore_defaults</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
</div></div><a name="L1070"></a><tt class="py-lineno">1070</tt> <tt class="py-line"> </tt>
<a name="L1071"></a><tt class="py-lineno">1071</tt> <tt class="py-line"> </tt>
<a name="ConfigObj"></a><div id="ConfigObj-def"><a name="L1072"></a><tt class="py-lineno">1072</tt> <a class="py-toggle" href="#" id="ConfigObj-toggle" onclick="return toggle('ConfigObj');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html">ConfigObj</a><tt class="py-op">(</tt><tt class="py-base-class">Section</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="ConfigObj-expanded"><a name="L1073"></a><tt class="py-lineno">1073</tt> <tt class="py-line"> <tt class="py-docstring">"""An object to read, create, and write config files."""</tt> </tt>
<a name="L1074"></a><tt class="py-lineno">1074</tt> <tt class="py-line"> </tt>
<a name="L1075"></a><tt class="py-lineno">1075</tt> <tt class="py-line"> <tt id="link-125" class="py-name" targets="Variable configobj.ConfigObj._keyword=configobj.ConfigObj-class.html#_keyword"><a title="configobj.ConfigObj._keyword" class="py-name" href="#" onclick="return doclink('link-125', '_keyword', 'link-125');">_keyword</a></tt> <tt class="py-op">=</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">compile</tt><tt class="py-op">(</tt><tt class="py-string">r'''^ # line start</tt> </tt>
<a name="L1076"></a><tt class="py-lineno">1076</tt> <tt class="py-line"><tt class="py-string"> (\s*) # indentation</tt> </tt>
<a name="L1077"></a><tt class="py-lineno">1077</tt> <tt class="py-line"><tt class="py-string"> ( # keyword</tt> </tt>
<a name="L1078"></a><tt class="py-lineno">1078</tt> <tt class="py-line"><tt class="py-string"> (?:".*?")| # double quotes</tt> </tt>
<a name="L1079"></a><tt class="py-lineno">1079</tt> <tt class="py-line"><tt class="py-string"> (?:'.*?')| # single quotes</tt> </tt>
<a name="L1080"></a><tt class="py-lineno">1080</tt> <tt class="py-line"><tt class="py-string"> (?:[^'"=].*?) # no quotes</tt> </tt>
<a name="L1081"></a><tt class="py-lineno">1081</tt> <tt class="py-line"><tt class="py-string"> )</tt> </tt>
<a name="L1082"></a><tt class="py-lineno">1082</tt> <tt class="py-line"><tt class="py-string"> \s*=\s* # divider</tt> </tt>
<a name="L1083"></a><tt class="py-lineno">1083</tt> <tt class="py-line"><tt class="py-string"> (.*) # value (including list values and comments)</tt> </tt>
<a name="L1084"></a><tt class="py-lineno">1084</tt> <tt class="py-line"><tt class="py-string"> $ # line end</tt> </tt>
<a name="L1085"></a><tt class="py-lineno">1085</tt> <tt class="py-line"><tt class="py-string"> '''</tt><tt class="py-op">,</tt> </tt>
<a name="L1086"></a><tt class="py-lineno">1086</tt> <tt class="py-line"> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">VERBOSE</tt><tt class="py-op">)</tt> </tt>
<a name="L1087"></a><tt class="py-lineno">1087</tt> <tt class="py-line"> </tt>
<a name="L1088"></a><tt class="py-lineno">1088</tt> <tt class="py-line"> <tt id="link-126" class="py-name" targets="Variable configobj.ConfigObj._sectionmarker=configobj.ConfigObj-class.html#_sectionmarker"><a title="configobj.ConfigObj._sectionmarker" class="py-name" href="#" onclick="return doclink('link-126', '_sectionmarker', 'link-126');">_sectionmarker</a></tt> <tt class="py-op">=</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">compile</tt><tt class="py-op">(</tt><tt class="py-string">r'''^</tt> </tt>
<a name="L1089"></a><tt class="py-lineno">1089</tt> <tt class="py-line"><tt class="py-string"> (\s*) # 1: indentation</tt> </tt>
<a name="L1090"></a><tt class="py-lineno">1090</tt> <tt class="py-line"><tt class="py-string"> ((?:\[\s*)+) # 2: section marker open</tt> </tt>
<a name="L1091"></a><tt class="py-lineno">1091</tt> <tt class="py-line"><tt class="py-string"> ( # 3: section name open</tt> </tt>
<a name="L1092"></a><tt class="py-lineno">1092</tt> <tt class="py-line"><tt class="py-string"> (?:"\s*\S.*?\s*")| # at least one non-space with double quotes</tt> </tt>
<a name="L1093"></a><tt class="py-lineno">1093</tt> <tt class="py-line"><tt class="py-string"> (?:'\s*\S.*?\s*')| # at least one non-space with single quotes</tt> </tt>
<a name="L1094"></a><tt class="py-lineno">1094</tt> <tt class="py-line"><tt class="py-string"> (?:[^'"\s].*?) # at least one non-space unquoted</tt> </tt>
<a name="L1095"></a><tt class="py-lineno">1095</tt> <tt class="py-line"><tt class="py-string"> ) # section name close</tt> </tt>
<a name="L1096"></a><tt class="py-lineno">1096</tt> <tt class="py-line"><tt class="py-string"> ((?:\s*\])+) # 4: section marker close</tt> </tt>
<a name="L1097"></a><tt class="py-lineno">1097</tt> <tt class="py-line"><tt class="py-string"> \s*(\#.*)? # 5: optional comment</tt> </tt>
<a name="L1098"></a><tt class="py-lineno">1098</tt> <tt class="py-line"><tt class="py-string"> $'''</tt><tt class="py-op">,</tt> </tt>
<a name="L1099"></a><tt class="py-lineno">1099</tt> <tt class="py-line"> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">VERBOSE</tt><tt class="py-op">)</tt> </tt>
<a name="L1100"></a><tt class="py-lineno">1100</tt> <tt class="py-line"> </tt>
<a name="L1101"></a><tt class="py-lineno">1101</tt> <tt class="py-line"> <tt class="py-comment"># this regexp pulls list values out as a single string</tt> </tt>
<a name="L1102"></a><tt class="py-lineno">1102</tt> <tt class="py-line"> <tt class="py-comment"># or single values and comments</tt> </tt>
<a name="L1103"></a><tt class="py-lineno">1103</tt> <tt class="py-line"> <tt class="py-comment"># FIXME: this regex adds a '' to the end of comma terminated lists</tt> </tt>
<a name="L1104"></a><tt class="py-lineno">1104</tt> <tt class="py-line"> <tt class="py-comment"># workaround in ``_handle_value``</tt> </tt>
<a name="L1105"></a><tt class="py-lineno">1105</tt> <tt class="py-line"> <tt id="link-127" class="py-name" targets="Variable configobj.ConfigObj._valueexp=configobj.ConfigObj-class.html#_valueexp"><a title="configobj.ConfigObj._valueexp" class="py-name" href="#" onclick="return doclink('link-127', '_valueexp', 'link-127');">_valueexp</a></tt> <tt class="py-op">=</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">compile</tt><tt class="py-op">(</tt><tt class="py-string">r'''^</tt> </tt>
<a name="L1106"></a><tt class="py-lineno">1106</tt> <tt class="py-line"><tt class="py-string"> (?:</tt> </tt>
<a name="L1107"></a><tt class="py-lineno">1107</tt> <tt class="py-line"><tt class="py-string"> (?:</tt> </tt>
<a name="L1108"></a><tt class="py-lineno">1108</tt> <tt class="py-line"><tt class="py-string"> (</tt> </tt>
<a name="L1109"></a><tt class="py-lineno">1109</tt> <tt class="py-line"><tt class="py-string"> (?:</tt> </tt>
<a name="L1110"></a><tt class="py-lineno">1110</tt> <tt class="py-line"><tt class="py-string"> (?:</tt> </tt>
<a name="L1111"></a><tt class="py-lineno">1111</tt> <tt class="py-line"><tt class="py-string"> (?:".*?")| # double quotes</tt> </tt>
<a name="L1112"></a><tt class="py-lineno">1112</tt> <tt class="py-line"><tt class="py-string"> (?:'.*?')| # single quotes</tt> </tt>
<a name="L1113"></a><tt class="py-lineno">1113</tt> <tt class="py-line"><tt class="py-string"> (?:[^'",\#][^,\#]*?) # unquoted</tt> </tt>
<a name="L1114"></a><tt class="py-lineno">1114</tt> <tt class="py-line"><tt class="py-string"> )</tt> </tt>
<a name="L1115"></a><tt class="py-lineno">1115</tt> <tt class="py-line"><tt class="py-string"> \s*,\s* # comma</tt> </tt>
<a name="L1116"></a><tt class="py-lineno">1116</tt> <tt class="py-line"><tt class="py-string"> )* # match all list items ending in a comma (if any)</tt> </tt>
<a name="L1117"></a><tt class="py-lineno">1117</tt> <tt class="py-line"><tt class="py-string"> )</tt> </tt>
<a name="L1118"></a><tt class="py-lineno">1118</tt> <tt class="py-line"><tt class="py-string"> (</tt> </tt>
<a name="L1119"></a><tt class="py-lineno">1119</tt> <tt class="py-line"><tt class="py-string"> (?:".*?")| # double quotes</tt> </tt>
<a name="L1120"></a><tt class="py-lineno">1120</tt> <tt class="py-line"><tt class="py-string"> (?:'.*?')| # single quotes</tt> </tt>
<a name="L1121"></a><tt class="py-lineno">1121</tt> <tt class="py-line"><tt class="py-string"> (?:[^'",\#\s][^,]*?)| # unquoted</tt> </tt>
<a name="L1122"></a><tt class="py-lineno">1122</tt> <tt class="py-line"><tt class="py-string"> (?:(?<!,)) # Empty value</tt> </tt>
<a name="L1123"></a><tt class="py-lineno">1123</tt> <tt class="py-line"><tt class="py-string"> )? # last item in a list - or string value</tt> </tt>
<a name="L1124"></a><tt class="py-lineno">1124</tt> <tt class="py-line"><tt class="py-string"> )|</tt> </tt>
<a name="L1125"></a><tt class="py-lineno">1125</tt> <tt class="py-line"><tt class="py-string"> (,) # alternatively a single comma - empty list</tt> </tt>
<a name="L1126"></a><tt class="py-lineno">1126</tt> <tt class="py-line"><tt class="py-string"> )</tt> </tt>
<a name="L1127"></a><tt class="py-lineno">1127</tt> <tt class="py-line"><tt class="py-string"> \s*(\#.*)? # optional comment</tt> </tt>
<a name="L1128"></a><tt class="py-lineno">1128</tt> <tt class="py-line"><tt class="py-string"> $'''</tt><tt class="py-op">,</tt> </tt>
<a name="L1129"></a><tt class="py-lineno">1129</tt> <tt class="py-line"> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">VERBOSE</tt><tt class="py-op">)</tt> </tt>
<a name="L1130"></a><tt class="py-lineno">1130</tt> <tt class="py-line"> </tt>
<a name="L1131"></a><tt class="py-lineno">1131</tt> <tt class="py-line"> <tt class="py-comment"># use findall to get the members of a list value</tt> </tt>
<a name="L1132"></a><tt class="py-lineno">1132</tt> <tt class="py-line"> <tt id="link-128" class="py-name" targets="Variable configobj.ConfigObj._listvalueexp=configobj.ConfigObj-class.html#_listvalueexp"><a title="configobj.ConfigObj._listvalueexp" class="py-name" href="#" onclick="return doclink('link-128', '_listvalueexp', 'link-128');">_listvalueexp</a></tt> <tt class="py-op">=</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">compile</tt><tt class="py-op">(</tt><tt class="py-string">r'''</tt> </tt>
<a name="L1133"></a><tt class="py-lineno">1133</tt> <tt class="py-line"><tt class="py-string"> (</tt> </tt>
<a name="L1134"></a><tt class="py-lineno">1134</tt> <tt class="py-line"><tt class="py-string"> (?:".*?")| # double quotes</tt> </tt>
<a name="L1135"></a><tt class="py-lineno">1135</tt> <tt class="py-line"><tt class="py-string"> (?:'.*?')| # single quotes</tt> </tt>
<a name="L1136"></a><tt class="py-lineno">1136</tt> <tt class="py-line"><tt class="py-string"> (?:[^'",\#]?.*?) # unquoted</tt> </tt>
<a name="L1137"></a><tt class="py-lineno">1137</tt> <tt class="py-line"><tt class="py-string"> )</tt> </tt>
<a name="L1138"></a><tt class="py-lineno">1138</tt> <tt class="py-line"><tt class="py-string"> \s*,\s* # comma</tt> </tt>
<a name="L1139"></a><tt class="py-lineno">1139</tt> <tt class="py-line"><tt class="py-string"> '''</tt><tt class="py-op">,</tt> </tt>
<a name="L1140"></a><tt class="py-lineno">1140</tt> <tt class="py-line"> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">VERBOSE</tt><tt class="py-op">)</tt> </tt>
<a name="L1141"></a><tt class="py-lineno">1141</tt> <tt class="py-line"> </tt>
<a name="L1142"></a><tt class="py-lineno">1142</tt> <tt class="py-line"> <tt class="py-comment"># this regexp is used for the value</tt> </tt>
<a name="L1143"></a><tt class="py-lineno">1143</tt> <tt class="py-line"> <tt class="py-comment"># when lists are switched off</tt> </tt>
<a name="L1144"></a><tt class="py-lineno">1144</tt> <tt class="py-line"> <tt id="link-129" class="py-name" targets="Variable configobj.ConfigObj._nolistvalue=configobj.ConfigObj-class.html#_nolistvalue"><a title="configobj.ConfigObj._nolistvalue" class="py-name" href="#" onclick="return doclink('link-129', '_nolistvalue', 'link-129');">_nolistvalue</a></tt> <tt class="py-op">=</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">compile</tt><tt class="py-op">(</tt><tt class="py-string">r'''^</tt> </tt>
<a name="L1145"></a><tt class="py-lineno">1145</tt> <tt class="py-line"><tt class="py-string"> (</tt> </tt>
<a name="L1146"></a><tt class="py-lineno">1146</tt> <tt class="py-line"><tt class="py-string"> (?:".*?")| # double quotes</tt> </tt>
<a name="L1147"></a><tt class="py-lineno">1147</tt> <tt class="py-line"><tt class="py-string"> (?:'.*?')| # single quotes</tt> </tt>
<a name="L1148"></a><tt class="py-lineno">1148</tt> <tt class="py-line"><tt class="py-string"> (?:[^'"\#].*?)| # unquoted</tt> </tt>
<a name="L1149"></a><tt class="py-lineno">1149</tt> <tt class="py-line"><tt class="py-string"> (?:) # Empty value</tt> </tt>
<a name="L1150"></a><tt class="py-lineno">1150</tt> <tt class="py-line"><tt class="py-string"> )</tt> </tt>
<a name="L1151"></a><tt class="py-lineno">1151</tt> <tt class="py-line"><tt class="py-string"> \s*(\#.*)? # optional comment</tt> </tt>
<a name="L1152"></a><tt class="py-lineno">1152</tt> <tt class="py-line"><tt class="py-string"> $'''</tt><tt class="py-op">,</tt> </tt>
<a name="L1153"></a><tt class="py-lineno">1153</tt> <tt class="py-line"> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">VERBOSE</tt><tt class="py-op">)</tt> </tt>
<a name="L1154"></a><tt class="py-lineno">1154</tt> <tt class="py-line"> </tt>
<a name="L1155"></a><tt class="py-lineno">1155</tt> <tt class="py-line"> <tt class="py-comment"># regexes for finding triple quoted values on one line</tt> </tt>
<a name="L1156"></a><tt class="py-lineno">1156</tt> <tt class="py-line"> <tt id="link-130" class="py-name" targets="Variable configobj.ConfigObj._single_line_single=configobj.ConfigObj-class.html#_single_line_single"><a title="configobj.ConfigObj._single_line_single" class="py-name" href="#" onclick="return doclink('link-130', '_single_line_single', 'link-130');">_single_line_single</a></tt> <tt class="py-op">=</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">compile</tt><tt class="py-op">(</tt><tt class="py-string">r"^'''(.*?)'''\s*(#.*)?$"</tt><tt class="py-op">)</tt> </tt>
<a name="L1157"></a><tt class="py-lineno">1157</tt> <tt class="py-line"> <tt id="link-131" class="py-name" targets="Variable configobj.ConfigObj._single_line_double=configobj.ConfigObj-class.html#_single_line_double"><a title="configobj.ConfigObj._single_line_double" class="py-name" href="#" onclick="return doclink('link-131', '_single_line_double', 'link-131');">_single_line_double</a></tt> <tt class="py-op">=</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">compile</tt><tt class="py-op">(</tt><tt class="py-string">r'^"""(.*?)"""\s*(#.*)?$'</tt><tt class="py-op">)</tt> </tt>
<a name="L1158"></a><tt class="py-lineno">1158</tt> <tt class="py-line"> <tt id="link-132" class="py-name" targets="Variable configobj.ConfigObj._multi_line_single=configobj.ConfigObj-class.html#_multi_line_single"><a title="configobj.ConfigObj._multi_line_single" class="py-name" href="#" onclick="return doclink('link-132', '_multi_line_single', 'link-132');">_multi_line_single</a></tt> <tt class="py-op">=</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">compile</tt><tt class="py-op">(</tt><tt class="py-string">r"^(.*?)'''\s*(#.*)?$"</tt><tt class="py-op">)</tt> </tt>
<a name="L1159"></a><tt class="py-lineno">1159</tt> <tt class="py-line"> <tt id="link-133" class="py-name" targets="Variable configobj.ConfigObj._multi_line_double=configobj.ConfigObj-class.html#_multi_line_double"><a title="configobj.ConfigObj._multi_line_double" class="py-name" href="#" onclick="return doclink('link-133', '_multi_line_double', 'link-133');">_multi_line_double</a></tt> <tt class="py-op">=</tt> <tt class="py-name">re</tt><tt class="py-op">.</tt><tt class="py-name">compile</tt><tt class="py-op">(</tt><tt class="py-string">r'^(.*?)"""\s*(#.*)?$'</tt><tt class="py-op">)</tt> </tt>
<a name="L1160"></a><tt class="py-lineno">1160</tt> <tt class="py-line"> </tt>
<a name="L1161"></a><tt class="py-lineno">1161</tt> <tt class="py-line"> <tt id="link-134" class="py-name" targets="Variable configobj.ConfigObj._triple_quote=configobj.ConfigObj-class.html#_triple_quote"><a title="configobj.ConfigObj._triple_quote" class="py-name" href="#" onclick="return doclink('link-134', '_triple_quote', 'link-134');">_triple_quote</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt>
<a name="L1162"></a><tt class="py-lineno">1162</tt> <tt class="py-line"> <tt class="py-string">"'''"</tt><tt class="py-op">:</tt> <tt class="py-op">(</tt><tt id="link-135" class="py-name"><a title="configobj.ConfigObj._single_line_single" class="py-name" href="#" onclick="return doclink('link-135', '_single_line_single', 'link-130');">_single_line_single</a></tt><tt class="py-op">,</tt> <tt id="link-136" class="py-name"><a title="configobj.ConfigObj._multi_line_single" class="py-name" href="#" onclick="return doclink('link-136', '_multi_line_single', 'link-132');">_multi_line_single</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt>
<a name="L1163"></a><tt class="py-lineno">1163</tt> <tt class="py-line"> <tt class="py-string">'"""'</tt><tt class="py-op">:</tt> <tt class="py-op">(</tt><tt id="link-137" class="py-name"><a title="configobj.ConfigObj._single_line_double" class="py-name" href="#" onclick="return doclink('link-137', '_single_line_double', 'link-131');">_single_line_double</a></tt><tt class="py-op">,</tt> <tt id="link-138" class="py-name"><a title="configobj.ConfigObj._multi_line_double" class="py-name" href="#" onclick="return doclink('link-138', '_multi_line_double', 'link-133');">_multi_line_double</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt>
<a name="L1164"></a><tt class="py-lineno">1164</tt> <tt class="py-line"> <tt class="py-op">}</tt> </tt>
<a name="L1165"></a><tt class="py-lineno">1165</tt> <tt class="py-line"> </tt>
<a name="L1166"></a><tt class="py-lineno">1166</tt> <tt class="py-line"> <tt class="py-comment"># Used by the ``istrue`` Section method</tt> </tt>
<a name="L1167"></a><tt class="py-lineno">1167</tt> <tt class="py-line"> <tt id="link-139" class="py-name"><a title="configobj.ConfigObj._bools" class="py-name" href="#" onclick="return doclink('link-139', '_bools', 'link-120');">_bools</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt>
<a name="L1168"></a><tt class="py-lineno">1168</tt> <tt class="py-line"> <tt class="py-string">'yes'</tt><tt class="py-op">:</tt> <tt class="py-name">True</tt><tt class="py-op">,</tt> <tt class="py-string">'no'</tt><tt class="py-op">:</tt> <tt class="py-name">False</tt><tt class="py-op">,</tt> </tt>
<a name="L1169"></a><tt class="py-lineno">1169</tt> <tt class="py-line"> <tt class="py-string">'on'</tt><tt class="py-op">:</tt> <tt class="py-name">True</tt><tt class="py-op">,</tt> <tt class="py-string">'off'</tt><tt class="py-op">:</tt> <tt class="py-name">False</tt><tt class="py-op">,</tt> </tt>
<a name="L1170"></a><tt class="py-lineno">1170</tt> <tt class="py-line"> <tt class="py-string">'1'</tt><tt class="py-op">:</tt> <tt class="py-name">True</tt><tt class="py-op">,</tt> <tt class="py-string">'0'</tt><tt class="py-op">:</tt> <tt class="py-name">False</tt><tt class="py-op">,</tt> </tt>
<a name="L1171"></a><tt class="py-lineno">1171</tt> <tt class="py-line"> <tt class="py-string">'true'</tt><tt class="py-op">:</tt> <tt class="py-name">True</tt><tt class="py-op">,</tt> <tt class="py-string">'false'</tt><tt class="py-op">:</tt> <tt class="py-name">False</tt><tt class="py-op">,</tt> </tt>
<a name="L1172"></a><tt class="py-lineno">1172</tt> <tt class="py-line"> <tt class="py-op">}</tt> </tt>
<a name="L1173"></a><tt class="py-lineno">1173</tt> <tt class="py-line"> </tt>
<a name="L1174"></a><tt class="py-lineno">1174</tt> <tt class="py-line"> </tt>
<a name="ConfigObj.__init__"></a><div id="ConfigObj.__init__-def"><a name="L1175"></a><tt class="py-lineno">1175</tt> <a class="py-toggle" href="#" id="ConfigObj.__init__-toggle" onclick="return toggle('ConfigObj.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">infile</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">options</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">configspec</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">encoding</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt>
<a name="L1176"></a><tt class="py-lineno">1176</tt> <tt class="py-line"> <tt class="py-param">interpolation</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">,</tt> <tt class="py-param">raise_errors</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">,</tt> <tt class="py-param">list_values</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">,</tt> </tt>
<a name="L1177"></a><tt class="py-lineno">1177</tt> <tt class="py-line"> <tt class="py-param">create_empty</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">,</tt> <tt class="py-param">file_error</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">,</tt> <tt class="py-param">stringify</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">,</tt> </tt>
<a name="L1178"></a><tt class="py-lineno">1178</tt> <tt class="py-line"> <tt class="py-param">indent_type</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">default_encoding</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">unrepr</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">,</tt> </tt>
<a name="L1179"></a><tt class="py-lineno">1179</tt> <tt class="py-line"> <tt class="py-param">write_empty_values</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">,</tt> <tt class="py-param">_inspec</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj.__init__-expanded"><a name="L1180"></a><tt class="py-lineno">1180</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L1181"></a><tt class="py-lineno">1181</tt> <tt class="py-line"><tt class="py-docstring"> Parse a config file or create a config file object.</tt> </tt>
<a name="L1182"></a><tt class="py-lineno">1182</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L1183"></a><tt class="py-lineno">1183</tt> <tt class="py-line"><tt class="py-docstring"> ``ConfigObj(infile=None, configspec=None, encoding=None,</tt> </tt>
<a name="L1184"></a><tt class="py-lineno">1184</tt> <tt class="py-line"><tt class="py-docstring"> interpolation=True, raise_errors=False, list_values=True,</tt> </tt>
<a name="L1185"></a><tt class="py-lineno">1185</tt> <tt class="py-line"><tt class="py-docstring"> create_empty=False, file_error=False, stringify=True,</tt> </tt>
<a name="L1186"></a><tt class="py-lineno">1186</tt> <tt class="py-line"><tt class="py-docstring"> indent_type=None, default_encoding=None, unrepr=False,</tt> </tt>
<a name="L1187"></a><tt class="py-lineno">1187</tt> <tt class="py-line"><tt class="py-docstring"> write_empty_values=False, _inspec=False)``</tt> </tt>
<a name="L1188"></a><tt class="py-lineno">1188</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L1189"></a><tt class="py-lineno">1189</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_inspec</tt> <tt class="py-op">=</tt> <tt class="py-name">_inspec</tt> </tt>
<a name="L1190"></a><tt class="py-lineno">1190</tt> <tt class="py-line"> <tt class="py-comment"># init the superclass</tt> </tt>
<a name="L1191"></a><tt class="py-lineno">1191</tt> <tt class="py-line"> <tt id="link-140" class="py-name"><a title="configobj.Section" class="py-name" href="#" onclick="return doclink('link-140', 'Section', 'link-52');">Section</a></tt><tt class="py-op">.</tt><tt id="link-141" class="py-name"><a title="configobj.ConfigObj.__init__
configobj.ConfigObjError.__init__
configobj.InterpolationEngine.__init__
configobj.InterpolationLoopError.__init__
configobj.MissingInterpolationOption.__init__
configobj.ReloadError.__init__
configobj.Section.__init__
configobj.SimpleVal.__init__" class="py-name" href="#" onclick="return doclink('link-141', '__init__', 'link-38');">__init__</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-number">0</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt> </tt>
<a name="L1192"></a><tt class="py-lineno">1192</tt> <tt class="py-line"> </tt>
<a name="L1193"></a><tt class="py-lineno">1193</tt> <tt class="py-line"> <tt class="py-name">infile</tt> <tt class="py-op">=</tt> <tt class="py-name">infile</tt> <tt class="py-keyword">or</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L1194"></a><tt class="py-lineno">1194</tt> <tt class="py-line"> </tt>
<a name="L1195"></a><tt class="py-lineno">1195</tt> <tt class="py-line"> <tt class="py-name">_options</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-string">'configspec'</tt><tt class="py-op">:</tt> <tt class="py-name">configspec</tt><tt class="py-op">,</tt> </tt>
<a name="L1196"></a><tt class="py-lineno">1196</tt> <tt class="py-line"> <tt class="py-string">'encoding'</tt><tt class="py-op">:</tt> <tt class="py-name">encoding</tt><tt class="py-op">,</tt> <tt class="py-string">'interpolation'</tt><tt class="py-op">:</tt> <tt class="py-name">interpolation</tt><tt class="py-op">,</tt> </tt>
<a name="L1197"></a><tt class="py-lineno">1197</tt> <tt class="py-line"> <tt class="py-string">'raise_errors'</tt><tt class="py-op">:</tt> <tt class="py-name">raise_errors</tt><tt class="py-op">,</tt> <tt class="py-string">'list_values'</tt><tt class="py-op">:</tt> <tt class="py-name">list_values</tt><tt class="py-op">,</tt> </tt>
<a name="L1198"></a><tt class="py-lineno">1198</tt> <tt class="py-line"> <tt class="py-string">'create_empty'</tt><tt class="py-op">:</tt> <tt class="py-name">create_empty</tt><tt class="py-op">,</tt> <tt class="py-string">'file_error'</tt><tt class="py-op">:</tt> <tt class="py-name">file_error</tt><tt class="py-op">,</tt> </tt>
<a name="L1199"></a><tt class="py-lineno">1199</tt> <tt class="py-line"> <tt class="py-string">'stringify'</tt><tt class="py-op">:</tt> <tt class="py-name">stringify</tt><tt class="py-op">,</tt> <tt class="py-string">'indent_type'</tt><tt class="py-op">:</tt> <tt class="py-name">indent_type</tt><tt class="py-op">,</tt> </tt>
<a name="L1200"></a><tt class="py-lineno">1200</tt> <tt class="py-line"> <tt class="py-string">'default_encoding'</tt><tt class="py-op">:</tt> <tt class="py-name">default_encoding</tt><tt class="py-op">,</tt> <tt class="py-string">'unrepr'</tt><tt class="py-op">:</tt> <tt id="link-142" class="py-name"><a title="configobj.unrepr" class="py-name" href="#" onclick="return doclink('link-142', 'unrepr', 'link-89');">unrepr</a></tt><tt class="py-op">,</tt> </tt>
<a name="L1201"></a><tt class="py-lineno">1201</tt> <tt class="py-line"> <tt class="py-string">'write_empty_values'</tt><tt class="py-op">:</tt> <tt class="py-name">write_empty_values</tt><tt class="py-op">}</tt> </tt>
<a name="L1202"></a><tt class="py-lineno">1202</tt> <tt class="py-line"> </tt>
<a name="L1203"></a><tt class="py-lineno">1203</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">options</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L1204"></a><tt class="py-lineno">1204</tt> <tt class="py-line"> <tt class="py-name">options</tt> <tt class="py-op">=</tt> <tt class="py-name">_options</tt> </tt>
<a name="L1205"></a><tt class="py-lineno">1205</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1206"></a><tt class="py-lineno">1206</tt> <tt class="py-line"> <tt class="py-keyword">import</tt> <tt class="py-name">warnings</tt> </tt>
<a name="L1207"></a><tt class="py-lineno">1207</tt> <tt class="py-line"> <tt class="py-name">warnings</tt><tt class="py-op">.</tt><tt class="py-name">warn</tt><tt class="py-op">(</tt><tt class="py-string">'Passing in an options dictionary to ConfigObj() is '</tt> </tt>
<a name="L1208"></a><tt class="py-lineno">1208</tt> <tt class="py-line"> <tt class="py-string">'deprecated. Use **options instead.'</tt><tt class="py-op">,</tt> </tt>
<a name="L1209"></a><tt class="py-lineno">1209</tt> <tt class="py-line"> <tt class="py-name">DeprecationWarning</tt><tt class="py-op">,</tt> <tt class="py-name">stacklevel</tt><tt class="py-op">=</tt><tt class="py-number">2</tt><tt class="py-op">)</tt> </tt>
<a name="L1210"></a><tt class="py-lineno">1210</tt> <tt class="py-line"> </tt>
<a name="L1211"></a><tt class="py-lineno">1211</tt> <tt class="py-line"> <tt class="py-comment"># TODO: check the values too.</tt> </tt>
<a name="L1212"></a><tt class="py-lineno">1212</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">in</tt> <tt class="py-name">options</tt><tt class="py-op">:</tt> </tt>
<a name="L1213"></a><tt class="py-lineno">1213</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt id="link-143" class="py-name"><a title="configobj.OPTION_DEFAULTS" class="py-name" href="#" onclick="return doclink('link-143', 'OPTION_DEFAULTS', 'link-17');">OPTION_DEFAULTS</a></tt><tt class="py-op">:</tt> </tt>
<a name="L1214"></a><tt class="py-lineno">1214</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Unrecognised option "%s".'</tt> <tt class="py-op">%</tt> <tt class="py-name">entry</tt><tt class="py-op">)</tt> </tt>
<a name="L1215"></a><tt class="py-lineno">1215</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">entry</tt><tt class="py-op">,</tt> <tt class="py-name">value</tt> <tt class="py-keyword">in</tt> <tt id="link-144" class="py-name"><a title="configobj.OPTION_DEFAULTS" class="py-name" href="#" onclick="return doclink('link-144', 'OPTION_DEFAULTS', 'link-17');">OPTION_DEFAULTS</a></tt><tt class="py-op">.</tt><tt id="link-145" class="py-name"><a title="configobj.Section.items" class="py-name" href="#" onclick="return doclink('link-145', 'items', 'link-102');">items</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1216"></a><tt class="py-lineno">1216</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">options</tt><tt class="py-op">:</tt> </tt>
<a name="L1217"></a><tt class="py-lineno">1217</tt> <tt class="py-line"> <tt class="py-name">options</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">value</tt> </tt>
<a name="L1218"></a><tt class="py-lineno">1218</tt> <tt class="py-line"> <tt class="py-name">keyword_value</tt> <tt class="py-op">=</tt> <tt class="py-name">_options</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> </tt>
<a name="L1219"></a><tt class="py-lineno">1219</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">value</tt> <tt class="py-op">!=</tt> <tt class="py-name">keyword_value</tt><tt class="py-op">:</tt> </tt>
<a name="L1220"></a><tt class="py-lineno">1220</tt> <tt class="py-line"> <tt class="py-name">options</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">keyword_value</tt> </tt>
<a name="L1221"></a><tt class="py-lineno">1221</tt> <tt class="py-line"> </tt>
<a name="L1222"></a><tt class="py-lineno">1222</tt> <tt class="py-line"> <tt class="py-comment"># XXXX this ignores an explicit list_values = True in combination</tt> </tt>
<a name="L1223"></a><tt class="py-lineno">1223</tt> <tt class="py-line"> <tt class="py-comment"># with _inspec. The user should *never* do that anyway, but still...</tt> </tt>
<a name="L1224"></a><tt class="py-lineno">1224</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">_inspec</tt><tt class="py-op">:</tt> </tt>
<a name="L1225"></a><tt class="py-lineno">1225</tt> <tt class="py-line"> <tt class="py-name">options</tt><tt class="py-op">[</tt><tt class="py-string">'list_values'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L1226"></a><tt class="py-lineno">1226</tt> <tt class="py-line"> </tt>
<a name="L1227"></a><tt class="py-lineno">1227</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-146" class="py-name"><a title="configobj.ConfigObj._initialise
configobj.Section._initialise" class="py-name" href="#" onclick="return doclink('link-146', '_initialise', 'link-75');">_initialise</a></tt><tt class="py-op">(</tt><tt class="py-name">options</tt><tt class="py-op">)</tt> </tt>
<a name="L1228"></a><tt class="py-lineno">1228</tt> <tt class="py-line"> <tt class="py-name">configspec</tt> <tt class="py-op">=</tt> <tt class="py-name">options</tt><tt class="py-op">[</tt><tt class="py-string">'configspec'</tt><tt class="py-op">]</tt> </tt>
<a name="L1229"></a><tt class="py-lineno">1229</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_original_configspec</tt> <tt class="py-op">=</tt> <tt class="py-name">configspec</tt> </tt>
<a name="L1230"></a><tt class="py-lineno">1230</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-147" class="py-name" targets="Method configobj.ConfigObj._load()=configobj.ConfigObj-class.html#_load"><a title="configobj.ConfigObj._load" class="py-name" href="#" onclick="return doclink('link-147', '_load', 'link-147');">_load</a></tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-name">configspec</tt><tt class="py-op">)</tt> </tt>
</div><a name="L1231"></a><tt class="py-lineno">1231</tt> <tt class="py-line"> </tt>
<a name="L1232"></a><tt class="py-lineno">1232</tt> <tt class="py-line"> </tt>
<a name="ConfigObj._load"></a><div id="ConfigObj._load-def"><a name="L1233"></a><tt class="py-lineno">1233</tt> <a class="py-toggle" href="#" id="ConfigObj._load-toggle" onclick="return toggle('ConfigObj._load');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#_load">_load</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">infile</tt><tt class="py-op">,</tt> <tt class="py-param">configspec</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj._load-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj._load-expanded"><a name="L1234"></a><tt class="py-lineno">1234</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-name">basestring</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1235"></a><tt class="py-lineno">1235</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">filename</tt> <tt class="py-op">=</tt> <tt class="py-name">infile</tt> </tt>
<a name="L1236"></a><tt class="py-lineno">1236</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">path</tt><tt class="py-op">.</tt><tt class="py-name">isfile</tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1237"></a><tt class="py-lineno">1237</tt> <tt class="py-line"> <tt class="py-name">h</tt> <tt class="py-op">=</tt> <tt class="py-name">open</tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-string">'rb'</tt><tt class="py-op">)</tt> </tt>
<a name="L1238"></a><tt class="py-lineno">1238</tt> <tt class="py-line"> <tt class="py-name">infile</tt> <tt class="py-op">=</tt> <tt class="py-name">h</tt><tt class="py-op">.</tt><tt class="py-name">read</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L1239"></a><tt class="py-lineno">1239</tt> <tt class="py-line"> <tt class="py-name">h</tt><tt class="py-op">.</tt><tt class="py-name">close</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L1240"></a><tt class="py-lineno">1240</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">file_error</tt><tt class="py-op">:</tt> </tt>
<a name="L1241"></a><tt class="py-lineno">1241</tt> <tt class="py-line"> <tt class="py-comment"># raise an error if the file doesn't exist</tt> </tt>
<a name="L1242"></a><tt class="py-lineno">1242</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">IOError</tt><tt class="py-op">(</tt><tt class="py-string">'Config file not found: "%s".'</tt> <tt class="py-op">%</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">filename</tt><tt class="py-op">)</tt> </tt>
<a name="L1243"></a><tt class="py-lineno">1243</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1244"></a><tt class="py-lineno">1244</tt> <tt class="py-line"> <tt class="py-comment"># file doesn't already exist</tt> </tt>
<a name="L1245"></a><tt class="py-lineno">1245</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">create_empty</tt><tt class="py-op">:</tt> </tt>
<a name="L1246"></a><tt class="py-lineno">1246</tt> <tt class="py-line"> <tt class="py-comment"># this is a good test that the filename specified</tt> </tt>
<a name="L1247"></a><tt class="py-lineno">1247</tt> <tt class="py-line"> <tt class="py-comment"># isn't impossible - like on a non-existent device</tt> </tt>
<a name="L1248"></a><tt class="py-lineno">1248</tt> <tt class="py-line"> <tt class="py-name">h</tt> <tt class="py-op">=</tt> <tt class="py-name">open</tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-string">'w'</tt><tt class="py-op">)</tt> </tt>
<a name="L1249"></a><tt class="py-lineno">1249</tt> <tt class="py-line"> <tt class="py-name">h</tt><tt class="py-op">.</tt><tt id="link-148" class="py-name" targets="Method configobj.ConfigObj.write()=configobj.ConfigObj-class.html#write"><a title="configobj.ConfigObj.write" class="py-name" href="#" onclick="return doclink('link-148', 'write', 'link-148');">write</a></tt><tt class="py-op">(</tt><tt class="py-string">''</tt><tt class="py-op">)</tt> </tt>
<a name="L1250"></a><tt class="py-lineno">1250</tt> <tt class="py-line"> <tt class="py-name">h</tt><tt class="py-op">.</tt><tt class="py-name">close</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L1251"></a><tt class="py-lineno">1251</tt> <tt class="py-line"> <tt class="py-name">infile</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L1252"></a><tt class="py-lineno">1252</tt> <tt class="py-line"> </tt>
<a name="L1253"></a><tt class="py-lineno">1253</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">list</tt><tt class="py-op">,</tt> <tt class="py-name">tuple</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1254"></a><tt class="py-lineno">1254</tt> <tt class="py-line"> <tt class="py-name">infile</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">)</tt> </tt>
<a name="L1255"></a><tt class="py-lineno">1255</tt> <tt class="py-line"> </tt>
<a name="L1256"></a><tt class="py-lineno">1256</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt id="link-149" class="py-name"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-149', 'dict', 'link-68');">dict</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1257"></a><tt class="py-lineno">1257</tt> <tt class="py-line"> <tt class="py-comment"># initialise self</tt> </tt>
<a name="L1258"></a><tt class="py-lineno">1258</tt> <tt class="py-line"> <tt class="py-comment"># the Section class handles creating subsections</tt> </tt>
<a name="L1259"></a><tt class="py-lineno">1259</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt id="link-150" class="py-name" targets="Class configobj.ConfigObj=configobj.ConfigObj-class.html"><a title="configobj.ConfigObj" class="py-name" href="#" onclick="return doclink('link-150', 'ConfigObj', 'link-150');">ConfigObj</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1260"></a><tt class="py-lineno">1260</tt> <tt class="py-line"> <tt class="py-comment"># get a copy of our ConfigObj</tt> </tt>
<a name="L1261"></a><tt class="py-lineno">1261</tt> <tt class="py-line"> <tt class="py-keyword">def</tt> <tt class="py-def-name">set_section</tt><tt class="py-op">(</tt><tt class="py-param">in_section</tt><tt class="py-op">,</tt> <tt class="py-param">this_section</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1262"></a><tt class="py-lineno">1262</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">in</tt> <tt class="py-name">in_section</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt><tt class="py-op">:</tt> </tt>
<a name="L1263"></a><tt class="py-lineno">1263</tt> <tt class="py-line"> <tt class="py-name">this_section</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">in_section</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> </tt>
<a name="L1264"></a><tt class="py-lineno">1264</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">section</tt> <tt class="py-keyword">in</tt> <tt class="py-name">in_section</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">:</tt> </tt>
<a name="L1265"></a><tt class="py-lineno">1265</tt> <tt class="py-line"> <tt class="py-name">this_section</tt><tt class="py-op">[</tt><tt class="py-name">section</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
<a name="L1266"></a><tt class="py-lineno">1266</tt> <tt class="py-line"> <tt class="py-name">set_section</tt><tt class="py-op">(</tt><tt class="py-name">in_section</tt><tt class="py-op">[</tt><tt class="py-name">section</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">this_section</tt><tt class="py-op">[</tt><tt class="py-name">section</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
</div><a name="L1267"></a><tt class="py-lineno">1267</tt> <tt class="py-line"> <tt class="py-name">set_section</tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt> </tt>
<a name="L1268"></a><tt class="py-lineno">1268</tt> <tt class="py-line"> </tt>
<a name="L1269"></a><tt class="py-lineno">1269</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1270"></a><tt class="py-lineno">1270</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">in</tt> <tt class="py-name">infile</tt><tt class="py-op">:</tt> </tt>
<a name="L1271"></a><tt class="py-lineno">1271</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">infile</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> </tt>
<a name="L1272"></a><tt class="py-lineno">1272</tt> <tt class="py-line"> <tt class="py-keyword">del</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_errors</tt> </tt>
<a name="L1273"></a><tt class="py-lineno">1273</tt> <tt class="py-line"> </tt>
<a name="L1274"></a><tt class="py-lineno">1274</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">configspec</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L1275"></a><tt class="py-lineno">1275</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-151" class="py-name" targets="Method configobj.ConfigObj._handle_configspec()=configobj.ConfigObj-class.html#_handle_configspec"><a title="configobj.ConfigObj._handle_configspec" class="py-name" href="#" onclick="return doclink('link-151', '_handle_configspec', 'link-151');">_handle_configspec</a></tt><tt class="py-op">(</tt><tt class="py-name">configspec</tt><tt class="py-op">)</tt> </tt>
<a name="L1276"></a><tt class="py-lineno">1276</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1277"></a><tt class="py-lineno">1277</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">configspec</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
<a name="L1278"></a><tt class="py-lineno">1278</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> </tt>
<a name="L1279"></a><tt class="py-lineno">1279</tt> <tt class="py-line"> </tt>
<a name="L1280"></a><tt class="py-lineno">1280</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">getattr</tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-string">'read'</tt><tt class="py-op">,</tt> <tt id="link-152" class="py-name"><a title="configobj.MISSING" class="py-name" href="#" onclick="return doclink('link-152', 'MISSING', 'link-12');">MISSING</a></tt><tt class="py-op">)</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt id="link-153" class="py-name"><a title="configobj.MISSING" class="py-name" href="#" onclick="return doclink('link-153', 'MISSING', 'link-12');">MISSING</a></tt><tt class="py-op">:</tt> </tt>
<a name="L1281"></a><tt class="py-lineno">1281</tt> <tt class="py-line"> <tt class="py-comment"># This supports file like objects</tt> </tt>
<a name="L1282"></a><tt class="py-lineno">1282</tt> <tt class="py-line"> <tt class="py-name">infile</tt> <tt class="py-op">=</tt> <tt class="py-name">infile</tt><tt class="py-op">.</tt><tt class="py-name">read</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L1283"></a><tt class="py-lineno">1283</tt> <tt class="py-line"> <tt class="py-comment"># needs splitting into lines - but needs doing *after* decoding</tt> </tt>
<a name="L1284"></a><tt class="py-lineno">1284</tt> <tt class="py-line"> <tt class="py-comment"># in case it's not an 8 bit encoding</tt> </tt>
<a name="L1285"></a><tt class="py-lineno">1285</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1286"></a><tt class="py-lineno">1286</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'infile must be a filename, file like object, or list of lines.'</tt><tt class="py-op">)</tt> </tt>
<a name="L1287"></a><tt class="py-lineno">1287</tt> <tt class="py-line"> </tt>
<a name="L1288"></a><tt class="py-lineno">1288</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">infile</tt><tt class="py-op">:</tt> </tt>
<a name="L1289"></a><tt class="py-lineno">1289</tt> <tt class="py-line"> <tt class="py-comment"># don't do it for the empty ConfigObj</tt> </tt>
<a name="L1290"></a><tt class="py-lineno">1290</tt> <tt class="py-line"> <tt class="py-name">infile</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-154" class="py-name" targets="Method configobj.ConfigObj._handle_bom()=configobj.ConfigObj-class.html#_handle_bom"><a title="configobj.ConfigObj._handle_bom" class="py-name" href="#" onclick="return doclink('link-154', '_handle_bom', 'link-154');">_handle_bom</a></tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">)</tt> </tt>
<a name="L1291"></a><tt class="py-lineno">1291</tt> <tt class="py-line"> <tt class="py-comment"># infile is now *always* a list</tt> </tt>
<a name="L1292"></a><tt class="py-lineno">1292</tt> <tt class="py-line"> <tt class="py-comment">#</tt> </tt>
<a name="L1293"></a><tt class="py-lineno">1293</tt> <tt class="py-line"> <tt class="py-comment"># Set the newlines attribute (first line ending it finds)</tt> </tt>
<a name="L1294"></a><tt class="py-lineno">1294</tt> <tt class="py-line"> <tt class="py-comment"># and strip trailing '\n' or '\r' from lines</tt> </tt>
<a name="L1295"></a><tt class="py-lineno">1295</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">line</tt> <tt class="py-keyword">in</tt> <tt class="py-name">infile</tt><tt class="py-op">:</tt> </tt>
<a name="L1296"></a><tt class="py-lineno">1296</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-keyword">not</tt> <tt class="py-name">line</tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> <tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-string">'\r'</tt><tt class="py-op">,</tt> <tt class="py-string">'\n'</tt><tt class="py-op">,</tt> <tt class="py-string">'\r\n'</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1297"></a><tt class="py-lineno">1297</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L1298"></a><tt class="py-lineno">1298</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">end</tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-string">'\r\n'</tt><tt class="py-op">,</tt> <tt class="py-string">'\n'</tt><tt class="py-op">,</tt> <tt class="py-string">'\r'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1299"></a><tt class="py-lineno">1299</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">line</tt><tt class="py-op">.</tt><tt class="py-name">endswith</tt><tt class="py-op">(</tt><tt class="py-name">end</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1300"></a><tt class="py-lineno">1300</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">newlines</tt> <tt class="py-op">=</tt> <tt class="py-name">end</tt> </tt>
<a name="L1301"></a><tt class="py-lineno">1301</tt> <tt class="py-line"> <tt class="py-keyword">break</tt> </tt>
<a name="L1302"></a><tt class="py-lineno">1302</tt> <tt class="py-line"> <tt class="py-keyword">break</tt> </tt>
<a name="L1303"></a><tt class="py-lineno">1303</tt> <tt class="py-line"> </tt>
<a name="L1304"></a><tt class="py-lineno">1304</tt> <tt class="py-line"> <tt class="py-name">infile</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">line</tt><tt class="py-op">.</tt><tt class="py-name">rstrip</tt><tt class="py-op">(</tt><tt class="py-string">'\r\n'</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">line</tt> <tt class="py-keyword">in</tt> <tt class="py-name">infile</tt><tt class="py-op">]</tt> </tt>
<a name="L1305"></a><tt class="py-lineno">1305</tt> <tt class="py-line"> </tt>
<a name="L1306"></a><tt class="py-lineno">1306</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-155" class="py-name" targets="Method configobj.ConfigObj._parse()=configobj.ConfigObj-class.html#_parse"><a title="configobj.ConfigObj._parse" class="py-name" href="#" onclick="return doclink('link-155', '_parse', 'link-155');">_parse</a></tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">)</tt> </tt>
<a name="L1307"></a><tt class="py-lineno">1307</tt> <tt class="py-line"> <tt class="py-comment"># if we had any errors, now is the time to raise them</tt> </tt>
<a name="L1308"></a><tt class="py-lineno">1308</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_errors</tt><tt class="py-op">:</tt> </tt>
<a name="L1309"></a><tt class="py-lineno">1309</tt> <tt class="py-line"> <tt class="py-name">info</tt> <tt class="py-op">=</tt> <tt class="py-string">"at line %s."</tt> <tt class="py-op">%</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_errors</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">line_number</tt> </tt>
<a name="L1310"></a><tt class="py-lineno">1310</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_errors</tt><tt class="py-op">)</tt> <tt class="py-op">></tt> <tt class="py-number">1</tt><tt class="py-op">:</tt> </tt>
<a name="L1311"></a><tt class="py-lineno">1311</tt> <tt class="py-line"> <tt class="py-name">msg</tt> <tt class="py-op">=</tt> <tt class="py-string">"Parsing failed with several errors.\nFirst error %s"</tt> <tt class="py-op">%</tt> <tt class="py-name">info</tt> </tt>
<a name="L1312"></a><tt class="py-lineno">1312</tt> <tt class="py-line"> <tt class="py-name">error</tt> <tt class="py-op">=</tt> <tt id="link-156" class="py-name" targets="Class configobj.ConfigObjError=configobj.ConfigObjError-class.html"><a title="configobj.ConfigObjError" class="py-name" href="#" onclick="return doclink('link-156', 'ConfigObjError', 'link-156');">ConfigObjError</a></tt><tt class="py-op">(</tt><tt class="py-name">msg</tt><tt class="py-op">)</tt> </tt>
<a name="L1313"></a><tt class="py-lineno">1313</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1314"></a><tt class="py-lineno">1314</tt> <tt class="py-line"> <tt class="py-name">error</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_errors</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> </tt>
<a name="L1315"></a><tt class="py-lineno">1315</tt> <tt class="py-line"> <tt class="py-comment"># set the errors attribute; it's a list of tuples:</tt> </tt>
<a name="L1316"></a><tt class="py-lineno">1316</tt> <tt class="py-line"> <tt class="py-comment"># (error_type, message, line_number)</tt> </tt>
<a name="L1317"></a><tt class="py-lineno">1317</tt> <tt class="py-line"> <tt class="py-name">error</tt><tt class="py-op">.</tt><tt class="py-name">errors</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_errors</tt> </tt>
<a name="L1318"></a><tt class="py-lineno">1318</tt> <tt class="py-line"> <tt class="py-comment"># set the config attribute</tt> </tt>
<a name="L1319"></a><tt class="py-lineno">1319</tt> <tt class="py-line"> <tt class="py-name">error</tt><tt class="py-op">.</tt><tt class="py-name">config</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt> </tt>
<a name="L1320"></a><tt class="py-lineno">1320</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">error</tt> </tt>
<a name="L1321"></a><tt class="py-lineno">1321</tt> <tt class="py-line"> <tt class="py-comment"># delete private attributes</tt> </tt>
<a name="L1322"></a><tt class="py-lineno">1322</tt> <tt class="py-line"> <tt class="py-keyword">del</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_errors</tt> </tt>
<a name="L1323"></a><tt class="py-lineno">1323</tt> <tt class="py-line"> </tt>
<a name="L1324"></a><tt class="py-lineno">1324</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">configspec</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L1325"></a><tt class="py-lineno">1325</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">configspec</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
<a name="L1326"></a><tt class="py-lineno">1326</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1327"></a><tt class="py-lineno">1327</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-157" class="py-name"><a title="configobj.ConfigObj._handle_configspec" class="py-name" href="#" onclick="return doclink('link-157', '_handle_configspec', 'link-151');">_handle_configspec</a></tt><tt class="py-op">(</tt><tt class="py-name">configspec</tt><tt class="py-op">)</tt> </tt>
</div><a name="L1328"></a><tt class="py-lineno">1328</tt> <tt class="py-line"> </tt>
<a name="L1329"></a><tt class="py-lineno">1329</tt> <tt class="py-line"> </tt>
<a name="ConfigObj._initialise"></a><div id="ConfigObj._initialise-def"><a name="L1330"></a><tt class="py-lineno">1330</tt> <a class="py-toggle" href="#" id="ConfigObj._initialise-toggle" onclick="return toggle('ConfigObj._initialise');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#_initialise">_initialise</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">options</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj._initialise-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj._initialise-expanded"><a name="L1331"></a><tt class="py-lineno">1331</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">options</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L1332"></a><tt class="py-lineno">1332</tt> <tt class="py-line"> <tt class="py-name">options</tt> <tt class="py-op">=</tt> <tt id="link-158" class="py-name"><a title="configobj.OPTION_DEFAULTS" class="py-name" href="#" onclick="return doclink('link-158', 'OPTION_DEFAULTS', 'link-17');">OPTION_DEFAULTS</a></tt> </tt>
<a name="L1333"></a><tt class="py-lineno">1333</tt> <tt class="py-line"> </tt>
<a name="L1334"></a><tt class="py-lineno">1334</tt> <tt class="py-line"> <tt class="py-comment"># initialise a few variables</tt> </tt>
<a name="L1335"></a><tt class="py-lineno">1335</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">filename</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
<a name="L1336"></a><tt class="py-lineno">1336</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_errors</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L1337"></a><tt class="py-lineno">1337</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">raise_errors</tt> <tt class="py-op">=</tt> <tt class="py-name">options</tt><tt class="py-op">[</tt><tt class="py-string">'raise_errors'</tt><tt class="py-op">]</tt> </tt>
<a name="L1338"></a><tt class="py-lineno">1338</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">interpolation</tt> <tt class="py-op">=</tt> <tt class="py-name">options</tt><tt class="py-op">[</tt><tt class="py-string">'interpolation'</tt><tt class="py-op">]</tt> </tt>
<a name="L1339"></a><tt class="py-lineno">1339</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">list_values</tt> <tt class="py-op">=</tt> <tt class="py-name">options</tt><tt class="py-op">[</tt><tt class="py-string">'list_values'</tt><tt class="py-op">]</tt> </tt>
<a name="L1340"></a><tt class="py-lineno">1340</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">create_empty</tt> <tt class="py-op">=</tt> <tt class="py-name">options</tt><tt class="py-op">[</tt><tt class="py-string">'create_empty'</tt><tt class="py-op">]</tt> </tt>
<a name="L1341"></a><tt class="py-lineno">1341</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">file_error</tt> <tt class="py-op">=</tt> <tt class="py-name">options</tt><tt class="py-op">[</tt><tt class="py-string">'file_error'</tt><tt class="py-op">]</tt> </tt>
<a name="L1342"></a><tt class="py-lineno">1342</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">stringify</tt> <tt class="py-op">=</tt> <tt class="py-name">options</tt><tt class="py-op">[</tt><tt class="py-string">'stringify'</tt><tt class="py-op">]</tt> </tt>
<a name="L1343"></a><tt class="py-lineno">1343</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">indent_type</tt> <tt class="py-op">=</tt> <tt class="py-name">options</tt><tt class="py-op">[</tt><tt class="py-string">'indent_type'</tt><tt class="py-op">]</tt> </tt>
<a name="L1344"></a><tt class="py-lineno">1344</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt> <tt class="py-op">=</tt> <tt class="py-name">options</tt><tt class="py-op">[</tt><tt class="py-string">'encoding'</tt><tt class="py-op">]</tt> </tt>
<a name="L1345"></a><tt class="py-lineno">1345</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">default_encoding</tt> <tt class="py-op">=</tt> <tt class="py-name">options</tt><tt class="py-op">[</tt><tt class="py-string">'default_encoding'</tt><tt class="py-op">]</tt> </tt>
<a name="L1346"></a><tt class="py-lineno">1346</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">BOM</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L1347"></a><tt class="py-lineno">1347</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">newlines</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
<a name="L1348"></a><tt class="py-lineno">1348</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">write_empty_values</tt> <tt class="py-op">=</tt> <tt class="py-name">options</tt><tt class="py-op">[</tt><tt class="py-string">'write_empty_values'</tt><tt class="py-op">]</tt> </tt>
<a name="L1349"></a><tt class="py-lineno">1349</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-159" class="py-name"><a title="configobj.unrepr" class="py-name" href="#" onclick="return doclink('link-159', 'unrepr', 'link-89');">unrepr</a></tt> <tt class="py-op">=</tt> <tt class="py-name">options</tt><tt class="py-op">[</tt><tt class="py-string">'unrepr'</tt><tt class="py-op">]</tt> </tt>
<a name="L1350"></a><tt class="py-lineno">1350</tt> <tt class="py-line"> </tt>
<a name="L1351"></a><tt class="py-lineno">1351</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">initial_comment</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L1352"></a><tt class="py-lineno">1352</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">final_comment</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L1353"></a><tt class="py-lineno">1353</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">configspec</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
<a name="L1354"></a><tt class="py-lineno">1354</tt> <tt class="py-line"> </tt>
<a name="L1355"></a><tt class="py-lineno">1355</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_inspec</tt><tt class="py-op">:</tt> </tt>
<a name="L1356"></a><tt class="py-lineno">1356</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">list_values</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L1357"></a><tt class="py-lineno">1357</tt> <tt class="py-line"> </tt>
<a name="L1358"></a><tt class="py-lineno">1358</tt> <tt class="py-line"> <tt class="py-comment"># Clear section attributes as well</tt> </tt>
<a name="L1359"></a><tt class="py-lineno">1359</tt> <tt class="py-line"> <tt id="link-160" class="py-name"><a title="configobj.Section" class="py-name" href="#" onclick="return doclink('link-160', 'Section', 'link-52');">Section</a></tt><tt class="py-op">.</tt><tt id="link-161" class="py-name"><a title="configobj.ConfigObj._initialise
configobj.Section._initialise" class="py-name" href="#" onclick="return doclink('link-161', '_initialise', 'link-75');">_initialise</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt> </tt>
</div><a name="L1360"></a><tt class="py-lineno">1360</tt> <tt class="py-line"> </tt>
<a name="L1361"></a><tt class="py-lineno">1361</tt> <tt class="py-line"> </tt>
<a name="ConfigObj.__repr__"></a><div id="ConfigObj.__repr__-def"><a name="L1362"></a><tt class="py-lineno">1362</tt> <a class="py-toggle" href="#" id="ConfigObj.__repr__-toggle" onclick="return toggle('ConfigObj.__repr__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#__repr__">__repr__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj.__repr__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj.__repr__-expanded"><a name="L1363"></a><tt class="py-lineno">1363</tt> <tt class="py-line"> <tt class="py-keyword">def</tt> <tt class="py-def-name">_getval</tt><tt class="py-op">(</tt><tt class="py-param">key</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1364"></a><tt class="py-lineno">1364</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
<a name="L1365"></a><tt class="py-lineno">1365</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> </tt>
<a name="L1366"></a><tt class="py-lineno">1366</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt id="link-162" class="py-name"><a title="configobj.MissingInterpolationOption" class="py-name" href="#" onclick="return doclink('link-162', 'MissingInterpolationOption', 'link-56');">MissingInterpolationOption</a></tt><tt class="py-op">:</tt> </tt>
<a name="L1367"></a><tt class="py-lineno">1367</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-163" class="py-name"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-163', 'dict', 'link-68');">dict</a></tt><tt class="py-op">.</tt><tt id="link-164" class="py-name"><a title="configobj.Section.__getitem__" class="py-name" href="#" onclick="return doclink('link-164', '__getitem__', 'link-82');">__getitem__</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
</div><a name="L1368"></a><tt class="py-lineno">1368</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-string">'ConfigObj({%s})'</tt> <tt class="py-op">%</tt> </tt>
<a name="L1369"></a><tt class="py-lineno">1369</tt> <tt class="py-line"> <tt class="py-string">', '</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-op">(</tt><tt class="py-string">'%s: %s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">repr</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">repr</tt><tt class="py-op">(</tt><tt class="py-name">_getval</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
<a name="L1370"></a><tt class="py-lineno">1370</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">key</tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt> <tt class="py-op">+</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">)</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
</div><a name="L1371"></a><tt class="py-lineno">1371</tt> <tt class="py-line"> </tt>
<a name="L1372"></a><tt class="py-lineno">1372</tt> <tt class="py-line"> </tt>
<a name="ConfigObj._handle_bom"></a><div id="ConfigObj._handle_bom-def"><a name="L1373"></a><tt class="py-lineno">1373</tt> <a class="py-toggle" href="#" id="ConfigObj._handle_bom-toggle" onclick="return toggle('ConfigObj._handle_bom');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#_handle_bom">_handle_bom</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">infile</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj._handle_bom-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj._handle_bom-expanded"><a name="L1374"></a><tt class="py-lineno">1374</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L1375"></a><tt class="py-lineno">1375</tt> <tt class="py-line"><tt class="py-docstring"> Handle any BOM, and decode if necessary.</tt> </tt>
<a name="L1376"></a><tt class="py-lineno">1376</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L1377"></a><tt class="py-lineno">1377</tt> <tt class="py-line"><tt class="py-docstring"> If an encoding is specified, that *must* be used - but the BOM should</tt> </tt>
<a name="L1378"></a><tt class="py-lineno">1378</tt> <tt class="py-line"><tt class="py-docstring"> still be removed (and the BOM attribute set).</tt> </tt>
<a name="L1379"></a><tt class="py-lineno">1379</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L1380"></a><tt class="py-lineno">1380</tt> <tt class="py-line"><tt class="py-docstring"> (If the encoding is wrongly specified, then a BOM for an alternative</tt> </tt>
<a name="L1381"></a><tt class="py-lineno">1381</tt> <tt class="py-line"><tt class="py-docstring"> encoding won't be discovered or removed.)</tt> </tt>
<a name="L1382"></a><tt class="py-lineno">1382</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L1383"></a><tt class="py-lineno">1383</tt> <tt class="py-line"><tt class="py-docstring"> If an encoding is not specified, UTF8 or UTF16 BOM will be detected and</tt> </tt>
<a name="L1384"></a><tt class="py-lineno">1384</tt> <tt class="py-line"><tt class="py-docstring"> removed. The BOM attribute will be set. UTF16 will be decoded to</tt> </tt>
<a name="L1385"></a><tt class="py-lineno">1385</tt> <tt class="py-line"><tt class="py-docstring"> unicode.</tt> </tt>
<a name="L1386"></a><tt class="py-lineno">1386</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L1387"></a><tt class="py-lineno">1387</tt> <tt class="py-line"><tt class="py-docstring"> NOTE: This method must not be called with an empty ``infile``.</tt> </tt>
<a name="L1388"></a><tt class="py-lineno">1388</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L1389"></a><tt class="py-lineno">1389</tt> <tt class="py-line"><tt class="py-docstring"> Specifying the *wrong* encoding is likely to cause a</tt> </tt>
<a name="L1390"></a><tt class="py-lineno">1390</tt> <tt class="py-line"><tt class="py-docstring"> ``UnicodeDecodeError``.</tt> </tt>
<a name="L1391"></a><tt class="py-lineno">1391</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L1392"></a><tt class="py-lineno">1392</tt> <tt class="py-line"><tt class="py-docstring"> ``infile`` must always be returned as a list of lines, but may be</tt> </tt>
<a name="L1393"></a><tt class="py-lineno">1393</tt> <tt class="py-line"><tt class="py-docstring"> passed in as a single string.</tt> </tt>
<a name="L1394"></a><tt class="py-lineno">1394</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L1395"></a><tt class="py-lineno">1395</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> </tt>
<a name="L1396"></a><tt class="py-lineno">1396</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt><tt class="py-op">.</tt><tt class="py-name">lower</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt id="link-165" class="py-name"><a title="configobj.BOM_LIST" class="py-name" href="#" onclick="return doclink('link-165', 'BOM_LIST', 'link-2');">BOM_LIST</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1397"></a><tt class="py-lineno">1397</tt> <tt class="py-line"> <tt class="py-comment"># No need to check for a BOM</tt> </tt>
<a name="L1398"></a><tt class="py-lineno">1398</tt> <tt class="py-line"> <tt class="py-comment"># the encoding specified doesn't have one</tt> </tt>
<a name="L1399"></a><tt class="py-lineno">1399</tt> <tt class="py-line"> <tt class="py-comment"># just decode</tt> </tt>
<a name="L1400"></a><tt class="py-lineno">1400</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-166" class="py-name" targets="Method configobj.ConfigObj._decode()=configobj.ConfigObj-class.html#_decode"><a title="configobj.ConfigObj._decode" class="py-name" href="#" onclick="return doclink('link-166', '_decode', 'link-166');">_decode</a></tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt><tt class="py-op">)</tt> </tt>
<a name="L1401"></a><tt class="py-lineno">1401</tt> <tt class="py-line"> </tt>
<a name="L1402"></a><tt class="py-lineno">1402</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">list</tt><tt class="py-op">,</tt> <tt class="py-name">tuple</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1403"></a><tt class="py-lineno">1403</tt> <tt class="py-line"> <tt class="py-name">line</tt> <tt class="py-op">=</tt> <tt class="py-name">infile</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> </tt>
<a name="L1404"></a><tt class="py-lineno">1404</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1405"></a><tt class="py-lineno">1405</tt> <tt class="py-line"> <tt class="py-name">line</tt> <tt class="py-op">=</tt> <tt class="py-name">infile</tt> </tt>
<a name="L1406"></a><tt class="py-lineno">1406</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L1407"></a><tt class="py-lineno">1407</tt> <tt class="py-line"> <tt class="py-comment"># encoding explicitly supplied</tt> </tt>
<a name="L1408"></a><tt class="py-lineno">1408</tt> <tt class="py-line"> <tt class="py-comment"># And it could have an associated BOM</tt> </tt>
<a name="L1409"></a><tt class="py-lineno">1409</tt> <tt class="py-line"> <tt class="py-comment"># TODO: if encoding is just UTF16 - we ought to check for both</tt> </tt>
<a name="L1410"></a><tt class="py-lineno">1410</tt> <tt class="py-line"> <tt class="py-comment"># TODO: big endian and little endian versions.</tt> </tt>
<a name="L1411"></a><tt class="py-lineno">1411</tt> <tt class="py-line"> <tt class="py-name">enc</tt> <tt class="py-op">=</tt> <tt id="link-167" class="py-name"><a title="configobj.BOM_LIST" class="py-name" href="#" onclick="return doclink('link-167', 'BOM_LIST', 'link-2');">BOM_LIST</a></tt><tt class="py-op">[</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt><tt class="py-op">.</tt><tt class="py-name">lower</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt>
<a name="L1412"></a><tt class="py-lineno">1412</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">enc</tt> <tt class="py-op">==</tt> <tt class="py-string">'utf_16'</tt><tt class="py-op">:</tt> </tt>
<a name="L1413"></a><tt class="py-lineno">1413</tt> <tt class="py-line"> <tt class="py-comment"># For UTF16 we try big endian and little endian</tt> </tt>
<a name="L1414"></a><tt class="py-lineno">1414</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">BOM</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">encoding</tt><tt class="py-op">,</tt> <tt class="py-name">final_encoding</tt><tt class="py-op">)</tt> <tt class="py-keyword">in</tt> <tt id="link-168" class="py-name"><a title="configobj.BOMS" class="py-name" href="#" onclick="return doclink('link-168', 'BOMS', 'link-1');">BOMS</a></tt><tt class="py-op">.</tt><tt id="link-169" class="py-name"><a title="configobj.Section.items" class="py-name" href="#" onclick="return doclink('link-169', 'items', 'link-102');">items</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1415"></a><tt class="py-lineno">1415</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">final_encoding</tt><tt class="py-op">:</tt> </tt>
<a name="L1416"></a><tt class="py-lineno">1416</tt> <tt class="py-line"> <tt class="py-comment"># skip UTF8</tt> </tt>
<a name="L1417"></a><tt class="py-lineno">1417</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L1418"></a><tt class="py-lineno">1418</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">infile</tt><tt class="py-op">.</tt><tt class="py-name">startswith</tt><tt class="py-op">(</tt><tt class="py-name">BOM</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1419"></a><tt class="py-lineno">1419</tt> <tt class="py-line"> <tt class="py-comment">### BOM discovered</tt> </tt>
<a name="L1420"></a><tt class="py-lineno">1420</tt> <tt class="py-line"> <tt class="py-comment">##self.BOM = True</tt> </tt>
<a name="L1421"></a><tt class="py-lineno">1421</tt> <tt class="py-line"> <tt class="py-comment"># Don't need to remove BOM</tt> </tt>
<a name="L1422"></a><tt class="py-lineno">1422</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-170" class="py-name"><a title="configobj.ConfigObj._decode" class="py-name" href="#" onclick="return doclink('link-170', '_decode', 'link-166');">_decode</a></tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-name">encoding</tt><tt class="py-op">)</tt> </tt>
<a name="L1423"></a><tt class="py-lineno">1423</tt> <tt class="py-line"> </tt>
<a name="L1424"></a><tt class="py-lineno">1424</tt> <tt class="py-line"> <tt class="py-comment"># If we get this far, will *probably* raise a DecodeError</tt> </tt>
<a name="L1425"></a><tt class="py-lineno">1425</tt> <tt class="py-line"> <tt class="py-comment"># As it doesn't appear to start with a BOM</tt> </tt>
<a name="L1426"></a><tt class="py-lineno">1426</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-171" class="py-name"><a title="configobj.ConfigObj._decode" class="py-name" href="#" onclick="return doclink('link-171', '_decode', 'link-166');">_decode</a></tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt><tt class="py-op">)</tt> </tt>
<a name="L1427"></a><tt class="py-lineno">1427</tt> <tt class="py-line"> </tt>
<a name="L1428"></a><tt class="py-lineno">1428</tt> <tt class="py-line"> <tt class="py-comment"># Must be UTF8</tt> </tt>
<a name="L1429"></a><tt class="py-lineno">1429</tt> <tt class="py-line"> <tt class="py-name">BOM</tt> <tt class="py-op">=</tt> <tt id="link-172" class="py-name"><a title="configobj.BOM_SET" class="py-name" href="#" onclick="return doclink('link-172', 'BOM_SET', 'link-3');">BOM_SET</a></tt><tt class="py-op">[</tt><tt class="py-name">enc</tt><tt class="py-op">]</tt> </tt>
<a name="L1430"></a><tt class="py-lineno">1430</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">line</tt><tt class="py-op">.</tt><tt class="py-name">startswith</tt><tt class="py-op">(</tt><tt class="py-name">BOM</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1431"></a><tt class="py-lineno">1431</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-173" class="py-name"><a title="configobj.ConfigObj._decode" class="py-name" href="#" onclick="return doclink('link-173', '_decode', 'link-166');">_decode</a></tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt><tt class="py-op">)</tt> </tt>
<a name="L1432"></a><tt class="py-lineno">1432</tt> <tt class="py-line"> </tt>
<a name="L1433"></a><tt class="py-lineno">1433</tt> <tt class="py-line"> <tt class="py-name">newline</tt> <tt class="py-op">=</tt> <tt class="py-name">line</tt><tt class="py-op">[</tt><tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">BOM</tt><tt class="py-op">)</tt><tt class="py-op">:</tt><tt class="py-op">]</tt> </tt>
<a name="L1434"></a><tt class="py-lineno">1434</tt> <tt class="py-line"> </tt>
<a name="L1435"></a><tt class="py-lineno">1435</tt> <tt class="py-line"> <tt class="py-comment"># BOM removed</tt> </tt>
<a name="L1436"></a><tt class="py-lineno">1436</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">list</tt><tt class="py-op">,</tt> <tt class="py-name">tuple</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1437"></a><tt class="py-lineno">1437</tt> <tt class="py-line"> <tt class="py-name">infile</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">newline</tt> </tt>
<a name="L1438"></a><tt class="py-lineno">1438</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1439"></a><tt class="py-lineno">1439</tt> <tt class="py-line"> <tt class="py-name">infile</tt> <tt class="py-op">=</tt> <tt class="py-name">newline</tt> </tt>
<a name="L1440"></a><tt class="py-lineno">1440</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">BOM</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
<a name="L1441"></a><tt class="py-lineno">1441</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-174" class="py-name"><a title="configobj.ConfigObj._decode" class="py-name" href="#" onclick="return doclink('link-174', '_decode', 'link-166');">_decode</a></tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt><tt class="py-op">)</tt> </tt>
<a name="L1442"></a><tt class="py-lineno">1442</tt> <tt class="py-line"> </tt>
<a name="L1443"></a><tt class="py-lineno">1443</tt> <tt class="py-line"> <tt class="py-comment"># No encoding specified - so we need to check for UTF8/UTF16</tt> </tt>
<a name="L1444"></a><tt class="py-lineno">1444</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">BOM</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">encoding</tt><tt class="py-op">,</tt> <tt class="py-name">final_encoding</tt><tt class="py-op">)</tt> <tt class="py-keyword">in</tt> <tt id="link-175" class="py-name"><a title="configobj.BOMS" class="py-name" href="#" onclick="return doclink('link-175', 'BOMS', 'link-1');">BOMS</a></tt><tt class="py-op">.</tt><tt id="link-176" class="py-name"><a title="configobj.Section.items" class="py-name" href="#" onclick="return doclink('link-176', 'items', 'link-102');">items</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1445"></a><tt class="py-lineno">1445</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">line</tt><tt class="py-op">.</tt><tt class="py-name">startswith</tt><tt class="py-op">(</tt><tt class="py-name">BOM</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1446"></a><tt class="py-lineno">1446</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L1447"></a><tt class="py-lineno">1447</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1448"></a><tt class="py-lineno">1448</tt> <tt class="py-line"> <tt class="py-comment"># BOM discovered</tt> </tt>
<a name="L1449"></a><tt class="py-lineno">1449</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt> <tt class="py-op">=</tt> <tt class="py-name">final_encoding</tt> </tt>
<a name="L1450"></a><tt class="py-lineno">1450</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">final_encoding</tt><tt class="py-op">:</tt> </tt>
<a name="L1451"></a><tt class="py-lineno">1451</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">BOM</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
<a name="L1452"></a><tt class="py-lineno">1452</tt> <tt class="py-line"> <tt class="py-comment"># UTF8</tt> </tt>
<a name="L1453"></a><tt class="py-lineno">1453</tt> <tt class="py-line"> <tt class="py-comment"># remove BOM</tt> </tt>
<a name="L1454"></a><tt class="py-lineno">1454</tt> <tt class="py-line"> <tt class="py-name">newline</tt> <tt class="py-op">=</tt> <tt class="py-name">line</tt><tt class="py-op">[</tt><tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">BOM</tt><tt class="py-op">)</tt><tt class="py-op">:</tt><tt class="py-op">]</tt> </tt>
<a name="L1455"></a><tt class="py-lineno">1455</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">list</tt><tt class="py-op">,</tt> <tt class="py-name">tuple</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1456"></a><tt class="py-lineno">1456</tt> <tt class="py-line"> <tt class="py-name">infile</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">newline</tt> </tt>
<a name="L1457"></a><tt class="py-lineno">1457</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1458"></a><tt class="py-lineno">1458</tt> <tt class="py-line"> <tt class="py-name">infile</tt> <tt class="py-op">=</tt> <tt class="py-name">newline</tt> </tt>
<a name="L1459"></a><tt class="py-lineno">1459</tt> <tt class="py-line"> <tt class="py-comment"># UTF8 - don't decode</tt> </tt>
<a name="L1460"></a><tt class="py-lineno">1460</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-name">basestring</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1461"></a><tt class="py-lineno">1461</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">infile</tt><tt class="py-op">.</tt><tt class="py-name">splitlines</tt><tt class="py-op">(</tt><tt class="py-name">True</tt><tt class="py-op">)</tt> </tt>
<a name="L1462"></a><tt class="py-lineno">1462</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1463"></a><tt class="py-lineno">1463</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">infile</tt> </tt>
<a name="L1464"></a><tt class="py-lineno">1464</tt> <tt class="py-line"> <tt class="py-comment"># UTF16 - have to decode</tt> </tt>
<a name="L1465"></a><tt class="py-lineno">1465</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-177" class="py-name"><a title="configobj.ConfigObj._decode" class="py-name" href="#" onclick="return doclink('link-177', '_decode', 'link-166');">_decode</a></tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-name">encoding</tt><tt class="py-op">)</tt> </tt>
<a name="L1466"></a><tt class="py-lineno">1466</tt> <tt class="py-line"> </tt>
<a name="L1467"></a><tt class="py-lineno">1467</tt> <tt class="py-line"> <tt class="py-comment"># No BOM discovered and no encoding specified, just return</tt> </tt>
<a name="L1468"></a><tt class="py-lineno">1468</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-name">basestring</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1469"></a><tt class="py-lineno">1469</tt> <tt class="py-line"> <tt class="py-comment"># infile read from a file will be a single string</tt> </tt>
<a name="L1470"></a><tt class="py-lineno">1470</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">infile</tt><tt class="py-op">.</tt><tt class="py-name">splitlines</tt><tt class="py-op">(</tt><tt class="py-name">True</tt><tt class="py-op">)</tt> </tt>
<a name="L1471"></a><tt class="py-lineno">1471</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">infile</tt> </tt>
</div><a name="L1472"></a><tt class="py-lineno">1472</tt> <tt class="py-line"> </tt>
<a name="L1473"></a><tt class="py-lineno">1473</tt> <tt class="py-line"> </tt>
<a name="ConfigObj._a_to_u"></a><div id="ConfigObj._a_to_u-def"><a name="L1474"></a><tt class="py-lineno">1474</tt> <a class="py-toggle" href="#" id="ConfigObj._a_to_u-toggle" onclick="return toggle('ConfigObj._a_to_u');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#_a_to_u">_a_to_u</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">aString</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj._a_to_u-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj._a_to_u-expanded"><a name="L1475"></a><tt class="py-lineno">1475</tt> <tt class="py-line"> <tt class="py-docstring">"""Decode ASCII strings to unicode if a self.encoding is specified."""</tt> </tt>
<a name="L1476"></a><tt class="py-lineno">1476</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt><tt class="py-op">:</tt> </tt>
<a name="L1477"></a><tt class="py-lineno">1477</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">aString</tt><tt class="py-op">.</tt><tt class="py-name">decode</tt><tt class="py-op">(</tt><tt class="py-string">'ascii'</tt><tt class="py-op">)</tt> </tt>
<a name="L1478"></a><tt class="py-lineno">1478</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1479"></a><tt class="py-lineno">1479</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">aString</tt> </tt>
</div><a name="L1480"></a><tt class="py-lineno">1480</tt> <tt class="py-line"> </tt>
<a name="L1481"></a><tt class="py-lineno">1481</tt> <tt class="py-line"> </tt>
<a name="ConfigObj._decode"></a><div id="ConfigObj._decode-def"><a name="L1482"></a><tt class="py-lineno">1482</tt> <a class="py-toggle" href="#" id="ConfigObj._decode-toggle" onclick="return toggle('ConfigObj._decode');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#_decode">_decode</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">infile</tt><tt class="py-op">,</tt> <tt class="py-param">encoding</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj._decode-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj._decode-expanded"><a name="L1483"></a><tt class="py-lineno">1483</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L1484"></a><tt class="py-lineno">1484</tt> <tt class="py-line"><tt class="py-docstring"> Decode infile to unicode. Using the specified encoding.</tt> </tt>
<a name="L1485"></a><tt class="py-lineno">1485</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L1486"></a><tt class="py-lineno">1486</tt> <tt class="py-line"><tt class="py-docstring"> if is a string, it also needs converting to a list.</tt> </tt>
<a name="L1487"></a><tt class="py-lineno">1487</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L1488"></a><tt class="py-lineno">1488</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-name">basestring</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1489"></a><tt class="py-lineno">1489</tt> <tt class="py-line"> <tt class="py-comment"># can't be unicode</tt> </tt>
<a name="L1490"></a><tt class="py-lineno">1490</tt> <tt class="py-line"> <tt class="py-comment"># NOTE: Could raise a ``UnicodeDecodeError``</tt> </tt>
<a name="L1491"></a><tt class="py-lineno">1491</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">infile</tt><tt class="py-op">.</tt><tt class="py-name">decode</tt><tt class="py-op">(</tt><tt class="py-name">encoding</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">splitlines</tt><tt class="py-op">(</tt><tt class="py-name">True</tt><tt class="py-op">)</tt> </tt>
<a name="L1492"></a><tt class="py-lineno">1492</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt><tt class="py-op">,</tt> <tt class="py-name">line</tt> <tt class="py-keyword">in</tt> <tt class="py-name">enumerate</tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1493"></a><tt class="py-lineno">1493</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1494"></a><tt class="py-lineno">1494</tt> <tt class="py-line"> <tt class="py-comment"># NOTE: The isinstance test here handles mixed lists of unicode/string</tt> </tt>
<a name="L1495"></a><tt class="py-lineno">1495</tt> <tt class="py-line"> <tt class="py-comment"># NOTE: But the decode will break on any non-string values</tt> </tt>
<a name="L1496"></a><tt class="py-lineno">1496</tt> <tt class="py-line"> <tt class="py-comment"># NOTE: Or could raise a ``UnicodeDecodeError``</tt> </tt>
<a name="L1497"></a><tt class="py-lineno">1497</tt> <tt class="py-line"> <tt class="py-name">infile</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">line</tt><tt class="py-op">.</tt><tt class="py-name">decode</tt><tt class="py-op">(</tt><tt class="py-name">encoding</tt><tt class="py-op">)</tt> </tt>
<a name="L1498"></a><tt class="py-lineno">1498</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">infile</tt> </tt>
</div><a name="L1499"></a><tt class="py-lineno">1499</tt> <tt class="py-line"> </tt>
<a name="L1500"></a><tt class="py-lineno">1500</tt> <tt class="py-line"> </tt>
<a name="ConfigObj._decode_element"></a><div id="ConfigObj._decode_element-def"><a name="L1501"></a><tt class="py-lineno">1501</tt> <a class="py-toggle" href="#" id="ConfigObj._decode_element-toggle" onclick="return toggle('ConfigObj._decode_element');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#_decode_element">_decode_element</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">line</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj._decode_element-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj._decode_element-expanded"><a name="L1502"></a><tt class="py-lineno">1502</tt> <tt class="py-line"> <tt class="py-docstring">"""Decode element to unicode if necessary."""</tt> </tt>
<a name="L1503"></a><tt class="py-lineno">1503</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt><tt class="py-op">:</tt> </tt>
<a name="L1504"></a><tt class="py-lineno">1504</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">line</tt> </tt>
<a name="L1505"></a><tt class="py-lineno">1505</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">,</tt> <tt class="py-name">str</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">default_encoding</tt><tt class="py-op">:</tt> </tt>
<a name="L1506"></a><tt class="py-lineno">1506</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">line</tt><tt class="py-op">.</tt><tt class="py-name">decode</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">default_encoding</tt><tt class="py-op">)</tt> </tt>
<a name="L1507"></a><tt class="py-lineno">1507</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">line</tt> </tt>
</div><a name="L1508"></a><tt class="py-lineno">1508</tt> <tt class="py-line"> </tt>
<a name="L1509"></a><tt class="py-lineno">1509</tt> <tt class="py-line"> </tt>
<a name="ConfigObj._str"></a><div id="ConfigObj._str-def"><a name="L1510"></a><tt class="py-lineno">1510</tt> <a class="py-toggle" href="#" id="ConfigObj._str-toggle" onclick="return toggle('ConfigObj._str');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#_str">_str</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj._str-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj._str-expanded"><a name="L1511"></a><tt class="py-lineno">1511</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L1512"></a><tt class="py-lineno">1512</tt> <tt class="py-line"><tt class="py-docstring"> Used by ``stringify`` within validate, to turn non-string values</tt> </tt>
<a name="L1513"></a><tt class="py-lineno">1513</tt> <tt class="py-line"><tt class="py-docstring"> into strings.</tt> </tt>
<a name="L1514"></a><tt class="py-lineno">1514</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L1515"></a><tt class="py-lineno">1515</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-name">basestring</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1516"></a><tt class="py-lineno">1516</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
<a name="L1517"></a><tt class="py-lineno">1517</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1518"></a><tt class="py-lineno">1518</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">value</tt> </tt>
</div><a name="L1519"></a><tt class="py-lineno">1519</tt> <tt class="py-line"> </tt>
<a name="L1520"></a><tt class="py-lineno">1520</tt> <tt class="py-line"> </tt>
<a name="ConfigObj._parse"></a><div id="ConfigObj._parse-def"><a name="L1521"></a><tt class="py-lineno">1521</tt> <a class="py-toggle" href="#" id="ConfigObj._parse-toggle" onclick="return toggle('ConfigObj._parse');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#_parse">_parse</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">infile</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj._parse-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj._parse-expanded"><a name="L1522"></a><tt class="py-lineno">1522</tt> <tt class="py-line"> <tt class="py-docstring">"""Actually parse the config file."""</tt> </tt>
<a name="L1523"></a><tt class="py-lineno">1523</tt> <tt class="py-line"> <tt class="py-name">temp_list_values</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">list_values</tt> </tt>
<a name="L1524"></a><tt class="py-lineno">1524</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-178" class="py-name"><a title="configobj.unrepr" class="py-name" href="#" onclick="return doclink('link-178', 'unrepr', 'link-89');">unrepr</a></tt><tt class="py-op">:</tt> </tt>
<a name="L1525"></a><tt class="py-lineno">1525</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">list_values</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L1526"></a><tt class="py-lineno">1526</tt> <tt class="py-line"> </tt>
<a name="L1527"></a><tt class="py-lineno">1527</tt> <tt class="py-line"> <tt class="py-name">comment_list</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L1528"></a><tt class="py-lineno">1528</tt> <tt class="py-line"> <tt class="py-name">done_start</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L1529"></a><tt class="py-lineno">1529</tt> <tt class="py-line"> <tt class="py-name">this_section</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt> </tt>
<a name="L1530"></a><tt class="py-lineno">1530</tt> <tt class="py-line"> <tt class="py-name">maxline</tt> <tt class="py-op">=</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">infile</tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt> </tt>
<a name="L1531"></a><tt class="py-lineno">1531</tt> <tt class="py-line"> <tt class="py-name">cur_index</tt> <tt class="py-op">=</tt> <tt class="py-op">-</tt><tt class="py-number">1</tt> </tt>
<a name="L1532"></a><tt class="py-lineno">1532</tt> <tt class="py-line"> <tt class="py-name">reset_comment</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L1533"></a><tt class="py-lineno">1533</tt> <tt class="py-line"> </tt>
<a name="L1534"></a><tt class="py-lineno">1534</tt> <tt class="py-line"> <tt class="py-keyword">while</tt> <tt class="py-name">cur_index</tt> <tt class="py-op"><</tt> <tt class="py-name">maxline</tt><tt class="py-op">:</tt> </tt>
<a name="L1535"></a><tt class="py-lineno">1535</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">reset_comment</tt><tt class="py-op">:</tt> </tt>
<a name="L1536"></a><tt class="py-lineno">1536</tt> <tt class="py-line"> <tt class="py-name">comment_list</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L1537"></a><tt class="py-lineno">1537</tt> <tt class="py-line"> <tt class="py-name">cur_index</tt> <tt class="py-op">+=</tt> <tt class="py-number">1</tt> </tt>
<a name="L1538"></a><tt class="py-lineno">1538</tt> <tt class="py-line"> <tt class="py-name">line</tt> <tt class="py-op">=</tt> <tt class="py-name">infile</tt><tt class="py-op">[</tt><tt class="py-name">cur_index</tt><tt class="py-op">]</tt> </tt>
<a name="L1539"></a><tt class="py-lineno">1539</tt> <tt class="py-line"> <tt class="py-name">sline</tt> <tt class="py-op">=</tt> <tt class="py-name">line</tt><tt class="py-op">.</tt><tt class="py-name">strip</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L1540"></a><tt class="py-lineno">1540</tt> <tt class="py-line"> <tt class="py-comment"># do we have anything on the line ?</tt> </tt>
<a name="L1541"></a><tt class="py-lineno">1541</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">sline</tt> <tt class="py-keyword">or</tt> <tt class="py-name">sline</tt><tt class="py-op">.</tt><tt class="py-name">startswith</tt><tt class="py-op">(</tt><tt class="py-string">'#'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1542"></a><tt class="py-lineno">1542</tt> <tt class="py-line"> <tt class="py-name">reset_comment</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L1543"></a><tt class="py-lineno">1543</tt> <tt class="py-line"> <tt class="py-name">comment_list</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">)</tt> </tt>
<a name="L1544"></a><tt class="py-lineno">1544</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L1545"></a><tt class="py-lineno">1545</tt> <tt class="py-line"> </tt>
<a name="L1546"></a><tt class="py-lineno">1546</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">done_start</tt><tt class="py-op">:</tt> </tt>
<a name="L1547"></a><tt class="py-lineno">1547</tt> <tt class="py-line"> <tt class="py-comment"># preserve initial comment</tt> </tt>
<a name="L1548"></a><tt class="py-lineno">1548</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">initial_comment</tt> <tt class="py-op">=</tt> <tt class="py-name">comment_list</tt> </tt>
<a name="L1549"></a><tt class="py-lineno">1549</tt> <tt class="py-line"> <tt class="py-name">comment_list</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L1550"></a><tt class="py-lineno">1550</tt> <tt class="py-line"> <tt class="py-name">done_start</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
<a name="L1551"></a><tt class="py-lineno">1551</tt> <tt class="py-line"> </tt>
<a name="L1552"></a><tt class="py-lineno">1552</tt> <tt class="py-line"> <tt class="py-name">reset_comment</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
<a name="L1553"></a><tt class="py-lineno">1553</tt> <tt class="py-line"> <tt class="py-comment"># first we check if it's a section marker</tt> </tt>
<a name="L1554"></a><tt class="py-lineno">1554</tt> <tt class="py-line"> <tt class="py-name">mat</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-179" class="py-name"><a title="configobj.ConfigObj._sectionmarker" class="py-name" href="#" onclick="return doclink('link-179', '_sectionmarker', 'link-126');">_sectionmarker</a></tt><tt class="py-op">.</tt><tt class="py-name">match</tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">)</tt> </tt>
<a name="L1555"></a><tt class="py-lineno">1555</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">mat</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L1556"></a><tt class="py-lineno">1556</tt> <tt class="py-line"> <tt class="py-comment"># is a section line</tt> </tt>
<a name="L1557"></a><tt class="py-lineno">1557</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">indent</tt><tt class="py-op">,</tt> <tt class="py-name">sect_open</tt><tt class="py-op">,</tt> <tt class="py-name">sect_name</tt><tt class="py-op">,</tt> <tt class="py-name">sect_close</tt><tt class="py-op">,</tt> <tt class="py-name">comment</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt class="py-name">mat</tt><tt class="py-op">.</tt><tt class="py-name">groups</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L1558"></a><tt class="py-lineno">1558</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">indent</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">indent_type</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1559"></a><tt class="py-lineno">1559</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">indent_type</tt> <tt class="py-op">=</tt> <tt class="py-name">indent</tt> </tt>
<a name="L1560"></a><tt class="py-lineno">1560</tt> <tt class="py-line"> <tt class="py-name">cur_depth</tt> <tt class="py-op">=</tt> <tt class="py-name">sect_open</tt><tt class="py-op">.</tt><tt class="py-name">count</tt><tt class="py-op">(</tt><tt class="py-string">'['</tt><tt class="py-op">)</tt> </tt>
<a name="L1561"></a><tt class="py-lineno">1561</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">cur_depth</tt> <tt class="py-op">!=</tt> <tt class="py-name">sect_close</tt><tt class="py-op">.</tt><tt class="py-name">count</tt><tt class="py-op">(</tt><tt class="py-string">']'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1562"></a><tt class="py-lineno">1562</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-180" class="py-name" targets="Method configobj.ConfigObj._handle_error()=configobj.ConfigObj-class.html#_handle_error"><a title="configobj.ConfigObj._handle_error" class="py-name" href="#" onclick="return doclink('link-180', '_handle_error', 'link-180');">_handle_error</a></tt><tt class="py-op">(</tt><tt class="py-string">"Cannot compute the section depth at line %s."</tt><tt class="py-op">,</tt> </tt>
<a name="L1563"></a><tt class="py-lineno">1563</tt> <tt class="py-line"> <tt id="link-181" class="py-name" targets="Class configobj.NestingError=configobj.NestingError-class.html"><a title="configobj.NestingError" class="py-name" href="#" onclick="return doclink('link-181', 'NestingError', 'link-181');">NestingError</a></tt><tt class="py-op">,</tt> <tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-name">cur_index</tt><tt class="py-op">)</tt> </tt>
<a name="L1564"></a><tt class="py-lineno">1564</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L1565"></a><tt class="py-lineno">1565</tt> <tt class="py-line"> </tt>
<a name="L1566"></a><tt class="py-lineno">1566</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">cur_depth</tt> <tt class="py-op"><</tt> <tt class="py-name">this_section</tt><tt class="py-op">.</tt><tt class="py-name">depth</tt><tt class="py-op">:</tt> </tt>
<a name="L1567"></a><tt class="py-lineno">1567</tt> <tt class="py-line"> <tt class="py-comment"># the new section is dropping back to a previous level</tt> </tt>
<a name="L1568"></a><tt class="py-lineno">1568</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
<a name="L1569"></a><tt class="py-lineno">1569</tt> <tt class="py-line"> <tt class="py-name">parent</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-182" class="py-name" targets="Method configobj.ConfigObj._match_depth()=configobj.ConfigObj-class.html#_match_depth"><a title="configobj.ConfigObj._match_depth" class="py-name" href="#" onclick="return doclink('link-182', '_match_depth', 'link-182');">_match_depth</a></tt><tt class="py-op">(</tt><tt class="py-name">this_section</tt><tt class="py-op">,</tt> </tt>
<a name="L1570"></a><tt class="py-lineno">1570</tt> <tt class="py-line"> <tt class="py-name">cur_depth</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">parent</tt> </tt>
<a name="L1571"></a><tt class="py-lineno">1571</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">SyntaxError</tt><tt class="py-op">:</tt> </tt>
<a name="L1572"></a><tt class="py-lineno">1572</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-183" class="py-name"><a title="configobj.ConfigObj._handle_error" class="py-name" href="#" onclick="return doclink('link-183', '_handle_error', 'link-180');">_handle_error</a></tt><tt class="py-op">(</tt><tt class="py-string">"Cannot compute nesting level at line %s."</tt><tt class="py-op">,</tt> </tt>
<a name="L1573"></a><tt class="py-lineno">1573</tt> <tt class="py-line"> <tt id="link-184" class="py-name"><a title="configobj.NestingError" class="py-name" href="#" onclick="return doclink('link-184', 'NestingError', 'link-181');">NestingError</a></tt><tt class="py-op">,</tt> <tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-name">cur_index</tt><tt class="py-op">)</tt> </tt>
<a name="L1574"></a><tt class="py-lineno">1574</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L1575"></a><tt class="py-lineno">1575</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">cur_depth</tt> <tt class="py-op">==</tt> <tt class="py-name">this_section</tt><tt class="py-op">.</tt><tt class="py-name">depth</tt><tt class="py-op">:</tt> </tt>
<a name="L1576"></a><tt class="py-lineno">1576</tt> <tt class="py-line"> <tt class="py-comment"># the new section is a sibling of the current section</tt> </tt>
<a name="L1577"></a><tt class="py-lineno">1577</tt> <tt class="py-line"> <tt class="py-name">parent</tt> <tt class="py-op">=</tt> <tt class="py-name">this_section</tt><tt class="py-op">.</tt><tt class="py-name">parent</tt> </tt>
<a name="L1578"></a><tt class="py-lineno">1578</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">cur_depth</tt> <tt class="py-op">==</tt> <tt class="py-name">this_section</tt><tt class="py-op">.</tt><tt class="py-name">depth</tt> <tt class="py-op">+</tt> <tt class="py-number">1</tt><tt class="py-op">:</tt> </tt>
<a name="L1579"></a><tt class="py-lineno">1579</tt> <tt class="py-line"> <tt class="py-comment"># the new section is a child the current section</tt> </tt>
<a name="L1580"></a><tt class="py-lineno">1580</tt> <tt class="py-line"> <tt class="py-name">parent</tt> <tt class="py-op">=</tt> <tt class="py-name">this_section</tt> </tt>
<a name="L1581"></a><tt class="py-lineno">1581</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1582"></a><tt class="py-lineno">1582</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-185" class="py-name"><a title="configobj.ConfigObj._handle_error" class="py-name" href="#" onclick="return doclink('link-185', '_handle_error', 'link-180');">_handle_error</a></tt><tt class="py-op">(</tt><tt class="py-string">"Section too nested at line %s."</tt><tt class="py-op">,</tt> </tt>
<a name="L1583"></a><tt class="py-lineno">1583</tt> <tt class="py-line"> <tt id="link-186" class="py-name"><a title="configobj.NestingError" class="py-name" href="#" onclick="return doclink('link-186', 'NestingError', 'link-181');">NestingError</a></tt><tt class="py-op">,</tt> <tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-name">cur_index</tt><tt class="py-op">)</tt> </tt>
<a name="L1584"></a><tt class="py-lineno">1584</tt> <tt class="py-line"> </tt>
<a name="L1585"></a><tt class="py-lineno">1585</tt> <tt class="py-line"> <tt class="py-name">sect_name</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-187" class="py-name" targets="Method configobj.ConfigObj._unquote()=configobj.ConfigObj-class.html#_unquote"><a title="configobj.ConfigObj._unquote" class="py-name" href="#" onclick="return doclink('link-187', '_unquote', 'link-187');">_unquote</a></tt><tt class="py-op">(</tt><tt class="py-name">sect_name</tt><tt class="py-op">)</tt> </tt>
<a name="L1586"></a><tt class="py-lineno">1586</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">sect_name</tt> <tt class="py-keyword">in</tt> <tt class="py-name">parent</tt><tt class="py-op">:</tt> </tt>
<a name="L1587"></a><tt class="py-lineno">1587</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-188" class="py-name"><a title="configobj.ConfigObj._handle_error" class="py-name" href="#" onclick="return doclink('link-188', '_handle_error', 'link-180');">_handle_error</a></tt><tt class="py-op">(</tt><tt class="py-string">'Duplicate section name at line %s.'</tt><tt class="py-op">,</tt> </tt>
<a name="L1588"></a><tt class="py-lineno">1588</tt> <tt class="py-line"> <tt id="link-189" class="py-name" targets="Class configobj.DuplicateError=configobj.DuplicateError-class.html"><a title="configobj.DuplicateError" class="py-name" href="#" onclick="return doclink('link-189', 'DuplicateError', 'link-189');">DuplicateError</a></tt><tt class="py-op">,</tt> <tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-name">cur_index</tt><tt class="py-op">)</tt> </tt>
<a name="L1589"></a><tt class="py-lineno">1589</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L1590"></a><tt class="py-lineno">1590</tt> <tt class="py-line"> </tt>
<a name="L1591"></a><tt class="py-lineno">1591</tt> <tt class="py-line"> <tt class="py-comment"># create the new section</tt> </tt>
<a name="L1592"></a><tt class="py-lineno">1592</tt> <tt class="py-line"> <tt class="py-name">this_section</tt> <tt class="py-op">=</tt> <tt id="link-190" class="py-name"><a title="configobj.Section" class="py-name" href="#" onclick="return doclink('link-190', 'Section', 'link-52');">Section</a></tt><tt class="py-op">(</tt> </tt>
<a name="L1593"></a><tt class="py-lineno">1593</tt> <tt class="py-line"> <tt class="py-name">parent</tt><tt class="py-op">,</tt> </tt>
<a name="L1594"></a><tt class="py-lineno">1594</tt> <tt class="py-line"> <tt class="py-name">cur_depth</tt><tt class="py-op">,</tt> </tt>
<a name="L1595"></a><tt class="py-lineno">1595</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">,</tt> </tt>
<a name="L1596"></a><tt class="py-lineno">1596</tt> <tt class="py-line"> <tt class="py-name">name</tt><tt class="py-op">=</tt><tt class="py-name">sect_name</tt><tt class="py-op">)</tt> </tt>
<a name="L1597"></a><tt class="py-lineno">1597</tt> <tt class="py-line"> <tt class="py-name">parent</tt><tt class="py-op">[</tt><tt class="py-name">sect_name</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">this_section</tt> </tt>
<a name="L1598"></a><tt class="py-lineno">1598</tt> <tt class="py-line"> <tt class="py-name">parent</tt><tt class="py-op">.</tt><tt class="py-name">inline_comments</tt><tt class="py-op">[</tt><tt class="py-name">sect_name</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">comment</tt> </tt>
<a name="L1599"></a><tt class="py-lineno">1599</tt> <tt class="py-line"> <tt class="py-name">parent</tt><tt class="py-op">.</tt><tt class="py-name">comments</tt><tt class="py-op">[</tt><tt class="py-name">sect_name</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">comment_list</tt> </tt>
<a name="L1600"></a><tt class="py-lineno">1600</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L1601"></a><tt class="py-lineno">1601</tt> <tt class="py-line"> <tt class="py-comment">#</tt> </tt>
<a name="L1602"></a><tt class="py-lineno">1602</tt> <tt class="py-line"> <tt class="py-comment"># it's not a section marker,</tt> </tt>
<a name="L1603"></a><tt class="py-lineno">1603</tt> <tt class="py-line"> <tt class="py-comment"># so it should be a valid ``key = value`` line</tt> </tt>
<a name="L1604"></a><tt class="py-lineno">1604</tt> <tt class="py-line"> <tt class="py-name">mat</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-191" class="py-name"><a title="configobj.ConfigObj._keyword" class="py-name" href="#" onclick="return doclink('link-191', '_keyword', 'link-125');">_keyword</a></tt><tt class="py-op">.</tt><tt class="py-name">match</tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">)</tt> </tt>
<a name="L1605"></a><tt class="py-lineno">1605</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">mat</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L1606"></a><tt class="py-lineno">1606</tt> <tt class="py-line"> <tt class="py-comment"># it neither matched as a keyword</tt> </tt>
<a name="L1607"></a><tt class="py-lineno">1607</tt> <tt class="py-line"> <tt class="py-comment"># or a section marker</tt> </tt>
<a name="L1608"></a><tt class="py-lineno">1608</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-192" class="py-name"><a title="configobj.ConfigObj._handle_error" class="py-name" href="#" onclick="return doclink('link-192', '_handle_error', 'link-180');">_handle_error</a></tt><tt class="py-op">(</tt> </tt>
<a name="L1609"></a><tt class="py-lineno">1609</tt> <tt class="py-line"> <tt class="py-string">'Invalid line at line "%s".'</tt><tt class="py-op">,</tt> </tt>
<a name="L1610"></a><tt class="py-lineno">1610</tt> <tt class="py-line"> <tt id="link-193" class="py-name" targets="Class configobj.ParseError=configobj.ParseError-class.html"><a title="configobj.ParseError" class="py-name" href="#" onclick="return doclink('link-193', 'ParseError', 'link-193');">ParseError</a></tt><tt class="py-op">,</tt> <tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-name">cur_index</tt><tt class="py-op">)</tt> </tt>
<a name="L1611"></a><tt class="py-lineno">1611</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1612"></a><tt class="py-lineno">1612</tt> <tt class="py-line"> <tt class="py-comment"># is a keyword value</tt> </tt>
<a name="L1613"></a><tt class="py-lineno">1613</tt> <tt class="py-line"> <tt class="py-comment"># value will include any inline comment</tt> </tt>
<a name="L1614"></a><tt class="py-lineno">1614</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">indent</tt><tt class="py-op">,</tt> <tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">value</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt class="py-name">mat</tt><tt class="py-op">.</tt><tt class="py-name">groups</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L1615"></a><tt class="py-lineno">1615</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">indent</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">indent_type</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1616"></a><tt class="py-lineno">1616</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">indent_type</tt> <tt class="py-op">=</tt> <tt class="py-name">indent</tt> </tt>
<a name="L1617"></a><tt class="py-lineno">1617</tt> <tt class="py-line"> <tt class="py-comment"># check for a multiline value</tt> </tt>
<a name="L1618"></a><tt class="py-lineno">1618</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">value</tt><tt class="py-op">[</tt><tt class="py-op">:</tt><tt class="py-number">3</tt><tt class="py-op">]</tt> <tt class="py-keyword">in</tt> <tt class="py-op">[</tt><tt class="py-string">'"""'</tt><tt class="py-op">,</tt> <tt class="py-string">"'''"</tt><tt class="py-op">]</tt><tt class="py-op">:</tt> </tt>
<a name="L1619"></a><tt class="py-lineno">1619</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
<a name="L1620"></a><tt class="py-lineno">1620</tt> <tt class="py-line"> <tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-name">comment</tt><tt class="py-op">,</tt> <tt class="py-name">cur_index</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-194" class="py-name" targets="Method configobj.ConfigObj._multiline()=configobj.ConfigObj-class.html#_multiline"><a title="configobj.ConfigObj._multiline" class="py-name" href="#" onclick="return doclink('link-194', '_multiline', 'link-194');">_multiline</a></tt><tt class="py-op">(</tt> </tt>
<a name="L1621"></a><tt class="py-lineno">1621</tt> <tt class="py-line"> <tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-name">cur_index</tt><tt class="py-op">,</tt> <tt class="py-name">maxline</tt><tt class="py-op">)</tt> </tt>
<a name="L1622"></a><tt class="py-lineno">1622</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">SyntaxError</tt><tt class="py-op">:</tt> </tt>
<a name="L1623"></a><tt class="py-lineno">1623</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-195" class="py-name"><a title="configobj.ConfigObj._handle_error" class="py-name" href="#" onclick="return doclink('link-195', '_handle_error', 'link-180');">_handle_error</a></tt><tt class="py-op">(</tt> </tt>
<a name="L1624"></a><tt class="py-lineno">1624</tt> <tt class="py-line"> <tt class="py-string">'Parse error in value at line %s.'</tt><tt class="py-op">,</tt> </tt>
<a name="L1625"></a><tt class="py-lineno">1625</tt> <tt class="py-line"> <tt id="link-196" class="py-name"><a title="configobj.ParseError" class="py-name" href="#" onclick="return doclink('link-196', 'ParseError', 'link-193');">ParseError</a></tt><tt class="py-op">,</tt> <tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-name">cur_index</tt><tt class="py-op">)</tt> </tt>
<a name="L1626"></a><tt class="py-lineno">1626</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L1627"></a><tt class="py-lineno">1627</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1628"></a><tt class="py-lineno">1628</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-197" class="py-name"><a title="configobj.unrepr" class="py-name" href="#" onclick="return doclink('link-197', 'unrepr', 'link-89');">unrepr</a></tt><tt class="py-op">:</tt> </tt>
<a name="L1629"></a><tt class="py-lineno">1629</tt> <tt class="py-line"> <tt class="py-name">comment</tt> <tt class="py-op">=</tt> <tt class="py-string">''</tt> </tt>
<a name="L1630"></a><tt class="py-lineno">1630</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
<a name="L1631"></a><tt class="py-lineno">1631</tt> <tt class="py-line"> <tt class="py-name">value</tt> <tt class="py-op">=</tt> <tt id="link-198" class="py-name"><a title="configobj.unrepr" class="py-name" href="#" onclick="return doclink('link-198', 'unrepr', 'link-89');">unrepr</a></tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
<a name="L1632"></a><tt class="py-lineno">1632</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">Exception</tt><tt class="py-op">,</tt> <tt class="py-name">e</tt><tt class="py-op">:</tt> </tt>
<a name="L1633"></a><tt class="py-lineno">1633</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-name">e</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt id="link-199" class="py-name"><a title="configobj.UnknownType" class="py-name" href="#" onclick="return doclink('link-199', 'UnknownType', 'link-22');">UnknownType</a></tt><tt class="py-op">:</tt> </tt>
<a name="L1634"></a><tt class="py-lineno">1634</tt> <tt class="py-line"> <tt class="py-name">msg</tt> <tt class="py-op">=</tt> <tt class="py-string">'Unknown name or type in value at line %s.'</tt> </tt>
<a name="L1635"></a><tt class="py-lineno">1635</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1636"></a><tt class="py-lineno">1636</tt> <tt class="py-line"> <tt class="py-name">msg</tt> <tt class="py-op">=</tt> <tt class="py-string">'Parse error in value at line %s.'</tt> </tt>
<a name="L1637"></a><tt class="py-lineno">1637</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-200" class="py-name"><a title="configobj.ConfigObj._handle_error" class="py-name" href="#" onclick="return doclink('link-200', '_handle_error', 'link-180');">_handle_error</a></tt><tt class="py-op">(</tt><tt class="py-name">msg</tt><tt class="py-op">,</tt> <tt id="link-201" class="py-name" targets="Class configobj.UnreprError=configobj.UnreprError-class.html"><a title="configobj.UnreprError" class="py-name" href="#" onclick="return doclink('link-201', 'UnreprError', 'link-201');">UnreprError</a></tt><tt class="py-op">,</tt> <tt class="py-name">infile</tt><tt class="py-op">,</tt> </tt>
<a name="L1638"></a><tt class="py-lineno">1638</tt> <tt class="py-line"> <tt class="py-name">cur_index</tt><tt class="py-op">)</tt> </tt>
<a name="L1639"></a><tt class="py-lineno">1639</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L1640"></a><tt class="py-lineno">1640</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1641"></a><tt class="py-lineno">1641</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-202" class="py-name"><a title="configobj.unrepr" class="py-name" href="#" onclick="return doclink('link-202', 'unrepr', 'link-89');">unrepr</a></tt><tt class="py-op">:</tt> </tt>
<a name="L1642"></a><tt class="py-lineno">1642</tt> <tt class="py-line"> <tt class="py-name">comment</tt> <tt class="py-op">=</tt> <tt class="py-string">''</tt> </tt>
<a name="L1643"></a><tt class="py-lineno">1643</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
<a name="L1644"></a><tt class="py-lineno">1644</tt> <tt class="py-line"> <tt class="py-name">value</tt> <tt class="py-op">=</tt> <tt id="link-203" class="py-name"><a title="configobj.unrepr" class="py-name" href="#" onclick="return doclink('link-203', 'unrepr', 'link-89');">unrepr</a></tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
<a name="L1645"></a><tt class="py-lineno">1645</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">Exception</tt><tt class="py-op">,</tt> <tt class="py-name">e</tt><tt class="py-op">:</tt> </tt>
<a name="L1646"></a><tt class="py-lineno">1646</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">e</tt><tt class="py-op">,</tt> <tt id="link-204" class="py-name"><a title="configobj.UnknownType" class="py-name" href="#" onclick="return doclink('link-204', 'UnknownType', 'link-22');">UnknownType</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1647"></a><tt class="py-lineno">1647</tt> <tt class="py-line"> <tt class="py-name">msg</tt> <tt class="py-op">=</tt> <tt class="py-string">'Unknown name or type in value at line %s.'</tt> </tt>
<a name="L1648"></a><tt class="py-lineno">1648</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1649"></a><tt class="py-lineno">1649</tt> <tt class="py-line"> <tt class="py-name">msg</tt> <tt class="py-op">=</tt> <tt class="py-string">'Parse error in value at line %s.'</tt> </tt>
<a name="L1650"></a><tt class="py-lineno">1650</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-205" class="py-name"><a title="configobj.ConfigObj._handle_error" class="py-name" href="#" onclick="return doclink('link-205', '_handle_error', 'link-180');">_handle_error</a></tt><tt class="py-op">(</tt><tt class="py-name">msg</tt><tt class="py-op">,</tt> <tt id="link-206" class="py-name"><a title="configobj.UnreprError" class="py-name" href="#" onclick="return doclink('link-206', 'UnreprError', 'link-201');">UnreprError</a></tt><tt class="py-op">,</tt> <tt class="py-name">infile</tt><tt class="py-op">,</tt> </tt>
<a name="L1651"></a><tt class="py-lineno">1651</tt> <tt class="py-line"> <tt class="py-name">cur_index</tt><tt class="py-op">)</tt> </tt>
<a name="L1652"></a><tt class="py-lineno">1652</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L1653"></a><tt class="py-lineno">1653</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1654"></a><tt class="py-lineno">1654</tt> <tt class="py-line"> <tt class="py-comment"># extract comment and lists</tt> </tt>
<a name="L1655"></a><tt class="py-lineno">1655</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
<a name="L1656"></a><tt class="py-lineno">1656</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-name">comment</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-207" class="py-name" targets="Method configobj.ConfigObj._handle_value()=configobj.ConfigObj-class.html#_handle_value"><a title="configobj.ConfigObj._handle_value" class="py-name" href="#" onclick="return doclink('link-207', '_handle_value', 'link-207');">_handle_value</a></tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
<a name="L1657"></a><tt class="py-lineno">1657</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">SyntaxError</tt><tt class="py-op">:</tt> </tt>
<a name="L1658"></a><tt class="py-lineno">1658</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-208" class="py-name"><a title="configobj.ConfigObj._handle_error" class="py-name" href="#" onclick="return doclink('link-208', '_handle_error', 'link-180');">_handle_error</a></tt><tt class="py-op">(</tt> </tt>
<a name="L1659"></a><tt class="py-lineno">1659</tt> <tt class="py-line"> <tt class="py-string">'Parse error in value at line %s.'</tt><tt class="py-op">,</tt> </tt>
<a name="L1660"></a><tt class="py-lineno">1660</tt> <tt class="py-line"> <tt id="link-209" class="py-name"><a title="configobj.ParseError" class="py-name" href="#" onclick="return doclink('link-209', 'ParseError', 'link-193');">ParseError</a></tt><tt class="py-op">,</tt> <tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-name">cur_index</tt><tt class="py-op">)</tt> </tt>
<a name="L1661"></a><tt class="py-lineno">1661</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L1662"></a><tt class="py-lineno">1662</tt> <tt class="py-line"> <tt class="py-comment">#</tt> </tt>
<a name="L1663"></a><tt class="py-lineno">1663</tt> <tt class="py-line"> <tt class="py-name">key</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-210" class="py-name"><a title="configobj.ConfigObj._unquote" class="py-name" href="#" onclick="return doclink('link-210', '_unquote', 'link-187');">_unquote</a></tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<a name="L1664"></a><tt class="py-lineno">1664</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">key</tt> <tt class="py-keyword">in</tt> <tt class="py-name">this_section</tt><tt class="py-op">:</tt> </tt>
<a name="L1665"></a><tt class="py-lineno">1665</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-211" class="py-name"><a title="configobj.ConfigObj._handle_error" class="py-name" href="#" onclick="return doclink('link-211', '_handle_error', 'link-180');">_handle_error</a></tt><tt class="py-op">(</tt> </tt>
<a name="L1666"></a><tt class="py-lineno">1666</tt> <tt class="py-line"> <tt class="py-string">'Duplicate keyword name at line %s.'</tt><tt class="py-op">,</tt> </tt>
<a name="L1667"></a><tt class="py-lineno">1667</tt> <tt class="py-line"> <tt id="link-212" class="py-name"><a title="configobj.DuplicateError" class="py-name" href="#" onclick="return doclink('link-212', 'DuplicateError', 'link-189');">DuplicateError</a></tt><tt class="py-op">,</tt> <tt class="py-name">infile</tt><tt class="py-op">,</tt> <tt class="py-name">cur_index</tt><tt class="py-op">)</tt> </tt>
<a name="L1668"></a><tt class="py-lineno">1668</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L1669"></a><tt class="py-lineno">1669</tt> <tt class="py-line"> <tt class="py-comment"># add the key.</tt> </tt>
<a name="L1670"></a><tt class="py-lineno">1670</tt> <tt class="py-line"> <tt class="py-comment"># we set unrepr because if we have got this far we will never</tt> </tt>
<a name="L1671"></a><tt class="py-lineno">1671</tt> <tt class="py-line"> <tt class="py-comment"># be creating a new section</tt> </tt>
<a name="L1672"></a><tt class="py-lineno">1672</tt> <tt class="py-line"> <tt class="py-name">this_section</tt><tt class="py-op">.</tt><tt id="link-213" class="py-name"><a title="configobj.Section.__setitem__" class="py-name" href="#" onclick="return doclink('link-213', '__setitem__', 'link-87');">__setitem__</a></tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">value</tt><tt class="py-op">,</tt> <tt id="link-214" class="py-name"><a title="configobj.unrepr" class="py-name" href="#" onclick="return doclink('link-214', 'unrepr', 'link-89');">unrepr</a></tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">)</tt> </tt>
<a name="L1673"></a><tt class="py-lineno">1673</tt> <tt class="py-line"> <tt class="py-name">this_section</tt><tt class="py-op">.</tt><tt class="py-name">inline_comments</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">comment</tt> </tt>
<a name="L1674"></a><tt class="py-lineno">1674</tt> <tt class="py-line"> <tt class="py-name">this_section</tt><tt class="py-op">.</tt><tt class="py-name">comments</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">comment_list</tt> </tt>
<a name="L1675"></a><tt class="py-lineno">1675</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L1676"></a><tt class="py-lineno">1676</tt> <tt class="py-line"> <tt class="py-comment">#</tt> </tt>
<a name="L1677"></a><tt class="py-lineno">1677</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">indent_type</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L1678"></a><tt class="py-lineno">1678</tt> <tt class="py-line"> <tt class="py-comment"># no indentation used, set the type accordingly</tt> </tt>
<a name="L1679"></a><tt class="py-lineno">1679</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">indent_type</tt> <tt class="py-op">=</tt> <tt class="py-string">''</tt> </tt>
<a name="L1680"></a><tt class="py-lineno">1680</tt> <tt class="py-line"> </tt>
<a name="L1681"></a><tt class="py-lineno">1681</tt> <tt class="py-line"> <tt class="py-comment"># preserve the final comment</tt> </tt>
<a name="L1682"></a><tt class="py-lineno">1682</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt> <tt class="py-keyword">and</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">initial_comment</tt><tt class="py-op">:</tt> </tt>
<a name="L1683"></a><tt class="py-lineno">1683</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">initial_comment</tt> <tt class="py-op">=</tt> <tt class="py-name">comment_list</tt> </tt>
<a name="L1684"></a><tt class="py-lineno">1684</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-keyword">not</tt> <tt class="py-name">reset_comment</tt><tt class="py-op">:</tt> </tt>
<a name="L1685"></a><tt class="py-lineno">1685</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">final_comment</tt> <tt class="py-op">=</tt> <tt class="py-name">comment_list</tt> </tt>
<a name="L1686"></a><tt class="py-lineno">1686</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">list_values</tt> <tt class="py-op">=</tt> <tt class="py-name">temp_list_values</tt> </tt>
</div><a name="L1687"></a><tt class="py-lineno">1687</tt> <tt class="py-line"> </tt>
<a name="L1688"></a><tt class="py-lineno">1688</tt> <tt class="py-line"> </tt>
<a name="ConfigObj._match_depth"></a><div id="ConfigObj._match_depth-def"><a name="L1689"></a><tt class="py-lineno">1689</tt> <a class="py-toggle" href="#" id="ConfigObj._match_depth-toggle" onclick="return toggle('ConfigObj._match_depth');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#_match_depth">_match_depth</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">sect</tt><tt class="py-op">,</tt> <tt class="py-param">depth</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj._match_depth-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj._match_depth-expanded"><a name="L1690"></a><tt class="py-lineno">1690</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L1691"></a><tt class="py-lineno">1691</tt> <tt class="py-line"><tt class="py-docstring"> Given a section and a depth level, walk back through the sections</tt> </tt>
<a name="L1692"></a><tt class="py-lineno">1692</tt> <tt class="py-line"><tt class="py-docstring"> parents to see if the depth level matches a previous section.</tt> </tt>
<a name="L1693"></a><tt class="py-lineno">1693</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L1694"></a><tt class="py-lineno">1694</tt> <tt class="py-line"><tt class="py-docstring"> Return a reference to the right section,</tt> </tt>
<a name="L1695"></a><tt class="py-lineno">1695</tt> <tt class="py-line"><tt class="py-docstring"> or raise a SyntaxError.</tt> </tt>
<a name="L1696"></a><tt class="py-lineno">1696</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L1697"></a><tt class="py-lineno">1697</tt> <tt class="py-line"> <tt class="py-keyword">while</tt> <tt class="py-name">depth</tt> <tt class="py-op"><</tt> <tt class="py-name">sect</tt><tt class="py-op">.</tt><tt class="py-name">depth</tt><tt class="py-op">:</tt> </tt>
<a name="L1698"></a><tt class="py-lineno">1698</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">sect</tt> <tt class="py-keyword">is</tt> <tt class="py-name">sect</tt><tt class="py-op">.</tt><tt class="py-name">parent</tt><tt class="py-op">:</tt> </tt>
<a name="L1699"></a><tt class="py-lineno">1699</tt> <tt class="py-line"> <tt class="py-comment"># we've reached the top level already</tt> </tt>
<a name="L1700"></a><tt class="py-lineno">1700</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">SyntaxError</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L1701"></a><tt class="py-lineno">1701</tt> <tt class="py-line"> <tt class="py-name">sect</tt> <tt class="py-op">=</tt> <tt class="py-name">sect</tt><tt class="py-op">.</tt><tt class="py-name">parent</tt> </tt>
<a name="L1702"></a><tt class="py-lineno">1702</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">sect</tt><tt class="py-op">.</tt><tt class="py-name">depth</tt> <tt class="py-op">==</tt> <tt class="py-name">depth</tt><tt class="py-op">:</tt> </tt>
<a name="L1703"></a><tt class="py-lineno">1703</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">sect</tt> </tt>
<a name="L1704"></a><tt class="py-lineno">1704</tt> <tt class="py-line"> <tt class="py-comment"># shouldn't get here</tt> </tt>
<a name="L1705"></a><tt class="py-lineno">1705</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">SyntaxError</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
</div><a name="L1706"></a><tt class="py-lineno">1706</tt> <tt class="py-line"> </tt>
<a name="L1707"></a><tt class="py-lineno">1707</tt> <tt class="py-line"> </tt>
<a name="ConfigObj._handle_error"></a><div id="ConfigObj._handle_error-def"><a name="L1708"></a><tt class="py-lineno">1708</tt> <a class="py-toggle" href="#" id="ConfigObj._handle_error-toggle" onclick="return toggle('ConfigObj._handle_error');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#_handle_error">_handle_error</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">text</tt><tt class="py-op">,</tt> <tt class="py-param">ErrorClass</tt><tt class="py-op">,</tt> <tt class="py-param">infile</tt><tt class="py-op">,</tt> <tt class="py-param">cur_index</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj._handle_error-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj._handle_error-expanded"><a name="L1709"></a><tt class="py-lineno">1709</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L1710"></a><tt class="py-lineno">1710</tt> <tt class="py-line"><tt class="py-docstring"> Handle an error according to the error settings.</tt> </tt>
<a name="L1711"></a><tt class="py-lineno">1711</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L1712"></a><tt class="py-lineno">1712</tt> <tt class="py-line"><tt class="py-docstring"> Either raise the error or store it.</tt> </tt>
<a name="L1713"></a><tt class="py-lineno">1713</tt> <tt class="py-line"><tt class="py-docstring"> The error will have occured at ``cur_index``</tt> </tt>
<a name="L1714"></a><tt class="py-lineno">1714</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L1715"></a><tt class="py-lineno">1715</tt> <tt class="py-line"> <tt class="py-name">line</tt> <tt class="py-op">=</tt> <tt class="py-name">infile</tt><tt class="py-op">[</tt><tt class="py-name">cur_index</tt><tt class="py-op">]</tt> </tt>
<a name="L1716"></a><tt class="py-lineno">1716</tt> <tt class="py-line"> <tt class="py-name">cur_index</tt> <tt class="py-op">+=</tt> <tt class="py-number">1</tt> </tt>
<a name="L1717"></a><tt class="py-lineno">1717</tt> <tt class="py-line"> <tt class="py-name">message</tt> <tt class="py-op">=</tt> <tt class="py-name">text</tt> <tt class="py-op">%</tt> <tt class="py-name">cur_index</tt> </tt>
<a name="L1718"></a><tt class="py-lineno">1718</tt> <tt class="py-line"> <tt class="py-name">error</tt> <tt class="py-op">=</tt> <tt class="py-name">ErrorClass</tt><tt class="py-op">(</tt><tt class="py-name">message</tt><tt class="py-op">,</tt> <tt class="py-name">cur_index</tt><tt class="py-op">,</tt> <tt class="py-name">line</tt><tt class="py-op">)</tt> </tt>
<a name="L1719"></a><tt class="py-lineno">1719</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">raise_errors</tt><tt class="py-op">:</tt> </tt>
<a name="L1720"></a><tt class="py-lineno">1720</tt> <tt class="py-line"> <tt class="py-comment"># raise the error - parsing stops here</tt> </tt>
<a name="L1721"></a><tt class="py-lineno">1721</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">error</tt> </tt>
<a name="L1722"></a><tt class="py-lineno">1722</tt> <tt class="py-line"> <tt class="py-comment"># store the error</tt> </tt>
<a name="L1723"></a><tt class="py-lineno">1723</tt> <tt class="py-line"> <tt class="py-comment"># reraise when parsing has finished</tt> </tt>
<a name="L1724"></a><tt class="py-lineno">1724</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_errors</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">error</tt><tt class="py-op">)</tt> </tt>
</div><a name="L1725"></a><tt class="py-lineno">1725</tt> <tt class="py-line"> </tt>
<a name="L1726"></a><tt class="py-lineno">1726</tt> <tt class="py-line"> </tt>
<a name="ConfigObj._unquote"></a><div id="ConfigObj._unquote-def"><a name="L1727"></a><tt class="py-lineno">1727</tt> <a class="py-toggle" href="#" id="ConfigObj._unquote-toggle" onclick="return toggle('ConfigObj._unquote');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#_unquote">_unquote</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj._unquote-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj._unquote-expanded"><a name="L1728"></a><tt class="py-lineno">1728</tt> <tt class="py-line"> <tt class="py-docstring">"""Return an unquoted version of a value"""</tt> </tt>
<a name="L1729"></a><tt class="py-lineno">1729</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">value</tt><tt class="py-op">:</tt> </tt>
<a name="L1730"></a><tt class="py-lineno">1730</tt> <tt class="py-line"> <tt class="py-comment"># should only happen during parsing of lists</tt> </tt>
<a name="L1731"></a><tt class="py-lineno">1731</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">SyntaxError</tt> </tt>
<a name="L1732"></a><tt class="py-lineno">1732</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-name">value</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-string">'"'</tt><tt class="py-op">,</tt> <tt class="py-string">"'"</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1733"></a><tt class="py-lineno">1733</tt> <tt class="py-line"> <tt class="py-name">value</tt> <tt class="py-op">=</tt> <tt class="py-name">value</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">:</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt>
<a name="L1734"></a><tt class="py-lineno">1734</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">value</tt> </tt>
</div><a name="L1735"></a><tt class="py-lineno">1735</tt> <tt class="py-line"> </tt>
<a name="L1736"></a><tt class="py-lineno">1736</tt> <tt class="py-line"> </tt>
<a name="ConfigObj._quote"></a><div id="ConfigObj._quote-def"><a name="L1737"></a><tt class="py-lineno">1737</tt> <a class="py-toggle" href="#" id="ConfigObj._quote-toggle" onclick="return toggle('ConfigObj._quote');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#_quote">_quote</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">,</tt> <tt class="py-param">multiline</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj._quote-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj._quote-expanded"><a name="L1738"></a><tt class="py-lineno">1738</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L1739"></a><tt class="py-lineno">1739</tt> <tt class="py-line"><tt class="py-docstring"> Return a safely quoted version of a value.</tt> </tt>
<a name="L1740"></a><tt class="py-lineno">1740</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L1741"></a><tt class="py-lineno">1741</tt> <tt class="py-line"><tt class="py-docstring"> Raise a ConfigObjError if the value cannot be safely quoted.</tt> </tt>
<a name="L1742"></a><tt class="py-lineno">1742</tt> <tt class="py-line"><tt class="py-docstring"> If multiline is ``True`` (default) then use triple quotes</tt> </tt>
<a name="L1743"></a><tt class="py-lineno">1743</tt> <tt class="py-line"><tt class="py-docstring"> if necessary.</tt> </tt>
<a name="L1744"></a><tt class="py-lineno">1744</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L1745"></a><tt class="py-lineno">1745</tt> <tt class="py-line"><tt class="py-docstring"> * Don't quote values that don't need it.</tt> </tt>
<a name="L1746"></a><tt class="py-lineno">1746</tt> <tt class="py-line"><tt class="py-docstring"> * Recursively quote members of a list and return a comma joined list.</tt> </tt>
<a name="L1747"></a><tt class="py-lineno">1747</tt> <tt class="py-line"><tt class="py-docstring"> * Multiline is ``False`` for lists.</tt> </tt>
<a name="L1748"></a><tt class="py-lineno">1748</tt> <tt class="py-line"><tt class="py-docstring"> * Obey list syntax for empty and single member lists.</tt> </tt>
<a name="L1749"></a><tt class="py-lineno">1749</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L1750"></a><tt class="py-lineno">1750</tt> <tt class="py-line"><tt class="py-docstring"> If ``list_values=False`` then the value is only quoted if it contains</tt> </tt>
<a name="L1751"></a><tt class="py-lineno">1751</tt> <tt class="py-line"><tt class="py-docstring"> a ``\\n`` (is multiline) or '#'.</tt> </tt>
<a name="L1752"></a><tt class="py-lineno">1752</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L1753"></a><tt class="py-lineno">1753</tt> <tt class="py-line"><tt class="py-docstring"> If ``write_empty_values`` is set, and the value is an empty string, it</tt> </tt>
<a name="L1754"></a><tt class="py-lineno">1754</tt> <tt class="py-line"><tt class="py-docstring"> won't be quoted.</tt> </tt>
<a name="L1755"></a><tt class="py-lineno">1755</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L1756"></a><tt class="py-lineno">1756</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">multiline</tt> <tt class="py-keyword">and</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">write_empty_values</tt> <tt class="py-keyword">and</tt> <tt class="py-name">value</tt> <tt class="py-op">==</tt> <tt class="py-string">''</tt><tt class="py-op">:</tt> </tt>
<a name="L1757"></a><tt class="py-lineno">1757</tt> <tt class="py-line"> <tt class="py-comment"># Only if multiline is set, so that it is used for values not</tt> </tt>
<a name="L1758"></a><tt class="py-lineno">1758</tt> <tt class="py-line"> <tt class="py-comment"># keys, and not values that are part of a list</tt> </tt>
<a name="L1759"></a><tt class="py-lineno">1759</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">''</tt> </tt>
<a name="L1760"></a><tt class="py-lineno">1760</tt> <tt class="py-line"> </tt>
<a name="L1761"></a><tt class="py-lineno">1761</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">multiline</tt> <tt class="py-keyword">and</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">list</tt><tt class="py-op">,</tt> <tt class="py-name">tuple</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1762"></a><tt class="py-lineno">1762</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">value</tt><tt class="py-op">:</tt> </tt>
<a name="L1763"></a><tt class="py-lineno">1763</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">','</tt> </tt>
<a name="L1764"></a><tt class="py-lineno">1764</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-number">1</tt><tt class="py-op">:</tt> </tt>
<a name="L1765"></a><tt class="py-lineno">1765</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-215" class="py-name" targets="Method configobj.ConfigObj._quote()=configobj.ConfigObj-class.html#_quote"><a title="configobj.ConfigObj._quote" class="py-name" href="#" onclick="return doclink('link-215', '_quote', 'link-215');">_quote</a></tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">multiline</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt> <tt class="py-op">+</tt> <tt class="py-string">','</tt> </tt>
<a name="L1766"></a><tt class="py-lineno">1766</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">', '</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-216" class="py-name"><a title="configobj.ConfigObj._quote" class="py-name" href="#" onclick="return doclink('link-216', '_quote', 'link-215');">_quote</a></tt><tt class="py-op">(</tt><tt class="py-name">val</tt><tt class="py-op">,</tt> <tt class="py-name">multiline</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt> </tt>
<a name="L1767"></a><tt class="py-lineno">1767</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">val</tt> <tt class="py-keyword">in</tt> <tt class="py-name">value</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
<a name="L1768"></a><tt class="py-lineno">1768</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-name">basestring</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1769"></a><tt class="py-lineno">1769</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">stringify</tt><tt class="py-op">:</tt> </tt>
<a name="L1770"></a><tt class="py-lineno">1770</tt> <tt class="py-line"> <tt class="py-name">value</tt> <tt class="py-op">=</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
<a name="L1771"></a><tt class="py-lineno">1771</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1772"></a><tt class="py-lineno">1772</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Value "%s" is not a string.'</tt> <tt class="py-op">%</tt> <tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
<a name="L1773"></a><tt class="py-lineno">1773</tt> <tt class="py-line"> </tt>
<a name="L1774"></a><tt class="py-lineno">1774</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">value</tt><tt class="py-op">:</tt> </tt>
<a name="L1775"></a><tt class="py-lineno">1775</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'""'</tt> </tt>
<a name="L1776"></a><tt class="py-lineno">1776</tt> <tt class="py-line"> </tt>
<a name="L1777"></a><tt class="py-lineno">1777</tt> <tt class="py-line"> <tt class="py-name">no_lists_no_quotes</tt> <tt class="py-op">=</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">list_values</tt> <tt class="py-keyword">and</tt> <tt class="py-string">'\n'</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">value</tt> <tt class="py-keyword">and</tt> <tt class="py-string">'#'</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">value</tt> </tt>
<a name="L1778"></a><tt class="py-lineno">1778</tt> <tt class="py-line"> <tt class="py-name">need_triple</tt> <tt class="py-op">=</tt> <tt class="py-name">multiline</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-string">"'"</tt> <tt class="py-keyword">in</tt> <tt class="py-name">value</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-string">'"'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">value</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> <tt class="py-op">(</tt><tt class="py-string">'\n'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">value</tt> <tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
<a name="L1779"></a><tt class="py-lineno">1779</tt> <tt class="py-line"> <tt class="py-name">hash_triple_quote</tt> <tt class="py-op">=</tt> <tt class="py-name">multiline</tt> <tt class="py-keyword">and</tt> <tt class="py-keyword">not</tt> <tt class="py-name">need_triple</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-string">"'"</tt> <tt class="py-keyword">in</tt> <tt class="py-name">value</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-string">'"'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">value</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-string">'#'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
<a name="L1780"></a><tt class="py-lineno">1780</tt> <tt class="py-line"> <tt class="py-name">check_for_single</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-name">no_lists_no_quotes</tt> <tt class="py-keyword">or</tt> <tt class="py-keyword">not</tt> <tt class="py-name">need_triple</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-keyword">not</tt> <tt class="py-name">hash_triple_quote</tt> </tt>
<a name="L1781"></a><tt class="py-lineno">1781</tt> <tt class="py-line"> </tt>
<a name="L1782"></a><tt class="py-lineno">1782</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">check_for_single</tt><tt class="py-op">:</tt> </tt>
<a name="L1783"></a><tt class="py-lineno">1783</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">list_values</tt><tt class="py-op">:</tt> </tt>
<a name="L1784"></a><tt class="py-lineno">1784</tt> <tt class="py-line"> <tt class="py-comment"># we don't quote if ``list_values=False``</tt> </tt>
<a name="L1785"></a><tt class="py-lineno">1785</tt> <tt class="py-line"> <tt class="py-name">quot</tt> <tt class="py-op">=</tt> <tt id="link-217" class="py-name"><a title="configobj.noquot" class="py-name" href="#" onclick="return doclink('link-217', 'noquot', 'link-8');">noquot</a></tt> </tt>
<a name="L1786"></a><tt class="py-lineno">1786</tt> <tt class="py-line"> <tt class="py-comment"># for normal values either single or double quotes will do</tt> </tt>
<a name="L1787"></a><tt class="py-lineno">1787</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-string">'\n'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">value</tt><tt class="py-op">:</tt> </tt>
<a name="L1788"></a><tt class="py-lineno">1788</tt> <tt class="py-line"> <tt class="py-comment"># will only happen if multiline is off - e.g. '\n' in key</tt> </tt>
<a name="L1789"></a><tt class="py-lineno">1789</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-218" class="py-name"><a title="configobj.ConfigObjError" class="py-name" href="#" onclick="return doclink('link-218', 'ConfigObjError', 'link-156');">ConfigObjError</a></tt><tt class="py-op">(</tt><tt class="py-string">'Value "%s" cannot be safely quoted.'</tt> <tt class="py-op">%</tt> <tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
<a name="L1790"></a><tt class="py-lineno">1790</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt id="link-219" class="py-name"><a title="configobj.wspace_plus" class="py-name" href="#" onclick="return doclink('link-219', 'wspace_plus', 'link-9');">wspace_plus</a></tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> </tt>
<a name="L1791"></a><tt class="py-lineno">1791</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt id="link-220" class="py-name"><a title="configobj.wspace_plus" class="py-name" href="#" onclick="return doclink('link-220', 'wspace_plus', 'link-9');">wspace_plus</a></tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> </tt>
<a name="L1792"></a><tt class="py-lineno">1792</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-string">','</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">value</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1793"></a><tt class="py-lineno">1793</tt> <tt class="py-line"> <tt class="py-name">quot</tt> <tt class="py-op">=</tt> <tt id="link-221" class="py-name"><a title="configobj.noquot" class="py-name" href="#" onclick="return doclink('link-221', 'noquot', 'link-8');">noquot</a></tt> </tt>
<a name="L1794"></a><tt class="py-lineno">1794</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1795"></a><tt class="py-lineno">1795</tt> <tt class="py-line"> <tt class="py-name">quot</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-222" class="py-name" targets="Method configobj.ConfigObj._get_single_quote()=configobj.ConfigObj-class.html#_get_single_quote"><a title="configobj.ConfigObj._get_single_quote" class="py-name" href="#" onclick="return doclink('link-222', '_get_single_quote', 'link-222');">_get_single_quote</a></tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
<a name="L1796"></a><tt class="py-lineno">1796</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1797"></a><tt class="py-lineno">1797</tt> <tt class="py-line"> <tt class="py-comment"># if value has '\n' or "'" *and* '"', it will need triple quotes</tt> </tt>
<a name="L1798"></a><tt class="py-lineno">1798</tt> <tt class="py-line"> <tt class="py-name">quot</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-223" class="py-name" targets="Method configobj.ConfigObj._get_triple_quote()=configobj.ConfigObj-class.html#_get_triple_quote"><a title="configobj.ConfigObj._get_triple_quote" class="py-name" href="#" onclick="return doclink('link-223', '_get_triple_quote', 'link-223');">_get_triple_quote</a></tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
<a name="L1799"></a><tt class="py-lineno">1799</tt> <tt class="py-line"> </tt>
<a name="L1800"></a><tt class="py-lineno">1800</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">quot</tt> <tt class="py-op">==</tt> <tt id="link-224" class="py-name"><a title="configobj.noquot" class="py-name" href="#" onclick="return doclink('link-224', 'noquot', 'link-8');">noquot</a></tt> <tt class="py-keyword">and</tt> <tt class="py-string">'#'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">value</tt> <tt class="py-keyword">and</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">list_values</tt><tt class="py-op">:</tt> </tt>
<a name="L1801"></a><tt class="py-lineno">1801</tt> <tt class="py-line"> <tt class="py-name">quot</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-225" class="py-name"><a title="configobj.ConfigObj._get_single_quote" class="py-name" href="#" onclick="return doclink('link-225', '_get_single_quote', 'link-222');">_get_single_quote</a></tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
<a name="L1802"></a><tt class="py-lineno">1802</tt> <tt class="py-line"> </tt>
<a name="L1803"></a><tt class="py-lineno">1803</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">quot</tt> <tt class="py-op">%</tt> <tt class="py-name">value</tt> </tt>
</div><a name="L1804"></a><tt class="py-lineno">1804</tt> <tt class="py-line"> </tt>
<a name="L1805"></a><tt class="py-lineno">1805</tt> <tt class="py-line"> </tt>
<a name="ConfigObj._get_single_quote"></a><div id="ConfigObj._get_single_quote-def"><a name="L1806"></a><tt class="py-lineno">1806</tt> <a class="py-toggle" href="#" id="ConfigObj._get_single_quote-toggle" onclick="return toggle('ConfigObj._get_single_quote');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#_get_single_quote">_get_single_quote</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj._get_single_quote-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj._get_single_quote-expanded"><a name="L1807"></a><tt class="py-lineno">1807</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-string">"'"</tt> <tt class="py-keyword">in</tt> <tt class="py-name">value</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-string">'"'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1808"></a><tt class="py-lineno">1808</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-226" class="py-name"><a title="configobj.ConfigObjError" class="py-name" href="#" onclick="return doclink('link-226', 'ConfigObjError', 'link-156');">ConfigObjError</a></tt><tt class="py-op">(</tt><tt class="py-string">'Value "%s" cannot be safely quoted.'</tt> <tt class="py-op">%</tt> <tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
<a name="L1809"></a><tt class="py-lineno">1809</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-string">'"'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">value</tt><tt class="py-op">:</tt> </tt>
<a name="L1810"></a><tt class="py-lineno">1810</tt> <tt class="py-line"> <tt class="py-name">quot</tt> <tt class="py-op">=</tt> <tt id="link-227" class="py-name"><a title="configobj.squot" class="py-name" href="#" onclick="return doclink('link-227', 'squot', 'link-6');">squot</a></tt> </tt>
<a name="L1811"></a><tt class="py-lineno">1811</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1812"></a><tt class="py-lineno">1812</tt> <tt class="py-line"> <tt class="py-name">quot</tt> <tt class="py-op">=</tt> <tt id="link-228" class="py-name"><a title="configobj.dquot" class="py-name" href="#" onclick="return doclink('link-228', 'dquot', 'link-7');">dquot</a></tt> </tt>
<a name="L1813"></a><tt class="py-lineno">1813</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">quot</tt> </tt>
</div><a name="L1814"></a><tt class="py-lineno">1814</tt> <tt class="py-line"> </tt>
<a name="L1815"></a><tt class="py-lineno">1815</tt> <tt class="py-line"> </tt>
<a name="ConfigObj._get_triple_quote"></a><div id="ConfigObj._get_triple_quote-def"><a name="L1816"></a><tt class="py-lineno">1816</tt> <a class="py-toggle" href="#" id="ConfigObj._get_triple_quote-toggle" onclick="return toggle('ConfigObj._get_triple_quote');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#_get_triple_quote">_get_triple_quote</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj._get_triple_quote-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj._get_triple_quote-expanded"><a name="L1817"></a><tt class="py-lineno">1817</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">.</tt><tt class="py-name">find</tt><tt class="py-op">(</tt><tt class="py-string">'"""'</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">.</tt><tt class="py-name">find</tt><tt class="py-op">(</tt><tt class="py-string">"'''"</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1818"></a><tt class="py-lineno">1818</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-229" class="py-name"><a title="configobj.ConfigObjError" class="py-name" href="#" onclick="return doclink('link-229', 'ConfigObjError', 'link-156');">ConfigObjError</a></tt><tt class="py-op">(</tt><tt class="py-string">'Value "%s" cannot be safely quoted.'</tt> <tt class="py-op">%</tt> <tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
<a name="L1819"></a><tt class="py-lineno">1819</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">value</tt><tt class="py-op">.</tt><tt class="py-name">find</tt><tt class="py-op">(</tt><tt class="py-string">'"""'</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">:</tt> </tt>
<a name="L1820"></a><tt class="py-lineno">1820</tt> <tt class="py-line"> <tt class="py-name">quot</tt> <tt class="py-op">=</tt> <tt id="link-230" class="py-name"><a title="configobj.tsquot" class="py-name" href="#" onclick="return doclink('link-230', 'tsquot', 'link-10');">tsquot</a></tt> </tt>
<a name="L1821"></a><tt class="py-lineno">1821</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1822"></a><tt class="py-lineno">1822</tt> <tt class="py-line"> <tt class="py-name">quot</tt> <tt class="py-op">=</tt> <tt id="link-231" class="py-name"><a title="configobj.tdquot" class="py-name" href="#" onclick="return doclink('link-231', 'tdquot', 'link-11');">tdquot</a></tt> </tt>
<a name="L1823"></a><tt class="py-lineno">1823</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">quot</tt> </tt>
</div><a name="L1824"></a><tt class="py-lineno">1824</tt> <tt class="py-line"> </tt>
<a name="L1825"></a><tt class="py-lineno">1825</tt> <tt class="py-line"> </tt>
<a name="ConfigObj._handle_value"></a><div id="ConfigObj._handle_value-def"><a name="L1826"></a><tt class="py-lineno">1826</tt> <a class="py-toggle" href="#" id="ConfigObj._handle_value-toggle" onclick="return toggle('ConfigObj._handle_value');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#_handle_value">_handle_value</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj._handle_value-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj._handle_value-expanded"><a name="L1827"></a><tt class="py-lineno">1827</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L1828"></a><tt class="py-lineno">1828</tt> <tt class="py-line"><tt class="py-docstring"> Given a value string, unquote, remove comment,</tt> </tt>
<a name="L1829"></a><tt class="py-lineno">1829</tt> <tt class="py-line"><tt class="py-docstring"> handle lists. (including empty and single member lists)</tt> </tt>
<a name="L1830"></a><tt class="py-lineno">1830</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L1831"></a><tt class="py-lineno">1831</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_inspec</tt><tt class="py-op">:</tt> </tt>
<a name="L1832"></a><tt class="py-lineno">1832</tt> <tt class="py-line"> <tt class="py-comment"># Parsing a configspec so don't handle comments</tt> </tt>
<a name="L1833"></a><tt class="py-lineno">1833</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt> </tt>
<a name="L1834"></a><tt class="py-lineno">1834</tt> <tt class="py-line"> <tt class="py-comment"># do we look for lists in values ?</tt> </tt>
<a name="L1835"></a><tt class="py-lineno">1835</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">list_values</tt><tt class="py-op">:</tt> </tt>
<a name="L1836"></a><tt class="py-lineno">1836</tt> <tt class="py-line"> <tt class="py-name">mat</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-232" class="py-name"><a title="configobj.ConfigObj._nolistvalue" class="py-name" href="#" onclick="return doclink('link-232', '_nolistvalue', 'link-129');">_nolistvalue</a></tt><tt class="py-op">.</tt><tt class="py-name">match</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
<a name="L1837"></a><tt class="py-lineno">1837</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">mat</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L1838"></a><tt class="py-lineno">1838</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">SyntaxError</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L1839"></a><tt class="py-lineno">1839</tt> <tt class="py-line"> <tt class="py-comment"># NOTE: we don't unquote here</tt> </tt>
<a name="L1840"></a><tt class="py-lineno">1840</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">mat</tt><tt class="py-op">.</tt><tt class="py-name">groups</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L1841"></a><tt class="py-lineno">1841</tt> <tt class="py-line"> <tt class="py-comment">#</tt> </tt>
<a name="L1842"></a><tt class="py-lineno">1842</tt> <tt class="py-line"> <tt class="py-name">mat</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-233" class="py-name"><a title="configobj.ConfigObj._valueexp" class="py-name" href="#" onclick="return doclink('link-233', '_valueexp', 'link-127');">_valueexp</a></tt><tt class="py-op">.</tt><tt class="py-name">match</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
<a name="L1843"></a><tt class="py-lineno">1843</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">mat</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L1844"></a><tt class="py-lineno">1844</tt> <tt class="py-line"> <tt class="py-comment"># the value is badly constructed, probably badly quoted,</tt> </tt>
<a name="L1845"></a><tt class="py-lineno">1845</tt> <tt class="py-line"> <tt class="py-comment"># or an invalid list</tt> </tt>
<a name="L1846"></a><tt class="py-lineno">1846</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">SyntaxError</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L1847"></a><tt class="py-lineno">1847</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">list_values</tt><tt class="py-op">,</tt> <tt class="py-name">single</tt><tt class="py-op">,</tt> <tt class="py-name">empty_list</tt><tt class="py-op">,</tt> <tt class="py-name">comment</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt class="py-name">mat</tt><tt class="py-op">.</tt><tt class="py-name">groups</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L1848"></a><tt class="py-lineno">1848</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">list_values</tt> <tt class="py-op">==</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-name">single</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1849"></a><tt class="py-lineno">1849</tt> <tt class="py-line"> <tt class="py-comment"># change this if you want to accept empty values</tt> </tt>
<a name="L1850"></a><tt class="py-lineno">1850</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">SyntaxError</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L1851"></a><tt class="py-lineno">1851</tt> <tt class="py-line"> <tt class="py-comment"># NOTE: note there is no error handling from here if the regex</tt> </tt>
<a name="L1852"></a><tt class="py-lineno">1852</tt> <tt class="py-line"> <tt class="py-comment"># is wrong: then incorrect values will slip through</tt> </tt>
<a name="L1853"></a><tt class="py-lineno">1853</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">empty_list</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L1854"></a><tt class="py-lineno">1854</tt> <tt class="py-line"> <tt class="py-comment"># the single comma - meaning an empty list</tt> </tt>
<a name="L1855"></a><tt class="py-lineno">1855</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">comment</tt><tt class="py-op">)</tt> </tt>
<a name="L1856"></a><tt class="py-lineno">1856</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">single</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L1857"></a><tt class="py-lineno">1857</tt> <tt class="py-line"> <tt class="py-comment"># handle empty values</tt> </tt>
<a name="L1858"></a><tt class="py-lineno">1858</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">list_values</tt> <tt class="py-keyword">and</tt> <tt class="py-keyword">not</tt> <tt class="py-name">single</tt><tt class="py-op">:</tt> </tt>
<a name="L1859"></a><tt class="py-lineno">1859</tt> <tt class="py-line"> <tt class="py-comment"># FIXME: the '' is a workaround because our regex now matches</tt> </tt>
<a name="L1860"></a><tt class="py-lineno">1860</tt> <tt class="py-line"> <tt class="py-comment"># '' at the end of a list if it has a trailing comma</tt> </tt>
<a name="L1861"></a><tt class="py-lineno">1861</tt> <tt class="py-line"> <tt class="py-name">single</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
<a name="L1862"></a><tt class="py-lineno">1862</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1863"></a><tt class="py-lineno">1863</tt> <tt class="py-line"> <tt class="py-name">single</tt> <tt class="py-op">=</tt> <tt class="py-name">single</tt> <tt class="py-keyword">or</tt> <tt class="py-string">'""'</tt> </tt>
<a name="L1864"></a><tt class="py-lineno">1864</tt> <tt class="py-line"> <tt class="py-name">single</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-234" class="py-name"><a title="configobj.ConfigObj._unquote" class="py-name" href="#" onclick="return doclink('link-234', '_unquote', 'link-187');">_unquote</a></tt><tt class="py-op">(</tt><tt class="py-name">single</tt><tt class="py-op">)</tt> </tt>
<a name="L1865"></a><tt class="py-lineno">1865</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">list_values</tt> <tt class="py-op">==</tt> <tt class="py-string">''</tt><tt class="py-op">:</tt> </tt>
<a name="L1866"></a><tt class="py-lineno">1866</tt> <tt class="py-line"> <tt class="py-comment"># not a list value</tt> </tt>
<a name="L1867"></a><tt class="py-lineno">1867</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">single</tt><tt class="py-op">,</tt> <tt class="py-name">comment</tt><tt class="py-op">)</tt> </tt>
<a name="L1868"></a><tt class="py-lineno">1868</tt> <tt class="py-line"> <tt class="py-name">the_list</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-235" class="py-name"><a title="configobj.ConfigObj._listvalueexp" class="py-name" href="#" onclick="return doclink('link-235', '_listvalueexp', 'link-128');">_listvalueexp</a></tt><tt class="py-op">.</tt><tt class="py-name">findall</tt><tt class="py-op">(</tt><tt class="py-name">list_values</tt><tt class="py-op">)</tt> </tt>
<a name="L1869"></a><tt class="py-lineno">1869</tt> <tt class="py-line"> <tt class="py-name">the_list</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-236" class="py-name"><a title="configobj.ConfigObj._unquote" class="py-name" href="#" onclick="return doclink('link-236', '_unquote', 'link-187');">_unquote</a></tt><tt class="py-op">(</tt><tt class="py-name">val</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">val</tt> <tt class="py-keyword">in</tt> <tt class="py-name">the_list</tt><tt class="py-op">]</tt> </tt>
<a name="L1870"></a><tt class="py-lineno">1870</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">single</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L1871"></a><tt class="py-lineno">1871</tt> <tt class="py-line"> <tt class="py-name">the_list</tt> <tt class="py-op">+=</tt> <tt class="py-op">[</tt><tt class="py-name">single</tt><tt class="py-op">]</tt> </tt>
<a name="L1872"></a><tt class="py-lineno">1872</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">the_list</tt><tt class="py-op">,</tt> <tt class="py-name">comment</tt><tt class="py-op">)</tt> </tt>
</div><a name="L1873"></a><tt class="py-lineno">1873</tt> <tt class="py-line"> </tt>
<a name="L1874"></a><tt class="py-lineno">1874</tt> <tt class="py-line"> </tt>
<a name="ConfigObj._multiline"></a><div id="ConfigObj._multiline-def"><a name="L1875"></a><tt class="py-lineno">1875</tt> <a class="py-toggle" href="#" id="ConfigObj._multiline-toggle" onclick="return toggle('ConfigObj._multiline');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#_multiline">_multiline</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">,</tt> <tt class="py-param">infile</tt><tt class="py-op">,</tt> <tt class="py-param">cur_index</tt><tt class="py-op">,</tt> <tt class="py-param">maxline</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj._multiline-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj._multiline-expanded"><a name="L1876"></a><tt class="py-lineno">1876</tt> <tt class="py-line"> <tt class="py-docstring">"""Extract the value, where we are in a multiline situation."""</tt> </tt>
<a name="L1877"></a><tt class="py-lineno">1877</tt> <tt class="py-line"> <tt class="py-name">quot</tt> <tt class="py-op">=</tt> <tt class="py-name">value</tt><tt class="py-op">[</tt><tt class="py-op">:</tt><tt class="py-number">3</tt><tt class="py-op">]</tt> </tt>
<a name="L1878"></a><tt class="py-lineno">1878</tt> <tt class="py-line"> <tt class="py-name">newvalue</tt> <tt class="py-op">=</tt> <tt class="py-name">value</tt><tt class="py-op">[</tt><tt class="py-number">3</tt><tt class="py-op">:</tt><tt class="py-op">]</tt> </tt>
<a name="L1879"></a><tt class="py-lineno">1879</tt> <tt class="py-line"> <tt class="py-name">single_line</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-237" class="py-name"><a title="configobj.ConfigObj._triple_quote" class="py-name" href="#" onclick="return doclink('link-237', '_triple_quote', 'link-134');">_triple_quote</a></tt><tt class="py-op">[</tt><tt class="py-name">quot</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> </tt>
<a name="L1880"></a><tt class="py-lineno">1880</tt> <tt class="py-line"> <tt class="py-name">multi_line</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-238" class="py-name"><a title="configobj.ConfigObj._triple_quote" class="py-name" href="#" onclick="return doclink('link-238', '_triple_quote', 'link-134');">_triple_quote</a></tt><tt class="py-op">[</tt><tt class="py-name">quot</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt>
<a name="L1881"></a><tt class="py-lineno">1881</tt> <tt class="py-line"> <tt class="py-name">mat</tt> <tt class="py-op">=</tt> <tt class="py-name">single_line</tt><tt class="py-op">.</tt><tt class="py-name">match</tt><tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">)</tt> </tt>
<a name="L1882"></a><tt class="py-lineno">1882</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">mat</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L1883"></a><tt class="py-lineno">1883</tt> <tt class="py-line"> <tt class="py-name">retval</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">mat</tt><tt class="py-op">.</tt><tt class="py-name">groups</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
<a name="L1884"></a><tt class="py-lineno">1884</tt> <tt class="py-line"> <tt class="py-name">retval</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">cur_index</tt><tt class="py-op">)</tt> </tt>
<a name="L1885"></a><tt class="py-lineno">1885</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">retval</tt> </tt>
<a name="L1886"></a><tt class="py-lineno">1886</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">newvalue</tt><tt class="py-op">.</tt><tt class="py-name">find</tt><tt class="py-op">(</tt><tt class="py-name">quot</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">:</tt> </tt>
<a name="L1887"></a><tt class="py-lineno">1887</tt> <tt class="py-line"> <tt class="py-comment"># somehow the triple quote is missing</tt> </tt>
<a name="L1888"></a><tt class="py-lineno">1888</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">SyntaxError</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L1889"></a><tt class="py-lineno">1889</tt> <tt class="py-line"> <tt class="py-comment">#</tt> </tt>
<a name="L1890"></a><tt class="py-lineno">1890</tt> <tt class="py-line"> <tt class="py-keyword">while</tt> <tt class="py-name">cur_index</tt> <tt class="py-op"><</tt> <tt class="py-name">maxline</tt><tt class="py-op">:</tt> </tt>
<a name="L1891"></a><tt class="py-lineno">1891</tt> <tt class="py-line"> <tt class="py-name">cur_index</tt> <tt class="py-op">+=</tt> <tt class="py-number">1</tt> </tt>
<a name="L1892"></a><tt class="py-lineno">1892</tt> <tt class="py-line"> <tt class="py-name">newvalue</tt> <tt class="py-op">+=</tt> <tt class="py-string">'\n'</tt> </tt>
<a name="L1893"></a><tt class="py-lineno">1893</tt> <tt class="py-line"> <tt class="py-name">line</tt> <tt class="py-op">=</tt> <tt class="py-name">infile</tt><tt class="py-op">[</tt><tt class="py-name">cur_index</tt><tt class="py-op">]</tt> </tt>
<a name="L1894"></a><tt class="py-lineno">1894</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">line</tt><tt class="py-op">.</tt><tt class="py-name">find</tt><tt class="py-op">(</tt><tt class="py-name">quot</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">:</tt> </tt>
<a name="L1895"></a><tt class="py-lineno">1895</tt> <tt class="py-line"> <tt class="py-name">newvalue</tt> <tt class="py-op">+=</tt> <tt class="py-name">line</tt> </tt>
<a name="L1896"></a><tt class="py-lineno">1896</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1897"></a><tt class="py-lineno">1897</tt> <tt class="py-line"> <tt class="py-comment"># end of multiline, process it</tt> </tt>
<a name="L1898"></a><tt class="py-lineno">1898</tt> <tt class="py-line"> <tt class="py-keyword">break</tt> </tt>
<a name="L1899"></a><tt class="py-lineno">1899</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1900"></a><tt class="py-lineno">1900</tt> <tt class="py-line"> <tt class="py-comment"># we've got to the end of the config, oops...</tt> </tt>
<a name="L1901"></a><tt class="py-lineno">1901</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">SyntaxError</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L1902"></a><tt class="py-lineno">1902</tt> <tt class="py-line"> <tt class="py-name">mat</tt> <tt class="py-op">=</tt> <tt class="py-name">multi_line</tt><tt class="py-op">.</tt><tt class="py-name">match</tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">)</tt> </tt>
<a name="L1903"></a><tt class="py-lineno">1903</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">mat</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L1904"></a><tt class="py-lineno">1904</tt> <tt class="py-line"> <tt class="py-comment"># a badly formed line</tt> </tt>
<a name="L1905"></a><tt class="py-lineno">1905</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">SyntaxError</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L1906"></a><tt class="py-lineno">1906</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-name">comment</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt class="py-name">mat</tt><tt class="py-op">.</tt><tt class="py-name">groups</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L1907"></a><tt class="py-lineno">1907</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">newvalue</tt> <tt class="py-op">+</tt> <tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-name">comment</tt><tt class="py-op">,</tt> <tt class="py-name">cur_index</tt><tt class="py-op">)</tt> </tt>
</div><a name="L1908"></a><tt class="py-lineno">1908</tt> <tt class="py-line"> </tt>
<a name="L1909"></a><tt class="py-lineno">1909</tt> <tt class="py-line"> </tt>
<a name="ConfigObj._handle_configspec"></a><div id="ConfigObj._handle_configspec-def"><a name="L1910"></a><tt class="py-lineno">1910</tt> <a class="py-toggle" href="#" id="ConfigObj._handle_configspec-toggle" onclick="return toggle('ConfigObj._handle_configspec');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#_handle_configspec">_handle_configspec</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">configspec</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj._handle_configspec-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj._handle_configspec-expanded"><a name="L1911"></a><tt class="py-lineno">1911</tt> <tt class="py-line"> <tt class="py-docstring">"""Parse the configspec."""</tt> </tt>
<a name="L1912"></a><tt class="py-lineno">1912</tt> <tt class="py-line"> <tt class="py-comment"># FIXME: Should we check that the configspec was created with the </tt> </tt>
<a name="L1913"></a><tt class="py-lineno">1913</tt> <tt class="py-line"> <tt class="py-comment"># correct settings ? (i.e. ``list_values=False``)</tt> </tt>
<a name="L1914"></a><tt class="py-lineno">1914</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">configspec</tt><tt class="py-op">,</tt> <tt id="link-239" class="py-name"><a title="configobj.ConfigObj" class="py-name" href="#" onclick="return doclink('link-239', 'ConfigObj', 'link-150');">ConfigObj</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1915"></a><tt class="py-lineno">1915</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
<a name="L1916"></a><tt class="py-lineno">1916</tt> <tt class="py-line"> <tt class="py-name">configspec</tt> <tt class="py-op">=</tt> <tt id="link-240" class="py-name"><a title="configobj.ConfigObj" class="py-name" href="#" onclick="return doclink('link-240', 'ConfigObj', 'link-150');">ConfigObj</a></tt><tt class="py-op">(</tt><tt class="py-name">configspec</tt><tt class="py-op">,</tt> </tt>
<a name="L1917"></a><tt class="py-lineno">1917</tt> <tt class="py-line"> <tt class="py-name">raise_errors</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">,</tt> </tt>
<a name="L1918"></a><tt class="py-lineno">1918</tt> <tt class="py-line"> <tt class="py-name">file_error</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">,</tt> </tt>
<a name="L1919"></a><tt class="py-lineno">1919</tt> <tt class="py-line"> <tt class="py-name">_inspec</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">)</tt> </tt>
<a name="L1920"></a><tt class="py-lineno">1920</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt id="link-241" class="py-name"><a title="configobj.ConfigObjError" class="py-name" href="#" onclick="return doclink('link-241', 'ConfigObjError', 'link-156');">ConfigObjError</a></tt><tt class="py-op">,</tt> <tt class="py-name">e</tt><tt class="py-op">:</tt> </tt>
<a name="L1921"></a><tt class="py-lineno">1921</tt> <tt class="py-line"> <tt class="py-comment"># FIXME: Should these errors have a reference</tt> </tt>
<a name="L1922"></a><tt class="py-lineno">1922</tt> <tt class="py-line"> <tt class="py-comment"># to the already parsed ConfigObj ?</tt> </tt>
<a name="L1923"></a><tt class="py-lineno">1923</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-242" class="py-name" targets="Class configobj.ConfigspecError=configobj.ConfigspecError-class.html"><a title="configobj.ConfigspecError" class="py-name" href="#" onclick="return doclink('link-242', 'ConfigspecError', 'link-242');">ConfigspecError</a></tt><tt class="py-op">(</tt><tt class="py-string">'Parsing configspec failed: %s'</tt> <tt class="py-op">%</tt> <tt class="py-name">e</tt><tt class="py-op">)</tt> </tt>
<a name="L1924"></a><tt class="py-lineno">1924</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">IOError</tt><tt class="py-op">,</tt> <tt class="py-name">e</tt><tt class="py-op">:</tt> </tt>
<a name="L1925"></a><tt class="py-lineno">1925</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">IOError</tt><tt class="py-op">(</tt><tt class="py-string">'Reading configspec failed: %s'</tt> <tt class="py-op">%</tt> <tt class="py-name">e</tt><tt class="py-op">)</tt> </tt>
<a name="L1926"></a><tt class="py-lineno">1926</tt> <tt class="py-line"> </tt>
<a name="L1927"></a><tt class="py-lineno">1927</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">configspec</tt> <tt class="py-op">=</tt> <tt class="py-name">configspec</tt> </tt>
</div><a name="L1928"></a><tt class="py-lineno">1928</tt> <tt class="py-line"> </tt>
<a name="L1929"></a><tt class="py-lineno">1929</tt> <tt class="py-line"> </tt>
<a name="L1930"></a><tt class="py-lineno">1930</tt> <tt class="py-line"> </tt>
<a name="ConfigObj._set_configspec"></a><div id="ConfigObj._set_configspec-def"><a name="L1931"></a><tt class="py-lineno">1931</tt> <a class="py-toggle" href="#" id="ConfigObj._set_configspec-toggle" onclick="return toggle('ConfigObj._set_configspec');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#_set_configspec">_set_configspec</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">section</tt><tt class="py-op">,</tt> <tt class="py-param">copy</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj._set_configspec-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj._set_configspec-expanded"><a name="L1932"></a><tt class="py-lineno">1932</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L1933"></a><tt class="py-lineno">1933</tt> <tt class="py-line"><tt class="py-docstring"> Called by validate. Handles setting the configspec on subsections</tt> </tt>
<a name="L1934"></a><tt class="py-lineno">1934</tt> <tt class="py-line"><tt class="py-docstring"> including sections to be validated by __many__</tt> </tt>
<a name="L1935"></a><tt class="py-lineno">1935</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L1936"></a><tt class="py-lineno">1936</tt> <tt class="py-line"> <tt class="py-name">configspec</tt> <tt class="py-op">=</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">configspec</tt> </tt>
<a name="L1937"></a><tt class="py-lineno">1937</tt> <tt class="py-line"> <tt class="py-name">many</tt> <tt class="py-op">=</tt> <tt class="py-name">configspec</tt><tt class="py-op">.</tt><tt id="link-243" class="py-name"><a title="configobj.Section.get" class="py-name" href="#" onclick="return doclink('link-243', 'get', 'link-5');">get</a></tt><tt class="py-op">(</tt><tt class="py-string">'__many__'</tt><tt class="py-op">)</tt> </tt>
<a name="L1938"></a><tt class="py-lineno">1938</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">many</tt><tt class="py-op">,</tt> <tt id="link-244" class="py-name"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-244', 'dict', 'link-68');">dict</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1939"></a><tt class="py-lineno">1939</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">in</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">:</tt> </tt>
<a name="L1940"></a><tt class="py-lineno">1940</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">configspec</tt><tt class="py-op">:</tt> </tt>
<a name="L1941"></a><tt class="py-lineno">1941</tt> <tt class="py-line"> <tt class="py-name">section</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">configspec</tt> <tt class="py-op">=</tt> <tt class="py-name">many</tt> </tt>
<a name="L1942"></a><tt class="py-lineno">1942</tt> <tt class="py-line"> </tt>
<a name="L1943"></a><tt class="py-lineno">1943</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">in</tt> <tt class="py-name">configspec</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">:</tt> </tt>
<a name="L1944"></a><tt class="py-lineno">1944</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">entry</tt> <tt class="py-op">==</tt> <tt class="py-string">'__many__'</tt><tt class="py-op">:</tt> </tt>
<a name="L1945"></a><tt class="py-lineno">1945</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L1946"></a><tt class="py-lineno">1946</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">section</tt><tt class="py-op">:</tt> </tt>
<a name="L1947"></a><tt class="py-lineno">1947</tt> <tt class="py-line"> <tt class="py-name">section</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
<a name="L1948"></a><tt class="py-lineno">1948</tt> <tt class="py-line"> <tt class="py-name">section</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">_created</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
<a name="L1949"></a><tt class="py-lineno">1949</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">copy</tt><tt class="py-op">:</tt> </tt>
<a name="L1950"></a><tt class="py-lineno">1950</tt> <tt class="py-line"> <tt class="py-comment"># copy comments</tt> </tt>
<a name="L1951"></a><tt class="py-lineno">1951</tt> <tt class="py-line"> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">comments</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">configspec</tt><tt class="py-op">.</tt><tt class="py-name">comments</tt><tt class="py-op">.</tt><tt id="link-245" class="py-name"><a title="configobj.Section.get" class="py-name" href="#" onclick="return doclink('link-245', 'get', 'link-5');">get</a></tt><tt class="py-op">(</tt><tt class="py-name">entry</tt><tt class="py-op">,</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
<a name="L1952"></a><tt class="py-lineno">1952</tt> <tt class="py-line"> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">inline_comments</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">configspec</tt><tt class="py-op">.</tt><tt class="py-name">inline_comments</tt><tt class="py-op">.</tt><tt id="link-246" class="py-name"><a title="configobj.Section.get" class="py-name" href="#" onclick="return doclink('link-246', 'get', 'link-5');">get</a></tt><tt class="py-op">(</tt><tt class="py-name">entry</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt> </tt>
<a name="L1953"></a><tt class="py-lineno">1953</tt> <tt class="py-line"> </tt>
<a name="L1954"></a><tt class="py-lineno">1954</tt> <tt class="py-line"> <tt class="py-comment"># Could be a scalar when we expect a section</tt> </tt>
<a name="L1955"></a><tt class="py-lineno">1955</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">section</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt id="link-247" class="py-name"><a title="configobj.Section" class="py-name" href="#" onclick="return doclink('link-247', 'Section', 'link-52');">Section</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1956"></a><tt class="py-lineno">1956</tt> <tt class="py-line"> <tt class="py-name">section</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">configspec</tt> <tt class="py-op">=</tt> <tt class="py-name">configspec</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> </tt>
</div><a name="L1957"></a><tt class="py-lineno">1957</tt> <tt class="py-line"> </tt>
<a name="L1958"></a><tt class="py-lineno">1958</tt> <tt class="py-line"> </tt>
<a name="ConfigObj._write_line"></a><div id="ConfigObj._write_line-def"><a name="L1959"></a><tt class="py-lineno">1959</tt> <a class="py-toggle" href="#" id="ConfigObj._write_line-toggle" onclick="return toggle('ConfigObj._write_line');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#_write_line">_write_line</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">indent_string</tt><tt class="py-op">,</tt> <tt class="py-param">entry</tt><tt class="py-op">,</tt> <tt class="py-param">this_entry</tt><tt class="py-op">,</tt> <tt class="py-param">comment</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj._write_line-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj._write_line-expanded"><a name="L1960"></a><tt class="py-lineno">1960</tt> <tt class="py-line"> <tt class="py-docstring">"""Write an individual line, for the write method"""</tt> </tt>
<a name="L1961"></a><tt class="py-lineno">1961</tt> <tt class="py-line"> <tt class="py-comment"># NOTE: the calls to self._quote here handles non-StringType values.</tt> </tt>
<a name="L1962"></a><tt class="py-lineno">1962</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-248" class="py-name"><a title="configobj.unrepr" class="py-name" href="#" onclick="return doclink('link-248', 'unrepr', 'link-89');">unrepr</a></tt><tt class="py-op">:</tt> </tt>
<a name="L1963"></a><tt class="py-lineno">1963</tt> <tt class="py-line"> <tt class="py-name">val</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-249" class="py-name" targets="Method configobj.ConfigObj._decode_element()=configobj.ConfigObj-class.html#_decode_element"><a title="configobj.ConfigObj._decode_element" class="py-name" href="#" onclick="return doclink('link-249', '_decode_element', 'link-249');">_decode_element</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-250" class="py-name"><a title="configobj.ConfigObj._quote" class="py-name" href="#" onclick="return doclink('link-250', '_quote', 'link-215');">_quote</a></tt><tt class="py-op">(</tt><tt class="py-name">this_entry</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
<a name="L1964"></a><tt class="py-lineno">1964</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L1965"></a><tt class="py-lineno">1965</tt> <tt class="py-line"> <tt class="py-name">val</tt> <tt class="py-op">=</tt> <tt class="py-name">repr</tt><tt class="py-op">(</tt><tt class="py-name">this_entry</tt><tt class="py-op">)</tt> </tt>
<a name="L1966"></a><tt class="py-lineno">1966</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'%s%s%s%s%s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">indent_string</tt><tt class="py-op">,</tt> </tt>
<a name="L1967"></a><tt class="py-lineno">1967</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-251" class="py-name"><a title="configobj.ConfigObj._decode_element" class="py-name" href="#" onclick="return doclink('link-251', '_decode_element', 'link-249');">_decode_element</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-252" class="py-name"><a title="configobj.ConfigObj._quote" class="py-name" href="#" onclick="return doclink('link-252', '_quote', 'link-215');">_quote</a></tt><tt class="py-op">(</tt><tt class="py-name">entry</tt><tt class="py-op">,</tt> <tt class="py-name">multiline</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt>
<a name="L1968"></a><tt class="py-lineno">1968</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-253" class="py-name" targets="Method configobj.ConfigObj._a_to_u()=configobj.ConfigObj-class.html#_a_to_u"><a title="configobj.ConfigObj._a_to_u" class="py-name" href="#" onclick="return doclink('link-253', '_a_to_u', 'link-253');">_a_to_u</a></tt><tt class="py-op">(</tt><tt class="py-string">' = '</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt>
<a name="L1969"></a><tt class="py-lineno">1969</tt> <tt class="py-line"> <tt class="py-name">val</tt><tt class="py-op">,</tt> </tt>
<a name="L1970"></a><tt class="py-lineno">1970</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-254" class="py-name"><a title="configobj.ConfigObj._decode_element" class="py-name" href="#" onclick="return doclink('link-254', '_decode_element', 'link-249');">_decode_element</a></tt><tt class="py-op">(</tt><tt class="py-name">comment</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
</div><a name="L1971"></a><tt class="py-lineno">1971</tt> <tt class="py-line"> </tt>
<a name="L1972"></a><tt class="py-lineno">1972</tt> <tt class="py-line"> </tt>
<a name="ConfigObj._write_marker"></a><div id="ConfigObj._write_marker-def"><a name="L1973"></a><tt class="py-lineno">1973</tt> <a class="py-toggle" href="#" id="ConfigObj._write_marker-toggle" onclick="return toggle('ConfigObj._write_marker');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#_write_marker">_write_marker</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">indent_string</tt><tt class="py-op">,</tt> <tt class="py-param">depth</tt><tt class="py-op">,</tt> <tt class="py-param">entry</tt><tt class="py-op">,</tt> <tt class="py-param">comment</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj._write_marker-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj._write_marker-expanded"><a name="L1974"></a><tt class="py-lineno">1974</tt> <tt class="py-line"> <tt class="py-docstring">"""Write a section marker line"""</tt> </tt>
<a name="L1975"></a><tt class="py-lineno">1975</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'%s%s%s%s%s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">indent_string</tt><tt class="py-op">,</tt> </tt>
<a name="L1976"></a><tt class="py-lineno">1976</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-255" class="py-name"><a title="configobj.ConfigObj._a_to_u" class="py-name" href="#" onclick="return doclink('link-255', '_a_to_u', 'link-253');">_a_to_u</a></tt><tt class="py-op">(</tt><tt class="py-string">'['</tt> <tt class="py-op">*</tt> <tt class="py-name">depth</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt>
<a name="L1977"></a><tt class="py-lineno">1977</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-256" class="py-name"><a title="configobj.ConfigObj._quote" class="py-name" href="#" onclick="return doclink('link-256', '_quote', 'link-215');">_quote</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-257" class="py-name"><a title="configobj.ConfigObj._decode_element" class="py-name" href="#" onclick="return doclink('link-257', '_decode_element', 'link-249');">_decode_element</a></tt><tt class="py-op">(</tt><tt class="py-name">entry</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">multiline</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt>
<a name="L1978"></a><tt class="py-lineno">1978</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-258" class="py-name"><a title="configobj.ConfigObj._a_to_u" class="py-name" href="#" onclick="return doclink('link-258', '_a_to_u', 'link-253');">_a_to_u</a></tt><tt class="py-op">(</tt><tt class="py-string">']'</tt> <tt class="py-op">*</tt> <tt class="py-name">depth</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt>
<a name="L1979"></a><tt class="py-lineno">1979</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-259" class="py-name"><a title="configobj.ConfigObj._decode_element" class="py-name" href="#" onclick="return doclink('link-259', '_decode_element', 'link-249');">_decode_element</a></tt><tt class="py-op">(</tt><tt class="py-name">comment</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
</div><a name="L1980"></a><tt class="py-lineno">1980</tt> <tt class="py-line"> </tt>
<a name="L1981"></a><tt class="py-lineno">1981</tt> <tt class="py-line"> </tt>
<a name="ConfigObj._handle_comment"></a><div id="ConfigObj._handle_comment-def"><a name="L1982"></a><tt class="py-lineno">1982</tt> <a class="py-toggle" href="#" id="ConfigObj._handle_comment-toggle" onclick="return toggle('ConfigObj._handle_comment');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#_handle_comment">_handle_comment</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">comment</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj._handle_comment-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj._handle_comment-expanded"><a name="L1983"></a><tt class="py-lineno">1983</tt> <tt class="py-line"> <tt class="py-docstring">"""Deal with a comment."""</tt> </tt>
<a name="L1984"></a><tt class="py-lineno">1984</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">comment</tt><tt class="py-op">:</tt> </tt>
<a name="L1985"></a><tt class="py-lineno">1985</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">''</tt> </tt>
<a name="L1986"></a><tt class="py-lineno">1986</tt> <tt class="py-line"> <tt class="py-name">start</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">indent_type</tt> </tt>
<a name="L1987"></a><tt class="py-lineno">1987</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">comment</tt><tt class="py-op">.</tt><tt class="py-name">startswith</tt><tt class="py-op">(</tt><tt class="py-string">'#'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L1988"></a><tt class="py-lineno">1988</tt> <tt class="py-line"> <tt class="py-name">start</tt> <tt class="py-op">+=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-260" class="py-name"><a title="configobj.ConfigObj._a_to_u" class="py-name" href="#" onclick="return doclink('link-260', '_a_to_u', 'link-253');">_a_to_u</a></tt><tt class="py-op">(</tt><tt class="py-string">' # '</tt><tt class="py-op">)</tt> </tt>
<a name="L1989"></a><tt class="py-lineno">1989</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">start</tt> <tt class="py-op">+</tt> <tt class="py-name">comment</tt><tt class="py-op">)</tt> </tt>
</div><a name="L1990"></a><tt class="py-lineno">1990</tt> <tt class="py-line"> </tt>
<a name="L1991"></a><tt class="py-lineno">1991</tt> <tt class="py-line"> </tt>
<a name="L1992"></a><tt class="py-lineno">1992</tt> <tt class="py-line"> <tt class="py-comment"># Public methods</tt> </tt>
<a name="L1993"></a><tt class="py-lineno">1993</tt> <tt class="py-line"> </tt>
<a name="ConfigObj.write"></a><div id="ConfigObj.write-def"><a name="L1994"></a><tt class="py-lineno">1994</tt> <a class="py-toggle" href="#" id="ConfigObj.write-toggle" onclick="return toggle('ConfigObj.write');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#write">write</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">outfile</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">section</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj.write-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj.write-expanded"><a name="L1995"></a><tt class="py-lineno">1995</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L1996"></a><tt class="py-lineno">1996</tt> <tt class="py-line"><tt class="py-docstring"> Write the current ConfigObj as a file</tt> </tt>
<a name="L1997"></a><tt class="py-lineno">1997</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L1998"></a><tt class="py-lineno">1998</tt> <tt class="py-line"><tt class="py-docstring"> tekNico: FIXME: use StringIO instead of real files</tt> </tt>
<a name="L1999"></a><tt class="py-lineno">1999</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2000"></a><tt class="py-lineno">2000</tt> <tt class="py-line"><tt class="py-docstring"> >>> filename = a.filename</tt> </tt>
<a name="L2001"></a><tt class="py-lineno">2001</tt> <tt class="py-line"><tt class="py-docstring"> >>> a.filename = 'test.ini'</tt> </tt>
<a name="L2002"></a><tt class="py-lineno">2002</tt> <tt class="py-line"><tt class="py-docstring"> >>> a.write()</tt> </tt>
<a name="L2003"></a><tt class="py-lineno">2003</tt> <tt class="py-line"><tt class="py-docstring"> >>> a.filename = filename</tt> </tt>
<a name="L2004"></a><tt class="py-lineno">2004</tt> <tt class="py-line"><tt class="py-docstring"> >>> a == ConfigObj('test.ini', raise_errors=True)</tt> </tt>
<a name="L2005"></a><tt class="py-lineno">2005</tt> <tt class="py-line"><tt class="py-docstring"> 1</tt> </tt>
<a name="L2006"></a><tt class="py-lineno">2006</tt> <tt class="py-line"><tt class="py-docstring"> >>> import os</tt> </tt>
<a name="L2007"></a><tt class="py-lineno">2007</tt> <tt class="py-line"><tt class="py-docstring"> >>> os.remove('test.ini')</tt> </tt>
<a name="L2008"></a><tt class="py-lineno">2008</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L2009"></a><tt class="py-lineno">2009</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">indent_type</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L2010"></a><tt class="py-lineno">2010</tt> <tt class="py-line"> <tt class="py-comment"># this can be true if initialised from a dictionary</tt> </tt>
<a name="L2011"></a><tt class="py-lineno">2011</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">indent_type</tt> <tt class="py-op">=</tt> <tt id="link-261" class="py-name"><a title="configobj.DEFAULT_INDENT_TYPE" class="py-name" href="#" onclick="return doclink('link-261', 'DEFAULT_INDENT_TYPE', 'link-15');">DEFAULT_INDENT_TYPE</a></tt> </tt>
<a name="L2012"></a><tt class="py-lineno">2012</tt> <tt class="py-line"> </tt>
<a name="L2013"></a><tt class="py-lineno">2013</tt> <tt class="py-line"> <tt class="py-name">out</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L2014"></a><tt class="py-lineno">2014</tt> <tt class="py-line"> <tt class="py-name">cs</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-262" class="py-name"><a title="configobj.ConfigObj._a_to_u" class="py-name" href="#" onclick="return doclink('link-262', '_a_to_u', 'link-253');">_a_to_u</a></tt><tt class="py-op">(</tt><tt class="py-string">'#'</tt><tt class="py-op">)</tt> </tt>
<a name="L2015"></a><tt class="py-lineno">2015</tt> <tt class="py-line"> <tt class="py-name">csp</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-263" class="py-name"><a title="configobj.ConfigObj._a_to_u" class="py-name" href="#" onclick="return doclink('link-263', '_a_to_u', 'link-253');">_a_to_u</a></tt><tt class="py-op">(</tt><tt class="py-string">'# '</tt><tt class="py-op">)</tt> </tt>
<a name="L2016"></a><tt class="py-lineno">2016</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">section</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L2017"></a><tt class="py-lineno">2017</tt> <tt class="py-line"> <tt class="py-name">int_val</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">interpolation</tt> </tt>
<a name="L2018"></a><tt class="py-lineno">2018</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">interpolation</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L2019"></a><tt class="py-lineno">2019</tt> <tt class="py-line"> <tt class="py-name">section</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt> </tt>
<a name="L2020"></a><tt class="py-lineno">2020</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">line</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">initial_comment</tt><tt class="py-op">:</tt> </tt>
<a name="L2021"></a><tt class="py-lineno">2021</tt> <tt class="py-line"> <tt class="py-name">line</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-264" class="py-name"><a title="configobj.ConfigObj._decode_element" class="py-name" href="#" onclick="return doclink('link-264', '_decode_element', 'link-249');">_decode_element</a></tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">)</tt> </tt>
<a name="L2022"></a><tt class="py-lineno">2022</tt> <tt class="py-line"> <tt class="py-name">stripped_line</tt> <tt class="py-op">=</tt> <tt class="py-name">line</tt><tt class="py-op">.</tt><tt class="py-name">strip</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L2023"></a><tt class="py-lineno">2023</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">stripped_line</tt> <tt class="py-keyword">and</tt> <tt class="py-keyword">not</tt> <tt class="py-name">stripped_line</tt><tt class="py-op">.</tt><tt class="py-name">startswith</tt><tt class="py-op">(</tt><tt class="py-name">cs</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L2024"></a><tt class="py-lineno">2024</tt> <tt class="py-line"> <tt class="py-name">line</tt> <tt class="py-op">=</tt> <tt class="py-name">csp</tt> <tt class="py-op">+</tt> <tt class="py-name">line</tt> </tt>
<a name="L2025"></a><tt class="py-lineno">2025</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">)</tt> </tt>
<a name="L2026"></a><tt class="py-lineno">2026</tt> <tt class="py-line"> </tt>
<a name="L2027"></a><tt class="py-lineno">2027</tt> <tt class="py-line"> <tt class="py-name">indent_string</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">indent_type</tt> <tt class="py-op">*</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">depth</tt> </tt>
<a name="L2028"></a><tt class="py-lineno">2028</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt> <tt class="py-op">+</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L2029"></a><tt class="py-lineno">2029</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">in</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">defaults</tt><tt class="py-op">:</tt> </tt>
<a name="L2030"></a><tt class="py-lineno">2030</tt> <tt class="py-line"> <tt class="py-comment"># don't write out default values</tt> </tt>
<a name="L2031"></a><tt class="py-lineno">2031</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L2032"></a><tt class="py-lineno">2032</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">comment_line</tt> <tt class="py-keyword">in</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">comments</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt><tt class="py-op">:</tt> </tt>
<a name="L2033"></a><tt class="py-lineno">2033</tt> <tt class="py-line"> <tt class="py-name">comment_line</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-265" class="py-name"><a title="configobj.ConfigObj._decode_element" class="py-name" href="#" onclick="return doclink('link-265', '_decode_element', 'link-249');">_decode_element</a></tt><tt class="py-op">(</tt><tt class="py-name">comment_line</tt><tt class="py-op">.</tt><tt class="py-name">lstrip</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
<a name="L2034"></a><tt class="py-lineno">2034</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">comment_line</tt> <tt class="py-keyword">and</tt> <tt class="py-keyword">not</tt> <tt class="py-name">comment_line</tt><tt class="py-op">.</tt><tt class="py-name">startswith</tt><tt class="py-op">(</tt><tt class="py-name">cs</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L2035"></a><tt class="py-lineno">2035</tt> <tt class="py-line"> <tt class="py-name">comment_line</tt> <tt class="py-op">=</tt> <tt class="py-name">csp</tt> <tt class="py-op">+</tt> <tt class="py-name">comment_line</tt> </tt>
<a name="L2036"></a><tt class="py-lineno">2036</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">indent_string</tt> <tt class="py-op">+</tt> <tt class="py-name">comment_line</tt><tt class="py-op">)</tt> </tt>
<a name="L2037"></a><tt class="py-lineno">2037</tt> <tt class="py-line"> <tt class="py-name">this_entry</tt> <tt class="py-op">=</tt> <tt class="py-name">section</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> </tt>
<a name="L2038"></a><tt class="py-lineno">2038</tt> <tt class="py-line"> <tt class="py-name">comment</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-266" class="py-name" targets="Method configobj.ConfigObj._handle_comment()=configobj.ConfigObj-class.html#_handle_comment"><a title="configobj.ConfigObj._handle_comment" class="py-name" href="#" onclick="return doclink('link-266', '_handle_comment', 'link-266');">_handle_comment</a></tt><tt class="py-op">(</tt><tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">inline_comments</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
<a name="L2039"></a><tt class="py-lineno">2039</tt> <tt class="py-line"> </tt>
<a name="L2040"></a><tt class="py-lineno">2040</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">this_entry</tt><tt class="py-op">,</tt> <tt id="link-267" class="py-name"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-267', 'dict', 'link-68');">dict</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L2041"></a><tt class="py-lineno">2041</tt> <tt class="py-line"> <tt class="py-comment"># a section</tt> </tt>
<a name="L2042"></a><tt class="py-lineno">2042</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-268" class="py-name" targets="Method configobj.ConfigObj._write_marker()=configobj.ConfigObj-class.html#_write_marker"><a title="configobj.ConfigObj._write_marker" class="py-name" href="#" onclick="return doclink('link-268', '_write_marker', 'link-268');">_write_marker</a></tt><tt class="py-op">(</tt> </tt>
<a name="L2043"></a><tt class="py-lineno">2043</tt> <tt class="py-line"> <tt class="py-name">indent_string</tt><tt class="py-op">,</tt> </tt>
<a name="L2044"></a><tt class="py-lineno">2044</tt> <tt class="py-line"> <tt class="py-name">this_entry</tt><tt class="py-op">.</tt><tt class="py-name">depth</tt><tt class="py-op">,</tt> </tt>
<a name="L2045"></a><tt class="py-lineno">2045</tt> <tt class="py-line"> <tt class="py-name">entry</tt><tt class="py-op">,</tt> </tt>
<a name="L2046"></a><tt class="py-lineno">2046</tt> <tt class="py-line"> <tt class="py-name">comment</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
<a name="L2047"></a><tt class="py-lineno">2047</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">.</tt><tt class="py-name">extend</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-269" class="py-name"><a title="configobj.ConfigObj.write" class="py-name" href="#" onclick="return doclink('link-269', 'write', 'link-148');">write</a></tt><tt class="py-op">(</tt><tt class="py-name">section</tt><tt class="py-op">=</tt><tt class="py-name">this_entry</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
<a name="L2048"></a><tt class="py-lineno">2048</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L2049"></a><tt class="py-lineno">2049</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-270" class="py-name" targets="Method configobj.ConfigObj._write_line()=configobj.ConfigObj-class.html#_write_line"><a title="configobj.ConfigObj._write_line" class="py-name" href="#" onclick="return doclink('link-270', '_write_line', 'link-270');">_write_line</a></tt><tt class="py-op">(</tt> </tt>
<a name="L2050"></a><tt class="py-lineno">2050</tt> <tt class="py-line"> <tt class="py-name">indent_string</tt><tt class="py-op">,</tt> </tt>
<a name="L2051"></a><tt class="py-lineno">2051</tt> <tt class="py-line"> <tt class="py-name">entry</tt><tt class="py-op">,</tt> </tt>
<a name="L2052"></a><tt class="py-lineno">2052</tt> <tt class="py-line"> <tt class="py-name">this_entry</tt><tt class="py-op">,</tt> </tt>
<a name="L2053"></a><tt class="py-lineno">2053</tt> <tt class="py-line"> <tt class="py-name">comment</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
<a name="L2054"></a><tt class="py-lineno">2054</tt> <tt class="py-line"> </tt>
<a name="L2055"></a><tt class="py-lineno">2055</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">section</tt> <tt class="py-keyword">is</tt> <tt class="py-name">self</tt><tt class="py-op">:</tt> </tt>
<a name="L2056"></a><tt class="py-lineno">2056</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">line</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">final_comment</tt><tt class="py-op">:</tt> </tt>
<a name="L2057"></a><tt class="py-lineno">2057</tt> <tt class="py-line"> <tt class="py-name">line</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-271" class="py-name"><a title="configobj.ConfigObj._decode_element" class="py-name" href="#" onclick="return doclink('link-271', '_decode_element', 'link-249');">_decode_element</a></tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">)</tt> </tt>
<a name="L2058"></a><tt class="py-lineno">2058</tt> <tt class="py-line"> <tt class="py-name">stripped_line</tt> <tt class="py-op">=</tt> <tt class="py-name">line</tt><tt class="py-op">.</tt><tt class="py-name">strip</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L2059"></a><tt class="py-lineno">2059</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">stripped_line</tt> <tt class="py-keyword">and</tt> <tt class="py-keyword">not</tt> <tt class="py-name">stripped_line</tt><tt class="py-op">.</tt><tt class="py-name">startswith</tt><tt class="py-op">(</tt><tt class="py-name">cs</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L2060"></a><tt class="py-lineno">2060</tt> <tt class="py-line"> <tt class="py-name">line</tt> <tt class="py-op">=</tt> <tt class="py-name">csp</tt> <tt class="py-op">+</tt> <tt class="py-name">line</tt> </tt>
<a name="L2061"></a><tt class="py-lineno">2061</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">)</tt> </tt>
<a name="L2062"></a><tt class="py-lineno">2062</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">interpolation</tt> <tt class="py-op">=</tt> <tt class="py-name">int_val</tt> </tt>
<a name="L2063"></a><tt class="py-lineno">2063</tt> <tt class="py-line"> </tt>
<a name="L2064"></a><tt class="py-lineno">2064</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">section</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">:</tt> </tt>
<a name="L2065"></a><tt class="py-lineno">2065</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">out</tt> </tt>
<a name="L2066"></a><tt class="py-lineno">2066</tt> <tt class="py-line"> </tt>
<a name="L2067"></a><tt class="py-lineno">2067</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">filename</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-name">outfile</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L2068"></a><tt class="py-lineno">2068</tt> <tt class="py-line"> <tt class="py-comment"># output a list of lines</tt> </tt>
<a name="L2069"></a><tt class="py-lineno">2069</tt> <tt class="py-line"> <tt class="py-comment"># might need to encode</tt> </tt>
<a name="L2070"></a><tt class="py-lineno">2070</tt> <tt class="py-line"> <tt class="py-comment"># NOTE: This will *screw* UTF16, each line will start with the BOM</tt> </tt>
<a name="L2071"></a><tt class="py-lineno">2071</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt><tt class="py-op">:</tt> </tt>
<a name="L2072"></a><tt class="py-lineno">2072</tt> <tt class="py-line"> <tt class="py-name">out</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">l</tt><tt class="py-op">.</tt><tt class="py-name">encode</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">l</tt> <tt class="py-keyword">in</tt> <tt class="py-name">out</tt><tt class="py-op">]</tt> </tt>
<a name="L2073"></a><tt class="py-lineno">2073</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">BOM</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> </tt>
<a name="L2074"></a><tt class="py-lineno">2074</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt id="link-272" class="py-name"><a title="configobj.BOM_LIST" class="py-name" href="#" onclick="return doclink('link-272', 'BOM_LIST', 'link-2');">BOM_LIST</a></tt><tt class="py-op">.</tt><tt id="link-273" class="py-name"><a title="configobj.Section.get" class="py-name" href="#" onclick="return doclink('link-273', 'get', 'link-5');">get</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt><tt class="py-op">.</tt><tt class="py-name">lower</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-string">'utf_8'</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L2075"></a><tt class="py-lineno">2075</tt> <tt class="py-line"> <tt class="py-comment"># Add the UTF8 BOM</tt> </tt>
<a name="L2076"></a><tt class="py-lineno">2076</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">out</tt><tt class="py-op">:</tt> </tt>
<a name="L2077"></a><tt class="py-lineno">2077</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">''</tt><tt class="py-op">)</tt> </tt>
<a name="L2078"></a><tt class="py-lineno">2078</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">BOM_UTF8</tt> <tt class="py-op">+</tt> <tt class="py-name">out</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> </tt>
<a name="L2079"></a><tt class="py-lineno">2079</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">out</tt> </tt>
<a name="L2080"></a><tt class="py-lineno">2080</tt> <tt class="py-line"> </tt>
<a name="L2081"></a><tt class="py-lineno">2081</tt> <tt class="py-line"> <tt class="py-comment"># Turn the list to a string, joined with correct newlines</tt> </tt>
<a name="L2082"></a><tt class="py-lineno">2082</tt> <tt class="py-line"> <tt class="py-name">newline</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">newlines</tt> <tt class="py-keyword">or</tt> <tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">linesep</tt> </tt>
<a name="L2083"></a><tt class="py-lineno">2083</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">getattr</tt><tt class="py-op">(</tt><tt class="py-name">outfile</tt><tt class="py-op">,</tt> <tt class="py-string">'mode'</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt> <tt class="py-keyword">and</tt> <tt class="py-name">outfile</tt><tt class="py-op">.</tt><tt class="py-name">mode</tt> <tt class="py-op">==</tt> <tt class="py-string">'w'</tt> </tt>
<a name="L2084"></a><tt class="py-lineno">2084</tt> <tt class="py-line"> <tt class="py-keyword">and</tt> <tt class="py-name">sys</tt><tt class="py-op">.</tt><tt class="py-name">platform</tt> <tt class="py-op">==</tt> <tt class="py-string">'win32'</tt> <tt class="py-keyword">and</tt> <tt class="py-name">newline</tt> <tt class="py-op">==</tt> <tt class="py-string">'\r\n'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L2085"></a><tt class="py-lineno">2085</tt> <tt class="py-line"> <tt class="py-comment"># Windows specific hack to avoid writing '\r\r\n'</tt> </tt>
<a name="L2086"></a><tt class="py-lineno">2086</tt> <tt class="py-line"> <tt class="py-name">newline</tt> <tt class="py-op">=</tt> <tt class="py-string">'\n'</tt> </tt>
<a name="L2087"></a><tt class="py-lineno">2087</tt> <tt class="py-line"> <tt class="py-name">output</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-274" class="py-name"><a title="configobj.ConfigObj._a_to_u" class="py-name" href="#" onclick="return doclink('link-274', '_a_to_u', 'link-253');">_a_to_u</a></tt><tt class="py-op">(</tt><tt class="py-name">newline</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">out</tt><tt class="py-op">)</tt> </tt>
<a name="L2088"></a><tt class="py-lineno">2088</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt><tt class="py-op">:</tt> </tt>
<a name="L2089"></a><tt class="py-lineno">2089</tt> <tt class="py-line"> <tt class="py-name">output</tt> <tt class="py-op">=</tt> <tt class="py-name">output</tt><tt class="py-op">.</tt><tt class="py-name">encode</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt><tt class="py-op">)</tt> </tt>
<a name="L2090"></a><tt class="py-lineno">2090</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">BOM</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> <tt id="link-275" class="py-name" targets="Function configobj.match_utf8()=configobj-module.html#match_utf8"><a title="configobj.match_utf8" class="py-name" href="#" onclick="return doclink('link-275', 'match_utf8', 'link-275');">match_utf8</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L2091"></a><tt class="py-lineno">2091</tt> <tt class="py-line"> <tt class="py-comment"># Add the UTF8 BOM</tt> </tt>
<a name="L2092"></a><tt class="py-lineno">2092</tt> <tt class="py-line"> <tt class="py-name">output</tt> <tt class="py-op">=</tt> <tt class="py-name">BOM_UTF8</tt> <tt class="py-op">+</tt> <tt class="py-name">output</tt> </tt>
<a name="L2093"></a><tt class="py-lineno">2093</tt> <tt class="py-line"> </tt>
<a name="L2094"></a><tt class="py-lineno">2094</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">output</tt><tt class="py-op">.</tt><tt class="py-name">endswith</tt><tt class="py-op">(</tt><tt class="py-name">newline</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L2095"></a><tt class="py-lineno">2095</tt> <tt class="py-line"> <tt class="py-name">output</tt> <tt class="py-op">+=</tt> <tt class="py-name">newline</tt> </tt>
<a name="L2096"></a><tt class="py-lineno">2096</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">outfile</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L2097"></a><tt class="py-lineno">2097</tt> <tt class="py-line"> <tt class="py-name">outfile</tt><tt class="py-op">.</tt><tt id="link-276" class="py-name"><a title="configobj.ConfigObj.write" class="py-name" href="#" onclick="return doclink('link-276', 'write', 'link-148');">write</a></tt><tt class="py-op">(</tt><tt class="py-name">output</tt><tt class="py-op">)</tt> </tt>
<a name="L2098"></a><tt class="py-lineno">2098</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L2099"></a><tt class="py-lineno">2099</tt> <tt class="py-line"> <tt class="py-name">h</tt> <tt class="py-op">=</tt> <tt class="py-name">open</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">filename</tt><tt class="py-op">,</tt> <tt class="py-string">'wb'</tt><tt class="py-op">)</tt> </tt>
<a name="L2100"></a><tt class="py-lineno">2100</tt> <tt class="py-line"> <tt class="py-name">h</tt><tt class="py-op">.</tt><tt id="link-277" class="py-name"><a title="configobj.ConfigObj.write" class="py-name" href="#" onclick="return doclink('link-277', 'write', 'link-148');">write</a></tt><tt class="py-op">(</tt><tt class="py-name">output</tt><tt class="py-op">)</tt> </tt>
<a name="L2101"></a><tt class="py-lineno">2101</tt> <tt class="py-line"> <tt class="py-name">h</tt><tt class="py-op">.</tt><tt class="py-name">close</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
</div><a name="L2102"></a><tt class="py-lineno">2102</tt> <tt class="py-line"> </tt>
<a name="L2103"></a><tt class="py-lineno">2103</tt> <tt class="py-line"> </tt>
<a name="ConfigObj.validate"></a><div id="ConfigObj.validate-def"><a name="L2104"></a><tt class="py-lineno">2104</tt> <a class="py-toggle" href="#" id="ConfigObj.validate-toggle" onclick="return toggle('ConfigObj.validate');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#validate">validate</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">validator</tt><tt class="py-op">,</tt> <tt class="py-param">preserve_errors</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">,</tt> <tt class="py-param">copy</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">,</tt> </tt>
<a name="L2105"></a><tt class="py-lineno">2105</tt> <tt class="py-line"> <tt class="py-param">section</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj.validate-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj.validate-expanded"><a name="L2106"></a><tt class="py-lineno">2106</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L2107"></a><tt class="py-lineno">2107</tt> <tt class="py-line"><tt class="py-docstring"> Test the ConfigObj against a configspec.</tt> </tt>
<a name="L2108"></a><tt class="py-lineno">2108</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2109"></a><tt class="py-lineno">2109</tt> <tt class="py-line"><tt class="py-docstring"> It uses the ``validator`` object from *validate.py*.</tt> </tt>
<a name="L2110"></a><tt class="py-lineno">2110</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2111"></a><tt class="py-lineno">2111</tt> <tt class="py-line"><tt class="py-docstring"> To run ``validate`` on the current ConfigObj, call: ::</tt> </tt>
<a name="L2112"></a><tt class="py-lineno">2112</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2113"></a><tt class="py-lineno">2113</tt> <tt class="py-line"><tt class="py-docstring"> test = config.validate(validator)</tt> </tt>
<a name="L2114"></a><tt class="py-lineno">2114</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2115"></a><tt class="py-lineno">2115</tt> <tt class="py-line"><tt class="py-docstring"> (Normally having previously passed in the configspec when the ConfigObj</tt> </tt>
<a name="L2116"></a><tt class="py-lineno">2116</tt> <tt class="py-line"><tt class="py-docstring"> was created - you can dynamically assign a dictionary of checks to the</tt> </tt>
<a name="L2117"></a><tt class="py-lineno">2117</tt> <tt class="py-line"><tt class="py-docstring"> ``configspec`` attribute of a section though).</tt> </tt>
<a name="L2118"></a><tt class="py-lineno">2118</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2119"></a><tt class="py-lineno">2119</tt> <tt class="py-line"><tt class="py-docstring"> It returns ``True`` if everything passes, or a dictionary of</tt> </tt>
<a name="L2120"></a><tt class="py-lineno">2120</tt> <tt class="py-line"><tt class="py-docstring"> pass/fails (True/False). If every member of a subsection passes, it</tt> </tt>
<a name="L2121"></a><tt class="py-lineno">2121</tt> <tt class="py-line"><tt class="py-docstring"> will just have the value ``True``. (It also returns ``False`` if all</tt> </tt>
<a name="L2122"></a><tt class="py-lineno">2122</tt> <tt class="py-line"><tt class="py-docstring"> members fail).</tt> </tt>
<a name="L2123"></a><tt class="py-lineno">2123</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2124"></a><tt class="py-lineno">2124</tt> <tt class="py-line"><tt class="py-docstring"> In addition, it converts the values from strings to their native</tt> </tt>
<a name="L2125"></a><tt class="py-lineno">2125</tt> <tt class="py-line"><tt class="py-docstring"> types if their checks pass (and ``stringify`` is set).</tt> </tt>
<a name="L2126"></a><tt class="py-lineno">2126</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2127"></a><tt class="py-lineno">2127</tt> <tt class="py-line"><tt class="py-docstring"> If ``preserve_errors`` is ``True`` (``False`` is default) then instead</tt> </tt>
<a name="L2128"></a><tt class="py-lineno">2128</tt> <tt class="py-line"><tt class="py-docstring"> of a marking a fail with a ``False``, it will preserve the actual</tt> </tt>
<a name="L2129"></a><tt class="py-lineno">2129</tt> <tt class="py-line"><tt class="py-docstring"> exception object. This can contain info about the reason for failure.</tt> </tt>
<a name="L2130"></a><tt class="py-lineno">2130</tt> <tt class="py-line"><tt class="py-docstring"> For example the ``VdtValueTooSmallError`` indicates that the value</tt> </tt>
<a name="L2131"></a><tt class="py-lineno">2131</tt> <tt class="py-line"><tt class="py-docstring"> supplied was too small. If a value (or section) is missing it will</tt> </tt>
<a name="L2132"></a><tt class="py-lineno">2132</tt> <tt class="py-line"><tt class="py-docstring"> still be marked as ``False``.</tt> </tt>
<a name="L2133"></a><tt class="py-lineno">2133</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2134"></a><tt class="py-lineno">2134</tt> <tt class="py-line"><tt class="py-docstring"> You must have the validate module to use ``preserve_errors=True``.</tt> </tt>
<a name="L2135"></a><tt class="py-lineno">2135</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2136"></a><tt class="py-lineno">2136</tt> <tt class="py-line"><tt class="py-docstring"> You can then use the ``flatten_errors`` function to turn your nested</tt> </tt>
<a name="L2137"></a><tt class="py-lineno">2137</tt> <tt class="py-line"><tt class="py-docstring"> results dictionary into a flattened list of failures - useful for</tt> </tt>
<a name="L2138"></a><tt class="py-lineno">2138</tt> <tt class="py-line"><tt class="py-docstring"> displaying meaningful error messages.</tt> </tt>
<a name="L2139"></a><tt class="py-lineno">2139</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L2140"></a><tt class="py-lineno">2140</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">section</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L2141"></a><tt class="py-lineno">2141</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">configspec</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L2142"></a><tt class="py-lineno">2142</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'No configspec supplied.'</tt><tt class="py-op">)</tt> </tt>
<a name="L2143"></a><tt class="py-lineno">2143</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">preserve_errors</tt><tt class="py-op">:</tt> </tt>
<a name="L2144"></a><tt class="py-lineno">2144</tt> <tt class="py-line"> <tt class="py-comment"># We do this once to remove a top level dependency on the validate module</tt> </tt>
<a name="L2145"></a><tt class="py-lineno">2145</tt> <tt class="py-line"> <tt class="py-comment"># Which makes importing configobj faster</tt> </tt>
<a name="L2146"></a><tt class="py-lineno">2146</tt> <tt class="py-line"> <tt class="py-keyword">from</tt> <tt id="link-278" class="py-name" targets="Method configobj.ConfigObj.validate()=configobj.ConfigObj-class.html#validate"><a title="configobj.ConfigObj.validate" class="py-name" href="#" onclick="return doclink('link-278', 'validate', 'link-278');">validate</a></tt> <tt class="py-keyword">import</tt> <tt class="py-name">VdtMissingValue</tt> </tt>
<a name="L2147"></a><tt class="py-lineno">2147</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_vdtMissingValue</tt> <tt class="py-op">=</tt> <tt class="py-name">VdtMissingValue</tt> </tt>
<a name="L2148"></a><tt class="py-lineno">2148</tt> <tt class="py-line"> </tt>
<a name="L2149"></a><tt class="py-lineno">2149</tt> <tt class="py-line"> <tt class="py-name">section</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt> </tt>
<a name="L2150"></a><tt class="py-lineno">2150</tt> <tt class="py-line"> </tt>
<a name="L2151"></a><tt class="py-lineno">2151</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">copy</tt><tt class="py-op">:</tt> </tt>
<a name="L2152"></a><tt class="py-lineno">2152</tt> <tt class="py-line"> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">initial_comment</tt> <tt class="py-op">=</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">configspec</tt><tt class="py-op">.</tt><tt class="py-name">initial_comment</tt> </tt>
<a name="L2153"></a><tt class="py-lineno">2153</tt> <tt class="py-line"> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">final_comment</tt> <tt class="py-op">=</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">configspec</tt><tt class="py-op">.</tt><tt class="py-name">final_comment</tt> </tt>
<a name="L2154"></a><tt class="py-lineno">2154</tt> <tt class="py-line"> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt> <tt class="py-op">=</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">configspec</tt><tt class="py-op">.</tt><tt class="py-name">encoding</tt> </tt>
<a name="L2155"></a><tt class="py-lineno">2155</tt> <tt class="py-line"> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">BOM</tt> <tt class="py-op">=</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">configspec</tt><tt class="py-op">.</tt><tt class="py-name">BOM</tt> </tt>
<a name="L2156"></a><tt class="py-lineno">2156</tt> <tt class="py-line"> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">newlines</tt> <tt class="py-op">=</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">configspec</tt><tt class="py-op">.</tt><tt class="py-name">newlines</tt> </tt>
<a name="L2157"></a><tt class="py-lineno">2157</tt> <tt class="py-line"> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">indent_type</tt> <tt class="py-op">=</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">configspec</tt><tt class="py-op">.</tt><tt class="py-name">indent_type</tt> </tt>
<a name="L2158"></a><tt class="py-lineno">2158</tt> <tt class="py-line"> </tt>
<a name="L2159"></a><tt class="py-lineno">2159</tt> <tt class="py-line"> <tt class="py-comment">#</tt> </tt>
<a name="L2160"></a><tt class="py-lineno">2160</tt> <tt class="py-line"> <tt class="py-comment"># section.default_values.clear() #??</tt> </tt>
<a name="L2161"></a><tt class="py-lineno">2161</tt> <tt class="py-line"> <tt class="py-name">configspec</tt> <tt class="py-op">=</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">configspec</tt> </tt>
<a name="L2162"></a><tt class="py-lineno">2162</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-279" class="py-name" targets="Method configobj.ConfigObj._set_configspec()=configobj.ConfigObj-class.html#_set_configspec"><a title="configobj.ConfigObj._set_configspec" class="py-name" href="#" onclick="return doclink('link-279', '_set_configspec', 'link-279');">_set_configspec</a></tt><tt class="py-op">(</tt><tt class="py-name">section</tt><tt class="py-op">,</tt> <tt class="py-name">copy</tt><tt class="py-op">)</tt> </tt>
<a name="L2163"></a><tt class="py-lineno">2163</tt> <tt class="py-line"> </tt>
<a name="L2164"></a><tt class="py-lineno">2164</tt> <tt class="py-line"> </tt>
<a name="L2165"></a><tt class="py-lineno">2165</tt> <tt class="py-line"> <tt class="py-keyword">def</tt> <tt class="py-def-name">validate_entry</tt><tt class="py-op">(</tt><tt class="py-param">entry</tt><tt class="py-op">,</tt> <tt class="py-param">spec</tt><tt class="py-op">,</tt> <tt class="py-param">val</tt><tt class="py-op">,</tt> <tt class="py-param">missing</tt><tt class="py-op">,</tt> <tt class="py-param">ret_true</tt><tt class="py-op">,</tt> <tt class="py-param">ret_false</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L2166"></a><tt class="py-lineno">2166</tt> <tt class="py-line"> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">default_values</tt><tt class="py-op">.</tt><tt id="link-280" class="py-name" targets="Method configobj.Section.pop()=configobj.Section-class.html#pop"><a title="configobj.Section.pop" class="py-name" href="#" onclick="return doclink('link-280', 'pop', 'link-280');">pop</a></tt><tt class="py-op">(</tt><tt class="py-name">entry</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt> </tt>
<a name="L2167"></a><tt class="py-lineno">2167</tt> <tt class="py-line"> </tt>
<a name="L2168"></a><tt class="py-lineno">2168</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
<a name="L2169"></a><tt class="py-lineno">2169</tt> <tt class="py-line"> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">default_values</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">validator</tt><tt class="py-op">.</tt><tt class="py-name">get_default_value</tt><tt class="py-op">(</tt><tt class="py-name">configspec</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
<a name="L2170"></a><tt class="py-lineno">2170</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-op">(</tt><tt class="py-name">KeyError</tt><tt class="py-op">,</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">,</tt> <tt class="py-name">validator</tt><tt class="py-op">.</tt><tt class="py-name">baseErrorClass</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L2171"></a><tt class="py-lineno">2171</tt> <tt class="py-line"> <tt class="py-comment"># No default, bad default or validator has no 'get_default_value'</tt> </tt>
<a name="L2172"></a><tt class="py-lineno">2172</tt> <tt class="py-line"> <tt class="py-comment"># (e.g. SimpleVal)</tt> </tt>
<a name="L2173"></a><tt class="py-lineno">2173</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt>
<a name="L2174"></a><tt class="py-lineno">2174</tt> <tt class="py-line"> </tt>
<a name="L2175"></a><tt class="py-lineno">2175</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
<a name="L2176"></a><tt class="py-lineno">2176</tt> <tt class="py-line"> <tt id="link-281" class="py-name" targets="Method configobj.SimpleVal.check()=configobj.SimpleVal-class.html#check"><a title="configobj.SimpleVal.check" class="py-name" href="#" onclick="return doclink('link-281', 'check', 'link-281');">check</a></tt> <tt class="py-op">=</tt> <tt class="py-name">validator</tt><tt class="py-op">.</tt><tt id="link-282" class="py-name"><a title="configobj.SimpleVal.check" class="py-name" href="#" onclick="return doclink('link-282', 'check', 'link-281');">check</a></tt><tt class="py-op">(</tt><tt class="py-name">spec</tt><tt class="py-op">,</tt> </tt>
<a name="L2177"></a><tt class="py-lineno">2177</tt> <tt class="py-line"> <tt class="py-name">val</tt><tt class="py-op">,</tt> </tt>
<a name="L2178"></a><tt class="py-lineno">2178</tt> <tt class="py-line"> <tt class="py-name">missing</tt><tt class="py-op">=</tt><tt class="py-name">missing</tt> </tt>
<a name="L2179"></a><tt class="py-lineno">2179</tt> <tt class="py-line"> <tt class="py-op">)</tt> </tt>
<a name="L2180"></a><tt class="py-lineno">2180</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">validator</tt><tt class="py-op">.</tt><tt class="py-name">baseErrorClass</tt><tt class="py-op">,</tt> <tt class="py-name">e</tt><tt class="py-op">:</tt> </tt>
<a name="L2181"></a><tt class="py-lineno">2181</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">preserve_errors</tt> <tt class="py-keyword">or</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">e</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_vdtMissingValue</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L2182"></a><tt class="py-lineno">2182</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L2183"></a><tt class="py-lineno">2183</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L2184"></a><tt class="py-lineno">2184</tt> <tt class="py-line"> <tt class="py-comment"># preserve the error</tt> </tt>
<a name="L2185"></a><tt class="py-lineno">2185</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">e</tt> </tt>
<a name="L2186"></a><tt class="py-lineno">2186</tt> <tt class="py-line"> <tt class="py-name">ret_false</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L2187"></a><tt class="py-lineno">2187</tt> <tt class="py-line"> <tt class="py-name">ret_true</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L2188"></a><tt class="py-lineno">2188</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L2189"></a><tt class="py-lineno">2189</tt> <tt class="py-line"> <tt class="py-name">ret_false</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L2190"></a><tt class="py-lineno">2190</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
<a name="L2191"></a><tt class="py-lineno">2191</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">stringify</tt> <tt class="py-keyword">or</tt> <tt class="py-name">missing</tt><tt class="py-op">:</tt> </tt>
<a name="L2192"></a><tt class="py-lineno">2192</tt> <tt class="py-line"> <tt class="py-comment"># if we are doing type conversion</tt> </tt>
<a name="L2193"></a><tt class="py-lineno">2193</tt> <tt class="py-line"> <tt class="py-comment"># or the value is a supplied default</tt> </tt>
<a name="L2194"></a><tt class="py-lineno">2194</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">stringify</tt><tt class="py-op">:</tt> </tt>
<a name="L2195"></a><tt class="py-lineno">2195</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt id="link-283" class="py-name"><a title="configobj.SimpleVal.check" class="py-name" href="#" onclick="return doclink('link-283', 'check', 'link-281');">check</a></tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">list</tt><tt class="py-op">,</tt> <tt class="py-name">tuple</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L2196"></a><tt class="py-lineno">2196</tt> <tt class="py-line"> <tt class="py-comment"># preserve lists</tt> </tt>
<a name="L2197"></a><tt class="py-lineno">2197</tt> <tt class="py-line"> <tt id="link-284" class="py-name"><a title="configobj.SimpleVal.check" class="py-name" href="#" onclick="return doclink('link-284', 'check', 'link-281');">check</a></tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-285" class="py-name" targets="Method configobj.ConfigObj._str()=configobj.ConfigObj-class.html#_str"><a title="configobj.ConfigObj._str" class="py-name" href="#" onclick="return doclink('link-285', '_str', 'link-285');">_str</a></tt><tt class="py-op">(</tt><tt class="py-name">item</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">item</tt> <tt class="py-keyword">in</tt> <tt id="link-286" class="py-name"><a title="configobj.SimpleVal.check" class="py-name" href="#" onclick="return doclink('link-286', 'check', 'link-281');">check</a></tt><tt class="py-op">]</tt> </tt>
<a name="L2198"></a><tt class="py-lineno">2198</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">missing</tt> <tt class="py-keyword">and</tt> <tt id="link-287" class="py-name"><a title="configobj.SimpleVal.check" class="py-name" href="#" onclick="return doclink('link-287', 'check', 'link-281');">check</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L2199"></a><tt class="py-lineno">2199</tt> <tt class="py-line"> <tt class="py-comment"># convert the None from a default to a ''</tt> </tt>
<a name="L2200"></a><tt class="py-lineno">2200</tt> <tt class="py-line"> <tt id="link-288" class="py-name"><a title="configobj.SimpleVal.check" class="py-name" href="#" onclick="return doclink('link-288', 'check', 'link-281');">check</a></tt> <tt class="py-op">=</tt> <tt class="py-string">''</tt> </tt>
<a name="L2201"></a><tt class="py-lineno">2201</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L2202"></a><tt class="py-lineno">2202</tt> <tt class="py-line"> <tt id="link-289" class="py-name"><a title="configobj.SimpleVal.check" class="py-name" href="#" onclick="return doclink('link-289', 'check', 'link-281');">check</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-290" class="py-name"><a title="configobj.ConfigObj._str" class="py-name" href="#" onclick="return doclink('link-290', '_str', 'link-285');">_str</a></tt><tt class="py-op">(</tt><tt id="link-291" class="py-name"><a title="configobj.SimpleVal.check" class="py-name" href="#" onclick="return doclink('link-291', 'check', 'link-281');">check</a></tt><tt class="py-op">)</tt> </tt>
<a name="L2203"></a><tt class="py-lineno">2203</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt id="link-292" class="py-name"><a title="configobj.SimpleVal.check" class="py-name" href="#" onclick="return doclink('link-292', 'check', 'link-281');">check</a></tt> <tt class="py-op">!=</tt> <tt class="py-name">val</tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> <tt class="py-name">missing</tt><tt class="py-op">:</tt> </tt>
<a name="L2204"></a><tt class="py-lineno">2204</tt> <tt class="py-line"> <tt class="py-name">section</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-293" class="py-name"><a title="configobj.SimpleVal.check" class="py-name" href="#" onclick="return doclink('link-293', 'check', 'link-281');">check</a></tt> </tt>
<a name="L2205"></a><tt class="py-lineno">2205</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">copy</tt> <tt class="py-keyword">and</tt> <tt class="py-name">missing</tt> <tt class="py-keyword">and</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">defaults</tt><tt class="py-op">:</tt> </tt>
<a name="L2206"></a><tt class="py-lineno">2206</tt> <tt class="py-line"> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">defaults</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">entry</tt><tt class="py-op">)</tt> </tt>
<a name="L2207"></a><tt class="py-lineno">2207</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">ret_true</tt><tt class="py-op">,</tt> <tt class="py-name">ret_false</tt> </tt>
</div><a name="L2208"></a><tt class="py-lineno">2208</tt> <tt class="py-line"> </tt>
<a name="L2209"></a><tt class="py-lineno">2209</tt> <tt class="py-line"> <tt class="py-comment">#</tt> </tt>
<a name="L2210"></a><tt class="py-lineno">2210</tt> <tt class="py-line"> <tt class="py-name">out</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
<a name="L2211"></a><tt class="py-lineno">2211</tt> <tt class="py-line"> <tt class="py-name">ret_true</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
<a name="L2212"></a><tt class="py-lineno">2212</tt> <tt class="py-line"> <tt class="py-name">ret_false</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
<a name="L2213"></a><tt class="py-lineno">2213</tt> <tt class="py-line"> </tt>
<a name="L2214"></a><tt class="py-lineno">2214</tt> <tt class="py-line"> <tt class="py-name">unvalidated</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">k</tt> <tt class="py-keyword">for</tt> <tt class="py-name">k</tt> <tt class="py-keyword">in</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt> <tt class="py-keyword">if</tt> <tt class="py-name">k</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">configspec</tt><tt class="py-op">]</tt> </tt>
<a name="L2215"></a><tt class="py-lineno">2215</tt> <tt class="py-line"> <tt class="py-name">incorrect_sections</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">k</tt> <tt class="py-keyword">for</tt> <tt class="py-name">k</tt> <tt class="py-keyword">in</tt> <tt class="py-name">configspec</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt> <tt class="py-keyword">if</tt> <tt class="py-name">k</tt> <tt class="py-keyword">in</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt><tt class="py-op">]</tt> </tt>
<a name="L2216"></a><tt class="py-lineno">2216</tt> <tt class="py-line"> <tt class="py-name">incorrect_scalars</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">k</tt> <tt class="py-keyword">for</tt> <tt class="py-name">k</tt> <tt class="py-keyword">in</tt> <tt class="py-name">configspec</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt> <tt class="py-keyword">if</tt> <tt class="py-name">k</tt> <tt class="py-keyword">in</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">]</tt> </tt>
<a name="L2217"></a><tt class="py-lineno">2217</tt> <tt class="py-line"> </tt>
<a name="L2218"></a><tt class="py-lineno">2218</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">in</tt> <tt class="py-name">configspec</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt><tt class="py-op">:</tt> </tt>
<a name="L2219"></a><tt class="py-lineno">2219</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-string">'__many__'</tt><tt class="py-op">,</tt> <tt class="py-string">'___many___'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L2220"></a><tt class="py-lineno">2220</tt> <tt class="py-line"> <tt class="py-comment"># reserved names</tt> </tt>
<a name="L2221"></a><tt class="py-lineno">2221</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L2222"></a><tt class="py-lineno">2222</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-keyword">not</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">in</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> <tt class="py-op">(</tt><tt class="py-name">entry</tt> <tt class="py-keyword">in</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">defaults</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L2223"></a><tt class="py-lineno">2223</tt> <tt class="py-line"> <tt class="py-comment"># missing entries</tt> </tt>
<a name="L2224"></a><tt class="py-lineno">2224</tt> <tt class="py-line"> <tt class="py-comment"># or entries from defaults</tt> </tt>
<a name="L2225"></a><tt class="py-lineno">2225</tt> <tt class="py-line"> <tt class="py-name">missing</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
<a name="L2226"></a><tt class="py-lineno">2226</tt> <tt class="py-line"> <tt class="py-name">val</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
<a name="L2227"></a><tt class="py-lineno">2227</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">copy</tt> <tt class="py-keyword">and</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt><tt class="py-op">:</tt> </tt>
<a name="L2228"></a><tt class="py-lineno">2228</tt> <tt class="py-line"> <tt class="py-comment"># copy comments</tt> </tt>
<a name="L2229"></a><tt class="py-lineno">2229</tt> <tt class="py-line"> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">comments</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt> </tt>
<a name="L2230"></a><tt class="py-lineno">2230</tt> <tt class="py-line"> <tt class="py-name">configspec</tt><tt class="py-op">.</tt><tt class="py-name">comments</tt><tt class="py-op">.</tt><tt id="link-294" class="py-name"><a title="configobj.Section.get" class="py-name" href="#" onclick="return doclink('link-294', 'get', 'link-5');">get</a></tt><tt class="py-op">(</tt><tt class="py-name">entry</tt><tt class="py-op">,</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
<a name="L2231"></a><tt class="py-lineno">2231</tt> <tt class="py-line"> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">inline_comments</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt> </tt>
<a name="L2232"></a><tt class="py-lineno">2232</tt> <tt class="py-line"> <tt class="py-name">configspec</tt><tt class="py-op">.</tt><tt class="py-name">inline_comments</tt><tt class="py-op">.</tt><tt id="link-295" class="py-name"><a title="configobj.Section.get" class="py-name" href="#" onclick="return doclink('link-295', 'get', 'link-5');">get</a></tt><tt class="py-op">(</tt><tt class="py-name">entry</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
<a name="L2233"></a><tt class="py-lineno">2233</tt> <tt class="py-line"> <tt class="py-comment">#</tt> </tt>
<a name="L2234"></a><tt class="py-lineno">2234</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L2235"></a><tt class="py-lineno">2235</tt> <tt class="py-line"> <tt class="py-name">missing</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L2236"></a><tt class="py-lineno">2236</tt> <tt class="py-line"> <tt class="py-name">val</tt> <tt class="py-op">=</tt> <tt class="py-name">section</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> </tt>
<a name="L2237"></a><tt class="py-lineno">2237</tt> <tt class="py-line"> </tt>
<a name="L2238"></a><tt class="py-lineno">2238</tt> <tt class="py-line"> <tt class="py-name">ret_true</tt><tt class="py-op">,</tt> <tt class="py-name">ret_false</tt> <tt class="py-op">=</tt> <tt class="py-name">validate_entry</tt><tt class="py-op">(</tt><tt class="py-name">entry</tt><tt class="py-op">,</tt> <tt class="py-name">configspec</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">val</tt><tt class="py-op">,</tt> </tt>
<a name="L2239"></a><tt class="py-lineno">2239</tt> <tt class="py-line"> <tt class="py-name">missing</tt><tt class="py-op">,</tt> <tt class="py-name">ret_true</tt><tt class="py-op">,</tt> <tt class="py-name">ret_false</tt><tt class="py-op">)</tt> </tt>
<a name="L2240"></a><tt class="py-lineno">2240</tt> <tt class="py-line"> </tt>
<a name="L2241"></a><tt class="py-lineno">2241</tt> <tt class="py-line"> <tt class="py-name">many</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
<a name="L2242"></a><tt class="py-lineno">2242</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'__many__'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">configspec</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt><tt class="py-op">:</tt> </tt>
<a name="L2243"></a><tt class="py-lineno">2243</tt> <tt class="py-line"> <tt class="py-name">many</tt> <tt class="py-op">=</tt> <tt class="py-name">configspec</tt><tt class="py-op">[</tt><tt class="py-string">'__many__'</tt><tt class="py-op">]</tt> </tt>
<a name="L2244"></a><tt class="py-lineno">2244</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-string">'___many___'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">configspec</tt><tt class="py-op">.</tt><tt class="py-name">scalars</tt><tt class="py-op">:</tt> </tt>
<a name="L2245"></a><tt class="py-lineno">2245</tt> <tt class="py-line"> <tt class="py-name">many</tt> <tt class="py-op">=</tt> <tt class="py-name">configspec</tt><tt class="py-op">[</tt><tt class="py-string">'___many___'</tt><tt class="py-op">]</tt> </tt>
<a name="L2246"></a><tt class="py-lineno">2246</tt> <tt class="py-line"> </tt>
<a name="L2247"></a><tt class="py-lineno">2247</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">many</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L2248"></a><tt class="py-lineno">2248</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">in</tt> <tt class="py-name">unvalidated</tt><tt class="py-op">:</tt> </tt>
<a name="L2249"></a><tt class="py-lineno">2249</tt> <tt class="py-line"> <tt class="py-name">val</tt> <tt class="py-op">=</tt> <tt class="py-name">section</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> </tt>
<a name="L2250"></a><tt class="py-lineno">2250</tt> <tt class="py-line"> <tt class="py-name">ret_true</tt><tt class="py-op">,</tt> <tt class="py-name">ret_false</tt> <tt class="py-op">=</tt> <tt class="py-name">validate_entry</tt><tt class="py-op">(</tt><tt class="py-name">entry</tt><tt class="py-op">,</tt> <tt class="py-name">many</tt><tt class="py-op">,</tt> <tt class="py-name">val</tt><tt class="py-op">,</tt> <tt class="py-name">False</tt><tt class="py-op">,</tt> </tt>
<a name="L2251"></a><tt class="py-lineno">2251</tt> <tt class="py-line"> <tt class="py-name">ret_true</tt><tt class="py-op">,</tt> <tt class="py-name">ret_false</tt><tt class="py-op">)</tt> </tt>
<a name="L2252"></a><tt class="py-lineno">2252</tt> <tt class="py-line"> <tt class="py-name">unvalidated</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L2253"></a><tt class="py-lineno">2253</tt> <tt class="py-line"> </tt>
<a name="L2254"></a><tt class="py-lineno">2254</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">in</tt> <tt class="py-name">incorrect_scalars</tt><tt class="py-op">:</tt> </tt>
<a name="L2255"></a><tt class="py-lineno">2255</tt> <tt class="py-line"> <tt class="py-name">ret_true</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L2256"></a><tt class="py-lineno">2256</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">preserve_errors</tt><tt class="py-op">:</tt> </tt>
<a name="L2257"></a><tt class="py-lineno">2257</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L2258"></a><tt class="py-lineno">2258</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L2259"></a><tt class="py-lineno">2259</tt> <tt class="py-line"> <tt class="py-name">ret_false</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L2260"></a><tt class="py-lineno">2260</tt> <tt class="py-line"> <tt class="py-name">msg</tt> <tt class="py-op">=</tt> <tt class="py-string">'Value %r was provided as a section'</tt> <tt class="py-op">%</tt> <tt class="py-name">entry</tt> </tt>
<a name="L2261"></a><tt class="py-lineno">2261</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">validator</tt><tt class="py-op">.</tt><tt class="py-name">baseErrorClass</tt><tt class="py-op">(</tt><tt class="py-name">msg</tt><tt class="py-op">)</tt> </tt>
<a name="L2262"></a><tt class="py-lineno">2262</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">in</tt> <tt class="py-name">incorrect_sections</tt><tt class="py-op">:</tt> </tt>
<a name="L2263"></a><tt class="py-lineno">2263</tt> <tt class="py-line"> <tt class="py-name">ret_true</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L2264"></a><tt class="py-lineno">2264</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">preserve_errors</tt><tt class="py-op">:</tt> </tt>
<a name="L2265"></a><tt class="py-lineno">2265</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L2266"></a><tt class="py-lineno">2266</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L2267"></a><tt class="py-lineno">2267</tt> <tt class="py-line"> <tt class="py-name">ret_false</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L2268"></a><tt class="py-lineno">2268</tt> <tt class="py-line"> <tt class="py-name">msg</tt> <tt class="py-op">=</tt> <tt class="py-string">'Section %r was provided as a single value'</tt> <tt class="py-op">%</tt> <tt class="py-name">entry</tt> </tt>
<a name="L2269"></a><tt class="py-lineno">2269</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">validator</tt><tt class="py-op">.</tt><tt class="py-name">baseErrorClass</tt><tt class="py-op">(</tt><tt class="py-name">msg</tt><tt class="py-op">)</tt> </tt>
<a name="L2270"></a><tt class="py-lineno">2270</tt> <tt class="py-line"> </tt>
<a name="L2271"></a><tt class="py-lineno">2271</tt> <tt class="py-line"> <tt class="py-comment"># Missing sections will have been created as empty ones when the</tt> </tt>
<a name="L2272"></a><tt class="py-lineno">2272</tt> <tt class="py-line"> <tt class="py-comment"># configspec was read.</tt> </tt>
<a name="L2273"></a><tt class="py-lineno">2273</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">in</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">:</tt> </tt>
<a name="L2274"></a><tt class="py-lineno">2274</tt> <tt class="py-line"> <tt class="py-comment"># FIXME: this means DEFAULT is not copied in copy mode</tt> </tt>
<a name="L2275"></a><tt class="py-lineno">2275</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">section</tt> <tt class="py-keyword">is</tt> <tt class="py-name">self</tt> <tt class="py-keyword">and</tt> <tt class="py-name">entry</tt> <tt class="py-op">==</tt> <tt class="py-string">'DEFAULT'</tt><tt class="py-op">:</tt> </tt>
<a name="L2276"></a><tt class="py-lineno">2276</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L2277"></a><tt class="py-lineno">2277</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">section</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">configspec</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L2278"></a><tt class="py-lineno">2278</tt> <tt class="py-line"> <tt class="py-name">unvalidated</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">entry</tt><tt class="py-op">)</tt> </tt>
<a name="L2279"></a><tt class="py-lineno">2279</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L2280"></a><tt class="py-lineno">2280</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">copy</tt><tt class="py-op">:</tt> </tt>
<a name="L2281"></a><tt class="py-lineno">2281</tt> <tt class="py-line"> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">comments</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">configspec</tt><tt class="py-op">.</tt><tt class="py-name">comments</tt><tt class="py-op">.</tt><tt id="link-296" class="py-name"><a title="configobj.Section.get" class="py-name" href="#" onclick="return doclink('link-296', 'get', 'link-5');">get</a></tt><tt class="py-op">(</tt><tt class="py-name">entry</tt><tt class="py-op">,</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
<a name="L2282"></a><tt class="py-lineno">2282</tt> <tt class="py-line"> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">inline_comments</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">configspec</tt><tt class="py-op">.</tt><tt class="py-name">inline_comments</tt><tt class="py-op">.</tt><tt id="link-297" class="py-name"><a title="configobj.Section.get" class="py-name" href="#" onclick="return doclink('link-297', 'get', 'link-5');">get</a></tt><tt class="py-op">(</tt><tt class="py-name">entry</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt> </tt>
<a name="L2283"></a><tt class="py-lineno">2283</tt> <tt class="py-line"> <tt id="link-298" class="py-name"><a title="configobj.SimpleVal.check" class="py-name" href="#" onclick="return doclink('link-298', 'check', 'link-281');">check</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-299" class="py-name"><a title="configobj.ConfigObj.validate" class="py-name" href="#" onclick="return doclink('link-299', 'validate', 'link-278');">validate</a></tt><tt class="py-op">(</tt><tt class="py-name">validator</tt><tt class="py-op">,</tt> <tt class="py-name">preserve_errors</tt><tt class="py-op">=</tt><tt class="py-name">preserve_errors</tt><tt class="py-op">,</tt> <tt class="py-name">copy</tt><tt class="py-op">=</tt><tt class="py-name">copy</tt><tt class="py-op">,</tt> <tt class="py-name">section</tt><tt class="py-op">=</tt><tt class="py-name">section</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
<a name="L2284"></a><tt class="py-lineno">2284</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-300" class="py-name"><a title="configobj.SimpleVal.check" class="py-name" href="#" onclick="return doclink('link-300', 'check', 'link-281');">check</a></tt> </tt>
<a name="L2285"></a><tt class="py-lineno">2285</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-301" class="py-name"><a title="configobj.SimpleVal.check" class="py-name" href="#" onclick="return doclink('link-301', 'check', 'link-281');">check</a></tt> <tt class="py-op">==</tt> <tt class="py-name">False</tt><tt class="py-op">:</tt> </tt>
<a name="L2286"></a><tt class="py-lineno">2286</tt> <tt class="py-line"> <tt class="py-name">ret_true</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L2287"></a><tt class="py-lineno">2287</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt id="link-302" class="py-name"><a title="configobj.SimpleVal.check" class="py-name" href="#" onclick="return doclink('link-302', 'check', 'link-281');">check</a></tt> <tt class="py-op">==</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt>
<a name="L2288"></a><tt class="py-lineno">2288</tt> <tt class="py-line"> <tt class="py-name">ret_false</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L2289"></a><tt class="py-lineno">2289</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
<a name="L2290"></a><tt class="py-lineno">2290</tt> <tt class="py-line"> <tt class="py-name">ret_true</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L2291"></a><tt class="py-lineno">2291</tt> <tt class="py-line"> </tt>
<a name="L2292"></a><tt class="py-lineno">2292</tt> <tt class="py-line"> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">extra_values</tt> <tt class="py-op">=</tt> <tt class="py-name">unvalidated</tt> </tt>
<a name="L2293"></a><tt class="py-lineno">2293</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">preserve_errors</tt> <tt class="py-keyword">and</tt> <tt class="py-keyword">not</tt> <tt class="py-name">section</tt><tt class="py-op">.</tt><tt class="py-name">_created</tt><tt class="py-op">:</tt> </tt>
<a name="L2294"></a><tt class="py-lineno">2294</tt> <tt class="py-line"> <tt class="py-comment"># If the section wasn't created (i.e. it wasn't missing)</tt> </tt>
<a name="L2295"></a><tt class="py-lineno">2295</tt> <tt class="py-line"> <tt class="py-comment"># then we can't return False, we need to preserve errors</tt> </tt>
<a name="L2296"></a><tt class="py-lineno">2296</tt> <tt class="py-line"> <tt class="py-name">ret_false</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
<a name="L2297"></a><tt class="py-lineno">2297</tt> <tt class="py-line"> <tt class="py-comment">#</tt> </tt>
<a name="L2298"></a><tt class="py-lineno">2298</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">ret_false</tt> <tt class="py-keyword">and</tt> <tt class="py-name">preserve_errors</tt> <tt class="py-keyword">and</tt> <tt class="py-name">out</tt><tt class="py-op">:</tt> </tt>
<a name="L2299"></a><tt class="py-lineno">2299</tt> <tt class="py-line"> <tt class="py-comment"># If we are preserving errors, but all</tt> </tt>
<a name="L2300"></a><tt class="py-lineno">2300</tt> <tt class="py-line"> <tt class="py-comment"># the failures are from missing sections / values</tt> </tt>
<a name="L2301"></a><tt class="py-lineno">2301</tt> <tt class="py-line"> <tt class="py-comment"># then we can return False. Otherwise there is a</tt> </tt>
<a name="L2302"></a><tt class="py-lineno">2302</tt> <tt class="py-line"> <tt class="py-comment"># real failure that we need to preserve.</tt> </tt>
<a name="L2303"></a><tt class="py-lineno">2303</tt> <tt class="py-line"> <tt class="py-name">ret_false</tt> <tt class="py-op">=</tt> <tt class="py-keyword">not</tt> <tt id="link-303" class="py-name"><a title="configobj.any" class="py-name" href="#" onclick="return doclink('link-303', 'any', 'link-13');">any</a></tt><tt class="py-op">(</tt><tt class="py-name">out</tt><tt class="py-op">.</tt><tt id="link-304" class="py-name"><a title="configobj.Section.values" class="py-name" href="#" onclick="return doclink('link-304', 'values', 'link-101');">values</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
<a name="L2304"></a><tt class="py-lineno">2304</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">ret_true</tt><tt class="py-op">:</tt> </tt>
<a name="L2305"></a><tt class="py-lineno">2305</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt>
<a name="L2306"></a><tt class="py-lineno">2306</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">ret_false</tt><tt class="py-op">:</tt> </tt>
<a name="L2307"></a><tt class="py-lineno">2307</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt>
<a name="L2308"></a><tt class="py-lineno">2308</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">out</tt> </tt>
</div><a name="L2309"></a><tt class="py-lineno">2309</tt> <tt class="py-line"> </tt>
<a name="L2310"></a><tt class="py-lineno">2310</tt> <tt class="py-line"> </tt>
<a name="ConfigObj.reset"></a><div id="ConfigObj.reset-def"><a name="L2311"></a><tt class="py-lineno">2311</tt> <a class="py-toggle" href="#" id="ConfigObj.reset-toggle" onclick="return toggle('ConfigObj.reset');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#reset">reset</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj.reset-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj.reset-expanded"><a name="L2312"></a><tt class="py-lineno">2312</tt> <tt class="py-line"> <tt class="py-docstring">"""Clear ConfigObj instance and restore to 'freshly created' state."""</tt> </tt>
<a name="L2313"></a><tt class="py-lineno">2313</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-305" class="py-name"><a title="configobj.Section.clear" class="py-name" href="#" onclick="return doclink('link-305', 'clear', 'link-100');">clear</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L2314"></a><tt class="py-lineno">2314</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-306" class="py-name"><a title="configobj.ConfigObj._initialise
configobj.Section._initialise" class="py-name" href="#" onclick="return doclink('link-306', '_initialise', 'link-75');">_initialise</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L2315"></a><tt class="py-lineno">2315</tt> <tt class="py-line"> <tt class="py-comment"># FIXME: Should be done by '_initialise', but ConfigObj constructor (and reload)</tt> </tt>
<a name="L2316"></a><tt class="py-lineno">2316</tt> <tt class="py-line"> <tt class="py-comment"># requires an empty dictionary</tt> </tt>
<a name="L2317"></a><tt class="py-lineno">2317</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">configspec</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
<a name="L2318"></a><tt class="py-lineno">2318</tt> <tt class="py-line"> <tt class="py-comment"># Just to be sure ;-)</tt> </tt>
<a name="L2319"></a><tt class="py-lineno">2319</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_original_configspec</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
</div><a name="L2320"></a><tt class="py-lineno">2320</tt> <tt class="py-line"> </tt>
<a name="L2321"></a><tt class="py-lineno">2321</tt> <tt class="py-line"> </tt>
<a name="ConfigObj.reload"></a><div id="ConfigObj.reload-def"><a name="L2322"></a><tt class="py-lineno">2322</tt> <a class="py-toggle" href="#" id="ConfigObj.reload-toggle" onclick="return toggle('ConfigObj.reload');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.ConfigObj-class.html#reload">reload</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="ConfigObj.reload-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="ConfigObj.reload-expanded"><a name="L2323"></a><tt class="py-lineno">2323</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L2324"></a><tt class="py-lineno">2324</tt> <tt class="py-line"><tt class="py-docstring"> Reload a ConfigObj from file.</tt> </tt>
<a name="L2325"></a><tt class="py-lineno">2325</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2326"></a><tt class="py-lineno">2326</tt> <tt class="py-line"><tt class="py-docstring"> This method raises a ``ReloadError`` if the ConfigObj doesn't have</tt> </tt>
<a name="L2327"></a><tt class="py-lineno">2327</tt> <tt class="py-line"><tt class="py-docstring"> a filename attribute pointing to a file.</tt> </tt>
<a name="L2328"></a><tt class="py-lineno">2328</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L2329"></a><tt class="py-lineno">2329</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">filename</tt><tt class="py-op">,</tt> <tt class="py-name">basestring</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L2330"></a><tt class="py-lineno">2330</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-307" class="py-name" targets="Class configobj.ReloadError=configobj.ReloadError-class.html"><a title="configobj.ReloadError" class="py-name" href="#" onclick="return doclink('link-307', 'ReloadError', 'link-307');">ReloadError</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L2331"></a><tt class="py-lineno">2331</tt> <tt class="py-line"> </tt>
<a name="L2332"></a><tt class="py-lineno">2332</tt> <tt class="py-line"> <tt class="py-name">filename</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">filename</tt> </tt>
<a name="L2333"></a><tt class="py-lineno">2333</tt> <tt class="py-line"> <tt class="py-name">current_options</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
<a name="L2334"></a><tt class="py-lineno">2334</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">entry</tt> <tt class="py-keyword">in</tt> <tt id="link-308" class="py-name"><a title="configobj.OPTION_DEFAULTS" class="py-name" href="#" onclick="return doclink('link-308', 'OPTION_DEFAULTS', 'link-17');">OPTION_DEFAULTS</a></tt><tt class="py-op">:</tt> </tt>
<a name="L2335"></a><tt class="py-lineno">2335</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">entry</tt> <tt class="py-op">==</tt> <tt class="py-string">'configspec'</tt><tt class="py-op">:</tt> </tt>
<a name="L2336"></a><tt class="py-lineno">2336</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L2337"></a><tt class="py-lineno">2337</tt> <tt class="py-line"> <tt class="py-name">current_options</tt><tt class="py-op">[</tt><tt class="py-name">entry</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">getattr</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">entry</tt><tt class="py-op">)</tt> </tt>
<a name="L2338"></a><tt class="py-lineno">2338</tt> <tt class="py-line"> </tt>
<a name="L2339"></a><tt class="py-lineno">2339</tt> <tt class="py-line"> <tt class="py-name">configspec</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_original_configspec</tt> </tt>
<a name="L2340"></a><tt class="py-lineno">2340</tt> <tt class="py-line"> <tt class="py-name">current_options</tt><tt class="py-op">[</tt><tt class="py-string">'configspec'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">configspec</tt> </tt>
<a name="L2341"></a><tt class="py-lineno">2341</tt> <tt class="py-line"> </tt>
<a name="L2342"></a><tt class="py-lineno">2342</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-309" class="py-name"><a title="configobj.Section.clear" class="py-name" href="#" onclick="return doclink('link-309', 'clear', 'link-100');">clear</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L2343"></a><tt class="py-lineno">2343</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-310" class="py-name"><a title="configobj.ConfigObj._initialise
configobj.Section._initialise" class="py-name" href="#" onclick="return doclink('link-310', '_initialise', 'link-75');">_initialise</a></tt><tt class="py-op">(</tt><tt class="py-name">current_options</tt><tt class="py-op">)</tt> </tt>
<a name="L2344"></a><tt class="py-lineno">2344</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-311" class="py-name"><a title="configobj.ConfigObj._load" class="py-name" href="#" onclick="return doclink('link-311', '_load', 'link-147');">_load</a></tt><tt class="py-op">(</tt><tt class="py-name">filename</tt><tt class="py-op">,</tt> <tt class="py-name">configspec</tt><tt class="py-op">)</tt> </tt>
</div></div><a name="L2345"></a><tt class="py-lineno">2345</tt> <tt class="py-line"> </tt>
<a name="L2346"></a><tt class="py-lineno">2346</tt> <tt class="py-line"> </tt>
<a name="L2347"></a><tt class="py-lineno">2347</tt> <tt class="py-line"> </tt>
<a name="SimpleVal"></a><div id="SimpleVal-def"><a name="L2348"></a><tt class="py-lineno">2348</tt> <a class="py-toggle" href="#" id="SimpleVal-toggle" onclick="return toggle('SimpleVal');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="configobj.SimpleVal-class.html">SimpleVal</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="SimpleVal-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="SimpleVal-expanded"><a name="L2349"></a><tt class="py-lineno">2349</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L2350"></a><tt class="py-lineno">2350</tt> <tt class="py-line"><tt class="py-docstring"> A simple validator.</tt> </tt>
<a name="L2351"></a><tt class="py-lineno">2351</tt> <tt class="py-line"><tt class="py-docstring"> Can be used to check that all members expected are present.</tt> </tt>
<a name="L2352"></a><tt class="py-lineno">2352</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2353"></a><tt class="py-lineno">2353</tt> <tt class="py-line"><tt class="py-docstring"> To use it, provide a configspec with all your members in (the value given</tt> </tt>
<a name="L2354"></a><tt class="py-lineno">2354</tt> <tt class="py-line"><tt class="py-docstring"> will be ignored). Pass an instance of ``SimpleVal`` to the ``validate``</tt> </tt>
<a name="L2355"></a><tt class="py-lineno">2355</tt> <tt class="py-line"><tt class="py-docstring"> method of your ``ConfigObj``. ``validate`` will return ``True`` if all</tt> </tt>
<a name="L2356"></a><tt class="py-lineno">2356</tt> <tt class="py-line"><tt class="py-docstring"> members are present, or a dictionary with True/False meaning</tt> </tt>
<a name="L2357"></a><tt class="py-lineno">2357</tt> <tt class="py-line"><tt class="py-docstring"> present/missing. (Whole missing sections will be replaced with ``False``)</tt> </tt>
<a name="L2358"></a><tt class="py-lineno">2358</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L2359"></a><tt class="py-lineno">2359</tt> <tt class="py-line"> </tt>
<a name="SimpleVal.__init__"></a><div id="SimpleVal.__init__-def"><a name="L2360"></a><tt class="py-lineno">2360</tt> <a class="py-toggle" href="#" id="SimpleVal.__init__-toggle" onclick="return toggle('SimpleVal.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.SimpleVal-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="SimpleVal.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="SimpleVal.__init__-expanded"><a name="L2361"></a><tt class="py-lineno">2361</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">baseErrorClass</tt> <tt class="py-op">=</tt> <tt id="link-312" class="py-name"><a title="configobj.ConfigObjError" class="py-name" href="#" onclick="return doclink('link-312', 'ConfigObjError', 'link-156');">ConfigObjError</a></tt> </tt>
</div><a name="L2362"></a><tt class="py-lineno">2362</tt> <tt class="py-line"> </tt>
<a name="SimpleVal.check"></a><div id="SimpleVal.check-def"><a name="L2363"></a><tt class="py-lineno">2363</tt> <a class="py-toggle" href="#" id="SimpleVal.check-toggle" onclick="return toggle('SimpleVal.check');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj.SimpleVal-class.html#check">check</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">check</tt><tt class="py-op">,</tt> <tt class="py-param">member</tt><tt class="py-op">,</tt> <tt class="py-param">missing</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="SimpleVal.check-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="SimpleVal.check-expanded"><a name="L2364"></a><tt class="py-lineno">2364</tt> <tt class="py-line"> <tt class="py-docstring">"""A dummy check method, always returns the value unchanged."""</tt> </tt>
<a name="L2365"></a><tt class="py-lineno">2365</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">missing</tt><tt class="py-op">:</tt> </tt>
<a name="L2366"></a><tt class="py-lineno">2366</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">baseErrorClass</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L2367"></a><tt class="py-lineno">2367</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">member</tt> </tt>
</div></div><a name="L2368"></a><tt class="py-lineno">2368</tt> <tt class="py-line"> </tt>
<a name="L2369"></a><tt class="py-lineno">2369</tt> <tt class="py-line"> </tt>
<a name="flatten_errors"></a><div id="flatten_errors-def"><a name="L2370"></a><tt class="py-lineno">2370</tt> <a class="py-toggle" href="#" id="flatten_errors-toggle" onclick="return toggle('flatten_errors');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj-module.html#flatten_errors">flatten_errors</a><tt class="py-op">(</tt><tt class="py-param">cfg</tt><tt class="py-op">,</tt> <tt class="py-param">res</tt><tt class="py-op">,</tt> <tt class="py-param">levels</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">results</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="flatten_errors-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="flatten_errors-expanded"><a name="L2371"></a><tt class="py-lineno">2371</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L2372"></a><tt class="py-lineno">2372</tt> <tt class="py-line"><tt class="py-docstring"> An example function that will turn a nested dictionary of results</tt> </tt>
<a name="L2373"></a><tt class="py-lineno">2373</tt> <tt class="py-line"><tt class="py-docstring"> (as returned by ``ConfigObj.validate``) into a flat list.</tt> </tt>
<a name="L2374"></a><tt class="py-lineno">2374</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2375"></a><tt class="py-lineno">2375</tt> <tt class="py-line"><tt class="py-docstring"> ``cfg`` is the ConfigObj instance being checked, ``res`` is the results</tt> </tt>
<a name="L2376"></a><tt class="py-lineno">2376</tt> <tt class="py-line"><tt class="py-docstring"> dictionary returned by ``validate``.</tt> </tt>
<a name="L2377"></a><tt class="py-lineno">2377</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2378"></a><tt class="py-lineno">2378</tt> <tt class="py-line"><tt class="py-docstring"> (This is a recursive function, so you shouldn't use the ``levels`` or</tt> </tt>
<a name="L2379"></a><tt class="py-lineno">2379</tt> <tt class="py-line"><tt class="py-docstring"> ``results`` arguments - they are used by the function.)</tt> </tt>
<a name="L2380"></a><tt class="py-lineno">2380</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2381"></a><tt class="py-lineno">2381</tt> <tt class="py-line"><tt class="py-docstring"> Returns a list of keys that failed. Each member of the list is a tuple::</tt> </tt>
<a name="L2382"></a><tt class="py-lineno">2382</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2383"></a><tt class="py-lineno">2383</tt> <tt class="py-line"><tt class="py-docstring"> ([list of sections...], key, result)</tt> </tt>
<a name="L2384"></a><tt class="py-lineno">2384</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2385"></a><tt class="py-lineno">2385</tt> <tt class="py-line"><tt class="py-docstring"> If ``validate`` was called with ``preserve_errors=False`` (the default)</tt> </tt>
<a name="L2386"></a><tt class="py-lineno">2386</tt> <tt class="py-line"><tt class="py-docstring"> then ``result`` will always be ``False``.</tt> </tt>
<a name="L2387"></a><tt class="py-lineno">2387</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt>
<a name="L2388"></a><tt class="py-lineno">2388</tt> <tt class="py-line"><tt class="py-docstring"> *list of sections* is a flattened list of sections that the key was found</tt> </tt>
<a name="L2389"></a><tt class="py-lineno">2389</tt> <tt class="py-line"><tt class="py-docstring"> in.</tt> </tt>
<a name="L2390"></a><tt class="py-lineno">2390</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2391"></a><tt class="py-lineno">2391</tt> <tt class="py-line"><tt class="py-docstring"> If the section was missing (or a section was expected and a scalar provided</tt> </tt>
<a name="L2392"></a><tt class="py-lineno">2392</tt> <tt class="py-line"><tt class="py-docstring"> - or vice-versa) then key will be ``None``.</tt> </tt>
<a name="L2393"></a><tt class="py-lineno">2393</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2394"></a><tt class="py-lineno">2394</tt> <tt class="py-line"><tt class="py-docstring"> If the value (or section) was missing then ``result`` will be ``False``.</tt> </tt>
<a name="L2395"></a><tt class="py-lineno">2395</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2396"></a><tt class="py-lineno">2396</tt> <tt class="py-line"><tt class="py-docstring"> If ``validate`` was called with ``preserve_errors=True`` and a value</tt> </tt>
<a name="L2397"></a><tt class="py-lineno">2397</tt> <tt class="py-line"><tt class="py-docstring"> was present, but failed the check, then ``result`` will be the exception</tt> </tt>
<a name="L2398"></a><tt class="py-lineno">2398</tt> <tt class="py-line"><tt class="py-docstring"> object returned. You can use this as a string that describes the failure.</tt> </tt>
<a name="L2399"></a><tt class="py-lineno">2399</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2400"></a><tt class="py-lineno">2400</tt> <tt class="py-line"><tt class="py-docstring"> For example *The value "3" is of the wrong type*.</tt> </tt>
<a name="L2401"></a><tt class="py-lineno">2401</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L2402"></a><tt class="py-lineno">2402</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">levels</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt>
<a name="L2403"></a><tt class="py-lineno">2403</tt> <tt class="py-line"> <tt class="py-comment"># first time called</tt> </tt>
<a name="L2404"></a><tt class="py-lineno">2404</tt> <tt class="py-line"> <tt class="py-name">levels</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L2405"></a><tt class="py-lineno">2405</tt> <tt class="py-line"> <tt class="py-name">results</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L2406"></a><tt class="py-lineno">2406</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">res</tt> <tt class="py-op">==</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt>
<a name="L2407"></a><tt class="py-lineno">2407</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">results</tt> </tt>
<a name="L2408"></a><tt class="py-lineno">2408</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">res</tt> <tt class="py-op">==</tt> <tt class="py-name">False</tt> <tt class="py-keyword">or</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">res</tt><tt class="py-op">,</tt> <tt class="py-name">Exception</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L2409"></a><tt class="py-lineno">2409</tt> <tt class="py-line"> <tt class="py-name">results</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-name">levels</tt><tt class="py-op">[</tt><tt class="py-op">:</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-name">res</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
<a name="L2410"></a><tt class="py-lineno">2410</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">levels</tt><tt class="py-op">:</tt> </tt>
<a name="L2411"></a><tt class="py-lineno">2411</tt> <tt class="py-line"> <tt class="py-name">levels</tt><tt class="py-op">.</tt><tt id="link-313" class="py-name"><a title="configobj.Section.pop" class="py-name" href="#" onclick="return doclink('link-313', 'pop', 'link-280');">pop</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L2412"></a><tt class="py-lineno">2412</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">results</tt> </tt>
<a name="L2413"></a><tt class="py-lineno">2413</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">val</tt><tt class="py-op">)</tt> <tt class="py-keyword">in</tt> <tt class="py-name">res</tt><tt class="py-op">.</tt><tt id="link-314" class="py-name"><a title="configobj.Section.items" class="py-name" href="#" onclick="return doclink('link-314', 'items', 'link-102');">items</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L2414"></a><tt class="py-lineno">2414</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">val</tt> <tt class="py-op">==</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt>
<a name="L2415"></a><tt class="py-lineno">2415</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L2416"></a><tt class="py-lineno">2416</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">cfg</tt><tt class="py-op">.</tt><tt id="link-315" class="py-name"><a title="configobj.Section.get" class="py-name" href="#" onclick="return doclink('link-315', 'get', 'link-5');">get</a></tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt id="link-316" class="py-name"><a title="configobj.Section.dict" class="py-name" href="#" onclick="return doclink('link-316', 'dict', 'link-68');">dict</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
<a name="L2417"></a><tt class="py-lineno">2417</tt> <tt class="py-line"> <tt class="py-comment"># Go down one level</tt> </tt>
<a name="L2418"></a><tt class="py-lineno">2418</tt> <tt class="py-line"> <tt class="py-name">levels</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">)</tt> </tt>
<a name="L2419"></a><tt class="py-lineno">2419</tt> <tt class="py-line"> <tt id="link-317" class="py-name" targets="Function configobj.flatten_errors()=configobj-module.html#flatten_errors"><a title="configobj.flatten_errors" class="py-name" href="#" onclick="return doclink('link-317', 'flatten_errors', 'link-317');">flatten_errors</a></tt><tt class="py-op">(</tt><tt class="py-name">cfg</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">val</tt><tt class="py-op">,</tt> <tt class="py-name">levels</tt><tt class="py-op">,</tt> <tt class="py-name">results</tt><tt class="py-op">)</tt> </tt>
<a name="L2420"></a><tt class="py-lineno">2420</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
<a name="L2421"></a><tt class="py-lineno">2421</tt> <tt class="py-line"> <tt class="py-name">results</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-name">levels</tt><tt class="py-op">[</tt><tt class="py-op">:</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">val</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
<a name="L2422"></a><tt class="py-lineno">2422</tt> <tt class="py-line"> <tt class="py-comment">#</tt> </tt>
<a name="L2423"></a><tt class="py-lineno">2423</tt> <tt class="py-line"> <tt class="py-comment"># Go up one level</tt> </tt>
<a name="L2424"></a><tt class="py-lineno">2424</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">levels</tt><tt class="py-op">:</tt> </tt>
<a name="L2425"></a><tt class="py-lineno">2425</tt> <tt class="py-line"> <tt class="py-name">levels</tt><tt class="py-op">.</tt><tt id="link-318" class="py-name"><a title="configobj.Section.pop" class="py-name" href="#" onclick="return doclink('link-318', 'pop', 'link-280');">pop</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
<a name="L2426"></a><tt class="py-lineno">2426</tt> <tt class="py-line"> <tt class="py-comment">#</tt> </tt>
<a name="L2427"></a><tt class="py-lineno">2427</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">results</tt> </tt>
</div><a name="L2428"></a><tt class="py-lineno">2428</tt> <tt class="py-line"> </tt>
<a name="L2429"></a><tt class="py-lineno">2429</tt> <tt class="py-line"> </tt>
<a name="get_extra_values"></a><div id="get_extra_values-def"><a name="L2430"></a><tt class="py-lineno">2430</tt> <a class="py-toggle" href="#" id="get_extra_values-toggle" onclick="return toggle('get_extra_values');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="configobj-module.html#get_extra_values">get_extra_values</a><tt class="py-op">(</tt><tt class="py-param">conf</tt><tt class="py-op">,</tt> <tt class="py-param">_prepend</tt><tt class="py-op">=</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="get_extra_values-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="get_extra_values-expanded"><a name="L2431"></a><tt class="py-lineno">2431</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt>
<a name="L2432"></a><tt class="py-lineno">2432</tt> <tt class="py-line"><tt class="py-docstring"> Find all the values and sections not in the configspec from a validated</tt> </tt>
<a name="L2433"></a><tt class="py-lineno">2433</tt> <tt class="py-line"><tt class="py-docstring"> ConfigObj.</tt> </tt>
<a name="L2434"></a><tt class="py-lineno">2434</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2435"></a><tt class="py-lineno">2435</tt> <tt class="py-line"><tt class="py-docstring"> ``get_extra_values`` returns a list of tuples where each tuple represents</tt> </tt>
<a name="L2436"></a><tt class="py-lineno">2436</tt> <tt class="py-line"><tt class="py-docstring"> either an extra section, or an extra value.</tt> </tt>
<a name="L2437"></a><tt class="py-lineno">2437</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2438"></a><tt class="py-lineno">2438</tt> <tt class="py-line"><tt class="py-docstring"> The tuples contain two values, a tuple representing the section the value </tt> </tt>
<a name="L2439"></a><tt class="py-lineno">2439</tt> <tt class="py-line"><tt class="py-docstring"> is in and the name of the extra values. For extra values in the top level</tt> </tt>
<a name="L2440"></a><tt class="py-lineno">2440</tt> <tt class="py-line"><tt class="py-docstring"> section the first member will be an empty tuple. For values in the 'foo'</tt> </tt>
<a name="L2441"></a><tt class="py-lineno">2441</tt> <tt class="py-line"><tt class="py-docstring"> section the first member will be ``('foo',)``. For members in the 'bar'</tt> </tt>
<a name="L2442"></a><tt class="py-lineno">2442</tt> <tt class="py-line"><tt class="py-docstring"> subsection of the 'foo' section the first member will be ``('foo', 'bar')``.</tt> </tt>
<a name="L2443"></a><tt class="py-lineno">2443</tt> <tt class="py-line"><tt class="py-docstring"> </tt> </tt>
<a name="L2444"></a><tt class="py-lineno">2444</tt> <tt class="py-line"><tt class="py-docstring"> NOTE: If you call ``get_extra_values`` on a ConfigObj instance that hasn't</tt> </tt>
<a name="L2445"></a><tt class="py-lineno">2445</tt> <tt class="py-line"><tt class="py-docstring"> been validated it will return an empty list.</tt> </tt>
<a name="L2446"></a><tt class="py-lineno">2446</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
<a name="L2447"></a><tt class="py-lineno">2447</tt> <tt class="py-line"> <tt class="py-name">out</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
<a name="L2448"></a><tt class="py-lineno">2448</tt> <tt class="py-line"> </tt>
<a name="L2449"></a><tt class="py-lineno">2449</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">.</tt><tt class="py-name">extend</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-op">(</tt><tt class="py-name">_prepend</tt><tt class="py-op">,</tt> <tt class="py-name">name</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt class="py-name">conf</tt><tt class="py-op">.</tt><tt class="py-name">extra_values</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
<a name="L2450"></a><tt class="py-lineno">2450</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">name</tt> <tt class="py-keyword">in</tt> <tt class="py-name">conf</tt><tt class="py-op">.</tt><tt class="py-name">sections</tt><tt class="py-op">:</tt> </tt>
<a name="L2451"></a><tt class="py-lineno">2451</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">name</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">conf</tt><tt class="py-op">.</tt><tt class="py-name">extra_values</tt><tt class="py-op">:</tt> </tt>
<a name="L2452"></a><tt class="py-lineno">2452</tt> <tt class="py-line"> <tt class="py-name">out</tt><tt class="py-op">.</tt><tt class="py-name">extend</tt><tt class="py-op">(</tt><tt id="link-319" class="py-name" targets="Function configobj.get_extra_values()=configobj-module.html#get_extra_values"><a title="configobj.get_extra_values" class="py-name" href="#" onclick="return doclink('link-319', 'get_extra_values', 'link-319');">get_extra_values</a></tt><tt class="py-op">(</tt><tt class="py-name">conf</tt><tt class="py-op">[</tt><tt class="py-name">name</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">_prepend</tt> <tt class="py-op">+</tt> <tt class="py-op">(</tt><tt class="py-name">name</tt><tt class="py-op">,</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
<a name="L2453"></a><tt class="py-lineno">2453</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">out</tt> </tt>
</div><a name="L2454"></a><tt class="py-lineno">2454</tt> <tt class="py-line"> </tt>
<a name="L2455"></a><tt class="py-lineno">2455</tt> <tt class="py-line"> </tt>
<a name="L2456"></a><tt class="py-lineno">2456</tt> <tt class="py-line"><tt class="py-string">"""*A programming language is a medium of expression.* - Paul Graham"""</tt> </tt>
<a name="L2457"></a><tt class="py-lineno">2457</tt> <tt class="py-line"> </tt><script type="text/javascript">
<!--
expandto(location.href);
// -->
</script>
</pre>
<br />
<!-- ==================== NAVIGATION BAR ==================== -->
<table class="navbar" border="0" width="100%" cellpadding="0"
bgcolor="#a0c0ff" cellspacing="0">
<tr valign="middle">
<!-- Home link -->
<th bgcolor="#70b0f0" class="navbar-select"
> Home </th>
<!-- Tree link -->
<th> <a
href="module-tree.html">Trees</a> </th>
<!-- Index link -->
<th> <a
href="identifier-index.html">Indices</a> </th>
<!-- Help link -->
<th> <a
href="help.html">Help</a> </th>
<!-- Project homepage -->
<th class="navbar" align="right" width="100%">
<table border="0" cellpadding="0" cellspacing="0">
<tr><th class="navbar" align="center"
><a class="navbar" target="_top" href="http://www.voidspace.org.uk/python/configobj.html">ConfigObj</a></th>
</tr></table></th>
</tr>
</table>
<table border="0" cellpadding="0" cellspacing="0" width="100%%">
<tr>
<td align="left" class="footer">
Generated by Epydoc 3.0.1 on Thu May 3 14:56:24 2012
</td>
<td align="right" class="footer">
<a target="mainFrame" href="http://epydoc.sourceforge.net"
>http://epydoc.sourceforge.net</a>
</td>
</tr>
</table>
<script type="text/javascript">
<!--
// Private objects are initially displayed (because if
// javascript is turned off then we want them to be
// visible); but by default, we want to hide them. So hide
// them unless we have a cookie that says to show them.
checkCookie();
// -->
</script>
</body>
</html>
|