Golly Core
Golly Core
This section contains the documentation for all the core packages available in Golly, a robust collection of enterprise-grade Go libraries.
The core packages provide the foundation for Golly’s functionality, offering solutions for common programming challenges while adhering to Go’s philosophy of simplicity and performance.
Package Categories
🔧 Fundamentals
Core building blocks and essential utilities.
| Package | Description |
|---|---|
| Assertion | A flexible and extensible assertion library for consistent testing |
| CLI | Command-line interface tools for building complex applications |
| Collections | Generic data structures — ArrayList, LinkedList, HashSet, Queue, Stack |
| Config | Configuration management utilities |
| ErrUtils | Error handling and multi-error aggregation |
| FnUtils | Deferred and timed function execution utilities |
📡 Networking & Communication
HTTP clients, servers, routers, and messaging interfaces.
| Package | Description |
|---|---|
| Clients | HTTP client with auth providers, retry with backoff, and circuit breaker |
| REST | HTTP server with routing, middleware, TLS, and transport configuration |
| Turbo | Enterprise-grade HTTP router with path/query params, filters, CORS, and auth middleware |
| Messaging | Producer/consumer interfaces with local channel-based provider |
🗃️ Data & Encoding
Data serialization, encoding/decoding, and identifier generation.
| Package | Description |
|---|---|
| Codec | Unified encoding/decoding for JSON, XML, YAML with struct validation |
| Data | Pipeline key-value container with typed extraction and JSON Schema generation |
| SemVer | Semantic versioning parser and comparator |
| TextUtils | Named ASCII character constants for readable code |
| UUID | UUID generation (V1–V4) and parsing |
🤖 AI & Intelligence
Provider-agnostic Generative AI integration.
| Package | Description |
|---|---|
| GenAI | Provider-agnostic GenAI/LLM interface with prompt templates — supports OpenAI, Claude, and Ollama |
🛠️ Infrastructure
System-level utilities for filesystem, logging, lifecycle, and security.
| Package | Description |
|---|---|
| FSUtils | Filesystem utilities: existence checks, content type detection |
| IOUtils | MIME type lookup, channel utilities, and checksum calculation |
| L3 | Lightweight Levelled Logger with console/file writers and async support |
| Lifecycle | Component lifecycle management with dependency ordering |
| Managers | Generic item manager for registering, retrieving, and listing named items |
| Pool | Generic, thread-safe object pool with configurable capacity |
| Secrets | AES encryption and decryption for strings and byte slices |
| VFS | Virtual File System with unified interface, extensible for cloud storage |
🧪 Testing
Testing utilities and assertion helpers.
| Package | Description |
|---|---|
| Testing | Lightweight assertion helpers for unit tests |