Update to release v2.

This makes Telodendria compatible with Telodendria/Cytoplasm#47.

---

Please review the developer certificate of origin:

1. The contribution was created in whole or in part by me, and I have
the right to submit it under the open source licenses of the
Telodendria project; or
1. The contribution is based upon a previous work that, to the best of
my knowledge, is covered under an appropriate open source license and
I have the right under that license to submit that work with
modifications, whether created in whole or in part by me, under the
Telodendria project license; or
1. The contribution was provided directly to me by some other person
who certified (1), (2), or (3), and I have not modified it.
1. I understand and agree that this project and the contribution are
made public and that a record of the contribution—including all
personal information I submit with it—is maintained indefinitely
and may be redistributed consistent with this project or the open
source licenses involved.

- [x] I have read the Telodendria Project development certificate of
origin, and I certify that I have permission to submit this patch
under the conditions specified in it.

Co-authored-by: Jordan Bancino <jordan@bancino.net>
Co-authored-by: LDA <lda@ari.lt>
Reviewed-on: #57
Co-authored-by: lda <lda@freetards.xyz>
Co-committed-by: lda <lda@freetards.xyz>

.cvsignore

@@ -1,6 +0,0 @@
-build
-data
-.env
-*.patch
-*.log
-vgcore.*

.forgejo/issue_template/bug_report.yaml

@@ -0,0 +1,49 @@
+name: Bug Report
+about: File a bug report regarding Telodendria, its website, or its documentation.
+body:
+  - type: markdown
+    attributes:
+      value: |
+        You are submitting a bug report. Please be sure to fill out the
+        title with a brief description of the bug.
+  - type: dropdown
+    attributes:
+      label: Type
+      description: Select the type of issue.
+      options:
+        - Memory Leak
+        - Crash
+        - Unexpected Error Message
+        - Documentation
+        - Website
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: Description
+      description: |
+        Please give a thorough and detailed description of the bug you
+        are reporting. Provide all the information you have, and do
+        some investigating to ensure you are providing a legitimate
+        issue report that is well thought out. **Include details on
+        how to reproduce the issue, or explicitly state that you were
+        unable to reproduce it.**
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: Log Output
+      description: |
+        Please copy and paste the relevant sections of the log output,
+        or the entire log if it is not unreasonably large. The logs
+        will be automatically formatted, no code block is necessary.
+      render: shell
+    validations:
+      required: true
+  - type: markdown
+    attributes:
+      value: |
+        Please attach any additional files that may aid in our
+        investigation of this issue, including screenshots, debugging
+        session stack traces and dumps, etc.

.forgejo/issue_template/config.yaml

@@ -0,0 +1,7 @@
+blank_issues_enabled: false
+contact_links:
+  - name: General Matrix Room
+    url: "https://matrix.to/#/#telodendria-general:bancino.net"
+    about: |
+      General discussion on Telodendria happens in this Matrix room. You
+      may get quicker feedback from there.

.forgejo/issue_template/feature_request.yaml

@@ -0,0 +1,18 @@
+name: Feature Request
+about: Request a new feature or enhancement be added to Telodendria.
+title: "[Feature] "
+body:
+  - type: markdown
+    attributes:
+      value: |
+        You are submitting a feature request. Please be sure to fill
+        out the title with a brief description of the feature you are
+        requesting.
+  - type: textarea
+    attributes:
+      label: Description
+      description: |
+        Please give a thorough and detailed description of the feature
+        you are requesting.
+    validations:
+      required: true

.forgejo/pull_request_template.md

@@ -0,0 +1,25 @@
+
+---
+
+Please review the developer certificate of origin:
+
+1. The contribution was created in whole or in part by me, and I have
+the right to submit it under the open source licenses of the
+Telodendria project; or
+1. The contribution is based upon a previous work that, to the best of
+my knowledge, is covered under an appropriate open source license and
+I have the right under that license to submit that work with
+modifications, whether created in whole or in part by me, under the
+Telodendria project license; or
+1. The contribution was provided directly to me by some other person
+who certified (1), (2), or (3), and I have not modified it.
+1. I understand and agree that this project and the contribution are
+made public and that a record of the contribution—including all
+personal information I submit with it—is maintained indefinitely
+and may be redistributed consistent with this project or the open
+source licenses involved.
+
+- [ ] I have read the Telodendria Project development certificate of
+origin, and I certify that I have permission to submit this patch
+under the conditions specified in it.
+

.forgejo/workflows/compile.yaml

