Init project (#1)

First git server version with S3-compatible backend storage.

Author: moutonjeremy

.air.toml

@@ -0,0 +1,52 @@
+root = "."
+testdata_dir = "testdata"
+tmp_dir = "tmp"
+
+[build]
+  bin = "./tmp/main"
+  args_bin = ["server", "-c", "./config.yaml"]
+  cmd = "go build -o ./tmp/main cmd/main.go"
+  delay = 1000
+  exclude_dir = ["assets", "tmp", "vendor", "testdata", "repositories"]
+  exclude_file = []
+  exclude_regex = ["_test.go"]
+  exclude_unchanged = false
+  follow_symlink = false
+  full_bin = ""
+  include_dir = []
+  include_ext = ["go", "tpl", "tmpl", "html"]
+  include_file = []
+  kill_delay = "0s"
+  log = "build-errors.log"
+  poll = false
+  poll_interval = 0
+  post_cmd = []
+  pre_cmd = []
+  rerun = false
+  rerun_delay = 500
+  send_interrupt = false
+  stop_on_error = false
+
+[color]
+  app = ""
+  build = "yellow"
+  main = "magenta"
+  runner = "green"
+  watcher = "cyan"
+
+[log]
+  main_only = false
+  silent = false
+  time = false
+
+[misc]
+  clean_on_exit = false
+
+[proxy]
+  app_port = 0
+  enabled = false
+  proxy_port = 0
+
+[screen]
+  clear_on_rebuild = false
+  keep_scroll = true

.dev/create-repo.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+
+curl -X POST http://localhost:8080/api/repo -H "Content-Type: application/json" -d '{
+  "name": "new-repo"
+}'

.gitignore

@@ -30,3 +30,16 @@ go.work.sum
 # Editor/IDE
 # .idea/
 # .vscode/
+
+config.yaml
+
+# Folder used by air to store build files
+tmp/
+
+# Default local storage folder
+repositories/
+
+main
+
+.vscode/
+ssh_host_key

Makefile

