[TT-1842] [TT-1608] Parrot Server

.github/workflows/docker-test.yaml

@@ -46,7 +46,7 @@ jobs:
           go test -timeout 20m -json -parallel 2 -cover -covermode=atomic -coverprofile=unit-test-coverage.out $(go list ./... | grep /docker/test_env) -run '${{ matrix.test.tests }}' 2>&1 | tee /tmp/gotest.log | ../gotestloghelper -ci
       - name: Publish Artifacts
         if: failure()
-        uses: actions/upload-artifact@b4b15b8c7c6ac21ea08fcf65892d2ee8f75cf882 # v4.4.3
+        uses: actions/upload-artifact@v4
         with:
           name: test-logs
           path: ./lib/logs

.github/workflows/framework-golden-tests.yml

@@ -22,7 +22,7 @@ jobs:
             config: smoke.toml
             count: 1
             timeout: 10m
-          - name: TestSmoke
+          - name: TestSmokeLimitedResources
             config: smoke_limited_resources.toml
             count: 1
             timeout: 10m
@@ -81,9 +81,9 @@ jobs:
               - 'framework/**'
               - '.github/workflows/framework-golden-tests.yml'
       - name: Set up Go
-        uses: actions/setup-go@v4
+        uses: actions/setup-go@v5
         with:
-          go-version: 1.22.8
+          go-version: 1.23
       - name: Cache Go modules
         uses: actions/cache@v3
         with:
@@ -104,7 +104,7 @@ jobs:
           go test -timeout ${{ matrix.test.timeout }} -v -count ${{ matrix.test.count }} -run ${{ matrix.test.name }}
       - name: Upload Logs
         if: always()
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: container-logs-${{ matrix.test.name }}
           path: framework/examples/myproject/logs

.github/workflows/framework.yml

@@ -36,9 +36,9 @@ jobs:
             src:
               - 'framework/**'
       - name: Set up Go
-        uses: actions/setup-go@v4
+        uses: actions/setup-go@v5
         with:
-          go-version: 1.22.8
+          go-version: 1.23
       - name: Cache Go modules
         uses: actions/cache@v4
         with:

.github/workflows/generate-go-docs.yaml

@@ -111,7 +111,7 @@
         shell: bash
         env:
           OPENAI_API_KEY: ${{ secrets.OPENAI_DOC_GEN_API_KEY }}
         run: |
           # Add go binary to PATH
           PATH=$PATH:$(go env GOPATH)/bin
           export PATH
@@ -123,7 +123,7 @@
           rm filtered_folders.json
 
       - name: Upload costs as artifact
-        uses: actions/upload-artifact@b4b15b8c7c6ac21ea08fcf65892d2ee8f75cf882 # v4.4.3
+        uses: actions/upload-artifact@v4
         with:
           name: generation-costs
           path: ./costs

.github/workflows/k8s-e2e.yaml

@@ -98,7 +98,7 @@ jobs:
           QA_AWS_ROLE_TO_ASSUME: ${{ secrets.QA_AWS_ROLE_TO_ASSUME }}
           run_setup: false
       - name: Upload test log
-        uses: actions/upload-artifact@b4b15b8c7c6ac21ea08fcf65892d2ee8f75cf882 # v4.4.3
+        uses: actions/upload-artifact@v4
         if: failure()
         with:
           name: test-log
@@ -146,7 +146,7 @@ jobs:
           QA_KUBECONFIG: ${{ secrets.QA_KUBECONFIG }}
           run_setup: false
       - name: Upload test log
-        uses: actions/upload-artifact@b4b15b8c7c6ac21ea08fcf65892d2ee8f75cf882 # v4.4.3
+        uses: actions/upload-artifact@v4
         if: failure()
         with:
           name: remote-runner-test-log

.github/workflows/lint.yaml

@@ -76,6 +76,8 @@ jobs:
             path: ./tools/asciitable/
           - name: workflowresultparser
             path: ./tools/workflowresultparser/
+          - name: parrot
+            path: ./parrot/
     steps:
       - name: Check out Code
         uses: actions/checkout@eef61447b9ff4aafe5dcd4e0bbf5d482be7e7871 # v4.2.1
@@ -98,7 +100,7 @@ jobs:
         run: test -f ${{ matrix.project.path }}golangci-lint-report.xml || true
       - name: Store lint report artifact
         if: always()
-        uses: actions/upload-artifact@b4b15b8c7c6ac21ea08fcf65892d2ee8f75cf882 # v4.4.3
+        uses: actions/upload-artifact@v4
         with:
           name: golangci-lint-report-${{ matrix.project.name }}
           path: ${{ matrix.project.path }}golangci-lint-report.xml

.github/workflows/parrot-release.yml