@@ -0,0 +1,27 @@
+name: Compile Telodendria
+run-name: Compile Telodendria on ${{ forgejo.actor }}
+on:
+  push:
+    branches:
+      - 'ma*'
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+    "Compile Telodendria":
+        strategy:
+            matrix:
+                os: [alpine]
+                arch: [aarch64]
+        runs-on: ["${{ matrix.os }}", "${{ matrix.arch }}"]
+        steps:
+            - name: Check out repository
+              uses: actions/checkout@v4
+              with:
+                submodules: true
+            - name: Configure Telodendria
+              run: ./configure
+            - name: Configure & Build Cytoplasm
+              run: make cytoplasm
+            - name: Build Telodendria
+              run: make

.forgejo/workflows/release.yaml

@@ -0,0 +1,44 @@
+name: Release Telodendria
+run-name: Release Telodendria on ${{ forgejo.actor }}
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+    "Release Telodendria":
+        strategy:
+            matrix:
+                os: [alpine]
+                arch: [aarch64]
+        runs-on: ["${{ matrix.os }}", "${{ matrix.arch }}"]
+        steps:
+            - name: Check out repository
+              uses: actions/checkout@v4
+              with:
+                submodules: true
+            - name: Archive submodules
+              run: git submodule foreach --recursive 'git archive --format tar --prefix=$displaypath/ -o submodule.tar HEAD'
+            - name: Archive repository
+              run: git archive --format tar -o release.tar HEAD
+            - name: Produce release archive
+              run: |
+                TOPDIR=$(pwd) git submodule --quiet foreach --recursive 'cd $TOPDIR; tar --concatenate --file=release.tar $displaypath/submodule.tar; rm -fv $displaypath/submodule.tar'
+                gzip release.tar
+                mkdir release
+                mv release.tar.gz release/Telodendria-$GITHUB_REF_NAME.tar.gz
+            - name: Upload artifact
+              uses: actions/upload-artifact@v3
+              with:
+                name: Telodendria-$GITHUB_REF_NAME.tar.gz
+                path: release/Telodendria-$GITHUB_REF_NAME.tar.gz
+            - name: Publish release
+              uses: actions/forgejo-release@v2
+              with:
+                tag: $GITHUB_REF_NAME
+                title: "Telodendria $GITHUB_REF_NAME"
+                release-dir: release/
+                release-notes: "docs/CHANGELOG.md"
+                direction: upload
+                prerelease: true

.gitignore

@@ -0,0 +1,18 @@
+# Telodendria .gitignore
+
+build
+out
+data
+Makefile
+
+*-leaked.txt
+.env
+*.patch
+*.orig
+*.log
+vgcore.*
+*.core
+contrib/.vagrant
+src/Schema
+src/include/Schema
+man/mandoc.db

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "Cytoplasm"]
+	path = Cytoplasm
+	url = https://git.telodendria.io/Telodendria/Cytoplasm.git

CONTRIBUTORS.txt

@@ -0,0 +1,16 @@
+N: Jordan Bancino
+E: jordan@bancino.net
+M: @jordan:bancino.net
+W: https://bancino.net
+D: Project Lead
+L: United States
+
+N: LDA
+E: marie@doskel.net
+E: ldasta@tedomum.fr
+E: lda@freetards.xyz
+M: @lda:a.freetards.xyz
+M: @lda:pain.agency
+M: @fourier:ari.lt
+D: Developer
+L: France

Cytoplasm

@@ -0,0 +1 @@
+Subproject commit 4f316ff7b3a955b831ca4aefb8679ddf3396a7d0

Cytoplasm/.cvsignore

@@ -1,3 +0,0 @@
-build
-out
-*-leaked.txt

Cytoplasm/.indent.pro

@@ -1,28 +0,0 @@
--bad
--bap
--bbb
--nbc
--bl
--c36
--cd36
--ncdb
--nce
--ci8
--cli1
--d0
--di1
--ndj
--ei
--fc1
--i4
--ip
--l72
--lc72
--lp
--npcs
--psl
--sc
--nsob
--nut
--nv 
-

Cytoplasm/README.txt