@@ -0,0 +1,168 @@
+# Makefile for Git Server S3
+
+.PHONY: help test test-unit test-integration test-coverage build run clean lint fmt vet deps
+
+# Variables
+BINARY_NAME=git-server-s3
+BUILD_DIR=tmp
+CONFIG_FILE=config.yaml
+
+# Help
+help: ## Display this help
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'
+
+# Install dependencies
+deps: ## Install dependencies
+	go mod download
+	go mod tidy
+
+# Unit tests
+test-unit: ## Run unit tests
+	go test -v -race -timeout 30s ./pkg/... ./internal/...
+
+# Tests with coverage
+test-coverage: ## Run tests with coverage
+	go test -v -race -coverprofile=coverage.out -covermode=atomic ./pkg/... ./internal/...
+	go tool cover -html=coverage.out -o coverage.html
+	@echo "Coverage report generated: coverage.html"
+
+# Integration tests (requires S3_TEST_*)
+test-integration: ## Run integration tests (requires S3_TEST_* variables)
+	@if [ -z "$(S3_TEST_BUCKET)" ]; then \
+		echo "❌ S3_TEST_* variables not defined. Example:"; \
+		echo "export S3_TEST_BUCKET=your-test-bucket"; \
+		echo "export S3_TEST_REGION=us-east-1"; \
+		echo "export S3_TEST_ENDPOINT=https://s3.us-east-1.amazonaws.com"; \
+		echo "make test-integration"; \
+		exit 1; \
+	fi
+	go test -v -tags=integration -timeout 5m ./...
+
+# All tests
+test: test-unit ## Run all tests (unit tests only by default)
+
+# Tests with more verbosity
+test-verbose: ## Run tests with more details
+	go test -v -race -coverprofile=coverage.out ./pkg/... ./internal/... -args -test.v
+
+# Code formatting
+fmt: ## Format code
+	go fmt ./...
+
+# Static checks
+vet: ## Check code with go vet
+	go vet ./...
+
+# Linting (requires golangci-lint)
+lint: ## Lint code (requires golangci-lint)
+	@if command -v golangci-lint >/dev/null 2>&1; then \
+		golangci-lint run; \
+	else \
+		echo "⚠️  golangci-lint not installed. Installation:"; \
+		echo "go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest"; \
+	fi
+
+# Build
+build: ## Build the server
+	@mkdir -p $(BUILD_DIR)
+	go build -o $(BUILD_DIR)/$(BINARY_NAME) ./cmd/main.go
+
+# Build with version information
+build-release: ## Build for release
+	@mkdir -p $(BUILD_DIR)
+	go build -ldflags "-X main.version=$(shell git describe --tags --always --dirty)" \
+		-o $(BUILD_DIR)/$(BINARY_NAME) ./cmd/main.go
+
+# Run the server
+run: build ## Build and run the server
+	./$(BUILD_DIR)/$(BINARY_NAME) server --config $(CONFIG_FILE)
+
+# Run in development mode with auto-reload (requires air)
+dev: ## Run in development mode (requires air)
+	@if command -v air >/dev/null 2>&1; then \
+		air; \
+	else \
+		echo "⚠️  air not installed. Installation:"; \
+		echo "go install github.com/cosmtrek/air@latest"; \
+		echo "Or use: make run"; \
+	fi
+
+# Cleanup
+clean: ## Clean generated files
+	rm -rf $(BUILD_DIR)
+	rm -f coverage.out coverage.html
+	go clean -cache -testcache
+
+# Performance tests
+bench: ## Run benchmarks
+	go test -bench=. -benchmem -run=^$$ ./pkg/... ./internal/...
+
+# Race condition tests
+race: ## Run tests with race condition detection
+	go test -race ./pkg/... ./internal/...
+
+# Security check (requires gosec)
+security: ## Check code security (requires gosec)
+	@if command -v gosec >/dev/null 2>&1; then \
+		gosec ./...; \
+	else \
+		echo "⚠️  gosec not installed. Installation:"; \
+		echo "go install github.com/securecodewarrior/gosec/v2/cmd/gosec@latest"; \
+	fi
+
+# Update dependencies
+update-deps: ## Update dependencies
+	go get -u ./...
+	go mod tidy
+
+# Complete check (CI)
+ci: fmt vet test-unit ## CI/CD checks
+
+# Memory tests with Valgrind (Linux only)
+memcheck: ## Memory tests (Linux only)
+	@if command -v valgrind >/dev/null 2>&1; then \
+		go test -c ./pkg/storage/s3/ && valgrind --leak-check=full ./s3.test; \
+	else \
+		echo "⚠️  valgrind not available (Linux only)"; \
+	fi
+
+# Install development tools
+install-tools: ## Install development tools
+	go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest
+	go install github.com/cosmtrek/air@latest
+	go install github.com/securecodewarrior/gosec/v2/cmd/gosec@latest
+
+# Test configuration example
+setup-test-env: ## Display test configuration example
+	@echo "Configuration for integration tests:"
+	@echo ""
+	@echo "# Local MinIO (for testing)"
+	@echo "export S3_TEST_BUCKET=git-server-test"
+	@echo "export S3_TEST_REGION=us-east-1"
+	@echo "export S3_TEST_ENDPOINT=http://localhost:9000"
+	@echo "export AWS_ACCESS_KEY_ID=minio"
+	@echo "export AWS_SECRET_ACCESS_KEY=minio123"
+	@echo ""
+	@echo "# Real AWS S3 (for cloud testing)"
+	@echo "export S3_TEST_BUCKET=your-test-bucket"
+	@echo "export S3_TEST_REGION=us-east-1"
+	@echo "export S3_TEST_ENDPOINT=https://s3.us-east-1.amazonaws.com"
+	@echo "# + your AWS credentials via AWS CLI or environment variables"
+
+# Tests with different log levels
+test-debug: ## Run tests with debug logs
+	ZEROLOG_LEVEL=debug go test -v ./pkg/... ./internal/...
+
+# Tests on specific files
+test-s3: ## Test only the S3 package
+	go test -v ./pkg/storage/s3/...
+
+test-api: ## Test only the API
+	go test -v ./internal/api/...
+
+# Test statistics
+test-stats: ## Test statistics
+	@echo "📊 Test statistics:"
+	@find . -name "*_test.go" -not -path "./vendor/*" | wc -l | xargs echo "Test files:"
+	@grep -r "func Test" --include="*_test.go" . | wc -l | xargs echo "Test functions:"
+	@grep -r "func Benchmark" --include="*_test.go" . | wc -l | xargs echo "Benchmarks:"