{"header":{"message":"simplify docs and add back compat support (#12)\n\n* simplify docs\r\n\r\n* improve docs a little more","description":null,"timestamp":"2020-05-03T20:40:02Z","authors":[{"email":"jlusby42@gmail.com","name":"Jane Lusby"}]},"hash":"OQCFKTKCBTWGXL27ZLWQSL4L5VPREJAYN7MVCCR4GXW6WLWYOUHAC","authors":[],"deps":{"hashes":[["OQCFKTKCBTWGXL27ZLWQSL4L5VPREJAYN7MVCCR4GXW6WLWYOUHAC","simplify docs and add back compat support (#12)\n\n* simplify docs\r\n\r\n* improve docs a little more"],["AA",null],["GPASF452R6CFMY6PRIRQ4AGZTCYCLD33Q7CCWSDCK4N2LSHI4UZQC","Fix tracing_error::SpanTrace link in Readme \n\nJust a quick drive-by commit :)"],["NVJJABMFM5CUP7M2BAPEIZIVK5IV7OGL7ERK237RR33I2ABFXUUQC","Merge upstream changes\n"],["VAO5JFB2XAADU6QRQ24O2GCIFRBWNLRIJMEFMYR4IOLAF45VNIQQC","Be more assertive\n"],["EKYR4HDT6DHI7H5YMSHEBHXLPDCA2X2XNXYHDKHWGMPHNVTUBCMQC","Initial commit\n"],["OXKWHQFHTDDOWX3QDMHDWHCT3HFKWQS7Z7DEL3ILJBA7GNITA4GAC","Copy readme to crate level doc\n"],["FUJQNVMLSYHOFH6Z663M2MIGQXYSWGMNUKEIT2O4JYER3CGGLV3AC","Release 1.0.26\n"],["K7UY4GCWKGWKQKFKOE4ETLPGEMN5LDIGBOQKN57Q24UUQGYU2WOAC","Update README.md\n"],["X4XC4Q2MJC6Q45SOWNGIG2PWZFE4AG5E3M5ZW3OGV6ABUVC2XNGQC","Rename ErrReport to Report (#9)\n\n* Rename ErrReport to Report\r\n\r\n* bump versions to prep for a release"],["YWW5TKMSPEGRZ52FQZ3SC4C3DEZ57U5XUO4LHZC34BJA7QR5NSCQC","Add readme stub\n"],["MIDZP3PF6NSHV5CHZAM2ZALULRTCQKHVRZ5KUNWSWPU4K3ABVB3AC","Another one bites the dust\n"],["3ZZ75E2AOF7DO3TMR422QV7ZXNYOQZTOGF67LVSCEMX6N75Y36LAC","Allow customization of error context\n"],["UBKNLKSJOZ6RR3BVEBTW2ID4NQ6DP34Z7HC6QA3755Q6YSTYSGEAC","More readme / docs updates\n"],["D3IJE5IHSC64GMC3QZUYMSPZL2PXIVOHCWF7BREKRQXJQLURZBLQC","Add one sentence project summary\n"],["GOPJFSDQLXOY7EGBNR26HON32UIMSC3IAWZZL57A277CMX2D4OOAC","Rename context apis\n"],["FJ7MWHMLIDTBGJJNKCNS5GIBQIJBUQRXLQEAFOCVZI7O4NA4XGSAC","Update docs to reflect changes in API\n"],["GFUITBG5JGUCDMG34FEMPPJAZGQKURXA5L2RYS6YOQC4DIQGASMAC","Update docs a little\n"],["QSDRPIYAFOQN3YAM3O7TTPLWBEMTDZTV3B7IYSL4OVXW5MMS3IEQC","Remove fehler link\n\nThe Anyhow implementation has changed a lot and is now quite different\nfrom der Fehler.\n"],["3YMIGCYC3YUOZP5OBNSTOIJOT6ZTEDDKNMR5YCAJRD5JNBYFETYAC","Add readme docs to lib\n"],["7T5M2QMTLQOO7IAVV3PNTEWMFAROZRHKQ3ILVH2M6UVH6ZX7LK2AC","Add comparison to failure crate\n"],["4SYP47QOL2X5VLRFMW3VCSVVWTZPMHZZMW46WBF6YFFZ43LTNIWQC","provide a default impl for the Display trait\n"],["LO6GF2475P5CT6LTGQFSUATR3VCLFX5EPWT4KZYIMTVHOZNADGDAC","Add acknowledgement of fehler::Exception\n"],["ANPVVYNDAQDZ5C5UK5Q45RUZJ6CSRLRZJNUNWZ2Z7NHIBJQKMJVQC","Include more information in readme\n"],["VPPGYSBICWMGVK6V7PRHP4OP2WRAFABRDKFJJ33AQAITJ65VPR4QC","simplify ci requirements\n"],["3AIAIKKJSIJYPFUQD2QOEI4IPW377FHYAWZZAOZ5S7GTQGW4ADSQC","Update readme\n"],["NYJCYVDTPMGIZAJ2A6M4PB5CVDCD5QXFYR6724XRZQCNYTV5XUAQC","Show supported compiler version in readme\n"],["JSBVL45BUNWMQIONEJFWAVI3XGZOUDJXGAYT6FWJZS4TJIJBQVIAC","Update README.md\n"],["KU3EUQE2P5B6JDOKOCOHMYLFGQMYTWIFXRKQCV4YHY26EIZQQ5VAC","Release 1.0.0\n"],["2XZLORI35AOKD4YITN2XAVXDXZXRNUKNXJXPA2TTBAXYYLJB77GAC","Add brief comparison with thiserror\n"],["STVQHBZPF2AV3H5PVVSZZSP47R6OA3IDTN66VSGE3Z5DWS3U43IAC","Fix broken links\n"],["KGWHXYQ5JQD52NFGGGZVXNU25DRNMYCAY6IEDEKTWYDSLWAXPIZQC","Fix more broken links\n"],["KVTZ5BUW7V7RZ3STMQXF6LXVLMGRXDBEOPRBTHX2O4HELTQ2467QC","make an effort at no_std support\n"],["7ST7DCCRWJ64IV6RIZLJXIACDT7AGMXRIQY7MVXYXAPU5GATUFRQC","Bump version to push updated docs to crates\n"],["MSP7OSXV27W2UISXGWOGV52O4MWLPHQZ4EVBUFEX5KKCR4MXI63AC","Update README.md\n"],["CZYHXIBGQF2SK4MSUQISYQJYTWFCWCLZB7OPPE5P2VASG374S2XAC","Fix readme on crates.io\n"],["6BNRWGF55J5M3YBWYNTWJCRJQSEHY7YRKOUBV43W7I2HCTFDJHUQC","Document no-std support\n"],["DK2344VK2P47NVSA774Q7BY3LP24ZWWVUEGCLKJ5IDZFP5YWNDDQC","Update README.md\n"],["RNR2NUQ3S5ONDO4OESVLJOSDFFNMQABEJAJRVOZO75477MRAJZ6AC","Raise minimum supported rustc version to 1.34\n"],["MOSHJ3ZHBZUKDXUP4WDUJGOG3R3QTVZKBN6RSZLNGTMEVSKIRR7AC","Include example of anyhow! macro\n"],["KB6THMJJPQ56OLYYODIM5IVEF3IAPCAEC2HGH3C7LAEF24IW6XQQC","Bump version one more time\n"],["6ASXQDFE2S6ADA43ELZTBDTRJ7BG3NFJIKVSAKEU5FMYNRWCHOPAC","Fix readme\n"],["B35ATKRQB7JRNWXZD2YRYT6H73ZTQBUEXHZWZCHQEIOMSST5QJ6QC","Propogate context to the top most error when wrapping inner errors (#5)\n\n* Propogate context when wrapping errors with Option::take\r\n\r\n* fix test failure in fmt output\r\n\r\n* bump version for release"],["COA6YXVKGYVAIDYWVD3DN6IYTXXS74GKEHLPLDN6UZ5YT3G5SRVQC","Link to err-derive crate\n"],["LNM226ITXRMWOSX6GOJ4HO72BWFRBDKQTEZMF4QUJUACUIOKIEJQC","Rename core types\n"],["N7U2FHPRHGARPZ6M7LYBDJ52NMYE23VD5YALZ7CC76W3V5OLBP7QC","move fmting to trait and add github actions support\n"],["CITEDKPB6MKVZUEYEDE5ZKTNVY35HCOAXKDPYG7YLLEOVFNMSRXQC","Import implementation from fehler 1.0.0-alpha.1\n"],["KCOCFOS6KMCTVS6K3WE6KOQSWC3QNWN2E36ASHQPP3Z3H4BHR3NQC","Support context on Option\n"],["AOQSHDBY3FLBJBFEIJQDYHGQOBECTYRN3KPWJWQMCVWDTB6L2IRQC","Work around bad diagnostic when missing Context import\n\nPreviously the compiler would say:\n\n error[E0599]: no method named `context` found for type `std::result::Result<(), anyhow::error::Error>` in the current scope\n --> src/main.rs:83:13\n |\n 83 | context(...)?;\n | ^^^^^^^ method not found in `std::result::Result<(), anyhow::error::Error>`\n |\n = help: items from traits can only be used if the trait is in scope\n help: the following trait is implemented but not in scope; perhaps add a `use` for it:\n |\n 19 | use anyhow::context::Context;\n\nwhere the `anyhow::context::Context` in the suggestion is not a path\nthat is accessible to the user.\n"],["77T3TBBG5VN2Q4AUXHQVZTIFOSXDGTHW72J4MLX4P7LMYQURYZJAC","Rework context APIs\n"]],"deps":["GPASF452R6CFMY6PRIRQ4AGZTCYCLD33Q7CCWSDCK4N2LSHI4UZQC","NVJJABMFM5CUP7M2BAPEIZIVK5IV7OGL7ERK237RR33I2ABFXUUQC"],"known":["EKYR4HDT6DHI7H5YMSHEBHXLPDCA2X2XNXYHDKHWGMPHNVTUBCMQC","YWW5TKMSPEGRZ52FQZ3SC4C3DEZ57U5XUO4LHZC34BJA7QR5NSCQC","LO6GF2475P5CT6LTGQFSUATR3VCLFX5EPWT4KZYIMTVHOZNADGDAC","D3IJE5IHSC64GMC3QZUYMSPZL2PXIVOHCWF7BREKRQXJQLURZBLQC","ANPVVYNDAQDZ5C5UK5Q45RUZJ6CSRLRZJNUNWZ2Z7NHIBJQKMJVQC","OXKWHQFHTDDOWX3QDMHDWHCT3HFKWQS7Z7DEL3ILJBA7GNITA4GAC","COA6YXVKGYVAIDYWVD3DN6IYTXXS74GKEHLPLDN6UZ5YT3G5SRVQC","MOSHJ3ZHBZUKDXUP4WDUJGOG3R3QTVZKBN6RSZLNGTMEVSKIRR7AC","KU3EUQE2P5B6JDOKOCOHMYLFGQMYTWIFXRKQCV4YHY26EIZQQ5VAC","7T5M2QMTLQOO7IAVV3PNTEWMFAROZRHKQ3ILVH2M6UVH6ZX7LK2AC","NYJCYVDTPMGIZAJ2A6M4PB5CVDCD5QXFYR6724XRZQCNYTV5XUAQC","RNR2NUQ3S5ONDO4OESVLJOSDFFNMQABEJAJRVOZO75477MRAJZ6AC","QSDRPIYAFOQN3YAM3O7TTPLWBEMTDZTV3B7IYSL4OVXW5MMS3IEQC","2XZLORI35AOKD4YITN2XAVXDXZXRNUKNXJXPA2TTBAXYYLJB77GAC","6BNRWGF55J5M3YBWYNTWJCRJQSEHY7YRKOUBV43W7I2HCTFDJHUQC","FUJQNVMLSYHOFH6Z663M2MIGQXYSWGMNUKEIT2O4JYER3CGGLV3AC","LNM226ITXRMWOSX6GOJ4HO72BWFRBDKQTEZMF4QUJUACUIOKIEJQC","3ZZ75E2AOF7DO3TMR422QV7ZXNYOQZTOGF67LVSCEMX6N75Y36LAC","GOPJFSDQLXOY7EGBNR26HON32UIMSC3IAWZZL57A277CMX2D4OOAC","N7U2FHPRHGARPZ6M7LYBDJ52NMYE23VD5YALZ7CC76W3V5OLBP7QC","KVTZ5BUW7V7RZ3STMQXF6LXVLMGRXDBEOPRBTHX2O4HELTQ2467QC","GFUITBG5JGUCDMG34FEMPPJAZGQKURXA5L2RYS6YOQC4DIQGASMAC","JSBVL45BUNWMQIONEJFWAVI3XGZOUDJXGAYT6FWJZS4TJIJBQVIAC","DK2344VK2P47NVSA774Q7BY3LP24ZWWVUEGCLKJ5IDZFP5YWNDDQC","MSP7OSXV27W2UISXGWOGV52O4MWLPHQZ4EVBUFEX5KKCR4MXI63AC","VPPGYSBICWMGVK6V7PRHP4OP2WRAFABRDKFJJ33AQAITJ65VPR4QC","K7UY4GCWKGWKQKFKOE4ETLPGEMN5LDIGBOQKN57Q24UUQGYU2WOAC","FJ7MWHMLIDTBGJJNKCNS5GIBQIJBUQRXLQEAFOCVZI7O4NA4XGSAC","6ASXQDFE2S6ADA43ELZTBDTRJ7BG3NFJIKVSAKEU5FMYNRWCHOPAC","KB6THMJJPQ56OLYYODIM5IVEF3IAPCAEC2HGH3C7LAEF24IW6XQQC","STVQHBZPF2AV3H5PVVSZZSP47R6OA3IDTN66VSGE3Z5DWS3U43IAC","KGWHXYQ5JQD52NFGGGZVXNU25DRNMYCAY6IEDEKTWYDSLWAXPIZQC","MIDZP3PF6NSHV5CHZAM2ZALULRTCQKHVRZ5KUNWSWPU4K3ABVB3AC","CZYHXIBGQF2SK4MSUQISYQJYTWFCWCLZB7OPPE5P2VASG374S2XAC","VAO5JFB2XAADU6QRQ24O2GCIFRBWNLRIJMEFMYR4IOLAF45VNIQQC","7ST7DCCRWJ64IV6RIZLJXIACDT7AGMXRIQY7MVXYXAPU5GATUFRQC","3YMIGCYC3YUOZP5OBNSTOIJOT6ZTEDDKNMR5YCAJRD5JNBYFETYAC","UBKNLKSJOZ6RR3BVEBTW2ID4NQ6DP34Z7HC6QA3755Q6YSTYSGEAC","3AIAIKKJSIJYPFUQD2QOEI4IPW377FHYAWZZAOZ5S7GTQGW4ADSQC","4SYP47QOL2X5VLRFMW3VCSVVWTZPMHZZMW46WBF6YFFZ43LTNIWQC","B35ATKRQB7JRNWXZD2YRYT6H73ZTQBUEXHZWZCHQEIOMSST5QJ6QC","X4XC4Q2MJC6Q45SOWNGIG2PWZFE4AG5E3M5ZW3OGV6ABUVC2XNGQC"]},"hunks":[{"Replacement":{"inode":{"change":4,"pos":13},"path":"Cargo.toml","line":3,"ins":{"up_context":[{"change":4,"pos":14}],"down_context":[{"change":4,"pos":53}],"flag":"BLOCK","start":0,"end":53,"inode":{"change":4,"pos":13}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":14},"to":{"change":4,"start":0,"end":53},"introduced_by":4}],"inode":{"change":4,"pos":13}},"ins_contents":[{"Add":"version = \"0.3.9\" # remember to update html_root_url"}],"del_contents":[{"Del":"version = \"0.3.8\" # remember to update html_root_url\n"}]}},{"Edit":{"inode":{"change":4,"pos":12},"path":"README.md","line":11,"atom":{"EdgeMap":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":2014},"to":{"change":4,"start":324,"end":325},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":325},"to":{"change":4,"start":0,"end":79},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":79},"to":{"change":4,"start":0,"end":80},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":80},"to":{"change":4,"start":0,"end":159},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":159},"to":{"change":4,"start":237,"end":346},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":237},"to":{"change":4,"start":237,"end":346},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":346},"to":{"change":4,"start":515,"end":815},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":515},"to":{"change":4,"start":515,"end":815},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":305},"to":{"change":4,"start":566,"end":617},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":815},"to":{"change":4,"start":566,"end":617},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":566},"to":{"change":4,"start":566,"end":617},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":617},"to":{"change":4,"start":816,"end":1015},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":345},"to":{"change":4,"start":805,"end":875},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":1015},"to":{"change":4,"start":805,"end":875},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":805},"to":{"change":4,"start":805,"end":875},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":875},"to":{"change":4,"start":1016,"end":1243},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":1243},"to":{"change":4,"start":124,"end":198},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":198},"to":{"change":4,"start":1320,"end":1642},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":1320},"to":{"change":4,"start":1320,"end":1642},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":1642},"to":{"change":4,"start":1287,"end":1366},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":1287},"to":{"change":4,"start":1287,"end":1366},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":1366},"to":{"change":4,"start":1643,"end":1778},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":1778},"to":{"change":4,"start":160,"end":237},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":237},"to":{"change":4,"start":199,"end":269},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":269},"to":{"change":4,"start":1930,"end":2041},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":1930},"to":{"change":4,"start":1930,"end":2041},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":2041},"to":{"change":4,"start":1742,"end":1803},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":1742},"to":{"change":4,"start":1742,"end":1803},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":1803},"to":{"change":4,"start":0,"end":77},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":77},"to":{"change":4,"start":238,"end":304},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":304},"to":{"change":4,"start":0,"end":24},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":1916},"to":{"change":4,"start":0,"end":24},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":24},"to":{"change":4,"start":2042,"end":2055},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":2180},"to":{"change":4,"start":2180,"end":2184},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":43},"to":{"change":4,"start":43,"end":48},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":48},"to":{"change":4,"start":209,"end":210},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":80},"to":{"change":4,"start":209,"end":210},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":99},"to":{"change":4,"start":209,"end":210},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":197},"to":{"change":4,"start":209,"end":210},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":586},"to":{"change":4,"start":209,"end":210},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":2080},"to":{"change":4,"start":209,"end":210},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":2730},"to":{"change":4,"start":209,"end":210},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":209},"to":{"change":4,"start":209,"end":210},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":210},"to":{"change":4,"start":2731,"end":2826},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":2826},"to":{"change":4,"start":54,"end":154},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":154},"to":{"change":4,"start":2156,"end":2178},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":2156},"to":{"change":4,"start":2156,"end":2178},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":2178},"to":{"change":4,"start":2900,"end":3423},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":2900},"to":{"change":4,"start":2900,"end":3423},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":3818},"to":{"change":4,"start":3818,"end":3819},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":3819},"to":{"change":4,"start":0,"end":78},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":78},"to":{"change":4,"start":155,"end":270},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":201},"to":{"change":4,"start":4307,"end":4308},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":270},"to":{"change":4,"start":4307,"end":4308},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":4307},"to":{"change":4,"start":4307,"end":4308},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":4308},"to":{"change":4,"start":270,"end":345},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":345},"to":{"change":4,"start":4386,"end":5392},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":4386},"to":{"change":4,"start":4386,"end":5392},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":5392},"to":{"change":4,"start":2179,"end":2481},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":2481},"to":{"change":4,"start":346,"end":423},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":423},"to":{"change":4,"start":2561,"end":2670},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":2561},"to":{"change":4,"start":2561,"end":2670},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":2670},"to":{"change":4,"start":424,"end":499},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":499},"to":{"change":4,"start":2748,"end":3012},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":2748},"to":{"change":4,"start":2748,"end":3012},"introduced_by":4}],"inode":{"change":4,"pos":12}}},"contents":[{"Del":"\n"},{"Del":"This crate is a fork of [`anyhow`] by @dtolnay. By default this crate does not\n"},{"Del":"add any new features that anyhow doesn't already support, though it does rename\n"},{"Del":"a number of the APIs to try to make the intended usage more obvious. The magic\nof this crate is when you need to add extra context to a chain of errors beyond\n"},{"Del":"what you can or should insert into the error chain. For an example of a\ncustomized version of eyre check out\n"},{"Del":"[`jane-eyre`](https://github.com/yaahc/jane-eyre).\n\nMy goal in writing this crate is to explore new ways to associate context with\nerrors, to cleanly separate the concept of an error and context about an error,\nand to more clearly communicate the intended usage of this crate via changes to\nthe API.\n"},{"Del":"\nThe main changes this crate brings to anyhow are\n\n"},{"Del":"* Addition of the [`eyre::EyreContext`] trait and a type parameter on the core\n error handling type which users can use to insert custom forms of context\n into their catch-all error handling type.\n"},{"Del":"* Rebranding the type as principally for error reporting, rather than\n"},{"Del":" describing it as an error type in its own right. What is and isn't an error\n is a fuzzy concept, for the purposes of this crate though errors are types\n that implement `std::error::Error`, and you'll notice that this trait\n"},{"Del":" implementation is conspicuously absent on `Report`. Instead it contains\n"},{"Del":" errors that it masqerades as, and provides helpers for creating new errors to\n wrap those errors and for displaying those chains of errors, and the included\n context, to the end user. The goal is to make it obvious that this type is\n meant to be used when the only way you expect to handle errors is to print\n them.\n"},{"Del":"* Changing the [`anyhow::Context`] trait to [`eyre::WrapErr`] to make it clear\n"},{"Del":" that it is unrelated to the [`eyre::EyreContext`] trait and member, and is\n only for inserting new errors into the chain of errors.\n"},{"Del":"* Addition of new context helpers `member_ref`/`member_mut` on `EyreContext`\n"},{"Del":" and `context`/`context_mut` on `Report` for working with the custom\n"},{"Del":" context and extracting forms of context based on their type independent of\n the type of the custom context.\n"},{"Del":"\nThese changes were made in order to facilitate the usage of\n"},{"Del":"[`tracing_error::SpanTrace`] with anyhow, which is a Backtrace-like type for\n"},{"Del":"rendering custom defined runtime context setup via tracing spans.\n"},{"Del":"\n```toml\n[dependencies]\n"},{"Del":"eyre = \"0.3\"\n"},{"Del":"```\n"},{"Del":"
\n"},{"Del":"\n"},{"Del":"## Customization\n\nIn order to insert your own custom context type you must first implement the\n"},{"Del":"`eyre::EyreContext` trait for said type, which has two required methods and\nthree optional methods.\n"},{"Del":"\n### Required Methods\n"},{"Del":"\n* `fn default(error: &Error) -> Self` - For constructing default context while\nallowing special case handling depending on the content of the error you're\nwrapping.\n\nThis is essentially `Default::default` but more flexible, for example, the\n`eyre::DefaultContext` type provide by this crate uses this to only capture a\n`Backtrace` if the inner `Error` does not already have one.\n\n```rust\nfn default(error: &(dyn StdError + 'static)) -> Self {\n let backtrace = backtrace_if_absent!(error);\n\n Self { backtrace }\n}\n```\n"},{"Del":"\n"},{"Del":"* `fn debug(&self, error: &(dyn Error + 'static), f: &mut fmt::Formatter<'_>)\n"},{"Del":" -> fmt Result` and optionally `display` - For formatting the entire error\n chain and the user provided context.\n"},{"Del":"\n"},{"Del":"When overriding the context it no longer makes sense for `eyre::Report` to\n"},{"Del":"provide the `Display` and `Debug` implementations for the user, becase we\ncannot predict what forms of context you will need to display along side your\nchain of errors. Instead we forward the implementations of `Display` and\n`Debug` to these methods on the inner `EyreContext` type.\n\nThis crate does provide a few helpers to assist in writing display\nimplementations, specifically the `Chain` type, for treating an error and its\nsources like an iterator, and the `Indented` type, for indenting multi line\nerrors consistently without using heap allocations.\n\n**Note**: best practices for printing errors suggest that `{}` should only\nprint the current error and none of its sources, and that the primary method of\ndisplaying an error, its sources, and its context should be handled by the\n`Debug` implementation, which is what is used to print errors that are returned\nfrom `main`. For examples on how to implement this please refer to the\nimplementations of `display` and `debug` on `eyre::DefaultContext`\n"},{"Del":"\n### Optional Methods\n\n* `fn member_ref(&self, typeid TypeID) -> Option<&dyn Any>` - For extracting\n arbitrary members from a context based on their type and `member_mut` for\n getting a mutable reference in the same way.\n\nThis method is like a flexible version of the `fn backtrace(&self)` method on\n"},{"Del":"the `Error` trait. The main `Report` type provides versions of these methods\n"},{"Del":"that use type inference to get the typeID that should be used by inner trait fn\nto pick a member to return.\n\n"},{"Del":"**Note**: The `backtrace()` fn on `Report` relies on the implementation of\n"},{"Del":"this function to get the backtrace from the user provided context if one\nexists. If you wish your type to guaruntee that it captures a backtrace for any\nerror it wraps you **must** implement `member_ref` and provide a path to return\na `Backtrace` type like below.\n"}]}},{"Replacement":{"inode":{"change":4,"pos":12},"path":"README.md","line":12,"ins":{"up_context":[{"change":4,"pos":5393}],"down_context":[{"change":4,"pos":3091}],"flag":"BLOCK","start":54,"end":376,"inode":{"change":4,"pos":12}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":5393},"to":{"change":4,"start":3013,"end":3091},"introduced_by":4}],"inode":{"change":4,"pos":12}},"ins_contents":[{"Add":"This crate is a fork of [`anyhow`] by @dtolnay with a support for customized"},{"Add":"`Reports`. For more details on customization checkout the docs on"},{"Add":"[`eyre::EyreContext`]. For an example on how to implement a custom context"},{"Add":"check out [`stable-eyre`] which implements a minimal custom context for"},{"Add":"capturing backtraces on stable."}],"del_contents":[{"Del":"Here is how the `eyre::DefaultContext` type uses this to return `Backtrace`s.\n"}]}},{"Edit":{"inode":{"change":4,"pos":12},"path":"README.md","line":18,"atom":{"EdgeMap":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":3092},"to":{"change":4,"start":3092,"end":3298},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":3298},"to":{"change":4,"start":5393,"end":5504},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":5393},"to":{"change":4,"start":5393,"end":5504},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":5504},"to":{"change":4,"start":3299,"end":3300},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":3300},"to":{"change":4,"start":5504,"end":5513},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":5504},"to":{"change":4,"start":5504,"end":5513},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":5513},"to":{"change":4,"start":500,"end":539},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":539},"to":{"change":4,"start":5558,"end":5580},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":5558},"to":{"change":4,"start":5558,"end":5580},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":5580},"to":{"change":4,"start":540,"end":614},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":96},"to":{"change":4,"start":431,"end":435},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":600},"to":{"change":4,"start":431,"end":435},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":614},"to":{"change":4,"start":431,"end":435},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":5676},"to":{"change":4,"start":431,"end":435},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":431},"to":{"change":4,"start":431,"end":435},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":435},"to":{"change":4,"start":0,"end":1},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":1},"to":{"change":4,"start":211,"end":216},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":216},"to":{"change":4,"start":0,"end":1},"introduced_by":4}],"inode":{"change":4,"pos":12}}},"contents":[{"Del":"```rust\nfn member_ref(&self, typeid: TypeId) -> Option<&dyn Any> {\n if typeid == TypeId::of::() {\n self.backtrace.as_ref().map(|b| b as &dyn Any)\n } else {\n None\n }\n}\n```\n\n"},{"Del":"Once you've defined a custom Context type you can use it throughout your\napplication by defining a type alias.\n"},{"Del":"\n"},{"Del":"\n```rust\n"},{"Del":"type Report = eyre::Report;\n"},{"Del":"\n// And optionally...\n"},{"Del":"type Result> = core::result::Result;\n"},{"Del":"```\n"},{"Del":"\n"},{"Del":"
\n"},{"Del":"\n"}]}},{"Edit":{"inode":{"change":4,"pos":12},"path":"README.md","line":117,"atom":{"EdgeMap":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":1},"to":{"change":4,"start":1,"end":7},"introduced_by":4}],"inode":{"change":4,"pos":12}}},"contents":[{"Del":"
\n\n"}]}},{"Edit":{"inode":{"change":4,"pos":12},"path":"README.md","line":137,"atom":{"EdgeMap":{"edges":[{"previous":"","flag":"DELETED","from":{"change":4,"pos":218},"to":{"change":4,"start":1764,"end":1769},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":595},"to":{"change":4,"start":1764,"end":1769},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":1764},"to":{"change":4,"start":1764,"end":1769},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":1769},"to":{"change":4,"start":0,"end":1},"introduced_by":4}],"inode":{"change":4,"pos":12}}},"contents":[{"Del":"
\n"},{"Del":"\n"}]}},{"Edit":{"inode":{"change":4,"pos":12},"path":"README.md","line":145,"atom":{"EdgeMap":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":415},"to":{"change":4,"start":415,"end":421},"introduced_by":4}],"inode":{"change":4,"pos":12}}},"contents":[{"Del":"\n
\n"}]}},{"Replacement":{"inode":{"change":4,"pos":12},"path":"README.md","line":155,"ins":{"up_context":[{"change":4,"pos":382}],"down_context":[{"change":4,"pos":54}],"flag":"BLOCK","start":377,"end":408,"inode":{"change":4,"pos":12}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":382},"to":{"change":4,"start":382,"end":387},"introduced_by":4}],"inode":{"change":4,"pos":12}},"ins_contents":[{"Add":"## Compatibility with `anyhow`"}],"del_contents":[{"Del":"
\n"}]}},{"Replacement":{"inode":{"change":4,"pos":12},"path":"README.md","line":157,"ins":{"up_context":[{"change":4,"pos":55}],"down_context":[{"change":4,"pos":88}],"flag":"BLOCK","start":409,"end":574,"inode":{"change":4,"pos":12}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":55},"to":{"change":4,"start":55,"end":88},"introduced_by":4}],"inode":{"change":4,"pos":12}},"ins_contents":[{"Add":"This crate does its best to be usable as a drop in replacement of `anyhow` and"},{"Add":"vice-versa by `re-exporting` all of the renamed APIs with the names used in"},{"Add":"`anyhow`."}],"del_contents":[{"Del":"## Incompatibilities with anyhow\n"}]}},{"Replacement":{"inode":{"change":4,"pos":12},"path":"README.md","line":161,"ins":{"up_context":[{"change":4,"pos":89}],"down_context":[{"change":4,"pos":302}],"flag":"BLOCK","start":575,"end":773,"inode":{"change":4,"pos":12}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":89},"to":{"change":4,"start":89,"end":247},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":247},"to":{"change":4,"start":0,"end":55},"introduced_by":4}],"inode":{"change":4,"pos":12}},"ins_contents":[{"Add":"It is not 100% compatible because there are some cases where `eyre` encounters"},{"Add":"type inference errors but it should mostly work as a drop in replacement."},{"Add":"Specifically, the following works in anyhow:"}],"del_contents":[{"Del":"Beyond the fact that eyre renames many of the core APIs in anyhow the addition\nof the type parameter makes the `eyre!` macro not work in certain places where\n"},{"Del":"`anyhow!` does work. In\nanyhow the following is valid.\n"}]}},{"Edit":{"inode":{"change":4,"pos":12},"path":"README.md","line":188,"atom":{"NewVertex":{"up_context":[{"change":2,"pos":98}],"down_context":[{"change":4,"pos":955}],"flag":"BLOCK","start":774,"end":819,"inode":{"change":4,"pos":12}}},"contents":[{"Add":"[`stable-eyre`]: https://docs.rs/stable-eyre"}]}},{"Edit":{"inode":{"change":47,"pos":642},"path":"src/context.rs","line":65,"atom":{"NewVertex":{"up_context":[{"change":4,"pos":936}],"down_context":[{"change":48,"pos":51}],"flag":"BLOCK","start":820,"end":970,"inode":{"change":47,"pos":642}}},"contents":[{"Add":" }"},{"Add":""},{"Add":" fn context(self, msg: D) -> Result>"},{"Add":" where"},{"Add":" D: Display + Send + Sync + 'static,"},{"Add":" {"},{"Add":" self.wrap_err(msg)"}]}},{"Edit":{"inode":{"change":47,"pos":642},"path":"src/context.rs","line":73,"atom":{"NewVertex":{"up_context":[{"change":48,"pos":57}],"down_context":[{"change":48,"pos":57}],"flag":"BLOCK","start":971,"end":1160,"inode":{"change":47,"pos":642}}},"contents":[{"Add":""},{"Add":" fn with_context(self, msg: F) -> Result>"},{"Add":" where"},{"Add":" D: Display + Send + Sync + 'static,"},{"Add":" F: FnOnce() -> D,"},{"Add":" {"},{"Add":" self.wrap_err_with(msg)"},{"Add":" }"}]}},{"Edit":{"inode":{"change":47,"pos":11888},"path":"src/lib.rs","line":3,"atom":{"EdgeMap":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":144},"to":{"change":4,"start":144,"end":148},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":148},"to":{"change":4,"start":54,"end":558},"introduced_by":4}],"inode":{"change":47,"pos":11888}}},"contents":[{"Del":"//!\n"},{"Del":"//! This crate is a fork of [`anyhow`] by @dtolnay. By default this crate does not\n//! add any new features that anyhow doesn't already support, though it does rename\n//! a number of the APIs to try to make the proper usage more obvious. The magic of\n//! this crate is when you need to add extra context to a chain of errors beyond\n//! what you can or should insert into the error chain. For an example of a\n//! customized version of eyre check out\n//! [`jane-eyre`](https://github.com/yaahc/jane-eyre).\n"}]}},{"Replacement":{"inode":{"change":47,"pos":11888},"path":"src/lib.rs","line":4,"ins":{"up_context":[{"change":4,"pos":562}],"down_context":[{"change":4,"pos":2534}],"flag":"BLOCK","start":1161,"end":1499,"inode":{"change":47,"pos":11888}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":562},"to":{"change":4,"start":562,"end":1411},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":1411},"to":{"change":4,"start":5163,"end":5241},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":5241},"to":{"change":4,"start":1492,"end":2143},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":1492},"to":{"change":4,"start":1492,"end":2143},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":2143},"to":{"change":4,"start":5242,"end":5316},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":5316},"to":{"change":4,"start":2220,"end":2534},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":2220},"to":{"change":4,"start":2220,"end":2534},"introduced_by":4}],"inode":{"change":47,"pos":11888}},"ins_contents":[{"Add":"//! This crate is a fork of [`anyhow`] by @dtolnay with a support for customized `Reports`. For"},{"Add":"//! more details on customization checkout the docs on [`eyre::EyreContext`]. For an example on how"},{"Add":"//! to implement a custom context check out [`stable-eyre`] which implements a minimal custom"},{"Add":"//! context for capturing backtraces on stable."}],"del_contents":[{"Del":"//! My goal in writing this crate is to explore new ways to associate context with\n//! errors, to cleanly separate the concept of an error and context about an error,\n//! and to more clearly communicate the intended usage of this crate via changes to\n//! the API.\n//!\n//! The main changes this crate brings to anyhow are\n//!\n//! * Addition of the [`eyre::EyreContext`] trait and a type parameter on the core\n//! error handling type which users can use to insert custom forms of context\n//! into their catch-all error handling type.\n//! * Rebranding the type as principally for error reporting, rather than\n//! describing it as an error type in its own right. What is and isn't an error\n//! is a fuzzy concept, for the purposes of this crate though errors are types\n//! that implement `std::error::Error`, and you'll notice that this trait\n"},{"Del":"//! implementation is conspicuously absent on `Report`. Instead it contains\n"},{"Del":"//! errors that it masqerades as, and provides helpers for creating new errors to\n//! wrap those errors and for displaying those chains of errors, and the included\n//! context, to the end user. The goal is to make it obvious that this type is\n//! meant to be used when the only way you expect to handle errors is to print\n//! them.\n//! * Changing the [`anyhow::Context`] trait to [`eyre::WrapErr`] to make it clear\n//! that it is unrelated to the [`eyre::EyreContext`] trait and member, and is\n//! only for inserting new errors into the chain of errors.\n//! * Addition of new context helpers on `EyreContext` (`member_ref`/`member_mut`)\n"},{"Del":"//! and `context`/`context_mut` on `Report` for working with the custom\n"},{"Del":"//! context and extracting forms of context based on their type independent of\n//! the type of the custom context.\n//!\n//! These changes were made in order to facilitate the usage of\n//! [`tracing_error::SpanTrace`] with anyhow, which is a Backtrace-like type for\n//! rendering custom defined runtime context.\n"}]}},{"Edit":{"inode":{"change":47,"pos":11888},"path":"src/lib.rs","line":12,"atom":{"EdgeMap":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":2586},"to":{"change":4,"start":2586,"end":2594},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":2594},"to":{"change":4,"start":148,"end":157},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":148},"to":{"change":4,"start":148,"end":157},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":157},"to":{"change":4,"start":2595,"end":2705},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":2705},"to":{"change":4,"start":271,"end":379},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":379},"to":{"change":4,"start":157,"end":161},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":2813},"to":{"change":4,"start":157,"end":161},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":157},"to":{"change":4,"start":157,"end":161},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":161},"to":{"change":4,"start":2814,"end":3439},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":3439},"to":{"change":4,"start":202,"end":284},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":284},"to":{"change":4,"start":380,"end":455},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":455},"to":{"change":4,"start":366,"end":415},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":366},"to":{"change":4,"start":366,"end":415},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":415},"to":{"change":4,"start":3653,"end":3657},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":3653},"to":{"change":4,"start":3653,"end":3657},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":3657},"to":{"change":4,"start":5317,"end":5396},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":5396},"to":{"change":4,"start":3739,"end":5138},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":3739},"to":{"change":4,"start":3739,"end":5138},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":5138},"to":{"change":4,"start":5397,"end":5478},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":5478},"to":{"change":4,"start":5222,"end":5342},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":5222},"to":{"change":4,"start":5222,"end":5342},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":5342},"to":{"change":4,"start":5479,"end":5558},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":5558},"to":{"change":4,"start":5424,"end":6040},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":5424},"to":{"change":4,"start":5424,"end":6040},"introduced_by":4}],"inode":{"change":47,"pos":11888}}},"contents":[{"Del":"//! ```\n"},{"Del":"//!
\n"},{"Del":"//!\n//! ## Customization\n//!\n//! In order to insert your own custom context type you must first implement the\n"},{"Del":"//! `eyre::EyreContext` trait for said type, which has two required methods and\n//! three optional methods.\n"},{"Del":"//!\n"},{"Del":"//! ### Required Methods\n//!\n//! * `fn default(error: &Error) -> Self` - For constructing default context while\n//! allowing special case handling depending on the content of the error you're\n//! wrapping.\n//!\n//! This is essentially `Default::default` but more flexible, for example, the\n//! `eyre::DefaultContext` type provide by this crate uses this to only capture a\n//! `Backtrace` if the inner `Error` does not already have one.\n//!\n//! ```rust,compile_fail\n//! fn default(error: &(dyn StdError + 'static)) -> Self {\n//! let backtrace = backtrace_if_absent!(error);\n//!\n//! Self { backtrace }\n//! }\n//! ```\n//!\n"},{"Del":"//! * `fn debug(&self, error: &(dyn Error + 'static), f: &mut fmt::Formatter<'_>)\n"},{"Del":"//! -> fmt Result` and optionally `display`. - For formatting the entire\n"},{"Del":"//! error chain and the user provided context.\n"},{"Del":"//!\n"},{"Del":"//! When overriding the context it no longer makes sense for `eyre::Report` to\n"},{"Del":"//! provide the `Display` and `Debug` implementations for the user, becase we\n//! cannot predict what forms of context you will need to display along side your\n//! chain of errors. Instead we forward the implementations of `Display` and\n//! `Debug` to these methods on the inner `EyreContext` type.\n//!\n//! This crate does provide a few helpers to assist in writing display\n//! implementations, specifically the `Chain` type, for treating an error and its\n//! sources like an iterator, and the `Indented` type, for indenting multi line\n//! errors consistently without using heap allocations.\n//!\n//! **Note**: best practices for printing errors suggest that `{}` should only\n//! print the current error and none of its sources, and that the primary method of\n//! displaying an error, its sources, and its context should be handled by the\n//! `Debug` implementation, which is what is used to print errors that are returned\n//! from `main`. For examples on how to implement this please refer to the\n//! implementations of `display` and `debug` on `eyre::DefaultContext`\n//!\n//! ### Optional Methods\n//!\n//! * `fn member_ref(&self, typeid TypeID) -> Option<&dyn Any>` - For extracting\n//! arbitrary members from a context based on their type and `member_mut` for\n//! getting a mutable reference in the same way.\n//!\n//! This method is like a flexible version of the `fn backtrace(&self)` method on\n"},{"Del":"//! the `Error` trait. The main `Report` type provides versions of these methods\n"},{"Del":"//! that use type inference to get the typeID that should be used by inner trait fn\n//! to pick a member to return.\n//!\n"},{"Del":"//! **Note**: The `backtrace()` fn on `Report` relies on the implementation of\n"},{"Del":"//! this function to get the backtrace from the user provided context if one\n//! exists. If you wish your type to guaruntee that it captures a backtrace for any\n//! error it wraps you **must** implement `member_ref` and provide a path to return\n//! a `Backtrace` type like below.\n//!\n//! Here is how the `eyre::DefaultContext` type uses this to return `Backtrace`s.\n//!\n//! ```rust,compile_fail\n//! fn member_ref(&self, typeid: TypeId) -> Option<&dyn Any> {\n//! if typeid == TypeId::of::() {\n//! self.backtrace.as_ref().map(|b| b as &dyn Any)\n//! } else {\n//! None\n//! }\n//! }\n"}]}},{"Edit":{"inode":{"change":47,"pos":11888},"path":"src/lib.rs","line":13,"atom":{"EdgeMap":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":6048},"to":{"change":4,"start":6048,"end":6204},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":6204},"to":{"change":4,"start":5559,"end":5602},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":5602},"to":{"change":4,"start":6253,"end":6282},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":6253},"to":{"change":4,"start":6253,"end":6282},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":6282},"to":{"change":4,"start":5603,"end":5681},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":5681},"to":{"change":4,"start":6363,"end":6371},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":6363},"to":{"change":4,"start":6363,"end":6371},"introduced_by":4}],"inode":{"change":47,"pos":11888}}},"contents":[{"Del":"//!\n//! Once you've defined a custom Context type you can use it throughout your\n//! application by defining a type alias.\n//!\n//!\n//! ```rust,compile_fail\n"},{"Del":"//! type Report = eyre::Report;\n"},{"Del":"//!\n//! // And optionally...\n"},{"Del":"//! type Result> = core::result::Result;\n"},{"Del":"//! ```\n"}]}},{"Edit":{"inode":{"change":47,"pos":11888},"path":"src/lib.rs","line":199,"atom":{"NewVertex":{"up_context":[{"change":4,"pos":1820}],"down_context":[{"change":4,"pos":416}],"flag":"BLOCK","start":1500,"end":2497,"inode":{"change":47,"pos":11888}}},"contents":[{"Add":"//!"},{"Add":"//! # Compatibility with `anyhow`"},{"Add":"//!"},{"Add":"//! This crate does its best to be usable as a drop in replacement of `anyhow` and"},{"Add":"//! vice-versa by `re-exporting` all of the renamed APIs with the names used in"},{"Add":"//! `anyhow`."},{"Add":"//!"},{"Add":"//! It is not 100% compatible because there are some cases where `eyre` encounters"},{"Add":"//! type inference errors but it should mostly work as a drop in replacement."},{"Add":"//! Specifically, the following works in anyhow:"},{"Add":"//!"},{"Add":"//! ```rust,compile_fail"},{"Add":"//! // Works"},{"Add":"//! let val = get_optional_val.ok_or_else(|| anyhow!(\"failed to get value\")).unwrap();"},{"Add":"//! ```"},{"Add":"//!"},{"Add":"//! Where as with `eyre!` this will fail due to being unable to infer the type for"},{"Add":"//! the Context parameter. The solution to this problem, should you encounter it,"},{"Add":"//! is to give the compiler a hint for what type it should be resolving to, either"},{"Add":"//! via your return type or a type annotation."},{"Add":"//!"},{"Add":"//! ```rust,compile_fail"},{"Add":"//! // Broken"},{"Add":"//! let val = get_optional_val.ok_or_else(|| eyre!(\"failed to get value\")).unwrap();"}]}},{"Edit":{"inode":{"change":47,"pos":11888},"path":"src/lib.rs","line":224,"atom":{"NewVertex":{"up_context":[{"change":4,"pos":420}],"down_context":[{"change":4,"pos":6098}],"flag":"BLOCK","start":2498,"end":2612,"inode":{"change":47,"pos":11888}}},"contents":[{"Add":"//! // Works"},{"Add":"//! let val: Report = get_optional_val.ok_or_else(|| eyre!(\"failed to get value\")).unwrap();"},{"Add":"//! ```"}]}},{"Edit":{"inode":{"change":47,"pos":11888},"path":"src/lib.rs","line":233,"atom":{"NewVertex":{"up_context":[{"change":3,"pos":102}],"down_context":[{"change":4,"pos":6160}],"flag":"BLOCK","start":2613,"end":2662,"inode":{"change":47,"pos":11888}}},"contents":[{"Add":"//! [`stable_eyre`]: https://docs.rs/stable-eyre"}]}},{"Edit":{"inode":{"change":47,"pos":11888},"path":"src/lib.rs","line":292,"atom":{"NewVertex":{"up_context":[{"change":4,"pos":7005}],"down_context":[{"change":4,"pos":6215}],"flag":"BLOCK","start":2663,"end":2752,"inode":{"change":47,"pos":11888}}},"contents":[{"Add":"/// Compatibility re-export of `eyre` for interopt with `anyhow`"},{"Add":"pub use eyre as anyhow;"}]}},{"Edit":{"inode":{"change":47,"pos":11888},"path":"src/lib.rs","line":296,"atom":{"NewVertex":{"up_context":[{"change":4,"pos":6259}],"down_context":[{"change":49,"pos":79}],"flag":"BLOCK","start":2753,"end":2941,"inode":{"change":47,"pos":11888}}},"contents":[{"Add":"/// Compatibility re-export of `Report` for interopt with `anyhow`"},{"Add":"pub use Report as Error;"},{"Add":"/// Compatibility re-export of `WrapErr` for interopt with `anyhow`"},{"Add":"pub use WrapErr as Context;"}]}},{"Edit":{"inode":{"change":47,"pos":11888},"path":"src/lib.rs","line":399,"atom":{"NewVertex":{"up_context":[{"change":4,"pos":11434}],"down_context":[{"change":4,"pos":11434}],"flag":"BLOCK","start":2942,"end":3442,"inode":{"change":47,"pos":11888}}},"contents":[{"Add":"/// Context trait for customizing `eyre::Report`"},{"Add":"///"},{"Add":"/// ## Customization"},{"Add":"///"},{"Add":"/// In order to insert your own custom context type you must first implement the"},{"Add":"/// `eyre::EyreContext` trait."},{"Add":"///"},{"Add":"/// Once you've defined a custom Context type you can use it throughout your"},{"Add":"/// application by defining a type alias."},{"Add":"///"},{"Add":"/// ```rust,compile_fail"},{"Add":"/// type Report = eyre::Report;"},{"Add":"///"},{"Add":"/// // And optionally..."},{"Add":"/// type Result> = core::result::Result;"},{"Add":"/// ```"}]}},{"Edit":{"inode":{"change":47,"pos":11888},"path":"src/lib.rs","line":416,"atom":{"NewVertex":{"up_context":[{"change":4,"pos":11489}],"down_context":[{"change":4,"pos":1409}],"flag":"BLOCK","start":3443,"end":4385,"inode":{"change":47,"pos":11888}}},"contents":[{"Add":" /// Default construct a `Context` when constructing a `Report`."},{"Add":" ///"},{"Add":" /// This method provides a reference to the error being wrapped to support conditional"},{"Add":" /// capturing of context like `backtrace` depending on whether the source error already"},{"Add":" /// captured one."},{"Add":" ///"},{"Add":" /// # Example"},{"Add":" ///"},{"Add":" /// ```rust,compile_fail"},{"Add":" /// use std::backtrace::Backtrace;"},{"Add":" ///"},{"Add":" /// #[derive(Debug)]"},{"Add":" /// pub struct Context {"},{"Add":" /// backtrace: Option,"},{"Add":" /// }"},{"Add":" ///"},{"Add":" /// impl EyreContext for Context {"},{"Add":" /// #[allow(unused_variables)]"},{"Add":" /// fn default(error: &(dyn Error + 'static)) -> Self {"},{"Add":" /// let backtrace = if error.backtrace().is_some() {"},{"Add":" /// None"},{"Add":" /// } else {"},{"Add":" /// Some(Backtrace::capture())"},{"Add":" /// };"},{"Add":" ///"},{"Add":" /// Self { backtrace }"},{"Add":" /// }"},{"Add":" ///"},{"Add":" /// // ..."},{"Add":" /// }"},{"Add":" ///"},{"Add":" /// ```"}]}},{"Edit":{"inode":{"change":47,"pos":11888},"path":"src/lib.rs","line":449,"atom":{"NewVertex":{"up_context":[{"change":4,"pos":1465}],"down_context":[{"change":50,"pos":686}],"flag":"BLOCK","start":4386,"end":5926,"inode":{"change":47,"pos":11888}}},"contents":[{"Add":""},{"Add":" /// Define the report format"},{"Add":" ///"},{"Add":" /// Used to override the report format of `eyre::Report`"},{"Add":" ///"},{"Add":" /// # Example"},{"Add":" ///"},{"Add":" /// ```rust,compile_fail"},{"Add":" /// impl EyreContext for Context {"},{"Add":" /// // ..."},{"Add":" ///"},{"Add":" /// fn debug("},{"Add":" /// &self,"},{"Add":" /// error: &(dyn Error + 'static),"},{"Add":" /// f: &mut core::fmt::Formatter<'_>,"},{"Add":" /// ) -> core::fmt::Result {"},{"Add":" /// use core::fmt::Write as _;"},{"Add":" ///"},{"Add":" /// if f.alternate() {"},{"Add":" /// return core::fmt::Debug::fmt(error, f);"},{"Add":" /// }"},{"Add":" ///"},{"Add":" /// write!(f, \"{}\", error)?;"},{"Add":" ///"},{"Add":" /// if let Some(cause) = error.source() {"},{"Add":" /// write!(f, \"\\n\\nCaused by:\")?;"},{"Add":" /// let multiple = cause.source().is_some();"},{"Add":" /// for (n, error) in Chain::new(cause).enumerate() {"},{"Add":" /// writeln!(f)?;"},{"Add":" /// if multiple {"},{"Add":" /// write!(indenter::Indented::numbered(f, n), \"{}\", error)?;"},{"Add":" /// } else {"},{"Add":" /// write!(indenter::Indented::new(f), \"{}\", error)?;"},{"Add":" /// }"},{"Add":" /// }"},{"Add":" /// }"},{"Add":" ///"},{"Add":" /// let backtrace = &self.backtrace;"},{"Add":" /// write!(f, \"\\n\\nStack backtrace:\\n{:?}\", backtrace)?;"},{"Add":" ///"},{"Add":" /// Ok(())"},{"Add":" /// }"},{"Add":" /// }"},{"Add":" /// ```"},{"Add":" fn debug("},{"Add":" &self,"},{"Add":" error: &(dyn StdError + 'static),"},{"Add":" f: &mut core::fmt::Formatter<'_>,"},{"Add":" ) -> core::fmt::Result;"}]}},{"Edit":{"inode":{"change":47,"pos":11888},"path":"src/lib.rs","line":499,"atom":{"NewVertex":{"up_context":[{"change":50,"pos":687}],"down_context":[{"change":50,"pos":687}],"flag":"BLOCK","start":5927,"end":6496,"inode":{"change":47,"pos":11888}}},"contents":[{"Add":" /// Member access function"},{"Add":" ///"},{"Add":" /// The main reason to implement this fn is to provide support for `eyre::Report::backtrace`"},{"Add":" /// which will call this fn on `nightly` when attempting access the captured"},{"Add":" /// `std::backtrace::Backtrace`"},{"Add":" ///"},{"Add":" /// # Example"},{"Add":" /// ```rust,compile_fail"},{"Add":" /// fn member_ref(&self, typeid: TypeId) -> Option<&dyn Any> {"},{"Add":" /// if typeid == TypeId::of::() {"},{"Add":" /// self.backtrace.as_ref().map(|b| b as &dyn Any)"},{"Add":" /// } else {"},{"Add":" /// None"},{"Add":" /// }"},{"Add":" /// }"},{"Add":" /// ```"}]}},{"Edit":{"inode":{"change":47,"pos":11888},"path":"src/lib.rs","line":519,"atom":{"NewVertex":{"up_context":[{"change":4,"pos":11555}],"down_context":[{"change":50,"pos":771}],"flag":"BLOCK","start":6497,"end":6516,"inode":{"change":47,"pos":11888}}},"contents":[{"Add":" #[doc(hidden)]"}]}},{"Edit":{"inode":{"change":47,"pos":11888},"path":"src/lib.rs","line":524,"atom":{"NewVertex":{"up_context":[{"change":4,"pos":2679}],"down_context":[{"change":4,"pos":1466}],"flag":"BLOCK","start":6517,"end":6536,"inode":{"change":47,"pos":11888}}},"contents":[{"Add":" #[doc(hidden)]"}]}},{"Edit":{"inode":{"change":47,"pos":11888},"path":"src/lib.rs","line":540,"atom":{"EdgeMap":{"edges":[{"previous":"","flag":"DELETED","from":{"change":4,"pos":757},"to":{"change":4,"start":2800,"end":2801},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":1609},"to":{"change":4,"start":2800,"end":2801},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":2800},"to":{"change":4,"start":2800,"end":2801},"introduced_by":4},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":2801},"to":{"change":4,"start":1610,"end":1751},"introduced_by":4}],"inode":{"change":47,"pos":11888}}},"contents":[{"Del":"\n"},{"Del":" fn debug(\n &self,\n error: &(dyn StdError + 'static),\n f: &mut core::fmt::Formatter<'_>,\n ) -> core::fmt::Result;\n"}]}},{"Edit":{"inode":{"change":47,"pos":11888},"path":"src/lib.rs","line":839,"atom":{"NewVertex":{"up_context":[{"change":4,"pos":7141}],"down_context":[{"change":49,"pos":1655}],"flag":"BLOCK","start":6537,"end":6745,"inode":{"change":47,"pos":11888}}},"contents":[{"Add":" where"},{"Add":" D: Display + Send + Sync + 'static,"},{"Add":" F: FnOnce() -> D;"},{"Add":""},{"Add":" /// Compatibility re-export of wrap_err for interopt with `anyhow`"},{"Add":" fn context(self, msg: D) -> Result>"}]}},{"Edit":{"inode":{"change":47,"pos":11888},"path":"src/lib.rs","line":846,"atom":{"NewVertex":{"up_context":[{"change":49,"pos":1665}],"down_context":[{"change":4,"pos":2849}],"flag":"BLOCK","start":6746,"end":6939,"inode":{"change":47,"pos":11888}}},"contents":[{"Add":" D: Display + Send + Sync + 'static;"},{"Add":""},{"Add":" /// Compatibility re-export of wrap_err_with for interopt with `anyhow`"},{"Add":" fn with_context(self, f: F) -> Result>"},{"Add":" where"}]}}],"owner":"yaahc","repo":"eyre","token":"YzhC6cpHz9wL84zRo6RHx8CmLR4XDR9oalizIA1FycA=","login":null}

…

Dependencies

Change contents