Skip to content

v0.1.0 - Initial Experimental Release

Choose a tag to compare

@Ammar0144 Ammar0144 released this 25 Oct 12:54
· 5 commits to main since this release

🎉 sql4go v0.1.0 - First Experimental Release!

This is the first public release of sql4go, a learning-focused database library exploring automatic relationship detection and intelligent caching patterns in Go.

✨ What's Included

Core Features

  • Generic Repository Pattern with full type safety (Go 1.21+)
  • Zero Configuration - automatic GORM relationship detection via reflection
  • Intelligent Caching - cache-first reads with Redis (10x-100x faster)
  • Automatic Invalidation - relationship-aware cache management
  • Graceful Degradation - works seamlessly with or without Redis
  • Monitoring Metrics - basic performance tracking for development

Documentation

  • 📖 Comprehensive README with problem/solution narrative
  • 🏗️ Detailed DESIGN.md explaining architecture decisions
  • 🤝 CONTRIBUTING.md for community participation
  • 📊 Monitoring & metrics guide
  • 🔍 12 documented edge cases and foreseen issues

Code Quality

  • ✅ CI/CD with GitHub Actions (Go 1.21, 1.22, 1.23)
  • ✅ golangci-lint integration
  • ✅ Formatted and vetted code
  • ✅ MIT License

🎯 Use Cases

Good for:

  • Learning projects exploring advanced Go patterns
  • Read-heavy applications (blogs, catalogs, APIs)
  • Prototyping with quick database setup
  • Educational purposes

⚠️ Important Notice

This is an EXPERIMENTAL learning project!

  • Not recommended for production systems (until v1.0)
  • Actively exploring complex challenges (see README)
  • API may change as we learn and improve
  • Test thoroughly before considering any production use

📦 Installation

go get github.com/Ammar0144/sql4go@v0.1.0