Exclude Patterns

Filter files and directories during bundling.

Basic Usage

var result = try zigx.bundle(.{
    .allocator = allocator,
    .include = &.{"src", "lib"},
    .exclude = &.{
        "*.tmp",
        ".git",
        "node_modules",
    },
    .output_path = "bundle.zigx",
});

Pattern Types

Exact Match

.exclude = &.{
    ".git",           // Exact directory
    ".gitignore",     // Exact file
    "config.json",    // Exact file
}

Wildcard Suffix

.exclude = &.{
    "*.tmp",          // All .tmp files
    "*.log",          // All .log files
    "*.bak",          // All .bak files
}

Wildcard Prefix

.exclude = &.{
    "test_*",         // Files starting with test_
    "._*",            // macOS resource forks
}

Directories

Patterns match directory names at any level:

.exclude = &.{
    "node_modules",   // Any node_modules/
    "__pycache__",    // Any __pycache__/
    "build",          // Any build/
}

Common Patterns

Development

.exclude = &.{
    // Build artifacts
    "zig-cache",
    "zig-out",
    "build",
    "dist",
    
    // Temp files
    "*.tmp",
    "*.log",
    "*.bak",
}

Version Control

.exclude = &.{
    ".git",
    ".gitignore",
    ".svn",
    ".hg",
}

Dependencies

.exclude = &.{
    "node_modules",
    "vendor",
    ".venv",
    "__pycache__",
}

Sensitive Files

.exclude = &.{
    ".env",
    "*.key",
    "*.pem",
    "secrets",
}

Complete Example

var result = try zigx.bundle(.{
    .allocator = allocator,
    .include = &.{"src", "lib", "build.zig", "README.md"},
    .exclude = &.{
        // Version control
        ".git",
        ".gitignore",
        
        // Build artifacts
        "zig-cache",
        "zig-out",
        
        // Dependencies
        "node_modules",
        
        // Temp files
        "*.tmp",
        "*.log",
        "*.bak",
        
        // Sensitive
        ".env",
        "*.key",
    },
    .output_path = "project.zigx",
});