Skip to content

Commit 275e48e

Browse files
authored
Add docs section with alternative libraries (shopspring#363)
1 parent dd603cb commit 275e48e

File tree

1 file changed

+14
-2
lines changed

1 file changed

+14
-2
lines changed

README.md

+14-2
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,11 @@ Run `go get github.com/shopspring/decimal`
2424

2525
Decimal library requires Go version `>=1.10`
2626

27+
## Documentation
28+
29+
http://godoc.org/github.com/shopspring/decimal
30+
31+
2732
## Usage
2833

2934
```go
@@ -59,9 +64,16 @@ func main() {
5964
}
6065
```
6166

62-
## Documentation
67+
## Alternative libraries
6368

64-
http://godoc.org/github.com/shopspring/decimal
69+
When working with decimal numbers, you might face problems this library is not perfectly suited for.
70+
Fortunately, thanks to the wonderful community we have a dozen other libraries that you can choose from.
71+
Explore other alternatives to find the one that best fits your needs :)
72+
73+
* [cockroachdb/apd](https://github.com/cockroachdb/apd) - arbitrary precision, mutable and rich API similar to `big.Int`, more performant than this library
74+
* [alpacahq/alpacadecimal](https://github.com/alpacahq/alpacadecimal) - high performance, low precision (12 digits), fully compatible API with this library
75+
* [govalues/decimal](https://github.com/govalues/decimal) - high performance, zero-allocation, low precision (19 digits)
76+
* [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
6577

6678
## FAQ
6779

0 commit comments

Comments
 (0)