Pre-Requisites

Install the latest stable version of Node and Go version 1.17 or higher, and then install the below Go programs. Ensure the GOPATH bin directory is added to your PATH.

$ go install github.com/golang/mock/mockgen@latest
$ go install github.com/google/wire/cmd/wire@latest

Build

Build the user interface:

$ pushd web
$ npm install
$ npm run build
$ popd

Build the server and command line tools:

$ go generate ./...
$ go build -o release/scm-app

Test

Execute the unit tests:

$ go generate ./...
$ go test -v -cover ./...

Run

This project supports all operating systems and architectures supported by Go. This means you can build and run the system on your machine; docker containers are not required for local development and testing.

Start the server at localhost:3000

$ release/scm-app server

User Interface

This project includes a simple user interface for interacting with the system. When you run the application, you can access the user interface by navigating to http://localhost:3000 in your browser.

Swagger

This project includes a swagger specification. When you run the application, you can access the swagger specification by navigating to http://localhost:3000/swagger in your browser.

Command Line

This project includes simple command line tools for interacting with the system. Please remember that you must start the server before you can execute commands.

Register a new user:

$ release/scm-app register

Login to the application:

$ release/scm-app login

Logout from the application:

$ release/scm-app logout

View your account details:

$ release/scm-app account

Generate a peronsal access token:

$ release/scm-app token

Create a pipeline:

$ release/scm-app pipeline create <name>

List pipelines:

$ release/scm-app pipeline ls

Debug and output http responses from the server:

$ DEBUG=true release/scm-app pipeline ls

View all commands:

$ release/scm-app --help