KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

crash

★ 69 Open GitHub ↗

Proper error handling, exceptions and try/catch for ZSH

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Crash

[![Build Status](https://travis-ci.org/molovo/crash.svg?branch=master)](https://travis-ci.org/molovo/crash)
[![Join the chat at https://gitter.im/molovo/crash](https://badges.gitter.im/molovo/crash.svg)](https://gitter.im/molovo/crash?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

Proper error handling, exceptions and try/catch for ZSH.

![Crash Screenshot](https://raw.githubusercontent.com/molovo/crash/master/screenshots/screenshot.png)

## Installation

### [zulu](https://github.com/zulu-zsh/zulu)

```sh
zulu install crash
```

### Manual

```sh
git clone https://github.com/molovo/crash crash
cp crash/crash /usr/local/share/zsh/site-functions # Or anywhere else in $fpath
```

## Usage

### Set up the global error handler

Crash comes with a global error handler, which prints a readable error and stack trace both for user-created exceptions and traditional shell exit codes.

```sh
autoload -Uz crash && crash register

throw TestException 'This is a test' # Will cause the error handler to be displayed
```

### Try/catch

Crash comes with the functions `try`, `catch` and `throw`, allowing you to handle exceptions much as you would in a 'proper' programming language.

```sh
autoload -Uz crash && crash register

# The function we're going to call
function do_something() {
  echo 'Start to do something...'
  throw RainbowException 'Unicorns!'
  echo 'This message will never be displayed'
}

# A function to handle any caught exceptions
function error_handler() {
  local exception="$1" message="${(@)@:2}"

echo $exception # RainbowException
  echo $message   # Unicorns!
}

try do_something
catch RainbowException error_handler
```

## License

Crash is licensed under The MIT License (MIT)

## Team

* [James Dinsdale](http://molovo.co)

crash

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README