rakyll/statik
Statik
Statik is a build tool for the Go language that transforms directory structures and files into byte arrays within source code. This process enables the creation of single-binary distributions by embedding static assets directly into the compiled executable.
The tool ensures deterministic builds by stripping file modification timestamps, resulting in consistent binary outputs across different environments. It also includes a build-time asset filter to limit the inclusion of specific file extensions and minimize the final executable size.
To access these embedded assets, the project provides a virtual file system interface that maps binary data to a standard file system API. This allows applications to interact with embedded resources as if they were stored on a physical disk.
Features
- Static Asset Embedding - Ships a CLI utility that transforms directory structures and files into embedded Go source code.
- Virtual File System Generators - Generates a virtual file system interface from static directory structures during the Go compilation process.
- Single-Binary Distributions - Bundles all required static assets into a single executable to eliminate external file dependencies.
- Virtual File Systems - Provides a virtual file system interface that maps embedded byte arrays to a standard file system API.
- Binary Asset Embedders - Transforms directory structures and files into byte arrays within Go source code for single-binary distribution.
- Byte Array Converters - Converts static files into Go source code byte slices to enable embedding within the compiled binary.
- Build Resource Filtering - Includes only specific file extensions in the final binary to minimize the resulting executable size.
- Asset Filtering Rules - Provides rules to exclude specific files or directories based on extensions before they are embedded.
- Deterministic Timestamp Stripping - Removes file modification timestamps during the build process to ensure bit-for-bit identical binary outputs.
- Extension Filtering - Limits the inclusion of assets to specific file extensions to minimize the resulting binary size.
- Build Size Optimizers - Optimizes Go binary size by filtering specific files and removing timestamps during the build process.
- Embedded Resources - Embeds static files into Go executables.
- Resource Embedding - Embed static files into Go executables.
- Static Asset Embedding - Embeds static files into Go programs.