@@ -0,0 +1,44 @@
+name: Parrotserver Release
+
+on:
+  push:
+    tags:
+      - parrot/v*
+
+jobs:
+  release:
+    name: Build and Release
+    runs-on: ubuntu-latest
+    environment: integration
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@eef61447b9ff4aafe5dcd4e0bbf5d482be7e7871 # v4.2.1
+        with:
+          fetch-depth: 0
+      - name: Configure AWS Credentials
+        uses: aws-actions/configure-aws-credentials@e3dd6a429d7300a6a4c196c26e071d42e0343502 # v4.0.2
+        with:
+          aws-region: ${{ secrets.QA_AWS_REGION }}
+          role-to-assume: ${{ secrets.QA_AWS_ROLE_TO_ASSUME }}
+          role-duration-seconds: 600
+      - name: Login to Amazon ECR
+        uses: aws-actions/amazon-ecr-login@062b18b96a7aff071d4dc91bc00c4c1a7945b076 # v2.0.1
+        with:
+          mask-password: 'true'
+        env:
+          AWS_REGION: ${{ secrets.QA_AWS_REGION }}
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: stable
+      - name: Goreleaser Release
+        uses: goreleaser/goreleaser-action@v6
+        with:
+          distribution: goreleaser-pro
+          version: "~> v2"
+          args: release --clean -f ./parrot/.goreleaser.yml
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GORELEASER_KEY: ${{ secrets.GORELEASER_KEY }}
+          IMAGE_PREFIX: ${{ secrets.QA_AWS_ACCOUNT_NUMBER }}.dkr.ecr.${{ secrets.QA_AWS_REGION }}.amazonaws.com/parrot
+          IMAGE_TAG: ${{ github.ref_name}}

.github/workflows/rc-breaking-changes.yaml

@@ -16,10 +16,10 @@ jobs:
         with:
           fetch-depth: 0
           fetch-tags: true
-      - name: Set up Go 1.23.3
+      - name: Set up Go
         uses: actions/setup-go@v5
         with:
-          go-version: '1.23.3'
+          go-version: 1.23
       - name: Install gorelease tool
         run: |
           go install golang.org/x/exp/cmd/gorelease@latest

.github/workflows/release-go-module.yml

@@ -40,7 +40,7 @@
           echo "VERSION=$VERSION" >> "$GITHUB_ENV"
       - name: Find Last Tag for Package and Generate Release Notes
         id: generate_release_notes
         run: |
           # Find the latest tag for the same package that is not the current tag
           LAST_TAG=$(git describe --abbrev=0 --always --match "$PACKAGE_NAME/v*" --tags $(git rev-list --tags --skip=1 --max-count=1))
           echo "Last tag: ${LAST_TAG}"
@@ -69,14 +69,14 @@
       - name: Set up Go
         uses: actions/setup-go@v5
         with:
-          go-version: '1.23.3'
+          go-version: 1.23
       - name: Install gorelease tool
         run: |
           go install golang.org/x/exp/cmd/gorelease@latest
       - name: Run gorelease to check for breaking changes
         working-directory: ${{ env.PACKAGE_NAME }}
         id: check_breaking_changes
         run: |
           set +e  # Disable exit on error to capture output even if the command fails
           echo "Last tag version: ${{ env.LAST_TAG_VERSION }}"
           echo "Current tag version: ${VERSION}"
@@ -90,7 +90,7 @@
         if: always()
         working-directory: ${{ env.PACKAGE_NAME }}
         id: read_additional_notes
         run: |
           # Check if the .changeset directory exists and the file for the current version is present
           if [ -f ".changeset/${{ env.VERSION }}.md" ]; then
             # Read the content of the file
@@ -127,7 +127,7 @@
             echo "CMD_ENTRYPOINT_EXISTS=false" >> "$GITHUB_ENV"
           fi
       - name: Set binary name based on PACKAGE_NAME
         run: |
           if [ "${{ env.PACKAGE_NAME }}" == "framework" ]; then
             echo "BINARY_NAME=ctf" >> $GITHUB_ENV
           else

.github/workflows/test.yaml

@@ -26,6 +26,8 @@ jobs:
             path: ./tools/flakeguard/            
           - name: workflowresultparser
             path: ./tools/workflowresultparser/
+          - name: parrot
+            path: ./parrot/
     runs-on: ubuntu-latest
     name: ${{ matrix.project.name }} unit tests
     steps:
@@ -52,7 +54,7 @@ jobs:
             make test_unit"
       - name: Publish Artifacts
         if: failure()
-        uses: actions/upload-artifact@b4b15b8c7c6ac21ea08fcf65892d2ee8f75cf882 # v4.4.3
+        uses: actions/upload-artifact@v4
         with:
           name: test-logs
           path: /tmp/gotest.log

.gitignore

@@ -77,4 +77,9 @@ __debug*
 .tool-versions
 
 import_keys_test.go
