cpoach.sh 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Subhajit Sahu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+![](https://github.com/user-attachments/assets/459f91c1-c313-4f3a-b4e1-14edc4fb358f)
+
+**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* or including third-party libraries in your version control.
+
+<br>
+
+## Features
+
+- Install and use C/C++ libraries as easily as `#include <stdio.h>`.
+- Libraries are available via NPM for seamless installation.
+- Ideal for in-class demonstrations and assignments.
+- Access libraries for high-performance computing, graphics, networking, cryptography, and more.
+
+<br>
+
+## Installation
+
+To install *cpoach*, use the following command:
+
+```bash
+npm i -g cpoach.sh
+```
+
+<br>
+
+## Usage
+
+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:
+```bash
+$ npm i tigr.c
+```
+
+And then include `tigr.h` as follows:
+```c
+// main.c
+#define TIGR_IMPLEMENTATION
+#include <tigr.h>
+
+int main() { /* ... */ }
+```
+
+And then compile with `clang` or `gcc` as usual.
+
+```bash
+$ clang $(cpoach i) main.c  # or, use gcc
+$ gcc   $(cpoach i) main.c
+```
+
+Refer to the [website](https://nodef.github.io) for a categorized list of available libraries.
+
+<br>
+
+## Contributing
+
+We welcome contributions! If you have suggestions, please open an issue on our [GitHub repository](https://github.com/nodef/cpoach.sh/issues).
+
+<br>
+<br>
+
+
+[![ORG](https://img.shields.io/badge/org-nodef-green?logo=Org)](https://nodef.github.io)
+![](https://ga-beacon.deno.dev/G-RC63DPBH3P:SH3Eq-NoQ9mwgYeHWxu7cw/github.com/nodef/cpoach.sh)
+
+[tigr.c]: https://www.npmjs.com/package/tigr.c

package/index.js

@@ -0,0 +1,89 @@
+const fs   = require('fs');
+const path = require('path');
+
+
+// Run the `includes` command, which generates compiler flags for include paths.
+function runIncludes(opt) {
+  const includes = [];
+  const cwd = process.cwd();
+  const pth = path.basename(cwd) === 'node_modules'? cwd : path.join(cwd, 'node_modules');
+  for (const ent of fs.readdirSync(pth)) {
+    if (!ent.endsWith('.c') && !ent.endsWith('.cxx')) continue;
+    includes.push(path.join(pth, ent));
+  }
+  const FLAG = opt.compiler==='msvc'? '/I' : '-I';
+  console.log(includes.map(pth => `${FLAG}"${pth}"`).join(' ').trim());
+}
+
+
+// Run the help command, which displays usage information.
+function runHelp() {
+  console.error(
+    `Usage: cpoach [command] [options]\n` +
+    `\n` +
+    `Commands:\n` +
+    `  i | includes         Generate compiler flags for include paths.\n` +
+    `\n` +
+    `Options:\n` +
+    `  --compiler [name]    Specify the compiler (msvc, gcc, clang). Default is gcc.\n` +
+    `  --msvc               Shortcut for --compiler msvc.\n` +
+    `  --gcc                Shortcut for --compiler gcc.\n` +
+    `  --clang              Shortcut for --compiler clang.\n`
+  );
+}
+
+
+// Parse the command name.
+function parseCommand(opt, cmd) {
+  if (/i|includes/.test(cmd)) opt.command = 'includes';
+  else opt.error = `Unknown option: ${cmd}`;
+}
+
+// Parse a single command-line argument.
+function parseArg(opt, argv, k, i) {
+  if (k==='--help') opt.help = true;
+  else if (k==='--compiler') opt.compiler = argv[++i];
+  else if (k==='--msvc')  opt.compiler = 'msvc';
+  else if (k==='--gcc')   opt.compiler = 'gcc';
+  else if (k==='--clang') opt.compiler = 'clang';
+  else if (!opt.command)  parseCommand(opt, k);
+  else opt.error = `Unknown option: ${k}`;
+  return i;
+}
+
+// Parse command-line arguments.
+function parseArgs(argv) {
+  const opt = {
+    error: null,
+    help: false,
+    command: 'includes',
+    compiler: 'gcc'
+  };
+  for (let i=2; i<argv.length; i++)
+    i = parseArg(opt, argv, argv[i], i);
+  return opt;
+}
+
+
+// Main entry point.
+function main(argv) {
+  const opt = parseArgs(argv);
+  if (opt.error) {
+    console.error(opt.error + '\n');
+    console.error('Use "cpoach --help" for usage information.');
+    process.exit(1);
+  }
+  if (opt.help) {
+    runHelp();
+    process.exit(0);
+  }
+  switch (opt.command) {
+    case 'includes': runIncludes(opt); break;
+    default:
+      console.error(`Unknown command: ${opt.command}`);
+      process.exit(1);
+  }
+}
+
+// Run the main entry point.
+main(process.argv);

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "cpoach.sh",
+  "version": "0.0.0",
+  "description": "Support tool for for easy-to-use, C/C++ libraries that can be effortlessly installed via NPM.",
+  "keywords": [
+    "c",
+    "c++",
+    "cpoach",
+    "includes",
+    "support",
+    "tool",
+    "library",
+    "npm",
+    "compiler",
+    "flags",
+    "includes",
+    "path",
+    "gcc",
+    "clang",
+    "clang++",
+    "msvc"
+  ],
+  "bin": {
+    "cpoach": "./index.js"
+  },
+  "homepage": "https://github.com/nodef/cpoach.sh#readme",
+  "bugs": {
+    "url": "https://github.com/nodef/cpoach.sh/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nodef/cpoach.sh.git"
+  },
+  "license": "MIT",
+  "author": "wolfram77@gmail.com",
+  "type": "commonjs",
+  "main": "index.js",
+  "scripts": {
+    "test": "exit"
+  }
+}