cpoach is a support tool designed to simplify the use of single-file C/C++ libraries. These libraries can be effortlessly installed via npm, making it easier to integrate them into your projects without the hassle of managing build systems (rather, just like #include <stdio.h>), and without including the third-party libraries into the project's version control. This is mainly to facilitate in-class demonstrations and assignments.

The name cpoach is a playful nod to the idea of poaching awesome C/C++ libraries and making them easily accessible for educational purposes. Many of these libraries are listed in r-lyeh/single_file_libs, fffaraz/awesome-cpp, or p-ranav/awesome-hpp. I was listening to Eskil Steenberg's talk on Advanced C, which you should also look into. He also has a collection of C libraries that you may want to explore.

Issues or suggestions regarding a specific library should be directed to the original library repository. However, for issues to the cpoach project, please open an issue here.

To install cpoach, use the following command:

$ npm i -g cpoach.sh

After installation, you can include the desired libraries in your C/C++ projects. For example, if you want to use the tigr.c library for graphics, follow these steps:

Run:

$ npm i tigr.c

And then include tigr.h as follows:

// main.c
#define TIGR_IMPLEMENTATION
#include <tigr.h>

int main() { /* ... */ }

And then compile with clang or gcc as usual.

$ clang $(cpoach i) main.c  # or, use gcc
$ gcc   $(cpoach i) main.c

$ cpoach [command] [options]

Usage: cpoach [command] [options]

Commands:
  i | includes         Generate compiler flags for include paths.

Options:
  --compiler [name]    Specify the compiler (msvc, gcc, clang). Default is gcc.
  --msvc               Shortcut for --compiler msvc.
  --gcc                Shortcut for --compiler gcc.
  --clang              Shortcut for --compiler clang.
  --help               Display help information.

Below is a categorized list of single-file C/C++ libraries available through the cpoach project: