Personal multilang page written in Vue3, Sass, packaged with Vite, CI workflow

Brayan Narváez — Mon, 13 Jun 2022 13:46:41 +0000

bnarvaez-dev

Personal webpage written in Vue 3, Sass and packaged with Vite.
Unit tests in Vite 3
CI Workflow

You can use for your own page!

✅ Install and Run

First clone the repo

git clone https://github.com/prinick96/bnarvaez.dev.git

Install dependencies

npm install

Just run in local

npm run serve

Or with Docker 🐳

make docker-up

✅ Tests

All test are located in /src/test

Run

npm test

✅ Notes

I am using Netlify for deploy, i recommend optimize all images and minify the html if you don't use Netlify with plugins

Hexagonal Architecture in Go

Brayan Narváez — Fri, 03 Jun 2022 14:09:38 +0000

Hello everyone i recenlty written a TODO System with Hexagonal Architecture written in Go, with test and uses cases examples, docker ready, heroku ready, basic CI integration and you can use it how template for your projects.

I appreciate feedback!

Github Repo

✔️ A TODO System with hexagonal architecture / clean architecture what you can use how template for your projects

✔️ Includes a simple CI.yml that you can use to get started with continuous integration in Github Actions

✔️ DB and Tests Implemented with CockRoachDB but you can run with another, for example MySQL

✔️ It have use cases and test examples for that use cases

✔️ Unit tests models and integration test models

✔️ API REST with Echo MicroFramework

✔️ Simple error logs system

✔️ Docker and Heroku ready

✅ Install

First clone the repo

git clone https://github.com/prinick96/hex-arch-go.git

⚠️ Now, the system need connect to a database, by default you can use Postgres or CockroachDB

Just create a database
Upload the schema on your DB

/db/schema.sql

Change the enverioment variables located in .env.development

DB_ENGINE = "postgres or mysql"
DB_HOST = "host"
DB_PORT = 1234
DB_DATABASE = "db name"
DB_USERNAME = "user name"
DB_PASSWORD = "your secret password"

# For cockroach
DB_OPTIONS = "--cluster=cockroach-cluser-id"

# For postgres
DB_OPTIONS = "sslmode=disable timezone=UTC connect_timeout=5"

# For mysql
DB_OPTIONS = ""

✅ Run

If you want run in local, simply

go get
go run main.go

If you want run with Docker, simply

make docker-up

If you want run with Heroku local, simply

# For Linux/MacOS
make heroku-run

# For Windows
heroku-run-win

⚠️ If you use Windows, you need change Procfile in the root of project for

# For windows use 
web: bin\hex-arch-go.exe
# web: bin/hex-arch-go

And now you can run Heroku local for Windows

✅ Test

For unit tests, simply

make unit-test

⚠️For integration tests, first need configure the .env.test vars adding the database test connection, after, simply

make integration-test

Or both of them

make test

🌳 Understanding the folder structure

.
├── /.github/workflows       # Github Actions!
├── /cmd                     # Start the application with server and database
├── /core                    # The CORE of hexagonal architecture: infrastructure, application and domain
│   ├── /application         # Handlers and the entry point of data
│   ├── /entities            # The entities what conform the domain
│   └── /infrastructure      # Gateways for the domain logic and Storage/Repository for the implementation of database
├── /db                      # Simply the schema of DB for you first run
├── /env                     # .env loader
├── /internal                # Elemental logic common for all the system
│   ├── /database            # Connection with database implemented
│   └── /helpers             # Reusable functions around the app, like a UUID generation
│       └── tests            # Unit tests for helpers 
└── /server                  # The server listener and endpoints of API REST

Forem: Brayan Narváez