# `ignore_source_files`

A list of patterns that exclude files and directories from the source tree before it gets staged into the build container. Applies equally to RPM, DEB, and pacman builds.

```yaml
ignore_source_files:
  - .git
  - .env
  - .DS_Store
  - "*.log"
  - /build
  - /target
  - node_modules
```

## What it does

For each build, OmniPackage uses `rsync` to copy the project source into a working directory inside the container (`/root/rpmbuild/SOURCES/<name>/` for RPM, `/output/build/` for DEB, `/work/<name>/` for pacman). Each pattern in `ignore_source_files` is passed verbatim as `--exclude=<pattern>` to that rsync. Matching files never reach the container, never end up in the source tarball that ships inside the RPM, and never enter the `debuild` working tree.

Two main uses:

- **Keep build artefacts out of the package source.** Prior local builds (`/build`, `/dist`, `/target`, `node_modules`) bloat the staged tree and can confuse the in-container build by colliding with what it is about to produce.
- **Keep secrets out.** `.env` typically holds the GPG key and S3 credentials. The final package only contains files your spec / `debian/` / `PKGBUILD` recipes install, so a stray `.env` will not ship on its own — but it sits in the container's working tree, available to anything the build script runs. That is a hazard if a script bakes it into a generated config or copies the tree elsewhere. The init templates exclude `.env`; do the same in a config written from scratch.

## Pattern syntax

Patterns are rsync exclude filters (not gitignore — close, but not identical):

| Pattern     | Matches                                                              |
| ----------- | -------------------------------------------------------------------- |
| `name`      | Any file or directory called `name`, at any depth                    |
| `/name`     | A file or directory called `name` only at the source root (anchored) |
| `*.ext`     | Any file with that extension, at any depth (basename glob)           |
| `dir/*.tmp` | `*.tmp` files directly inside any `dir/`                             |

`*` does not cross `/` boundaries (standard rsync). Stick to the four shapes above; fancier patterns (`**`, character classes) are valid in rsync but inconsistent across versions, so avoid them.

## Defaults from `omnipackage init`

`omnipackage init` writes a starter `ignore_source_files` matching the detected project type. Common to every type:

```yaml
- .git
- .env
- .DS_Store
- "*.log"
```

Per-type additions:

| Project type        | Adds                            |
| ------------------- | ------------------------------- |
| `rust`              | `/target`                       |
| `cmake`, `cpp`, `c` | `/build`                        |
| `electron`, `tauri` | `node_modules`, `/dist`, `/out` |
| `ruby`              | `/vendor`, `/tmp`               |
| `crystal`           | `/lib`, `/bin`                  |

These are starting points — extend them as the project grows. Real-world examples: [`mpz`](https://github.com/olegantonyan/mpz/blob/master/.omnipackage/config.yml) excludes `/build`; [`omnipackage-rs`](https://github.com/omnipackage/omnipackage-rs/blob/master/.omnipackage/config.yml) excludes `/target`.