locusts 0.0.1

data/.standard.yml

@@ -0,0 +1,3 @@
+# For available configuration options, see:
+#   https://github.com/standardrb/standard
+ruby_version: 3.0

data/.syncpackrc

@@ -0,0 +1,14 @@
+{
+  "versionGroups": [
+    {
+      "label": "Use workspace protocol when developing local packages",
+      "dependencies": [
+        "$LOCAL"
+      ],
+      "dependencyTypes": [
+        "dev"
+      ],
+      "pinVersion": "workspace:*"
+    }
+  ]
+}

data/.vscode/settings.json

@@ -0,0 +1,19 @@
+{
+  "python.testing.unittestArgs": [
+    "-v",
+    "-s",
+    "./src",
+    "-p",
+    "test_*.py"
+  ],
+  "python.testing.pytestEnabled": false,
+  "python.testing.unittestEnabled": true,
+  "eslint.workingDirectories": [
+    {
+      "mode": "auto"
+    }
+  ],
+  "java.compile.nullAnalysis.mode": "automatic",
+  "C_Cpp.default.compileCommands": "/home/user/src/github.com/locusts/builddir/compile_commands.json",
+  "C_Cpp.default.configurationProvider": "mesonbuild.mesonbuild"
+}

data/CMakeLists.txt

@@ -0,0 +1,41 @@
+cmake_minimum_required(VERSION 3.14)
+project(libocusts VERSION 0.0.0 DESCRIPTION "A C library that introduces locusts into your codebase" LANGUAGES C)
+
+include(GNUInstallDirs)
+
+add_library(objlib OBJECT src/locusts.c)
+target_include_directories(objlib PUBLIC include)
+set_target_properties(objlib PROPERTIES LINKER_LANGUAGE C)
+
+add_library(ocusts SHARED $<TARGET_OBJECTS:objlib> include/locusts.h)
+target_link_libraries(ocusts PUBLIC objlib)
+set_target_properties(ocusts PROPERTIES VERSION ${PROJECT_VERSION} SOVERSION ${PROJECT_VERSION_MAJOR})
+set_target_properties(ocusts PROPERTIES PUBLIC_HEADER include/locusts.h)
+
+add_library(ocusts_static STATIC $<TARGET_OBJECTS:objlib> include/locusts.h)
+target_link_libraries(ocusts_static PUBLIC objlib)
+set_target_properties(ocusts_static PROPERTIES VERSION ${PROJECT_VERSION} SOVERSION ${PROJECT_VERSION_MAJOR})
+set_target_properties(ocusts_static PROPERTIES OUTPUT_NAME ocusts)
+
+# Make autoconf and cmake agree with each other
+set(prefix ${CMAKE_INSTALL_PREFIX})
+set(libdir \${prefix}/${CMAKE_INSTALL_LIBDIR})
+set(includedir \${prefix}/${CMAKE_INSTALL_INCLUDEDIR})
+set(VERSION ${PROJECT_VERSION})
+configure_file(${CMAKE_CURRENT_SOURCE_DIR}/ocusts.pc.in ${CMAKE_CURRENT_BINARY_DIR}/ocusts.pc @ONLY)
+install(
+	FILES ${CMAKE_CURRENT_BINARY_DIR}/ocusts.pc DESTINATION ${CMAKE_INSTALL_LIBDIR}/pkgconfig
+)
+install(
+	TARGETS ocusts ocusts_static
+	LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
+	ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR}
+	PUBLIC_HEADER DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}
+)
+
+add_executable(test_locusts tests/test_locusts.c)
+target_link_libraries(test_locusts PRIVATE ocusts)
+
+enable_testing()
+
+add_test(NAME test_locusts COMMAND test_locusts)

data/CONTRIBUTING.md

