From 275e48eaef75c81ad54823b7b455b3f3e998062c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mateusz=20Wo=C5=9B?= Date: Fri, 12 Apr 2024 15:40:04 +0200 Subject: [PATCH] Add docs section with alternative libraries (#363) --- README.md | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 4793c7a..318c9df 100644 --- a/README.md +++ b/README.md @@ -24,6 +24,11 @@ Run `go get github.com/shopspring/decimal` Decimal library requires Go version `>=1.10` +## Documentation + +http://godoc.org/github.com/shopspring/decimal + + ## Usage ```go @@ -59,9 +64,16 @@ func main() { } ``` -## Documentation +## Alternative libraries -http://godoc.org/github.com/shopspring/decimal +When working with decimal numbers, you might face problems this library is not perfectly suited for. +Fortunately, thanks to the wonderful community we have a dozen other libraries that you can choose from. +Explore other alternatives to find the one that best fits your needs :) + +* [cockroachdb/apd](https://github.com/cockroachdb/apd) - arbitrary precision, mutable and rich API similar to `big.Int`, more performant than this library +* [alpacahq/alpacadecimal](https://github.com/alpacahq/alpacadecimal) - high performance, low precision (12 digits), fully compatible API with this library +* [govalues/decimal](https://github.com/govalues/decimal) - high performance, zero-allocation, low precision (19 digits) +* [greatcloak/decimal](https://github.com/greatcloak/decimal) - fork focusing on billing and e-commerce web application related use cases, includes out-of-the-box BSON marshaling support ## FAQ