feat(profiler): add CPU and memory profiling support

Introduce a new profiler package to handle CPU and memory profiling. This allows developers to analyze performance bottlenecks by enabling profiling flags in the main application. The profiler outputs profiles to a specified directory, with timestamps for unique file naming. Added the `profiles` directory to .gitignore to exclude profiling outputs from version control.

Author: vldcreation

.gitignore

@@ -1,4 +1,7 @@
 vendor
 local
 
-bin
+bin
+
+# dev
+profiles

main.go

@@ -1,11 +1,46 @@
 package main
 
 import (
+	"flag"
+
 	"github.com/vldcreation/helpme/cmd"
+	"github.com/vldcreation/helpme/pkg/profiler"
 	"github.com/vldcreation/helpme/util"
 )
 
 func main() {
+	// Setup profiling flags
+	cpuProfile := flag.String("cpuprofile", "", "write cpu profile to file")
+	memProfile := flag.String("memprofile", "", "write memory profile to file")
+	flag.Parse()
+
+	// Initialize profiler if profiling is enabled
+	if *cpuProfile != "" || *memProfile != "" {
+		prof, err := profiler.New("./profiles")
+		if err != nil {
+			util.PrintlnRed(err.Error())
+			return
+		}
+
+		// Start CPU profiling if requested
+		if *cpuProfile != "" {
+			if err := prof.StartCPUProfile(); err != nil {
+				util.PrintlnRed(err.Error())
+				return
+			}
+			defer prof.StopCPUProfile()
+		}
+
+		// Write memory profile at exit if requested
+		if *memProfile != "" {
+			defer func() {
+				if err := prof.WriteHeapProfile(); err != nil {
+					util.PrintlnRed(err.Error())
+				}
+			}()
+		}
+	}
+
 	if err := cmd.NewApp().Execute(); err != nil {
 		util.PrintlnRed(err.Error())
 	}

pkg/profiler/profiler.go

@@ -0,0 +1,75 @@
+package profiler
+
+import (
+	"fmt"
+	"os"
+	"path/filepath"
+	"runtime/pprof"
+	"time"
+)
+
+// Profiler handles CPU and memory profiling
+type Profiler struct {
+	cpuFile   *os.File
+	memFile   *os.File
+	outputDir string
+}
+
+// New creates a new profiler instance
+func New(outputDir string) (*Profiler, error) {
+	if outputDir == "" {
+		outputDir = "."
+	}
+
+	if err := os.MkdirAll(outputDir, 0755); err != nil {
+		return nil, fmt.Errorf("failed to create output directory: %w", err)
+	}
+
+	return &Profiler{outputDir: outputDir}, nil
+}
+
+// StartCPUProfile starts CPU profiling
+func (p *Profiler) StartCPUProfile() error {
+	timestamp := time.Now().Format("20060102-150405")
+	cpuFile := filepath.Join(p.outputDir, fmt.Sprintf("cpu-%s.prof", timestamp))
+
+	f, err := os.Create(cpuFile)
+	if err != nil {
+		return fmt.Errorf("could not create CPU profile: %w", err)
+	}
+
+	if err := pprof.StartCPUProfile(f); err != nil {
+		f.Close()
+		return fmt.Errorf("could not start CPU profile: %w", err)
+	}
+
+	p.cpuFile = f
+	return nil
+}
+
+// StopCPUProfile stops CPU profiling
+func (p *Profiler) StopCPUProfile() {
+	if p.cpuFile != nil {
+		pprof.StopCPUProfile()
+		p.cpuFile.Close()
+		p.cpuFile = nil
+	}
+}
+
+// WriteHeapProfile writes memory profile
+func (p *Profiler) WriteHeapProfile() error {
+	timestamp := time.Now().Format("20060102-150405")
+	memFile := filepath.Join(p.outputDir, fmt.Sprintf("mem-%s.prof", timestamp))
+
+	f, err := os.Create(memFile)
+	if err != nil {
+		return fmt.Errorf("could not create memory profile: %w", err)
+	}
+	defer f.Close()
+
+	if err := pprof.WriteHeapProfile(f); err != nil {
+		return fmt.Errorf("could not write memory profile: %w", err)
+	}
+
+	return nil
+}