swaggest / rest

Web services with OpenAPI and JSON Schema done quick in Go
https://pkg.go.dev/github.com/swaggest/rest
MIT License
362 stars 17 forks source link

Skip unexported fields in decoder #66

Closed vearutop closed 2 years ago

github-actions[bot] commented 2 years ago

Lines Of Code

Language Files Lines Code Comments Blanks Complexity Bytes
Go 96 6337 (+5) 4585 (+3) 439 (+1) 1313 (+1) 714 (+2) 154.8K (+68B)
Go (test) 43 4353 (+1) 3337 (+1) 132 884 118 121.3K (+104B)
YAML 10 675 (+2) 592 (+2) 46 37 0 20.9K (+39B)
github-actions[bot] commented 2 years ago

Unit Test Coverage

total: (statements) 82.8%

Coverage diff with base branch ```diff 104c104 < github.com/swaggest/rest/request/factory.go jsonParams 83.3% --- > github.com/swaggest/rest/request/factory.go jsonParams 85.7% ```
github-actions[bot] commented 2 years ago

Go API Changes

# summary
Inferred base version: v0.2.24
Suggested version: v0.2.25
codecov[bot] commented 2 years ago

Codecov Report

Merging #66 (8f81c71) into master (6d0e915) will increase coverage by 0.03%. The diff coverage is 100.00%.

@@            Coverage Diff             @@
##           master      #66      +/-   ##
==========================================
+ Coverage   76.76%   76.79%   +0.03%     
==========================================
  Files          27       27              
  Lines        1321     1323       +2     
==========================================
+ Hits         1014     1016       +2     
  Misses        194      194              
  Partials      113      113              
Flag Coverage Δ
unittests 76.79% <100.00%> (+0.03%) :arrow_up:

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files Coverage Δ
request/factory.go 86.48% <100.00%> (+0.24%) :arrow_up:

:mega: Codecov can now indicate which changes are the most critical in Pull Requests. Learn more

github-actions[bot] commented 2 years ago

Benchmark Result

