txt: ## dist_zef-raku-community-modules-Die.md
  [![Actions Status](https://github.com/raku-community-modules/Die/workflows/test/badge.svg)](https://github.com/raku-community-modules/Die/actions)
  
  # NAME
  
  Die - Perl like die routine for note + exit
  
  # SYNOPSIS
  
  ```
  use Die;
  
  die "I don't like you, bruh\n"; # new line at the end == no stack trace
  die "something looks broken";   # no new line at end == stack trace
  die X::SomeShinyException.new;  # this still works like normal
  
  ```
  
  # DESCRIPTION
  
  Raku avoids many magics prevalent in Perl land, among which is automatically omitting the stack trace if the `&die` routine is given a string with a new line at the end.
  
  In Raku, you do the same with `note "foo" and exit 1`... or use this shiny module that adds Perl behaviour to `&die`
  
  # EXPORTS
  
  -head2 &die
  
  ```
  die "I don't like you, bruh\n"; # new line at the end == no stack trace
  die "something looks broken";   # no new line at end == full stack trace
  die X::SomeShinyException.new;  # this still works like normal
  
  ```
  
  Works just like core `&die` except stack trace will be omitted if you include a newline at the end of the die message.
  
  Note that Perl's `&die` exits with status `255`, while core Raku `&die` and this module's `&die` exit with status `1`.
  
  # AUTHOR
  
  Zoffix Znet
  
  Source can be located at: <https://github.com/raku-community-modules/Die> . Comments and Pull Requests are welcome.
  
  # COPYRIGHT AND LICENSE
  
  Copyright 2017, 2018 Zoffix Znet, 2021- Raku Community
  
  This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.
  