From 56407deafe0119064c3e81aa7faf75e3db0c0786 Mon Sep 17 00:00:00 2001 From: Levente Batuska Date: Sun, 1 Dec 2024 09:19:10 +0100 Subject: [PATCH] chore(Readme): add readme --- README.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..341341f --- /dev/null +++ b/README.md @@ -0,0 +1,23 @@ +# Golang Utility Tools + +This repository contains various utilities designed to aid Golang development. These tools are intended to improve productivity, simplify common tasks, and enhance testing and error handling. + +## Included Tools (Non-Exhaustive List) + +Assertions `IsNillable`, `NotNil`, `NilPtr`, `True`, `Equal`, for runtime assertion + +Logging: `ConsoleLoggerImpl`, `FileLoggerImpl`, buffered logging using channels + +Type: `Optional`, `Result`, as an alternative for "if err nil" error handling + +Testing: `AssertEqual`, `AssertTrue`, `AssertNil`, to help quickly write tests + +## Versioning + +### latest: + +Rolling version, pointing to the latest commit, no guarantees other than the code will compile. + +### For major versions: + +Anything outside the unstable directory is guaranteed to have a stable api and whatever cases and edge cases are already covered by tests are guaranteed to not change. Other behavior not covered by tests have no guarantees. (you can add any new test to add a new guarante for the future)