# Bild

`bild` is the universal build tool. It can build and test everything in the repo.

Examples:
```bash
bild --test Omni/Bild.hs         # Build and test a namespace
bild --time 0 Omni/Cloud.nix     # Build with no timeout
bild --plan Omni/Test.hs         # Analyze build without building
```

When the executable is built, the output will go to `_/bin`. Example:

```bash
# build the example executable
bild Omni/Bild/Example.py
# run the executable
_/bin/example
```

## Adding New Dependencies

### Python Packages

To add a new Python package as a dependency:

1. Add the package name to `Omni/Bild/Deps/Python.nix` (alphabetically sorted)
2. Use it in your Python file with `# : dep <package-name>` comment at the top
3. Run `bild <yourfile.py>` to build with the new dependency

Example:
```python
# : out myapp
# : dep stripe
# : dep pytest
import stripe
```

The package name must match the nixpkgs python package name (usually the PyPI name).
Check available packages: `nix-env -qaP -A nixpkgs.python3Packages | grep <name>`