/usr/share/doc/python-hypothesis/html/changes.html is in python-hypothesis-doc 3.44.1-2ubuntu1.
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 2645 2646 2647 2648 2649 2650 2651 2652 2653 2654 2655 2656 2657 2658 2659 2660 2661 2662 2663 2664 2665 2666 2667 2668 2669 2670 2671 2672 2673 2674 2675 2676 2677 2678 2679 2680 2681 2682 2683 2684 2685 2686 2687 2688 2689 2690 2691 2692 2693 2694 2695 2696 2697 2698 2699 2700 2701 2702 2703 2704 2705 2706 2707 2708 2709 2710 2711 2712 2713 2714 2715 2716 2717 2718 2719 2720 2721 2722 2723 2724 2725 2726 2727 2728 2729 2730 2731 2732 2733 2734 2735 2736 2737 2738 2739 2740 2741 2742 2743 2744 2745 2746 2747 2748 2749 2750 2751 2752 2753 2754 2755 2756 2757 2758 2759 2760 2761 2762 2763 2764 2765 2766 2767 2768 2769 2770 2771 2772 2773 2774 2775 2776 2777 2778 2779 2780 2781 2782 2783 2784 2785 2786 2787 2788 2789 2790 2791 2792 2793 2794 2795 2796 2797 2798 2799 2800 2801 2802 2803 2804 2805 2806 2807 2808 2809 2810 2811 2812 2813 2814 2815 2816 2817 2818 2819 2820 2821 2822 2823 2824 2825 2826 2827 2828 2829 2830 2831 2832 2833 2834 2835 2836 2837 2838 2839 2840 2841 2842 2843 2844 2845 2846 2847 2848 2849 2850 2851 2852 2853 2854 2855 2856 2857 2858 2859 2860 2861 2862 2863 2864 2865 2866 2867 2868 2869 2870 2871 2872 2873 2874 2875 2876 2877 2878 2879 2880 2881 2882 2883 2884 2885 2886 2887 2888 2889 2890 2891 2892 2893 2894 2895 2896 2897 2898 2899 2900 2901 2902 2903 2904 2905 2906 2907 2908 2909 2910 2911 2912 2913 2914 2915 2916 2917 2918 2919 2920 2921 2922 2923 2924 2925 2926 2927 2928 2929 2930 2931 2932 2933 2934 2935 2936 2937 2938 2939 2940 2941 2942 2943 2944 2945 2946 2947 2948 2949 2950 2951 2952 2953 2954 2955 2956 2957 2958 2959 2960 2961 2962 2963 2964 2965 2966 2967 2968 2969 2970 2971 2972 2973 2974 2975 2976 2977 2978 2979 2980 2981 2982 2983 2984 2985 2986 2987 2988 2989 2990 2991 2992 2993 2994 2995 2996 2997 2998 2999 3000 3001 3002 3003 3004 3005 3006 3007 3008 3009 3010 3011 3012 3013 3014 3015 3016 3017 3018 3019 3020 3021 3022 3023 3024 3025 3026 3027 3028 3029 3030 3031 3032 3033 3034 3035 3036 3037 3038 3039 3040 3041 3042 3043 3044 3045 3046 3047 3048 3049 3050 3051 3052 3053 3054 3055 3056 3057 3058 3059 3060 3061 3062 3063 3064 3065 3066 3067 3068 3069 3070 3071 3072 3073 3074 3075 3076 3077 3078 3079 3080 3081 3082 3083 3084 3085 3086 3087 3088 3089 3090 3091 3092 3093 3094 3095 3096 | <!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Changelog — Hypothesis 3.44.1 documentation</title>
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<link rel="index" title="Index"
href="genindex.html"/>
<link rel="search" title="Search" href="search.html"/>
<link rel="top" title="Hypothesis 3.44.1 documentation" href="index.html"/>
<link rel="next" title="Ongoing Hypothesis Development" href="development.html"/>
<link rel="prev" title="Projects extending Hypothesis" href="strategies.html"/>
<script src="_static/js/modernizr.min.js"></script>
</head>
<body class="wy-body-for-nav" role="document">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search">
<a href="index.html" class="icon icon-home"> Hypothesis
</a>
<div class="version">
3.44.1
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="quickstart.html">Quick start guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="details.html">Details and advanced features</a></li>
<li class="toctree-l1"><a class="reference internal" href="settings.html">Settings</a></li>
<li class="toctree-l1"><a class="reference internal" href="data.html">What you can generate and how</a></li>
<li class="toctree-l1"><a class="reference internal" href="extras.html">Additional packages</a></li>
<li class="toctree-l1"><a class="reference internal" href="django.html">Hypothesis for Django users</a></li>
<li class="toctree-l1"><a class="reference internal" href="numpy.html">Hypothesis for the Scientific Stack</a></li>
<li class="toctree-l1"><a class="reference internal" href="healthchecks.html">Health checks</a></li>
<li class="toctree-l1"><a class="reference internal" href="database.html">The Hypothesis Example Database</a></li>
<li class="toctree-l1"><a class="reference internal" href="stateful.html">Stateful testing</a></li>
<li class="toctree-l1"><a class="reference internal" href="supported.html">Compatibility</a></li>
<li class="toctree-l1"><a class="reference internal" href="examples.html">Some more examples</a></li>
<li class="toctree-l1"><a class="reference internal" href="community.html">Community</a></li>
<li class="toctree-l1"><a class="reference internal" href="manifesto.html">The Purpose of Hypothesis</a></li>
<li class="toctree-l1"><a class="reference internal" href="endorsements.html">Testimonials</a></li>
<li class="toctree-l1"><a class="reference internal" href="usage.html">Open Source Projects using Hypothesis</a></li>
<li class="toctree-l1"><a class="reference internal" href="strategies.html">Projects extending Hypothesis</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">Changelog</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#id1">3.44.1 - 2017-12-18</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id2">3.44.0 - 2017-12-17</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id3">3.43.1 - 2017-12-17</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id4">3.43.0 - 2017-12-17</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id5">3.42.2 - 2017-12-12</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id6">3.42.1 - 2017-12-10</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id7">3.42.0 - 2017-12-09</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id8">3.41.0 - 2017-12-06</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id9">3.40.1 - 2017-12-04</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id10">3.40.0 - 2017-12-02</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id12">3.39.0 - 2017-12-01</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id14">3.38.9 - 2017-11-29</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id15">3.38.8 - 2017-11-29</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id17">3.38.7 - 2017-11-29</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id18">3.38.6 - 2017-11-28</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id19">3.38.5 - 2017-11-23</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id20">3.38.4 - 2017-11-22</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id22">3.38.3 - 2017-11-21</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id23">3.38.2 - 2017-11-21</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id25">3.38.1 - 2017-11-21</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id26">3.38.0 - 2017-11-18</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id28">3.37.0 - 2017-11-12</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id30">3.36.1 - 2017-11-10</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id31">3.36.0 - 2017-11-06</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id32">3.35.0 - 2017-11-06</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id33">3.34.1 - 2017-11-02</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id34">3.34.0 - 2017-11-02</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id35">3.33.1 - 2017-11-02</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id36">3.33.0 - 2017-10-16</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id37">3.32.2 - 2017-10-15</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id38">3.32.1 - 2017-10-13</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id39">3.32.0 - 2017-10-09</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id40">3.31.6 - 2017-10-08</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id41">3.31.5 - 2017-10-08</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id42">3.31.4 - 2017-10-08</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id43">3.31.3 - 2017-10-06</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id44">3.31.2 - 2017-09-30</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id45">3.31.1 - 2017-09-30</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id47">3.31.0 - 2017-09-29</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id48">3.30.4 - 2017-09-27</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id49">3.30.3 - 2017-09-25</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id50">3.30.2 - 2017-09-24</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id51">3.30.1 - 2017-09-22</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id52">3.30.0 - 2017-09-20</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id54">3.29.0 - 2017-09-19</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id55">3.28.3 - 2017-09-18</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id56">3.28.2 - 2017-09-18</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id57">3.28.1 - 2017-09-16</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id58">3.28.0 - 2017-09-15</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id59">3.27.1 - 2017-09-14</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id60">3.27.0 - 2017-09-13</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id62">3.26.0 - 2017-09-12</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id63">3.25.1 - 2017-09-12</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id64">3.25.0 - 2017-09-12</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id65">3.24.2 - 2017-09-11</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id66">3.24.1 - 2017-09-06</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id67">3.24.0 - 2017-09-05</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id68">3.23.3 - 2017-09-05</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id69">3.23.2 - 2017-09-01</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id70">3.23.1 - 2017-09-01</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id71">3.23.0 - 2017-08-31</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id72">3.22.2 - 2017-08-29</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id73">3.22.1 - 2017-08-28</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id74">3.22.0 - 2017-08-26</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id76">3.21.3 - 2017-08-26</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id77">3.21.2 - 2017-08-25</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id78">3.21.1 - 2017-08-24</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id79">3.21.0 - 2017-08-23</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id80">3.20.0 - 2017-08-22</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id81">3.19.3 - 2017-08-22</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id82">3.19.2 - 2017-08-21</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id83">3.19.1 - 2017-08-21</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id84">3.19.0 - 2017-08-20</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id85">3.18.5 - 2017-08-18</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id86">3.18.4 - 2017-08-18</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id87">3.18.3 - 2017-08-17</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id88">3.18.2 - 2017-08-16</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id89">3.18.1 - 2017-08-14</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id90">3.18.0 - 2017-08-13</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id91">3.17.0 - 2017-08-07</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id92">3.16.1 - 2017-08-07</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id93">3.16.0 - 2017-08-04</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id94">3.15.0 - 2017-08-04</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id95">3.14.2 - 2017-08-03</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id96">3.14.1 - 2017-08-02</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id97">3.14.0 - 2017-07-23</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id98">3.13.1 - 2017-07-20</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id99">3.13.0 - 2017-07-16</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id100">3.12.0 - 2017-07-07</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id101">3.11.6 - 2017-06-19</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id102">3.11.5 - 2017-06-18</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id103">3.11.4 - 2017-06-17</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id104">3.11.3 - 2017-06-11</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id105">3.11.2 - 2017-06-10</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id106">3.11.1 - 2017-05-28</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id107">3.11.0 - 2017-05-23</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id108">3.10.0 - 2017-05-22</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id109">3.9.1 - 2017-05-22</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id110">3.9.0 - 2017-05-19</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id111">3.8.5 - 2017-05-16</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id112">3.8.4 - 2017-05-16</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id113">3.8.3 - 2017-05-09</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id114">3.8.2 - 2017-04-26</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id115">3.8.1 - 2017-04-26</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id116">3.8.0 - 2017-04-23</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id117">3.7.4 - 2017-04-22</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id118">3.7.3 - 2017-04-21</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id119">3.7.2 - 2017-04-21</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id120">3.7.1 - 2017-04-21</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id121">3.7.0 - 2017-03-20</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id122">3.6.1 - 2016-12-20</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id123">3.6.0 - 2016-10-31</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id124">3.5.3 - 2016-10-05</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id125">3.5.2 - 2016-09-24</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id126">3.5.1 - 2016-09-23</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id127">3.5.0 - 2016-09-22</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id128">3.4.2 - 2016-07-13</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id129">3.4.1 - 2016-07-07</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id130">3.4.0 - 2016-05-27</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id131">3.3.0 - 2016-05-27</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id132">3.2.0 - 2016-05-19</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id133">3.1.3 - 2016-05-01</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id134">3.1.2 - 2016-04-30</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id135">3.1.1 - 2016-04-29</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id136">3.1.0 - 2016-03-06</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id137">3.0.5 - 2016-02-25</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id138">3.0.4 - 2016-02-24</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id139">3.0.3 - 2016-02-23</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id140">3.0.2 - 2016-02-18</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id141">3.0.1 - 2016-02-18</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id142">3.0.0 - 2016-02-17</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id143">2.0.0 - 2016-01-10</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id144">1.19.0 - 2016-01-09</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id146">1.18.1 - 2015-12-22</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id148">1.18.0 - 2015-12-21</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id150">1.17.1 - 2015-12-16</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id152">1.17.0 - 2015-12-15</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id154">1.16.1 - 2015-12-14</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id156">1.16.0 - 2015-12-08</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id158">1.15.0 - 2015-11-24</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id160">1.14.0 - 2015-11-01</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id162">1.13.0 - 2015-10-29</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id164">1.12.0 - 2015-10-18</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id166">1.11.4 - 2015-09-27</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id168">1.11.3 - 2015-09-23</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id170">1.11.2 - 2015-09-23</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id172">1.11.1 - 2015-09-16</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id174">1.11.0 - 2015-08-31</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id176">1.10.6 - 2015-08-26</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id177">1.10.4 - 2015-08-21</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id179">1.10.3 - 2015-08-19</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id181">1.10.2 - 2015-08-19</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id183">1.10.0 - 2015-08-04</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id185">1.9.0 - 2015-07-27</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id187">1.8.5 - 2015-07-24</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id189">1.8.4 - 2015-07-20</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id191">1.8.3 - 2015-07-20</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id193">1.8.2 - 2015-07-18</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id194">1.8.1 - 2015-07-17</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id196">1.8.0 - 2015-07-16</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id198">1.7.2 - 2015-07-10</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id200">1.7.1 - 2015-06-29</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id201">1.6.2 - 2015-06-08</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id202">1.6.1 - 2015-05-21</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id204">1.6.0 - 2015-05-21</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id206">1.5.0 - 2015-05-14</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id208">1.4.0 - 2015-05-04</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id210">1.3.0 - 2015-05-22</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id212">1.2.1 - 2015-04-16</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id214">1.2.0 - 2015-04-15</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id216">1.1.1 - 2015-04-07</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id218">1.1.0 - 2015-04-06</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id220">1.0.0 - 2015-03-27</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id221">0.9.2 - 2015-03-26</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id222">0.9.1 - 2015-03-25</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id223">0.9.0 - 2015-03-23</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id224">0.7.2 - 2015-03-22</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id225">0.7.1 - 2015-03-21</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id226">0.7.0, - 2015-03-20</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id227">0.6.0 - 2015-03-13</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id228">0.5.0 - 2015-02-10</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id229">0.4.3 - 2015-02-05</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id230">0.4.2 - 2015-02-04</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id231">0.4.1 - 2015-02-03</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id232">0.4.0 - 2015-01-21</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id233">0.3.2 - 2015-01-16</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id234">0.3.1 - 2015-01-13</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id235">0.3.0 - 2015-01-12</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id236">0.2.2 - 2015-01-08</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id237">0.2.1 - 2015-01-07</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id238">0.2.0 - 2015-01-07</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id239">0.1.4 - 2013-12-14</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id240">0.1.3 - 2013-05-03</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id241">0.1.2 - 2013-03-24</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id242">0.1.1 - 2013-03-24</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id243">0.1.0 - 2013-03-23</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id244">0.0.5 - 2013-03-13</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id245">0.0.4 - 2013-03-13</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id246">0.0.3 - 2013-03-13</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id247">0.0.2 - 2013-03-12</a></li>
<li class="toctree-l2"><a class="reference internal" href="#id248">0.0.1 - 2013-03-10</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="development.html">Ongoing Hypothesis Development</a></li>
<li class="toctree-l1"><a class="reference internal" href="support.html">Help and Support</a></li>
<li class="toctree-l1"><a class="reference internal" href="packaging.html">Packaging Guidelines</a></li>
<li class="toctree-l1"><a class="reference internal" href="reproducing.html">Reproducing Failures</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" role="navigation" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">Hypothesis</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html">Docs</a> »</li>
<li>Changelog</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/changes.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<div class="section" id="changelog">
<h1>Changelog<a class="headerlink" href="#changelog" title="Permalink to this headline">¶</a></h1>
<p>This is a record of all past Hypothesis releases and what went into them,
in reverse chronological order. All previous releases should still be available
on pip.</p>
<p>Hypothesis APIs come in three flavours:</p>
<ul class="simple">
<li>Public: Hypothesis releases since 1.0 are <a class="reference external" href="https://semver.org/">semantically versioned</a>
with respect to these parts of the API. These will not break except between
major version bumps. All APIs mentioned in this documentation are public unless
explicitly noted otherwise.</li>
<li>Semi-public: These are APIs that are considered ready to use but are not wholly
nailed down yet. They will not break in patch releases and will <em>usually</em> not break
in minor releases, but when necessary minor releases may break semi-public APIs.</li>
<li>Internal: These may break at any time and you really should not use them at
all.</li>
</ul>
<p>You should generally assume that an API is internal unless you have specific
information to the contrary.</p>
<div class="section" id="id1">
<h2>3.44.1 - 2017-12-18<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
<p>This release fixes <a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/997">issue #997</a>, in which under some circumstances the body of
tests run under Hypothesis would not show up when run under coverage even
though the tests were run and the code they called outside of the test file
would show up normally.</p>
</div>
<div class="section" id="id2">
<h2>3.44.0 - 2017-12-17<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
<p>This release adds a new feature: The <a class="reference internal" href="reproducing.html#reproduce-failure"><span class="std std-ref">@reproduce_failure</span></a>,
designed to make it easy to use Hypothesis’s binary format for examples to
reproduce a problem locally without having to share your example database
between machines.</p>
<p>This also changes when seeds are printed:</p>
<ul class="simple">
<li>They will no longer be printed for
normal falsifying examples, as there are now adequate ways of reproducing those
for all cases, so it just contributes noise.</li>
<li>They will once again be printed when reusing examples from the database, as
health check failures should now be more reliable in this scenario so it will
almost always work in this case.</li>
</ul>
<p>This work was funded by <a class="reference external" href="https://smarkets.com/">Smarkets</a>.</p>
</div>
<div class="section" id="id3">
<h2>3.43.1 - 2017-12-17<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h2>
<p>This release fixes a bug with Hypothesis’s database management - examples that
were found in the course of shrinking were saved in a way that indicated that
they had distinct causes, and so they would all be retried on the start of the
next test. The intended behaviour, which is now what is implemented, is that
only a bounded subset of these examples would be retried.</p>
</div>
<div class="section" id="id4">
<h2>3.43.0 - 2017-12-17<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h2>
<p><code class="xref py py-exc docutils literal"><span class="pre">HypothesisDeprecationWarning</span></code> now inherits from
<code class="xref py py-exc docutils literal"><span class="pre">python:FutureWarning</span></code> instead of <code class="xref py py-exc docutils literal"><span class="pre">python:DeprecationWarning</span></code>,
as recommended by <span class="target" id="index-0"></span><a class="pep reference external" href="https://www.python.org/dev/peps/pep-0565"><strong>PEP 565</strong></a> for user-facing warnings (<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/618">issue #618</a>).
If you have not changed the default warnings settings, you will now see
each distinct <code class="xref py py-exc docutils literal"><span class="pre">HypothesisDeprecationWarning</span></code>
instead of only the first.</p>
</div>
<div class="section" id="id5">
<h2>3.42.2 - 2017-12-12<a class="headerlink" href="#id5" title="Permalink to this headline">¶</a></h2>
<p>This patch fixes <a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/1017">issue #1017</a>, where instances of a list or tuple subtype
used as an argument to a strategy would be coerced to tuple.</p>
</div>
<div class="section" id="id6">
<h2>3.42.1 - 2017-12-10<a class="headerlink" href="#id6" title="Permalink to this headline">¶</a></h2>
<p>This release has some internal cleanup, which makes reading the code
more pleasant and may shrink large examples slightly faster.</p>
</div>
<div class="section" id="id7">
<h2>3.42.0 - 2017-12-09<a class="headerlink" href="#id7" title="Permalink to this headline">¶</a></h2>
<p>This release deprecates <a class="reference internal" href="extras.html#faker-extra"><span class="std std-ref">hypothesis[fakefactory]</span></a>, which was designed as a transition
strategy but does not support example shrinking or coverage-guided discovery.</p>
</div>
<div class="section" id="id8">
<h2>3.41.0 - 2017-12-06<a class="headerlink" href="#id8" title="Permalink to this headline">¶</a></h2>
<p><a class="reference internal" href="data.html#hypothesis.strategies.sampled_from" title="hypothesis.strategies.sampled_from"><code class="xref py py-func docutils literal"><span class="pre">sampled_from()</span></code></a> can now sample from
one-dimensional numpy ndarrays. Sampling from multi-dimensional
ndarrays still results in a deprecation warning. Thanks to Charlie
Tanksley for this patch.</p>
</div>
<div class="section" id="id9">
<h2>3.40.1 - 2017-12-04<a class="headerlink" href="#id9" title="Permalink to this headline">¶</a></h2>
<p>This release makes two changes:</p>
<ul class="simple">
<li>It makes the calculation of some of the metadata that Hypothesis uses for
shrinking occur lazily. This should speed up performance of test case
generation a bit because it no longer calculates information it doesn’t need.</li>
<li>It improves the shrinker for certain classes of nested examples. e.g. when
shrinking lists of lists, the shrinker is now able to concatenate two
adjacent lists together into a single list. As a result of this change,
shrinking may get somewhat slower when the minimal example found is large.</li>
</ul>
</div>
<div class="section" id="id10">
<h2>3.40.0 - 2017-12-02<a class="headerlink" href="#id10" title="Permalink to this headline">¶</a></h2>
<p>This release improves how various ways of seeding Hypothesis interact with the
example database:</p>
<ul class="simple">
<li>Using the example database with <a class="reference internal" href="reproducing.html#hypothesis.seed" title="hypothesis.seed"><code class="xref py py-func docutils literal"><span class="pre">seed()</span></code></a> is now deprecated.
You should set <code class="docutils literal"><span class="pre">database=None</span></code> if you are doing that. This will only warn
if you actually load examples from the database while using <code class="docutils literal"><span class="pre">@seed</span></code>.</li>
<li>The <a class="reference internal" href="settings.html#hypothesis.settings.derandomize" title="hypothesis.settings.derandomize"><code class="xref py py-attr docutils literal"><span class="pre">derandomize</span></code></a> will behave the same way as
<code class="docutils literal"><span class="pre">@seed</span></code>.</li>
<li>Using <code class="docutils literal"><span class="pre">--hypothesis-seed</span></code> will disable use of the database.</li>
<li>If a test used examples from the database, it will not suggest using a seed
to reproduce it, because that won’t work.</li>
</ul>
<p>This work was funded by <a class="reference external" href="https://smarkets.com/">Smarkets</a>.</p>
</div>
<div class="section" id="id12">
<h2>3.39.0 - 2017-12-01<a class="headerlink" href="#id12" title="Permalink to this headline">¶</a></h2>
<p>This release adds a new health check that checks if the smallest “natural”
possible example of your test case is very large - this will tend to cause
Hypothesis to generate bad examples and be quite slow.</p>
<p>This work was funded by <a class="reference external" href="https://smarkets.com/">Smarkets</a>.</p>
</div>
<div class="section" id="id14">
<h2>3.38.9 - 2017-11-29<a class="headerlink" href="#id14" title="Permalink to this headline">¶</a></h2>
<p>This is a documentation release to improve the documentation of shrinking
behaviour for Hypothesis’s strategies.</p>
</div>
<div class="section" id="id15">
<h2>3.38.8 - 2017-11-29<a class="headerlink" href="#id15" title="Permalink to this headline">¶</a></h2>
<p>This release improves the performance of
<a class="reference internal" href="data.html#hypothesis.strategies.characters" title="hypothesis.strategies.characters"><code class="xref py py-func docutils literal"><span class="pre">characters()</span></code></a> when using <code class="docutils literal"><span class="pre">blacklist_characters</span></code>
and <a class="reference internal" href="data.html#hypothesis.strategies.from_regex" title="hypothesis.strategies.from_regex"><code class="xref py py-func docutils literal"><span class="pre">from_regex()</span></code></a> when using negative character
classes.</p>
<p>The problems this fixes were found in the course of work funded by
<a class="reference external" href="https://smarkets.com/">Smarkets</a>.</p>
</div>
<div class="section" id="id17">
<h2>3.38.7 - 2017-11-29<a class="headerlink" href="#id17" title="Permalink to this headline">¶</a></h2>
<p>This is a patch release for <a class="reference internal" href="data.html#hypothesis.strategies.from_regex" title="hypothesis.strategies.from_regex"><code class="xref py py-func docutils literal"><span class="pre">from_regex()</span></code></a>, which
had a bug in handling of the <code class="xref py py-obj docutils literal"><span class="pre">python:re.VERBOSE</span></code> flag (<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/992">issue #992</a>).
Flags are now handled correctly when parsing regex.</p>
</div>
<div class="section" id="id18">
<h2>3.38.6 - 2017-11-28<a class="headerlink" href="#id18" title="Permalink to this headline">¶</a></h2>
<p>This patch changes a few byte-string literals from double to single quotes,
thanks to an update in <a class="reference external" href="https://pypi.python.org/pypi/unify">unify</a>. There are no user-visible changes.</p>
</div>
<div class="section" id="id19">
<h2>3.38.5 - 2017-11-23<a class="headerlink" href="#id19" title="Permalink to this headline">¶</a></h2>
<p>This fixes the repr of strategies using lambda that are defined inside
decorators to include the lambda source.</p>
<p>This would mostly have been visible when using the
<a class="reference internal" href="details.html#statistics"><span class="std std-ref">statistics</span></a> functionality - lambdas used for e.g. filtering
would have shown up with a <code class="docutils literal"><span class="pre"><unknown></span></code> as their body. This can still happen,
but it should happen less often now.</p>
</div>
<div class="section" id="id20">
<h2>3.38.4 - 2017-11-22<a class="headerlink" href="#id20" title="Permalink to this headline">¶</a></h2>
<p>This release updates the reported <a class="reference internal" href="details.html#statistics"><span class="std std-ref">statistics</span></a> so that they
show approximately what fraction of your test run time is spent in data
generation (as opposed to test execution).</p>
<p>This work was funded by <a class="reference external" href="https://smarkets.com/">Smarkets</a>.</p>
</div>
<div class="section" id="id22">
<h2>3.38.3 - 2017-11-21<a class="headerlink" href="#id22" title="Permalink to this headline">¶</a></h2>
<p>This is a documentation release, which ensures code examples are up to date
by running them as doctests in CI (<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/711">issue #711</a>).</p>
</div>
<div class="section" id="id23">
<h2>3.38.2 - 2017-11-21<a class="headerlink" href="#id23" title="Permalink to this headline">¶</a></h2>
<p>This release changes the behaviour of the <a class="reference internal" href="settings.html#hypothesis.settings.deadline" title="hypothesis.settings.deadline"><code class="xref py py-attr docutils literal"><span class="pre">deadline</span></code></a>
setting when used with <a class="reference internal" href="data.html#hypothesis.strategies.data" title="hypothesis.strategies.data"><code class="xref py py-func docutils literal"><span class="pre">data()</span></code></a>: Time spent inside
calls to <code class="docutils literal"><span class="pre">data.draw</span></code> will no longer be counted towards the deadline time.</p>
<p>As a side effect of some refactoring required for this work, the way flaky
tests are handled has changed slightly. You are unlikely to see much difference
from this, but some error messages will have changed.</p>
<p>This work was funded by <a class="reference external" href="https://smarkets.com/">Smarkets</a>.</p>
</div>
<div class="section" id="id25">
<h2>3.38.1 - 2017-11-21<a class="headerlink" href="#id25" title="Permalink to this headline">¶</a></h2>
<p>This patch has a variety of non-user-visible refactorings, removing various
minor warts ranging from indirect imports to typos in comments.</p>
</div>
<div class="section" id="id26">
<h2>3.38.0 - 2017-11-18<a class="headerlink" href="#id26" title="Permalink to this headline">¶</a></h2>
<p>This release overhauls <a class="reference internal" href="healthchecks.html"><span class="doc">the health check system</span></a>
in a variety of small ways.
It adds no new features, but is nevertheless a minor release because it changes
which tests are likely to fail health checks.</p>
<p>The most noticeable effect is that some tests that used to fail health checks
will now pass, and some that used to pass will fail. These should all be
improvements in accuracy. In particular:</p>
<ul class="simple">
<li>New failures will usually be because they are now taking into account things
like use of <a class="reference internal" href="data.html#hypothesis.strategies.data" title="hypothesis.strategies.data"><code class="xref py py-func docutils literal"><span class="pre">data()</span></code></a> and
<a class="reference internal" href="details.html#hypothesis.assume" title="hypothesis.assume"><code class="xref py py-func docutils literal"><span class="pre">assume()</span></code></a> inside the test body.</li>
<li>New failures <em>may</em> also be because for some classes of example the way data
generation performance was measured was artificially faster than real data
generation (for most examples that are hitting performance health checks the
opposite should be the case).</li>
<li>Tests that used to fail health checks and now pass do so because the health
check system used to run in a way that was subtly different than the main
Hypothesis data generation and lacked some of its support for e.g. large
examples.</li>
</ul>
<p>If your data generation is especially slow, you may also see your tests get
somewhat faster, as there is no longer a separate health check phase. This will
be particularly noticeable when rerunning test failures.</p>
<p>This work was funded by <a class="reference external" href="https://smarkets.com/">Smarkets</a>.</p>
</div>
<div class="section" id="id28">
<h2>3.37.0 - 2017-11-12<a class="headerlink" href="#id28" title="Permalink to this headline">¶</a></h2>
<p>This is a deprecation release for some health check related features.</p>
<p>The following are now deprecated:</p>
<ul class="simple">
<li>Passing <a class="reference internal" href="healthchecks.html#hypothesis.HealthCheck.exception_in_generation" title="hypothesis.HealthCheck.exception_in_generation"><code class="xref py py-attr docutils literal"><span class="pre">exception_in_generation</span></code></a> to
<a class="reference internal" href="settings.html#hypothesis.settings.suppress_health_check" title="hypothesis.settings.suppress_health_check"><code class="xref py py-attr docutils literal"><span class="pre">suppress_health_check</span></code></a>. This no longer does
anything even when passed - All errors that occur during data generation
will now be immediately reraised rather than going through the health check
mechanism.</li>
<li>Passing <a class="reference internal" href="healthchecks.html#hypothesis.HealthCheck.random_module" title="hypothesis.HealthCheck.random_module"><code class="xref py py-attr docutils literal"><span class="pre">random_module</span></code></a> to
<a class="reference internal" href="settings.html#hypothesis.settings.suppress_health_check" title="hypothesis.settings.suppress_health_check"><code class="xref py py-attr docutils literal"><span class="pre">suppress_health_check</span></code></a>. This hasn’t done anything
for a long time, but was never explicitly deprecated. Hypothesis always seeds
the random module when running @given tests, so this is no longer an error
and suppressing it doesn’t do anything.</li>
<li>Passing non-<a class="reference internal" href="healthchecks.html#hypothesis.HealthCheck" title="hypothesis.HealthCheck"><code class="xref py py-class docutils literal"><span class="pre">HealthCheck</span></code></a> values in
<a class="reference internal" href="settings.html#hypothesis.settings.suppress_health_check" title="hypothesis.settings.suppress_health_check"><code class="xref py py-attr docutils literal"><span class="pre">suppress_health_check</span></code></a>. This was previously
allowed but never did anything useful.</li>
</ul>
<p>In addition, passing a non-iterable value as <a class="reference internal" href="settings.html#hypothesis.settings.suppress_health_check" title="hypothesis.settings.suppress_health_check"><code class="xref py py-attr docutils literal"><span class="pre">suppress_health_check</span></code></a>
will now raise an error immediately (it would never have worked correctly, but
it would previously have failed later). Some validation error messages have
also been updated.</p>
<p>This work was funded by <a class="reference external" href="https://smarkets.com/">Smarkets</a>.</p>
</div>
<div class="section" id="id30">
<h2>3.36.1 - 2017-11-10<a class="headerlink" href="#id30" title="Permalink to this headline">¶</a></h2>
<p>This is a yak shaving release, mostly concerned with our own tests.</p>
<p>While <code class="xref py py-func docutils literal"><span class="pre">getfullargspec()</span></code> was documented as deprecated
in Python 3.5, it never actually emitted a warning. Our code to silence
this (nonexistent) warning has therefore been removed.</p>
<p>We now run our tests with <code class="docutils literal"><span class="pre">DeprecationWarning</span></code> as an error, and made some
minor changes to our own tests as a result. This required similar upstream
updates to <a class="reference external" href="https://pypi.python.org/pypi/coverage">coverage</a> and <a class="reference external" href="https://pypi.python.org/pypi/execnet">execnet</a> (a test-time dependency via
<a class="reference external" href="https://pypi.python.org/pypi/pytest-xdist">pytest-xdist</a>).</p>
<p>There is no user-visible change in Hypothesis itself, but we encourage you
to consider enabling deprecations as errors in your own tests.</p>
</div>
<div class="section" id="id31">
<h2>3.36.0 - 2017-11-06<a class="headerlink" href="#id31" title="Permalink to this headline">¶</a></h2>
<p>This release adds a setting to the public API, and does some internal cleanup:</p>
<ul class="simple">
<li>The <a class="reference internal" href="settings.html#hypothesis.settings.derandomize" title="hypothesis.settings.derandomize"><code class="xref py py-attr docutils literal"><span class="pre">derandomize</span></code></a> setting is now documented (<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/890">issue #890</a>)</li>
<li>Removed - and disallowed - all ‘bare excepts’ in Hypothesis (<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/953">issue #953</a>)</li>
<li>Documented the <a class="reference internal" href="settings.html#hypothesis.settings.strict" title="hypothesis.settings.strict"><code class="xref py py-attr docutils literal"><span class="pre">strict</span></code></a> setting as deprecated, and
updated the build so our docs always match deprecations in the code.</li>
</ul>
</div>
<div class="section" id="id32">
<h2>3.35.0 - 2017-11-06<a class="headerlink" href="#id32" title="Permalink to this headline">¶</a></h2>
<p>This minor release supports constraining <a class="reference internal" href="data.html#hypothesis.strategies.uuids" title="hypothesis.strategies.uuids"><code class="xref py py-func docutils literal"><span class="pre">uuids()</span></code></a>
to generate a particular version of <code class="xref py py-class docutils literal"><span class="pre">UUID</span></code> (<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/721">issue #721</a>).</p>
<p>Thanks to Dion Misic for this feature.</p>
</div>
<div class="section" id="id33">
<h2>3.34.1 - 2017-11-02<a class="headerlink" href="#id33" title="Permalink to this headline">¶</a></h2>
<p>This patch updates the documentation to suggest
<a class="reference internal" href="data.html#hypothesis.strategies.builds" title="hypothesis.strategies.builds"><code class="xref py py-func docutils literal"><span class="pre">builds(callable)</span></code></a> instead of
<a class="reference internal" href="data.html#hypothesis.strategies.just" title="hypothesis.strategies.just"><code class="xref py py-func docutils literal"><span class="pre">just(callable())</span></code></a>.</p>
</div>
<div class="section" id="id34">
<h2>3.34.0 - 2017-11-02<a class="headerlink" href="#id34" title="Permalink to this headline">¶</a></h2>
<p>Hypothesis now emits deprecation warnings if you apply
<a class="reference internal" href="details.html#hypothesis.given" title="hypothesis.given"><code class="xref py py-func docutils literal"><span class="pre">@given</span></code></a> more than once to a target.</p>
<p>Applying <a class="reference internal" href="details.html#hypothesis.given" title="hypothesis.given"><code class="xref py py-func docutils literal"><span class="pre">@given</span></code></a> repeatedly wraps the target multiple
times. Each wrapper will search the space of of possible parameters separately.
This is equivalent but will be much more inefficient than doing it with a
single call to <a class="reference internal" href="details.html#hypothesis.given" title="hypothesis.given"><code class="xref py py-func docutils literal"><span class="pre">@given</span></code></a>.</p>
<p>For example, instead of
<code class="docutils literal"><span class="pre">@given(booleans())</span> <span class="pre">@given(integers())</span></code>, you could write
<code class="docutils literal"><span class="pre">@given(booleans(),</span> <span class="pre">integers())</span></code></p>
</div>
<div class="section" id="id35">
<h2>3.33.1 - 2017-11-02<a class="headerlink" href="#id35" title="Permalink to this headline">¶</a></h2>
<p>This is a bugfix release:</p>
<ul class="simple">
<li><a class="reference internal" href="data.html#hypothesis.strategies.builds" title="hypothesis.strategies.builds"><code class="xref py py-func docutils literal"><span class="pre">builds()</span></code></a> would try to infer a strategy for
required positional arguments of the target from type hints, even if they
had been given to <a class="reference internal" href="data.html#hypothesis.strategies.builds" title="hypothesis.strategies.builds"><code class="xref py py-func docutils literal"><span class="pre">builds()</span></code></a> as positional
arguments (<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/946">issue #946</a>). Now it only infers missing required arguments.</li>
<li>An internal introspection function wrongly reported <code class="docutils literal"><span class="pre">self</span></code> as a required
argument for bound methods, which might also have affected
<a class="reference internal" href="data.html#hypothesis.strategies.builds" title="hypothesis.strategies.builds"><code class="xref py py-func docutils literal"><span class="pre">builds()</span></code></a>. Now it knows better.</li>
</ul>
</div>
<div class="section" id="id36">
<h2>3.33.0 - 2017-10-16<a class="headerlink" href="#id36" title="Permalink to this headline">¶</a></h2>
<p>This release supports strategy inference for more field types in Django
<code class="xref py py-func docutils literal"><span class="pre">models()</span></code> - you can now omit an argument for
Date, Time, Duration, Slug, IP Address, and UUID fields. (<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/642">issue #642</a>)</p>
<p>Strategy generation for fields with grouped choices now selects choices from
each group, instead of selecting from the group names.</p>
</div>
<div class="section" id="id37">
<h2>3.32.2 - 2017-10-15<a class="headerlink" href="#id37" title="Permalink to this headline">¶</a></h2>
<p>This patch removes the <code class="docutils literal"><span class="pre">mergedb</span></code> tool, introduced in Hypothesis 1.7.1
on an experimental basis. It has never actually worked, and the new
<a class="reference internal" href="database.html"><span class="doc">Hypothesis example database</span></a> is designed to make such a
tool unnecessary.</p>
</div>
<div class="section" id="id38">
<h2>3.32.1 - 2017-10-13<a class="headerlink" href="#id38" title="Permalink to this headline">¶</a></h2>
<p>This patch has two improvements for strategies based on enumerations.</p>
<ul class="simple">
<li><a class="reference internal" href="data.html#hypothesis.strategies.from_type" title="hypothesis.strategies.from_type"><code class="xref py py-func docutils literal"><span class="pre">from_type()</span></code></a> now handles enumerations correctly,
delegating to <a class="reference internal" href="data.html#hypothesis.strategies.sampled_from" title="hypothesis.strategies.sampled_from"><code class="xref py py-func docutils literal"><span class="pre">sampled_from()</span></code></a>. Previously it
noted that <code class="docutils literal"><span class="pre">Enum.__init__</span></code> has no required arguments and therefore delegated
to <a class="reference internal" href="data.html#hypothesis.strategies.builds" title="hypothesis.strategies.builds"><code class="xref py py-func docutils literal"><span class="pre">builds()</span></code></a>, which would subsequently fail.</li>
<li>When sampling from an <code class="xref py py-class docutils literal"><span class="pre">python:enum.Flag</span></code>, we also generate combinations
of members. Eg for <code class="docutils literal"><span class="pre">Flag('Permissions',</span> <span class="pre">'READ,</span> <span class="pre">WRITE,</span> <span class="pre">EXECUTE')</span></code> we can now
generate, <code class="docutils literal"><span class="pre">Permissions.READ</span></code>, <code class="docutils literal"><span class="pre">Permissions.READ|WRITE</span></code>, and so on.</li>
</ul>
</div>
<div class="section" id="id39">
<h2>3.32.0 - 2017-10-09<a class="headerlink" href="#id39" title="Permalink to this headline">¶</a></h2>
<p>This changes the default value of
<a class="reference internal" href="settings.html#hypothesis.settings.use_coverage" title="hypothesis.settings.use_coverage"><code class="xref py py-attr docutils literal"><span class="pre">use_coverage=True</span></code></a> to True when
running on pypy (it was already True on CPython).</p>
<p>It was previously set to False because we expected it to be too slow, but
recent benchmarking shows that actually performance of the feature on pypy is
fairly acceptable - sometimes it’s slower than on CPython, sometimes it’s
faster, but it’s generally within a factor of two either way.</p>
</div>
<div class="section" id="id40">
<h2>3.31.6 - 2017-10-08<a class="headerlink" href="#id40" title="Permalink to this headline">¶</a></h2>
<p>This patch improves the quality of strategies inferred from Numpy dtypes:</p>
<ul class="simple">
<li>Integer dtypes generated examples with the upper half of their (non-sign) bits
set to zero. The inferred strategies can now produce any representable integer.</li>
<li>Fixed-width unicode- and byte-string dtypes now cap the internal example
length, which should improve example and shrink quality.</li>
<li>Numpy arrays can only store fixed-size strings internally, and allow shorter
strings by right-padding them with null bytes. Inferred string strategies
no longer generate such values, as they can never be retrieved from an array.
This improves shrinking performance by skipping useless values.</li>
</ul>
<p>This has already been useful in Hypothesis - we found an overflow bug in our
Pandas support, and as a result <a class="reference internal" href="numpy.html#hypothesis.extra.pandas.indexes" title="hypothesis.extra.pandas.indexes"><code class="xref py py-func docutils literal"><span class="pre">indexes()</span></code></a> and
<a class="reference internal" href="numpy.html#hypothesis.extra.pandas.range_indexes" title="hypothesis.extra.pandas.range_indexes"><code class="xref py py-func docutils literal"><span class="pre">range_indexes()</span></code></a> now check that <code class="docutils literal"><span class="pre">min_size</span></code>
and <code class="docutils literal"><span class="pre">max_size</span></code> are at least zero.</p>
</div>
<div class="section" id="id41">
<h2>3.31.5 - 2017-10-08<a class="headerlink" href="#id41" title="Permalink to this headline">¶</a></h2>
<p>This release fixes a performance problem in tests where
<a class="reference internal" href="settings.html#hypothesis.settings.use_coverage" title="hypothesis.settings.use_coverage"><code class="xref py py-attr docutils literal"><span class="pre">use_coverage</span></code></a> is set to True.</p>
<p>Tests experience a slow-down proportionate to the amount of code they cover.
This is still the case, but the factor is now low enough that it should be
unnoticeable. Previously it was large and became much larger in 3.28.4.</p>
</div>
<div class="section" id="id42">
<h2>3.31.4 - 2017-10-08<a class="headerlink" href="#id42" title="Permalink to this headline">¶</a></h2>
<p><a class="reference internal" href="data.html#hypothesis.strategies.from_type" title="hypothesis.strategies.from_type"><code class="xref py py-func docutils literal"><span class="pre">from_type()</span></code></a> failed with a very confusing error
if passed a <code class="xref py py-func docutils literal"><span class="pre">NewType()</span></code> (<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/901">issue #901</a>). These psudeo-types
are now unwrapped correctly, and strategy inference works as expected.</p>
</div>
<div class="section" id="id43">
<h2>3.31.3 - 2017-10-06<a class="headerlink" href="#id43" title="Permalink to this headline">¶</a></h2>
<p>This release makes some small optimisations to our use of coverage that should
reduce constant per-example overhead. This is probably only noticeable on
examples where the test itself is quite fast. On no-op tests that don’t test
anything you may see up to a fourfold speed increase (which is still
significantly slower than without coverage). On more realistic tests the speed
up is likely to be less than that.</p>
</div>
<div class="section" id="id44">
<h2>3.31.2 - 2017-09-30<a class="headerlink" href="#id44" title="Permalink to this headline">¶</a></h2>
<p>This release fixes some formatting and small typos/grammar issues in the
documentation, specifically the page docs/settings.rst, and the inline docs
for the various settings.</p>
</div>
<div class="section" id="id45">
<h2>3.31.1 - 2017-09-30<a class="headerlink" href="#id45" title="Permalink to this headline">¶</a></h2>
<p>This release improves the handling of deadlines so that they act better with
the shrinking process. This fixes <a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/892">issue #892</a>.</p>
<p>This involves two changes:</p>
<ol class="arabic simple">
<li>The deadline is raised during the initial generation and shrinking, and then
lowered to the set value for final replay. This restricts our attention to
examples which exceed the deadline by a more significant margin, which
increases their reliability.</li>
<li>When despite the above a test still becomes flaky because it is
significantly faster on rerun than it was on its first run, the error
message is now more explicit about the nature of this problem, and includes
both the initial test run time and the new test run time.</li>
</ol>
<p>In addition, this release also clarifies the documentation of the deadline
setting slightly to be more explicit about where it applies.</p>
<p>This work was funded by <a class="reference external" href="https://smarkets.com/">Smarkets</a>.</p>
</div>
<div class="section" id="id47">
<h2>3.31.0 - 2017-09-29<a class="headerlink" href="#id47" title="Permalink to this headline">¶</a></h2>
<p>This release blocks installation of Hypothesis on Python 3.3, which
<span class="target" id="index-1"></span><a class="pep reference external" href="https://www.python.org/dev/peps/pep-0398"><strong>reached its end of life date on 2017-09-29</strong></a>.</p>
<p>This should not be of interest to anyone but downstream maintainers -
if you are affected, migrate to a secure version of Python as soon as
possible or at least seek commercial support.</p>
</div>
<div class="section" id="id48">
<h2>3.30.4 - 2017-09-27<a class="headerlink" href="#id48" title="Permalink to this headline">¶</a></h2>
<p>This release makes several changes:</p>
<ol class="arabic simple">
<li>It significantly improves Hypothesis’s ability to use coverage information
to find interesting examples.</li>
<li>It reduces the default <a class="reference internal" href="settings.html#hypothesis.settings.max_examples" title="hypothesis.settings.max_examples"><code class="xref py py-attr docutils literal"><span class="pre">max_examples</span></code></a> setting from 200 to 100. This takes
advantage of the improved algorithm meaning fewer examples are typically
needed to get the same testing and is sufficiently better at covering
interesting behaviour, and offsets some of the performance problems of
running under coverage.</li>
<li>Hypothesis will always try to start its testing with an example that is near
minimized.</li>
</ol>
<p>The new algorithm for 1 also makes some changes to Hypothesis’s low level data
generation which apply even with coverage turned off. They generally reduce the
total amount of data generated, which should improve test performance somewhat.
Between this and 3 you should see a noticeable reduction in test runtime (how
much so depends on your tests and how much example size affects their
performance. On our benchmarks, where data generation dominates, we saw up to
a factor of two performance improvement, but it’s unlikely to be that large.</p>
</div>
<div class="section" id="id49">
<h2>3.30.3 - 2017-09-25<a class="headerlink" href="#id49" title="Permalink to this headline">¶</a></h2>
<p>This release fixes some formatting and small typos/grammar issues in the
documentation, specifically the page docs/details.rst, and some inline
docs linked from there.</p>
</div>
<div class="section" id="id50">
<h2>3.30.2 - 2017-09-24<a class="headerlink" href="#id50" title="Permalink to this headline">¶</a></h2>
<p>This release changes Hypothesis’s caching approach for functions in
<code class="docutils literal"><span class="pre">hypothesis.strategies</span></code>. Previously it would have cached extremely
aggressively and cache entries would never be evicted. Now it adopts a
least-frequently used, least recently used key invalidation policy, and is
somewhat more conservative about which strategies it caches.</p>
<p>Workloads which create strategies based on dynamic values, e.g. by using
<a class="reference internal" href="data.html#flatmap"><span class="std std-ref">flatmap</span></a> or <a class="reference internal" href="data.html#hypothesis.strategies.composite" title="hypothesis.strategies.composite"><code class="xref py py-func docutils literal"><span class="pre">composite()</span></code></a>,
will use significantly less memory.</p>
</div>
<div class="section" id="id51">
<h2>3.30.1 - 2017-09-22<a class="headerlink" href="#id51" title="Permalink to this headline">¶</a></h2>
<p>This release fixes a bug where when running with
<a class="reference internal" href="settings.html#hypothesis.settings.use_coverage" title="hypothesis.settings.use_coverage"><code class="xref py py-attr docutils literal"><span class="pre">use_coverage=True</span></code></a> inside an
existing running instance of coverage, Hypothesis would frequently put files
that the coveragerc excluded in the report for the enclosing coverage.</p>
</div>
<div class="section" id="id52">
<h2>3.30.0 - 2017-09-20<a class="headerlink" href="#id52" title="Permalink to this headline">¶</a></h2>
<p>This release introduces two new features:</p>
<ul class="simple">
<li>When a test fails, either with a health check failure or a falsifying example,
Hypothesis will print out a seed that led to that failure, if the test is not
already running with a fixed seed. You can then recreate that failure using either
the <a class="reference internal" href="reproducing.html#hypothesis.seed" title="hypothesis.seed"><code class="xref py py-func docutils literal"><span class="pre">@seed</span></code></a> decorator or (if you are running pytest) with <code class="docutils literal"><span class="pre">--hypothesis-seed</span></code>.</li>
<li><a class="reference external" href="https://pypi.python.org/pypi/pytest">pytest</a> users can specify a seed to use for <a class="reference internal" href="details.html#hypothesis.given" title="hypothesis.given"><code class="xref py py-func docutils literal"><span class="pre">@given</span></code></a> based tests by passing
the <code class="docutils literal"><span class="pre">--hypothesis-seed</span></code> command line argument.</li>
</ul>
<p>This work was funded by <a class="reference external" href="https://smarkets.com/">Smarkets</a>.</p>
</div>
<div class="section" id="id54">
<h2>3.29.0 - 2017-09-19<a class="headerlink" href="#id54" title="Permalink to this headline">¶</a></h2>
<p>This release makes Hypothesis coverage aware. Hypothesis now runs all test
bodies under coverage, and uses this information to guide its testing.</p>
<p>The <a class="reference internal" href="settings.html#hypothesis.settings.use_coverage" title="hypothesis.settings.use_coverage"><code class="xref py py-attr docutils literal"><span class="pre">use_coverage</span></code></a> setting can be used to disable
this behaviour if you want to test code that is sensitive to coverage being
enabled (either because of performance or interaction with the trace function).</p>
<p>The main benefits of this feature are:</p>
<ul class="simple">
<li>Hypothesis now observes when examples it discovers cover particular lines
or branches and stores them in the database for later.</li>
<li>Hypothesis will make some use of this information to guide its exploration of
the search space and improve the examples it finds (this is currently used
only very lightly and will likely improve significantly in future releases).</li>
</ul>
<p>This also has the following side-effects:</p>
<ul class="simple">
<li>Hypothesis now has an install time dependency on the <a class="reference external" href="https://pypi.python.org/pypi/coverage">coverage</a> package.</li>
<li>Tests that are already running Hypothesis under coverage will likely get
faster.</li>
<li>Tests that are not running under coverage now run their test bodies under
coverage by default.</li>
</ul>
<p>This feature is only partially supported under pypy. It is significantly slower
than on CPython and is turned off by default as a result, but it should still
work correctly if you want to use it.</p>
</div>
<div class="section" id="id55">
<h2>3.28.3 - 2017-09-18<a class="headerlink" href="#id55" title="Permalink to this headline">¶</a></h2>
<p>This release is an internal change that affects how Hypothesis handles
calculating certain properties of strategies.</p>
<p>The primary effect of this is that it fixes a bug where use of
<code class="xref py py-func docutils literal"><span class="pre">deferred()</span></code> could sometimes trigger an internal assertion
error. However the fix for this bug involved some moderately deep changes to
how Hypothesis handles certain constructs so you may notice some additional
knock-on effects.</p>
<p>In particular the way Hypothesis handles drawing data from strategies that
cannot generate any values has changed to bail out sooner than it previously
did. This may speed up certain tests, but it is unlikely to make much of a
difference in practice for tests that were not already failing with
Unsatisfiable.</p>
</div>
<div class="section" id="id56">
<h2>3.28.2 - 2017-09-18<a class="headerlink" href="#id56" title="Permalink to this headline">¶</a></h2>
<p>This is a patch release that fixes a bug in the <a class="reference internal" href="numpy.html#module-hypothesis.extra.pandas" title="hypothesis.extra.pandas"><code class="xref py py-mod docutils literal"><span class="pre">hypothesis.extra.pandas</span></code></a>
documentation where it incorrectly referred to <a class="reference internal" href="numpy.html#hypothesis.extra.pandas.column" title="hypothesis.extra.pandas.column"><code class="xref py py-func docutils literal"><span class="pre">column()</span></code></a>
instead of <a class="reference internal" href="numpy.html#hypothesis.extra.pandas.columns" title="hypothesis.extra.pandas.columns"><code class="xref py py-func docutils literal"><span class="pre">columns()</span></code></a>.</p>
</div>
<div class="section" id="id57">
<h2>3.28.1 - 2017-09-16<a class="headerlink" href="#id57" title="Permalink to this headline">¶</a></h2>
<p>This is a refactoring release. It moves a number of internal uses
of <code class="xref py py-func docutils literal"><span class="pre">namedtuple()</span></code> over to using attrs based classes, and removes a couple
of internal namedtuple classes that were no longer in use.</p>
<p>It should have no user visible impact.</p>
</div>
<div class="section" id="id58">
<h2>3.28.0 - 2017-09-15<a class="headerlink" href="#id58" title="Permalink to this headline">¶</a></h2>
<p>This release adds support for testing <a class="reference external" href="https://pypi.python.org/pypi/pandas">pandas</a> via the <a class="reference internal" href="numpy.html#hypothesis-pandas"><span class="std std-ref">hypothesis.extra.pandas</span></a>
module.</p>
<p>It also adds a dependency on <a class="reference external" href="https://pypi.python.org/pypi/attrs">attrs</a>.</p>
<p>This work was funded by <a class="reference external" href="https://stripe.com/">Stripe</a>.</p>
</div>
<div class="section" id="id59">
<h2>3.27.1 - 2017-09-14<a class="headerlink" href="#id59" title="Permalink to this headline">¶</a></h2>
<p>This release fixes some formatting and broken cross-references in the
documentation, which includes editing docstrings - and thus a patch release.</p>
</div>
<div class="section" id="id60">
<h2>3.27.0 - 2017-09-13<a class="headerlink" href="#id60" title="Permalink to this headline">¶</a></h2>
<p>This release introduces a <a class="reference internal" href="settings.html#hypothesis.settings.deadline" title="hypothesis.settings.deadline"><code class="xref py py-attr docutils literal"><span class="pre">deadline</span></code></a>
setting to Hypothesis.</p>
<p>When set this turns slow tests into errors. By default it is unset but will
warn if you exceed 200ms, which will become the default value in a future
release.</p>
<p>This work was funded by <a class="reference external" href="https://smarkets.com/">Smarkets</a>.</p>
</div>
<div class="section" id="id62">
<h2>3.26.0 - 2017-09-12<a class="headerlink" href="#id62" title="Permalink to this headline">¶</a></h2>
<p>Hypothesis now emits deprecation warnings if you are using the legacy
SQLite example database format, or the tool for merging them. These were
already documented as deprecated, so this doesn’t change their deprecation
status, only that we warn about it.</p>
</div>
<div class="section" id="id63">
<h2>3.25.1 - 2017-09-12<a class="headerlink" href="#id63" title="Permalink to this headline">¶</a></h2>
<p>This release fixes a bug with generating <span class="xref std std-doc">numpy datetime and timedelta types</span>:
When inferring the strategy from the dtype, datetime and timedelta dtypes with
sub-second precision would always produce examples with one second resolution.
Inferring a strategy from a time dtype will now always produce example with the
same precision.</p>
</div>
<div class="section" id="id64">
<h2>3.25.0 - 2017-09-12<a class="headerlink" href="#id64" title="Permalink to this headline">¶</a></h2>
<p>This release changes how Hypothesis shrinks and replays examples to take into
account that it can encounter new bugs while shrinking the bug it originally
found. Previously it would end up replacing the originally found bug with the
new bug and show you only that one. Now it is (often) able to recognise when
two bugs are distinct and when it finds more than one will show both.</p>
</div>
<div class="section" id="id65">
<h2>3.24.2 - 2017-09-11<a class="headerlink" href="#id65" title="Permalink to this headline">¶</a></h2>
<p>This release removes the (purely internal and no longer useful)
<code class="docutils literal"><span class="pre">strategy_test_suite</span></code> function and the corresponding strategytests module.</p>
</div>
<div class="section" id="id66">
<h2>3.24.1 - 2017-09-06<a class="headerlink" href="#id66" title="Permalink to this headline">¶</a></h2>
<p>This release improves the reduction of examples involving floating point
numbers to produce more human readable examples.</p>
<p>It also has some general purpose changes to the way the minimizer works
internally, which may see some improvement in quality and slow down of test
case reduction in cases that have nothing to do with floating point numbers.</p>
</div>
<div class="section" id="id67">
<h2>3.24.0 - 2017-09-05<a class="headerlink" href="#id67" title="Permalink to this headline">¶</a></h2>
<p>Hypothesis now emits deprecation warnings if you use <code class="docutils literal"><span class="pre">some_strategy.example()</span></code> inside a
test function or strategy definition (this was never intended to be supported,
but is sufficiently widespread that it warrants a deprecation path).</p>
</div>
<div class="section" id="id68">
<h2>3.23.3 - 2017-09-05<a class="headerlink" href="#id68" title="Permalink to this headline">¶</a></h2>
<p>This is a bugfix release for <a class="reference internal" href="data.html#hypothesis.strategies.decimals" title="hypothesis.strategies.decimals"><code class="xref py py-func docutils literal"><span class="pre">decimals()</span></code></a>
with the <code class="docutils literal"><span class="pre">places</span></code> argument.</p>
<ul class="simple">
<li>No longer fails health checks (<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/725">issue #725</a>, due to internal filtering)</li>
<li>Specifying a <code class="docutils literal"><span class="pre">min_value</span></code> and <code class="docutils literal"><span class="pre">max_value</span></code> without any decimals with
<code class="docutils literal"><span class="pre">places</span></code> places between them gives a more useful error message.</li>
<li>Works for any valid arguments, regardless of the decimal precision context.</li>
</ul>
</div>
<div class="section" id="id69">
<h2>3.23.2 - 2017-09-01<a class="headerlink" href="#id69" title="Permalink to this headline">¶</a></h2>
<p>This is a small refactoring release that removes a now-unused parameter to an
internal API. It shouldn’t have any user visible effect.</p>
</div>
<div class="section" id="id70">
<h2>3.23.1 - 2017-09-01<a class="headerlink" href="#id70" title="Permalink to this headline">¶</a></h2>
<p>Hypothesis no longer propagates the dynamic scope of settings into strategy
definitions.</p>
<p>This release is a small change to something that was never part of the public
API and you will almost certainly not notice any effect unless you’re doing
something surprising, but for example the following code will now give a
different answer in some circumstances:</p>
<div class="highlight-python"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">hypothesis.strategies</span> <span class="kn">as</span> <span class="nn">st</span>
<span class="kn">from</span> <span class="nn">hypothesis</span> <span class="kn">import</span> <span class="n">settings</span>
<span class="n">CURRENT_SETTINGS</span> <span class="o">=</span> <span class="n">st</span><span class="o">.</span><span class="n">builds</span><span class="p">(</span><span class="k">lambda</span><span class="p">:</span> <span class="n">settings</span><span class="o">.</span><span class="n">default</span><span class="p">)</span>
</pre></div>
</div>
<p>(We don’t actually encourage you writing code like this)</p>
<p>Previously this would have generated the settings that were in effect at the
point of definition of <code class="docutils literal"><span class="pre">CURRENT_SETTINGS</span></code>. Now it will generate the settings
that are used for the current test.</p>
<p>It is very unlikely to be significant enough to be visible, but you may also
notice a small performance improvement.</p>
</div>
<div class="section" id="id71">
<h2>3.23.0 - 2017-08-31<a class="headerlink" href="#id71" title="Permalink to this headline">¶</a></h2>
<p>This release adds a <code class="docutils literal"><span class="pre">unique</span></code> argument to <a class="reference internal" href="numpy.html#hypothesis.extra.numpy.arrays" title="hypothesis.extra.numpy.arrays"><code class="xref py py-func docutils literal"><span class="pre">arrays()</span></code></a>
which behaves the same ways as the corresponding one for
<a class="reference internal" href="data.html#hypothesis.strategies.lists" title="hypothesis.strategies.lists"><code class="xref py py-func docutils literal"><span class="pre">lists()</span></code></a>, requiring all of the elements in the
generated array to be distinct.</p>
</div>
<div class="section" id="id72">
<h2>3.22.2 - 2017-08-29<a class="headerlink" href="#id72" title="Permalink to this headline">¶</a></h2>
<p>This release fixes an issue where Hypothesis would raise a <code class="docutils literal"><span class="pre">TypeError</span></code> when
using the datetime-related strategies if running with <code class="docutils literal"><span class="pre">PYTHONOPTIMIZE=2</span></code>.
This bug was introduced in v3.20.0. (See <a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/822">issue #822</a>)</p>
</div>
<div class="section" id="id73">
<h2>3.22.1 - 2017-08-28<a class="headerlink" href="#id73" title="Permalink to this headline">¶</a></h2>
<p>Hypothesis now transparently handles problems with an internal unicode cache,
including file truncation or read-only filesystems (<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/767">issue #767</a>).
Thanks to Sam Hames for the patch.</p>
</div>
<div class="section" id="id74">
<h2>3.22.0 - 2017-08-26<a class="headerlink" href="#id74" title="Permalink to this headline">¶</a></h2>
<p>This release provides what should be a substantial performance improvement to
numpy arrays generated using <a class="reference internal" href="numpy.html#hypothesis-numpy"><span class="std std-ref">provided numpy support</span></a>,
and adds a new <code class="docutils literal"><span class="pre">fill_value</span></code> argument to <a class="reference internal" href="numpy.html#hypothesis.extra.numpy.arrays" title="hypothesis.extra.numpy.arrays"><code class="xref py py-func docutils literal"><span class="pre">arrays()</span></code></a>
to control this behaviour.</p>
<p>This work was funded by <a class="reference external" href="https://stripe.com/">Stripe</a>.</p>
</div>
<div class="section" id="id76">
<h2>3.21.3 - 2017-08-26<a class="headerlink" href="#id76" title="Permalink to this headline">¶</a></h2>
<p>This release fixes some extremely specific circumstances that probably have
never occurred in the wild where users of
<code class="xref py py-func docutils literal"><span class="pre">deferred()</span></code> might have seen a RuntimeError from
too much recursion, usually in cases where no valid example could have been
generated anyway.</p>
</div>
<div class="section" id="id77">
<h2>3.21.2 - 2017-08-25<a class="headerlink" href="#id77" title="Permalink to this headline">¶</a></h2>
<p>This release fixes some minor bugs in argument validation:</p>
<blockquote>
<div><ul class="simple">
<li><a class="reference internal" href="numpy.html#hypothesis-numpy"><span class="std std-ref">hypothesis.extra.numpy</span></a> dtype strategies would raise an internal error
instead of an InvalidArgument exception when passed an invalid
endianness specification.</li>
<li><a class="reference internal" href="data.html#hypothesis.strategies.fractions" title="hypothesis.strategies.fractions"><code class="xref py py-func docutils literal"><span class="pre">fractions()</span></code></a> would raise an internal error instead of an InvalidArgument
if passed <code class="docutils literal"><span class="pre">float("nan")</span></code> as one of its bounds.</li>
<li>The error message for passing <code class="docutils literal"><span class="pre">float("nan")</span></code> as a bound to various
strategies has been improved.</li>
<li>Various bound arguments will now raise InvalidArgument in cases where
they would previously have raised an internal TypeError or
ValueError from the relevant conversion function.</li>
<li><a class="reference internal" href="data.html#hypothesis.strategies.streaming" title="hypothesis.strategies.streaming"><code class="xref py py-func docutils literal"><span class="pre">streaming()</span></code></a> would not have emitted a
deprecation warning when called with an invalid argument.</li>
</ul>
</div></blockquote>
</div>
<div class="section" id="id78">
<h2>3.21.1 - 2017-08-24<a class="headerlink" href="#id78" title="Permalink to this headline">¶</a></h2>
<p>This release fixes a bug where test failures that were the result of
an <a class="reference internal" href="reproducing.html#hypothesis.example" title="hypothesis.example"><code class="xref py py-func docutils literal"><span class="pre">@example</span></code></a> would print an extra stack trace before re-raising the
exception.</p>
</div>
<div class="section" id="id79">
<h2>3.21.0 - 2017-08-23<a class="headerlink" href="#id79" title="Permalink to this headline">¶</a></h2>
<p>This release deprecates Hypothesis’s strict mode, which turned Hypothesis’s
deprecation warnings into errors. Similar functionality can be achieved
by using <code class="xref py py-func docutils literal"><span class="pre">simplefilter('error',</span> <span class="pre">HypothesisDeprecationWarning)</span></code>.</p>
</div>
<div class="section" id="id80">
<h2>3.20.0 - 2017-08-22<a class="headerlink" href="#id80" title="Permalink to this headline">¶</a></h2>
<p>This release renames the relevant arguments on the
<a class="reference internal" href="data.html#hypothesis.strategies.datetimes" title="hypothesis.strategies.datetimes"><code class="xref py py-func docutils literal"><span class="pre">datetimes()</span></code></a>, <a class="reference internal" href="data.html#hypothesis.strategies.dates" title="hypothesis.strategies.dates"><code class="xref py py-func docutils literal"><span class="pre">dates()</span></code></a>,
<a class="reference internal" href="data.html#hypothesis.strategies.times" title="hypothesis.strategies.times"><code class="xref py py-func docutils literal"><span class="pre">times()</span></code></a>, and <a class="reference internal" href="data.html#hypothesis.strategies.timedeltas" title="hypothesis.strategies.timedeltas"><code class="xref py py-func docutils literal"><span class="pre">timedeltas()</span></code></a>
strategies to <code class="docutils literal"><span class="pre">min_value</span></code> and <code class="docutils literal"><span class="pre">max_value</span></code>, to make them consistent with the
other strategies in the module.</p>
<p>The old argument names are still supported but will emit a deprecation warning
when used explicitly as keyword arguments. Arguments passed positionally will
go to the new argument names and are not deprecated.</p>
</div>
<div class="section" id="id81">
<h2>3.19.3 - 2017-08-22<a class="headerlink" href="#id81" title="Permalink to this headline">¶</a></h2>
<p>This release provides a major overhaul to the internals of how Hypothesis
handles shrinking.</p>
<p>This should mostly be visible in terms of getting better examples for tests
which make heavy use of <a class="reference internal" href="data.html#hypothesis.strategies.composite" title="hypothesis.strategies.composite"><code class="xref py py-func docutils literal"><span class="pre">composite()</span></code></a>,
<a class="reference internal" href="data.html#hypothesis.strategies.data" title="hypothesis.strategies.data"><code class="xref py py-func docutils literal"><span class="pre">data()</span></code></a> or <a class="reference internal" href="data.html#flatmap"><span class="std std-ref">flatmap</span></a> where the data
drawn depends a lot on previous choices, especially where size parameters are
affected. Previously Hypothesis would have struggled to reliably produce
good examples here. Now it should do much better. Performance should also be
better for examples with a non-zero <code class="docutils literal"><span class="pre">min_size</span></code>.</p>
<p>You may see slight changes to example generation (e.g. improved example
diversity) as a result of related changes to internals, but they are unlikely
to be significant enough to notice.</p>
</div>
<div class="section" id="id82">
<h2>3.19.2 - 2017-08-21<a class="headerlink" href="#id82" title="Permalink to this headline">¶</a></h2>
<p>This release fixes two bugs in <a class="reference internal" href="numpy.html#module-hypothesis.extra.numpy" title="hypothesis.extra.numpy"><code class="xref py py-mod docutils literal"><span class="pre">hypothesis.extra.numpy</span></code></a>:</p>
<ul class="simple">
<li><a class="reference internal" href="numpy.html#hypothesis.extra.numpy.unicode_string_dtypes" title="hypothesis.extra.numpy.unicode_string_dtypes"><code class="xref py py-func docutils literal"><span class="pre">unicode_string_dtypes()</span></code></a> didn’t work at all due
to an incorrect dtype specifier. Now it does.</li>
<li>Various impossible conditions would have been accepted but would error when
they fail to produced any example. Now they raise an explicit InvalidArgument
error.</li>
</ul>
</div>
<div class="section" id="id83">
<h2>3.19.1 - 2017-08-21<a class="headerlink" href="#id83" title="Permalink to this headline">¶</a></h2>
<p>This is a bugfix release for <a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/739">issue #739</a>, where bounds for
<a class="reference internal" href="data.html#hypothesis.strategies.fractions" title="hypothesis.strategies.fractions"><code class="xref py py-func docutils literal"><span class="pre">fractions()</span></code></a> or floating-point
<a class="reference internal" href="data.html#hypothesis.strategies.decimals" title="hypothesis.strategies.decimals"><code class="xref py py-func docutils literal"><span class="pre">decimals()</span></code></a> were not properly converted to
integers before passing them to the integers strategy.
This excluded some values that should have been possible, and could
trigger internal errors if the bounds lay between adjacent integers.</p>
<p>You can now bound <a class="reference internal" href="data.html#hypothesis.strategies.fractions" title="hypothesis.strategies.fractions"><code class="xref py py-func docutils literal"><span class="pre">fractions()</span></code></a> with two
arbitrarily close fractions.</p>
<p>It is now an explicit error to supply a min_value, max_value, and
max_denominator to <a class="reference internal" href="data.html#hypothesis.strategies.fractions" title="hypothesis.strategies.fractions"><code class="xref py py-func docutils literal"><span class="pre">fractions()</span></code></a> where the value
bounds do not include a fraction with denominator at most max_denominator.</p>
</div>
<div class="section" id="id84">
<h2>3.19.0 - 2017-08-20<a class="headerlink" href="#id84" title="Permalink to this headline">¶</a></h2>
<p>This release adds the <a class="reference internal" href="data.html#hypothesis.strategies.from_regex" title="hypothesis.strategies.from_regex"><code class="xref py py-func docutils literal"><span class="pre">from_regex()</span></code></a> strategy,
which generates strings that contain a match of a regular expression.</p>
<p>Thanks to Maxim Kulkin for creating the
<a class="reference external" href="https://github.com/maximkulkin/hypothesis-regex">hypothesis-regex</a>
package and then helping to upstream it! (<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/662">issue #662</a>)</p>
</div>
<div class="section" id="id85">
<h2>3.18.5 - 2017-08-18<a class="headerlink" href="#id85" title="Permalink to this headline">¶</a></h2>
<p>This is a bugfix release for <a class="reference internal" href="data.html#hypothesis.strategies.integers" title="hypothesis.strategies.integers"><code class="xref py py-func docutils literal"><span class="pre">integers()</span></code></a>.
Previously the strategy would hit an internal assertion if passed non-integer
bounds for <code class="docutils literal"><span class="pre">min_value</span></code> and <code class="docutils literal"><span class="pre">max_value</span></code> that had no integers between them.
The strategy now raises InvalidArgument instead.</p>
</div>
<div class="section" id="id86">
<h2>3.18.4 - 2017-08-18<a class="headerlink" href="#id86" title="Permalink to this headline">¶</a></h2>
<p>Release to fix a bug where mocks can be used as test runners under certain
conditions. Specifically, if a mock is injected into a test via pytest
fixtures or patch decorators, and that mock is the first argument in the
list, hypothesis will think it represents self and turns the mock
into a test runner. If this happens, the affected test always passes
because the mock is executed instead of the test body. Sometimes, it
will also fail health checks.</p>
<p>Fixes <a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/491">issue #491</a> and a section of <a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/198">issue #198</a>.
Thanks to Ben Peterson for this bug fix.</p>
</div>
<div class="section" id="id87">
<h2>3.18.3 - 2017-08-17<a class="headerlink" href="#id87" title="Permalink to this headline">¶</a></h2>
<p>This release should improve the performance of some tests which
experienced a slow down as a result of the 3.13.0 release.</p>
<p>Tests most likely to benefit from this are ones that make extensive
use of <code class="docutils literal"><span class="pre">min_size</span></code> parameters, but others may see some improvement
as well.</p>
</div>
<div class="section" id="id88">
<h2>3.18.2 - 2017-08-16<a class="headerlink" href="#id88" title="Permalink to this headline">¶</a></h2>
<p>This release fixes a bug introduced in 3.18.0. If the arguments
<code class="docutils literal"><span class="pre">whitelist_characters</span></code> and <code class="docutils literal"><span class="pre">blacklist_characters</span></code> to
<a class="reference internal" href="data.html#hypothesis.strategies.characters" title="hypothesis.strategies.characters"><code class="xref py py-func docutils literal"><span class="pre">characters()</span></code></a> both contained elements, then an
<code class="docutils literal"><span class="pre">InvalidArgument</span></code> exception would be raised.</p>
<p>Thanks to Zac Hatfield-Dodds for reporting and fixing this.</p>
</div>
<div class="section" id="id89">
<h2>3.18.1 - 2017-08-14<a class="headerlink" href="#id89" title="Permalink to this headline">¶</a></h2>
<p>This is a bug fix release to fix <a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/780">issue #780</a>, where
<a class="reference internal" href="data.html#hypothesis.strategies.sets" title="hypothesis.strategies.sets"><code class="xref py py-func docutils literal"><span class="pre">sets()</span></code></a> and similar would trigger health check
errors if their element strategy could only produce one element (e.g.
if it was <a class="reference internal" href="data.html#hypothesis.strategies.just" title="hypothesis.strategies.just"><code class="xref py py-func docutils literal"><span class="pre">just()</span></code></a>).</p>
</div>
<div class="section" id="id90">
<h2>3.18.0 - 2017-08-13<a class="headerlink" href="#id90" title="Permalink to this headline">¶</a></h2>
<p>This is a feature release:</p>
<ul class="simple">
<li><a class="reference internal" href="data.html#hypothesis.strategies.characters" title="hypothesis.strategies.characters"><code class="xref py py-func docutils literal"><span class="pre">characters()</span></code></a> now accepts
<code class="docutils literal"><span class="pre">whitelist_characters</span></code>, particular characters which will be added to those
it produces. (<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/668">issue #668</a>)</li>
<li>A bug fix for the internal function <code class="docutils literal"><span class="pre">_union_interval_lists()</span></code>, and a rename
to <code class="docutils literal"><span class="pre">_union_intervals()</span></code>. It now correctly handles all cases where intervals
overlap, and it always returns the result as a tuple for tuples.</li>
</ul>
<p>Thanks to Alex Willmer for these.</p>
</div>
<div class="section" id="id91">
<h2>3.17.0 - 2017-08-07<a class="headerlink" href="#id91" title="Permalink to this headline">¶</a></h2>
<p>This release documents <a class="reference internal" href="settings.html#phases"><span class="std std-ref">the previously undocumented phases feature</span></a>,
making it part of the public API. It also updates how the example
database is used. Principally:</p>
<ul class="simple">
<li>A <code class="docutils literal"><span class="pre">Phases.reuse</span></code> argument will now correctly control whether examples
from the database are run (it previously did exactly the wrong thing and
controlled whether examples would be <em>saved</em>).</li>
<li>Hypothesis will no longer try to rerun <em>all</em> previously failing examples.
Instead it will replay the smallest previously failing example and a
selection of other examples that are likely to trigger any other bugs that
will found. This prevents a previous failure from dominating your tests
unnecessarily.</li>
<li>As a result of the previous change, Hypothesis will be slower about clearing
out old examples from the database that are no longer failing (because it can
only clear out ones that it actually runs).</li>
</ul>
</div>
<div class="section" id="id92">
<h2>3.16.1 - 2017-08-07<a class="headerlink" href="#id92" title="Permalink to this headline">¶</a></h2>
<p>This release makes an implementation change to how Hypothesis handles certain
internal constructs.</p>
<p>The main effect you should see is improvement to the behaviour and performance
of collection types, especially ones with a <code class="docutils literal"><span class="pre">min_size</span></code> parameter. Many cases
that would previously fail due to being unable to generate enough valid
examples will now succeed, and other cases should run slightly faster.</p>
</div>
<div class="section" id="id93">
<h2>3.16.0 - 2017-08-04<a class="headerlink" href="#id93" title="Permalink to this headline">¶</a></h2>
<p>This release introduces a deprecation of the timeout feature. This results in
the following changes:</p>
<ul class="simple">
<li>Creating a settings object with an explicit timeout will emit a deprecation
warning.</li>
<li>If your test stops because it hits the timeout (and has not found a bug) then
it will emit a deprecation warning.</li>
<li>There is a new value <code class="docutils literal"><span class="pre">unlimited</span></code> which you can import from hypothesis.
<code class="docutils literal"><span class="pre">settings(timeout=unlimited)</span></code> will <em>not</em> cause a deprecation warning.</li>
<li>There is a new health check, <code class="docutils literal"><span class="pre">hung_test</span></code>, which will trigger after a test
has been running for five minutes if it is not suppressed.</li>
</ul>
</div>
<div class="section" id="id94">
<h2>3.15.0 - 2017-08-04<a class="headerlink" href="#id94" title="Permalink to this headline">¶</a></h2>
<p>This release deprecates two strategies, <a class="reference internal" href="data.html#hypothesis.strategies.choices" title="hypothesis.strategies.choices"><code class="xref py py-func docutils literal"><span class="pre">choices()</span></code></a> and
<a class="reference internal" href="data.html#hypothesis.strategies.streaming" title="hypothesis.strategies.streaming"><code class="xref py py-func docutils literal"><span class="pre">streaming()</span></code></a>.</p>
<p>Both of these are somewhat confusing to use and are entirely redundant since the
introduction of the <a class="reference internal" href="data.html#hypothesis.strategies.data" title="hypothesis.strategies.data"><code class="xref py py-func docutils literal"><span class="pre">data()</span></code></a> strategy for interactive
drawing in tests, and their use should be replaced with direct use of
<a class="reference internal" href="data.html#hypothesis.strategies.data" title="hypothesis.strategies.data"><code class="xref py py-func docutils literal"><span class="pre">data()</span></code></a> instead.</p>
</div>
<div class="section" id="id95">
<h2>3.14.2 - 2017-08-03<a class="headerlink" href="#id95" title="Permalink to this headline">¶</a></h2>
<p>This fixes a bug where Hypothesis would not work correctly on Python 2.7 if you
had the <code class="xref py py-mod docutils literal"><span class="pre">python:typing</span></code> module <a class="reference external" href="https://pypi.python.org/pypi/typing">backport</a> installed.</p>
</div>
<div class="section" id="id96">
<h2>3.14.1 - 2017-08-02<a class="headerlink" href="#id96" title="Permalink to this headline">¶</a></h2>
<p>This raises the maximum depth at which Hypothesis starts cutting off data
generation to a more reasonable value which it is harder to hit by accident.</p>
<p>This resolves (<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/751">issue #751</a>), in which some examples which previously worked
would start timing out, but it will also likely improve the data generation
quality for complex data types.</p>
</div>
<div class="section" id="id97">
<h2>3.14.0 - 2017-07-23<a class="headerlink" href="#id97" title="Permalink to this headline">¶</a></h2>
<p>Hypothesis now understands inline type annotations (<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/293">issue #293</a>):</p>
<ul class="simple">
<li>If the target of <a class="reference internal" href="data.html#hypothesis.strategies.builds" title="hypothesis.strategies.builds"><code class="xref py py-func docutils literal"><span class="pre">builds()</span></code></a> has type annotations,
a default strategy for missing required arguments is selected based on the
type. Type-based strategy selection will only override a default if you
pass <code class="xref py py-const docutils literal"><span class="pre">hypothesis.infer</span></code> as a keyword argument.</li>
<li>If <a class="reference internal" href="details.html#hypothesis.given" title="hypothesis.given"><code class="xref py py-func docutils literal"><span class="pre">@given</span></code></a> wraps a function with type annotations,
you can pass <code class="xref py py-const docutils literal"><span class="pre">infer</span></code> as a keyword argument and the
appropriate strategy will be substituted.</li>
<li>You can check what strategy will be inferred for a type with the new
<a class="reference internal" href="data.html#hypothesis.strategies.from_type" title="hypothesis.strategies.from_type"><code class="xref py py-func docutils literal"><span class="pre">from_type()</span></code></a> function.</li>
<li><a class="reference internal" href="data.html#hypothesis.strategies.register_type_strategy" title="hypothesis.strategies.register_type_strategy"><code class="xref py py-func docutils literal"><span class="pre">register_type_strategy()</span></code></a> teaches Hypothesis
which strategy to infer for custom or unknown types. You can provide a
strategy, or for more complex cases a function which takes the type and
returns a strategy.</li>
</ul>
</div>
<div class="section" id="id98">
<h2>3.13.1 - 2017-07-20<a class="headerlink" href="#id98" title="Permalink to this headline">¶</a></h2>
<p>This is a bug fix release for <a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/514">issue #514</a> - Hypothesis would continue running
examples after a <code class="xref py py-class docutils literal"><span class="pre">SkipTest</span></code> exception was raised,
including printing a falsifying example. Skip exceptions from the standard
<code class="xref py py-mod docutils literal"><span class="pre">python:unittest</span></code> module, and <code class="docutils literal"><span class="pre">pytest</span></code>, <code class="docutils literal"><span class="pre">nose</span></code>, or <code class="docutils literal"><span class="pre">unittest2</span></code>
modules now abort the test immediately without printing output.</p>
</div>
<div class="section" id="id99">
<h2>3.13.0 - 2017-07-16<a class="headerlink" href="#id99" title="Permalink to this headline">¶</a></h2>
<p>This release has two major aspects to it: The first is the introduction of
<a class="reference internal" href="data.html#hypothesis.strategies.deferred" title="hypothesis.strategies.deferred"><code class="xref py py-func docutils literal"><span class="pre">deferred()</span></code></a>, which allows more natural definition
of recursive (including mutually recursive) strategies.</p>
<p>The second is a number of engine changes designed to support this sort of
strategy better. These should have a knock-on effect of also improving the
performance of any existing strategies that currently generate a lot of data
or involve heavy nesting by reducing their typical example size.</p>
</div>
<div class="section" id="id100">
<h2>3.12.0 - 2017-07-07<a class="headerlink" href="#id100" title="Permalink to this headline">¶</a></h2>
<p>This release makes some major internal changes to how Hypothesis represents
data internally, as a prelude to some major engine changes that should improve
data quality. There are no API changes, but it’s a significant enough internal
change that a minor version bump seemed warranted.</p>
<p>User facing impact should be fairly mild, but includes:</p>
<ul class="simple">
<li>All existing examples in the database will probably be invalidated. Hypothesis
handles this automatically, so you don’t need to do anything, but if you see
all your examples disappear that’s why.</li>
<li>Almost all data distributions have changed significantly. Possibly for the better,
possibly for the worse. This may result in new bugs being found, but it may
also result in Hypothesis being unable to find bugs it previously did.</li>
<li>Data generation may be somewhat faster if your existing bottleneck was in
draw_bytes (which is often the case for large examples).</li>
<li>Shrinking will probably be slower, possibly significantly.</li>
</ul>
<p>If you notice any effects you consider to be a significant regression, please
open an issue about them.</p>
</div>
<div class="section" id="id101">
<h2>3.11.6 - 2017-06-19<a class="headerlink" href="#id101" title="Permalink to this headline">¶</a></h2>
<p>This release involves no functionality changes, but is the first to ship wheels
as well as an sdist.</p>
</div>
<div class="section" id="id102">
<h2>3.11.5 - 2017-06-18<a class="headerlink" href="#id102" title="Permalink to this headline">¶</a></h2>
<p>This release provides a performance improvement to shrinking. For cases where
there is some non-trivial “boundary” value (e.g. the bug happens for all values
greater than some other value), shrinking should now be substantially faster.
Other types of bug will likely see improvements too.</p>
<p>This may also result in some changes to the quality of the final examples - it
may sometimes be better, but is more likely to get slightly worse in some edge
cases. If you see any examples where this happens in practice, please report
them.</p>
</div>
<div class="section" id="id103">
<h2>3.11.4 - 2017-06-17<a class="headerlink" href="#id103" title="Permalink to this headline">¶</a></h2>
<p>This is a bugfix release: Hypothesis now prints explicit examples when
running in verbose mode. (<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/313">issue #313</a>)</p>
</div>
<div class="section" id="id104">
<h2>3.11.3 - 2017-06-11<a class="headerlink" href="#id104" title="Permalink to this headline">¶</a></h2>
<p>This is a bugfix release: Hypothesis no longer emits a warning if you try to
use <a class="reference internal" href="data.html#hypothesis.strategies.sampled_from" title="hypothesis.strategies.sampled_from"><code class="xref py py-func docutils literal"><span class="pre">sampled_from()</span></code></a> with
<code class="xref py py-class docutils literal"><span class="pre">python:collections.OrderedDict</span></code>. (<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/688">issue #688</a>)</p>
</div>
<div class="section" id="id105">
<h2>3.11.2 - 2017-06-10<a class="headerlink" href="#id105" title="Permalink to this headline">¶</a></h2>
<p>This is a documentation release. Several outdated snippets have been updated
or removed, and many cross-references are now hyperlinks.</p>
</div>
<div class="section" id="id106">
<h2>3.11.1 - 2017-05-28<a class="headerlink" href="#id106" title="Permalink to this headline">¶</a></h2>
<p>This is a minor ergonomics release. Tracebacks shown by pytest no longer
include Hypothesis internals for test functions decorated with <a class="reference internal" href="details.html#hypothesis.given" title="hypothesis.given"><code class="xref py py-func docutils literal"><span class="pre">@given</span></code></a>.</p>
</div>
<div class="section" id="id107">
<h2>3.11.0 - 2017-05-23<a class="headerlink" href="#id107" title="Permalink to this headline">¶</a></h2>
<p>This is a feature release, adding datetime-related strategies to the core strategies.</p>
<p><code class="xref py py-func docutils literal"><span class="pre">timezones()</span></code> allows you to sample pytz timezones from
the Olsen database. Use directly in a recipe for tz-aware datetimes, or
compose with <a class="reference internal" href="data.html#hypothesis.strategies.none" title="hypothesis.strategies.none"><code class="xref py py-func docutils literal"><span class="pre">none()</span></code></a> to allow a mix of aware and naive output.</p>
<p>The new <a class="reference internal" href="data.html#hypothesis.strategies.dates" title="hypothesis.strategies.dates"><code class="xref py py-func docutils literal"><span class="pre">dates()</span></code></a>, <a class="reference internal" href="data.html#hypothesis.strategies.times" title="hypothesis.strategies.times"><code class="xref py py-func docutils literal"><span class="pre">times()</span></code></a>,
<a class="reference internal" href="data.html#hypothesis.strategies.datetimes" title="hypothesis.strategies.datetimes"><code class="xref py py-func docutils literal"><span class="pre">datetimes()</span></code></a>, and <a class="reference internal" href="data.html#hypothesis.strategies.timedeltas" title="hypothesis.strategies.timedeltas"><code class="xref py py-func docutils literal"><span class="pre">timedeltas()</span></code></a>
strategies are all constrained by objects of their type.
This means that you can generate dates bounded by a single day
(i.e. a single date), or datetimes constrained to the microsecond.</p>
<p><a class="reference internal" href="data.html#hypothesis.strategies.times" title="hypothesis.strategies.times"><code class="xref py py-func docutils literal"><span class="pre">times()</span></code></a> and <a class="reference internal" href="data.html#hypothesis.strategies.datetimes" title="hypothesis.strategies.datetimes"><code class="xref py py-func docutils literal"><span class="pre">datetimes()</span></code></a>
take an optional <code class="docutils literal"><span class="pre">timezones=</span></code> argument, which
defaults to <a class="reference internal" href="data.html#hypothesis.strategies.none" title="hypothesis.strategies.none"><code class="xref py py-func docutils literal"><span class="pre">none()</span></code></a> for naive times. You can use our extra strategy
based on pytz, or roll your own timezones strategy with dateutil or even
the standard library.</p>
<p>The old <code class="docutils literal"><span class="pre">dates</span></code>, <code class="docutils literal"><span class="pre">times</span></code>, and <code class="docutils literal"><span class="pre">datetimes</span></code> strategies in
<code class="docutils literal"><span class="pre">hypothesis.extra.datetimes</span></code> are deprecated in favor of the new
core strategies, which are more flexible and have no dependencies.</p>
</div>
<div class="section" id="id108">
<h2>3.10.0 - 2017-05-22<a class="headerlink" href="#id108" title="Permalink to this headline">¶</a></h2>
<p>Hypothesis now uses <code class="xref py py-func docutils literal"><span class="pre">python:inspect.getfullargspec()</span></code> internally.
On Python 2, there are no visible changes.</p>
<p>On Python 3 <a class="reference internal" href="details.html#hypothesis.given" title="hypothesis.given"><code class="xref py py-func docutils literal"><span class="pre">@given</span></code></a> and <a class="reference internal" href="data.html#hypothesis.strategies.composite" title="hypothesis.strategies.composite"><code class="xref py py-func docutils literal"><span class="pre">@composite</span></code></a>
now preserve <span class="target" id="index-2"></span><a class="pep reference external" href="https://www.python.org/dev/peps/pep-3107"><strong>PEP 3107</strong></a> annotations on the
decorated function. Keyword-only arguments are now either handled correctly
(e.g. <a class="reference internal" href="data.html#hypothesis.strategies.composite" title="hypothesis.strategies.composite"><code class="xref py py-func docutils literal"><span class="pre">@composite</span></code></a>), or caught in validation instead of silently discarded
or raising an unrelated error later (e.g. <a class="reference internal" href="details.html#hypothesis.given" title="hypothesis.given"><code class="xref py py-func docutils literal"><span class="pre">@given</span></code></a>).</p>
</div>
<div class="section" id="id109">
<h2>3.9.1 - 2017-05-22<a class="headerlink" href="#id109" title="Permalink to this headline">¶</a></h2>
<p>This is a bugfix release: the default field mapping for a DateTimeField in the
Django extra now respects the <code class="docutils literal"><span class="pre">USE_TZ</span></code> setting when choosing a strategy.</p>
</div>
<div class="section" id="id110">
<h2>3.9.0 - 2017-05-19<a class="headerlink" href="#id110" title="Permalink to this headline">¶</a></h2>
<p>This is feature release, expanding the capabilities of the
<a class="reference internal" href="data.html#hypothesis.strategies.decimals" title="hypothesis.strategies.decimals"><code class="xref py py-func docutils literal"><span class="pre">decimals()</span></code></a> strategy.</p>
<ul class="simple">
<li>The new (optional) <code class="docutils literal"><span class="pre">places</span></code> argument allows you to generate decimals with
a certain number of places (e.g. cents, thousandths, satoshis).</li>
<li>If allow_infinity is None, setting min_bound no longer excludes positive
infinity and setting max_value no longer excludes negative infinity.</li>
<li>All of <code class="docutils literal"><span class="pre">NaN</span></code>, <code class="docutils literal"><span class="pre">-Nan</span></code>, <code class="docutils literal"><span class="pre">sNaN</span></code>, and <code class="docutils literal"><span class="pre">-sNaN</span></code> may now be drawn if
allow_nan is True, or if allow_nan is None and min_value or max_value is None.</li>
<li>min_value and max_value may be given as decimal strings, e.g. <code class="docutils literal"><span class="pre">"1.234"</span></code>.</li>
</ul>
</div>
<div class="section" id="id111">
<h2>3.8.5 - 2017-05-16<a class="headerlink" href="#id111" title="Permalink to this headline">¶</a></h2>
<p>Hypothesis now imports <code class="xref py py-mod docutils literal"><span class="pre">python:sqlite3</span></code> when a SQLite database is used, rather
than at module load, improving compatibility with Python implementations
compiled without SQLite support (such as BSD or Jython).</p>
</div>
<div class="section" id="id112">
<h2>3.8.4 - 2017-05-16<a class="headerlink" href="#id112" title="Permalink to this headline">¶</a></h2>
<p>This is a compatibility bugfix release. <code class="docutils literal"><span class="pre">sampled_from</span></code> no longer raises
a deprecation warning when sampling from an <code class="docutils literal"><span class="pre">Enum</span></code>, as all enums have a
reliable iteration order.</p>
</div>
<div class="section" id="id113">
<h2>3.8.3 - 2017-05-09<a class="headerlink" href="#id113" title="Permalink to this headline">¶</a></h2>
<p>This release removes a version check for older versions of pytest when using
the Hypothesis pytest plugin. The pytest plugin will now run unconditionally
on all versions of pytest. This breaks compatibility with any version of pytest
prior to 2.7.0 (which is more than two years old).</p>
<p>The primary reason for this change is that the version check was a frequent
source of breakage when pytest change their versioning scheme. If you are not
working on pytest itself and are not running a very old version of it, this
release probably doesn’t affect you.</p>
</div>
<div class="section" id="id114">
<h2>3.8.2 - 2017-04-26<a class="headerlink" href="#id114" title="Permalink to this headline">¶</a></h2>
<p>This is a code reorganisation release that moves some internal test helpers
out of the main source tree so as to not have changes to them trigger releases
in future.</p>
</div>
<div class="section" id="id115">
<h2>3.8.1 - 2017-04-26<a class="headerlink" href="#id115" title="Permalink to this headline">¶</a></h2>
<p>This is a documentation release. Almost all code examples are now doctests
checked in CI, eliminating stale examples.</p>
</div>
<div class="section" id="id116">
<h2>3.8.0 - 2017-04-23<a class="headerlink" href="#id116" title="Permalink to this headline">¶</a></h2>
<p>This is a feature release, adding the <a class="reference internal" href="data.html#hypothesis.strategies.iterables" title="hypothesis.strategies.iterables"><code class="xref py py-func docutils literal"><span class="pre">iterables()</span></code></a> strategy, equivalent
to <code class="docutils literal"><span class="pre">lists(...).map(iter)</span></code> but with a much more useful repr. You can use
this strategy to check that code doesn’t accidentally depend on sequence
properties such as indexing support or repeated iteration.</p>
</div>
<div class="section" id="id117">
<h2>3.7.4 - 2017-04-22<a class="headerlink" href="#id117" title="Permalink to this headline">¶</a></h2>
<p>This is a bug fix release for a single bug:</p>
<ul class="simple">
<li>In 3.7.3, using <a class="reference internal" href="reproducing.html#hypothesis.example" title="hypothesis.example"><code class="xref py py-func docutils literal"><span class="pre">@example</span></code></a> and a pytest fixture in the same test could
cause the test to fail to fill the arguments, and throw a TypeError.</li>
</ul>
</div>
<div class="section" id="id118">
<h2>3.7.3 - 2017-04-21<a class="headerlink" href="#id118" title="Permalink to this headline">¶</a></h2>
<p>This release should include no user visible changes and is purely a refactoring
release. This modularises the behaviour of the core <a class="reference internal" href="details.html#hypothesis.given" title="hypothesis.given"><code class="xref py py-func docutils literal"><span class="pre">given()</span></code></a> function, breaking
it up into smaller and more accessible parts, but its actual behaviour should
remain unchanged.</p>
</div>
<div class="section" id="id119">
<h2>3.7.2 - 2017-04-21<a class="headerlink" href="#id119" title="Permalink to this headline">¶</a></h2>
<p>This reverts an undocumented change in 3.7.1 which broke installation on
debian stable: The specifier for the hypothesis[django] extra_requires had
introduced a wild card, which was not supported on the default version of pip.</p>
</div>
<div class="section" id="id120">
<h2>3.7.1 - 2017-04-21<a class="headerlink" href="#id120" title="Permalink to this headline">¶</a></h2>
<p>This is a bug fix and internal improvements release.</p>
<ul class="simple">
<li>In particular Hypothesis now tracks a tree of where it has already explored.
This allows it to avoid some classes of duplicate examples, and significantly
improves the performance of shrinking failing examples by allowing it to
skip some shrinks that it can determine can’t possibly work.</li>
<li>Hypothesis will no longer seed the global random arbitrarily unless you have
asked it to using <a class="reference internal" href="data.html#hypothesis.strategies.random_module" title="hypothesis.strategies.random_module"><code class="xref py py-meth docutils literal"><span class="pre">random_module()</span></code></a></li>
<li>Shrinking would previously have not worked correctly in some special cases
on Python 2, and would have resulted in suboptimal examples.</li>
</ul>
</div>
<div class="section" id="id121">
<h2>3.7.0 - 2017-03-20<a class="headerlink" href="#id121" title="Permalink to this headline">¶</a></h2>
<p>This is a feature release.</p>
<p>New features:</p>
<ul class="simple">
<li>Rule based stateful testing now has an <a class="reference internal" href="stateful.html#hypothesis.stateful.invariant" title="hypothesis.stateful.invariant"><code class="xref py py-func docutils literal"><span class="pre">@invariant</span></code></a> decorator that specifies
methods that are run after init and after every step, allowing you to
encode properties that should be true at all times. Thanks to Tom Prince for
this feature.</li>
<li>The <a class="reference internal" href="data.html#hypothesis.strategies.decimals" title="hypothesis.strategies.decimals"><code class="xref py py-func docutils literal"><span class="pre">decimals()</span></code></a> strategy now supports <code class="docutils literal"><span class="pre">allow_nan</span></code> and <code class="docutils literal"><span class="pre">allow_infinity</span></code> flags.</li>
<li>There are <a class="reference internal" href="numpy.html#hypothesis-numpy"><span class="std std-ref">significantly more strategies available for numpy</span></a>, including for
generating arbitrary data types. Thanks to Zac Hatfield Dodds for this
feature.</li>
<li>When using the <a class="reference internal" href="data.html#hypothesis.strategies.data" title="hypothesis.strategies.data"><code class="xref py py-func docutils literal"><span class="pre">data()</span></code></a> strategy you can now add a label as an argument to
<code class="docutils literal"><span class="pre">draw()</span></code>, which will be printed along with the value when an example fails.
Thanks to Peter Inglesby for this feature.</li>
</ul>
<p>Bug fixes:</p>
<ul class="simple">
<li>Bug fix: <a class="reference internal" href="data.html#hypothesis.strategies.composite" title="hypothesis.strategies.composite"><code class="xref py py-func docutils literal"><span class="pre">composite()</span></code></a> now preserves functions’ docstrings.</li>
<li>The build is now reproducible and doesn’t depend on the path you build it
from. Thanks to Chris Lamb for this feature.</li>
<li>numpy strategies for the void data type did not work correctly. Thanks to
Zac Hatfield Dodds for this fix.</li>
</ul>
<p>There have also been a number of performance optimizations:</p>
<ul class="simple">
<li>The <a class="reference internal" href="data.html#hypothesis.strategies.permutations" title="hypothesis.strategies.permutations"><code class="xref py py-func docutils literal"><span class="pre">permutations()</span></code></a> strategy is now significantly faster to use for large
lists (the underlying algorithm has gone from O(n^2) to O(n)).</li>
<li>Shrinking of failing test cases should have got significantly faster in
some circumstances where it was previously struggling for a long time.</li>
<li>Example generation now involves less indirection, which results in a small
speedup in some cases (small enough that you won’t really notice it except in
pathological cases).</li>
</ul>
</div>
<div class="section" id="id122">
<h2>3.6.1 - 2016-12-20<a class="headerlink" href="#id122" title="Permalink to this headline">¶</a></h2>
<p>This release fixes a dependency problem and makes some small behind the scenes
improvements.</p>
<ul class="simple">
<li>The fake-factory dependency was renamed to faker. If you were depending on
it through hypothesis[django] or hypothesis[fake-factory] without pinning it
yourself then it would have failed to install properly. This release changes
it so that hypothesis[fakefactory] (which can now also be installed as
hypothesis[faker]) will install the renamed faker package instead.</li>
<li>This release also removed the dependency of hypothesis[django] on
hypothesis[fakefactory] - it was only being used for emails. These now use
a custom strategy that isn’t from fakefactory. As a result you should also
see performance improvements of tests which generated User objects or other
things with email fields, as well as better shrinking of email addresses.</li>
<li>The distribution of code using nested calls to <a class="reference internal" href="data.html#hypothesis.strategies.one_of" title="hypothesis.strategies.one_of"><code class="xref py py-func docutils literal"><span class="pre">one_of()</span></code></a> or the <code class="docutils literal"><span class="pre">|</span></code> operator for
combining strategies has been improved, as branches are now flattened to give
a more uniform distribution.</li>
<li>Examples using <a class="reference internal" href="data.html#hypothesis.strategies.composite" title="hypothesis.strategies.composite"><code class="xref py py-func docutils literal"><span class="pre">composite()</span></code></a> or <code class="docutils literal"><span class="pre">.flatmap</span></code> should now shrink better. In particular
this will affect things which work by first generating a length and then
generating that many items, which have historically not shrunk very well.</li>
</ul>
</div>
<div class="section" id="id123">
<h2>3.6.0 - 2016-10-31<a class="headerlink" href="#id123" title="Permalink to this headline">¶</a></h2>
<p>This release reverts Hypothesis to its old pretty printing of lambda functions
based on attempting to extract the source code rather than decompile the bytecode.
This is unfortunately slightly inferior in some cases and may result in you
occasionally seeing things like <code class="docutils literal"><span class="pre">lambda</span> <span class="pre">x:</span> <span class="pre"><unknown></span></code> in statistics reports and
strategy reprs.</p>
<p>This removes the dependencies on uncompyle6, xdis and spark-parser.</p>
<p>The reason for this is that the new functionality was based on uncompyle6, which
turns out to introduce a hidden GPLed dependency - it in turn depended on xdis,
and although the library was licensed under the MIT license, it contained some
GPL licensed source code and thus should have been released under the GPL.</p>
<p>My interpretation is that Hypothesis itself was never in violation of the GPL
(because the license it is under, the Mozilla Public License v2, is fully
compatible with being included in a GPL licensed work), but I have not consulted
a lawyer on the subject. Regardless of the answer to this question, adding a
GPLed dependency will likely cause a lot of users of Hypothesis to inadvertently
be in violation of the GPL.</p>
<p>As a result, if you are running Hypothesis 3.5.x you really should upgrade to
this release immediately.</p>
</div>
<div class="section" id="id124">
<h2>3.5.3 - 2016-10-05<a class="headerlink" href="#id124" title="Permalink to this headline">¶</a></h2>
<p>This is a bug fix release.</p>
<p>Bugs fixed:</p>
<ul class="simple">
<li>If the same test was running concurrently in two processes and there were
examples already in the test database which no longer failed, Hypothesis
would sometimes fail with a FileNotFoundError (IOError on Python 2) because
an example it was trying to read was deleted before it was read. (<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/372">issue #372</a>).</li>
<li>Drawing from an <a class="reference internal" href="data.html#hypothesis.strategies.integers" title="hypothesis.strategies.integers"><code class="xref py py-func docutils literal"><span class="pre">integers()</span></code></a> strategy with both a min_value and a max_value
would reject too many examples needlessly. Now it repeatedly redraws until
satisfied. (<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/pulls/366">pull request #366</a>. Thanks to Calen Pennington for the contribution).</li>
</ul>
</div>
<div class="section" id="id125">
<h2>3.5.2 - 2016-09-24<a class="headerlink" href="#id125" title="Permalink to this headline">¶</a></h2>
<p>This is a bug fix release.</p>
<ul class="simple">
<li>The Hypothesis pytest plugin broke pytest support for doctests. Now it doesn’t.</li>
</ul>
</div>
<div class="section" id="id126">
<h2>3.5.1 - 2016-09-23<a class="headerlink" href="#id126" title="Permalink to this headline">¶</a></h2>
<p>This is a bug fix release.</p>
<ul class="simple">
<li>Hypothesis now runs cleanly in -B and -BB modes, avoiding mixing bytes and unicode.</li>
<li><code class="xref py py-class docutils literal"><span class="pre">python:unittest.TestCase</span></code> tests would not have shown up in the new statistics mode. Now they
do.</li>
<li>Similarly, stateful tests would not have shown up in statistics and now they do.</li>
<li>Statistics now print with pytest node IDs (the names you’d get in pytest verbose mode).</li>
</ul>
</div>
<div class="section" id="id127">
<h2>3.5.0 - 2016-09-22<a class="headerlink" href="#id127" title="Permalink to this headline">¶</a></h2>
<p>This is a feature release.</p>
<ul class="simple">
<li><a class="reference internal" href="data.html#hypothesis.strategies.fractions" title="hypothesis.strategies.fractions"><code class="xref py py-func docutils literal"><span class="pre">fractions()</span></code></a> and <a class="reference internal" href="data.html#hypothesis.strategies.decimals" title="hypothesis.strategies.decimals"><code class="xref py py-func docutils literal"><span class="pre">decimals()</span></code></a> strategies now support min_value and max_value
parameters. Thanks go to Anne Mulhern for the development of this feature.</li>
<li>The Hypothesis pytest plugin now supports a –hypothesis-show-statistics parameter
that gives detailed statistics about the tests that were run. Huge thanks to
Jean-Louis Fuchs and Adfinis-SyGroup for funding the development of this feature.</li>
<li>There is a new <a class="reference internal" href="details.html#hypothesis.event" title="hypothesis.event"><code class="xref py py-func docutils literal"><span class="pre">event()</span></code></a> function that can be used to add custom statistics.</li>
</ul>
<p>Additionally there have been some minor bug fixes:</p>
<ul class="simple">
<li>In some cases Hypothesis should produce fewer duplicate examples (this will mostly
only affect cases with a single parameter).</li>
<li>py.test command line parameters are now under an option group for Hypothesis (thanks
to David Keijser for fixing this)</li>
<li>Hypothesis would previously error if you used <span class="target" id="index-3"></span><a class="pep reference external" href="https://www.python.org/dev/peps/pep-3107"><strong>PEP 3107</strong></a> function annotations on your tests under
Python 3.4.</li>
<li>The repr of many strategies using lambdas has been improved to include the lambda body
(this was previously supported in many but not all cases).</li>
</ul>
</div>
<div class="section" id="id128">
<h2>3.4.2 - 2016-07-13<a class="headerlink" href="#id128" title="Permalink to this headline">¶</a></h2>
<p>This is a bug fix release, fixing a number of problems with the settings system:</p>
<ul class="simple">
<li>Test functions defined using <a class="reference internal" href="details.html#hypothesis.given" title="hypothesis.given"><code class="xref py py-func docutils literal"><span class="pre">@given</span></code></a> can now be called from other threads
(<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/337">issue #337</a>)</li>
<li>Attempting to delete a settings property would previously have silently done
the wrong thing. Now it raises an AttributeError.</li>
<li>Creating a settings object with a custom database_file parameter was silently
getting ignored and the default was being used instead. Now it’s not.</li>
</ul>
</div>
<div class="section" id="id129">
<h2>3.4.1 - 2016-07-07<a class="headerlink" href="#id129" title="Permalink to this headline">¶</a></h2>
<p>This is a bug fix release for a single bug:</p>
<ul class="simple">
<li>On Windows when running two Hypothesis processes in parallel (e.g. using
pytest-xdist) they could race with each other and one would raise an exception
due to the non-atomic nature of file renaming on Windows and the fact that you
can’t rename over an existing file. This is now fixed.</li>
</ul>
</div>
<div class="section" id="id130">
<h2>3.4.0 - 2016-05-27<a class="headerlink" href="#id130" title="Permalink to this headline">¶</a></h2>
<p>This release is entirely provided by <a class="reference external" href="https://github.com/lucaswiman">Lucas Wiman</a>:</p>
<p>Strategies constructed by <code class="xref py py-func docutils literal"><span class="pre">models()</span></code> will now respect much more of
Django’s validations out of the box. Wherever possible full_clean() should
succeed.</p>
<p>In particular:</p>
<ul class="simple">
<li>The max_length, blank and choices kwargs are now respected.</li>
<li>Add support for DecimalField.</li>
<li>If a field includes validators, the list of validators are used to filter the field strategy.</li>
</ul>
</div>
<div class="section" id="id131">
<h2>3.3.0 - 2016-05-27<a class="headerlink" href="#id131" title="Permalink to this headline">¶</a></h2>
<p>This release went wrong and is functionally equivalent to 3.2.0. Ignore it.</p>
</div>
<div class="section" id="id132">
<h2>3.2.0 - 2016-05-19<a class="headerlink" href="#id132" title="Permalink to this headline">¶</a></h2>
<p>This is a small single-feature release:</p>
<ul class="simple">
<li>All tests using <a class="reference internal" href="details.html#hypothesis.given" title="hypothesis.given"><code class="xref py py-func docutils literal"><span class="pre">@given</span></code></a> now fix the global random seed. This removes the health
check for that. If a non-zero seed is required for the final falsifying
example, it will be reported. Otherwise Hypothesis will assume randomization
was not a significant factor for the test and be silent on the subject. If you
use <a class="reference internal" href="data.html#hypothesis.strategies.random_module" title="hypothesis.strategies.random_module"><code class="xref py py-func docutils literal"><span class="pre">random_module()</span></code></a> this will continue to work and will always
display the seed.</li>
</ul>
</div>
<div class="section" id="id133">
<h2>3.1.3 - 2016-05-01<a class="headerlink" href="#id133" title="Permalink to this headline">¶</a></h2>
<p>Single bug fix release</p>
<ul class="simple">
<li>Another charmap problem. In 3.1.2 <a class="reference internal" href="data.html#hypothesis.strategies.text" title="hypothesis.strategies.text"><code class="xref py py-func docutils literal"><span class="pre">text()</span></code></a> and
<a class="reference internal" href="data.html#hypothesis.strategies.characters" title="hypothesis.strategies.characters"><code class="xref py py-func docutils literal"><span class="pre">characters()</span></code></a> would break on systems
which had <code class="docutils literal"><span class="pre">/tmp</span></code> mounted on a different partition than the Hypothesis storage
directory (usually in home). This fixes that.</li>
</ul>
</div>
<div class="section" id="id134">
<h2>3.1.2 - 2016-04-30<a class="headerlink" href="#id134" title="Permalink to this headline">¶</a></h2>
<p>Single bug fix release:</p>
<ul class="simple">
<li>Anything which used a <a class="reference internal" href="data.html#hypothesis.strategies.text" title="hypothesis.strategies.text"><code class="xref py py-func docutils literal"><span class="pre">text()</span></code></a> or
<a class="reference internal" href="data.html#hypothesis.strategies.characters" title="hypothesis.strategies.characters"><code class="xref py py-func docutils literal"><span class="pre">characters()</span></code></a> strategy was broken on Windows
and I hadn’t updated appveyor to use the new repository location so I didn’t
notice. This is now fixed and windows support should work correctly.</li>
</ul>
</div>
<div class="section" id="id135">
<h2>3.1.1 - 2016-04-29<a class="headerlink" href="#id135" title="Permalink to this headline">¶</a></h2>
<p>Minor bug fix release.</p>
<ul class="simple">
<li>Fix concurrency issue when running tests that use <a class="reference internal" href="data.html#hypothesis.strategies.text" title="hypothesis.strategies.text"><code class="xref py py-func docutils literal"><span class="pre">text()</span></code></a> from multiple
processes at once (<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/302">issue #302</a>, thanks to Alex Chan).</li>
<li>Improve performance of code using <a class="reference internal" href="data.html#hypothesis.strategies.lists" title="hypothesis.strategies.lists"><code class="xref py py-func docutils literal"><span class="pre">lists()</span></code></a> with max_size (thanks to
Cristi Cobzarenco).</li>
<li>Fix install on Python 2 with ancient versions of pip so that it installs the
enum34 backport (thanks to Donald Stufft for telling me how to do this).</li>
<li>Remove duplicated __all__ exports from hypothesis.strategies (thanks to
Piët Delport).</li>
<li>Update headers to point to new repository location.</li>
<li>Allow use of strategies that can’t be used in <a class="reference internal" href="details.html#hypothesis.find" title="hypothesis.find"><code class="xref py py-func docutils literal"><span class="pre">find()</span></code></a>
(e.g. <a class="reference internal" href="data.html#hypothesis.strategies.choices" title="hypothesis.strategies.choices"><code class="xref py py-func docutils literal"><span class="pre">choices()</span></code></a>) in stateful testing.</li>
</ul>
</div>
<div class="section" id="id136">
<h2>3.1.0 - 2016-03-06<a class="headerlink" href="#id136" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Add a <a class="reference internal" href="data.html#hypothesis.strategies.nothing" title="hypothesis.strategies.nothing"><code class="xref py py-func docutils literal"><span class="pre">nothing()</span></code></a> strategy that never successfully generates values.</li>
<li><a class="reference internal" href="data.html#hypothesis.strategies.sampled_from" title="hypothesis.strategies.sampled_from"><code class="xref py py-func docutils literal"><span class="pre">sampled_from()</span></code></a> and <a class="reference internal" href="data.html#hypothesis.strategies.one_of" title="hypothesis.strategies.one_of"><code class="xref py py-func docutils literal"><span class="pre">one_of()</span></code></a>
can both now be called with an empty argument
list, in which case they also never generate any values.</li>
<li><a class="reference internal" href="data.html#hypothesis.strategies.one_of" title="hypothesis.strategies.one_of"><code class="xref py py-func docutils literal"><span class="pre">one_of()</span></code></a> may now be called with a single argument that is a collection of strategies
as well as as varargs.</li>
<li>Add a <a class="reference internal" href="data.html#hypothesis.strategies.runner" title="hypothesis.strategies.runner"><code class="xref py py-func docutils literal"><span class="pre">runner()</span></code></a> strategy which returns the instance of the current test object
if there is one.</li>
<li>‘Bundle’ for RuleBasedStateMachine is now a normal(ish) strategy and can be used
as such.</li>
<li>Tests using RuleBasedStateMachine should now shrink significantly better.</li>
<li>Hypothesis now uses a pretty-printing library internally, compatible with IPython’s
pretty printing protocol (actually using the same code). This may improve the quality
of output in some cases.</li>
<li>As a ‘phases’ setting that allows more fine grained control over which parts of the
process Hypothesis runs</li>
<li>Add a suppress_health_check setting which allows you to turn off specific health checks
in a fine grained manner.</li>
<li>Fix a bug where lists of non fixed size would always draw one more element than they
included. This mostly didn’t matter, but if would cause problems with empty strategies
or ones with side effects.</li>
<li>Add a mechanism to the Django model generator to allow you to explicitly request the
default value (thanks to Jeremy Thurgood for this one).</li>
</ul>
</div>
<div class="section" id="id137">
<h2>3.0.5 - 2016-02-25<a class="headerlink" href="#id137" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fix a bug where Hypothesis would now error on py.test development versions.</li>
</ul>
</div>
<div class="section" id="id138">
<h2>3.0.4 - 2016-02-24<a class="headerlink" href="#id138" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fix a bug where Hypothesis would error when running on Python 2.7.3 or
earlier because it was trying to pass a <code class="xref py py-class docutils literal"><span class="pre">python:bytearray</span></code> object
to <code class="xref py py-func docutils literal"><span class="pre">python:struct.unpack()</span></code> (which is only supported since 2.7.4).</li>
</ul>
</div>
<div class="section" id="id139">
<h2>3.0.3 - 2016-02-23<a class="headerlink" href="#id139" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fix version parsing of py.test to work with py.test release candidates</li>
<li>More general handling of the health check problem where things could fail because
of a cache miss - now one “free” example is generated before the start of the
health check run.</li>
</ul>
</div>
<div class="section" id="id140">
<h2>3.0.2 - 2016-02-18<a class="headerlink" href="#id140" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Under certain circumstances, strategies involving <a class="reference internal" href="data.html#hypothesis.strategies.text" title="hypothesis.strategies.text"><code class="xref py py-func docutils literal"><span class="pre">text()</span></code></a> buried inside some
other strategy (e.g. <code class="docutils literal"><span class="pre">text().filter(...)</span></code> or <code class="docutils literal"><span class="pre">recursive(text(),</span> <span class="pre">...))</span></code> would cause
a test to fail its health checks the first time it ran. This was caused by having
to compute some related data and cache it to disk. On travis or anywhere else
where the <code class="docutils literal"><span class="pre">.hypothesis</span></code> directory was recreated this would have caused the tests
to fail their health check on every run. This is now fixed for all the known cases,
although there could be others lurking.</li>
</ul>
</div>
<div class="section" id="id141">
<h2>3.0.1 - 2016-02-18<a class="headerlink" href="#id141" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fix a case where it was possible to trigger an “Unreachable” assertion when
running certain flaky stateful tests.</li>
<li>Improve shrinking of large stateful tests by eliminating a case where it was
hard to delete early steps.</li>
<li>Improve efficiency of drawing <a class="reference internal" href="data.html#hypothesis.strategies.binary" title="hypothesis.strategies.binary"><code class="xref py py-func docutils literal"><span class="pre">binary(min_size=n,</span> <span class="pre">max_size=n)</span></code></a> significantly by
provide a custom implementation for fixed size blocks that can bypass a lot
of machinery.</li>
<li>Set default home directory based on the current working directory at the
point Hypothesis is imported, not whenever the function first happens to be
called.</li>
</ul>
</div>
<div class="section" id="id142">
<h2>3.0.0 - 2016-02-17<a class="headerlink" href="#id142" title="Permalink to this headline">¶</a></h2>
<p>Codename: This really should have been 2.1.</p>
<p>Externally this looks like a very small release. It has one small breaking change
that probably doesn’t affect anyone at all (some behaviour that never really worked
correctly is now outright forbidden) but necessitated a major version bump and one
visible new feature.</p>
<p>Internally this is a complete rewrite. Almost nothing other than the public API is
the same.</p>
<p>New features:</p>
<ul class="simple">
<li>Addition of <a class="reference internal" href="data.html#hypothesis.strategies.data" title="hypothesis.strategies.data"><code class="xref py py-func docutils literal"><span class="pre">data()</span></code></a> strategy which allows you to draw arbitrary data interactively
within the test.</li>
<li>New “exploded” database format which allows you to more easily check the example
database into a source repository while supporting merging.</li>
<li>Better management of how examples are saved in the database.</li>
<li>Health checks will now raise as errors when they fail. It was too easy to have
the warnings be swallowed entirely.</li>
</ul>
<p>New limitations:</p>
<ul class="simple">
<li><a class="reference internal" href="data.html#hypothesis.strategies.choices" title="hypothesis.strategies.choices"><code class="xref py py-func docutils literal"><span class="pre">choices()</span></code></a> and <a class="reference internal" href="data.html#hypothesis.strategies.streaming" title="hypothesis.strategies.streaming"><code class="xref py py-func docutils literal"><span class="pre">streaming()</span></code></a>
strategies may no longer be used with <a class="reference internal" href="details.html#hypothesis.find" title="hypothesis.find"><code class="xref py py-func docutils literal"><span class="pre">find()</span></code></a>. Neither may
<a class="reference internal" href="data.html#hypothesis.strategies.data" title="hypothesis.strategies.data"><code class="xref py py-func docutils literal"><span class="pre">data()</span></code></a> (this is the change that necessitated a major version bump).</li>
</ul>
<p>Feature removal:</p>
<ul class="simple">
<li>The ForkingTestCase executor has gone away. It may return in some more working
form at a later date.</li>
</ul>
<p>Performance improvements:</p>
<ul class="simple">
<li>A new model which allows flatmap, composite strategies and stateful testing to
perform <em>much</em> better. They should also be more reliable.</li>
<li>Filtering may in some circumstances have improved significantly. This will
help especially in cases where you have lots of values with individual filters
on them, such as lists(x.filter(…)).</li>
<li>Modest performance improvements to the general test runner by avoiding expensive
operations</li>
</ul>
<p>In general your tests should have got faster. If they’ve instead got significantly
slower, I’m interested in hearing about it.</p>
<p>Data distribution:</p>
<p>The data distribution should have changed significantly. This may uncover bugs the
previous version missed. It may also miss bugs the previous version could have
uncovered. Hypothesis is now producing less strongly correlated data than it used
to, but the correlations are extended over more of the structure.</p>
<p>Shrinking:</p>
<p>Shrinking quality should have improved. In particular Hypothesis can now perform
simultaneous shrinking of separate examples within a single test (previously it
was only able to do this for elements of a single collection). In some cases
performance will have improved, in some cases it will have got worse but generally
shouldn’t have by much.</p>
</div>
<div class="section" id="id143">
<h2>2.0.0 - 2016-01-10<a class="headerlink" href="#id143" title="Permalink to this headline">¶</a></h2>
<p>Codename: A new beginning</p>
<p>This release cleans up all of the legacy that accrued in the course of
Hypothesis 1.0. These are mostly things that were emitting deprecation warnings
in 1.19.0, but there were a few additional changes.</p>
<p>In particular:</p>
<ul class="simple">
<li>non-strategy values will no longer be converted to strategies when used in
given or find.</li>
<li>FailedHealthCheck is now an error and not a warning.</li>
<li>Handling of non-ascii reprs in user types have been simplified by using raw
strings in more places in Python 2.</li>
<li>given no longer allows mixing positional and keyword arguments.</li>
<li>given no longer works with functions with defaults.</li>
<li>given no longer turns provided arguments into defaults - they will not appear
in the argspec at all.</li>
<li>the basic() strategy no longer exists.</li>
<li>the n_ary_tree strategy no longer exists.</li>
<li>the average_list_length setting no longer exists. Note: If you’re using
using recursive() this will cause you a significant slow down. You should
pass explicit average_size parameters to collections in recursive calls.</li>
<li>@rule can no longer be applied to the same method twice.</li>
<li>Python 2.6 and 3.3 are no longer officially supported, although in practice
they still work fine.</li>
</ul>
<p>This also includes two non-deprecation changes:</p>
<ul class="simple">
<li>given’s keyword arguments no longer have to be the rightmost arguments and
can appear anywhere in the method signature.</li>
<li>The max_shrinks setting would sometimes not have been respected.</li>
</ul>
</div>
<div class="section" id="id144">
<h2>1.19.0 - 2016-01-09<a class="headerlink" href="#id144" title="Permalink to this headline">¶</a></h2>
<p>Codename: IT COMES</p>
<p>This release heralds the beginning of a new and terrible age of Hypothesis 2.0.</p>
<p>It’s primary purpose is some final deprecations prior to said release. The goal
is that if your code emits no warnings under this release then it will probably run
unchanged under Hypothesis 2.0 (there are some caveats to this: 2.0 will drop
support for some Python versions, and if you’re using internal APIs then as usual
that may break without warning).</p>
<p>It does have two new features:</p>
<ul class="simple">
<li>New @seed() decorator which allows you to manually seed a test. This may be
harmlessly combined with and overrides the derandomize setting.</li>
<li>settings objects may now be used as a decorator to fix those settings to a
particular @given test.</li>
</ul>
<p>API changes (old usage still works but is deprecated):</p>
<ul class="simple">
<li>Settings has been renamed to settings (lower casing) in order to make the
decorator usage more natural.</li>
<li>Functions for the storage directory that were in hypothesis.settings are now
in a new hypothesis.configuration module.</li>
</ul>
<p>Additional deprecations:</p>
<ul class="simple">
<li>the average_list_length setting has been deprecated in favour of being
explicit.</li>
<li>the basic() strategy has been deprecated as it is impossible to support
it under a Conjecture based model, which will hopefully be implemented at
some point in the 2.x series.</li>
<li>the n_ary_tree strategy (which was never actually part of the public API)
has been deprecated.</li>
<li>Passing settings or random as keyword arguments to given is deprecated (use
the new functionality instead)</li>
</ul>
<p>Bug fixes:</p>
<ul class="simple">
<li>No longer emit PendingDeprecationWarning for __iter__ and StopIteration in
streaming() values.</li>
<li>When running in health check mode with non strict, don’t print quite so
many errors for an exception in reify.</li>
<li>When an assumption made in a test or a filter is flaky, tests will now
raise Flaky instead of UnsatisfiedAssumption.</li>
</ul>
</div>
<div class="section" id="id146">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.18.0/">1.18.1</a> - 2015-12-22<a class="headerlink" href="#id146" title="Permalink to this headline">¶</a></h2>
<p>Two behind the scenes changes:</p>
<ul class="simple">
<li>Hypothesis will no longer write generated code to the file system. This
will improve performance on some systems (e.g. if you’re using
<a class="reference external" href="https://www.pythonanywhere.com/">PythonAnywhere</a> which is running your
code from NFS) and prevent some annoying interactions with auto-restarting
systems.</li>
<li>Hypothesis will cache the creation of some strategies. This can significantly
improve performance for code that uses flatmap or composite and thus has to
instantiate strategies a lot.</li>
</ul>
</div>
<div class="section" id="id148">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.18.0/">1.18.0</a> - 2015-12-21<a class="headerlink" href="#id148" title="Permalink to this headline">¶</a></h2>
<p>Features:</p>
<ul class="simple">
<li>Tests and find are now explicitly seeded off the global random module. This
means that if you nest one inside the other you will now get a health check
error. It also means that you can control global randomization by seeding
random.</li>
<li>There is a new random_module() strategy which seeds the global random module
for you and handles things so that you don’t get a health check warning if
you use it inside your tests.</li>
<li>floats() now accepts two new arguments: allow_nan and allow_infinity. These
default to the old behaviour, but when set to False will do what the names
suggest.</li>
</ul>
<p>Bug fixes:</p>
<ul class="simple">
<li>Fix a bug where tests that used text() on Python 3.4+ would not actually be
deterministic even when explicitly seeded or using the derandomize mode,
because generation depended on dictionary iteration order which was affected
by hash randomization.</li>
<li>Fix a bug where with complicated strategies the timing of the initial health
check could affect the seeding of the subsequent test, which would also
render supposedly deterministic tests non-deterministic in some scenarios.</li>
<li>In some circumstances flatmap() could get confused by two structurally
similar things it could generate and would produce a flaky test where the
first time it produced an error but the second time it produced the other
value, which was not an error. The same bug was presumably also possible in
composite().</li>
<li>flatmap() and composite() initial generation should now be moderately faster.
This will be particularly noticeable when you have many values drawn from the
same strategy in a single run, e.g. constructs like lists(s.flatmap(f)).
Shrinking performance <em>may</em> have suffered, but this didn’t actually produce
an interestingly worse result in any of the standard scenarios tested.</li>
</ul>
</div>
<div class="section" id="id150">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.17.1/">1.17.1</a> - 2015-12-16<a class="headerlink" href="#id150" title="Permalink to this headline">¶</a></h2>
<p>A small bug fix release, which fixes the fact that the ‘note’ function could
not be used on tests which used the @example decorator to provide explicit
examples.</p>
</div>
<div class="section" id="id152">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.17.0/">1.17.0</a> - 2015-12-15<a class="headerlink" href="#id152" title="Permalink to this headline">¶</a></h2>
<p>This is actually the same release as 1.16.1, but 1.16.1 has been pulled because
it contains the following additional change that was not intended to be in a
patch release (it’s perfectly stable, but is a larger change that should have
required a minor version bump):</p>
<ul class="simple">
<li>Hypothesis will now perform a series of “health checks” as part of running
your tests. These detect and warn about some common error conditions that
people often run into which wouldn’t necessarily have caused the test to fail
but would cause e.g. degraded performance or confusing results.</li>
</ul>
</div>
<div class="section" id="id154">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.16.1/">1.16.1</a> - 2015-12-14<a class="headerlink" href="#id154" title="Permalink to this headline">¶</a></h2>
<p>Note: This release has been removed.</p>
<p>A small bugfix release that allows bdists for Hypothesis to be built
under 2.7 - the compat3.py file which had Python 3 syntax wasn’t intended
to be loaded under Python 2, but when building a bdist it was. In particular
this would break running setup.py test.</p>
</div>
<div class="section" id="id156">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.16.0/">1.16.0</a> - 2015-12-08<a class="headerlink" href="#id156" title="Permalink to this headline">¶</a></h2>
<p>There are no public API changes in this release but it includes a behaviour
change that I wasn’t comfortable putting in a patch release.</p>
<ul class="simple">
<li>Functions from hypothesis.strategies will no longer raise InvalidArgument
on bad arguments. Instead the same errors will be raised when a test
using such a strategy is run. This may improve startup time in some
cases, but the main reason for it is so that errors in strategies
won’t cause errors in loading, and it can interact correctly with things
like pytest.mark.skipif.</li>
<li>Errors caused by accidentally invoking the legacy API are now much less
confusing, although still throw NotImplementedError.</li>
<li>hypothesis.extra.django is 1.9 compatible.</li>
<li>When tests are run with max_shrinks=0 this will now still rerun the test
on failure and will no longer print “Trying example:” before each run.
Additionally note() will now work correctly when used with max_shrinks=0.</li>
</ul>
</div>
<div class="section" id="id158">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.15.0/">1.15.0</a> - 2015-11-24<a class="headerlink" href="#id158" title="Permalink to this headline">¶</a></h2>
<p>A release with two new features.</p>
<ul class="simple">
<li>A ‘characters’ strategy for more flexible generation of text with particular
character ranges and types, kindly contributed by <a class="reference external" href="https://github.com/kxepal">Alexander Shorin</a>.</li>
<li>Add support for preconditions to the rule based stateful testing. Kindly
contributed by <a class="reference external" href="https://github.com/radix">Christopher Armstrong</a></li>
</ul>
</div>
<div class="section" id="id160">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.14.0/">1.14.0</a> - 2015-11-01<a class="headerlink" href="#id160" title="Permalink to this headline">¶</a></h2>
<p>New features:</p>
<ul class="simple">
<li>Add ‘note’ function which lets you include additional information in the
final test run’s output.</li>
<li>Add ‘choices’ strategy which gives you a choice function that emulates
random.choice.</li>
<li>Add ‘uuid’ strategy that generates UUIDs’</li>
<li>Add ‘shared’ strategy that lets you create a strategy that just generates a
single shared value for each test run</li>
</ul>
<p>Bugs:</p>
<ul class="simple">
<li>Using strategies of the form streaming(x.flatmap(f)) with find or in stateful
testing would have caused InvalidArgument errors when the resulting values
were used (because code that expected to only be called within a test context
would be invoked).</li>
</ul>
</div>
<div class="section" id="id162">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.13.0/">1.13.0</a> - 2015-10-29<a class="headerlink" href="#id162" title="Permalink to this headline">¶</a></h2>
<p>This is quite a small release, but deprecates some public API functions
and removes some internal API functionality so gets a minor version bump.</p>
<ul class="simple">
<li>All calls to the ‘strategy’ function are now deprecated, even ones which
pass just a SearchStrategy instance (which is still a no-op).</li>
<li>Never documented hypothesis.extra entry_points mechanism has now been removed (
it was previously how hypothesis.extra packages were loaded and has been deprecated
and unused for some time)</li>
<li>Some corner cases that could previously have produced an OverflowError when simplifying
failing cases using hypothesis.extra.datetimes (or dates or times) have now been fixed.</li>
<li>Hypothesis load time for first import has been significantly reduced - it used to be
around 250ms (on my SSD laptop) and now is around 100-150ms. This almost never
matters but was slightly annoying when using it in the console.</li>
<li>hypothesis.strategies.randoms was previously missing from __all__.</li>
</ul>
</div>
<div class="section" id="id164">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.12.0/">1.12.0</a> - 2015-10-18<a class="headerlink" href="#id164" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Significantly improved performance of creating strategies using the functions
from the hypothesis.strategies module by deferring the calculation of their
repr until it was needed. This is unlikely to have been an performance issue
for you unless you were using flatmap, composite or stateful testing, but for
some cases it could be quite a significant impact.</li>
<li>A number of cases where the repr of strategies build from lambdas is improved</li>
<li>Add dates() and times() strategies to hypothesis.extra.datetimes</li>
<li>Add new ‘profiles’ mechanism to the settings system</li>
<li>Deprecates mutability of Settings, both the Settings.default top level property
and individual settings.</li>
<li>A Settings object may now be directly initialized from a parent Settings.</li>
<li>@given should now give a better error message if you attempt to use it with a
function that uses destructuring arguments (it still won’t work, but it will
error more clearly),</li>
<li>A number of spelling corrections in error messages</li>
<li>py.test should no longer display the intermediate modules Hypothesis generates
when running in verbose mode</li>
<li>Hypothesis should now correctly handle printing objects with non-ascii reprs
on python 3 when running in a locale that cannot handle ascii printing to
stdout.</li>
<li>Add a unique=True argument to lists(). This is equivalent to
unique_by=lambda x: x, but offers a more convenient syntax.</li>
</ul>
</div>
<div class="section" id="id166">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.11.4/">1.11.4</a> - 2015-09-27<a class="headerlink" href="#id166" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Hide modifications Hypothesis needs to make to sys.path by undoing them
after we’ve imported the relevant modules. This is a workaround for issues
cryptography experienced on windows.</li>
<li>Slightly improved performance of drawing from sampled_from on large lists
of alternatives.</li>
<li>Significantly improved performance of drawing from one_of or strategies
using | (note this includes a lot of strategies internally - floats()
and integers() both fall into this category). There turned out to be a
massive performance regression introduced in 1.10.0 affecting these which
probably would have made tests using Hypothesis significantly slower than
they should have been.</li>
</ul>
</div>
<div class="section" id="id168">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.11.3/">1.11.3</a> - 2015-09-23<a class="headerlink" href="#id168" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Better argument validation for datetimes() strategy - previously setting
max_year < datetime.MIN_YEAR or min_year > datetime.MAX_YEAR would not have
raised an InvalidArgument error and instead would have behaved confusingly.</li>
<li>Compatibility with being run on pytest < 2.7 (achieved by disabling the
plugin).</li>
</ul>
</div>
<div class="section" id="id170">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.11.2/">1.11.2</a> - 2015-09-23<a class="headerlink" href="#id170" title="Permalink to this headline">¶</a></h2>
<p>Bug fixes:</p>
<ul class="simple">
<li>Settings(database=my_db) would not be correctly inherited when used as a
default setting, so that newly created settings would use the database_file
setting and create an SQLite example database.</li>
<li>Settings.default.database = my_db would previously have raised an error and
now works.</li>
<li>Timeout could sometimes be significantly exceeded if during simplification
there were a lot of examples tried that didn’t trigger the bug.</li>
<li>When loading a heavily simplified example using a basic() strategy from the
database this could cause Python to trigger a recursion error.</li>
<li>Remove use of deprecated API in pytest plugin so as to not emit warning</li>
</ul>
<p>Misc:</p>
<ul class="simple">
<li>hypothesis-pytest is now part of hypothesis core. This should have no
externally visible consequences, but you should update your dependencies to
remove hypothesis-pytest and depend on only Hypothesis.</li>
<li>Better repr for hypothesis.extra.datetimes() strategies.</li>
<li>Add .close() method to abstract base class for Backend (it was already present
in the main implementation).</li>
</ul>
</div>
<div class="section" id="id172">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.11.1/">1.11.1</a> - 2015-09-16<a class="headerlink" href="#id172" title="Permalink to this headline">¶</a></h2>
<p>Bug fixes:</p>
<ul class="simple">
<li>When running Hypothesis tests in parallel (e.g. using pytest-xdist) there was a race
condition caused by code generation.</li>
<li>Example databases are now cached per thread so as to not use sqlite connections from
multiple threads. This should make Hypothesis now entirely thread safe.</li>
<li>floats() with only min_value or max_value set would have had a very bad distribution.</li>
<li>Running on 3.5, Hypothesis would have emitted deprecation warnings because of use of
inspect.getargspec</li>
</ul>
</div>
<div class="section" id="id174">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.11.0/">1.11.0</a> - 2015-08-31<a class="headerlink" href="#id174" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>text() with a non-string alphabet would have used the repr() of the the alphabet
instead of its contexts. This is obviously silly. It now works with any sequence
of things convertible to unicode strings.</li>
<li>@given will now work on methods whose definitions contains no explicit positional
arguments, only varargs (<a class="reference external" href="https://github.com/HypothesisWorks/hypothesis-python/issues/118">bug #118</a>).
This may have some knock on effects because it means that @given no longer changes the
argspec of functions other than by adding defaults.</li>
<li>Introduction of new @composite feature for more natural definition of strategies you’d
previously have used flatmap for.</li>
</ul>
</div>
<div class="section" id="id176">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.10.6/">1.10.6</a> - 2015-08-26<a class="headerlink" href="#id176" title="Permalink to this headline">¶</a></h2>
<p>Fix support for fixtures on Django 1.7.</p>
</div>
<div class="section" id="id177">
<h2>1.10.4 - 2015-08-21<a class="headerlink" href="#id177" title="Permalink to this headline">¶</a></h2>
<p>Tiny bug fix release:</p>
<ul class="simple">
<li>If the database_file setting is set to None, this would have resulted in
an error when running tests. Now it does the same as setting database to
None.</li>
</ul>
</div>
<div class="section" id="id179">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.10.3/">1.10.3</a> - 2015-08-19<a class="headerlink" href="#id179" title="Permalink to this headline">¶</a></h2>
<p>Another small bug fix release.</p>
<ul class="simple">
<li>lists(elements, unique_by=some_function, min_size=n) would have raised a
ValidationError if n > Settings.default.average_list_length because it would
have wanted to use an average list length shorter than the minimum size of
the list, which is impossible. Now it instead defaults to twice the minimum
size in these circumstances.</li>
<li>basic() strategy would have only ever produced at most ten distinct values
per run of the test (which is bad if you e.g. have it inside a list). This
was obviously silly. It will now produce a much better distribution of data,
both duplicated and non duplicated.</li>
</ul>
</div>
<div class="section" id="id181">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.10.2/">1.10.2</a> - 2015-08-19<a class="headerlink" href="#id181" title="Permalink to this headline">¶</a></h2>
<p>This is a small bug fix release:</p>
<ul class="simple">
<li>star imports from hypothesis should now work correctly.</li>
<li>example quality for examples using flatmap will be better, as the way it had
previously been implemented was causing problems where Hypothesis was
erroneously labelling some examples as being duplicates.</li>
</ul>
</div>
<div class="section" id="id183">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.10.0/">1.10.0</a> - 2015-08-04<a class="headerlink" href="#id183" title="Permalink to this headline">¶</a></h2>
<p>This is just a bugfix and performance release, but it changes some
semi-public APIs, hence the minor version bump.</p>
<ul class="simple">
<li>Significant performance improvements for strategies which are one_of()
many branches. In particular this included recursive() strategies. This
should take the case where you use one recursive() strategy as the base
strategy of another from unusably slow (tens of seconds per generated
example) to reasonably fast.</li>
<li>Better handling of just() and sampled_from() for values which have an
incorrect __repr__ implementation that returns non-ASCII unicode
on Python 2.</li>
<li>Better performance for flatmap from changing the internal morpher API
to be significantly less general purpose.</li>
<li>Introduce a new semi-public BuildContext/cleanup API. This allows
strategies to register cleanup activities that should run once the
example is complete. Note that this will interact somewhat weirdly with
find.</li>
<li>Better simplification behaviour for streaming strategies.</li>
<li>Don’t error on lambdas which use destructuring arguments in Python 2.</li>
<li>Add some better reprs for a few strategies that were missing good ones.</li>
<li>The Random instances provided by randoms() are now copyable.</li>
<li>Slightly more debugging information about simplify when using a debug
verbosity level.</li>
<li>Support using given for functions with varargs, but not passing arguments
to it as positional.</li>
</ul>
</div>
<div class="section" id="id185">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.9.0/">1.9.0</a> - 2015-07-27<a class="headerlink" href="#id185" title="Permalink to this headline">¶</a></h2>
<p>Codename: The great bundling.</p>
<p>This release contains two fairly major changes.</p>
<p>The first is the deprecation of the hypothesis-extra mechanism. From
now on all the packages that were previously bundled under it other
than hypothesis-pytest (which is a different beast and will remain
separate). The functionality remains unchanged and you can still import
them from exactly the same location, they just are no longer separate
packages.</p>
<p>The second is that this introduces a new way of building strategies
which lets you build up strategies recursively from other strategies.</p>
<p>It also contains the minor change that calling .example() on a
strategy object will give you examples that are more representative of
the actual data you’ll get. There used to be some logic in there to make
the examples artificially simple but this proved to be a bad idea.</p>
</div>
<div class="section" id="id187">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.8.5/">1.8.5</a> - 2015-07-24<a class="headerlink" href="#id187" title="Permalink to this headline">¶</a></h2>
<p>This contains no functionality changes but fixes a mistake made with
building the previous package that would have broken installation on
Windows.</p>
</div>
<div class="section" id="id189">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.8.4/">1.8.4</a> - 2015-07-20<a class="headerlink" href="#id189" title="Permalink to this headline">¶</a></h2>
<p>Bugs fixed:</p>
<ul class="simple">
<li>When a call to floats() had endpoints which were not floats but merely
convertible to one (e.g. integers), these would be included in the generated
data which would cause it to generate non-floats.</li>
<li>Splitting lambdas used in the definition of flatmap, map or filter over
multiple lines would break the repr, which would in turn break their usage.</li>
</ul>
</div>
<div class="section" id="id191">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.8.3/">1.8.3</a> - 2015-07-20<a class="headerlink" href="#id191" title="Permalink to this headline">¶</a></h2>
<p>“Falsifying example” would not have been printed when the failure came from an
explicit example.</p>
</div>
<div class="section" id="id193">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.8.2/">1.8.2</a> - 2015-07-18<a class="headerlink" href="#id193" title="Permalink to this headline">¶</a></h2>
<p>Another small bugfix release:</p>
<ul class="simple">
<li>When using ForkingTestCase you would usually not get the falsifying example
printed if the process exited abnormally (e.g. due to os._exit).</li>
<li>Improvements to the distribution of characters when using text() with a
default alphabet. In particular produces a better distribution of ascii and
whitespace in the alphabet.</li>
</ul>
</div>
<div class="section" id="id194">
<h2>1.8.1 - 2015-07-17<a class="headerlink" href="#id194" title="Permalink to this headline">¶</a></h2>
<p>This is a small release that contains a workaround for people who have
bad reprs returning non ascii text on Python 2.7. This is not a bug fix
for Hypothesis per se because that’s not a thing that is actually supposed
to work, but Hypothesis leans more heavily on repr than is typical so it’s
worth having a workaround for.</p>
</div>
<div class="section" id="id196">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.8.0/">1.8.0</a> - 2015-07-16<a class="headerlink" href="#id196" title="Permalink to this headline">¶</a></h2>
<p>New features:</p>
<ul class="simple">
<li>Much more sensible reprs for strategies, especially ones that come from
hypothesis.strategies. These should now have as reprs python code that
would produce the same strategy.</li>
<li>lists() accepts a unique_by argument which forces the generated lists to be
only contain elements unique according to some function key (which must
return a hashable value).</li>
<li>Better error messages from flaky tests to help you debug things.</li>
</ul>
<p>Mostly invisible implementation details that may result in finding new bugs
in your code:</p>
<ul class="simple">
<li>Sets and dictionary generation should now produce a better range of results.</li>
<li>floats with bounds now focus more on ‘critical values’, trying to produce
values at edge cases.</li>
<li>flatmap should now have better simplification for complicated cases, as well
as generally being (I hope) more reliable.</li>
</ul>
<p>Bug fixes:</p>
<ul class="simple">
<li>You could not previously use assume() if you were using the forking executor.</li>
</ul>
</div>
<div class="section" id="id198">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.7.2/">1.7.2</a> - 2015-07-10<a class="headerlink" href="#id198" title="Permalink to this headline">¶</a></h2>
<p>This is purely a bug fix release:</p>
<ul class="simple">
<li>When using floats() with stale data in the database you could sometimes get
values in your tests that did not respect min_value or max_value.</li>
<li>When getting a Flaky error from an unreliable test it would have incorrectly
displayed the example that caused it.</li>
<li>2.6 dependency on backports was incorrectly specified. This would only have
caused you problems if you were building a universal wheel from Hypothesis,
which is not how Hypothesis ships, so unless you’re explicitly building wheels
for your dependencies and support Python 2.6 plus a later version of Python
this probably would never have affected you.</li>
<li>If you use flatmap in a way that the strategy on the right hand side depends
sensitively on the left hand side you may have occasionally seen Flaky errors
caused by producing unreliable examples when minimizing a bug. This use case
may still be somewhat fraught to be honest. This code is due a major rearchitecture
for 1.8, but in the meantime this release fixes the only source of this error that
I’m aware of.</li>
</ul>
</div>
<div class="section" id="id200">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/1.7.1/">1.7.1</a> - 2015-06-29<a class="headerlink" href="#id200" title="Permalink to this headline">¶</a></h2>
<p>Codename: There is no 1.7.0.</p>
<p>A slight technical hitch with a premature upload means there’s was a yanked
1.7.0 release. Oops.</p>
<p>The major feature of this release is Python 2.6 support. Thanks to Jeff Meadows
for doing most of the work there.</p>
<p>Other minor features</p>
<ul class="simple">
<li>strategies now has a permutations() function which returns a strategy
yielding permutations of values from a given collection.</li>
<li>if you have a flaky test it will print the exception that it last saw before
failing with Flaky, even if you do not have verbose reporting on.</li>
<li>Slightly experimental git merge script available as “python -m
hypothesis.tools.mergedbs”. Instructions on how to use it in the docstring
of that file.</li>
</ul>
<p>Bug fixes:</p>
<ul class="simple">
<li>Better performance from use of filter. In particular tests which involve large
numbers of heavily filtered strategies should perform a lot better.</li>
<li>floats() with a negative min_value would not have worked correctly (worryingly,
it would have just silently failed to run any examples). This is now fixed.</li>
<li>tests using sampled_from would error if the number of sampled elements was smaller
than min_satisfying_examples.</li>
</ul>
</div>
<div class="section" id="id201">
<h2>1.6.2 - 2015-06-08<a class="headerlink" href="#id201" title="Permalink to this headline">¶</a></h2>
<p>This is just a few small bug fixes:</p>
<ul class="simple">
<li>Size bounds were not validated for values for a binary() strategy when
reading examples from the database.</li>
<li>sampled_from is now in __all__ in hypothesis.strategies</li>
<li>floats no longer consider negative integers to be simpler than positive
non-integers</li>
<li>Small floating point intervals now correctly count members, so if you have a
floating point interval so narrow there are only a handful of values in it,
this will no longer cause an error when Hypothesis runs out of values.</li>
</ul>
</div>
<div class="section" id="id202">
<h2>1.6.1 - 2015-05-21<a class="headerlink" href="#id202" title="Permalink to this headline">¶</a></h2>
<p>This is a small patch release that fixes a bug where 1.6.0 broke the use
of flatmap with the deprecated API and assumed the passed in function returned
a SearchStrategy instance rather than converting it to a strategy.</p>
</div>
<div class="section" id="id204">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/v1.6.0/">1.6.0</a> - 2015-05-21<a class="headerlink" href="#id204" title="Permalink to this headline">¶</a></h2>
<p>This is a smallish release designed to fix a number of bugs and smooth out
some weird behaviours.</p>
<ul class="simple">
<li>Fix a critical bug in flatmap where it would reuse old strategies. If all
your flatmap code was pure you’re fine. If it’s not, I’m surprised it’s
working at all. In particular if you want to use flatmap with django models,
you desperately need to upgrade to this version.</li>
<li>flatmap simplification performance should now be better in some cases where
it previously had to redo work.</li>
<li>Fix for a bug where invalid unicode data with surrogates could be generated
during simplification (it was already filtered out during actual generation).</li>
<li>The Hypothesis database is now keyed off the name of the test instead of the
type of data. This makes much more sense now with the new strategies API and
is generally more robust. This means you will lose old examples on upgrade.</li>
<li>The database will now not delete values which fail to deserialize correctly,
just skip them. This is to handle cases where multiple incompatible strategies
share the same key.</li>
<li>find now also saves and loads values from the database, keyed off a hash of the
function you’re finding from.</li>
<li>Stateful tests now serialize and load values from the database. They should have
before, really. This was a bug.</li>
<li>Passing a different verbosity level into a test would not have worked entirely
correctly, leaving off some messages. This is now fixed.</li>
<li>Fix a bug where derandomized tests with unicode characters in the function
body would error on Python 2.7.</li>
</ul>
</div>
<div class="section" id="id206">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/v1.5.0/">1.5.0</a> - 2015-05-14<a class="headerlink" href="#id206" title="Permalink to this headline">¶</a></h2>
<p>Codename: Strategic withdrawal.</p>
<p>The purpose of this release is a radical simplification of the API for building
strategies. Instead of the old approach of @strategy.extend and things that
get converted to strategies, you just build strategies directly.</p>
<p>The old method of defining strategies will still work until Hypothesis 2.0,
because it’s a major breaking change, but will now emit deprecation warnings.</p>
<p>The new API is also a lot more powerful as the functions for defining strategies
give you a lot of dials to turn. See <a class="reference internal" href="data.html"><span class="doc">the updated data section</span></a> for
details.</p>
<p>Other changes:</p>
<blockquote>
<div><ul class="simple">
<li>Mixing keyword and positional arguments in a call to @given is deprecated as well.</li>
<li>There is a new setting called ‘strict’. When set to True, Hypothesis will raise
warnings instead of merely printing them. Turning it on by default is inadvisable because
it means that Hypothesis minor releases can break your code, but it may be useful for
making sure you catch all uses of deprecated APIs.</li>
<li>max_examples in settings is now interpreted as meaning the maximum number
of unique (ish) examples satisfying assumptions. A new setting max_iterations
which defaults to a larger value has the old interpretation.</li>
<li>Example generation should be significantly faster due to a new faster parameter
selection algorithm. This will mostly show up for simple data types - for complex
ones the parameter selection is almost certainly dominated.</li>
<li>Simplification has some new heuristics that will tend to cut down on cases
where it could previously take a very long time.</li>
<li>timeout would previously not have been respected in cases where there were a lot
of duplicate examples. You probably wouldn’t have previously noticed this because
max_examples counted duplicates, so this was very hard to hit in a way that mattered.</li>
<li>A number of internal simplifications to the SearchStrategy API.</li>
<li>You can now access the current Hypothesis version as hypothesis.__version__.</li>
<li>A top level function is provided for running the stateful tests without the
TestCase infrastructure.</li>
</ul>
</div></blockquote>
</div>
<div class="section" id="id208">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/v1.4.0/">1.4.0</a> - 2015-05-04<a class="headerlink" href="#id208" title="Permalink to this headline">¶</a></h2>
<p>Codename: What a state.</p>
<p>The <em>big</em> feature of this release is the new and slightly experimental
stateful testing API. You can read more about that in <a class="reference internal" href="stateful.html"><span class="doc">the
appropriate section</span></a>.</p>
<p>Two minor features the were driven out in the course of developing this:</p>
<ul class="simple">
<li>You can now set settings.max_shrinks to limit the number of times
Hypothesis will try to shrink arguments to your test. If this is set to
<= 0 then Hypothesis will not rerun your test and will just raise the
failure directly. Note that due to technical limitations if max_shrinks
is <= 0 then Hypothesis will print <em>every</em> example it calls your test
with rather than just the failing one. Note also that I don’t consider
settings max_shrinks to zero a sensible way to run your tests and it
should really be considered a debug feature.</li>
<li>There is a new debug level of verbosity which is even <em>more</em> verbose than
verbose. You probably don’t want this.</li>
</ul>
<p>Breakage of semi-public SearchStrategy API:</p>
<ul class="simple">
<li>It is now a required invariant of SearchStrategy that if u simplifies to
v then it is not the case that strictly_simpler(u, v). i.e. simplifying
should not <em>increase</em> the complexity even though it is not required to
decrease it. Enforcing this invariant lead to finding some bugs where
simplifying of integers, floats and sets was suboptimal.</li>
<li>Integers in basic data are now required to fit into 64 bits. As a result
python integer types are now serialized as strings, and some types have
stopped using quite so needlessly large random seeds.</li>
</ul>
<p>Hypothesis Stateful testing was then turned upon Hypothesis itself, which lead
to an amazing number of minor bugs being found in Hypothesis itself.</p>
<p>Bugs fixed (most but not all from the result of stateful testing) include:</p>
<ul class="simple">
<li>Serialization of streaming examples was flaky in a way that you would
probably never notice: If you generate a template, simplify it, serialize
it, deserialize it, serialize it again and then deserialize it you would
get the original stream instead of the simplified one.</li>
<li>If you reduced max_examples below the number of examples already saved in
the database, you would have got a ValueError. Additionally, if you had
more than max_examples in the database all of them would have been
considered.</li>
<li>@given will no longer count duplicate examples (which it never called
your function with) towards max_examples. This may result in your tests
running slower, but that’s probably just because they’re trying more
examples.</li>
<li>General improvements to example search which should result in better
performance and higher quality examples. In particular parameters which
have a history of producing useless results will be more aggressively
culled. This is useful both because it decreases the chance of useless
examples and also because it’s much faster to not check parameters which
we were unlikely to ever pick!</li>
<li>integers_from and lists of types with only one value (e.g. [None]) would
previously have had a very high duplication rate so you were probably
only getting a handful of examples. They now have a much lower
duplication rate, as well as the improvements to search making this
less of a problem in the first place.</li>
<li>You would sometimes see simplification taking significantly longer than
your defined timeout. This would happen because timeout was only being
checked after each <em>successful</em> simplification, so if Hypothesis was
spending a lot of time unsuccessfully simplifying things it wouldn’t
stop in time. The timeout is now applied for unsuccessful simplifications
too.</li>
<li>In Python 2.7, integers_from strategies would have failed during
simplification with an OverflowError if their starting point was at or
near to the maximum size of a 64-bit integer.</li>
<li>flatmap and map would have failed if called with a function without a
__name__ attribute.</li>
<li>If max_examples was less than min_satisfying_examples this would always
error. Now min_satisfying_examples is capped to max_examples. Note that
if you have assumptions to satisfy here this will still cause an error.</li>
</ul>
<p>Some minor quality improvements:</p>
<ul class="simple">
<li>Lists of streams, flatmapped strategies and basic strategies should now
now have slightly better simplification.</li>
</ul>
</div>
<div class="section" id="id210">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/v1.3.0/">1.3.0</a> - 2015-05-22<a class="headerlink" href="#id210" title="Permalink to this headline">¶</a></h2>
<p>New features:</p>
<ul class="simple">
<li>New verbosity level API for printing intermediate results and exceptions.</li>
<li>New specifier for strings generated from a specified alphabet.</li>
<li>Better error messages for tests that are failing because of a lack of enough
examples.</li>
</ul>
<p>Bug fixes:</p>
<ul class="simple">
<li>Fix error where use of ForkingTestCase would sometimes result in too many
open files.</li>
<li>Fix error where saving a failing example that used flatmap could error.</li>
<li>Implement simplification for sampled_from, which apparently never supported
it previously. Oops.</li>
</ul>
<p>General improvements:</p>
<ul class="simple">
<li>Better range of examples when using one_of or sampled_from.</li>
<li>Fix some pathological performance issues when simplifying lists of complex
values.</li>
<li>Fix some pathological performance issues when simplifying examples that
require unicode strings with high codepoints.</li>
<li>Random will now simplify to more readable examples.</li>
</ul>
</div>
<div class="section" id="id212">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/v1.2.1/">1.2.1</a> - 2015-04-16<a class="headerlink" href="#id212" title="Permalink to this headline">¶</a></h2>
<p>A small patch release for a bug in the new executors feature. Tests which require
doing something to their result in order to fail would have instead reported as
flaky.</p>
</div>
<div class="section" id="id214">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/v1.2.0/">1.2.0</a> - 2015-04-15<a class="headerlink" href="#id214" title="Permalink to this headline">¶</a></h2>
<p>Codename: Finders keepers.</p>
<p>A bunch of new features and improvements.</p>
<ul class="simple">
<li>Provide a mechanism for customizing how your tests are executed.</li>
<li>Provide a test runner that forks before running each example. This allows
better support for testing native code which might trigger a segfault or a C
level assertion failure.</li>
<li>Support for using Hypothesis to find examples directly rather than as just as
a test runner.</li>
<li>New streaming type which lets you generate infinite lazily loaded streams of
data - perfect for if you need a number of examples but don’t know how many.</li>
<li>Better support for large integer ranges. You can now use integers_in_range
with ranges of basically any size. Previously large ranges would have eaten
up all your memory and taken forever.</li>
<li>Integers produce a wider range of data than before - previously they would
only rarely produce integers which didn’t fit into a machine word. Now it’s
much more common. This percolates to other numeric types which build on
integers.</li>
<li>Better validation of arguments to @given. Some situations that would
previously have caused silently wrong behaviour will now raise an error.</li>
<li>Include +/- sys.float_info.max in the set of floating point edge cases that
Hypothesis specifically tries.</li>
<li>Fix some bugs in floating point ranges which happen when given
+/- sys.float_info.max as one of the endpoints… (really any two floats that
are sufficiently far apart so that x, y are finite but y - x is infinite).
This would have resulted in generating infinite values instead of ones inside
the range.</li>
</ul>
</div>
<div class="section" id="id216">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/v1.1.1/">1.1.1</a> - 2015-04-07<a class="headerlink" href="#id216" title="Permalink to this headline">¶</a></h2>
<p>Codename: Nothing to see here</p>
<p>This is just a patch release put out because it fixed some internal bugs that would
block the Django integration release but did not actually affect anything anyone could
previously have been using. It also contained a minor quality fix for floats that
I’d happened to have finished in time.</p>
<ul class="simple">
<li>Fix some internal bugs with object lifecycle management that were impossible to
hit with the previously released versions but broke hypothesis-django.</li>
<li>Bias floating point numbers somewhat less aggressively towards very small numbers</li>
</ul>
</div>
<div class="section" id="id218">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/v1.1.0/">1.1.0</a> - 2015-04-06<a class="headerlink" href="#id218" title="Permalink to this headline">¶</a></h2>
<p>Codename: No-one mention the M word.</p>
<ul class="simple">
<li>Unicode strings are more strongly biased towards ascii characters. Previously they
would generate all over the space. This is mostly so that people who try to
shape their unicode strings with assume() have less of a bad time.</li>
<li>A number of fixes to data deserialization code that could theoretically have
caused mysterious bugs when using an old version of a Hypothesis example
database with a newer version. To the best of my knowledge a change that could
have triggered this bug has never actually been seen in the wild. Certainly
no-one ever reported a bug of this nature.</li>
<li>Out of the box support for Decimal and Fraction.</li>
<li>new dictionary specifier for dictionaries with variable keys.</li>
<li>Significantly faster and higher quality simplification, especially for
collections of data.</li>
<li>New filter() and flatmap() methods on Strategy for better ways of building
strategies out of other strategies.</li>
<li>New BasicStrategy class which allows you to define your own strategies from
scratch without needing an existing matching strategy or being exposed to the
full horror or non-public nature of the SearchStrategy interface.</li>
</ul>
</div>
<div class="section" id="id220">
<h2><a class="reference external" href="https://hypothesis.readthedocs.io/en/v1.0.0/">1.0.0</a> - 2015-03-27<a class="headerlink" href="#id220" title="Permalink to this headline">¶</a></h2>
<p>Codename: Blast-off!</p>
<p>There are no code changes in this release. This is precisely the 0.9.2 release
with some updated documentation.</p>
</div>
<div class="section" id="id221">
<h2>0.9.2 - 2015-03-26<a class="headerlink" href="#id221" title="Permalink to this headline">¶</a></h2>
<p>Codename: T-1 days.</p>
<ul class="simple">
<li>floats_in_range would not actually have produced floats_in_range unless that
range happened to be (0, 1). Fix this.</li>
</ul>
</div>
<div class="section" id="id222">
<h2>0.9.1 - 2015-03-25<a class="headerlink" href="#id222" title="Permalink to this headline">¶</a></h2>
<p>Codename: T-2 days.</p>
<ul class="simple">
<li>Fix a bug where if you defined a strategy using map on a lambda then the results would not be saved in the database.</li>
<li>Significant performance improvements when simplifying examples using lists, strings or bounded integer ranges.</li>
</ul>
</div>
<div class="section" id="id223">
<h2>0.9.0 - 2015-03-23<a class="headerlink" href="#id223" title="Permalink to this headline">¶</a></h2>
<p>Codename: The final countdown</p>
<p>This release could also be called 1.0-RC1.</p>
<p>It contains a teeny tiny bugfix, but the real point of this release is to declare
feature freeze. There will be zero functionality changes between 0.9.0 and 1.0 unless
something goes really really wrong. No new features will be added, no breaking API changes
will occur, etc. This is the final shakedown before I declare Hypothesis stable and ready
to use and throw a party to celebrate.</p>
<p>Bug bounty for any bugs found between now and 1.0: I will buy you a drink (alcoholic,
caffeinated, or otherwise) and shake your hand should we ever find ourselves in the
same city at the same time.</p>
<p>The one tiny bugfix:</p>
<ul class="simple">
<li>Under pypy, databases would fail to close correctly when garbage collected, leading to a memory leak and a confusing error message if you were repeatedly creating databases and not closing them. It is very unlikely you were doing this and the chances of you ever having noticed this bug are very low.</li>
</ul>
</div>
<div class="section" id="id224">
<h2>0.7.2 - 2015-03-22<a class="headerlink" href="#id224" title="Permalink to this headline">¶</a></h2>
<p>Codename: Hygienic macros or bust</p>
<ul class="simple">
<li>You can now name an argument to @given ‘f’ and it won’t break (issue #38)</li>
<li>strategy_test_suite is now named strategy_test_suite as the documentation claims and not in fact strategy_test_suitee</li>
<li>Settings objects can now be used as a context manager to temporarily override the default values inside their context.</li>
</ul>
</div>
<div class="section" id="id225">
<h2>0.7.1 - 2015-03-21<a class="headerlink" href="#id225" title="Permalink to this headline">¶</a></h2>
<p>Codename: Point releases go faster</p>
<ul class="simple">
<li>Better string generation by parametrizing by a limited alphabet</li>
<li>Faster string simplification - previously if simplifying a string with high range unicode characters it would try every unicode character smaller than that. This was pretty pointless. Now it stops after it’s a short range (it can still reach smaller ones through recursive calls because of other simplifying operations).</li>
<li>Faster list simplification by first trying a binary chop down the middle</li>
<li>Simultaneous simplification of identical elements in a list. So if a bug only triggers when you have duplicates but you drew e.g. [-17, -17], this will now simplify to [0, 0].</li>
</ul>
</div>
<div class="section" id="id226">
<h2>0.7.0, - 2015-03-20<a class="headerlink" href="#id226" title="Permalink to this headline">¶</a></h2>
<p>Codename: Starting to look suspiciously real</p>
<p>This is probably the last minor release prior to 1.0. It consists of stability
improvements, a few usability things designed to make Hypothesis easier to try
out, and filing off some final rough edges from the API.</p>
<ul class="simple">
<li>Significant speed and memory usage improvements</li>
<li>Add an example() method to strategy objects to give an example of the sort of data that the strategy generates.</li>
<li>Remove .descriptor attribute of strategies</li>
<li>Rename descriptor_test_suite to strategy_test_suite</li>
<li>Rename the few remaining uses of descriptor to specifier (descriptor already has a defined meaning in Python)</li>
</ul>
</div>
<div class="section" id="id227">
<h2>0.6.0 - 2015-03-13<a class="headerlink" href="#id227" title="Permalink to this headline">¶</a></h2>
<p>Codename: I’m sorry, were you using that API?</p>
<p>This is primarily a “simplify all the weird bits of the API” release. As a result there are a lot of breaking changes. If
you just use @given with core types then you’re probably fine.</p>
<p>In particular:</p>
<ul class="simple">
<li>Stateful testing has been removed from the API</li>
<li>The way the database is used has been rendered less useful (sorry). The feature for reassembling values saved from other
tests doesn’t currently work. This will probably be brought back in post 1.0.</li>
<li>SpecificationMapper is no longer a thing. Instead there is an ExtMethod called strategy which you extend to specify how
to convert other types to strategies.</li>
<li>Settings are now extensible so you can add your own for configuring a strategy</li>
<li>MappedSearchStrategy no longer needs an unpack method</li>
<li>Basically all the SearchStrategy internals have changed massively. If you implemented SearchStrategy directly rather than
using MappedSearchStrategy talk to me about fixing it.</li>
<li>Change to the way extra packages work. You now specify the package. This
must have a load() method. Additionally any modules in the package will be
loaded in under hypothesis.extra</li>
</ul>
<p>Bug fixes:</p>
<ul class="simple">
<li>Fix for a bug where calling falsify on a lambda with a non-ascii character
in its body would error.</li>
</ul>
<p>Hypothesis Extra:</p>
<dl class="docutils">
<dt>hypothesis-fakefactory: An extension for using faker data in hypothesis. Depends</dt>
<dd>on fake-factory.</dd>
</dl>
</div>
<div class="section" id="id228">
<h2>0.5.0 - 2015-02-10<a class="headerlink" href="#id228" title="Permalink to this headline">¶</a></h2>
<p>Codename: Read all about it.</p>
<p>Core hypothesis:</p>
<ul class="simple">
<li>Add support back in for pypy and python 3.2</li>
<li>@given functions can now be invoked with some arguments explicitly provided. If all arguments that hypothesis would have provided are passed in then no falsification is run.</li>
<li>Related to the above, this means that you can now use pytest fixtures and mark.parametrize with Hypothesis without either interfering with the other.</li>
<li>Breaking change: @given no longer works for functions with varargs (varkwargs are fine). This might be added back in at a later date.</li>
<li>Windows is now fully supported. A limited version (just the tests with none of the extras) of the test suite is run on windows with each commit so it is now a first class citizen of the Hypothesis world.</li>
<li>Fix a bug for fuzzy equality of equal complex numbers with different reprs (this can happen when one coordinate is zero). This shouldn’t affect users - that feature isn’t used anywhere public facing.</li>
<li>Fix generation of floats on windows and 32-bit builds of python. I was using some struct.pack logic that only worked on certain word sizes.</li>
<li>When a test times out and hasn’t produced enough examples this now raises a Timeout subclass of Unfalsifiable.</li>
<li>Small search spaces are better supported. Previously something like a @given(bool, bool) would have failed because it couldn’t find enough examples. Hypothesis is now aware of the fact that these are small search spaces and will not error in this case.</li>
<li>Improvements to parameter search in the case of hard to satisfy assume. Hypothesis will now spend less time exploring parameters that are unlikely to provide anything useful.</li>
<li>Increase chance of generating “nasty” floats</li>
<li>Fix a bug that would have caused unicode warnings if you had a sampled_from that was mixing unicode and byte strings.</li>
<li>Added a standard test suite that you can use to validate a custom strategy you’ve defined is working correctly.</li>
</ul>
<p>Hypothesis extra:</p>
<p>First off, introducing Hypothesis extra packages!</p>
<p>These are packages that are separated out from core Hypothesis because they have one or more dependencies. Every
hypothesis-extra package is pinned to a specific point release of Hypothesis and will have some version requirements
on its dependency. They use entry_points so you will usually not need to explicitly import them, just have them installed
on the path.</p>
<p>This release introduces two of them:</p>
<p>hypothesis-datetime:</p>
<p>Does what it says on the tin: Generates datetimes for Hypothesis. Just install the package and datetime support will start
working.</p>
<p>Depends on pytz for timezone support</p>
<p>hypothesis-pytest:</p>
<p>A very rudimentary pytest plugin. All it does right now is hook the display of falsifying examples into pytest reporting.</p>
<p>Depends on pytest.</p>
</div>
<div class="section" id="id229">
<h2>0.4.3 - 2015-02-05<a class="headerlink" href="#id229" title="Permalink to this headline">¶</a></h2>
<p>Codename: TIL narrow Python builds are a thing</p>
<p>This just fixes the one bug.</p>
<ul class="simple">
<li>Apparently there is such a thing as a “narrow python build” and OS X ships with these by default
for python 2.7. These are builds where you only have two bytes worth of unicode. As a result,
generating unicode was completely broken on OS X. Fix this by only generating unicode codepoints
in the range supported by the system.</li>
</ul>
</div>
<div class="section" id="id230">
<h2>0.4.2 - 2015-02-04<a class="headerlink" href="#id230" title="Permalink to this headline">¶</a></h2>
<p>Codename: O(dear)</p>
<p>This is purely a bugfix release:</p>
<ul class="simple">
<li>Provide sensible external hashing for all core types. This will significantly improve
performance of tracking seen examples which happens in literally every falsification
run. For Hypothesis fixing this cut 40% off the runtime of the test suite. The behaviour
is quadratic in the number of examples so if you’re running the default configuration
this will be less extreme (Hypothesis’s test suite runs at a higher number of examples
than default), but you should still see a significant improvement.</li>
<li>Fix a bug in formatting of complex numbers where the string could get incorrectly truncated.</li>
</ul>
</div>
<div class="section" id="id231">
<h2>0.4.1 - 2015-02-03<a class="headerlink" href="#id231" title="Permalink to this headline">¶</a></h2>
<p>Codename: Cruel and unusual edge cases</p>
<p>This release is mostly about better test case generation.</p>
<p>Enhancements:</p>
<ul class="simple">
<li>Has a cool release name</li>
<li>text_type (str in python 3, unicode in python 2) example generation now
actually produces interesting unicode instead of boring ascii strings.</li>
<li>floating point numbers are generated over a much wider range, with particular
attention paid to generating nasty numbers - nan, infinity, large and small
values, etc.</li>
<li>examples can be generated using pieces of examples previously saved in the
database. This allows interesting behaviour that has previously been discovered
to be propagated to other examples.</li>
<li>improved parameter exploration algorithm which should allow it to more reliably
hit interesting edge cases.</li>
<li>Timeout can now be disabled entirely by setting it to any value <= 0.</li>
</ul>
<p>Bug fixes:</p>
<ul class="simple">
<li>The descriptor on a OneOfStrategy could be wrong if you had descriptors which
were equal but should not be coalesced. e.g. a strategy for one_of((frozenset({int}), {int}))
would have reported its descriptor as {int}. This is unlikely to have caused you
any problems</li>
<li>If you had strategies that could produce NaN (which float previously couldn’t but
e.g. a Just(float(‘nan’)) could) then this would have sent hypothesis into an infinite
loop that would have only been terminated when it hit the timeout.</li>
<li>Given elements that can take a long time to minimize, minimization of floats or tuples
could be quadratic or worse in the that value. You should now see much better performance
for simplification, albeit at some cost in quality.</li>
</ul>
<p>Other:</p>
<ul class="simple">
<li>A lot of internals have been been rewritten. This shouldn’t affect you at all, but
it opens the way for certain of hypothesis’s oddities to be a lot more extensible by
users. Whether this is a good thing may be up for debate…</li>
</ul>
</div>
<div class="section" id="id232">
<h2>0.4.0 - 2015-01-21<a class="headerlink" href="#id232" title="Permalink to this headline">¶</a></h2>
<p>FLAGSHIP FEATURE: Hypothesis now persists examples for later use. It stores
data in a local SQLite database and will reuse it for all tests of the same
type.</p>
<p>LICENSING CHANGE: Hypothesis is now released under the Mozilla Public License
2.0. This applies to all versions from 0.4.0 onwards until further notice.
The previous license remains applicable to all code prior to 0.4.0.</p>
<p>Enhancements:</p>
<ul class="simple">
<li>Printing of failing examples. I was finding that the pytest runner was not
doing a good job of displaying these, and that Hypothesis itself could do
much better.</li>
<li>Drop dependency on six for cross-version compatibility. It was easy
enough to write the shim for the small set of features that we care about
and this lets us avoid a moderately complex dependency.</li>
<li>Some improvements to statistical distribution of selecting from small (<=
3 elements)</li>
<li>Improvements to parameter selection for finding examples.</li>
</ul>
<p>Bugs fixed:</p>
<ul class="simple">
<li>could_have_produced for lists, dicts and other collections would not have
examined the elements and thus when using a union of different types of
list this could result in Hypothesis getting confused and passing a value
to the wrong strategy. This could potentially result in exceptions being
thrown from within simplification.</li>
<li>sampled_from would not work correctly on a single element list.</li>
<li>Hypothesis could get <em>very</em> confused by values which are
equal despite having different types being used in descriptors. Hypothesis
now has its own more specific version of equality it uses for descriptors
and tracking. It is always more fine grained than Python equality: Things
considered != are not considered equal by hypothesis, but some things that
are considered == are distinguished. If your test suite uses both frozenset
and set tests this bug is probably affecting you.</li>
</ul>
</div>
<div class="section" id="id233">
<h2>0.3.2 - 2015-01-16<a class="headerlink" href="#id233" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fix a bug where if you specified floats_in_range with integer arguments
Hypothesis would error in example simplification.</li>
<li>Improve the statistical distribution of the floats you get for the
floats_in_range strategy. I’m not sure whether this will affect users in
practice but it took my tests for various conditions from flaky to rock
solid so it at the very least improves discovery of the artificial cases
I’m looking for.</li>
<li>Improved repr() for strategies and RandomWithSeed instances.</li>
<li>Add detection for flaky test cases where hypothesis managed to find an
example which breaks it but on the final invocation of the test it does
not raise an error. This will typically happen with too much recursion
errors but could conceivably happen in other circumstances too.</li>
<li>Provide a “derandomized” mode. This allows you to run hypothesis with
zero real randomization, making your build nice and deterministic. The
tests run with a seed calculated from the function they’re testing so you
should still get a good distribution of test cases.</li>
<li>Add a mechanism for more conveniently defining tests which just sample
from some collection.</li>
<li>Fix for a really subtle bug deep in the internals of the strategy table.
In some circumstances if you were to define instance strategies for both
a parent class and one or more of its subclasses you would under some
circumstances get the strategy for the wrong superclass of an instance.
It is very unlikely anyone has ever encountered this in the wild, but it
is conceivably possible given that a mix of namedtuple and tuple are used
fairly extensively inside hypothesis which do exhibit this pattern of
strategy.</li>
</ul>
</div>
<div class="section" id="id234">
<h2>0.3.1 - 2015-01-13<a class="headerlink" href="#id234" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Support for generation of frozenset and Random values</li>
<li>Correct handling of the case where a called function mutates it argument.
This involved introducing a notion of a strategies knowing how to copy
their argument. The default method should be entirely acceptable and the
worst case is that it will continue to have the old behaviour if you
don’t mark your strategy as mutable, so this shouldn’t break anything.</li>
<li>Fix for a bug where some strategies did not correctly implement
could_have_produced. It is very unlikely that any of these would have
been seen in the wild, and the consequences if they had been would have
been minor.</li>
<li>Re-export the @given decorator from the main hypothesis namespace. It’s
still available at the old location too.</li>
<li>Minor performance optimisation for simplifying long lists.</li>
</ul>
</div>
<div class="section" id="id235">
<h2>0.3.0 - 2015-01-12<a class="headerlink" href="#id235" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Complete redesign of the data generation system. Extreme breaking change
for anyone who was previously writing their own SearchStrategy
implementations. These will not work any more and you’ll need to modify
them.</li>
<li>New settings system allowing more global and modular control of Verifier
behaviour.</li>
<li>Decouple SearchStrategy from the StrategyTable. This leads to much more
composable code which is a lot easier to understand.</li>
<li>A significant amount of internal API renaming and moving. This may also
break your code.</li>
<li>Expanded available descriptors, allowing for generating integers or
floats in a specific range.</li>
<li>Significantly more robust. A very large number of small bug fixes, none
of which anyone is likely to have ever noticed.</li>
<li>Deprecation of support for pypy and python 3 prior to 3.3. 3.3 and 3.4.
Supported versions are 2.7.x, 3.3.x, 3.4.x. I expect all of these to
remain officially supported for a very long time. I would not be
surprised to add pypy support back in later but I’m not going to do so
until I know someone cares about it. In the meantime it will probably
still work.</li>
</ul>
</div>
<div class="section" id="id236">
<h2>0.2.2 - 2015-01-08<a class="headerlink" href="#id236" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fix an embarrassing complete failure of the installer caused by my being
bad at version control</li>
</ul>
</div>
<div class="section" id="id237">
<h2>0.2.1 - 2015-01-07<a class="headerlink" href="#id237" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fix a bug in the new stateful testing feature where you could make
__init__ a @requires method. Simplification would not always work if the
prune method was able to successfully shrink the test.</li>
</ul>
</div>
<div class="section" id="id238">
<h2>0.2.0 - 2015-01-07<a class="headerlink" href="#id238" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>It’s aliiive.</li>
<li>Improve python 3 support using six.</li>
<li>Distinguish between byte and unicode types.</li>
<li>Fix issues where FloatStrategy could raise.</li>
<li>Allow stateful testing to request constructor args.</li>
<li>Fix for issue where test annotations would timeout based on when the
module was loaded instead of when the test started</li>
</ul>
</div>
<div class="section" id="id239">
<h2>0.1.4 - 2013-12-14<a class="headerlink" href="#id239" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Make verification runs time bounded with a configurable timeout</li>
</ul>
</div>
<div class="section" id="id240">
<h2>0.1.3 - 2013-05-03<a class="headerlink" href="#id240" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Bugfix: Stateful testing behaved incorrectly with subclassing.</li>
<li>Complex number support</li>
<li>support for recursive strategies</li>
<li>different error for hypotheses with unsatisfiable assumptions</li>
</ul>
</div>
<div class="section" id="id241">
<h2>0.1.2 - 2013-03-24<a class="headerlink" href="#id241" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Bugfix: Stateful testing was not minimizing correctly and could
throw exceptions.</li>
<li>Better support for recursive strategies.</li>
<li>Support for named tuples.</li>
<li>Much faster integer generation.</li>
</ul>
</div>
<div class="section" id="id242">
<h2>0.1.1 - 2013-03-24<a class="headerlink" href="#id242" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Python 3.x support via 2to3.</li>
<li>Use new style classes (oops).</li>
</ul>
</div>
<div class="section" id="id243">
<h2>0.1.0 - 2013-03-23<a class="headerlink" href="#id243" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Introduce stateful testing.</li>
<li>Massive rewrite of internals to add flags and strategies.</li>
</ul>
</div>
<div class="section" id="id244">
<h2>0.0.5 - 2013-03-13<a class="headerlink" href="#id244" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>No changes except trying to fix packaging</li>
</ul>
</div>
<div class="section" id="id245">
<h2>0.0.4 - 2013-03-13<a class="headerlink" href="#id245" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>No changes except that I checked in a failing test case for 0.0.3
so had to replace the release. Doh</li>
</ul>
</div>
<div class="section" id="id246">
<h2>0.0.3 - 2013-03-13<a class="headerlink" href="#id246" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Improved a few internals.</li>
<li>Opened up creating generators from instances as a general API.</li>
<li>Test integration.</li>
</ul>
</div>
<div class="section" id="id247">
<h2>0.0.2 - 2013-03-12<a class="headerlink" href="#id247" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Starting to tighten up on the internals.</li>
<li>Change API to allow more flexibility in configuration.</li>
<li>More testing.</li>
</ul>
</div>
<div class="section" id="id248">
<h2>0.0.1 - 2013-03-10<a class="headerlink" href="#id248" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Initial release.</li>
<li>Basic working prototype. Demonstrates idea, probably shouldn’t be used.</li>
</ul>
</div>
</div>
</div>
<div class="articleComments">
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="development.html" class="btn btn-neutral float-right" title="Ongoing Hypothesis Development" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="strategies.html" class="btn btn-neutral" title="Projects extending Hypothesis" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<p>
© Copyright 2013-2018, David R. MacIver.
</p>
</div>
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'3.44.1',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
<script type="text/javascript">
jQuery(function () {
SphinxRtdTheme.StickyNav.enable();
});
</script>
</body>
</html>
|