Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dynastymasra/privy
Simple Go apps
https://github.com/dynastymasra/privy
Last synced: about 1 month ago
JSON representation
Simple Go apps
- Host: GitHub
- URL: https://github.com/dynastymasra/privy
- Owner: dynastymasra
- Created: 2019-11-04T05:24:22.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2019-11-05T01:32:33.000Z (about 5 years ago)
- Last Synced: 2023-03-14T08:10:26.955Z (almost 2 years ago)
- Language: Go
- Size: 91.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Privy
[](https://golang.org/)
[](https://www.docker.com/)
[](https://www.postgresql.org/)
Simple Golang CRUD service with Postgres
## Architecture
This project try to implement [Clean Architecture](https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html)
and the Apps architecture can use [Kong](https://konghq.com/kong/) for API Gateway and can use [Kong Authentication](https://docs.konghq.com/hub/)
for authentication mechanism.
## Libraries
Use [Go Module](https://blog.golang.org/using-go-modules) for install all dependencies required this application.
## How To Run and Deploy
Before run this service. Make sure all requirements dependencies has been installed likes **Golang, Docker, and Postgres**
### Local
Use command go ```go run main.go``` in root folder for run this application.
- ```go run main.go migrate:run``` Command to run database migration
- ```go run main.go migrate:rollback``` Command to rollback database migration
- ```go run main.go migrate:seed``` Command to add data to database
- ```go run main.go migrate:create``` Command to create database migration file
### Docker
**privy** uses docker multi stages build, minimal docker version is **17.05**. If docker already installed use command.
This command will build the images.
```bash
docker build -f Dockerfile -t $(IMAGE):$(VERSION) .
```
Run this command for database migration
```bash
docker-compose run --rm $(NAME) migrate:run
```
To run service use this command
```bash
docker run --name privy -d -e ADDRESS=:8080 -e $(IMAGE):$(VERSION)
```
### Shell Script
Make sure *docker-compose* already installed. to run this script.
Use this command for the first time. this script will run docker compose and run the database migration.
```bash
./start.sh run
```
Use this command to run application without database migration. Need to run ```./start.sh run``` before use this command
```bash
./start.sh up
```
## Test
For run unit test, from root project you can go to folder or package and execute command
```bash
go test -v -cover -coverprofile=coverage.out -covermode=set
go tool cover -html=coverage.out
```
`go tool` will generate GUI for test coverage. Available package or folder can be tested
- `/infrastructure/database/postgres`
- `/delivery/http/handler/**`
- `/product`
- `/category`
- `/product`
- `/image`
## API Documentation
This service documentation uses [](https://app.getpostman.com/run-collection/191fd3b11819d6d6aa25)
## Environment Variables
+ `SERVER_ADDRESS` - Address application is used default is `:8080`
+ `LOGGER_FORMAT` - Format specific for log, default value is `text`
- `text` - Log format will become standard text output, this used for development
- `json` - Log format will become *JSON* format, usually used for production
+ `LOG_LEVEL` - Log level default is `debug`
+ `DATABASE_HOST` - Database hostname
+ `DATABASE_PORT` - Database port
+ `DATABASE_NAME` - Database name
+ `DATABASE_USERNAME` - Database username
+ `DATABASE_PASSWORD` - Database Password
+ `DATABASE_ENABLE_LOG` - Database log enabled, value `true` or `false`
+ `DATABASE_MAX_OPEN_CONN` - Database max open connection
+ `DATABASE_MAX_IDLE_CONN` - Database max idle connection