-tag.py
+tag.py
+
+parrot/*.json
+parrot/*.log
+# Executable
+parrot/parrot

parrot/.dockerignore

@@ -0,0 +1,13 @@
+Dockerfile
+*.md
+*.log
+.gitignore
+.golangci-lint.yml
+.goreleaser.yml
+.pre-commit-config.yaml
+*_test.go
+LICENSE
+.vscode/
+dist/
+.github/
+save.json

parrot/.goreleaser.yaml

@@ -0,0 +1,59 @@
+# yaml-language-server: $schema=https://goreleaser.com/static/schema-pro.json
+version: 2
+project_name: parrot
+
+monorepo:
+  tag_prefix: parrot/
+  dir: parrot
+
+env:
+  - IMG_PRE={{ if index .Env "IMAGE_PREFIX"  }}{{ .Env.IMAGE_PREFIX }}{{ else }}local{{ end }}
+  - TAG={{ if index .Env "IMAGE_TAG" }}{{ .Env.IMAGE_TAG }}{{ else }}latest{{ end }}
+
+# Build settings for binaries
+builds:
+  - id: parrot
+    main: ./cmd/main.go
+    goos:
+      - linux
+      - darwin
+    goarch:
+      - amd64
+      - arm64
+    ldflags:
+      - '-s -w'
+
+archives:
+  - formats: ['binary']
+
+dockers:
+  - id: linux-amd64-parrot
+    goos: linux
+    goarch: amd64
+    image_templates:
+      - '{{ .Env.IMG_PRE }}/parrot:{{ .Tag }}'
+      - '{{ .Env.IMG_PRE }}/parrot:latest'
+    build_flag_templates:
+      - --platform=linux/amd64
+      - --pull
+      - --label=org.opencontainers.image.created={{.Date}}
+      - --label=org.opencontainers.image.title={{.ProjectName}}
+      - --label=org.opencontainers.image.revision={{.FullCommit}}
+      - --label=org.opencontainers.image.version={{.Version}}
+  - id: linux-arm64-parrot
+    goos: linux
+    goarch: arm64
+    image_templates:
+      - '{{ .Env.IMG_PRE }}/parrot:{{ .Tag }}-arm64'
+      - '{{ .Env.IMG_PRE }}/parrot:latest-arm64'
+    build_flag_templates:
+      - --platform=linux/arm64
+      - --pull
+      - --label=org.opencontainers.image.created={{.Date}}
+      - --label=org.opencontainers.image.title={{.ProjectName}}
+      - --label=org.opencontainers.image.revision={{.FullCommit}}
+      - --label=org.opencontainers.image.version={{.Version}}
+
+before:
+  hooks:
+    - cd parrot && go mod tidy

parrot/Dockerfile

@@ -0,0 +1,3 @@
+FROM scratch
+COPY parrotserver /parrotserver
+ENTRYPOINT [ "parrotserver" ]

parrot/Makefile

@@ -0,0 +1,37 @@
+# Default test log level (can be overridden)
+PARROT_TEST_LOG_LEVEL ?= ""
+
+# Pass TEST_LOG_LEVEL as a flag to go test
+TEST_ARGS ?= -testLogLevel=$(PARROT_TEST_LOG_LEVEL)
+
+.PHONY: lint
+lint:
+	golangci-lint --color=always run ./... --fix -v
+
+.PHONY: test
+test:
+	go install github.com/gotesttools/gotestfmt/v2/cmd/gotestfmt@latest
+	set -euo pipefail
+	go test $(TEST_ARGS) -json -cover -coverprofile cover.out -v ./... 2>&1 | tee /tmp/gotest.log | gotestfmt
+
+.PHONY: test_race
+test_race:
+	go install github.com/gotesttools/gotestfmt/v2/cmd/gotestfmt@latest
+	set -euo pipefail
+	go test $(TEST_ARGS) -json -cover -count=1 -race -coverprofile cover.out -v ./... 2>&1 | tee /tmp/gotest.log | gotestfmt
+
+.PHONY: test_unit
+test_unit:
+	go test $(TEST_ARGS) -coverprofile cover.out ./...
+
+.PHONY: bench
+bench:
+	go test $(TEST_ARGS) -bench=. -run=^$$ ./...
+
+.PHONY: build
+build:
+	go build -o ./parrot ./cmd
+
+.PHONY: goreleaser
+goreleaser:
+	cd .. && goreleaser build --snapshot --clean -f ./parrot/.goreleaser.yaml

parrot/README.md

@@ -0,0 +1,35 @@
+# Parrot Server
+
+A simple, high-performing mockserver that can dynamically build new routes with customized responses, parroting back whatever you tell it to.
+
+## Features
+
+* Simplistic and fast design
+* Run within your Go code, through a small binary, or in a minimal Docker container
+* Easily record all incoming requests to the server to programmatically react to 
+
+## Use
+
+See our runnable examples in [examples_test.go](./examples_test.go) to see how to use Parrot programmatically.
+
+## Run
+
+```sh
+go run ./cmd
+go run ./cmd -h # See all config options 
+```
+
+## Test
+
+```sh
+make test
+make test PARROT_TEST_LOG_LEVEL=trace # Set log level for tests
+make test_race # Test with -race flag enabled
+make bench # Benchmark
+```
+
+## Build
+
+```sh
+make goreleaser # Uses goreleaser to build binaries and docker containers
+```