docs: readme

Author: cmilesio

README.md

@@ -18,19 +18,17 @@
 <!-- test-count:embed:end -->
 </p>
 
+`web` is built on top of [Echo](https://echo.labstack.com/), which is a fantastic HTTP framework with a fast router, strong middleware story, and a mature ecosystem. GoForj wraps it so applications can code against a smaller app-facing contract while still getting a high-quality underlying engine, reusable middleware packages, testing helpers, route indexing, and framework-owned integration points like Prometheus and generated wiring.
+
 <!-- package-coverage:embed:start -->
-| Package | Coverage |
-|------|---------:|
-| `web` | 94.3% |
-| `adapter/echoweb` | 90.0% |
-| `webindex` | 90.3% |
-| `webmiddleware` | 89.2% |
-| `webprometheus` | 89.8% |
-| `webtest` | 100.0% |
+<img src="https://img.shields.io/badge/web-94.3%25-4c9a2a" alt="web coverage">
+<img src="https://img.shields.io/badge/adapter--echoweb-90.0%25-4c9a2a" alt="adapter/echoweb coverage">
+<img src="https://img.shields.io/badge/webindex-90.3%25-4c9a2a" alt="webindex coverage">
+<img src="https://img.shields.io/badge/webmiddleware-89.2%25-4c9a2a" alt="webmiddleware coverage">
+<img src="https://img.shields.io/badge/webprometheus-91.4%25-4c9a2a" alt="webprometheus coverage">
+<img src="https://img.shields.io/badge/webtest-100.0%25-4c9a2a" alt="webtest coverage">
 <!-- package-coverage:embed:end -->
 
-`web` is built on top of [Echo](https://echo.labstack.com/), which is a fantastic HTTP framework with a fast router, strong middleware story, and a mature ecosystem. GoForj wraps it so applications can code against a smaller app-facing contract while still getting a high-quality underlying engine, reusable middleware packages, testing helpers, route indexing, and framework-owned integration points like Prometheus and generated wiring.
-
 ## Installation
 
 ```bash

docs/readme/testcounts/main.go

@@ -222,20 +222,25 @@ func renderBadges(unitCount int) string {
 }
 
 func renderPackageCoverageTable(items []packageCoverage) string {
-	lines := []string{
-		"| Package | Coverage |",
-		"|------|---------:|",
-	}
+	lines := make([]string, 0, len(items))
 	for _, item := range items {
 		percent := 0.0
 		if item.Total > 0 {
 			percent = (float64(item.Covered) / float64(item.Total)) * 100
 		}
-		lines = append(lines, fmt.Sprintf("| `%s` | %.1f%% |", item.Name, percent))
+		lines = append(lines, fmt.Sprintf(`<img src="https://img.shields.io/badge/%s-%.1f%%25-4c9a2a" alt="%s coverage">`, badgeLabel(item.Name), percent, item.Name))
 	}
 	return strings.Join(lines, "\n")
 }
 
+func badgeLabel(name string) string {
+	replacer := strings.NewReplacer(
+		"/", "--",
+		" ", "_",
+	)
+	return replacer.Replace(name)
+}
+
 func replaceSection(input, start, end, replacement string) (string, error) {
 	si := strings.Index(input, start)
 	ei := strings.Index(input, end)