{"header":{"message":"Move macros to their own module\n\nNow that lib.rs needs to have other things in it.\n","description":null,"timestamp":"2019-10-21T18:24:04Z","authors":[{"email":"dtolnay@gmail.com","name":"David Tolnay"}]},"hash":"YMUCHF4MBM4KQ2TBSJKGN5JFPZLTTI43CQETAMAC5K6KKLLVE73AC","authors":[],"deps":{"hashes":[["YMUCHF4MBM4KQ2TBSJKGN5JFPZLTTI43CQETAMAC5K6KKLLVE73AC","Move macros to their own module\n\nNow that lib.rs needs to have other things in it.\n"],["AA",null],["CUNXZ67ZJQGGKXH6V6UXXO3BHTXM7Q3TFOCCOGH5BNYLISUIYQJAC","Support string interpolation in bail macro\n"],["JFHL4E7DX2X2KWODFDHNIUB5RLDXWL3FMIBJIEQKO55J7FFJOLHQC","Document bail macro with examples\n"],["SBH3TJ4H3E6ZYSAXSYLUQFW2NK57S7M7LEOZEXZDUO33YXFEVPTAC","Document anyhow macro with example\n"],["N4ANQ2NUA7Y5NPIAVGPYYHI4QQA52YEA6J3LX455AR5FXOJLJ6SQC","Fix bail with single str parameter.\nThis was resulting in a missing From conversion, so now just use the anyhow macro also for single parameter bail.\nAlso added small test to verify that that it compiles.\n"],["DD2LOIR4RWUM35WJK7YL2ENXDQPHFLNM2DLESN3CIAWGNASOUP6QC","Remove unneeded parens in ensure macro\n"],["EHE4X5PVQFLWRTTI6CD2KTQDRP4PW5QBISBZ57MC5DF2DF2I6VPAC","Touch up ensure macro documentation\n"],["IHFIR6TGELGKZOAR2APEY2BHHVK75EKNYPVUWSQHPXS6EZBH5LZQC","make Result more flexible"],["6KL7TFY4VYQ67TCMYG53KQV55EP6PHHN73BFVW6VSDI27CPHVY6QC","Fix anyhow_kind dispatch on owned value\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"],["L5KQKEPFTGP2RH5PC6UIQQUKZFNKL7SIHEBIZ4WZHTYXGIBQHFYAC","Move macro tests to tests directory\n"],["K3KDTBCJ2D6AHLKDKSV7KTKXOXO72KZ5CXBVLCYSKDNRCJ3EGDMQC","Document anyhow::Result with example\n"],["MBJSV73XEUIBF7LU6MUYQJQLCRXYY7LXD7KZZFLLOCEDOKU2EAQAC","Tagged dispatch for anyhow!($expr)\n"],["UM7DFUYLW4HSMBUDZY3R6ZNJRSX2E75C4DYV3MJAU57EUCGE6JLAC","Rename Exception to Error\n"],["VSLQNAQBAGOJC2IV55V3W755UIPN47J4RTCCLCABRFFFUU5LT2JQC","Also move Error and Chain to get usable paths in diagnostics\n"],["JZK5OKKPI672GJNZPKKC3T35E6CUHBLT62YHCKMODOYDLVHU6BUQC","Add ensure macro.\nFix #1.\n"],["7JZIPWVKXY3QA5QMTP24WPR7KKMMVXIHAQ4EGHNGCE7H4CRKROCAC","Remove a layer of wrapping from debug mode backtraces\n"],["TEYHPVS3CWEWID4TOEBXRAYAWG5Q5Y7DIVJRCXSZPOBG745PXBNAC","Add a Result type alias\n"],["MMM45Y76ZSMHJ52WZO2CMP6BTNHTJAA54AZRHSIMNZBML7QNBEFQC","Simplify handling of trailing commas\n"],["BZSTVYDVHJA3ZMCM3YTU4U5JKJC2JVUDM5APSBIGMSS54J2C4WKQC","Accept string literal in bail macro\n"],["LDNILCVWYT3PJ3UOUPRCAASTZXNKSYJBHHB7DO4TVXMYHQQ2DGVQC","Rename throw macro to bail\n"],["GZZOJ7ZUSBPI3HXIV5UCFNMCDAMZPPLISY2UDV73FDN74HZ3AWJAC","Format with rustfmt 2019-09-08\n"],["UZFAWKZ7DHFYNB3MKHLZXPKWPEPOC5YF4E6SHKEJG25NBW2XXLRQC","Rename exception module to error\n"],["W655S25G7CGI4XOZ2PKITKTH26VJ4QMZFRV2RPYNI4KIUJOIGVMAC","Change all remaining exception related wording\n"],["KQXMNV3RMRPSJCQVW4I2HSCFJQ6ZDRLNMJOTQI4MODB6UYA3ONQQC","Make new_adhoc unambiguously private\n"],["G5RLZIDWZF2ZDQ6MMKWORKROOQUNIG4NFLNG6NYVZ3UHEWGGUJEAC","Rename error macro to anyhow\n"],["CITEDKPB6MKVZUEYEDE5ZKTNVY35HCOAXKDPYG7YLLEOVFNMSRXQC","Import implementation from fehler 1.0.0-alpha.1\n"],["BQU6MTEH6QEW5E2HX3F2AAZ54AHIVDVOEE7FTCQTPLO23U5ILFIQC","Rename Errors to Chain\n"],["HHQUHNVMK5HPDJJ53MBD4IE2TDC3BMQOARPHRQAOO43AWG2LNMOAC","Wrap comments to 80 columns\n"],["7B4X77QUU6FEO7YBDMTGJGUDR3EWVORCIUCOZDH76WHZFQ6C2CUAC","Merge pull request 2 from EmbarkStudios/bail-single-str\n"],["RTVLSOCCLZMZRJZXRIX5RHJMAFJO4XK573NXTBZVBEJSUBJPY5ZQC","Accept trailing comma in macros\n"],["JVAAEIVSTVEANB55M7F3UQTFZ7JMGO47UPQPAIHLMZ2VBLUVX2DAC","Recognize literal anyhow as a special case\n"]],"deps":["CUNXZ67ZJQGGKXH6V6UXXO3BHTXM7Q3TFOCCOGH5BNYLISUIYQJAC","JFHL4E7DX2X2KWODFDHNIUB5RLDXWL3FMIBJIEQKO55J7FFJOLHQC","SBH3TJ4H3E6ZYSAXSYLUQFW2NK57S7M7LEOZEXZDUO33YXFEVPTAC","N4ANQ2NUA7Y5NPIAVGPYYHI4QQA52YEA6J3LX455AR5FXOJLJ6SQC","DD2LOIR4RWUM35WJK7YL2ENXDQPHFLNM2DLESN3CIAWGNASOUP6QC","EHE4X5PVQFLWRTTI6CD2KTQDRP4PW5QBISBZ57MC5DF2DF2I6VPAC","IHFIR6TGELGKZOAR2APEY2BHHVK75EKNYPVUWSQHPXS6EZBH5LZQC","6KL7TFY4VYQ67TCMYG53KQV55EP6PHHN73BFVW6VSDI27CPHVY6QC","AOQSHDBY3FLBJBFEIJQDYHGQOBECTYRN3KPWJWQMCVWDTB6L2IRQC"],"known":["CITEDKPB6MKVZUEYEDE5ZKTNVY35HCOAXKDPYG7YLLEOVFNMSRXQC","GZZOJ7ZUSBPI3HXIV5UCFNMCDAMZPPLISY2UDV73FDN74HZ3AWJAC","LDNILCVWYT3PJ3UOUPRCAASTZXNKSYJBHHB7DO4TVXMYHQQ2DGVQC","UZFAWKZ7DHFYNB3MKHLZXPKWPEPOC5YF4E6SHKEJG25NBW2XXLRQC","UM7DFUYLW4HSMBUDZY3R6ZNJRSX2E75C4DYV3MJAU57EUCGE6JLAC","W655S25G7CGI4XOZ2PKITKTH26VJ4QMZFRV2RPYNI4KIUJOIGVMAC","HHQUHNVMK5HPDJJ53MBD4IE2TDC3BMQOARPHRQAOO43AWG2LNMOAC","TEYHPVS3CWEWID4TOEBXRAYAWG5Q5Y7DIVJRCXSZPOBG745PXBNAC","BQU6MTEH6QEW5E2HX3F2AAZ54AHIVDVOEE7FTCQTPLO23U5ILFIQC","G5RLZIDWZF2ZDQ6MMKWORKROOQUNIG4NFLNG6NYVZ3UHEWGGUJEAC","RTVLSOCCLZMZRJZXRIX5RHJMAFJO4XK573NXTBZVBEJSUBJPY5ZQC","KQXMNV3RMRPSJCQVW4I2HSCFJQ6ZDRLNMJOTQI4MODB6UYA3ONQQC","7JZIPWVKXY3QA5QMTP24WPR7KKMMVXIHAQ4EGHNGCE7H4CRKROCAC","MMM45Y76ZSMHJ52WZO2CMP6BTNHTJAA54AZRHSIMNZBML7QNBEFQC","K3KDTBCJ2D6AHLKDKSV7KTKXOXO72KZ5CXBVLCYSKDNRCJ3EGDMQC","BZSTVYDVHJA3ZMCM3YTU4U5JKJC2JVUDM5APSBIGMSS54J2C4WKQC","JZK5OKKPI672GJNZPKKC3T35E6CUHBLT62YHCKMODOYDLVHU6BUQC","7B4X77QUU6FEO7YBDMTGJGUDR3EWVORCIUCOZDH76WHZFQ6C2CUAC","L5KQKEPFTGP2RH5PC6UIQQUKZFNKL7SIHEBIZ4WZHTYXGIBQHFYAC","MBJSV73XEUIBF7LU6MUYQJQLCRXYY7LXD7KZZFLLOCEDOKU2EAQAC","JVAAEIVSTVEANB55M7F3UQTFZ7JMGO47UPQPAIHLMZ2VBLUVX2DAC","VSLQNAQBAGOJC2IV55V3W755UIPN47J4RTCCLCABRFFFUU5LT2JQC"]},"hunks":[{"Edit":{"inode":{"change":11,"pos":11888},"path":"src/lib.rs","line":182,"atom":{"NewVertex":{"up_context":[{"change":11,"pos":913}],"down_context":[{"change":11,"pos":12395}],"flag":"BLOCK","start":0,"end":12,"inode":{"change":11,"pos":11888}}},"contents":[{"Add":"mod macros;"}]}},{"Edit":{"inode":{"change":11,"pos":11888},"path":"src/lib.rs","line":279,"atom":{"EdgeMap":{"edges":[{"previous":"","flag":"DELETED","from":{"change":8,"pos":59},"to":{"change":11,"start":75,"end":76},"introduced_by":8},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":75},"to":{"change":11,"start":75,"end":76},"introduced_by":11},{"previous":"","flag":"DELETED","from":{"change":11,"pos":76},"to":{"change":11,"start":0,"end":32},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":12854},"to":{"change":11,"start":0,"end":32},"introduced_by":11},{"previous":"","flag":"DELETED","from":{"change":11,"pos":32},"to":{"change":11,"start":12874,"end":12878},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":12874},"to":{"change":11,"start":12874,"end":12878},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":12878},"to":{"change":11,"start":33,"end":97},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":97},"to":{"change":3,"start":0,"end":1237},"introduced_by":3},{"previous":"","flag":"DELETED","from":{"change":11,"pos":97},"to":{"change":11,"start":12924,"end":12940},"introduced_by":11},{"previous":"","flag":"DELETED","from":{"change":3,"pos":1237},"to":{"change":11,"start":12924,"end":12940},"introduced_by":3},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":12924},"to":{"change":11,"start":12924,"end":12940},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":12940},"to":{"change":11,"start":98,"end":118},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":118},"to":{"change":11,"start":0,"end":101},"introduced_by":11},{"previous":"","flag":"DELETED","from":{"change":11,"pos":101},"to":{"change":11,"start":0,"end":27},"introduced_by":11},{"previous":"","flag":"DELETED","from":{"change":11,"pos":101},"to":{"change":11,"start":0,"end":27},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":118},"to":{"change":11,"start":0,"end":27},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":27},"to":{"change":5,"start":0,"end":64},"introduced_by":5},{"previous":"","flag":"DELETED","from":{"change":11,"pos":58},"to":{"change":11,"start":2349,"end":2356},"introduced_by":11},{"previous":"","flag":"DELETED","from":{"change":5,"pos":64},"to":{"change":11,"start":2349,"end":2356},"introduced_by":5},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":2349},"to":{"change":11,"start":2349,"end":2356},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":2356},"to":{"change":2,"start":0,"end":115},"introduced_by":2},{"previous":"","flag":"DELETED","from":{"change":2,"pos":115},"to":{"change":11,"start":13048,"end":13051},"introduced_by":2},{"previous":"","flag":"DELETED","from":{"change":11,"pos":2356},"to":{"change":11,"start":13048,"end":13051},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":13048},"to":{"change":11,"start":13048,"end":13051},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":13051},"to":{"change":11,"start":0,"end":68},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":68},"to":{"change":7,"start":0,"end":79},"introduced_by":7},{"previous":"","flag":"DELETED","from":{"change":7,"pos":79},"to":{"change":11,"start":150,"end":154},"introduced_by":7},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":150},"to":{"change":11,"start":150,"end":154},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":154},"to":{"change":7,"start":80,"end":263},"introduced_by":7},{"previous":"","flag":"DELETED","from":{"change":7,"pos":263},"to":{"change":11,"start":330,"end":402},"introduced_by":7},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":330},"to":{"change":11,"start":330,"end":402},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":408},"to":{"change":11,"start":408,"end":464},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":492},"to":{"change":11,"start":492,"end":1447},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":1447},"to":{"change":11,"start":102,"end":249},"introduced_by":11},{"previous":"","flag":"DELETED","from":{"change":11,"pos":249},"to":{"change":11,"start":1447,"end":1486},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":1447},"to":{"change":11,"start":1447,"end":1486},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":1486},"to":{"change":6,"start":0,"end":20},"introduced_by":6},{"previous":"","flag":"DELETED","from":{"change":6,"pos":20},"to":{"change":11,"start":1508,"end":1639},"introduced_by":6},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":1508},"to":{"change":11,"start":1508,"end":1639},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":1639},"to":{"change":6,"start":21,"end":41},"introduced_by":6},{"previous":"","flag":"DELETED","from":{"change":6,"pos":41},"to":{"change":11,"start":1661,"end":1759},"introduced_by":6},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":1661},"to":{"change":11,"start":1661,"end":1759},"introduced_by":11},{"previous":"","flag":"DELETED","from":{"change":11,"pos":1759},"to":{"change":11,"start":698,"end":743},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":13051},"to":{"change":11,"start":698,"end":743},"introduced_by":11},{"previous":"","flag":"DELETED","from":{"change":11,"pos":743},"to":{"change":11,"start":13100,"end":13104},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":13100},"to":{"change":11,"start":13100,"end":13104},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":13104},"to":{"change":11,"start":683,"end":867},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":867},"to":{"change":4,"start":0,"end":311},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":4,"pos":311},"to":{"change":11,"start":13288,"end":13304},"introduced_by":4},{"previous":"","flag":"DELETED","from":{"change":11,"pos":867},"to":{"change":11,"start":13288,"end":13304},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":13288},"to":{"change":11,"start":13288,"end":13304},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":13304},"to":{"change":11,"start":0,"end":22},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":22},"to":{"change":11,"start":250,"end":474},"introduced_by":11},{"previous":"","flag":"DELETED","from":{"change":11,"pos":474},"to":{"change":11,"start":942,"end":1028},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":942},"to":{"change":11,"start":942,"end":1028},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":1028},"to":{"change":11,"start":475,"end":501},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":501},"to":{"change":9,"start":42,"end":84},"introduced_by":9},{"previous":"","flag":"DELETED","from":{"change":9,"pos":84},"to":{"change":11,"start":1093,"end":1101},"introduced_by":9},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":1093},"to":{"change":11,"start":1093,"end":1101},"introduced_by":11},{"previous":"","flag":"DELETED","from":{"change":11,"pos":1101},"to":{"change":11,"start":185,"end":219},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":185},"to":{"change":11,"start":185,"end":219},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":219},"to":{"change":11,"start":94,"end":154},"introduced_by":11},{"previous":"","flag":"DELETED","from":{"change":11,"pos":154},"to":{"change":11,"start":277,"end":284},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":277},"to":{"change":11,"start":277,"end":284},"introduced_by":11},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":284},"to":{"change":10,"start":81,"end":83},"introduced_by":10}],"inode":{"change":11,"pos":11888}}},"contents":[{"Del":"\n"},{"Del":"/// Return early with an error.\n"},{"Del":"///\n"},{"Del":"/// This macro is equivalent to `return Err(From::from($err))`.\n"},{"Del":"///\n/// # Example\n///\n/// ```\n/// # use anyhow::{bail, Result};\n/// #\n/// # fn has_permission(user: usize, resource: usize) -> bool {\n/// # true\n/// # }\n/// #\n/// # fn main() -> Result<()> {\n/// # let user = 0;\n/// # let resource = 0;\n/// #\n/// if !has_permission(user, resource) {\n/// bail!(\"permission denied for accessing {}\", resource);\n/// }\n/// # Ok(())\n/// # }\n/// ```\n///\n/// ```\n/// # use anyhow::{bail, Result};\n/// # use std::fmt::{self, Display};\n/// #\n/// # #[derive(Debug)]\n/// # enum ScienceError {\n/// # RecursionLimitExceeded,\n/// # }\n/// #\n/// # impl std::error::Error for ScienceError {}\n/// #\n/// # impl Display for ScienceError {\n/// # fn fmt(&self, formatter: &mut fmt::Formatter) -> fmt::Result {\n/// # unimplemented!()\n/// # }\n/// # }\n/// #\n/// # const MAX_DEPTH: usize = 1;\n/// #\n/// # const IGNORE: &str = stringify! {\n/// #[derive(Error, Debug)]\n/// enum ScienceError {\n/// #[error(display = \"recursion limit exceeded\")]\n/// RecursionLimitExceeded,\n/// ...\n/// }\n/// # };\n///\n/// # fn main() -> Result<()> {\n/// # let depth = 0;\n/// #\n/// if depth > MAX_DEPTH {\n/// bail!(ScienceError::RecursionLimitExceeded);\n/// }\n/// # Ok(())\n/// # }\n/// ```\n"},{"Del":"#[macro_export]\n"},{"Del":"macro_rules! bail {\n"},{"Del":" ($msg:literal $(,)?) => {\n return std::result::Result::Err($crate::anyhow!($msg));\n };\n"},{"Del":" ($err:expr $(,)?) => {\n"},{"Del":" return std::result::Result::Err($crate::anyhow!($err));\n"},{"Del":" };\n"},{"Del":" ($fmt:expr, $($arg:tt)*) => {\n return std::result::Result::Err($crate::anyhow!($fmt, $($arg)*));\n };\n"},{"Del":"}\n\n"},{"Del":"/// Return early with an error if a condition is not satisfied.\n///\n"},{"Del":"/// This macro is equivalent to `if !$cond { return Err(From::from($err)); }`.\n"},{"Del":"///\n"},{"Del":"/// Analogously to `assert!`, `ensure!` takes a condition and exits the function\n/// if the condition fails. Unlike `assert!`, `ensure!` returns an `Error`\n/// rather than panicking.\n"},{"Del":"///\n/// # Example\n///\n/// ```\n/// # use anyhow::{ensure, Result};\n/// #\n"},{"Del":"/// # fn main() -> Result<()> {\n/// # let user = 0;\n"},{"Del":"/// #\n/// ensure!(user == 0, \"only user 0 is allowed\");\n/// # Ok(())\n/// # }\n/// ```\n///\n/// ```\n/// # use anyhow::{ensure, Result};\n/// # use std::fmt::{self, Display};\n/// #\n/// # #[derive(Debug)]\n/// # enum ScienceError {\n/// # RecursionLimitExceeded,\n/// # }\n/// #\n/// # impl std::error::Error for ScienceError {}\n/// #\n/// # impl Display for ScienceError {\n/// # fn fmt(&self, formatter: &mut fmt::Formatter) -> fmt::Result {\n/// # unimplemented!()\n/// # }\n/// # }\n/// #\n/// # const MAX_DEPTH: usize = 1;\n/// #\n/// # const IGNORE: &str = stringify! {\n/// #[derive(Error, Debug)]\n/// enum ScienceError {\n/// #[error(display = \"recursion limit exceeded\")]\n/// RecursionLimitExceeded,\n/// ...\n/// }\n/// # };\n///\n/// # fn main() -> Result<()> {\n/// # let depth = 0;\n/// #\n/// ensure!(depth <= MAX_DEPTH, ScienceError::RecursionLimitExceeded);\n/// # Ok(())\n/// # }\n/// ```\n#[macro_export]\nmacro_rules! ensure {\n"},{"Del":" ($cond:expr, $msg:literal $(,)?) => {\n if !$cond {\n return std::result::Result::Err($crate::anyhow!($msg));\n }\n };\n"},{"Del":" ($cond:expr, $err:expr $(,)?) => {\n"},{"Del":" if !$cond {\n"},{"Del":" return std::result::Result::Err($crate::anyhow!($err));\n }\n };\n ($cond:expr, $fmt:expr, $($arg:tt)*) => {\n"},{"Del":" if !$cond {\n"},{"Del":" return std::result::Result::Err($crate::anyhow!($fmt, $($arg)*));\n }\n };\n}\n\n"},{"Del":"/// Construct an ad-hoc error from a string.\n"},{"Del":"///\n"},{"Del":"/// This evaluates to an `Error`. It can take either just a string, or a format\n/// string with arguments. It also can take any custom type which implements\n/// `Debug` and `Display`.\n"},{"Del":"///\n/// # Example\n///\n/// ```\n/// # type V = ();\n/// #\n/// use anyhow::{anyhow, Result};\n///\n/// fn lookup(key: &str) -> Result {\n/// if key.len() != 16 {\n/// return Err(anyhow!(\"key length must be 16 characters, got {:?}\", key));\n/// }\n/// \n/// // ...\n/// # Ok(())\n/// }\n/// ```\n"},{"Del":"#[macro_export]\n"},{"Del":"macro_rules! anyhow {\n"},{"Del":" ($msg:literal $(,)?) => {\n // Handle $:literal as a special case to make cargo-expanded code more\n // concise in the common case.\n $crate::private::new_adhoc($msg)\n };\n ($err:expr $(,)?) => ({\n"},{"Del":" #[allow(unused_imports)]\n use $crate::private::{AdhocKind, TraitKind};\n"},{"Del":" let error = $err;\n"},{"Del":" (&error).anyhow_kind().new(error)\n"},{"Del":" });\n"},{"Del":" ($fmt:expr, $($arg:tt)*) => {\n"},{"Del":" $crate::private::new_adhoc(format!($fmt, $($arg)*))\n"},{"Del":" };\n"},{"Del":"}\n"}]}},{"Replacement":{"inode":{"change":11,"pos":11888},"path":"src/lib.rs","line":339,"ins":{"up_context":[{"change":11,"pos":158}],"down_context":[{"change":11,"pos":177}],"flag":"BLOCK","start":13,"end":68,"inode":{"change":11,"pos":11888}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":11,"pos":158},"to":{"change":11,"start":158,"end":177},"introduced_by":11}],"inode":{"change":11,"pos":11888}},"ins_contents":[{"Add":"// Not public API. Referenced by macro-generated code."}],"del_contents":[{"Del":"// Not public API.\n"}]}},{"FileAdd":{"meta":{"basename":"macros.rs","metadata":0},"context":[{"change":11,"pos":6}],"contents":[{"Add":"/// Return early with an error."},{"Add":"///"},{"Add":"/// This macro is equivalent to `return Err(From::from($err))`."},{"Add":"///"},{"Add":"/// # Example"},{"Add":"///"},{"Add":"/// ```"},{"Add":"/// # use anyhow::{bail, Result};"},{"Add":"/// #"},{"Add":"/// # fn has_permission(user: usize, resource: usize) -> bool {"},{"Add":"/// # true"},{"Add":"/// # }"},{"Add":"/// #"},{"Add":"/// # fn main() -> Result<()> {"},{"Add":"/// # let user = 0;"},{"Add":"/// # let resource = 0;"},{"Add":"/// #"},{"Add":"/// if !has_permission(user, resource) {"},{"Add":"/// bail!(\"permission denied for accessing {}\", resource);"},{"Add":"/// }"},{"Add":"/// # Ok(())"},{"Add":"/// # }"},{"Add":"/// ```"},{"Add":"///"},{"Add":"/// ```"},{"Add":"/// # use anyhow::{bail, Result};"},{"Add":"/// # use std::fmt::{self, Display};"},{"Add":"/// #"},{"Add":"/// # #[derive(Debug)]"},{"Add":"/// # enum ScienceError {"},{"Add":"/// # RecursionLimitExceeded,"},{"Add":"/// # }"},{"Add":"/// #"},{"Add":"/// # impl std::error::Error for ScienceError {}"},{"Add":"/// #"},{"Add":"/// # impl Display for ScienceError {"},{"Add":"/// # fn fmt(&self, formatter: &mut fmt::Formatter) -> fmt::Result {"},{"Add":"/// # unimplemented!()"},{"Add":"/// # }"},{"Add":"/// # }"},{"Add":"/// #"},{"Add":"/// # const MAX_DEPTH: usize = 1;"},{"Add":"/// #"},{"Add":"/// # const IGNORE: &str = stringify! {"},{"Add":"/// #[derive(Error, Debug)]"},{"Add":"/// enum ScienceError {"},{"Add":"/// #[error(display = \"recursion limit exceeded\")]"},{"Add":"/// RecursionLimitExceeded,"},{"Add":"/// ..."},{"Add":"/// }"},{"Add":"/// # };"},{"Add":"///"},{"Add":"/// # fn main() -> Result<()> {"},{"Add":"/// # let depth = 0;"},{"Add":"/// #"},{"Add":"/// if depth > MAX_DEPTH {"},{"Add":"/// bail!(ScienceError::RecursionLimitExceeded);"},{"Add":"/// }"},{"Add":"/// # Ok(())"},{"Add":"/// # }"},{"Add":"/// ```"},{"Add":"#[macro_export]"},{"Add":"macro_rules! bail {"},{"Add":" ($msg:literal $(,)?) => {"},{"Add":" return std::result::Result::Err($crate::anyhow!($msg));"},{"Add":" };"},{"Add":" ($err:expr $(,)?) => {"},{"Add":" return std::result::Result::Err($crate::anyhow!($err));"},{"Add":" };"},{"Add":" ($fmt:expr, $($arg:tt)*) => {"},{"Add":" return std::result::Result::Err($crate::anyhow!($fmt, $($arg)*));"},{"Add":" };"},{"Add":"}"},{"Add":""},{"Add":"/// Return early with an error if a condition is not satisfied."},{"Add":"///"},{"Add":"/// This macro is equivalent to `if !$cond { return Err(From::from($err)); }`."},{"Add":"///"},{"Add":"/// Analogously to `assert!`, `ensure!` takes a condition and exits the function"},{"Add":"/// if the condition fails. Unlike `assert!`, `ensure!` returns an `Error`"},{"Add":"/// rather than panicking."},{"Add":"///"},{"Add":"/// # Example"},{"Add":"///"},{"Add":"/// ```"},{"Add":"/// # use anyhow::{ensure, Result};"},{"Add":"/// #"},{"Add":"/// # fn main() -> Result<()> {"},{"Add":"/// # let user = 0;"},{"Add":"/// #"},{"Add":"/// ensure!(user == 0, \"only user 0 is allowed\");"},{"Add":"/// # Ok(())"},{"Add":"/// # }"},{"Add":"/// ```"},{"Add":"///"},{"Add":"/// ```"},{"Add":"/// # use anyhow::{ensure, Result};"},{"Add":"/// # use std::fmt::{self, Display};"},{"Add":"/// #"},{"Add":"/// # #[derive(Debug)]"},{"Add":"/// # enum ScienceError {"},{"Add":"/// # RecursionLimitExceeded,"},{"Add":"/// # }"},{"Add":"/// #"},{"Add":"/// # impl std::error::Error for ScienceError {}"},{"Add":"/// #"},{"Add":"/// # impl Display for ScienceError {"},{"Add":"/// # fn fmt(&self, formatter: &mut fmt::Formatter) -> fmt::Result {"},{"Add":"/// # unimplemented!()"},{"Add":"/// # }"},{"Add":"/// # }"},{"Add":"/// #"},{"Add":"/// # const MAX_DEPTH: usize = 1;"},{"Add":"/// #"},{"Add":"/// # const IGNORE: &str = stringify! {"},{"Add":"/// #[derive(Error, Debug)]"},{"Add":"/// enum ScienceError {"},{"Add":"/// #[error(display = \"recursion limit exceeded\")]"},{"Add":"/// RecursionLimitExceeded,"},{"Add":"/// ..."},{"Add":"/// }"},{"Add":"/// # };"},{"Add":"///"},{"Add":"/// # fn main() -> Result<()> {"},{"Add":"/// # let depth = 0;"},{"Add":"/// #"},{"Add":"/// ensure!(depth <= MAX_DEPTH, ScienceError::RecursionLimitExceeded);"},{"Add":"/// # Ok(())"},{"Add":"/// # }"},{"Add":"/// ```"},{"Add":"#[macro_export]"},{"Add":"macro_rules! ensure {"},{"Add":" ($cond:expr, $msg:literal $(,)?) => {"},{"Add":" if !$cond {"},{"Add":" return std::result::Result::Err($crate::anyhow!($msg));"},{"Add":" }"},{"Add":" };"},{"Add":" ($cond:expr, $err:expr $(,)?) => {"},{"Add":" if !$cond {"},{"Add":" return std::result::Result::Err($crate::anyhow!($err));"},{"Add":" }"},{"Add":" };"},{"Add":" ($cond:expr, $fmt:expr, $($arg:tt)*) => {"},{"Add":" if !$cond {"},{"Add":" return std::result::Result::Err($crate::anyhow!($fmt, $($arg)*));"},{"Add":" }"},{"Add":" };"},{"Add":"}"},{"Add":""},{"Add":"/// Construct an ad-hoc error from a string."},{"Add":"///"},{"Add":"/// This evaluates to an `Error`. It can take either just a string, or a format"},{"Add":"/// string with arguments. It also can take any custom type which implements"},{"Add":"/// `Debug` and `Display`."},{"Add":"///"},{"Add":"/// # Example"},{"Add":"///"},{"Add":"/// ```"},{"Add":"/// # type V = ();"},{"Add":"/// #"},{"Add":"/// use anyhow::{anyhow, Result};"},{"Add":"///"},{"Add":"/// fn lookup(key: &str) -> Result {"},{"Add":"/// if key.len() != 16 {"},{"Add":"/// return Err(anyhow!(\"key length must be 16 characters, got {:?}\", key));"},{"Add":"/// }"},{"Add":"///"},{"Add":"/// // ..."},{"Add":"/// # Ok(())"},{"Add":"/// }"},{"Add":"/// ```"},{"Add":"#[macro_export]"},{"Add":"macro_rules! anyhow {"},{"Add":" ($msg:literal $(,)?) => {"},{"Add":" // Handle $:literal as a special case to make cargo-expanded code more"},{"Add":" // concise in the common case."},{"Add":" $crate::private::new_adhoc($msg)"},{"Add":" };"},{"Add":" ($err:expr $(,)?) => ({"},{"Add":" #[allow(unused_imports)]"},{"Add":" use $crate::private::{AdhocKind, TraitKind};"},{"Add":" let error = $err;"},{"Add":" (&error).anyhow_kind().new(error)"},{"Add":" });"},{"Add":" ($fmt:expr, $($arg:tt)*) => {"},{"Add":" $crate::private::new_adhoc(format!($fmt, $($arg)*))"},{"Add":" };"},{"Add":"}"}]}}],"owner":"yaahc","repo":"eyre","token":"aaMnIm7ycckGkiO59YCHhKCAubAQG+XLPp0nH0JDQqk=","login":null}

…

Dependencies

Change contents