README
¶
Utils
A common utilities library for Go.
Overview
Utils is a lightweight, flexible, and reusable library that provides utility functions and helpers for common operations in Go applications. It includes packages for boolean conversions, context value handling, map operations, slice utilities, string manipulations, struct comparisons, and more—enhancing Go projects with optimized, clean, and practical solutions.
Prerequisites
- Go: The project is written in Golang. Ensure you have Go installed (preferably Go 1.24 or later). You can download it here.
- Git: Required for cloning the repository.
Installation
To use Utils in your project, add it as a module dependency:
Install the Package
go get github.com/kashifkhan0771/utils
Alternatively, include it directly in your go.mod file (use the latest release):
require github.com/kashifkhan0771/utils v0.3.0
Clone the Repository (For Development)
If you want to contribute or modify the library, clone the repository:
git clone https://github.com/kashifkhan0771/utils.git
cd utils
Key Features
Utility Packages
| Package Name | Description | Documentation | Examples |
|---|---|---|---|
| boolean | Utilities for boolean value checking and toggling | README | EXAMPLES |
| caching | Cache management utilities | README | EXAMPLES |
| cryptoutils | A set of cryptographic utility functions for various cryptographic operations | README | EXAMPLES |
| ctxutils | Context utilities | README | EXAMPLES |
| errutils | Error aggregation and management utilities | README | EXAMPLES |
| fake | Fake data generation (UUIDs, addresses, dates) | README | EXAMPLES |
| fsutils | File system utilities (size, metadata, comparison) | README | EXAMPLES |
| logging | Flexible logging system for Golang | README | EXAMPLES |
| maps | Utilities for state and metadata maps | README | EXAMPLES |
| math | Mathematical utilities and helpers | README | EXAMPLES |
| pointers | Helper functions for working with pointer values | README | EXAMPLES |
| rand | Random number and string generation utilities | README | EXAMPLES |
| slice | Slice manipulation and de-duplication utilities | README | EXAMPLES |
| slugger | A simple and efficient way to generate URL-friendly slugs from strings | README | EXAMPLES |
| sort | Sorting algorithms | README | EXAMPLES |
| stack | Stack data structure | README | EXAMPLES |
| strings | String manipulation and encoding utilities | README | EXAMPLES |
| structs | Struct comparison utilities | README | EXAMPLES |
| templates | Template rendering utilities | README | EXAMPLES |
| timeutils | Time and date manipulation utilities | README | EXAMPLES |
| url | URL parsing and manipulation utilities | README | EXAMPLES |
| conversion | Conversion of data types, time, and temperatues | README | EXAMPLES |
| ratelimiter | Token-bucket rate limiter (allow/wait, adjustable capacity & refill rate) | README | EXAMPLES |
| queue | Queue data structure | README | EXAMPLES |
| image | Utility functions for working with images | README | EXAMPLES |
Comparison
| Feature / Utility Area | kashifkhan0771/utils |
go-commons-lang |
gookit/goutil |
|---|---|---|---|
| Boolean Utilities | ✅ Yes | ✅ Yes | ✅ Yes |
| Caching | ✅ Yes | ❌ No | ✅ Yes |
| Cryptographic Utilities | ✅ Yes | ✅ Yes | ✅ Yes |
| Context Utilities | ✅ Yes | ❌ No | ❌ No |
| Error Aggregation | ✅ Yes | ❌ No | ✅ Yes |
| Fake Data (UUID, etc.) | ✅ Yes | ✅ Yes | ✅ Yes |
| Filesystem Utilities | ✅ Yes | ✅ Yes | ✅ Yes |
| Logging | ✅ Yes | ❌ No | ✅ Yes |
| Maps / Metadata Helpers | ✅ Yes | ✅ Yes | ✅ Yes |
| Math Utilities | ✅ Yes | ✅ Yes | ✅ Yes |
| Pointer Utilities | ✅ Yes | ❌ No | ❌ No |
| Conversion Utilities | ✅ Yes | ❌ No | ❌ No |
| Random Utilities | ✅ Yes | ✅ Yes | ✅ Yes |
| Slice Utilities | ✅ Yes | ✅ Yes | ✅ Yes |
| Slugify | ✅ Yes | ❌ No | ✅ Yes |
| Sorting | ✅ Yes | ✅ Yes | ✅ Yes |
| String Utilities | ✅ Yes | ✅ Yes | ✅ Yes |
| Struct Comparison | ✅ Yes | ❌ No | ✅ Yes |
| Template Helpers | ✅ Yes | ❌ No | ✅ Yes |
| Time Utilities | ✅ Yes | ✅ Yes | ✅ Yes |
| URL Utilities | ✅ Yes | ❌ No | ✅ Yes |
| Dependency-Free | ✅ Yes | ❌ No | ❌ No |
| Small API Surface | ✅ Yes | ❌ No | ✅ Yes |
| Rate Limiter Utilities | ✅ Yes | ❌ No | ❌ No |
| Image | ✅ Yes | ❌ No | ❌ No |
Contributions
Contributions are welcome! If you'd like to contribute, feel free to open a pull request.
Before submitting a PR, please review the Contribution Guide.
Together, we can make Utils even better for the Go community!
Credits
The image used in this project was sourced from https://github.com/MariaLetta/free-gophers-pack.
📷 Image by MariaLetta, used under the Creative Commons (CC0-1.0) license.
Contributors
Powered by coffee, code, and these legends ☕💻:
Star History
Directories
¶
| Path | Synopsis |
|---|---|
|
Package boolean defines boolean helpers.
|
Package boolean defines boolean helpers. |
|
Package errutils provides utilities for error aggregation and handling.
|
Package errutils provides utilities for error aggregation and handling. |
|
Package fake provides utilities for generating fake data.
|
Package fake provides utilities for generating fake data. |
|
Package logging provides a simple logging library with support for multiple log levels, custom prefixes, colored output, and customizable output streams.
|
Package logging provides a simple logging library with support for multiple log levels, custom prefixes, colored output, and customizable output streams. |
|
Package strings defines strings helpers.
|
Package strings defines strings helpers. |
|
Package url defines url utilities helpers.
|
Package url defines url utilities helpers. |