feat(structslop): add support for structslop (#21)

Learn More:
* https://github.com/orijtech/structslop

Co-Authors:
* Adam Babik : https://github.com/adambabik
* TekWizely : https://github.com/TekWizely

Author: adambabik

.pre-commit-hooks.yaml

@@ -542,6 +542,72 @@
     description: "Run 'staticcheck [$ARGS] ./...' in repo root folder"
     pass_filenames: false
 
+# ==============================================================================
+# go-structslop-mod
+#   * Folder-Based
+#   * Recursive
+#   * Targets first parent folder with a go.mod file
+#   * Executes if any .go files modified
+#   * Executes if go.mod modified
+# ==============================================================================
+-   id: go-structslop-mod
+    name: 'go-structslop-mod'
+    entry: go-structslop-mod.sh
+    files: '(\.go$)|(\bgo\.mod$)'
+    exclude: '(^|/)vendor/'
+    language: 'script'
+    description: "Run 'cd $(mod_root $FILE); structslop [$ARGS] ./...' for each staged .go file"
+    pass_filenames: true
+    require_serial: true
+
+# ==============================================================================
+# go-structslop-pkg
+#   * Folder-Based
+#   * Targets folder containing staged file
+#   * Executes if any .go files modified
+# ==============================================================================
+-   id: go-structslop-pkg
+    name: 'go-structslop-pkg'
+    entry: go-structslop-pkg.sh
+    types: [go]
+    exclude: '(^|/)vendor/'
+    language: 'script'
+    description: "Run 'structslop [$ARGS] ./$(dirname $FILE)' for each staged .go file"
+    pass_filenames: true
+    require_serial: true
+
+# ==============================================================================
+# go-structslop-repo-mod
+#   * Repo-Based
+#   * Recursive
+#   * Targets ALL folders with a go.mod file
+#   * Executes if any .go files modified
+#   * Executes if go.mod modified
+# ==============================================================================
+-   id: go-structslop-repo-mod
+    name: 'go-structslop-repo-mod'
+    entry: go-structslop-repo-mod.sh
+    files: '(\.go$)|(\bgo\.mod$)'
+    exclude: '(^|/)vendor/'
+    language: 'script'
+    description: "Run 'cd $(mod_root); structslop [$ARGS] ./...' for each module in the repo"
+    pass_filenames: false
+
+# ==============================================================================
+# go-structslop-repo-pkg
+#   * Repo-Based
+#   * Recursive
+#   * Executes if any .go files modified
+# ==============================================================================
+-   id: go-structslop-repo-pkg
+    name: 'go-structslop-repo-pkg'
+    entry: go-structslop-repo-pkg.sh
+    types: [go]
+    exclude: '(^|/)vendor/'
+    language: 'script'
+    description: "Run 'structslop [$ARGS] ./...' in repo root folder"
+    pass_filenames: false
+
 # ==============================================================================
 # go-test-mod
 #   * Folder-Based

README.md

@@ -79,6 +79,13 @@ You can copy/paste the following snippet into your `.pre-commit-config.yaml` fil
     -   id: go-staticcheck-repo-mod
     -   id: go-staticcheck-repo-pkg
     #
+    # StructSlop
+    #
+    -   id: go-structslop-mod
+    -   id: go-structslop-pkg
+    -   id: go-structslop-repo-mod
+    -   id: go-structslop-repo-pkg
+    #
     # Formatters
     #
     -   id: go-fmt
@@ -265,6 +272,7 @@ This can be useful, for example, for hooks that display warnings, but don't gene
    - [go-vet](#go-vet)
    - [go-sec](#go-sec)
    - [go-staticcheck](#go-staticcheck)
+   - [go-structslop](#go-structslop)
  - Formatters
    - [go-fmt](#go-fmt)
    - [go-fumpt](#go-fumpt)
@@ -371,6 +379,33 @@ bingo install honnef.co/go/tools/cmd/staticcheck
  - https://staticcheck.io/
  - `staticcheck -h`
 
+-----------------
+### go-structslop
+Recommends struct field rearrangements to provide for maximum space/allocation efficiency.
+
+ - Can modify files (see `-apply`)
+
+| Hook ID                  | Description
+|--------------------------|------------
+| `go-structslop-mod`      | Run `'cd $(mod_root $FILE); structslop [$ARGS] ./...'` for each staged .go file
+| `go-structslop-pkg`      | Run `'structslop [$ARGS] ./$(dirname $FILE)'` for each staged .go file
+| `go-structslop-repo-mod` | Run `'cd $(mod_root); structslop [$ARGS] ./...'` for each module in the repo
+| `go-structslop-repo-pkg` | Run `'structslop [$ARGS] ./...'` in repo root folder
+
+##### Install (via [bingo](https://github.com/TekWizely/bingo))
+```
+bingo install github.com/orijtech/structslop/cmd/structslop
+```
+
+##### Useful Args
+```
+-apply : apply suggested fixes
+```
+
+##### Help
+ - https://github.com/orijtech/structslop#usage
+ - `structslop -h`
+
 ----------
 ### go-vet
 Examines Go source code and reports suspicious constructs, such as

go-structslop-mod.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+cmd=(structslop)
+. "$(dirname "${0}")/lib/cmd-mod.bash"

go-structslop-pkg.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+cmd=(structslop)
+. "$(dirname "${0}")/lib/cmd-pkg.bash"

go-structslop-repo-mod.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+cmd=(structslop)
+. "$(dirname "${0}")/lib/cmd-repo-mod.bash"

go-structslop-repo-pkg.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+cmd=(structslop)
+. "$(dirname "${0}")/lib/cmd-repo-pkg.bash"

sample-config.yaml

@@ -127,6 +127,13 @@ repos:
     -   id: go-staticcheck-repo-mod
     -   id: go-staticcheck-repo-pkg
     #
+    # StructSlop
+    #
+    -   id: go-structslop-mod
+    -   id: go-structslop-pkg
+    -   id: go-structslop-repo-mod
+    -   id: go-structslop-repo-pkg
+    #
     # Formatters
     #
     -   id: go-fmt