jokes-bapak2/api/README.md

70 lines
2.2 KiB
Markdown
Raw Normal View History

2021-05-02 07:49:13 +00:00
# Jokes Bapak2 API
Still work in progress
2021-05-02 07:58:37 +00:00
## Development
```bash
# Install modules
2021-07-09 12:13:19 +00:00
$ go mod download
2021-05-02 07:58:37 +00:00
# or
$ go mod vendor
# run the local server
2021-07-09 12:13:19 +00:00
$ go run main.go
2021-05-02 07:58:37 +00:00
# build everything
2021-07-09 12:13:19 +00:00
$ go build main.go
2021-05-02 07:58:37 +00:00
```
2021-05-02 07:49:13 +00:00
2021-07-09 12:13:19 +00:00
## Used packages
2021-05-02 07:49:13 +00:00
2021-07-09 12:13:19 +00:00
| Name | Version | Type |
| --- | --- | --- |
2021-07-09 12:22:56 +00:00
| [gofiber/fiber](https://github.com/gofiber/fiber) | `v2.14.0` | Framework |
| [jackc/pgx](https://github.com/jackc/pgx) | `v4.11.0` | Database |
| [go-redis/redis](https://github.com/go-redis/redis) | `v8.11.0` | Cache |
| [patrickmn/go-cache](https://github.com/patrickmn/go-cache) | `v2.1.0+incompatible` | Cache |
2021-07-09 12:22:56 +00:00
| [joho/godotenv](https://github.com/joho/godotenv) | `v1.3.0` | Config |
| [getsentry/sentry-go](https://github.com/getsentry/sentry-go) | `v0.11.0` | Logging |
| [aldy505/phc-crypto](https://github.com/aldy505/phc-crypto) | `v1.1.0` | Utils |
| [Masterminds/squirrel](https://github.com/Masterminds/squirrel ) | `v1.5.0` | Utils |
| [aldy505/bob](https://github.com/aldy505/bob) | `v0.0.1` | Utils |
| [gojek/heimdall](https://github.com/gojek/heimdall) | `v7.0.2` | Utils |
| [georgysavva/scany](https://github.com/georgysavva/scany) | `v0.2.9` | Utils |
| [stretchr/testify](https://github.com/stretchr/testify) | `v1.5.1` | Tests |
2021-07-09 12:13:19 +00:00
## Directory structure
```
2021-07-15 12:44:07 +00:00
.
├── app
│ └── v1
│ ├── app.go - v1 application entry point
│ ├── core - Pure business logic
2021-07-15 12:44:07 +00:00
│ ├── handler - Route handler
│ ├── middleware - App middleware handler
│ ├── models - Output and input schema
│ ├── platform
│ │ ├── cache - In-memory cache setup functions
│ │ └── database - Database setup functions
│ ├── routes - Routes definition & assignment
│ └── utils - Utility functions
├── Dockerfile - Docker image for API
├── go.mod - Module information & dependencies
├── go.sum - Packages lock file
├── main.go - Application entry point
└── README.md - You are here
2021-07-09 12:13:19 +00:00
```
2021-07-15 12:44:07 +00:00
2021-07-09 12:13:19 +00:00
## `.env` configuration
```ini
ENV=development
PORT=5000
DATABASE_URL=postgres://postgres:password@localhost:5432/jokesbapak2
REDIS_URL=redis://@localhost:6379
SENTRY_DSN=
```