Benchmark diff with base branch ``` name old time/op new time/op delta pkg:github.com/swaggest/rest/jsonschema goos:linux goarch:amd64 RequestValidator_ValidateRequestData-2 1.52µs ± 1% 1.54µs ± 1% +1.46% (p=0.032 n=5+5) pkg:github.com/swaggest/rest/request goos:linux goarch:amd64 Decoder_Decode-2 827ns ± 1% 849ns ± 7% +2.63% (p=0.032 n=5+5) DecoderFunc_Decode-2 2.46µs ± 2% 2.43µs ± 2% ~ (p=0.206 n=5+5) Decoder_Decode_json-2 26.9µs ± 2% 26.7µs ± 2% ~ (p=0.548 n=5+5) Decoder_Decode_queryObject-2 5.74µs ± 1% 5.80µs ± 1% ~ (p=0.063 n=5+5) Decoder_Decode_jsonParam-2 2.10µs ± 1% 2.11µs ± 1% ~ (p=1.000 n=5+5) DecoderFactory_SetDecoderFunc-2 1.98µs ± 1% 1.98µs ± 2% ~ (p=0.841 n=5+5) pkg:github.com/swaggest/rest/response/gzip goos:linux goarch:amd64 Middleware-2 13.8µs ± 1% 13.7µs ± 1% ~ (p=0.222 n=5+5) Middleware_control-2 3.77µs ± 1% 3.73µs ± 2% ~ (p=0.190 n=5+5) name old alloc/op new alloc/op delta pkg:github.com/swaggest/rest/jsonschema goos:linux goarch:amd64 RequestValidator_ValidateRequestData-2 2.46kB ± 0% 2.46kB ± 0% ~ (all equal) pkg:github.com/swaggest/rest/request goos:linux goarch:amd64 Decoder_Decode-2 440B ± 0% 440B ± 0% ~ (all equal) DecoderFunc_Decode-2 1.51kB ± 0% 1.51kB ± 0% ~ (all equal) Decoder_Decode_json-2 12.2kB ± 0% 12.2kB ± 0% ~ (all equal) Decoder_Decode_queryObject-2 2.00kB ± 0% 2.00kB ± 0% ~ (all equal) Decoder_Decode_jsonParam-2 736B ± 0% 736B ± 0% ~ (all equal) DecoderFactory_SetDecoderFunc-2 1.02kB ± 0% 1.02kB ± 0% ~ (all equal) pkg:github.com/swaggest/rest/response/gzip goos:linux goarch:amd64 Middleware-2 1.14kB ± 1% 1.14kB ± 2% ~ (p=0.841 n=4+5) Middleware_control-2 11.2kB ± 0% 11.2kB ± 0% ~ (all equal) name old allocs/op new allocs/op delta pkg:github.com/swaggest/rest/jsonschema goos:linux goarch:amd64 RequestValidator_ValidateRequestData-2 8.00 ± 0% 8.00 ± 0% ~ (all equal) pkg:github.com/swaggest/rest/request goos:linux goarch:amd64 Decoder_Decode-2 4.00 ± 0% 4.00 ± 0% ~ (all equal) DecoderFunc_Decode-2 12.0 ± 0% 12.0 ± 0% ~ (all equal) Decoder_Decode_json-2 177 ± 0% 177 ± 0% ~ (all equal) Decoder_Decode_queryObject-2 36.0 ± 0% 36.0 ± 0% ~ (all equal) Decoder_Decode_jsonParam-2 13.0 ± 0% 13.0 ± 0% ~ (all equal) DecoderFactory_SetDecoderFunc-2 16.0 ± 0% 16.0 ± 0% ~ (all equal) pkg:github.com/swaggest/rest/response/gzip goos:linux goarch:amd64 Middleware-2 11.0 ± 0% 11.0 ± 0% ~ (all equal) Middleware_control-2 9.00 ± 0% 9.00 ± 0% ~ (all equal) ```
Benchmark result ``` name time/op pkg:github.com/swaggest/rest/jsonschema goos:linux goarch:amd64 RequestValidator_ValidateRequestData-2 1.54µs ± 1% pkg:github.com/swaggest/rest/request goos:linux goarch:amd64 Decoder_Decode-2 849ns ± 7% DecoderFunc_Decode-2 2.43µs ± 2% Decoder_Decode_json-2 26.7µs ± 2% Decoder_Decode_queryObject-2 5.80µs ± 1% Decoder_Decode_jsonParam-2 2.11µs ± 1% DecoderFactory_SetDecoderFunc-2 1.98µs ± 2% pkg:github.com/swaggest/rest/response/gzip goos:linux goarch:amd64 Middleware-2 13.7µs ± 1% Middleware_control-2 3.73µs ± 2% name alloc/op pkg:github.com/swaggest/rest/jsonschema goos:linux goarch:amd64 RequestValidator_ValidateRequestData-2 2.46kB ± 0% pkg:github.com/swaggest/rest/request goos:linux goarch:amd64 Decoder_Decode-2 440B ± 0% DecoderFunc_Decode-2 1.51kB ± 0% Decoder_Decode_json-2 12.2kB ± 0% Decoder_Decode_queryObject-2 2.00kB ± 0% Decoder_Decode_jsonParam-2 736B ± 0% DecoderFactory_SetDecoderFunc-2 1.02kB ± 0% pkg:github.com/swaggest/rest/response/gzip goos:linux goarch:amd64 Middleware-2 1.14kB ± 2% Middleware_control-2 11.2kB ± 0% name allocs/op pkg:github.com/swaggest/rest/jsonschema goos:linux goarch:amd64 RequestValidator_ValidateRequestData-2 8.00 ± 0% pkg:github.com/swaggest/rest/request goos:linux goarch:amd64 Decoder_Decode-2 4.00 ± 0% DecoderFunc_Decode-2 12.0 ± 0% Decoder_Decode_json-2 177 ± 0% Decoder_Decode_queryObject-2 36.0 ± 0% Decoder_Decode_jsonParam-2 13.0 ± 0% DecoderFactory_SetDecoderFunc-2 16.0 ± 0% pkg:github.com/swaggest/rest/response/gzip goos:linux goarch:amd64 Middleware-2 11.0 ± 0% Middleware_control-2 9.00 ± 0% ```
github-actions[bot] commented 2 years ago

Examples Benchmark Result

