{"header":{"message":"Update docs a little\n","description":null,"timestamp":"2020-02-28T17:37:41Z","authors":[{"email":"jlusby@yaah.dev","name":"Jane Lusby"}]},"hash":"GFUITBG5JGUCDMG34FEMPPJAZGQKURXA5L2RYS6YOQC4DIQGASMAC","authors":[],"deps":{"hashes":[["GFUITBG5JGUCDMG34FEMPPJAZGQKURXA5L2RYS6YOQC4DIQGASMAC","Update docs a little\n"],["AA",null],["N7U2FHPRHGARPZ6M7LYBDJ52NMYE23VD5YALZ7CC76W3V5OLBP7QC","move fmting to trait and add github actions support\n"],["MCPTFJMN333Z2GVL5J2KPLR6BJ3TAZKUGFORXNZ4YZBRXVQLCMFQC","Add placeholder std feature\n"],["UWMRLBK2V2EYFZVJ5ECX2BQAXDNPRJPYVBHYMJBNKG2PSCFPTXVAC","Release 1.0.24\n"],["J5MV4B4AM4DQCWXQ6ZP4GSB3LDAXISZMKI6TIPI43CQRITKOY6DQC","Release 1.0.4\n"],["7QQNJET43BO52L6BB7GIIWWSD7YSZF56AKUNBEMY53KXL64EF5CAC","Release 1.0.10\n"],["KU3EUQE2P5B6JDOKOCOHMYLFGQMYTWIFXRKQCV4YHY26EIZQQ5VAC","Release 1.0.0\n"],["QLZQ4EFM22GEFD4JAXGL5O2DPIS5QXICOBIBWAQZMWULYAXLW3ZAC","Release 1.0.16\n"],["236GOKPH456B2MQDNF63EHVYXOEWO26TGORKVYQZBT4LTIJFXPCAC","Release 1.0.6\n"],["KVJLO32PLCESEZT2IHB467L6CN6EJBQ3FQY2MD53HDE46NAQWE7AC","Release 1.0.5\n"],["D65N7FFF6MOQ6CFSBVVDRC5VKPHNEEWIYXHT5UBLOWLJGPSYFA4AC","Release 1.0.12\n"],["FUJQNVMLSYHOFH6Z663M2MIGQXYSWGMNUKEIT2O4JYER3CGGLV3AC","Release 1.0.26\n"],["EKYR4HDT6DHI7H5YMSHEBHXLPDCA2X2XNXYHDKHWGMPHNVTUBCMQC","Initial commit\n"],["F6BP6K2WEKNTEBJGJH4LE2JXH3SDSO4GZFIK2J4EBC2PMGAKIKZAC","Release 1.0.13\n"],["OXKWHQFHTDDOWX3QDMHDWHCT3HFKWQS7Z7DEL3ILJBA7GNITA4GAC","Copy readme to crate level doc\n"],["6BNRWGF55J5M3YBWYNTWJCRJQSEHY7YRKOUBV43W7I2HCTFDJHUQC","Document no-std support\n"],["KVTZ5BUW7V7RZ3STMQXF6LXVLMGRXDBEOPRBTHX2O4HELTQ2467QC","make an effort at no_std support\n"],["OOWGPNHEB7QQ7A2NSMAJ5VPFE7FPPDVXM5Q3X7KHAFCAXBOJAIEAC","Set html_root_url\n"],["MCDKSHTMINAAHTISNB6UQPZSSGDI2OEHTHRXEK3Q6YP3SWREKZXAC","Release 1.0.22\n"],["7CFCRKLZLAJ6KKLMCMVKA54FPLPDEIQJWAJMYOESVAFIYYD24ZNQC","Release 1.0.1\n"],["EW76CAD5Y3JX7PYTVSZZQDIOQBYM73ZLNTZUGTR6U7APLGCKX5BAC","Release 1.0.2\n"],["YNQFROO7XUHL53EEKSEO47FWWCWSBFN6YB4WXMFVVEOQUMF6DQRAC","Release 1.0.20\n"],["ZDN7BJ3JA3VL4AYWX3SV24GHP6NCAETJVAKAXKMIZTLHTWLUNMOQC","Detect nightly and only expose backtrace if available\n"],["27FJCOHTEFRJBL5NVKLRYWYAOU6CI4U322PKFY72MRPV4UOWHK4QC","Release 1.0.19\n"],["USP4ZMOPFNQT735CCLW3RYPOQUFHUQEAH7HNTVQEBXQVUZIQUUEQC","Release 1.0.15\n"],["EOLQBFXQGG4UJEVBSXLH6PJRJACTU6W3SGQPCJSEDIVPBO75SRLQC","Add crates-io category"],["TGRYO7YUCIFDN7I2FK5RXGTC7GZLLQVE7YYG7HYLK2Y7Q7C37TSAC","Add reminder about html_root_url\n"],["DBYTNFJIVBGNURGIPWS3NJBI4XPF6IU6NY2BLBTJCECYVCGBWSNAC","Display a Travis badge on crates.io\n"],["3ZZ75E2AOF7DO3TMR422QV7ZXNYOQZTOGF67LVSCEMX6N75Y36LAC","Allow customization of error context\n"],["GOPJFSDQLXOY7EGBNR26HON32UIMSC3IAWZZL57A277CMX2D4OOAC","Rename context apis\n"],["JFNBM5AK6APNNL53OI7ZMCISM5Z4HXBLCXIJY7PQAEFUDHLE4HCAC","Release 1.0.17\n"],["U6V2B33XDTYWTEBLU6EXBUJ6MYKTCWYR67YAJUQ4ZG6FWLWXKZTQC","Release 1.0.3\n"],["GL2F5JA26IICALTT4SQ56GI3W6J7M64XNW7HNAC2Y7ASRU6WNV2QC","Release 1.0.23\n"],["PZ7MJFBMS4GG34VVVCCTJ5TTEDEPFVL72CFRYBMOKRF2BC2FWQKQC","Release 1.0.7\n"],["TOB3GIX6URUWT7SYBP4QJ5FWF6DKP3NMZXRWBZ3H7PKBAJ6VR2IQC","Rename crate to anyhow\n\n\"Any\" conveys an error type that can represent any error, and \"how\"\nsuggests how a function failed. 6 characters is in the ideal range for\ncrate name length. Both anyhow::Error and anyhow::Result are easy to\npronounce.\n"],["D3IJE5IHSC64GMC3QZUYMSPZL2PXIVOHCWF7BREKRQXJQLURZBLQC","Add one sentence project summary\n"],["YWW5TKMSPEGRZ52FQZ3SC4C3DEZ57U5XUO4LHZC34BJA7QR5NSCQC","Add readme stub\n"],["G2VYAJCVORVVN2ZLYRIIHZ5NE34BCCKC4GAK6GO4THUCMFH3I5GAC","Release 1.0.8\n"],["YJUQPNYMVFV46BIEXKJTRVXLSXSKBW23QON2SAP5PMQN5UVRB7ZAC","Release 1.0.9\n"],["DM6P3O3COJK7GKPZHLFGEBOTOPDQMTWOAY2Q74R7O6YN4I7PD3EAC","Release 1.0.18\n"],["QDAWHJQA5USW53TYHBRZ7NOWPRZ7LBWC7XLCNUCSRTQHJ22263WQC","Release 1.0.25\n"],["VPMZ53P77PEBGYXR46WL2XLD5IS4IJ545BZAKXE63OD2G5VJ5Y4QC","Update crates.io description metadata\n"],["Q7MCJVD4Y227MJCVURE67PLM5EAHJ3NHPL2JPJDXBIBPGV5C3F2AC","Release 1.0.11\n"],["V2JI47ZPBHNQHEY4SAB5IE5NUBUUNN4DRTVECBG3S66VVUAMXT3QC","Release 1.0.21\n"],["LNM226ITXRMWOSX6GOJ4HO72BWFRBDKQTEZMF4QUJUACUIOKIEJQC","Rename core types\n"],["VMNH3BH3MUBCODGOXU3JUFYLVKKKXQLGW7O73T6T45G276XNXSSQC","Release 1.0.14\n"],["CITEDKPB6MKVZUEYEDE5ZKTNVY35HCOAXKDPYG7YLLEOVFNMSRXQC","Import implementation from fehler 1.0.0-alpha.1\n"]],"deps":["N7U2FHPRHGARPZ6M7LYBDJ52NMYE23VD5YALZ7CC76W3V5OLBP7QC"],"known":["EKYR4HDT6DHI7H5YMSHEBHXLPDCA2X2XNXYHDKHWGMPHNVTUBCMQC","TOB3GIX6URUWT7SYBP4QJ5FWF6DKP3NMZXRWBZ3H7PKBAJ6VR2IQC","MCPTFJMN333Z2GVL5J2KPLR6BJ3TAZKUGFORXNZ4YZBRXVQLCMFQC","YWW5TKMSPEGRZ52FQZ3SC4C3DEZ57U5XUO4LHZC34BJA7QR5NSCQC","ZDN7BJ3JA3VL4AYWX3SV24GHP6NCAETJVAKAXKMIZTLHTWLUNMOQC","D3IJE5IHSC64GMC3QZUYMSPZL2PXIVOHCWF7BREKRQXJQLURZBLQC","OXKWHQFHTDDOWX3QDMHDWHCT3HFKWQS7Z7DEL3ILJBA7GNITA4GAC","OOWGPNHEB7QQ7A2NSMAJ5VPFE7FPPDVXM5Q3X7KHAFCAXBOJAIEAC","KU3EUQE2P5B6JDOKOCOHMYLFGQMYTWIFXRKQCV4YHY26EIZQQ5VAC","7CFCRKLZLAJ6KKLMCMVKA54FPLPDEIQJWAJMYOESVAFIYYD24ZNQC","EW76CAD5Y3JX7PYTVSZZQDIOQBYM73ZLNTZUGTR6U7APLGCKX5BAC","TGRYO7YUCIFDN7I2FK5RXGTC7GZLLQVE7YYG7HYLK2Y7Q7C37TSAC","U6V2B33XDTYWTEBLU6EXBUJ6MYKTCWYR67YAJUQ4ZG6FWLWXKZTQC","J5MV4B4AM4DQCWXQ6ZP4GSB3LDAXISZMKI6TIPI43CQRITKOY6DQC","KVJLO32PLCESEZT2IHB467L6CN6EJBQ3FQY2MD53HDE46NAQWE7AC","236GOKPH456B2MQDNF63EHVYXOEWO26TGORKVYQZBT4LTIJFXPCAC","PZ7MJFBMS4GG34VVVCCTJ5TTEDEPFVL72CFRYBMOKRF2BC2FWQKQC","G2VYAJCVORVVN2ZLYRIIHZ5NE34BCCKC4GAK6GO4THUCMFH3I5GAC","YJUQPNYMVFV46BIEXKJTRVXLSXSKBW23QON2SAP5PMQN5UVRB7ZAC","7QQNJET43BO52L6BB7GIIWWSD7YSZF56AKUNBEMY53KXL64EF5CAC","Q7MCJVD4Y227MJCVURE67PLM5EAHJ3NHPL2JPJDXBIBPGV5C3F2AC","D65N7FFF6MOQ6CFSBVVDRC5VKPHNEEWIYXHT5UBLOWLJGPSYFA4AC","F6BP6K2WEKNTEBJGJH4LE2JXH3SDSO4GZFIK2J4EBC2PMGAKIKZAC","VMNH3BH3MUBCODGOXU3JUFYLVKKKXQLGW7O73T6T45G276XNXSSQC","USP4ZMOPFNQT735CCLW3RYPOQUFHUQEAH7HNTVQEBXQVUZIQUUEQC","QLZQ4EFM22GEFD4JAXGL5O2DPIS5QXICOBIBWAQZMWULYAXLW3ZAC","JFNBM5AK6APNNL53OI7ZMCISM5Z4HXBLCXIJY7PQAEFUDHLE4HCAC","DM6P3O3COJK7GKPZHLFGEBOTOPDQMTWOAY2Q74R7O6YN4I7PD3EAC","27FJCOHTEFRJBL5NVKLRYWYAOU6CI4U322PKFY72MRPV4UOWHK4QC","YNQFROO7XUHL53EEKSEO47FWWCWSBFN6YB4WXMFVVEOQUMF6DQRAC","V2JI47ZPBHNQHEY4SAB5IE5NUBUUNN4DRTVECBG3S66VVUAMXT3QC","MCDKSHTMINAAHTISNB6UQPZSSGDI2OEHTHRXEK3Q6YP3SWREKZXAC","GL2F5JA26IICALTT4SQ56GI3W6J7M64XNW7HNAC2Y7ASRU6WNV2QC","UWMRLBK2V2EYFZVJ5ECX2BQAXDNPRJPYVBHYMJBNKG2PSCFPTXVAC","6BNRWGF55J5M3YBWYNTWJCRJQSEHY7YRKOUBV43W7I2HCTFDJHUQC","QDAWHJQA5USW53TYHBRZ7NOWPRZ7LBWC7XLCNUCSRTQHJ22263WQC","VPMZ53P77PEBGYXR46WL2XLD5IS4IJ545BZAKXE63OD2G5VJ5Y4QC","FUJQNVMLSYHOFH6Z663M2MIGQXYSWGMNUKEIT2O4JYER3CGGLV3AC","DBYTNFJIVBGNURGIPWS3NJBI4XPF6IU6NY2BLBTJCECYVCGBWSNAC","EOLQBFXQGG4UJEVBSXLH6PJRJACTU6W3SGQPCJSEDIVPBO75SRLQC","LNM226ITXRMWOSX6GOJ4HO72BWFRBDKQTEZMF4QUJUACUIOKIEJQC","3ZZ75E2AOF7DO3TMR422QV7ZXNYOQZTOGF67LVSCEMX6N75Y36LAC","GOPJFSDQLXOY7EGBNR26HON32UIMSC3IAWZZL57A277CMX2D4OOAC","KVTZ5BUW7V7RZ3STMQXF6LXVLMGRXDBEOPRBTHX2O4HELTQ2467QC"]},"hunks":[{"Replacement":{"inode":{"change":3,"pos":13},"path":"Cargo.toml","line":3,"ins":{"up_context":[{"change":3,"pos":14}],"down_context":[{"change":3,"pos":114}],"flag":"BLOCK","start":0,"end":135,"inode":{"change":3,"pos":13}},"del":{"edges":[{"previous":"","flag":"DELETED","from":{"change":3,"pos":14},"to":{"change":3,"start":0,"end":54},"introduced_by":3},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":3,"pos":16},"to":{"change":3,"start":0,"end":54},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":18},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":18},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":18},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":53},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":53},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":53},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":53},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":53},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":53},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":53},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":53},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":54},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":54},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":54},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":54},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":54},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":54},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":54},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":54},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":54},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":54},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":54},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":54},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":54},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":54},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":54},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":54},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":54},"to":{"change":3,"start":67,"end":114},"introduced_by":3},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":3,"pos":67},"to":{"change":3,"start":67,"end":114},"introduced_by":3}],"inode":{"change":3,"pos":13}},"ins_contents":[{"Add":"version = \"0.2.0\" # remember to update html_root_url"},{"Add":"authors = [\"David Tolnay \", \"Jane Lusby \"]"}],"del_contents":[{"Del":"version = \"1.0.26\" # remember to update html_root_url\n"},{"Del":"authors = [\"David Tolnay \"]\n"}]}},{"Replacement":{"inode":{"change":3,"pos":13},"path":"Cargo.toml","line":7,"ins":{"up_context":[{"change":3,"pos":161}],"down_context":[{"change":3,"pos":62}],"flag":"BLOCK","start":136,"end":276,"inode":{"change":3,"pos":13}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":3,"pos":161},"to":{"change":3,"start":0,"end":72},"introduced_by":3},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":3,"pos":72},"to":{"change":3,"start":15,"end":62},"introduced_by":3}],"inode":{"change":3,"pos":13}},"ins_contents":[{"Add":"description = \"Flexible concrete Error Handling and Reporting type built on std::error::Error\""},{"Add":"repository = \"https://github.com/yaahc/eyre\""}],"del_contents":[{"Del":"description = \"Flexible concrete Error type built on std::error::Error\"\n"},{"Del":"repository = \"https://github.com/dtolnay/eyre\"\n"}]}},{"Edit":{"inode":{"change":3,"pos":13},"path":"Cargo.toml","line":13,"atom":{"EdgeMap":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":3,"pos":1},"to":{"change":3,"start":0,"end":9},"introduced_by":3},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":3,"pos":9},"to":{"change":3,"start":102,"end":146},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":3,"pos":146},"to":{"change":3,"start":55,"end":56},"introduced_by":3},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":3,"pos":55},"to":{"change":3,"start":55,"end":56},"introduced_by":3}],"inode":{"change":3,"pos":13}}},"contents":[{"Del":"[badges]\n"},{"Del":"travis-ci = { repository = \"dtolnay/eyre\" }\n"},{"Del":"\n"}]}},{"Replacement":{"inode":{"change":3,"pos":12},"path":"README.md","line":4,"ins":{"up_context":[{"change":3,"pos":69}],"down_context":[{"change":3,"pos":259}],"flag":"BLOCK","start":277,"end":323,"inode":{"change":3,"pos":12}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":3,"pos":69},"to":{"change":3,"start":147,"end":259},"introduced_by":3}],"inode":{"change":3,"pos":12}},"ins_contents":[{"Add":"[![Build Status][actions-badge]][actions-url]"}],"del_contents":[{"Del":"[![Build Status](https://api.travis-ci.com/dtolnay/eyre.svg?branch=master)](https://travis-ci.com/dtolnay/eyre)\n"}]}},{"Edit":{"inode":{"change":3,"pos":12},"path":"README.md","line":11,"atom":{"NewVertex":{"up_context":[{"change":2,"pos":2014}],"down_context":[{"change":3,"pos":381}],"flag":"BLOCK","start":324,"end":1916,"inode":{"change":3,"pos":12}}},"contents":[{"Add":""},{"Add":"First and foremost, this crate is a fork of `anyhow` by @dtolnay. My goal in"},{"Add":"writing this crate is to explore new directions of handling context and to"},{"Add":"explore new ways to communicate the intended usage of this crate via changes to"},{"Add":"the API."},{"Add":""},{"Add":"The main changes this crate brings to anyhow are"},{"Add":""},{"Add":"* Addition of the [`eyre::EyreContext`] trait and a type parameter on the core error"},{"Add":" handling type which users can use to insert custom forms of context into"},{"Add":" their general error type."},{"Add":"* Rebranding the type as principally for error reporting, rather than"},{"Add":" describing it as an error type in its own right. This type is not an error,"},{"Add":" it contains errors that it masqerades as, and provides helpers for creating"},{"Add":" new errors to wrap those errors and for displaying those chains of errors,"},{"Add":" and the included context, to the end user. The goal is to make it obvious"},{"Add":" that this type is meant to be used when the only way you expect to handle"},{"Add":" errors is to print them."},{"Add":"* Changing the [`anyhow::Context`] trait to [`eyre::WrapErr`] to make it clear"},{"Add":" that it is unrelated to the [`eyre::EyreContext`] and the context member, and"},{"Add":" is only for inserting new errors into the chain of errors."},{"Add":"* Addition of a new `context` function on [`eyre::ErrReport`] to assist with"},{"Add":" extracting members from the inner Context, which is used by"},{"Add":" [`eyre::ErrReport`] to extract [`std::backtrace::Backtrace`]'s from generic"},{"Add":" contexts types."},{"Add":""},{"Add":"These changes were made in order to facilitate the usage of"},{"Add":"[`tracing::SpanTrace`] with anyhow, which is a Backtrace-like type for"},{"Add":"rendering custom defined runtime context."}]}},{"Edit":{"inode":{"change":3,"pos":12},"path":"README.md","line":41,"atom":{"NewVertex":{"up_context":[{"change":3,"pos":382}],"down_context":[{"change":2,"pos":2015}],"flag":"BLOCK","start":1917,"end":2587,"inode":{"change":3,"pos":12}}},"contents":[{"Add":"**Note**: The way the `eyre!` macro works in practice differs from how"},{"Add":"`anyhow!` works due to the addition of the generic type parameter. In anyhow"},{"Add":"the following is valid."},{"Add":""},{"Add":"```rust"},{"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"},{"Add":"// Will work fine"},{"Add":"let val: ErrReport = get_optional_val.ok_or_else(|| eyre!(\"failed to get value)).unwrap();"},{"Add":"```"},{"Add":""}]}},{"Edit":{"inode":{"change":3,"pos":12},"path":"README.md","line":60,"atom":{"NewVertex":{"up_context":[{"change":2,"pos":2080}],"down_context":[{"change":3,"pos":209}],"flag":"BLOCK","start":2588,"end":2730,"inode":{"change":3,"pos":12}}},"contents":[{"Add":"[actions-badge]: https://github.com/yaahc/eyre/workflows/ci/badge.svg"},{"Add":"[actions-url]:https://github.com/yaahc/eyre/actions?query=workflow%3Aci"}]}},{"Edit":{"inode":{"change":3,"pos":12},"path":"README.md","line":63,"atom":{"NewVertex":{"up_context":[{"change":3,"pos":210}],"down_context":[{"change":3,"pos":382}],"flag":"BLOCK","start":2731,"end":5662,"inode":{"change":3,"pos":12}}},"contents":[{"Add":"## Customization"},{"Add":""},{"Add":"In order to insert your own custom context type you must first implement the"},{"Add":"`eyre::EyreContext` trait for said type, which has four required methods."},{"Add":""},{"Add":"* `fn default(error: &Error) -> Self` - For constructing default context while"},{"Add":"allowing special case handling depending on the content of the error you're"},{"Add":"wrapping."},{"Add":""},{"Add":"This is essentially `Default::default` but more flexible, for example, the"},{"Add":"`eyre::DefaultContext` type provide by this crate uses this to only capture a"},{"Add":"`Backtrace` if the inner `Error` does not already have one."},{"Add":""},{"Add":"```rust"},{"Add":"fn default(error: &(dyn StdError + 'static)) -> Self {"},{"Add":" let backtrace = backtrace_if_absent!(error);"},{"Add":""},{"Add":" Self { backtrace }"},{"Add":"}"},{"Add":"```"},{"Add":""},{"Add":"* `fn context_raw(&self, typeid TypeID) -> Option<&dyn Any>` - For extracting"},{"Add":" arbitrary members from a context based on their type."},{"Add":""},{"Add":"This method is like a flexible version of the `fn backtrace(&self)` method on"},{"Add":"the `Error` trait. In the future we will likely support extracting `Backtrace`s"},{"Add":"and `SpanTrace`s by default by relying on the implementation of `context_raw`"},{"Add":"provided by the user."},{"Add":""},{"Add":""},{"Add":"Here is how the `eyre::DefaultContext` type uses this to return `Backtrace`s."},{"Add":""},{"Add":"```rust"},{"Add":"fn context_raw(&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":"```"},{"Add":""},{"Add":"* `fn debug(&self, error: &(dyn Error + 'static), f: &mut fmt::Formatter<'_>) -> fmt Result`"},{"Add":" it's companion `display` version. - For formatting the entire error chain and"},{"Add":" the user provided context."},{"Add":""},{"Add":"When overriding the context it no longer makes sense for `eyre::ErrReport` to"},{"Add":"provide the `Display` and `Debug` implementations for the user, becase we"},{"Add":"cannot predict what forms of context you will need to display along side your"},{"Add":"chain of errors. Instead we forward the implementations of `Display` and"},{"Add":"`Debug` to these methods on the inner `EyreContext` type."},{"Add":""},{"Add":"This crate does provide a few helpers to assist in writing display"},{"Add":"implementations, specifically the `Chain` type, for treating an error and its"},{"Add":"sources like an iterator, and the `Indented` type, for indenting multi line"},{"Add":"errors consistently without using heap allocations."},{"Add":""},{"Add":"**Note**: best practices for printing errors suggest that `{}` should only"},{"Add":"print the current error and none of its sources, and that the primary method of"},{"Add":"displaying an error, its sources, and its context should be handled by the"},{"Add":"`Debug` implementation, which is what is used to print errors that are returned"},{"Add":"from `main`. For examples on how to implement this please refer to the"},{"Add":"implementations of `display` and `debug` on `eyre::DefaultContext`"},{"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"},{"Add":"type ErrReport = eyre::ErrReport;"},{"Add":""},{"Add":"// And optionally..."},{"Add":"type Result> = core::result::Result;"},{"Add":"```"},{"Add":""}]}},{"Replacement":{"inode":{"change":3,"pos":12},"path":"README.md","line":139,"ins":{"up_context":[{"change":3,"pos":405}],"down_context":[{"change":3,"pos":431}],"flag":"BLOCK","start":5663,"end":5676,"inode":{"change":3,"pos":12}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":3,"pos":405},"to":{"change":3,"start":587,"end":600},"introduced_by":3}],"inode":{"change":3,"pos":12}},"ins_contents":[{"Add":"eyre = \"0.2\""}],"del_contents":[{"Del":"eyre = \"1.0\"\n"}]}},{"Edit":{"inode":{"change":3,"pos":12},"path":"README.md","line":235,"atom":{"NewVertex":{"up_context":[{"change":3,"pos":25}],"down_context":[{"change":3,"pos":25}],"flag":"BLOCK","start":5677,"end":5872,"inode":{"change":3,"pos":12}}},"contents":[{"Add":""},{"Add":"**NOTE**: tests are currently broken for `no_std` so I cannot guaruntee that"},{"Add":"everything works still. I'm waiting for upstream fixes to be merged rather than"},{"Add":"fixing them myself, so bear with me."}]}},{"Replacement":{"inode":{"change":3,"pos":12},"path":"README.md","line":246,"ins":{"up_context":[{"change":3,"pos":252}],"down_context":[{"change":3,"pos":307}],"flag":"BLOCK","start":5873,"end":5926,"inode":{"change":3,"pos":12}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":3,"pos":252},"to":{"change":3,"start":924,"end":977},"introduced_by":3}],"inode":{"change":3,"pos":12}},"ins_contents":[{"Add":"eyre = { version = \"0.2\", default-features = false }"}],"del_contents":[{"Del":"eyre = { version = \"1.0\", default-features = false }\n"}]}},{"Replacement":{"inode":{"change":48,"pos":11888},"path":"src/lib.rs","line":172,"ins":{"up_context":[{"change":3,"pos":887}],"down_context":[{"change":3,"pos":946}],"flag":"BLOCK","start":5927,"end":5984,"inode":{"change":48,"pos":11888}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":3,"pos":887},"to":{"change":3,"start":6703,"end":6760},"introduced_by":3}],"inode":{"change":48,"pos":11888}},"ins_contents":[{"Add":"//! eyre = { version = \"0.2\", default-features = false }"}],"del_contents":[{"Del":"//! eyre = { version = \"1.0\", default-features = false }\n"}]}},{"Replacement":{"inode":{"change":48,"pos":11888},"path":"src/lib.rs","line":180,"ins":{"up_context":[{"change":3,"pos":2544}],"down_context":[{"change":3,"pos":1865}],"flag":"BLOCK","start":5985,"end":6039,"inode":{"change":48,"pos":11888}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":3,"pos":2544},"to":{"change":3,"start":6921,"end":6976},"introduced_by":3}],"inode":{"change":48,"pos":11888}},"ins_contents":[{"Add":"#![doc(html_root_url = \"https://docs.rs/eyre/0.2.0\")]"}],"del_contents":[{"Del":"#![doc(html_root_url = \"https://docs.rs/eyre/1.0.26\")]\n"}]}},{"Replacement":{"inode":{"change":48,"pos":11888},"path":"src/lib.rs","line":367,"ins":{"up_context":[{"change":3,"pos":11900}],"down_context":[{"change":2,"pos":2960}],"flag":"BLOCK","start":6040,"end":6246,"inode":{"change":48,"pos":11888}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":3,"pos":11900},"to":{"change":3,"start":11900,"end":12107},"introduced_by":3}],"inode":{"change":48,"pos":11888}},"ins_contents":[{"Add":" fn context_raw(&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"}],"del_contents":[{"Del":" fn context_raw(&self, typid: TypeId) -> Option<&dyn Any> {\n match typid {\n t if t == TypeId::of::() => self.backtrace.as_ref().map(|b| b as &dyn Any),\n _ => None,\n"}]}}],"owner":"yaahc","repo":"eyre","token":"N7diXbvLnC6Ai5g7jWHNnBoDh3ui1yteNXFUwt10Kpg=","login":null}

…

Dependencies

Change contents