Merge pull request #4 from govalues/error-management

money: implement panic free methods

.github/workflows/go.yml

@@ -31,7 +31,7 @@ jobs:
       run: go generate ./... && git diff --exit-code
 
     - name: Verify potential issues
-      run: go vet ./...
+      uses: golangci/golangci-lint-action@v3
 
     - name: Run tests with coverage
       run: go test -race -shuffle=on -coverprofile="coverage.txt" -covermode=atomic ./...

.golangci.yml

@@ -0,0 +1,15 @@
+run:
+  timeout: 5m
+
+linters:
+  enable:
+    - errcheck
+    - gosimple
+    - goimports
+    - govet
+    - ineffassign
+    - misspell
+    - revive
+    - staticcheck
+    - typecheck
+    - unused

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.1.0] - 2023-06-04
+
+### Changed
+
+- All methods return error instead of panicing.
+- Renamed Amount.Round to Amount.Rescale.
+- Renamed ExchangeRate.Round to ExchangeRate.Rescale.
+
 ## [0.0.3] - 2023-04-22
 
 ### Changed

README.md

@@ -29,11 +29,11 @@ import (
 ## Using Amount
 
 To create a new amount, you can use one of the provided constructors,
-such as `NewAmount`, `ParseAmount` or `MustParseAmount`.
+such as `NewAmount`, `MustNewAmount`, `ParseAmount` or `MustParseAmount`.
 
 ```go
-d := decimal.New(12345, 2)                  // d = 123.45
-a, _ := money.NewAmount(money.USD, d)       // a = USD 123.45
+d := decimal.MustNew(12345, 2)              // d = 123.45
+a := money.MustNewAmount(money.USD, d)      // a = USD 123.45
 b := money.MustParseAmount("USD", "123.45") // b = USD 123.45
 ```
 
@@ -42,11 +42,11 @@ addition, subtraction, multiplication, division, as well
 as rounding operations such as ceiling, floor, truncation, and rounding.
 
 ```go
-sum := a.Add(b)
-difference := a.Sub(b)
-product := a.Mul(d)
-quotient := a.Quo(d)
-ratio := a.Rat(b)
+sum, _ := a.Add(b)
+difference, _ := a.Sub(b)
+product, _ := a.Mul(d)
+quotient, _ := a.Quo(d)
+ratio, _ := a.Rat(b)
 ceil := a.Ceil(2)
 floor := a.Floor(2)
 trunc := a.Trunc(2)