# Locusts: A universal library

[![BEAM](https://github.com/locusts-r-us/locusts/actions/workflows/beam.yml/badge.svg)](https://github.com/locusts-r-us/locusts/actions/workflows/beam.yml)
[![C](https://github.com/locusts-r-us/locusts/actions/workflows/c.yml/badge.svg)](https://github.com/locusts-r-us/locusts/actions/workflows/c.yml)
[![Docker](https://github.com/locusts-r-us/locusts/actions/workflows/docker.yml/badge.svg)](https://github.com/locusts-r-us/locusts/actions/workflows/docker.yml)
[![.NET](https://github.com/locusts-r-us/locusts/actions/workflows/dotnet.yml/badge.svg)](https://github.com/locusts-r-us/locusts/actions/workflows/dotnet.yml)
[![JVM](https://github.com/locusts-r-us/locusts/actions/workflows/jvm.yml/badge.svg)](https://github.com/locusts-r-us/locusts/actions/workflows/jvm.yml)
[![Go](https://github.com/locusts-r-us/locusts/actions/workflows/go.yml/badge.svg)](https://github.com/locusts-r-us/locusts/actions/workflows/go.yml)
[![Node.js](https://github.com/locusts-r-us/locusts/actions/workflows/node.yml/badge.svg)](https://github.com/locusts-r-us/locusts/actions/workflows/node.yml)
[![Python](https://github.com/locusts-r-us/locusts/actions/workflows/python.yml/badge.svg)](https://github.com/locusts-r-us/locusts/actions/workflows/python.yml)
[![Rust](https://github.com/locusts-r-us/locusts/actions/workflows/rust.yml/badge.svg)](https://github.com/locusts-r-us/locusts/actions/workflows/rust.yml)


We here at Locusts-R-Us have developed a series of libraries for all sorts of programming languages to introduce locusts in all sorts of codebases.

## FAQ

### Why the name `Locusts`?

[![XKCD 797 "debian-main"](https://imgs.xkcd.com/comics/debian_main.png "dpkg: error processing package (--purge): subprocess pre-removal script returned error exit 163: OH_GOD_THEYRE_INSIDE_MY_CLOTHES")](https://xkcd.com/797/)

### Why would you do this?

It's funny.

### Do any of these libraries serve any purpose?

No.

### How do I add these to my projects?

See the documentation below.

### Can I contribute?

Yes! Please do! We welcome all contributions.
See the [CONTRIBUTING.md](./CONTRIBUTING.md) file for more information.

## Currently Supported Languages

- [C/C++](./docs/C.md)
- [Go](./docs/Go.md)
- [Rust](./docs/Rust.md)
- [Python](./docs/Python.md)
- [C#/F#](./docs/.NET.md)
- [JavaScript/TypeScript](./docs/JavaScript.md)
- [BEAM](./docs/BEAM.md)
- [JVM](./docs/JVM.md)

### Not a language but still supported

- [Docker](./docs/Docker.md)

## License

Every locust library in this repository is licensed under the [BSD 0 Clause License](./LICENSE).