# Contributing to [AsyncNinja](https://github.com/AsyncNinja/AsyncNinja)


##👍 🎉
**Thank you for considering contributing to [AsyncNinja](https://github.com/AsyncNinja/AsyncNinja). You are very welcomed to make all kinds of contributions.**

## How to contribute?

### Report a bug

* [report a GitHub issue](https://github.com/AsyncNinja/AsyncNinja/issues/new)
* [write an email to asyncninja@gmail.com](mailto:asyncninja@gmail.com?subject=[Issue])
* make a pull request that either exposes or fixes bug

### Make a suggest a feature or share an idea

* [write it in a GitHub issue](https://github.com/AsyncNinja/AsyncNinja/issues/new)
* [contact via Gitter.im](https://gitter.im/AsyncNinja/Lobby)
* [write an email to asyncninja@gmail.com](mailto:asyncninja@gmail.com?subject=[Suggestion])

### Ask question, clarification request, documentation request 

* [ask it in a GitHub issue](https://github.com/AsyncNinja/AsyncNinja/issues/new)
* [contact via Gitter.im](https://gitter.im/AsyncNinja/Lobby)
* [ask via email to asyncninja@gmail.com](mailto:asyncninja@gmail.com?subject=[Clarification_Request])

### Anything else?

Just [file a GitHub issue](https://github.com/AsyncNinja/AsyncNinja/issues/new) or [write an email to asyncninja@gmail.com](mailto:asyncninja@gmail.com)

## Running tests locally

There are 2 options:

#### Running tests with Swift Package Manager

*for Linux and macOS*

Make sure that your swift toolchain is properly set

```shell
swift test
```

#### Running tests with Xcode
*for macOS*

1. open AsyncNinja.xcodeproj with Xcode
2. select device target: iOS simulator, tvOS simulator, macOS (watchOS simulator does not support unit tests 😭)
3. run tests (CMD+U) on AsyncNinja target

## Am I missing something?

Just [file a GitHub issue](https://github.com/AsyncNinja/AsyncNinja/issues/new) or [write an email to asyncninja@gmail.com](mailto:asyncninja@gmail.com)