Merge pull request #502 from slashdevops/refactor/idpscimcli-modernize

docs: update documentation for v0.40.1 changes

Author: christiangda

docs/Configuration.md

@@ -36,7 +36,7 @@ __NOTES:__
 create a `.idpscim.yaml` file in the `$HOME/` directory or in the same path where the `idpscim` program is.
 
 ```yaml
-log_level: trace
+log_level: debug
 log_format: text
 
 gws_service_account_file: /path/to/gws_service_account.json
@@ -81,7 +81,7 @@ or create a `<any filename on whenever place>.yaml` then run the `idpscim` progr
   --gws-groups-filter 'name:AWS* email:aws*' \
   --gws-groups-filter 'email:administrators*' \
   --sync-method 'groups'
-  --log-level trace
+  --log-level debug
 ```
 
 ## Environment variables
@@ -96,7 +96,7 @@ export IDPSCIM_GWS_SERVICE_ACCOUNT_FILE="/path/to/gws_service_account.json"
 export IDPSCIM_GWS_USER_EMAIL="my.user@gws-email.com"
 export IDPSCIM_GWS_GROUPS_FILTER='name:AWS* email:aws*','email:administrators*'
 export IDPSCIM_SYNC_METHOD="groups"
-export IDPSCIM_LOG_LEVEL="trace"
+export IDPSCIM_LOG_LEVEL="debug"
 
 # then execute the program
 ./idpscim

docs/Whats-New.md

@@ -34,10 +34,21 @@ Several code quality improvements and bug fixes in the AWS SCIM client:
 
 Applied Go 1.26 best practices across the codebase:
 
-* **Removed `github.com/pkg/errors` dependency:** Replaced all `errors.Wrap` and `errors.Errorf` with stdlib `fmt.Errorf` (with `%w`) and `errors.New` in `internal/setup`, `internal/repository`, and `pkg/aws`.
+* **Removed `github.com/pkg/errors` dependency:** Replaced all `errors.Wrap` and `errors.Errorf` with stdlib `fmt.Errorf` (with `%w`) and `errors.New` in `internal/setup`, `internal/repository`, `pkg/aws`, and `cmd/idpscim`.
 * **`errors.AsType[T]`:** Migrated `errors.As` calls to the generic `errors.AsType[T]` in `internal/core/sync.go` for type safety and performance.
 * **Fixed `os.Exit` in `Hash()`:** `internal/model.Hash()` no longer calls `os.Exit(1)` on nil input or encoding failure. It panics instead (appropriate for programming errors, recoverable, produces stack trace).
 
+### CLI Modernization (`idpscimcli`)
+
+Improved the `idpscimcli` command-line tool for code quality and testability:
+
+* **Fixed logger initialization bug:** Log handler options were applied after the handler was created, so log level and format from config had no effect. Fixed by configuring options before creating the handler.
+* **Testable error handling:** `getGWSDirectoryService` now returns errors instead of calling `os.Exit(1)`, allowing proper error propagation and unit testing.
+* **`show()` error handling:** The output function now returns errors instead of silently discarding marshal failures.
+* **Reduced code duplication:** Extracted `newSCIMHTTPClient()`, `newGWSHTTPClient()`, and `newAWSSCIMService()` helpers, eliminating 6 duplicated builder blocks.
+* **Added unit tests:** New tests for `show()` covering JSON, YAML, default format, marshal errors, and empty structs.
+* **Fixed typos:** "usrs" → "users", "Servive" → "Service" in command help text.
+
 ## v0.44.0
 
 ### Configurable User Fields

docs/idpscimcli.md

@@ -1,8 +1,8 @@
 # idpscimcli
 
-This is is a `command-line tool` to check and validate some functionalities implemented in idpscim.
+This is a `command-line tool` to check and validate some functionalities implemented in idpscim.
 
-The Idea of this tools is check the configuration you will implement in the [idpscim](idpscim.md) program, like the `filter` used for `Google Workspace Groups` and `Users` and the inventory of users and goups in both sides.
+The idea of this tool is to check the configuration you will implement in the [idpscim](idpscim.md) program, like the `filter` used for `Google Workspace Groups` and `Users` and the inventory of users and groups in both sides.
 
 ## idpscimcli --help
 
@@ -48,7 +48,7 @@ Use "idpscimcli [command] --help" for more information about a command.
 
 ## Building the project
 
-To build the project in local, you will need to have installed and configured at least the following:
+To build the project locally, you will need to have installed and configured at least the following:
 
 1. [git](https://git-scm.com/)
 2. [Go](https://go.dev/learn/)