Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/zunit-zsh/zunit

A powerful testing framework for ZSH projects
https://github.com/zunit-zsh/zunit

assertions ci developer-tools tap test-automation test-framework test-runner testing testing-tools unit-testing zsh

Last synced: about 1 month ago
JSON representation

A powerful testing framework for ZSH projects

Host: GitHub
URL: https://github.com/zunit-zsh/zunit
Owner: zunit-zsh
License: mit
Created: 2016-09-05T21:10:23.000Z (over 7 years ago)
Default Branch: master
Last Pushed: 2023-08-14T19:45:33.000Z (9 months ago)
Last Synced: 2024-04-08T04:05:25.574Z (about 2 months ago)
Topics: assertions, ci, developer-tools, tap, test-automation, test-framework, test-runner, testing, testing-tools, unit-testing, zsh
Language: Shell
Homepage: https://zunit.xyz
Size: 238 KB
Stars: 197
Watchers: 6
Forks: 22
Open Issues: 18
Metadata Files:
- Readme: README.md
- Contributing: contributing.md
- License: LICENSE
- Code of conduct: code-of-conduct.md

Lists

awesome-shell - zunit - A powerful unit testing framework for ZSH (Shell Script Development / Directory Navigation)
awesome-zsh-plugins - zunit - A powerful unit testing framework for ZSH. (Other Resources / ZSH Tools)
awesome-github-repos - zunit-zsh/zunit - A powerful testing framework for ZSH projects (Shell)
awesome-shell - zunit - A powerful unit testing framework for ZSH (Shell Script Development / Directory Navigation)
fucking-awesome-zsh-plugins - zunit - A powerful unit testing framework for ZSH. (Other Resources / ZSH Tools)
awesome-shell - zunit - A powerful unit testing framework for ZSH (Shell Script Development)
awesome-zsh-plugins - zunit - A powerful unit testing framework for ZSH (Other Resources / ZSH Tools)
awesome-zsh-plugins - zunit - A powerful unit testing framework for ZSH. (Other Resources / ZSH Tools)
awesome-stars - zunit-zsh/zunit - A powerful testing framework for ZSH projects (zsh)

README

        ![ZUnit](https://zunit.xyz/img/logo.png)

[![GitHub release](https://img.shields.io/github/release/zunit-zsh/zunit.svg)](https://github.com/zunit-zsh/zunit/releases/latest) [![Build Status](https://travis-ci.org/zunit-zsh/zunit.svg?branch=master)](https://travis-ci.org/zunit-zsh/zunit) [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/zunit-zsh/zunit?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

ZUnit is a powerful unit testing framework for ZSH

## Installation

> **WARNING**: Although the majority of ZUnit's functionality works as expected, it is in the early stages of development, and as such bugs are likely to be present. Please continue with caution, and [report any issues](https://github.com/zunit-zsh/zunit/issues/new) you may have.

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

```sh

zulu install zunit

```

> **NOTE:** In versions of Zulu prior to `1.2.0`, there is an additional step required after install:

  ```sh

  cd ~/.zulu/packages/zunit

  ./build.zsh

  zulu link zunit

  ```

  

### [zplug](https://github.com/zplug/zplug)

ZUnit and its dependencies can all be installed with zplug.

```sh

zplug 'molovo/revolver', \

  as:command, \

  use:revolver

zplug 'zunit-zsh/zunit', \

  as:command, \

  use:zunit, \

  hook-build:'./build.zsh'

```

### Homebrew

```sh

brew install zunit-zsh/zunit/zunit

```

### Manual

```sh

git clone https://github.com/zunit-zsh/zunit

cd ./zunit

./build.zsh

chmod u+x ./zunit

cp ./zunit /usr/local/bin

```

> ZUnit requires [Revolver](https://github.com/molovo/revolver) to be installed, and in your `$PATH`. The zulu or homebrew installation methods will install this dependency for you.

## Writing Tests

### Test syntax

Tests in ZUnit have a simple syntax, which is inspired by the [BATS](https://github.com/sstephenson/bats) framework.

```sh

#!/usr/bin/env zunit

@test 'My first test' {

	# Test contents here

}

```

The body of each test can contain any valid ZSH code. The zunit shebang `#!/usr/bin/env zunit` **MUST** appear at the top of each test file, or ZUnit will not run it.

## Documentation

For a full breakdown of ZUnit's syntax and functionality, check out the [official documentation](https://zunit.xyz/docs/).

## Contributing

All contributions are welcome, and encouraged. Please read our [contribution guidelines](contributing.md) and [code of conduct](code-of-conduct.md) for more information.

## License

Copyright (c) 2016 James Dinsdale  (molovo.co)

ZUnit is licensed under The MIT License (MIT)

## Team

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