Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/j4ng5y/hnsecrets


https://github.com/j4ng5y/hnsecrets

Last synced: 14 days ago
JSON representation

Awesome Lists containing this project

README

        

# HNSECRETS

## Development Prereqs

* Go: The language this app is written in - https://golang.org/dl
* Git is a requirement of Go (to use `go get`)
* Protoc: The Protocol Buffers compiler - https://github.com/protocolbuffers/protobuf/releases/latest
* Install the grpc tooling: `go get google.golang.org/protobuf/cmd/protoc-gen-go google.golang.org/grpc/cmd/protoc-gen-go-grpc`
* make: The build tool to build this app
* debian based systems: `apt-get install -y make`
* rhel based systems: `yum install -y make` or `dnf install -y make`
* macos: `brew install make`
* windows: :shrug: - chocolatty maybe?
* docker/moby-engine/podman/etc...: A container runtime

## Building

To build this project, perform the following:

**Building/Running Locally**

1. clone this repository
2. `cd hnsecrets`
3. `make && make run`

This set of commands will generate the API code, test all the code, and build the binaries locally (in the respetive `svcs//bin` directory) and then runs the binaries for local testing.

**Building/Deploying Containers**

1. clone this repository
2. `cd hnsecrets`
3. `docker login`
4. `make test && make build && make deploy`

This set of commands will generate the API code, test all the code, build the containers, and deploy the containers to the `j4ng5y/hnsecrets` dockerhub repository.

**Checking test coverage**

To check the current test coverage, simply run `make test && make coverage`. This will open the HTML test coverage reports for both services.