version

README

Go-Field

Go-Field is a powerful tool designed for Golang developers to enhance code readability and optimize memory usage by performing multi-level field alignment in struct declarations while preserving original metadata.

Features

• Analyzes struct field alignment and padding in Go source files
• Calculates the size and alignment of each struct and its fields
• Generics support
• single-pass iteration
• flexible configuration of files and directories for search
• flexible configuration of ignore files (full control)
• Optimizes struct layout by reordering fields for better memory efficiency
• Performs multi-level struct field alignment for improved readability
• Preserves original comments and metadata
• Supports nested structs and complex type hierarchies
• Processes single files or entire directories
• Offers an option to automatically apply optimizations to source files
• Easily integrates with existing Go projects
• Provides debug mode for detailed analysis
• Supports custom file pattern matching and ignoring

Installation

To install gofield, make sure you have Go installed on your system, then run:

# get all versions
go list -m -versions github.com/t34-dev/go-field-alignment/v2

# get package
go get -u github.com/t34-dev/go-field-alignment/v2@latest

# install package
go install github.com/t34-dev/go-field-alignment/v2/cmd/gofield@latest
or
go install github.com/t34-dev/go-field-alignment/v2/cmd/gofield@v2.0.3

For local installation:

# Bash
go build -o $GOPATH/bin/gofield       # Unix
go build -o $GOPATH/bin/gofield.exe   # Windows

# Makefile
make install                        # Any system

Usage

gofield [options] <file or directory paths>

Options

• --files, -f: Comma-separated list of files or folders to process (required)
• --ignore, -i: Comma-separated list of files or folders to ignore
• --view, -v: Print the absolute paths of found files
• --fix: Make changes to the files
• --pattern: Regex pattern for files to process (default: \.go$)
• --ignore-pattern: Regex pattern for files to ignore
• --version: Print the version of the program
• --help: Print usage information
• --debug: Enable debug mode

Examples

1. Analyze all Go files in the current directory:

   gofield --files .
   

2. Optimize structs in specific files:

   gofield --files main.go,utils.go --fix
   

3. Process files matching a custom pattern (default: \.go$):

   gofield --files src --pattern "\\.(go|proto)$"
   

4. Ignore test files:

   gofield --files . --ignore-pattern "_test\\.go$"
   

5. View files that would be processed without making changes:

   gofield --files src,pkg --view
   gofield --files "./internal/models/, ./cmd/" --view
   

6. Process multiple directories while ignoring specific folders:

   gofield --files "gofield,internal" --ignore "internal/generated"
   

7. Use debug mode for detailed analysis:

   gofield --files main.go --debug
   

8. Combine multiple options:

   gofield --files "src,pkg" --ignore "pkg/generated" --pattern "\\.(go|pb\\.go)$" --fix --view
   

9. Ignore all test files + one special file.:

   gofield -f . --ignore-pattern "file\.go|_test\.go$"
   

Output

For each struct found in the processed files, gofield will output:

• Struct name
• Total size of the struct (before and after optimization)
• Alignment of the struct
• For each field:
  • Field name
  • Field type
  • Offset within the struct
  • Size of the field
  • Alignment of the field

If the --fix option is used, it will also show the optimized layout of the struct and apply the changes to the source files.

When using the --debug option, Go-Field provides a detailed before-and-after comparison of struct layouts.

How It Works

1. Go-Field parses the specified Go source files and identifies all struct declarations.
2. It analyzes the current layout of each struct, calculating sizes, alignments, and paddings.
3. The tool then optimizes the struct layout by reordering fields to minimize padding while maintaining correct alignment.
4. If the --fix option is used, Go-Field rewrites the struct declarations in the source files with the optimized layout.
5. The tool preserves all comments and formatting to maintain code readability.

Best Practices

• Run Go-Field on your project before committing changes to ensure optimal struct layouts.
• Use the --view option to preview which files would be affected before applying fixes.
• Integrate Go-Field into your CI/CD pipeline to catch suboptimal struct layouts early.
• When optimizing performance-critical code, use Go-Field in conjunction with benchmarking to measure the impact of struct optimizations.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. Here are some ways you can contribute:

• Improve documentation
• Add new features
• Fix bugs
• Optimize performance
• Write tests

Before submitting a pull request, please ensure your code passes all tests and adheres to the project's coding standards.

License

This project is licensed under the ISC License. See the LICENSE file for details.

Support

If you encounter any issues or have questions, please file an issue on the GitHub repository.

---

Developed with ❤️ by T34

Documentation

Index

• Constants

Constants

const Version = "2.0.9"

Version represents the current Version of the program