5 releases (2 stable)
1.1.0 | Jan 17, 2021 |
---|---|
1.0.0 | Jan 17, 2021 |
0.0.3 | Oct 3, 2020 |
0.0.2 | Oct 3, 2020 |
0.0.1 | Oct 3, 2020 |
#23 in #exit
25 downloads per month
Used in brainf
14KB
114 lines
The idioma
Library
As Rust developers we deeply care about safety and error handling - our programs are fast and reliable. However, users never make it easy for us: they misunderstand instructions and break things. When we catch them doing something they shouldn't be doing, we let them know (usually) with an error message.
Every command line tool prints handy messages to stdout
from time to time, and
to do so, requires a function or two. I noticed that whenever I start a new
project I tend to copy the util.rs
that contains those display functions from
my last project. That is simply no good.
It means that my error messages
- differ in style (since I regularly alter code in that util file);
- don't look like idiomatic Rust messages;
- require that
copy + paste
operation for every new project.
And I strongly believe that I am not alone in this. Take a look at this code by brain-lang:
macro_rules! exit_with_error(
($($arg:tt)*) => { {
use std::process;
eprintln!($($arg)*);
process::exit(1);
} }
);
As you can see, they wrote this macro right next to the main
function and it
is the same problem that I have with my util file. The idioma
library solves
all these issues forever. Here's how.
Use me, baby!
In your Cargo.toml
file.
[dependencies]
idioma = "*"
Include in any Rust file.
extern crate idioma;
Use within a function.
fn foo(i: i32) {
if i != 42 {
error("Your taste is appalling.").exit(1);
}
}
Development
You are more than welcome to contribute to this library. Same as always:
- Fork;
- Change;
- Pull Request.
I will do my best to review requests as soon as possible. If you write a new function or something, make sure to include doc comments with some of that spicy humour!
To see what's already there, visit docs.rs where you can see full documentation with links to source code.
License
I don't know why, but this code is licensed under the MIT license which means the following:
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
I know that it's cringe, but I really made it with ❤️ so 😘 bye-bye.
Dependencies
~0–10MB
~53K SLoC