A customizable code formatter for the C3 language, written in C3.

Usage

Usage:

c3fmt [<options>] <files/directories>

Options:

-h, --help       - Show this help.
-v, --version    - Show current version.
--in-place       - Format files in place.
--stdin          - Read input from stdin.
--stdout         - Output result to stdout.
--config=<path>  - Specify a config file.
--default        - Force default config.
--check          - Finish with error if files are not formatted.

Configuration

c3fmt will try to find a .c3fmt format inside the working directory. You can also pass your own path to c3fmt, or force the default configuration.

You can look at .c3fmt for the default configuration.

Building

Building requires the C3 compiler and the tree-sitter SDK library.

To build the executable:

c3c build

The binary will be located in build/c3fmt.

Updating Sources

You can keep the project dependencies and test data up-to-date using the built-in prepare targets:

Tree-sitter Grammar: Update the C3 grammar parser from upstream.
```
c3c build update-grammar --trust=full
```
Standard Library: Sync test/stdlib/src with the latest C3 standard library for stability testing.
```
c3c build update-stdlib --trust=full
```

Tests

Run all tests using the C3 compiler:

c3c test

The test suite includes:

Corpus: Compares formatted output against expected _f.c3 files.
Stability: Ensures that formatting already-formatted code produces no changes (idempotency).
Stdlib: Formats the entire C3 standard library and verifies that it still compiles and maintains the same syntax tree.

Vendored libraries

src/opt.c3: A vendored copy of getopt.c3l.
lib/tree_sitter.c3l: C3 bindings for the core tree-sitter SDK.
lib/tree_sitter_c3.c3l: C3 grammar bindings for tree-sitter.

Planned features / wishlist

Wrapping indent option (ContinuationIndentWidth).
Import sorting.
Pointer alignment calibration.

Known issues

(none yet)

C3fmt

Install / Use

README