activeprospect
diff --git a/‎.github/workflows/elixir.yml‎
Lines changed: 18 additions & 12 deletions b/‎.github/workflows/elixir.yml‎
Lines changed: 18 additions & 12 deletions
diff --git a/‎.github/workflows/release.yml‎
Lines changed: 1 addition & 1 deletion b/‎.github/workflows/release.yml‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎CHANGELOG.md‎
Lines changed: 97 additions & 0 deletions b/‎CHANGELOG.md‎
Lines changed: 97 additions & 0 deletions
diff --git a/‎README.md‎
Lines changed: 2 additions & 2 deletions b/‎README.md‎
Lines changed: 2 additions & 2 deletions
diff --git a/‎examples/phoenix_app/config/dev.exs‎
Lines changed: 1 addition & 1 deletion b/‎examples/phoenix_app/config/dev.exs‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎examples/phoenix_app/config/test.exs‎
Lines changed: 2 additions & 2 deletions b/‎examples/phoenix_app/config/test.exs‎
Lines changed: 2 additions & 2 deletions
diff --git a/‎examples/phoenix_app/lib/phoenix_app/accounts/accounts.ex‎
Lines changed: 13 additions & 2 deletions b/‎examples/phoenix_app/lib/phoenix_app/accounts/accounts.ex‎
Lines changed: 13 additions & 2 deletions
diff --git a/‎examples/phoenix_app/lib/phoenix_app/repo.ex‎
Lines changed: 1 addition & 1 deletion b/‎examples/phoenix_app/lib/phoenix_app/repo.ex‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎examples/phoenix_app/lib/phoenix_app_web/controllers/user_controller.ex‎
Lines changed: 13 additions & 6 deletions b/‎examples/phoenix_app/lib/phoenix_app_web/controllers/user_controller.ex‎
Lines changed: 13 additions & 6 deletions
diff --git a/‎examples/phoenix_app/lib/phoenix_app_web/controllers/user_controller_with_struct_specs.ex‎
Lines changed: 15 additions & 6 deletions b/‎examples/phoenix_app/lib/phoenix_app_web/controllers/user_controller_with_struct_specs.ex‎
Lines changed: 15 additions & 6 deletions
@@ -12,8 +12,8 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        otp: ['25']
-        elixir: ['1.13']
+        otp: ["26"]
+        elixir: ["1.16"]
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
       - uses: erlef/setup-beam@v1
@@ -34,7 +34,8 @@ jobs:
       - run: mix compile --warnings-as-errors
       - run: mix format --check-formatted
       - run: mix credo --strict --all
-      - run: mix dialyzer
+      - run: mix dialyzer --format github
+      - run: mix docs --warnings-as-errors
 
   test_examples:
     runs-on: ubuntu-latest
@@ -44,9 +45,10 @@ jobs:
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
       - uses: erlef/setup-beam@v1
+        id: beam
         with:
-          otp-version: 24
-          elixir-version: 1.13
+          otp-version: 26
+          elixir-version: 1.16
       - uses: actions/cache@cdf6c1fa76f9f475f3d7449005a359c84ca0f306 # v5.0.3
         with:
           key: |
@@ -61,20 +63,24 @@ jobs:
         run: mix do deps.get, test
 
   test:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
     name: Test (OTP ${{matrix.otp}} / Elixir ${{matrix.elixir}})
     strategy:
       matrix:
-        otp: ['22', '23', '24', '25']
-        elixir: ['1.10', '1.11', '1.12', '1.13']
+        otp: ["24", "25", "26"]
+        elixir: ["1.14", "1.15", "1.16", "1.18"]
+        # Test each elixir version with lowest and highest compatible OTP version, exclude others
+        # See https://hexdocs.pm/elixir/compatibility-and-deprecations.html#between-elixir-and-erlang-otp
         exclude:
-          - {otp: '24', elixir: '1.10'}
-          - {otp: '25', elixir: '1.10'}
-          - {otp: '25', elixir: '1.11'}
-          - {otp: '25', elixir: '1.12'}
+          - { otp: "24", elixir: "1.14" }
+          - { otp: "24", elixir: "1.18" }
+          - { otp: "25", elixir: "1.14" }
+          - { otp: "25", elixir: "1.15" }
+          - { otp: "25", elixir: "1.16" }
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
       - uses: erlef/setup-beam@v1