@@ -1,158 +0,0 @@
-Cytoplasm (libcytoplasm)
-========================================================================
-
-Cytoplasm is a general-purpose C library and runtime stub for
-creating high-level (particularly networked and multi-threaded) C
-applications. It allows applications to take advantage of the speed,
-flexibility, and simplicity of the C programming language, while
-providing helpful code to perform various complex tasks. Cytoplasm
-provides high-level data structures, a basic logging facility, an
-HTTP client and server, and more.
-
-Cytoplasm aims not to only do one thing well, but to do many things
-good enough. The primary target of Cytoplasm is simple, yet higher
-level C applications that have to perform relatively complex tasks,
-but don't want to pull in a large number of dependencies.
-
-Cytoplasm is extremely opinionated on the way programs using it are
-written. It strives to create a comprehensive and tightly-integrated
-programming environment, while also maintaining C programming
-correctness. It doesn't do any macro magic or make C look like
-anything other than C. It is written entirely in C89, and depends
-only on a POSIX environment. This differentiates it from other
-general-purpose libraries that often require modern compilers and
-non-standard language and environment features. Cytoplasm is intended
-to be extremely portable and simple, while still providing some of
-the functionality expected in higher-level programming languages
-in a platform-agnostic manner. In the case of TLS, Cytoplasm wraps
-low-level TLS libraries to offer a single, unified interface to TLS
-so that programs do not have to care about the underlying
-implementation.
-
-Cytoplasm is probably not suitable for embedded programming. It makes
-liberal use of the heap, and while data structures are designed to
-conserve memory where possible and practical, minimal memory usage
-is not really a design goal for Cytoplasm, although Cytoplasm takes
-care not to use any more memory than it absolutely needs. Cytoplasm
-also wraps a few standard libraries with additional logic and
-checking. While this ensures better runtime safetly, this inevitably
-adds a little overhead. 
-
-Originally a part of Telodendria (https://telodendria.io), a Matrix
-homeserver written in C, Cytoplasm was split off into its own project
-due to the desire of some Telodendria developers to use Telodendria's
-code in other projects. Cytoplasm is still a Telodendria project,
-and is maintained along side of Telodendria itself, even living in
-the same CVS module, but it is designed specifically to be distributed
-and used totally independent of Telodendria.
-
-The name "Cytoplasm" was chosen for a few reasons. It plays off the
-precedent set up by the Matrix organization in naming projects after
-the parts of a neuron. It also speaks to the function of Cytoplasm.
-The cytoplasm of a cell is the supporting material. It is what gives
-the cell its shape, and it facilitates the movement of materials
-to the other cell parts. Likewise, Cytoplasm aims to provide a
-support mechanism for C applications that have to perform complex
-tasks.
-
-Cytoplasm also starts with a C, which I think is a nice touch for C
-libraries. It's also fun to say and unique enough that searching for
-"libcytoplasm" should bring you to this project and not some other
-one.
-
-Building
-------------------------------------------------------------------------
-
-If your operating system or software distribution provides a pre-built
-package of Cytoplasm, you should prefer to use that instead of
-building it from source.
-
-Cytoplasm aims to have zero dependencies beyond what is mandated
-by POSIX. You only need the standard math and pthread libraries to
-build it. TLS support can optionally be enabled by setting the
-TLS_IMPL environment variable. The supported TLS implementations
-are as follows:
-
-    * OpenSSL
-    * LibreSSL
-
-If TLS support is not enabled, all APIs that use it should fall
-back to non-TLS behavior in a sensible manner. For example, if TLS
-support is not enabled, then the HTTP client API will simply return
-an error if a TLS connection is requested.
-
-Cytoplasm uses a custom build script instead of Make, for the sake
-of portability. To build everything, just run the script:
-
-        $ sh make.sh
-
-This will produce the following out/ directory:
-
-    out/
-        lib/
-            libcytoplasm.so - The Cytoplasm shared library.
-            libcytoplasm.a - The Cytoplasm static library.
-            cytoplasm.o - The Cytoplasm runtime stub.
-        bin/
-            hdoc - The documentation generator tool.
-        man/ - All Cytoplasm API documentation.
-
-Usage
-------------------------------------------------------------------------
-
-Cytoplasm provides the typical .so and .a files, which can be used
-to link programs with it in the usual way. However, Cytoplasm also
-provides a minimal runtime environment that is intended to be used
-with the library. As such, it also provides a runtime stub, which
-is intended to be linked in with programs using Cytoplasm. This
-stub is responsible for setting up and tearing down some Cytoplasm
-APIs. While it isn't required by any means, it makes Cytoplasm a
-lot easier to use for programmers by abstracting out all of the
-common logic that most programs will want to use.
-
-Here is the canonical Hello World written with Cytoplasm:
-
-	#include <Log.h>
-
-	int Main(void)
-	{
-		Log(LOG_INFO, "Hello World!");
-		return 0;
-	}
-
-If this file is Hello.c, then you can compile it by doing something
-like this:
-
-	$ cc -o hello Hello.c cytoplasm.o -lcytoplasm
-
-This command assumes that the runtime stub resides in the current
-working directory, and that libcytoplasm.so is in your library path.
-If you're using the version of Cytoplasm installed by your operating
-system or software distribution, consult the documentation for the
-location of the runtime stub. It may be located in
-/usr/local/libexec or some other similar location. If you've built
-Cytoplasm from source and wish to link to it from there, you may wish
-to do something like this:
-
-	$ export CYTOPLASM=/path/to/Cytoplasm/out/lib
-	$ cc -o hello Hello.c "${CYTOPLASM}/cytoplasm.o" \
-		"-L${CYTOPLASM}" -lcytoplasm
-
-As you may have noticed, C programs using Cytoplasm's runtime stub
-don't write the main() function. Instead, they use Main(). The main()
-function is provided by the runtime stub. The full form of Main()
-expected by the stub is as follows:
-
-	int Main(Array *args, HashMap *env);
-
-The first argument is a Cytoplasm array of the command line
-arguments, and the second is a Cytoplasm hash map of environment
-variables. Most linkers will let programs omit the env argument,
-or both arguments if you don't need either. The return value of
-Main() is returned to the operating system.
-
-Note that both arguments to Main may be treated like any other
-array or hash map. However, do not invoke ArrayFree() or HashMapFree()
-on the passed pointers, because memory is cleaned up after Main()
-returns.
-

Cytoplasm/examples/PrintArgsAndEnv.c

@@ -1,28 +0,0 @@
-#include <Array.h>
-#include <HashMap.h>
-
-#include <Log.h>
-
-int 
-Main(Array * args, HashMap * env)
-{
-    size_t i;
-    char *key;
-    char *val;
-
-    Log(LOG_INFO, "Hello World!");
-    Log(LOG_INFO, "Arguments: %lu", ArraySize(args));
-
-    for (i = 0; i < ArraySize(args); i++)
-    {
-        Log(LOG_INFO, "  [%ld] %s", i, ArrayGet(args, i));
-    }
-
-    Log(LOG_INFO, "Environment:");
-    while (HashMapIterate(env, &key, (void **) &val))
-    {
-        Log(LOG_INFO, "  %s = %s", key, val);
-    }
-
-    return 0;
-}

Cytoplasm/make.sh

@@ -1,328 +0,0 @@
-#!/usr/bin/env sh
-
-addprefix() {
-	prefix="$1"
-	shift
-	for thing in "$@"; do
-		echo "${prefix}${thing}"
-	done
-
-	unset prefix
-	unset thing
-}
-
-: "${NAME:=Cytoplasm}"
-: "${LIB_NAME:=$(echo ${NAME} | tr '[A-Z]' '[a-z]')}"
-: "${VERSION:=0.3.0}"
-
-: "${CVS_TAG:=${NAME}-$(echo ${VERSION} | sed 's/\./_/g')}"
-
-
-: "${SRC:=src}"
-: "${TOOLS:=tools}"
-: "${EXAMPLES:=examples}"
-: "${BUILD:=build}"
-: "${OUT:=out}"
-: "${STUB:=RtStub}"
-: "${LICENSE:=LICENSE.txt}"
-
-: "${CC:=cc}"
-: "${AR:=ar}"
-
-: "${DEFINES:=-D_DEFAULT_SOURCE -DLIB_NAME=\"${NAME}\" -DLIB_VERSION=\"${VERSION}\"}"
-: "${INCLUDE:=${SRC}/include}"
-
-: "${CFLAGS:=-Wall -Wextra -pedantic -std=c89 -O3 -pipe}"
-: "${LD_EXTRA:=-flto -fdata-sections -ffunction-sections -s -Wl,-gc-sections}"
-: "${LDFLAGS:=-lm -pthread}"
-
-if [ "${DEBUG}" = "1" ]; then
-    CFLAGS="${CFLAGS} -O0 -g"
-    LD_EXTRA=""
-fi
-
-if [ -n "${TLS_IMPL}" ]; then
-    case "${TLS_IMPL}" in
-        "LIBRESSL")
-            TLS_LIBS="-ltls -lcrypto -lssl"
-            ;;
-        "OPENSSL")
-            TLS_LIBS="-lcrypto -lssl"
-            ;;
-        *)
-            echo "Unrecognized TLS implementation: ${TLS_IMPL}"
-            echo "Consult Tls.h for supported implementations."
-            echo "Note that the TLS_ prefix is omitted in TLS_IMPL."
-            exit 1