Crun CLI

C-based project scaffolding CLI

Overview • Key Features • Requirements • Usage • Runtime Flow • Template Sources • Download • Emailware • Contributing • License • Contact • Acknowledgments

Overview

crun-cli fetches template metadata, lets you choose a language/template, downloads or reuses cached packages, then either extracts a ZIP scaffold (with optional init script) or installs a direct single-file template into your current directory.

Key Features

• Interactive language/template menus
• Template cache in ~/.local/share/crun/
• Hidden extraction workspace in ~/.local/share/crun/tmp/
• Optional init execution:
  • __init__.sh (Unix)
  • __init__.bat (Windows)
• Init script cleanup after execution
• ZIP scaffold copy excludes zip artifacts
• Single-file template install when package is not a ZIP
• Timestamped audit logs in CLI and ~/.local/share/crun/audit.log

Requirements

• CMake
• Ninja
• libcurl
• cJSON
• minizip

Usage

git clone https://github.com/zouari-oss/crun-cli
cd crun-cli/project

./run rb   # configure
./run i    # build
./run r    # run crun

CLI Flags

./bin/build/crun --help
./bin/build/crun --update

• --help prints CLI usage and notes.
• --update refreshes local crun_stacks.json from the remote source.

Install Binary (optional)

sudo cp bin/build/crun /usr/local/bin/crun

Runtime Flow

1. Load crun_stacks.json (download if missing)
2. Select language and template
3. Resolve template package (cache hit or download)
4. Detect package type (ZIP vs single file)
5. For ZIP: extract into hidden temp workspace
6. For ZIP: run init script if present
7. For ZIP: remove __init__.sh / __init__.bat
8. For ZIP: copy output to current directory (excluding *.zip)
9. For single file: copy file directly into current directory
10. Clean temporary workspace (ZIP path only)

Template Sources

• cpkg templates

Download

You can download the latest installable version of crun-cli for Windows, macOS and Linux.

Emailware

crun-cli is an emailware. Meaning, if you liked using this app or it has helped you in any way, would like you send as an email at zouariomar20@gmail.com about anything you'd want to say about this software. I'd really appreciate it!

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This repository is licensed under the GPL-3.0 License. You are free to use, modify, and distribute the content. See the LICENSE file for details.

Contact

For questions or suggestions, feel free to reach out:

• GitHub: ZouariOmar
• Email: zouariomar20@gmail.com
• LinkedIn: Zouari Omar

Acknowledgments

Built with ❤️ for the open-source community.