🧠 code-function-watcher

A powerful CLI tool for Go developers to scan, detect, and prevent duplicated or unused functions in your codebase.
Designed for code quality automation, especially useful in team collaboration, code review, and CI/CD pipelines.

---

✨ Features

• ✅ Detect all exported functions in a directory
• 🔁 Compare old and new snapshots to find duplicated or similar functions
• 🧹 Detect unused functions that are defined but never called
• 🚫 Ignore list support to skip known functions or third-party calls
• 🤖 GitHub CI/CD & PR auto-comment support

---

📦 Installation

1. Clone the Repo

git clone https://github.com/ak4bento/code-function-watcher.git
cd code-function-watcher

2. Install Dependencies

go mod tidy

---

🚀 Usage

🔍 Scan Functions

go run main.go scan <path> [-o output.json]

Example:

go run main.go scan ./ -o data/functions.json

This will scan all Go files recursively and extract exported function names + locations.

---

🔁 Compare Function Snapshots

go run main.go compare <old.json><new.json>

Example:

go run main.go compare data/functions-old.json data/functions-new.json

It will print potentially duplicated or very similar functions with similarity percentage (e.g., 94.5%).

---

🧹 Detect Unused Functions

go run main.go unused <path> --defined <functions.json> [--ignore ignore.txt]

Example:

go run main.go unused ./ --defined data/functions.json --ignore ignore.txt

Lists exported functions that were never called anywhere in your project.

---

🚫 Ignore List

Use a plain text file (e.g. ignore.txt) to exclude functions from being detected as "unused":

log.Println
fmt.Errorf
main

---

🧪 GitHub Actions (CI/CD)

Create a file .github/workflows/scan.yml:

name: Code Function Watcheron:
pull_request:
paths:
- '**/*.go'jobs:
scan:
runs-on: ubuntu-lateststeps:
- name: Checkout Codeuses: actions/checkout@v3
- name: Setup Gouses: actions/setup-go@v4with:
go-version: 1.21
- name: Install Dependenciesrun: go mod tidy
- name: Run Function Comparisonrun: | go run main.go scan ./ -o data/functions-new.json go run main.go compare data/functions-old.json data/functions-new.json > result.txt - name: Upload Resultsuses: actions/upload-artifact@v3with:
name: compare-resultpath: result.txt

---

💬 Auto-Comment to Pull Request (Bonus)

Install peter-evans/create-or-update-comment

Extend your workflow:

 - name: Post PR Commentuses: peter-evans/create-or-update-comment@v3with:
issue-number: ${{ github.event.pull_request.number }}body: | 🔁 **Function Comparison Report** ``` $(cat result.txt) ```

---

📁 Project Structure

.
├── cmd/
│ ├── compare.go
│ ├── scan.go
│ └── unused.go
├── pkg/
│ ├── compare/
│ ├── exporter/
│ ├── scanner/
│ └── unused/
├── data/
│ └── functions-old.json
│ └── functions-new.json
├── ignore.txt
└── main.go

---

🧑‍💻 Author

Made with ❤️ by @ak4bento