@@ -0,0 +1,35 @@
+# Contributing
+
+First off, thanks for taking the time to contribute! 🎉
+We welcome all sorts of contributions, from bug reports to feature requests to code contributions.
+
+## How to contribute
+
+The main ways to can contribute are:
+
+- [Requesting a new language](#requesting-a-new-language)
+- [Adding a new language](#adding-a-new-language)
+
+### Requesting a new language
+
+If you'd like to request a new language to be added to the repository, please open an issue with the `new language` label.
+Please include the following information:
+
+- The name of the language
+- A brief description of the language
+- The language's website, if any exist
+- Any relevant documentation on how to build, test, and publish libraries in the language
+- Any CI information
+- Any other relevant information
+
+### Adding a new language
+
+If you'd like to add a new language to the repository, please follow these guidelines:
+
+- The language **MUST** have some way of publishing and consuming libraries (ie. a package manager).
+- Your PR **MUST** include a GitHub Actions pipeline to build, run tests, and potentially publish the library to the library location.
+  - See any of the existing language workflows for examples.
+- Your PR **MUST** include a `LANGUAGE`.md file in the `docs` directory with the following information:
+  - A basic way to add the library as a dependency
+  - An example of how to use the library
+  - A link on the README.md to the new language documentation

data/Cargo.lock

@@ -0,0 +1,7 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 3
+
+[[package]]
+name = "locusts"
+version = "0.0.0"

data/Cargo.toml

@@ -0,0 +1,11 @@
+[package]
+name = "locusts"
+version = "0.0.0"
+description = "A Rust library that introduces locusts into your codebase"
+authors = ["Matt Strapp <matt+locusts@mattstrapp.net>"]
+readme = "docs/Rust.md"
+license = "0BSD"
+edition = "2015"
+repository = "https://github.com/locusts-r-us/locusts"
+
+[dependencies]

data/Dockerfile

@@ -0,0 +1,15 @@
+FROM --platform=$BUILDPLATFORM tinygo/tinygo:0.33.0 AS build
+ARG TARGETOS
+ARG TARGETARCH
+WORKDIR /app
+COPY . .
+RUN CGO_ENABLED=0 GOOS=${TARGETOS} GOARCH=${TARGETARCH} GOFLAGS=-buildvcs=false tinygo build -o locusts ./include
+
+FROM scratch
+LABEL org.opencontainers.image.licenses=0BSD
+LABEL org.opencontainers.image.source=https://github.com/locusts-r-us/locusts
+LABEL org.opencontainers.image.title=Locusts
+LABEL org.opencontainers.image.description="A container that contains locusts"
+HEALTHCHECK NONE
+COPY --from=build /app/locusts /
+ENTRYPOINT ["/locusts"]

data/GNUmakefile.am

@@ -0,0 +1,11 @@
+lib_LTLIBRARIES = libocusts.la
+libocusts_la_LDFLAGS = -version-info 1:0:0
+libocusts_la_SOURCES = include/locusts.h
+lib_LIBRARIES = libocusts.a
+libocusts_a_SOURCES = include/locusts.h
+include_HEADERS = include/locusts.h
+
+
+install-data-local:
+	mkdir -p $(libdir)/pkgconfig
+	cp ocusts.pc $(libdir)/pkgconfig/ocusts.pc

data/LICENSE

@@ -0,0 +1,12 @@
+Copyright (c) 2024 Matt Strapp <matt+locusts@mattstrapp.net>
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

data/Locusts.sln

@@ -0,0 +1,28 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.0.31903.59
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Locusts", "src\Locusts.csproj", "{D673881C-7095-4652-AFB5-AD51F4AA075B}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Locusts.Testing", "tests\Locusts.Testing.csproj", "{863697BA-0B39-4949-95E4-B6BE770A81F7}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{D673881C-7095-4652-AFB5-AD51F4AA075B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{D673881C-7095-4652-AFB5-AD51F4AA075B}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{D673881C-7095-4652-AFB5-AD51F4AA075B}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{D673881C-7095-4652-AFB5-AD51F4AA075B}.Release|Any CPU.Build.0 = Release|Any CPU
+		{863697BA-0B39-4949-95E4-B6BE770A81F7}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{863697BA-0B39-4949-95E4-B6BE770A81F7}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{863697BA-0B39-4949-95E4-B6BE770A81F7}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{863697BA-0B39-4949-95E4-B6BE770A81F7}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+EndGlobal

data/README.md

@@ -0,0 +1,69 @@
+# Locusts: A universal library
+
+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.
+
+## CI
+
+[![BEAM](https://img.shields.io/github/actions/workflow/status/locusts-r-us/locusts/beam.yml?style=for-the-badge&logo=erlang&label=Erlang%2FElixir%2FGleam%20(BEAM))](https://github.com/locusts-r-us/locusts/actions/workflows/beam.yml)
+[![C/C++](https://img.shields.io/github/actions/workflow/status/locusts-r-us/locusts/c.yml?style=for-the-badge&logo=c&label=C%2FC%2B%2B)](https://github.com/locusts-r-us/locusts/actions/workflows/c.yml)
+[![Deno](https://img.shields.io/github/actions/workflow/status/locusts-r-us/locusts/deno.yml?style=for-the-badge&logo=deno&label=Deno)](https://github.com/locusts-r-us/locusts/actions/workflows/deno.yml)
+[![Docker](https://img.shields.io/github/actions/workflow/status/locusts-r-us/locusts/docker.yml?style=for-the-badge&logo=docker&label=Docker)](https://github.com/locusts-r-us/locusts/actions/workflows/docker.yml)
+[![.NET](https://img.shields.io/github/actions/workflow/status/locusts-r-us/locusts/dotnet.yml?style=for-the-badge&logo=dotnet&label=C%23%2FF%23)](https://github.com/locusts-r-us/locusts/actions/workflows/dotnet.yml)
+[![JVM](https://img.shields.io/github/actions/workflow/status/locusts-r-us/locusts/jvm.yml?style=for-the-badge&logo=kotlin&label=Java%2FKotlin%2FGroovy%20(JVM))](https://github.com/locusts-r-us/locusts/actions/workflows/jvm.yml)
+[![Go](https://img.shields.io/github/actions/workflow/status/locusts-r-us/locusts/go.yml?style=for-the-badge&logo=go&label=Go)](https://github.com/locusts-r-us/locusts/actions/workflows/go.yml)
+[![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/locusts-r-us/locusts/node.yml?style=for-the-badge&logo=nodedotjs&label=Node.JS)](https://github.com/locusts-r-us/locusts/actions/workflows/node.yml)
+[![Python](https://img.shields.io/github/actions/workflow/status/locusts-r-us/locusts/python.yml?style=for-the-badge&logo=python&label=Python)](https://github.com/locusts-r-us/locusts/actions/workflows/python.yml)
+[![Rust](https://img.shields.io/github/actions/workflow/status/locusts-r-us/locusts/rust.yml?style=for-the-badge&logo=rust&label=Rust)](https://github.com/locusts-r-us/locusts/actions/workflows/rust.yml)
+
+## Packages
+
+[![Crates.io Version](https://img.shields.io/crates/v/locusts?style=for-the-badge&logo=rust&color=%23f74b00)](https://crates.io/crates/locusts)
+[![go.mod Version](https://img.shields.io/github/go-mod/go-version/locusts-r-us/locusts?style=for-the-badge&logo=go&color=%2300ADD8)](https://pkg.go.dev/github.com/locusts-r-us/locusts)
+[![Hex.pm Version](https://img.shields.io/hexpm/v/locusts?style=for-the-badge&logo=elixir&color=%234B275F)](https://hex.pm/packages/locusts)
+[![JSR Version](https://img.shields.io/jsr/v/%40locusts-r-us/locusts?style=for-the-badge&logo=jsr&color=%23F7DF1E)](https://jsr.io/@locusts-r-us/locusts)
+[![Maven Central Version](https://img.shields.io/maven-central/v/io.github.locusts-r-us/locusts?style=for-the-badge&logo=apachemaven&color=%23C71A36)](https://github.com/locusts-r-us/locusts/issues/32)
+[![npm Version](https://img.shields.io/npm/v/locusts?style=for-the-badge&logo=npm&color=%23cb3837)](https://www.npmjs.com/package/locusts)
+[![NuGet Version](https://img.shields.io/nuget/v/locusts?style=for-the-badge&logo=nuget&color=%23004880)](https://www.nuget.org/packages/locusts)
+[![PyPI Version](https://img.shields.io/pypi/v/locusts-r-us?style=for-the-badge&logo=pypi&label=pypi&color=%233775A9)](https://pypi.org/project/locusts-r-us/)
+
+## 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).

data/Rakefile

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create(:test) do |t|
+  t.libs << "tests"
+  t.libs << "src"
+  t.warning = false
+  t.test_globs = ["tests/**/test_*.rb"]
+end
+
+require "standard/rake"
+
+task default: %i[test standard]

data/build.gradle.kts

@@ -0,0 +1,99 @@
+/*
+ * This file was generated by the Gradle 'init' task.
+ *
+ * This generated file contains a sample Kotlin library project to get you started.
+ * For more details on building Java & JVM projects, please refer to https://docs.gradle.org/8.10.2/userguide/building_java_projects.html in the Gradle documentation.
+ * This project uses @Incubating APIs which are subject to change.
+ */
+
+plugins {
+    // Apply the org.jetbrains.kotlin.jvm Plugin to add support for Kotlin.
+    alias(libs.plugins.kotlin.jvm)
+
+    // Apply the java-library plugin for API and implementation separation.
+    `java-library`
+    id("maven-publish")
+    id("net.researchgate.release") version "3.0.2"
+}
+
+repositories {
+    // Use Maven Central for resolving dependencies.
+    mavenCentral()
+}
+
+dependencies {
+}
+
+testing {
+    suites {
+        // Configure the built-in test suite
+        val test by getting(JvmTestSuite::class) {
+            // Use Kotlin Test test framework
+            useKotlinTest("2.0.0")
+        }
+    }
+}
+
+// Apply a specific Java toolchain to ease working on different environments.
+java {
+    toolchain {
+        languageVersion = JavaLanguageVersion.of(11)
+    }
+}
+
+publishing {
+    publications {
+        create<MavenPublication>("maven") {
+            from(components["java"])
+            groupId = "io.github.locusts-r-us"
+            artifactId = "locusts"
+            version = "$version"
+            pom {
+                name = "Locusts"
+                description = "A JVM library that introduces locusts into your codebase."
+                licenses {
+                    license {
+                        name = "Zero-Clause BSD"
+                        url = "https://spdx.org/licenses/0BSD.html"
+                    }
+                }
+                developers {
+                    developer {
+                        id = "rosstheross"
+                        name = "Matt Strapp"
+                        email = "matt@mattstrapp.net"
+                    }
+                }
+                scm {
+                    connection = "scm:git:https://github.com/locusts-r-us/locusts.git"
+                    developerConnection = "scm:git:ssh://github.com/locusts-r-us/locusts.git"
+                    url = "https://github.com/locusts-r-us/locusts"
+                }
+            }
+        }
+    }
+    repositories {
+        maven {
+            name = "GitHubPackages"
+            url = uri("https://maven.pkg.github.com/locusts-r-us/locusts")
+            credentials {
+                username = System.getenv("GITHUB_ACTOR")
+                password = System.getenv("GITHUB_TOKEN")
+            }
+        }
+        maven {
+            name = "OSSRH"
+            url = uri("https://oss.sonatype.org/service/local/staging/deploy/maven2/")
+            credentials {
+                username = System.getenv("MAVEN_USERNAME")
+                password = System.getenv("MAVEN_PASSWORD")
+            }
+        }
+    }
+}
+
+release {
+    git {
+        requireBranch = "master"
+    }
+}

data/configure.ac

@@ -0,0 +1,10 @@
+AC_INIT([libocusts], [0.0.0])
+AC_CONFIG_SRCDIR([src/locusts.c])
+AC_CONFIG_MACRO_DIRS([m4])
+AM_INIT_AUTOMAKE([-Wall -Werror foreign])
+AC_PROG_CC
+AM_PROG_AR
+LT_INIT
+
+AC_CONFIG_FILES([GNUmakefile ocusts.pc])
+AC_OUTPUT

data/contrib/tag-repo

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+
+if [ -z "$GIT_TAG" ]; then
+  echo "GIT_TAG is not set, pulling from changeset"
+  GIT_TAG=$(jq -r '.version' src/packages/locusts/package.json)
+fi
+
+git tag v"$GIT_TAG"

data/contrib/version-bump

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+
+if [ -z "$GIT_TAG" ]; then
+  echo "GIT_TAG is not set, pulling from changeset"
+  GIT_TAG=$(jq -r '.version' src/packages/locusts/package.json)
+fi
+
+OLD_TAG=$(jq -r '.version' package.json)
+echo "Bumping version from $OLD_TAG to $GIT_TAG"
+
+rg "$OLD_TAG" --files-with-matches --iglob \!\*lock\* --iglob \!go.mod --iglob \!deno.json --iglob \!package.json --iglob \!\*.md "$(pwd)" | xargs sed -i "s/$OLD_TAG/$GIT_TAG/g"
+
+# fiddle with autotools
+AUTOTOOLS_TAG=${GIT_TAG//\./:}
+OLD_TAG=${OLD_TAG//\./:}
+
+sed -i "s/$GIT_TAG/$AUTOTOOLS_TAG/g" GNUmakefile.am
+
+# remove the snapshot from gradle
+sed -i "s/-SNAPSHOT//g" gradle.properties
+
+# bump the main package.json too
+jq ".version = \"$GIT_TAG\"" package.json | sponge package.json

data/deno.json

@@ -0,0 +1,5 @@
+{
+  "workspace": [
+    "./src/packages/locusts"
+  ]
+}

data/deno.lock

@@ -0,0 +1,71 @@
+{
+  "version": "3",
+  "packages": {
+    "specifiers": {
+      "jsr:@std/assert@^1.0.6": "jsr:@std/assert@1.0.6",
+      "jsr:@std/expect": "jsr:@std/expect@1.0.6",
+      "jsr:@std/internal@^1.0.4": "jsr:@std/internal@1.0.4",
+      "jsr:@std/testing": "jsr:@std/testing@1.0.3",
+      "npm:@types/node": "npm:@types/node@18.16.19"
+    },
+    "jsr": {
+      "@std/assert@1.0.6": {
+        "integrity": "1904c05806a25d94fe791d6d883b685c9e2dcd60e4f9fc30f4fc5cf010c72207",
+        "dependencies": [
+          "jsr:@std/internal@^1.0.4"
+        ]
+      },
+      "@std/expect@1.0.6": {
+        "integrity": "dffba969ca5ea6d7c39338d4985c9af2bfa6e080c710cc2b77756dd7657c369c",
+        "dependencies": [
+          "jsr:@std/assert@^1.0.6",
+          "jsr:@std/internal@^1.0.4"
+        ]
+      },
+      "@std/internal@1.0.4": {
+        "integrity": "62e8e4911527e5e4f307741a795c0b0a9e6958d0b3790716ae71ce085f755422"
+      },
+      "@std/testing@1.0.3": {
+        "integrity": "f98c2bee53860a5916727d7e7d3abe920dd6f9edace022e2d059f00d05c2cf42",
+        "dependencies": [
+          "jsr:@std/assert@^1.0.6",
+          "jsr:@std/internal@^1.0.4"
+        ]
+      }
+    },
+    "npm": {
+      "@types/node@18.16.19": {
+        "integrity": "sha512-IXl7o+R9iti9eBW4Wg2hx1xQDig183jj7YLn8F7udNceyfkbn1ZxmzZXuak20gR40D7pIkIY1kYGx5VIGbaHKA==",
+        "dependencies": {}
+      }
+    }
+  },
+  "remote": {},
+  "workspace": {
+    "packageJson": {
+      "dependencies": [
+        "npm:prettier@^3.2.5",
+        "npm:syncpack@13.0.0",
+        "npm:turbo@^2.2.3",
+        "npm:typescript@^5.6.3"
+      ]
+    },
+    "members": {
+      "src/packages/locusts": {
+        "dependencies": [
+          "jsr:@std/expect@1",
+          "jsr:@std/testing@1",
+          "npm:locusts"
+        ],
+        "packageJson": {
+          "dependencies": [
+            "npm:@types/node@^22.8.2",
+            "npm:tsup@^8.3.5",
+            "npm:tsx@^4.19.2",
+            "npm:typescript@^5.6.3"
+          ]
+        }
+      }
+    }
+  }
+}

data/docs/.NET.md

@@ -0,0 +1,29 @@
+# Locusts
+
+[![CI](https://github.com/locusts-r-us/locusts/actions/workflows/dotnet.yml/badge.svg)](https://github.com/locusts-r-us/locusts/actions/workflows/dotnet.yml)
+![NuGet Version](https://img.shields.io/nuget/v/locusts?logo=nuget&label=NuGet%20Package)
+
+## Description
+
+Locusts is a library that provides a way to introduce locusts into your code.
+
+Why would you want to do that? I don't know.
+
+## Installation
+
+```sh
+dotnet add package Locusts
+```
+
+## Example
+
+```cs
+using Locusts;
+
+Locusts.Introduce();
+// Locusts are now in your codebase!
+```
+
+## License
+
+This project is licensed under the BSD Zero Clause License. See the [LICENSE](../LICENSE) file for details.

data/docs/BEAM.md

@@ -0,0 +1,25 @@
+# Locusts
+
+[![CI](https://github.com/locusts-r-us/locusts/actions/workflows/beam.yml/badge.svg)](https://github.com/locusts-r-us/locusts/actions/workflows/beam.yml)
+![Hex.pm Version](https://img.shields.io/hexpm/v/locusts?logo=erlang)
+![Docs](https://img.shields.io/badge/docs-hexdocs.pm-blue?logo=elixir)
+
+
+**TODO: Add description**
+
+## Installation
+
+If [available in Hex](https://hex.pm/docs/publish), the package can be installed
+by adding `locusts` to your list of dependencies in `mix.exs`:
+
+```elixir
+def deps do
+  [
+    {:locusts, ">= 0.0.0"}
+  ]
+end
+```
+
+Documentation can be generated with [ExDoc](https://github.com/elixir-lang/ex_doc)
+and published on [HexDocs](https://hexdocs.pm). Once published, the docs can
+be found at <https://hexdocs.pm/locusts>.

data/docs/C.md

@@ -0,0 +1,51 @@
+# liboCusts
+
+[![CI](https://github.com/locusts-r-us/locusts/actions/workflows/c.yml/badge.svg)](https://github.com/locusts-r-us/locusts/actions/workflows/c.yml)
+
+## Description
+
+liboCusts is a library that provides a way to introduce locusts into your code.
+
+Why would you want to do that? I don't know.
+
+## Example
+
+```c
+#include "locusts.h"
+
+int main(void) {
+ introduce_locusts();
+ /* Locusts are now in your codebase! */
+ return 0;
+}
+```
+
+## Building
+
+Multiple build systems are supported.
+
+### Meson
+
+```sh
+meson setup builddir --buildtype=release
+meson compile -C builddir
+```
+
+### CMake
+
+```sh
+cmake -S . -B build
+cmake --build build
+```
+
+### Autoconf
+
+```sh
+autoreconf -fi
+./configure
+make
+```
+
+## License
+
+This project is licensed under the BSD Zero Clause License. See the [LICENSE](../LICENSE) file for details.

data/docs/Docker.md

@@ -0,0 +1,14 @@
+# Locusts
+
+[![CI](https://github.com/locusts-r-us/locusts/actions/workflows/docker.yml/badge.svg)](https://github.com/locusts-r-us/locusts/actions/workflows/docker.yml)
+
+A docker container containing locusts also exist.
+
+If you would like to add locusts to your company's servers, you can use the following command:
+
+```bash
+docker run --rm ghcr.io/locusts-r-us/locusts:master
+```
+
+That's it. There are locusts now in your computer.
+What those locusts do is up to the reader.