Release notes from framework

v0.21.1

2025-11-13T23:27:42Z

Fixed

Fix improper handling of optional file uploads (#595) (@Blacksmoke16)

v0.21.0

2025-09-05T00:00:33Z

Changed

Breaking: Leverage ATH::AbstractFile within ATH::BinaryFileResponse (#563) (@Blacksmoke16)
Leverage mime component within ATH::BinaryFileResponse (#545) (@Blacksmoke16)
Setter methods on ATH::Response and subclasses now return self to better support method chaining (#563) (@Blacksmoke16)

Added

Add support for Athena Contract component types (#544) (@Blacksmoke16)
Add native file upload support (#559) (@Blacksmoke16)

Fixed

Correctly apply emit_nil value from ATHA::View (#526) (@Blacksmoke16)

v0.20.1

2025-02-08T19:31:06Z

Fixed

Fix ATH::ViewHandler bundle configuration values not being correctly set (#520) (@Blacksmoke16)

v0.20.0

2025-01-26T20:40:17Z

Changed

Breaking: Normalize exception types (#428) (@Blacksmoke16)
Breaking: The ATHR::Interface.configuration macro is no longer scoped to the resolver namespace (#425) (@Blacksmoke16)
Breaking: Rename ATHR::RequestBody::Extract to ATHA::MapRequestBody (#425) (@Blacksmoke16)
Breaking: Rename ATHR::Time::Format to ATHA::MapTime (#425) (@Blacksmoke16)
Update minimum crystal version to ~> 1.14.0 (#433) (@Blacksmoke16)
Refactor auto redirection logic to be more robust (#436, #480) (@Blacksmoke16)
Refactor ATHR::RequestBody to raise more accurate deserialization errors (#490) (@Blacksmoke16)

Added

Add support for Proxies & Load Balancers (#440, #444) (@Blacksmoke16)
Add new trusted_host bundle scheme property to allow setting trusted hostnames (#474) (@Blacksmoke16)
Add support for deserializing application/x-www-form-urlencoded bodies via ATHA::MapRequestBody (#477) (@Blacksmoke16)
Add ATHA::MapQueryString to map a request's query string into a DTO type (#477) (@Blacksmoke16)
Add ATH::Exception.from_status helper method (#426) (@Blacksmoke16)
Add ATHA::MapQueryParameter for handling query parameters (#426) (@Blacksmoke16)
Add #validation_groups and #accept_formats annotation properties to ATHA::MapRequestBody (#486) (@Blacksmoke16)
Add #validation_groups annotation property to ATHA::MapQueryString (#486) (@Blacksmoke16)
Add ATH::Request#port and ATH::Response#redirect? methods (#436) (@Blacksmoke16)
Add #host, #scheme, #secure?, and #from_trusted_proxy? methods to ATH::Request (#440) (@Blacksmoke16)
Add ATH::Request#content_type_format to return the request format's name from its content-type header (#477) (@Blacksmoke16)
Add ATH::IPUtils module (#440) (@Blacksmoke16)
Add .unquote, .split, and .combine methods ATH::HeaderUtils (#440) (@Blacksmoke16)
Add request matchers for headers and query parameters (#491) (@Blacksmoke16)

Removed

Breaking: Remove ATHA::QueryParam (#426) (@Blacksmoke16)
Breaking: Remove ATHA::RequestParam (#426) (@Blacksmoke16)
Breaking: Remove ATH::Exception::InvalidParameter (#426) (@Blacksmoke16)
Breaking: Remove everything within ATH::Params namespace (#426) (@Blacksmoke16)
Breaking: Remove ATH::Action#params (#426) (@Blacksmoke16)
Breaking: Remove ATH::Listeners::ParamFetcher (#426) (@Blacksmoke16)

Fixed

Fix query parameters being dropped when redirecting to a trailing/non-trailing slash endpoint (#436) (@Blacksmoke16)
Fix auto redirection with non-standard ports (#480) (@Blacksmoke16)
Fix multipart/form-data not being mapped to the form format (#441) (@Blacksmoke16)
Fix being unable to provide the path of an ARTA::Route annotation on a class as a positional argument (#482) (@Blacksmoke16)
Fix error when attempting to use ATH::Controller#redirect_view and ATH::Controller#route_redirect_view (#498) (@Blacksmoke16)
Fix error when attempting to use ATH::Spec::APITestCase#unlink (#498) (@Blacksmoke16)

v0.19.2

2024-07-31T17:34:24Z

Added

Add ATH.run_console as an easier entrypoint into the console application (#413) (@Blacksmoke16)
Add support for additional boolean conversion values from request attributes (#422) (@Blacksmoke16)

Changed

Breaking: ATH::RequestMatcher::Method now requires an Array(String) as opposed to any Enumerable(String) (#431) (@Blacksmoke16)
Update minimum crystal version to ~> 1.13.0 (#433) (@Blacksmoke16)
Updates usages of UTF-8 in response headers to utf-8 as preferred by the RFC (#417) (@Blacksmoke16)

Fixed

Fix the content negotiation implementation not working (#431) (@Blacksmoke16)

v0.19.1

2024-04-27T14:20:31Z

Fixed

Fix framework component docs landing on an empty page (#399) (@Blacksmoke16)
Fix Athena::Clock not being aliased to the interface correctly (#400) (@Blacksmoke16)
Fix ATHA::View annotation being defined in incorrect namespace (#403) (@Blacksmoke16)
Fix ATH::ErrorRenderer not being aliased to the interface correctly (#404) (@Blacksmoke16)

v0.19.0

2024-04-10T00:23:40Z

Changed

Breaking: change how framework features are configured (#337, #374, #383) (@Blacksmoke16)
Update minimum crystal version to ~> 1.11.0 (#270) (@Blacksmoke16)
Integrate website into monorepo (#365) (@Blacksmoke16)

Added

Support for Windows OS (#270) (@Blacksmoke16)
Add ATH::RequestMatcher as a generic way of matching an ATH::Request given a set of rules (#338) (@Blacksmoke16)
Raise an exception if a controller's return value fails to serialize instead of just returning nil (#357) (@Blacksmoke16)
Add support for new Crystal 1.12 Process.on_terminate method (#394) (@Blacksmoke16)

Fixed

Fix macro splat deprecation (#330) (@Blacksmoke16)
Normalize ATH::Request#method to always be uppercase (#338) (@Blacksmoke16)
Fixed not being able to use top level configuration annotations on controller action parameters (#356) (@Blacksmoke16)

v0.18.2

2023-10-10T03:24:27Z

Changed

Change routing logic to redirect GET and HEAD requests with a trailing slash to the route without one if it exists, and vice versa (#307) (@Blacksmoke16)

Added

Add native tab completion support to the built-in ATH::Commands (#296) (@Blacksmoke16)
Add support for defining multiple route annotations on a single controller action method (#315) (@Blacksmoke16)
Require the new Athena::Clock component (#318) (@Blacksmoke16)
Add additional ATH::Spec::APITestCase request helper methods (#312, #313) (@Blacksmoke16)

Fixed

Fix incorrectly generated route paths with a controller level prefix and no action level / prefix (#308) (@Blacksmoke16)

v0.18.1

2023-05-29T19:31:58Z

Added

Add support for serializing arbitrarily nested controller action return types (#273) (@Blacksmoke16)
Allow using constants for controller action's path (#279) (@Blacksmoke16)

Fixed

Fix incorrect content-length header value when returning multi-byte strings (#288) (@Blacksmoke16)

v0.18.0

2023-02-21T00:19:42Z

Changed

Breaking: upgrade Athena::EventDispatcher to 0.2.x (#205) (@Blacksmoke16)
Breaking: deprecate the ATH::ParamConverter concept in favor of Value Resolvers (#243) (@Blacksmoke16)
Breaking: rename various types/methods to better adhere to crystal-lang/crystal#10374 (#243) (@Blacksmoke16)
Breaking: Change ATH::Spec::AbstractBrowser to be a class (#249) (@Blacksmoke16)
Breaking: upgrade Athena::Validator to 0.3.x (#250) (@Blacksmoke16)
Improve service ATH::Controllers to not need the public: true ADI::Register field (#213) (@Blacksmoke16)
Update minimum crystal version to ~> 1.6.0 (#205) (@Blacksmoke16)

Added

Add trace logging to ATH::Listeners::CORS to aid in debugging (#265) (@Blacksmoke16)
Introduce new framework.debug parameter that is true if the binary was not built with the --release flag (#249) (@Blacksmoke16)
Add built-in HTTP Expectation methods to ATH::Spec::WebTestCase (#249) (@Blacksmoke16)
Add #response and #request methods to ATH::Spec::AbstractBrowser types (#249) (@Blacksmoke16)
Add ATHR alias to make using value resolver annotations easier (#243) (@Blacksmoke16)
Add ATH::Commands::Commands::DebugEventDispatcher framework CLI command to aid in debugging the event dispatcher (#241) (@Blacksmoke16)
Add ATH::Commands::Commands::DebugRouter and ATH::Commands::Commands::DebugRouterMatch framework CLI commands to aid in debugging the router (#224) (@Blacksmoke16)
Add integration for the Athena::Console component (#218) (@Blacksmoke16)

Fixed

Correctly populate content-length based on the response content's size (#267) (@Blacksmoke16)
Prevent wildcard CORS expose_headers value when allow_credentials is true (#264) (@Blacksmoke16)
Correctly handle JSON::Serializable values within Hash/NamedTuple controller action return types (#253) (@Blacksmoke16)
Fix ATH::ParameterBag#get? not returning nil if it could not convert the value to the desired type (#243) (@Blacksmoke16)