+        id: beam
         with:
           otp-version: ${{matrix.otp}}
           elixir-version: ${{matrix.elixir}}
 
@@ -16,7 +16,7 @@ jobs:
         id: beam
         with:
           otp-version: 25
-          elixir-version: 1.13
+          elixir-version: 1.14
 
       - id: deps
         name: Fetch and compile dependencies
 
@@ -5,6 +5,103 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## v3.22.3 - 2026-05-05
+
+* chore: removed unused require(s) by @David-Klemenc in https://github.com/open-api-spex/open_api_spex/pull/700
+* Relax decimal requirement by @josevalim in https://github.com/open-api-spex/open_api_spex/pull/702
+
+## v3.22.2 - 2026-01-08
+
+* fix: type warnings Elixir 1.19 by @davydog187 in https://github.com/open-api-spex/open_api_spex/pull/693
+
+## v3.22.1 - 2025-11-21
+
+* Fix elixir 1.19 support by @adamcstephens in https://github.com/open-api-spex/open_api_spex/pull/685
+
+## v3.22.0 - 2025-08-05
+
+* Support multiple apps in Plug.SwaggerUI by @zorbash in https://github.com/open-api-spex/open_api_spex/pull/676
+* Validate keys given to operation/2 macro by @xxdavid in https://github.com/open-api-spex/open_api_spex/pull/675
+
+## v3.21.5 - 2025-07-08
+
+* Fix assert_operation_response/2 references by @zorbash in https://github.com/open-api-spex/open_api_spex/pull/673
+
+## v3.21.4 - 2025-07-01
+
+* Fix OTP-28 support by @bopm in https://github.com/open-api-spex/open_api_spex/pull/672
+
+## v3.21.3 - 2025-06-25
+
+* Fix cast x-validate when decoded schema by @GPrimola in https://github.com/open-api-spex/open_api_spex/pull/647
+* Add examples property to Schema by @madjar in https://github.com/open-api-spex/open_api_spex/pull/654
+* Document schema resolver duplicate titles behaviour by @zorbash in https://github.com/open-api-spex/open_api_spex/pull/656
+* Fix 1.18 compilation warnings by @zorbash in https://github.com/open-api-spex/open_api_spex/pull/665
+
+## v3.21.2 - 2024-10-02
+
+* Use latest version of SwaggerUI by default, but allow it to be configured by @jarmo in https://github.com/open-api-spex/open_api_spex/pull/628
+* Exporting to YAML preserves nil values in examples by @zorbash in f3cd32bee2a
+
+## v3.21.1 - 2024-09-17
+
+* Fix schema inspection argument error by @zorbash. https://github.com/open-api-spex/open_api_spex/issues/636
+
+## v3.21.0 - 2024-09-12
+
+* Update dev dependencies and example apps by @zorbash in https://github.com/open-api-spex/open_api_spex/pull/624
+* Support casting decimals by @zorbash in https://github.com/open-api-spex/open_api_spex/pull/634
+* Support decoding operations with :servers. by @loguntsov in https://github.com/open-api-spex/open_api_spex/pull/635
+
+## v3.20.1 - 2024-07-31
+
+* Support custom error messages in custom validators by @GregorGrasselli in https://github.com/open-api-spex/open_api_spex/pull/621
+* Update Schema.example/2 typespec to allow references by @zorbash in 5ec452f
+
+## v3.20.0 - 2024-07-10
+
+* Respect minLength when generating string examples by @zorbash in https://github.com/open-api-spex/open_api_spex/pull/608
+* Accept read_write_scope from opts when calling cast functions directly by @albertored in https://github.com/open-api-spex/open_api_spex/pull/572
+* Allow Poison v6 to be used by @hkrutzer in https://github.com/open-api-spex/open_api_spex/pull/616
+* chore: Drop build matrix support for elixir 1.11, 1.12, 1.13 and OTP 22 by @mbuhot in https://github.com/open-api-spex/open_api_spex/pull/619
+* improvement: use struct spec to avoid double `%` in struct inspect by @zachdaniel in https://github.com/open-api-spex/open_api_spex/pull/613
+* Feat: add `--check` option in Mix tasks to compare the generated spec with a previously generated file by @davidebriani in https://github.com/open-api-spex/open_api_spex/pull/618
+* fix: cast numbers as floats by @David-Klemenc in https://github.com/open-api-spex/open_api_spex/pull/611
+
+## v3.19.1 - 2024-05-17
+
+* Add notice that body params are not merged into Conn.params whne using cast and validate plug by @hamir-suspect in #589
+* Set nonces on `<script>` and `<style>` elements if configured by @nathanalderson in #593
+* Ensure operation_id is always set on conn.private by @msutkowski in #606
+
+## v3.19.0 - 2024-04-30
+
+* Support response code ranges by @zorbash in 8898859da1
+
+## v3.18.3 - 2024-03-15
+
+* Relax dependency constraint on ymlr to allow version ~> 5.0 by @egze in https://github.com/open-api-spex/open_api_spex/pull/586
+
+## v3.18.2 - 2024-01-26
+
+* Fix 'AllOf cast returns a map, but I expected a struct' by @angelikatyborska in https://github.com/open-api-spex/open_api_spex/pull/592
+
+## v3.18.1 - 2023-12-19
+
+* Fix `assert_operation_response/2` header lookup by @msutkowski in https://github.com/open-api-spex/open_api_spex/pull/584
+* Exclude empty paths (`operation false`) from generated spec by @alisinabh in https://github.com/open-api-spex/open_api_spex/pull/583
+* Cast discriminator when no title present (#574) by @albertored in https://github.com/open-api-spex/open_api_spex/pull/574
+* Docstest Operation.parameter/5 by @zorbash
+* Document the spec export task `--filename` option by @zorbash
+
+## v3.18.0 - 2023-08-23
+
+* Relax dependency constraint on ymlr to allow version ~> 4.0 by @arcanemachine in https://github.com/open-api-spex/open_api_spex/pull/544
+* Fix deprecation warning on Elixir 1.15, require Elixir 1.11, adapt CI by @thbar in https://github.com/open-api-spex/open_api_spex/pull/550
+* Add `--quiet` option for spec generation by @Cowa in https://github.com/open-api-spex/open_api_spex/pull/557
+* Fix casting non-objects against discriminator #551 by @gianluca-nitti in https://github.com/open-api-spex/open_api_spex/pull/552
+* feat: add assert_operation_response, assert_raw_schema by @msutkowski in https://github.com/open-api-spex/open_api_spex/pull/545
+
 ## v3.17.3 - 2023-05-30
 
 * Raise meaningful error message when `SchemaResolver.resolve_schema_modules_from_schema` failed to pattern match by @yuchunc in https://github.com/open-api-spex/open_api_spex/pull/541
 
@@ -24,7 +24,7 @@ The package can be installed by adding `:open_api_spex` to your list of dependen
 ```elixir
 def deps do
   [
-    {:open_api_spex, "~> 3.16"}
+    {:open_api_spex, "~> 3.21"}
   ]
 end
 ```
@@ -282,7 +282,7 @@ mix openapi.spec.yaml --spec MyAppWeb.ApiSpec
 Invoking this task starts the application by default. This can be
 disabled with the `--start-app=false` option.
 
-Please make to replace any calls to [OpenApiSpex.Server.from_endpoint](https://hexdocs.pm/open_api_spex/OpenApiSpex.Server.html#from_endpoint/1) with a `%OpenApiSpex.Server{}` struct like below:
+Please replace any calls to [OpenApiSpex.Server.from_endpoint](https://hexdocs.pm/open_api_spex/OpenApiSpex.Server.html#from_endpoint/1) with a `%OpenApiSpex.Server{}` struct like below:
 
 ```elixir
   %OpenApi{
 
@@ -10,5 +10,5 @@ config :logger, :console, format: "[$level] $message\n"
 config :phoenix, :stacktrace_depth, 20
 
 config :phoenix_app, PhoenixApp.Repo,
-  adapter: Sqlite.Ecto2,
+  adapter: Ecto.Adapters.SQLite3,
   database: "priv/repo/phoenix_app_dev.db"
@@ -4,10 +4,10 @@ config :phoenix_app, PhoenixAppWeb.Endpoint,
   http: [port: 4001],
   server: false
 
-config :logger, level: :warn
+config :logger, level: :warning
 
 config :phoenix_app, PhoenixApp.Repo, pool: Ecto.Adapters.SQL.Sandbox
 
 config :phoenix_app, PhoenixApp.Repo,
-  adapter: Sqlite.Ecto2,
+  adapter: Ecto.Adapters.SQLite3,
   database: "priv/repo/phoenix_app_test.db"
@@ -2,8 +2,19 @@ defmodule PhoenixApp.Accounts do
   alias PhoenixApp.Accounts.User
   alias PhoenixApp.Repo
 
-  def list_users() do
-    Repo.all(User)
+  import Ecto.Query
+
+  def list_users(filters) do
+    query = from(u in User, order_by: [asc: u.id])
+
+    query =
+      if filters[:ids] do
+        from(u in query, where: u.id in ^filters[:ids])
+      else
+        query
+      end
+
+    Repo.all(query)
   end
 
   def get_user!(id) do
 
@@ -1,3 +1,3 @@
 defmodule PhoenixApp.Repo do
-  use Ecto.Repo, otp_app: :phoenix_app, adapter: Sqlite.Ecto2
+  use Ecto.Repo, otp_app: :phoenix_app, adapter: Ecto.Adapters.SQLite3
 end
@@ -21,13 +21,22 @@ defmodule PhoenixAppWeb.UserController do
   operation :index,
     summary: "List users",
     description: "List all users",
+    parameters: [
+      OpenApiSpex.Operation.parameter(
+        :ids,
+        :query,
+        %Schema{type: :array, items: %Schema{type: :integer}},
+        "Filter by user ids"
+      )
+    ],
     responses: [
       ok: {"User List Response", "application/json", Schemas.UsersResponse},
       unprocessable_entity: %Reference{"$ref": "#/components/responses/unprocessable_entity"}
     ]
 
-  def index(conn, _params) do
-    users = Accounts.list_users()
+  def index(conn, params) do
+    users = Accounts.list_users(params)
+
     render(conn, "index.json", users: users)
   end
 
@@ -37,8 +46,7 @@ defmodule PhoenixAppWeb.UserController do
     parameters: [
       group_id: [in: :path, type: :integer, description: "Group ID", example: 1]
     ],
-    request_body:
-      {"The user attributes", "application/json", Schemas.UserRequest, required: true},
+    request_body: {"The user attributes", "application/json", Schemas.UserRequest, required: true},
     responses: [
       created: {"User", "application/json", Schemas.UserResponse}
     ]
@@ -88,8 +96,7 @@ defmodule PhoenixAppWeb.UserController do
         required: true
       ]
     ],
-    request_body:
-      {"The user attributes", "application/json", Schemas.UserRequest, required: true},
+    request_body: {"The user attributes", "application/json", Schemas.UserRequest, required: true},
     responses: [
       ok: {"User", "application/json", Schemas.UserResponse}
     ]
 
@@ -4,8 +4,10 @@ defmodule PhoenixAppWeb.UserControllerWithStructSpecs do
   of using the ExDoc-based operation specs.
   """
   use PhoenixAppWeb, :controller
+
   import OpenApiSpex.Operation, only: [parameter: 5, request_body: 4, response: 3]
-  alias OpenApiSpex.{Operation, Reference}
+
+  alias OpenApiSpex.{Operation, Reference, Schema}
   alias PhoenixApp.{Accounts, Accounts.User}
   alias PhoenixAppWeb.Schemas
 
@@ -34,15 +36,24 @@ defmodule PhoenixAppWeb.UserControllerWithStructSpecs do
       summary: "List users",
       description: "List all useres",
       operationId: "UserController.index",
+      parameters: [
+        OpenApiSpex.Operation.parameter(
+          :ids,
+          :query,
+          %Schema{type: :array, items: %Schema{type: :integer}},
+          "Filter by user ids"
+        )
+      ],
       responses: %{
         200 => response("User List Response", "application/json", Schemas.UsersResponse),
         422 => %Reference{"$ref": "#/components/responses/unprocessable_entity"}
       }
     }
   end
 
-  def index(conn, _params) do
-    users = Accounts.list_users()
+  def index(conn, params) do
+    users = Accounts.list_users(params)
+
     render(conn, "index.json", users: users)
   end
 
@@ -56,9 +67,7 @@ defmodule PhoenixAppWeb.UserControllerWithStructSpecs do
         Operation.parameter(:group_id, :path, :integer, "Group ID", example: 1)
       ],
       requestBody:
-        request_body("The user attributes", "application/json", Schemas.UserRequest,
-          required: true
-        ),
+        request_body("The user attributes", "application/json", Schemas.UserRequest, required: true),
       responses: %{
         201 => response("User", "application/json", Schemas.UserResponse)
       }