diff --git a/.gitignore b/.gitignore index 191579c..e6c34ba 100644 --- a/.gitignore +++ b/.gitignore @@ -1,3 +1,2 @@ tmp -.DS_STore -.idea +.DS_STore \ No newline at end of file diff --git a/README.md b/README.md index 73e7ccc..42f1bf9 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,4 @@ -# Goffee Core +# GoCondor Core +![Build Status](https://github.com/gocondor/core/actions/workflows/build-main.yml/badge.svg) ![Test Status](https://github.com/gocondor/core/actions/workflows/test-main.yml/badge.svg) [![Coverage Status](https://coveralls.io/repos/github/gocondor/core/badge.svg?branch=main)](https://coveralls.io/github/gocondor/core?branch=main&cache=false) [![GoDoc](https://godoc.org/github.com/gocondor/core?status.svg)](https://godoc.org/github.com/gocondor/core) [![Go Report Card](https://goreportcard.com/badge/github.com/gocondor/core)](https://goreportcard.com/report/github.com/gocondor/core) -The core packages of Goffee framework +The core packages of GoCondor framework diff --git a/cache.go b/cache.go index 4f32bcd..04e818c 100644 --- a/cache.go +++ b/cache.go @@ -16,9 +16,6 @@ type Cache struct { redis *redis.Client } -// NewCache initializes a new Cache instance with the provided configuration and connects to a Redis database. -// If caching is enabled in the provided configuration but the connection to Redis fails, it causes a panic. -// Returns a pointer to the initialized Cache structure. func NewCache(cacheConfig CacheConfig) *Cache { ctx = context.Background() dbStr := os.Getenv("REDIS_DB") @@ -43,7 +40,6 @@ func NewCache(cacheConfig CacheConfig) *Cache { } } -// Set stores a key-value pair in the Redis cache with no expiration. Returns an error if the operation fails. func (c *Cache) Set(key string, value string) error { err := c.redis.Set(ctx, key, value, 0).Err() if err != nil { @@ -52,8 +48,6 @@ func (c *Cache) Set(key string, value string) error { return nil } -// SetWithExpiration stores a key-value pair in the cache with a specified expiration duration. -// Returns an error if the operation fails. func (c *Cache) SetWithExpiration(key string, value string, expiration time.Duration) error { err := c.redis.Set(ctx, key, value, expiration).Err() if err != nil { @@ -62,7 +56,6 @@ func (c *Cache) SetWithExpiration(key string, value string, expiration time.Dura return nil } -// Get retrieves the value associated with the provided key from the cache. Returns an error if the operation fails. func (c *Cache) Get(key string) (string, error) { result, err := c.redis.Get(ctx, key).Result() if err != nil { @@ -71,7 +64,6 @@ func (c *Cache) Get(key string) (string, error) { return result, nil } -// Delete removes the specified key from the cache and returns an error if the operation fails. func (c *Cache) Delete(key string) error { err := c.redis.Del(ctx, key).Err() if err != nil { diff --git a/context.go b/context.go index c603030..7020e84 100644 --- a/context.go +++ b/context.go @@ -121,43 +121,34 @@ func (c *Context) GetQueueClient() *asynq.Client { return client } -func (c *Context) GetUploadedFile(name string) (*UploadedFileInfo, error) { +func (c *Context) GetUploadedFile(name string) *UploadedFileInfo { file, fileHeader, err := c.Request.httpRequest.FormFile(name) if err != nil { - return nil, fmt.Errorf("error retrieving file: %v", err) + panic(fmt.Sprintf("error with file,[%v]", err.Error())) } defer file.Close() - - // Extract the file extension ext := strings.TrimPrefix(path.Ext(fileHeader.Filename), ".") tmpFilePath := filepath.Join(os.TempDir(), fileHeader.Filename) tmpFile, err := os.Create(tmpFilePath) if err != nil { - return nil, fmt.Errorf("error creating temporary file: %v", err) + panic(fmt.Sprintf("error with file,[%v]", err.Error())) } - defer tmpFile.Close() - // Copy the uploaded file content to the temporary file buff := make([]byte, 100) for { n, err := file.Read(buff) if err != nil && err != io.EOF { - return nil, fmt.Errorf("error reading uploaded file: %v", err) + panic("error with uploaded file") } if n == 0 { break } - _, err = tmpFile.Write(buff[:n]) - if err != nil { - return nil, fmt.Errorf("error writing to temporary file: %v", err) - } + n, _ = tmpFile.Write(buff[:n]) } - - // Get file info for the temporary file tmpFileInfo, err := os.Stat(tmpFilePath) if err != nil { - return nil, fmt.Errorf("error getting file info: %v", err) + panic(fmt.Sprintf("error with file,[%v]", err.Error())) } - + defer tmpFile.Close() uploadedFileInfo := &UploadedFileInfo{ FullPath: tmpFilePath, Name: fileHeader.Filename, @@ -165,7 +156,7 @@ func (c *Context) GetUploadedFile(name string) (*UploadedFileInfo, error) { Extension: ext, Size: int(tmpFileInfo.Size()), } - return uploadedFileInfo, nil + return uploadedFileInfo } func (c *Context) MoveFile(sourceFilePath string, destFolderPath string) error { @@ -194,7 +185,7 @@ func (c *Context) MoveFile(sourceFilePath string, destFolderPath string) error { for { n, err := srcFile.Read(buff) if err != nil && err != io.EOF { - return fmt.Errorf("error moving file: %v", sourceFilePath) + panic(fmt.Sprintf("error moving file %v", sourceFilePath)) } if n == 0 { break @@ -238,7 +229,7 @@ func (c *Context) CopyFile(sourceFilePath string, destFolderPath string) error { for { n, err := srcFile.Read(buff) if err != nil && err != io.EOF { - return fmt.Errorf("error moving file: %v", sourceFilePath) + panic(fmt.Sprintf("error moving file %v", sourceFilePath)) } if n == 0 { break diff --git a/cookies.go b/cookies.go index 4e51470..ce17dd2 100644 --- a/cookies.go +++ b/cookies.go @@ -21,24 +21,19 @@ import ( "strings" ) -// ErrValueTooLong indicates that the cookie value exceeds the allowed length limit. -// ErrInvalidValue signifies that the cookie value is in an invalid format. var ( ErrValueTooLong = errors.New("cookie value too long") ErrInvalidValue = errors.New("invalid cookie value") ) -// UserCookie represents a structure to hold user-specific data stored in a cookie, including Email and Token fields. +// Declare the User type. type UserCookie struct { Email string Token string } -// secretcookie is a global variable used to store the decoded secret key for encrypting and decrypting cookies. var secretcookie []byte -// GetCookie retrieves and decrypts the user cookie from the provided HTTP request and returns it as a UserCookie. -// Returns an error if the cookie retrieval, decryption, or decoding process fails. func GetCookie(r *http.Request) (UserCookie, error) { var err error @@ -83,7 +78,6 @@ func GetCookie(r *http.Request) (UserCookie, error) { } -// SetCookie sets an encrypted cookie with a user's email and token, using gob encoding for data serialization. func SetCookie(w http.ResponseWriter, email string, token string) error { // Initialize a User struct containing the data that we want to store in the // cookie. @@ -144,8 +138,6 @@ func SetCookie(w http.ResponseWriter, email string, token string) error { return nil } -// CookieWrite writes a secure HTTP cookie to the response writer after base64 encoding its value. -// Returns ErrValueTooLong if the cookie string exceeds the 4096-byte size limit. func CookieWrite(w http.ResponseWriter, cookie http.Cookie) error { // Encode the cookie value using base64. cookie.Value = base64.URLEncoding.EncodeToString([]byte(cookie.Value)) @@ -162,8 +154,6 @@ func CookieWrite(w http.ResponseWriter, cookie http.Cookie) error { return nil } -// CookieRead retrieves a base64-encoded cookie value by name from the HTTP request and decodes it. -// Returns the decoded value as a string or an error if the cookie is not found or the value is invalid. func CookieRead(r *http.Request, name string) (string, error) { // Read the cookie as normal. cookie, err := r.Cookie(name) @@ -183,9 +173,6 @@ func CookieRead(r *http.Request, name string) (string, error) { return string(value), nil } -// CookieWriteEncrypted encrypts the cookie's value using AES-GCM and writes it to the HTTP response writer. -// The cookie name is authenticated along with its value. -// It returns an error if encryption fails or the cookie exceeds the maximum allowed length. func CookieWriteEncrypted(w http.ResponseWriter, cookie http.Cookie, secretKey []byte) error { // Create a new AES cipher block from the secret key. block, err := aes.NewCipher(secretKey) @@ -226,8 +213,6 @@ func CookieWriteEncrypted(w http.ResponseWriter, cookie http.Cookie, secretKey [ return CookieWrite(w, cookie) } -// CookieReadEncrypted reads an encrypted cookie, decrypts its value using AES-GCM, and validates its name before returning. -// Returns the plaintext cookie value or an error if decryption or validation fails. func CookieReadEncrypted(r *http.Request, name string, secretKey []byte) (string, error) { // Read the encrypted value from the cookie as normal. encryptedValue, err := CookieRead(r, name) diff --git a/core.go b/core.go index 3c80602..df6254a 100644 --- a/core.go +++ b/core.go @@ -39,17 +39,13 @@ var basePath string var runMode string var disableEvents bool = false -// components_resources holds embedded file system data, typically for templates or other embedded resources. -// //go:embed all:template var components_resources embed.FS -// configContainer is a configuration structure that holds request-specific configurations for the application. type configContainer struct { Request RequestConfig } -// App is a struct representing the main application container and its core components. type App struct { t int // for tracking hooks chain *chain @@ -57,10 +53,8 @@ type App struct { Config *configContainer } -// app is a global instance of the App structure used to manage application configuration and lifecycle. var app *App -// New initializes and returns a new instance of the App structure with default configurations and chain. func New() *App { app = &App{ chain: &chain{}, @@ -72,29 +66,24 @@ func New() *App { return app } -// ResolveApp returns the global instance of the App, providing access to its methods and configuration components. func ResolveApp() *App { return app } -// SetLogsDriver sets the logging driver to be used by the application. func (app *App) SetLogsDriver(d logger.LogsDriver) { logsDriver = &d } -// Bootstrap initializes the application by setting up the logger, router, and events manager. func (app *App) Bootstrap() { loggr = logger.NewLogger(*logsDriver) NewRouter() NewEventsManager() } -// RegisterTemplates initializes the application template system by embedding provided templates for rendering views. func (app *App) RegisterTemplates(templates_resources embed.FS) { NewTemplates(components_resources, templates_resources) } -// Run initializes the application's router, configures HTTPS if enabled, and starts the HTTP/HTTPS server. func (app *App) Run(router *httprouter.Router) { portNumber := os.Getenv("App_HTTP_PORT") if portNumber == "" { @@ -167,9 +156,6 @@ func (app *App) Run(router *httprouter.Router) { log.Fatal(http.ListenAndServe(fmt.Sprintf(":%s", portNumber), router)) } -// RegisterRoutes sets up and registers HTTP routes and their handlers to the provided router, enabling request processing. -// It assigns appropriate methods, controllers, and hooks, while handling core services, errors, and fallback behaviors. -// Returns the configured router instance. func (app *App) RegisterRoutes(routes []Route, router *httprouter.Router) *httprouter.Router { router.PanicHandler = panicHandler router.NotFound = notFoundHandler{} @@ -208,7 +194,6 @@ func (app *App) RegisterRoutes(routes []Route, router *httprouter.Router) *httpr return router } -// makeHTTPRouterHandlerFunc creates an httprouter.Handle that handles HTTP requests with the specified controller and hooks. func (app *App) makeHTTPRouterHandlerFunc(h Controller, ms []Hook) httprouter.Handle { return func(w http.ResponseWriter, r *http.Request, ps httprouter.Params) { @@ -275,13 +260,9 @@ func (app *App) makeHTTPRouterHandlerFunc(h Controller, ms []Hook) httprouter.Ha } } -// notFoundHandler is a type that implements the http.Handler interface to handle HTTP 404 Not Found errors. type notFoundHandler struct{} - -// methodNotAllowed is a type that implements http.Handler to handle HTTP 405 Method Not Allowed errors. type methodNotAllowed struct{} -// ServeHTTP handles HTTP requests by responding with a 404 status code and a JSON-formatted "Not Found" message. func (n notFoundHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) { w.WriteHeader(http.StatusNotFound) res := "{\"message\": \"Not Found\"}" @@ -291,7 +272,6 @@ func (n notFoundHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) { w.Write([]byte(res)) } -// ServeHTTP handles HTTP requests with method not allowed status and logs the occurrence and stack trace. func (n methodNotAllowed) ServeHTTP(w http.ResponseWriter, r *http.Request) { w.WriteHeader(http.StatusMethodNotAllowed) res := "{\"message\": \"Method not allowed\"}" @@ -301,7 +281,6 @@ func (n methodNotAllowed) ServeHTTP(w http.ResponseWriter, r *http.Request) { w.Write([]byte(res)) } -// panicHandler handles panics during HTTP request processing, logs errors, and formats responses based on environment settings. var panicHandler = func(w http.ResponseWriter, r *http.Request, e interface{}) { isDebugModeStr := os.Getenv("APP_DEBUG_MODE") isDebugMode, err := strconv.ParseBool(isDebugModeStr) @@ -336,12 +315,10 @@ var panicHandler = func(w http.ResponseWriter, r *http.Request, e interface{}) { w.Write([]byte(res)) } -// UseHook registers a Hook middleware function by attaching it to the global Hooks instance. func UseHook(mw Hook) { ResolveHooks().Attach(mw) } -// Next advances to the next middleware or controller in the chain and invokes it with the given context if available. func (app *App) Next(c *Context) { app.t = app.t + 1 n := app.chain.getByIndex(app.t) @@ -358,17 +335,14 @@ func (app *App) Next(c *Context) { } } -// chain represents a sequence of nodes, where each node is an interface, used for executing a series of operations. type chain struct { nodes []interface{} } -// reset clears all nodes in the chain, resetting it to an empty state. func (cn *chain) reset() { cn.nodes = []interface{}{} } -// getByIndex retrieves an element from the chain's nodes slice by its index. Returns nil if the index is out of range. func (c *chain) getByIndex(i int) interface{} { for k := range c.nodes { if k == i { @@ -379,7 +353,6 @@ func (c *chain) getByIndex(i int) interface{} { return nil } -// prepareChain appends all hooks from the provided list and the application's Hooks to the chain's nodes. func (app *App) prepareChain(hs []interface{}) { mw := app.hooks.GetHooks() for _, v := range mw { @@ -390,7 +363,6 @@ func (app *App) prepareChain(hs []interface{}) { } } -// execute executes the first node in the chain, invoking it as either a Hook or Controller if applicable. func (cn *chain) execute(ctx *Context) { i := cn.getByIndex(0) if i != nil { @@ -406,7 +378,6 @@ func (cn *chain) execute(ctx *Context) { } } -// combHandlers combines a controller and a slice of hooks into a single slice of interfaces in reversed order. func (app *App) combHandlers(h Controller, mw []Hook) []interface{} { var rev []interface{} for _, k := range mw { @@ -416,8 +387,6 @@ func (app *App) combHandlers(h Controller, mw []Hook) []interface{} { return rev } -// getGormFunc returns a function that provides a *gorm.DB instance, ensuring gorm is enabled in the configuration. -// If gorm is not enabled, it panics with an appropriate message. func getGormFunc() func() *gorm.DB { f := func() *gorm.DB { if !gormC.EnableGorm { @@ -428,9 +397,6 @@ func getGormFunc() func() *gorm.DB { return f } -// NewGorm initializes and returns a new gorm.DB instance based on the selected database driver specified in environment variables. -// Supported drivers include MySQL, PostgreSQL, and SQLite. -// Panics if the database driver is not specified or if a connection error occurs. func NewGorm() *gorm.DB { var err error switch os.Getenv("DB_DRIVER") { @@ -455,7 +421,6 @@ func NewGorm() *gorm.DB { return db } -// ResolveGorm initializes and returns a singleton instance of *gorm.DB, creating it if it doesn't already exist. func ResolveGorm() *gorm.DB { if db != nil { return db @@ -464,8 +429,6 @@ func ResolveGorm() *gorm.DB { return db } -// resolveCache returns a function that provides a *Cache instance when invoked. -// Panics if caching is not enabled in the configuration. func resolveCache() func() *Cache { f := func() *Cache { if !cacheC.EnableCache { @@ -476,8 +439,6 @@ func resolveCache() func() *Cache { return f } -// postgresConnect establishes a connection to a PostgreSQL database using environment variables for configuration. -// It returns a pointer to a gorm.DB instance or an error if the connection fails. func postgresConnect() (*gorm.DB, error) { dsn := fmt.Sprintf("host=%v user=%v password=%v dbname=%v port=%v sslmode=%v TimeZone=%v", os.Getenv("POSTGRES_HOST"), @@ -491,8 +452,6 @@ func postgresConnect() (*gorm.DB, error) { return gorm.Open(postgres.Open(dsn), &gorm.Config{}) } -// mysqlConnect establishes a connection to a MySQL database using credentials and configurations from environment variables. -// Returns a *gorm.DB instance on success or an error if the connection fails. func mysqlConnect() (*gorm.DB, error) { dsn := fmt.Sprintf("%v:%v@tcp(%v:%v)/%v?charset=%v&parseTime=True&loc=Local", os.Getenv("MYSQL_USERNAME"), @@ -512,9 +471,6 @@ func mysqlConnect() (*gorm.DB, error) { }), &gorm.Config{}) } -// getJWT returns a function that initializes and provides a *JWT instance configured with environment variables. -// The JWT instance is created using a secret signing key and a lifespan derived from the environment. -// Panics if the signing key is not set or if the lifespan cannot be parsed. func getJWT() func() *JWT { f := func() *JWT { secret := os.Getenv("JWT_SECRET") @@ -538,7 +494,6 @@ func getJWT() func() *JWT { return f } -// getValidator returns a closure that instantiates and provides a new instance of Validator. func getValidator() func() *Validator { f := func() *Validator { return &Validator{} @@ -546,7 +501,6 @@ func getValidator() func() *Validator { return f } -// resloveHashing returns a function that initializes and provides a pointer to a new instance of the Hashing struct. func resloveHashing() func() *Hashing { f := func() *Hashing { return &Hashing{} @@ -554,7 +508,6 @@ func resloveHashing() func() *Hashing { return f } -// resolveMailer initializes and returns a function that provides a singleton Mailer instance based on the configured driver. func resolveMailer() func() *Mailer { f := func() *Mailer { if mailer != nil { @@ -583,7 +536,6 @@ func resolveMailer() func() *Mailer { return f } -// resolveEventsManager creates and returns a function that resolves the singleton instance of EventsManager. func resolveEventsManager() func() *EventsManager { f := func() *EventsManager { return ResolveEventsManager() @@ -591,7 +543,6 @@ func resolveEventsManager() func() *EventsManager { return f } -// resolveLogger returns a function that provides access to the initialized logger instance when invoked. func resolveLogger() func() *logger.Logger { f := func() *logger.Logger { return loggr @@ -599,7 +550,6 @@ func resolveLogger() func() *logger.Logger { return f } -// MakeDirs creates the specified directories under the base path with the provided permissions (0766). func (app *App) MakeDirs(dirs ...string) { o := syscall.Umask(0) defer syscall.Umask(o) @@ -608,37 +558,30 @@ func (app *App) MakeDirs(dirs ...string) { } } -// SetRequestConfig sets the configuration for the request in the application instance. func (app *App) SetRequestConfig(r RequestConfig) { requestC = r } -// SetGormConfig sets the GormConfig for the application, overriding the current configuration with the provided value. func (app *App) SetGormConfig(g GormConfig) { gormC = g } -// SetCacheConfig sets the cache configuration for the application using the provided CacheConfig parameter. func (app *App) SetCacheConfig(c CacheConfig) { cacheC = c } -// SetBasePath sets the base path for the application, which is used as a prefix for file and directory operations. func (app *App) SetBasePath(path string) { basePath = path } -// SetRunMode sets the application run mode to the specified value. func (app *App) SetRunMode(runmode string) { runMode = runmode } -// DisableEvents sets the global variable `disableEvents` to true, disabling the handling or triggering of events. func DisableEvents() { disableEvents = true } -// EnableEvents sets the global variable `disableEvents` to false, effectively enabling event handling. func EnableEvents() { disableEvents = false } diff --git a/queue.go b/queue.go index 905a6ed..8725844 100644 --- a/queue.go +++ b/queue.go @@ -27,9 +27,6 @@ func (q *Queuemux) AddWork(pattern string, work Asynqtask) { q.themux.HandleFunc(pattern, work) } -// RunQueueserver starts the queue server with predefined configurations and handles tasks using the assigned ServeMux. -// Configures the queue server with concurrency limits and priority-based queue management. -// Logs and terminates the program if the server fails to run. func (q *Queuemux) RunQueueserver() { redisAddr := fmt.Sprintf("%v:%v", os.Getenv("REDIS_HOST"), os.Getenv("REDIS_PORT")) diff --git a/response.go b/response.go index 46f31ee..2b1047b 100644 --- a/response.go +++ b/response.go @@ -11,7 +11,6 @@ import ( "net/http" ) -// Response represents an HTTP response to be sent to the client, including headers, body, status code, and metadata. type Response struct { headers []header body []byte @@ -23,13 +22,12 @@ type Response struct { HttpResponseWriter http.ResponseWriter } -// header represents a single HTTP header with a key-value pair. type header struct { key string val string } -// writes the contents of a buffer to the HTTP response with specified file name and type if not terminated. +// TODO add doc func (rs *Response) BufferFile(name string, filetype string, b bytes.Buffer) *Response { if rs.isTerminated == false { @@ -40,7 +38,7 @@ func (rs *Response) BufferFile(name string, filetype string, b bytes.Buffer) *Re return rs } -// sets the response's content type to HTML and assigns the provided body as the response body if not terminated. +// TODO add doc func (rs *Response) Any(body any) *Response { if rs.isTerminated == false { rs.contentType = CONTENT_TYPE_HTML @@ -50,7 +48,7 @@ func (rs *Response) Any(body any) *Response { return rs } -// sets the response's content type to JSON and assigns the provided string as the body if the response is not terminated. +// TODO add doc func (rs *Response) Json(body string) *Response { if rs.isTerminated == false { rs.contentType = CONTENT_TYPE_JSON @@ -59,7 +57,7 @@ func (rs *Response) Json(body string) *Response { return rs } -// sets the response's content type to plain text and assigns the provided string as the body if not terminated. +// TODO add doc func (rs *Response) Text(body string) *Response { if rs.isTerminated == false { rs.contentType = CONTENT_TYPE_TEXT @@ -68,7 +66,7 @@ func (rs *Response) Text(body string) *Response { return rs } -// sets the response's content type to HTML and assigns the provided string as the body if the response is not terminated. +// TODO add doc func (rs *Response) HTML(body string) *Response { if rs.isTerminated == false { rs.contentType = CONTENT_TYPE_HTML @@ -77,7 +75,7 @@ func (rs *Response) HTML(body string) *Response { return rs } -// renders the specified template with the provided data and writes the result to the HTTP response if not terminated. +// TODO add doc func (rs *Response) Template(name string, data interface{}) *Response { var buffer bytes.Buffer if rs.isTerminated == false { @@ -91,7 +89,7 @@ func (rs *Response) Template(name string, data interface{}) *Response { return rs } -// sets the response status code if the response is not yet terminated. Returns the updated Response object. +// TODO add doc func (rs *Response) SetStatusCode(code int) *Response { if rs.isTerminated == false { rs.statusCode = code @@ -100,7 +98,7 @@ func (rs *Response) SetStatusCode(code int) *Response { return rs } -// sets a custom content type for the response if it is not terminated. Returns the updated Response object. +// TODO add doc func (rs *Response) SetContentType(c string) *Response { if rs.isTerminated == false { rs.overrideContentType = c @@ -109,7 +107,7 @@ func (rs *Response) SetContentType(c string) *Response { return rs } -// adds or updates a header to the response if it is not terminated. Returns the updated Response object. +// TODO add doc func (rs *Response) SetHeader(key string, val string) *Response { if rs.isTerminated == false { h := header{ @@ -121,12 +119,10 @@ func (rs *Response) SetHeader(key string, val string) *Response { return rs } -// terminates the response processing, preventing any further modifications or actions. func (rs *Response) ForceSendResponse() { rs.isTerminated = true } -// updates the redirect URL for the response and returns the modified Response. Validates the URL before setting it. func (rs *Response) Redirect(url string) *Response { validator := resolveValidator() v := validator.Validate(map[string]interface{}{ @@ -146,7 +142,6 @@ func (rs *Response) Redirect(url string) *Response { return rs } -// converts various primitive data types to their string representation or triggers a panic for unsupported types. func (rs *Response) castBasicVarsToString(data interface{}) string { switch dataType := data.(type) { case string: @@ -204,7 +199,6 @@ func (rs *Response) castBasicVarsToString(data interface{}) string { } } -// reinitializes the Response object to its default state, clearing its body, headers, and resetting other properties. func (rs *Response) reset() { rs.body = nil rs.statusCode = http.StatusOK diff --git a/router.go b/router.go index 163f22a..24141b4 100644 --- a/router.go +++ b/router.go @@ -5,7 +5,6 @@ package core -// Route defines an HTTP route with a method, path, controller function, and optional hooks for customization. type Route struct { Method string Path string @@ -13,15 +12,12 @@ type Route struct { Hooks []Hook } -// Router represents a structure for storing and managing routes in the application. type Router struct { Routes []Route } -// router is a global instance of the Router struct used to manage and resolve application routes. var router *Router -// NewRouter initializes and returns a new Router instance with an empty slice of routes. func NewRouter() *Router { router = &Router{ []Route{}, @@ -29,12 +25,10 @@ func NewRouter() *Router { return router } -// ResolveRouter returns the singleton instance of the Router. It initializes and manages HTTP routes configuration. func ResolveRouter() *Router { return router } -// Get registers a GET route with the specified path, controller, and optional hooks, returning the updated Router. func (r *Router) Get(path string, controller Controller, hooks ...Hook) *Router { r.Routes = append(r.Routes, Route{ Method: GET, @@ -45,7 +39,6 @@ func (r *Router) Get(path string, controller Controller, hooks ...Hook) *Router return r } -// Post registers a route with the HTTP POST method, associating it with the given path, controller, and optional hooks. func (r *Router) Post(path string, controller Controller, hooks ...Hook) *Router { r.Routes = append(r.Routes, Route{ Method: POST, @@ -56,7 +49,6 @@ func (r *Router) Post(path string, controller Controller, hooks ...Hook) *Router return r } -// Delete registers a DELETE HTTP method route with the specified path, controller, and optional hooks. func (r *Router) Delete(path string, controller Controller, hooks ...Hook) *Router { r.Routes = append(r.Routes, Route{ Method: DELETE, @@ -67,7 +59,6 @@ func (r *Router) Delete(path string, controller Controller, hooks ...Hook) *Rout return r } -// Patch registers a new route with the HTTP PATCH method, a specified path, a controller, and optional hooks. func (r *Router) Patch(path string, controller Controller, hooks ...Hook) *Router { r.Routes = append(r.Routes, Route{ Method: PATCH, @@ -78,7 +69,6 @@ func (r *Router) Patch(path string, controller Controller, hooks ...Hook) *Route return r } -// Put registers a new route with the HTTP PUT method, associating it to the given path, controller, and optional hooks. func (r *Router) Put(path string, controller Controller, hooks ...Hook) *Router { r.Routes = append(r.Routes, Route{ Method: PUT, @@ -89,7 +79,6 @@ func (r *Router) Put(path string, controller Controller, hooks ...Hook) *Router return r } -// Options registers a new route with the OPTIONS HTTP method, a specified path, controller, and optional hooks. func (r *Router) Options(path string, controller Controller, hooks ...Hook) *Router { r.Routes = append(r.Routes, Route{ Method: OPTIONS, @@ -100,7 +89,6 @@ func (r *Router) Options(path string, controller Controller, hooks ...Hook) *Rou return r } -// Head registers a route with the HTTP HEAD method, associates it with a path, controller, and optional hooks. func (r *Router) Head(path string, controller Controller, hooks ...Hook) *Router { r.Routes = append(r.Routes, Route{ Method: HEAD, @@ -111,7 +99,6 @@ func (r *Router) Head(path string, controller Controller, hooks ...Hook) *Router return r } -// GetRoutes returns a slice of Route objects currently registered within the Router. func (r *Router) GetRoutes() []Route { return r.Routes }