summaryrefslogtreecommitdiff
path: root/goldens/README.md
blob: 00bbdc0118674cad96d05eae724af33ada86b2c2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# Golden Generated Files

This directory is a repository for the generated files of `flatc`.

We check in the generated code so we can see, during a PR review, how the
changes affect the generated output. Its also useful as a reference to point too
as how things work across various languages.

These files are **NOT** intended to be depended on by any code, such as tests or
or compiled examples.

## Languages Specifics

Each language should keep their generated code in their respective directories.
However, the parent schemas can, and should, be shared so we have a consistent
view of things across languages. These are kept in the `schema/` directory.

Some languages may not support every generation feature, so each language is
required to specify the `flatc` arguments individually.

* Try to avoid includes and nested directories, preferring it as flat as 
possible.

## Updating

Just run the `generate_goldens.py` script and it should generate them all.