https://github.com/santerijps/ecc

ecc is an easy to use utility that makes compiling and running C programs easy, while also providing executable compression.
https://github.com/santerijps/ecc

Last synced: 2 days ago
JSON representation

ecc is an easy to use utility that makes compiling and running C programs easy, while also providing executable compression.

• Host: GitHub
• URL: https://github.com/santerijps/ecc
• Owner: santerijps
• Created: 2023-10-10T15:08:32.000Z (about 1 year ago)
• Default Branch: master
• Last Pushed: 2023-10-10T15:14:41.000Z (about 1 year ago)
• Last Synced: 2023-10-10T19:31:08.012Z (about 1 year ago)
• Language: C
• Size: 4.88 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# `ecc` - Easy Compiler & Compressor

`ecc` is an easy to use utility that makes compiling and running C programs easy, while also providing executable compression.

## Usage

```txt

Usage: ecc [generic options] [build options] [...c source files]

This program depends on:

  - Compilers:   gcc (and optionally, clang)

  - Compressor:  upx

Generic options:

  --help, -h             Show app usage.

  --version, -v          Show app version.

Build options:

  --compiler, -c         Which compiler to use. (Default: gcc, supports clang as well)

  --out, -o              Output executable name. (Default: out.exe)

  --std                  Which C standard version to use. (Default: c2x)

  --define, -D           Define a macro statement at compile time.

  --include, -I          Add include path.

  --libs, -L             Add lib path. Found DLLs are automatically included in the compilation.

  --quiet, -q            Only print errors.

  --strict               Compilation fails in case of warnings. (Warnings are treated as errors).

  --fast                 Compiles with the -Ofast GCC flag. (Default: -Oz)

  --compress             Compresses the compiled executable with upx.

  --run, -r              Runs the executable after compiling.

Examples:

  Compile current project:       ecc

  Compile a specific file(s):    ecc main.c lib.c

  Compile file and run:          ecc test.c -r

  Compile and run with args:     ecc sum.c -r -- 1 2 3

  Compile with options:          ecc --compiler clang -o app.exe

  Compile with defines:          ecc -D 'x=1' --define 'NAME="Alice"'

```

## Feature ideas

### Add `--root`/`-R` option

This is to avoid situations like:

```sh

ecc src/main.c -I src -L src

```

... where all the source files, includes and DLLs are in the `src` directory. Currently, we must specify the `src` dir three times. The new flag would enable the user to simply provide a "root" directory, from which the files will be looked up.

### Add code formatiing with `clang-format`

Self explanatory. This would add another dependency, but for my personal use it's ok. Code could optionally be formatted on every compilation.