Benchmark diff with base branch ``` name old time/op new time/op delta pkg:github.com/swaggest/rest/_examples/advanced goos:linux goarch:amd64 _directGzip-2 27.0µs ± 1% 27.1µs ± 0% ~ (p=0.556 n=4+5) _directGzipHead-2 27.6µs ± 7% 27.1µs ± 0% ~ (p=0.730 n=5+4) _noDirectGzip-2 160µs ± 2% 160µs ± 2% ~ (p=0.841 n=5+5) _directGzip_decode-2 517µs ± 3% 544µs ± 1% +5.21% (p=0.008 n=5+5) _noDirectGzip_decode-2 157µs ± 1% 159µs ± 1% ~ (p=0.310 n=5+5) _jsonBody-2 48.9µs ± 1% 49.6µs ± 2% ~ (p=0.151 n=5+5) _jsonBodyValidation-2 56.6µs ± 1% 56.7µs ± 1% ~ (p=0.841 n=5+5) _outputHeaders-2 26.3µs ± 0% 26.6µs ± 1% +1.13% (p=0.008 n=5+5) _requestResponseMapping-2 48.7µs ± 1% 49.1µs ± 1% ~ (p=0.063 n=5+5) _validation-2 52.9µs ± 3% 53.2µs ± 1% ~ (p=0.310 n=5+5) _noValidation-2 34.7µs ± 4% 34.5µs ± 0% ~ (p=1.000 n=5+5) pkg:github.com/swaggest/rest/_examples/advanced-generic goos:linux goarch:amd64 _directGzip-2 27.2µs ± 1% 27.4µs ± 0% ~ (p=0.343 n=4+4) _directGzipHead-2 27.3µs ± 1% 27.9µs ± 3% +2.50% (p=0.032 n=5+5) _noDirectGzip-2 158µs ± 0% 159µs ± 1% ~ (p=0.310 n=5+5) _directGzip_decode-2 520µs ± 1% 514µs ± 0% ~ (p=0.056 n=5+5) _noDirectGzip_decode-2 157µs ± 0% 157µs ± 0% ~ (p=0.222 n=5+5) _jsonBody-2 49.4µs ± 3% 49.8µs ± 1% ~ (p=0.151 n=5+5) _jsonBodyValidation-2 57.0µs ± 1% 57.4µs ± 1% ~ (p=0.548 n=5+5) _outputHeaders-2 26.5µs ± 1% 26.7µs ± 1% ~ (p=0.151 n=5+5) _requestResponseMapping-2 49.1µs ± 2% 49.3µs ± 1% ~ (p=0.548 n=5+5) _validation-2 52.7µs ± 1% 53.7µs ± 1% +1.94% (p=0.008 n=5+5) _noValidation-2 53.1µs ± 2% 53.8µs ± 1% ~ (p=0.095 n=5+5) pkg:github.com/swaggest/rest/_examples/task-api/internal/infra/nethttp goos:linux goarch:amd64 _notFoundSrv-2 31.4µs ± 2% 31.2µs ± 1% ~ (p=0.556 n=5+4) _ok-2 31.7µs ± 1% 31.6µs ± 1% ~ (p=0.889 n=5+5) _invalidBody-2 44.9µs ± 2% 44.9µs ± 1% ~ (p=0.841 n=5+5) name old B:rcvd/op new B:rcvd/op delta pkg:github.com/swaggest/rest/_examples/advanced goos:linux goarch:amd64 _directGzip-2 639 ± 0% 639 ± 0% ~ (all equal) _directGzipHead-2 183 ± 0% 183 ± 0% ~ (all equal) _noDirectGzip-2 1.04k ± 0% 1.04k ± 0% ~ (all equal) _directGzip_decode-2 639 ± 0% 639 ± 0% ~ (all equal) _noDirectGzip_decode-2 1.04k ± 0% 1.04k ± 0% ~ (all equal) _jsonBody-2 208 ± 0% 208 ± 0% ~ (all equal) _jsonBodyValidation-2 194 ± 0% 194 ± 0% ~ (all equal) _outputHeaders-2 155 ± 0% 155 ± 0% ~ (all equal) _requestResponseMapping-2 94.0 ± 0% 94.0 ± 0% ~ (all equal) _validation-2 177 ± 0% 177 ± 0% ~ (all equal) _noValidation-2 177 ± 0% 177 ± 0% ~ (all equal) pkg:github.com/swaggest/rest/_examples/advanced-generic goos:linux goarch:amd64 _directGzip-2 639 ± 0% 639 ± 0% ~ (all equal) _directGzipHead-2 183 ± 0% 183 ± 0% ~ (all equal) _noDirectGzip-2 1.04k ± 0% 1.04k ± 0% ~ (all equal) _directGzip_decode-2 639 ± 0% 639 ± 0% ~ (all equal) _noDirectGzip_decode-2 1.04k ± 0% 1.04k ± 0% ~ (all equal) _jsonBody-2 208 ± 0% 208 ± 0% ~ (all equal) _jsonBodyValidation-2 194 ± 0% 194 ± 0% ~ (all equal) _outputHeaders-2 155 ± 0% 155 ± 0% ~ (all equal) _requestResponseMapping-2 94.0 ± 0% 94.0 ± 0% ~ (all equal) _validation-2 177 ± 0% 177 ± 0% ~ (all equal) _noValidation-2 177 ± 0% 177 ± 0% ~ (all equal) pkg:github.com/swaggest/rest/_examples/task-api/internal/infra/nethttp goos:linux goarch:amd64 _notFoundSrv-2 337 ± 0% 337 ± 0% ~ (all equal) _ok-2 359 ± 0% 359 ± 0% ~ (all equal) _invalidBody-2 435 ± 0% 435 ± 0% ~ (all equal) name old B:sent/op new B:sent/op delta pkg:github.com/swaggest/rest/_examples/advanced goos:linux goarch:amd64 _directGzip-2 103 ± 0% 103 ± 0% ~ (all equal) _directGzipHead-2 104 ± 0% 104 ± 0% ~ (all equal) _noDirectGzip-2 117 ± 0% 117 ± 0% ~ (all equal) _directGzip_decode-2 116 ± 0% 116 ± 0% ~ (all equal) _noDirectGzip_decode-2 130 ± 0% 130 ± 0% ~ (all equal) _jsonBody-2 188 ± 0% 188 ± 0% ~ (all equal) _jsonBodyValidation-2 192 ± 0% 192 ± 0% ~ (all equal) _outputHeaders-2 77.0 ± 0% 77.0 ± 0% ~ (all equal) _requestResponseMapping-2 169 ± 0% 169 ± 0% ~ (all equal) _validation-2 170 ± 0% 170 ± 0% ~ (all equal) _noValidation-2 173 ± 0% 173 ± 0% ~ (all equal) pkg:github.com/swaggest/rest/_examples/advanced-generic goos:linux goarch:amd64 _directGzip-2 103 ± 0% 103 ± 0% ~ (all equal) _directGzipHead-2 104 ± 0% 104 ± 0% ~ (all equal) _noDirectGzip-2 117 ± 0% 117 ± 0% ~ (all equal) _directGzip_decode-2 116 ± 0% 116 ± 0% ~ (all equal) _noDirectGzip_decode-2 130 ± 0% 130 ± 0% ~ (all equal) _jsonBody-2 188 ± 0% 188 ± 0% ~ (all equal) _jsonBodyValidation-2 192 ± 0% 192 ± 0% ~ (all equal) _outputHeaders-2 77.0 ± 0% 77.0 ± 0% ~ (all equal) _requestResponseMapping-2 169 ± 0% 169 ± 0% ~ (all equal) _validation-2 170 ± 0% 170 ± 0% ~ (all equal) _noValidation-2 173 ± 0% 173 ± 0% ~ (all equal) pkg:github.com/swaggest/rest/_examples/task-api/internal/infra/nethttp goos:linux goarch:amd64 _notFoundSrv-2 74.0 ± 0% 74.0 ± 0% ~ (all equal) _ok-2 74.0 ± 0% 74.0 ± 0% ~ (all equal) _invalidBody-2 137 ± 0% 137 ± 0% ~ (all equal) name old rps new rps delta pkg:github.com/swaggest/rest/_examples/advanced goos:linux goarch:amd64 _directGzip-2 37.0k ± 1% 36.9k ± 0% ~ (p=0.556 n=4+5) _directGzipHead-2 36.2k ± 6% 36.9k ± 0% ~ (p=0.730 n=5+4) _noDirectGzip-2 6.26k ± 2% 6.26k ± 2% ~ (p=0.841 n=5+5) _directGzip_decode-2 1.94k ± 3% 1.84k ± 1% -4.98% (p=0.008 n=5+5) _noDirectGzip_decode-2 6.35k ± 1% 6.31k ± 1% ~ (p=0.310 n=5+5) _jsonBody-2 20.4k ± 1% 20.2k ± 2% ~ (p=0.151 n=5+5) _jsonBodyValidation-2 17.7k ± 1% 17.6k ± 1% ~ (p=0.841 n=5+5) _outputHeaders-2 38.0k ± 0% 37.6k ± 1% -1.12% (p=0.008 n=5+5) _requestResponseMapping-2 20.5k ± 1% 20.4k ± 1% ~ (p=0.095 n=5+5) _validation-2 18.9k ± 3% 18.8k ± 1% ~ (p=0.310 n=5+5) _noValidation-2 28.9k ± 4% 29.0k ± 0% ~ (p=1.000 n=5+5) pkg:github.com/swaggest/rest/_examples/advanced-generic goos:linux goarch:amd64 _directGzip-2 36.8k ± 1% 36.6k ± 0% ~ (p=0.343 n=4+4) _directGzipHead-2 36.7k ± 1% 35.8k ± 3% -2.40% (p=0.032 n=5+5) _noDirectGzip-2 6.34k ± 0% 6.31k ± 1% ~ (p=0.341 n=5+5) _directGzip_decode-2 1.92k ± 1% 1.95k ± 0% ~ (p=0.056 n=5+5) _noDirectGzip_decode-2 6.37k ± 0% 6.36k ± 0% ~ (p=0.222 n=5+5) _jsonBody-2 20.3k ± 3% 20.1k ± 1% ~ (p=0.151 n=5+5) _jsonBodyValidation-2 17.5k ± 1% 17.4k ± 1% ~ (p=0.548 n=5+5) _outputHeaders-2 37.7k ± 1% 37.4k ± 1% ~ (p=0.151 n=5+5) _requestResponseMapping-2 20.4k ± 2% 20.3k ± 1% ~ (p=0.548 n=5+5) _validation-2 19.0k ± 1% 18.6k ± 1% -1.90% (p=0.008 n=5+5) _noValidation-2 18.8k ± 2% 18.6k ± 1% ~ (p=0.095 n=5+5) pkg:github.com/swaggest/rest/_examples/task-api/internal/infra/nethttp goos:linux goarch:amd64 _notFoundSrv-2 31.8k ± 2% 32.1k ± 1% ~ (p=0.556 n=5+4) _ok-2 31.5k ± 1% 31.6k ± 1% ~ (p=0.841 n=5+5) _invalidBody-2 22.3k ± 2% 22.2k ± 1% ~ (p=0.730 n=5+5) name old alloc/op new alloc/op delta pkg:github.com/swaggest/rest/_examples/advanced goos:linux goarch:amd64 _directGzip-2 3.92kB ± 0% 3.92kB ± 0% ~ (p=0.135 n=5+5) _directGzipHead-2 3.92kB ± 0% 3.92kB ± 0% ~ (p=0.429 n=5+5) _noDirectGzip-2 6.79kB ±21% 6.31kB ±20% ~ (p=0.310 n=5+5) _directGzip_decode-2 402kB ± 0% 402kB ± 0% ~ (p=0.310 n=5+5) _noDirectGzip_decode-2 5.62kB ±11% 5.31kB ± 4% ~ (p=0.421 n=5+5) _jsonBody-2 13.2kB ± 0% 13.2kB ± 0% +0.02% (p=0.048 n=5+5) _jsonBodyValidation-2 19.0kB ± 0% 19.0kB ± 0% ~ (p=0.810 n=5+5) _outputHeaders-2 3.71kB ± 0% 3.71kB ± 0% ~ (p=0.635 n=5+4) _requestResponseMapping-2 16.6kB ± 0% 16.6kB ± 0% ~ (p=0.810 n=5+5) _validation-2 16.6kB ± 0% 16.6kB ± 0% ~ (p=0.159 n=4+5) _noValidation-2 6.13kB ± 0% 6.12kB ± 0% ~ (p=0.548 n=5+5) pkg:github.com/swaggest/rest/_examples/advanced-generic goos:linux goarch:amd64 _directGzip-2 3.94kB ± 0% 3.94kB ± 0% ~ (p=0.556 n=5+5) _directGzipHead-2 3.94kB ± 0% 3.94kB ± 0% ~ (p=0.762 n=5+5) _noDirectGzip-2 6.49kB ±15% 6.57kB ±20% ~ (p=1.000 n=5+5) _directGzip_decode-2 403kB ± 0% 402kB ± 0% ~ (p=0.151 n=5+5) _noDirectGzip_decode-2 5.15kB ± 3% 5.65kB ±14% +9.81% (p=0.032 n=5+5) _jsonBody-2 13.3kB ± 0% 13.3kB ± 0% ~ (p=0.190 n=5+5) _jsonBodyValidation-2 19.0kB ± 0% 19.0kB ± 0% ~ (p=0.921 n=5+5) _outputHeaders-2 3.71kB ± 0% 3.71kB ± 0% ~ (p=0.952 n=5+5) _requestResponseMapping-2 16.7kB ± 0% 16.7kB ± 0% ~ (p=0.341 n=5+5) _validation-2 16.6kB ± 0% 16.6kB ± 0% ~ (p=0.421 n=5+5) _noValidation-2 16.6kB ± 0% 16.6kB ± 0% ~ (p=0.889 n=5+5) pkg:github.com/swaggest/rest/_examples/task-api/internal/infra/nethttp goos:linux goarch:amd64 _notFoundSrv-2 4.88kB ± 0% 4.88kB ± 0% ~ (p=1.000 n=5+5) _ok-2 4.78kB ± 0% 4.78kB ± 0% ~ (p=0.543 n=4+4) _invalidBody-2 8.67kB ± 0% 8.67kB ± 0% ~ (p=0.543 n=4+4) name old allocs/op new allocs/op delta pkg:github.com/swaggest/rest/_examples/advanced goos:linux goarch:amd64 _directGzip-2 42.0 ± 0% 42.0 ± 0% ~ (all equal) _directGzipHead-2 42.0 ± 0% 42.0 ± 0% ~ (all equal) _noDirectGzip-2 49.8 ± 4% 49.8 ± 4% ~ (p=1.000 n=5+5) _directGzip_decode-2 500 ± 0% 500 ± 0% ~ (all equal) _noDirectGzip_decode-2 50.0 ± 0% 50.0 ± 0% ~ (all equal) _jsonBody-2 127 ± 0% 127 ± 0% ~ (all equal) _jsonBodyValidation-2 183 ± 0% 183 ± 0% ~ (all equal) _outputHeaders-2 37.0 ± 0% 37.0 ± 0% ~ (all equal) _requestResponseMapping-2 123 ± 0% 123 ± 0% ~ (all equal) _validation-2 152 ± 0% 152 ± 0% ~ (all equal) _noValidation-2 72.0 ± 0% 72.0 ± 0% ~ (all equal) pkg:github.com/swaggest/rest/_examples/advanced-generic goos:linux goarch:amd64 _directGzip-2 43.0 ± 0% 43.0 ± 0% ~ (all equal) _directGzipHead-2 43.0 ± 0% 43.0 ± 0% ~ (all equal) _noDirectGzip-2 50.8 ± 4% 50.8 ± 4% ~ (p=1.000 n=5+5) _directGzip_decode-2 501 ± 0% 501 ± 0% ~ (p=0.444 n=5+5) _noDirectGzip_decode-2 51.0 ± 0% 51.0 ± 0% ~ (all equal) _jsonBody-2 128 ± 0% 128 ± 0% ~ (all equal) _jsonBodyValidation-2 184 ± 0% 184 ± 0% ~ (all equal) _outputHeaders-2 37.0 ± 0% 37.0 ± 0% ~ (all equal) _requestResponseMapping-2 124 ± 0% 124 ± 0% ~ (all equal) _validation-2 153 ± 0% 153 ± 0% ~ (all equal) _noValidation-2 153 ± 0% 153 ± 0% ~ (all equal) pkg:github.com/swaggest/rest/_examples/task-api/internal/infra/nethttp goos:linux goarch:amd64 _notFoundSrv-2 54.0 ± 0% 54.0 ± 0% ~ (all equal) _ok-2 50.0 ± 0% 50.0 ± 0% ~ (all equal) _invalidBody-2 100 ± 0% 100 ± 0% ~ (all equal) ```