GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com โ€” GitHub - copyleftdev/OverHelloWorld: A robust, over-engineered "Hello World" Go application demonstrating: DDD, CQRS, and event sourcing Redis and file-backed event bus Plugin system (ASCII, TTS, LED, etc) Prometheus & OpenTelemetry observability Property-based and integration tests Automated test reporting and coverage

BranchesTags
Open more actions menu

Latest commit

 

History

11 Commits
11 Commits

Folders and files

NameName
Last commit message
Last commit date
.github
.github
 
 
bin
bin
 
 
cmd/server
cmd/server
 
 
config
config
 
 
internal
internal
 
 
media
media
 
 
pkg/di
pkg/di
 
 
test_reports/2025-04-17T20-31-36
test_reports/2025-04-17T20-31-36
 
 
tests
tests
 
 
.gitignore
.gitignore
 
 
ARCHITECTURE.md
ARCHITECTURE.md
 
 
BENCHMARK.md
BENCHMARK.md
 
 
CHANGELOG.md
CHANGELOG.md
 
 
CODE_OF_CONDUCT.md
CODE_OF_CONDUCT.md
 
 
CONTRIBUTING.md
CONTRIBUTING.md
 
 
Dockerfile
Dockerfile
 
 
LICENSE
LICENSE
 
 
Makefile
Makefile
 
 
OVERENGINEERING_ARTICLE.md
OVERENGINEERING_ARTICLE.md
 
 
README.md
README.md
 
 
SECURITY.md
SECURITY.md
 
 
SUPPORT.md
SUPPORT.md
 
 
docker-compose.yml
docker-compose.yml
 
 
go.mod
go.mod
 
 
go.sum
go.sum
 
 
run_tests.sh
run_tests.sh
 
 
server
server
 
 
windsurf.yaml
windsurf.yaml
 
 

Repository files navigation

OverHelloWorld

Tip my tokens

A robust, over-engineered "Hello World" Go application demonstrating:

  • DDD, CQRS, and event sourcing
  • Redis and file-backed event bus
  • Plugin system (ASCII, TTS, LED, etc)
  • Prometheus & OpenTelemetry observability
  • Property-based and integration tests
  • Automated test reporting and coverage

๐Ÿš€ Quick Start

# Run all tests with coverage and generate a timestamped report folder
test_reports/YYYY-MM-DDTHH-MM-SS/
./run_tests.sh

๐Ÿงช Test Suite & Coverage

  • Unit, integration, and property-based tests
  • Detailed coverage report in each test run folder
  • Property-based tests for:
    • Event sourcing (file store)
    • Plugins
    • API roundtrip
    • Redis event bus (if REDIS_ADDR set)

Run All Tests

./run_tests.sh

View Coverage

  • Open the generated HTML report, e.g.:
    xdg-open test_reports/YYYY-MM-DDTHH-MM-SS/coverage.html
    

Test Status & Coverage Badges

If using GitHub Actions, add this to your README:

![Go](https://github.com/<your-username>/OverHelloWorld/actions/workflows/go.yml/badge.svg)
![Coverage](https://img.shields.io/badge/coverage-dynamic-brightgreen)

(Replace <your-username> with your GitHub username)


CI Coverage


๐Ÿ“Š Benchmark

See BENCHMARK.md for the latest load test results using k6.


๐Ÿ“„ Documentation

  • OVERENGINEERING_ARTICLE.md: Satirical deep-dive on overengineering.
  • BENCHMARK.md: Performance and load test results.
  • CONTRIBUTING.md: How to contribute, code style, PR guidelines.
  • CODE_OF_CONDUCT.md: Community standards and behavior.
  • SECURITY.md: How to report vulnerabilities.
  • SUPPORT.md: Where and how to get help.
  • LICENSE: Project license.

๐Ÿ”ฌ Property-Based Testing

  • Uses gopter for hypothesis-style tests.
  • See tests/integration/property_test.go, property_redis_test.go, property_file_event_store_test.go.

๐Ÿ“ฆ Test Reports

  • All test runs output to test_reports/<timestamp>/:
    • report.json: Full JSON test log
    • coverage.out: Go coverage profile
    • coverage.html: Visual HTML coverage report

๐Ÿ› ๏ธ CI/CD

  • Recommended: Add a GitHub Actions workflow for Go tests and coverage.
  • Artifacts can be uploaded for each run.

๐Ÿ“ How to Add More Tests

  • Add new property-based or integration tests in tests/integration/.
  • Extend the plugin system or event store, and verify with new properties!

๐Ÿ“š Documentation

  • See inline comments and test files for usage and extension examples.
  • For questions, open an issue or PR!

๐Ÿ† Project Status

  • Feature-complete, robustly tested, and ready for extension or production demo!

Overengineering Microservices Unnecessary Patterns Job Security Agility CI/CD Ego Driven YAGNI KISS

About

A robust, over-engineered "Hello World" Go application demonstrating: DDD, CQRS, and event sourcing Redis and file-backed event bus Plugin system (ASCII, TTS, LED, etc) Prometheus & OpenTelemetry observability Property-based and integration tests Automated test reporting and coverage

Topics

aigolanghumerushumorvibe-coding

Resources

Readme
MIT license

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity

Stars

1 star

Watchers

1 watching

Forks

0 forks
Report repository

Releases

Packages

Used by

Contributors

Languages

You are visitor 01402503 โ€” GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800ร—600. No cookies required.