To gitea and beyond, let's go(-yco)

scripts/regenerate-swagger.sh

@@ -0,0 +1,68 @@
+#!/bin/bash
+# regenerate swagger
+set -e
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+echo -e "${BLUE}Regenerating Swagger documentation for Goyco API...${NC}"
+cd "$PROJECT_ROOT"
+
+if ! command -v swag &>/dev/null; then
+  echo -e "${RED}Error: 'swag' command not found. Please install it first:${NC}"
+  echo -e "${YELLOW}   go install github.com/swaggo/swag/cmd/swag@latest${NC}"
+  exit 1
+fi
+
+if [ ! -f "cmd/goyco/main.go" ]; then
+  echo -e "${RED}Error: cmd/goyco/main.go not found${NC}"
+  exit 1
+fi
+
+if [ ! -d "docs" ]; then
+  echo -e "${YELLOW}Creating docs directory...${NC}"
+  mkdir -p docs
+fi
+
+SWAGGER_DIRECTORIES="cmd/goyco,internal/handlers"
+SWAGGER_MAIN_FILE="main.go"
+SWAGGER_OUTPUT_DIR="docs"
+
+echo -e "${BLUE}Running swag init on directories: ${SWAGGER_DIRECTORIES}...${NC}"
+
+if swag init -g "$SWAGGER_MAIN_FILE" -d "$SWAGGER_DIRECTORIES" -o "$SWAGGER_OUTPUT_DIR"; then
+  echo -e "${GREEN}Swagger documentation generated successfully!${NC}"
+  echo -e "${BLUE}Generated files:${NC}"
+  ls -la docs/swagger.* docs/docs.go 2>/dev/null || true
+
+  if [ -f "docs/swagger.json" ]; then
+    ENDPOINT_COUNT=$(grep -o '"/[^"]*":' docs/swagger.json | wc -l)
+    echo -e "${GREEN}Found $ENDPOINT_COUNT API endpoints${NC}"
+  fi
+
+  if [ -f ".env" ]; then
+    export "$(grep -E '^APP_BASE_URL=' .env | xargs)"
+  fi
+
+  if [ -n "$APP_BASE_URL" ]; then
+    DOCS_URL="${APP_BASE_URL%/}/swagger/index.html"
+  else
+    DOCS_URL="http://localhost:8080/swagger/index.html"
+  fi
+
+  echo -e "${GREEN}You can now view the documentation at: $DOCS_URL${NC}"
+  echo -e "${BLUE}To serve the documentation, please start Goyco.${NC}"
+else
+  echo -e "${RED}Error: Failed to generate Swagger documentation${NC}"
+  echo -e "${YELLOW}Make sure you have proper Swagger annotations in your handlers${NC}"
+  echo -e "${YELLOW}Check the output above for specific error messages${NC}"
+  exit 1
+fi
+
+echo -e "${GREEN}Swagger documentation regeneration complete!${NC}"

scripts/setup-postgres.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+# helper script to setup a postgres database on deb based systems
+
+if [ "$EUID" -ne 0 ]; then
+    echo "Please run as root"
+    exit 1
+fi
+
+read -s "Do you want to install PostgreSQL 17? [y/N] " INSTALL_PG
+if [ "$INSTALL_PG" != "y" ]; then
+    echo "PostgreSQL 17 will not be installed"
+    exit 0
+fi
+
+read -s -p "Enter password for PostgreSQL user 'goyco': " GOYCO_PWD
+echo
+
+apt-get update
+apt-get install -y postgresql-17 
+
+systemctl enable --now postgresql
+
+su - postgres -c "psql" <<EOF
+DO
+\$body\$
+BEGIN
+   IF NOT EXISTS (SELECT FROM pg_catalog.pg_user WHERE usename = 'goyco') THEN
+      CREATE USER goyco WITH PASSWORD '${GOYCO_PWD}';
+   END IF;
+END
+\$body\$;
+
+DO
+\$body\$
+BEGIN
+   IF NOT EXISTS (SELECT FROM pg_database WHERE datname = 'goyco') THEN
+      CREATE DATABASE goyco OWNER goyco;
+   END IF;
+END
+\$body\$;
+
+-- Give all privileges on database to goyco (redundant if owner, but explicit)
+GRANT ALL PRIVILEGES ON DATABASE goyco TO goyco;
+EOF
+
+echo "PostgreSQL 17 installed, database 'goyco' and user 'goyco' set up."
+
+

scripts/test-coverage.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+
+set -e
+
+COVERAGE_DIR="coverage"
+PACKAGE="${1:-./internal/e2e/...}"
+
+mkdir -p "$COVERAGE_DIR"
+
+echo "Running tests with coverage for: $PACKAGE"
+go test -v -coverprofile="$COVERAGE_DIR/coverage.out" -covermode=atomic "$PACKAGE"
+
+echo "Generating HTML coverage report..."
+go tool cover -html="$COVERAGE_DIR/coverage.out" -o "$COVERAGE_DIR/coverage.html"
+
+echo "Generating coverage summary..."
+go tool cover -func="$COVERAGE_DIR/coverage.out" | tee "$COVERAGE_DIR/coverage.txt"
+
+echo ""
+echo "Coverage report generated:"
+echo "  HTML: $COVERAGE_DIR/coverage.html"
+echo "  Text: $COVERAGE_DIR/coverage.txt"
+echo "  Raw:  $COVERAGE_DIR/coverage.out"
+