Arrays support

.golangci-version

@@ -1 +1 @@
-v1.59.1
+v1.60.1

.golangci.yml

@@ -212,6 +212,9 @@ linters-settings:
     # Default: false
     all: true
 
+  dupl:
+    # 150 by default is not enough and leads to false positives
+    threshold: 200
 
 linters:
   disable-all: true
@@ -353,6 +356,8 @@ issues:
         - noctx
         - wrapcheck
         - gocognit
+        - gocyclo
+        - cyclop
     - path: "(routes/handlers/(.+)_(controller|params)\\.go)|(routes/models/(.+)\\.go)|(internal/(.+)_validation\\.go)"
       linters:
         - lll # hard to control line length in generated code

README.md

@@ -11,22 +11,36 @@ Project status: **pre-alpha**.
 
 ## TODOs
 
+### General
+* Installation and usage instructions
+* Documentation on generated code structure and suggested patterns
+
 ### Golang
+* enums
+* simple types directly in body
+* array types directly in body
+* allow handling as plain http handler
 * authentication
 * per route middleware
-* allow handling as plain http handler
-* nullable types
 * polymorphic models
-* enums
 
 ### Typescript
-
 Set of features compatible with golang
 
 ## Supported OpenAPI features
 
 Some language specific features may be challenging (if possible) to implement correctly. The [Language specific caveats](#language-specific-caveats) summarises various implementation details.
 
+### Parameter Serialization
+
+[OpenAPI Spec Reference](https://swagger.io/docs/specification/serialization/)
+
+Supported serialization styles:
+|parameter location|style|explode|example primitive type|example array type|object support|
+|----|----|----|----|----|----|
+|path|simple|false|`/users/5`|`/users/3,4,5`|-|
+|query|form|true|`/users?id=5`|`/users?id=3&id=4&id=5`|-|
+
 ###  Data types
 
 #### All types
@@ -36,6 +50,7 @@ Some language specific features may be challenging (if possible) to implement co
 |number/integer|✓|✓|
 |boolean|✓|✓|
 |object|✓|✓|
+|array|✓|✓|
 
 #### Strings
 |format|in|minLength|maxLength|pattern|
@@ -60,10 +75,20 @@ Some language specific features may be challenging (if possible) to implement co
 |----|----|----|
 |boolean|query,path,body|✓|
 
-#### Object
+#### Objects
 
 Objects are only supported in request body of `application/json` content type.
 
+#### Arrays
+|items type|in|minItems|maxItems|
+|----|----|----|----|
+|string|query,path,body|✓|✓|
+|number|query,path,body|✓|✓|
+|integer|query,path,body|✓|✓|
+|boolean|query,path,body|✓|✓|
+|object|body|✓|✓|
+
+
 ### Language specific caveats
 
 Golang:
@@ -72,6 +97,10 @@ Golang:
   * The `required` check on booleans in request body is not performed
   * For simple data types - will validate if the field is non default
   * For objects - optional and nullable are synonyms. This means that required validation will only work for non nullable fields.
+* `array` fields
+  * `required` is equivalent to `minItems: 1`
+  * `nullable` arrays are only supported in request body
+  * nullable and optional array fields are synonyms
 
 ## Contributing
 

examples/go-apigen-server/go.mod

@@ -1,5 +1,5 @@
 module github.com/gemyago/apigen/examples/go-apigen-server
 
-go 1.22
+go 1.23
 
-require golang.org/x/exp v0.0.0-20240613232115-7f521ea00fb8
+require golang.org/x/exp v0.0.0-20240808152545-0cdaa3abc0fa

examples/go-apigen-server/go.sum

@@ -1,2 +1,4 @@
 golang.org/x/exp v0.0.0-20240613232115-7f521ea00fb8 h1:yixxcjnhBmY0nkL253HFVIm0JsFHwrHdT3Yh6szTnfY=
 golang.org/x/exp v0.0.0-20240613232115-7f521ea00fb8/go.mod h1:jj3sYF3dwk5D+ghuXyeI3r5MFf+NT2An6/9dOA95KSI=
+golang.org/x/exp v0.0.0-20240808152545-0cdaa3abc0fa h1:ELnwvuAXPNtPk1TJRuGkI9fDTwym6AYBu0qzT8AcHdI=
+golang.org/x/exp v0.0.0-20240808152545-0cdaa3abc0fa/go.mod h1:akd2r19cwCdwSwWeIdzYQGa/EZZyqcOdwWiwj5L5eKQ=