Cup of Goffee

What is Goffee?

Cup is a skeleton project for the Goffee Go framework made for building web APIs, suitable for small, medium size and microservices projects. With it's simple structure, and developer friendly experience it helps with increasing the productivity.

Main Features

• Routing
• Middlewares
• Data Validation
• Databases ORM (GORM integrated)
• Emails
• JWT tokens
• Cache (Redis)
• HTTPS (TLS)

Installation

To create a new cup project you need to install the Goffee's cli first

Install Goffee [cli] tool

To install the goffee globally open up your terminal and run the following command:

go install git.smarteching.com/goffee/goffee@latest

Create new project using a Cup of Goffee

Here is how you can create new Goffee projects

goffee new [project-name] [project-remote-repository]

Example

goffee new myapp git.smarteching.com/goffee/myapp

where: project-name is the name of your project remote-repository is the remote repository that will host the project.

Getting started

First make sure you have Goffee installed, then use it to create a new project, here is how

Let's create a route that returns hello world

Open up the file routes.go in the root directory of your project and add the following code:

	router.Get("/greeting", func(c *core.Context) *core.Response {
		JsonString := `{"message": "hello world"}`

		return c.Response.Json(JsonString)
	})

Next, in your terminal navigate to the project dir and run the following command to start the live reloading:

goffee run:dev

Finally, open up your browser and navigate to http://localhost/greeting

To learn more check the routing docs section

Architecture

The architecture is similar to MVC, where there is a routes file ./routes.go in which you can map all your app routes to their controllers which resides in the directory ./controllers. Controllers are simply methods that handles requests (GET, POST, ... etch) to the given routes.

The request journey:

The first component that receive's the request in Cup is the Router, then Goffee locates the matching handler of the request and it check's if there are any middlewares to be executed either before or after the handler, if so, it executes them in the right order, then at the final stage it returns the response to the user. Request -> Router -> Optional Middlewares -> Handler -> Optional Middlewares -> Response

Folder structure

├── cup
│   ├── config/ --------------------------> main configs
│   ├── events/ --------------------------> contains events
│   │   ├── jobs/ ------------------------> contains the event jobs
│   ├── controllers/ ------------------------> route's controllers
│   ├── logs/ ----------------------------> app log files
│   ├── hooks/ ---------------------> app hooks
│   ├── models/ --------------------------> database models
│   ├── storage/ -------------------------> a place to store files
│   ├── tls/ -----------------------------> tls certificates
│   ├── .env -----------------------------> environment variables 
│   ├── .gitignore -----------------------> .gitignore
│   ├── go.mod ---------------------------> Go modules
│   ├── LICENSE --------------------------> license
│   ├── main.go --------------------------> go main file
│   ├── README.md ------------------------> readme file
│   ├── register-events.go ---------------> register events and jobs
│   ├── register-global-hooks.go ---> register global middlewares
│   ├── routes.go ------------------------> app routes
│   ├── run-auto-migrations.go -----------> database migrations