We have created the library to simplify the development process under C/C++ language, which offers a commonly used set of features that C developers often re-invent themselves. Apart from helper methods that replace/extend the C standard library, this toolkit also consists of modules that are very helpful in broad areas of expertise. The most notable is the JSON5 parser, math library, flexible file API, or various hashing algorithms.

Library is cross-platform and currently works on i386, amd64 and some ARM architectures. It has been tested on Windows, UNIX-like systems, iOS, Emscripten and Android. We're trying to expand the compatibility, but we need your help! If you have a device you want to test zpl on, please let us know about your experience, and we can try to make it work together.

There are several options in getting hands-on zpl:

curl -L https://github.com/zpl-c/zpl/releases/latest/download/zpl.h > zpl.h
# OR
wget https://github.com/zpl-c/zpl/releases/latest/download/zpl.h -O zpl.h

This approach will download the latest release of zpl with everything prepared for you.

• Navigate to the releases page of the zpl repository and pick the version you want to use. Each release contains the distributed version of zpl for you to use easily.

• Clone the repository by pressing the Clone or download button for instructions or use your terminal to clone:

git clone https://github.com/zpl-c/zpl.git

We use this method to develop zpl as it contains all the development sources that are easy to modify and expand, but it is not suitable for use in production.

Please follow the CONTRIBUTING.md guide to learn how to contribute to the project.

All distributions are defined at compile-time. You can always opt-in to any distribution kind without a need to maintain different copies of the library.

zpl enables all of its modules by default, which allows you to make full use of the library effortlessly.

The nano distribution provides the core parts of the library. It omits some specialized modules in favor of broader compatibility, and that also makes the library lightweight.

We've also made a pico distribution that only contains: Memory and Collections modules. There is no ability to enable specific core submodules within the pico distribution; however, consider using the nano distribution in that case.

zpl also allows you to enable/disable various modules at will, allowing you to create your distribution suiting your needs.

We cover many of these modules with example code you can explore at apps/examples folder. They serve as a good starting point to better understand how the library works. Have a look at this base64 text encoder:

#define ZPL_IMPL
#define ZPL_NANO
#define ZPL_ENABLE_OPTS
#define ZPL_ENABLE_HASHING
#include <zpl.h>

void exit_with_help(zpl_opts *opts);

int main(int argc, char **argv) {
    zpl_opts opts={0};

    zpl_opts_init(&opts, zpl_heap(), argv[0]);
    zpl_opts_add(&opts, "s", "string", "input string.", ZPL_OPTS_STRING);
    zpl_opts_positional_add(&opts, "string");
    zpl_b32 ok = zpl_opts_compile(&opts, argc, argv);
    if (!ok || !zpl_opts_positionals_filled(&opts))
        exit_with_help(&opts);

    zpl_string input = zpl_opts_string(&opts, "string", 0);
    zpl_u8 *encoded_str = zpl_base64_encode(zpl_heap(), cast(void*)input, zpl_string_length(input));
    zpl_printf("Original: %s\nEncoded: %s\n", input, encoded_str);

    zpl_mfree(encoded_str);
    zpl_opts_free(&opts);
    return 0;
}

void exit_with_help(zpl_opts *opts) {
    zpl_opts_print_errors(opts);
    zpl_opts_print_help(opts);
    zpl_exit(-1);
}

What is this library based on?

zpl is a fork of a library made by @gingerBill called gb that we've decided to expand and rewrite to fit our needs better. Although many parts of the library still stay faithful to their original, a significant amount of work shaped the library into what we present now.

Can I contribute to the project?

Yes, indeed. This project is dual-licensed according to LICENSE. You are free to fork it, contribute to it, or even sell it as you see fit.

Can I submit suggestions?

Indeed, we'd also gladly discuss those with you on Discord, if possible.