From 11fed5a4666f4360a4032991007a44d76e7124de Mon Sep 17 00:00:00 2001 From: Sergio Benitez Date: Wed, 1 Nov 2023 18:48:41 -0500 Subject: [PATCH] Document '&[u8]' form/data guard, limits. --- core/lib/src/data/limits.rs | 4 +++- core/lib/src/form/from_form.rs | 3 ++- 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/core/lib/src/data/limits.rs b/core/lib/src/data/limits.rs index 9606304e..535d843a 100644 --- a/core/lib/src/data/limits.rs +++ b/core/lib/src/data/limits.rs @@ -59,8 +59,10 @@ use crate::http::uncased::Uncased; /// | `data-form` | 2MiB | [`Form`] | entire data-based form | /// | `file` | 1MiB | [`TempFile`] | [`TempFile`] data guard or form field | /// | `file/$ext` | _N/A_ | [`TempFile`] | file form field with extension `$ext` | -/// | `string` | 8KiB | [`String`] | data guard or data form field | +/// | `string` | 8KiB | [`String`] | data guard or form field | +/// | `string` | 8KiB | [`&str`] | data guard or form field | /// | `bytes` | 8KiB | [`Vec`] | data guard | +/// | `bytes` | 8KiB | [`&[u8]`] | data guard or form field | /// | `json` | 1MiB | [`Json`] | JSON data and form payloads | /// | `msgpack` | 1MiB | [`MsgPack`] | MessagePack data and form payloads | /// diff --git a/core/lib/src/form/from_form.rs b/core/lib/src/form/from_form.rs index f44be8cf..347b62d8 100644 --- a/core/lib/src/form/from_form.rs +++ b/core/lib/src/form/from_form.rs @@ -116,11 +116,12 @@ use crate::http::uncased::AsUncased; /// | _nonzero_ int | _inherit_ | **no default** | No | Yes | `NonZero{I,U}{size,8,16,32,64,128}` | /// | float | _inherit_ | **no default** | No | Yes | `f{32,64}` | /// | `&str` | _inherit_ | **no default** | Yes | Yes | Percent-decoded. Data limit `string` applies. | +/// | `&[u8]` | _inherit_ | **no default** | Yes | Yes | Raw bytes. Data limit `bytes` applies. | /// | `String` | _inherit_ | **no default** | Yes | Yes | Exactly `&str`, but owned. Prefer `&str`. | /// | IP Address | _inherit_ | **no default** | No | Yes | [`IpAddr`], [`Ipv4Addr`], [`Ipv6Addr`] | /// | Socket Address | _inherit_ | **no default** | No | Yes | [`SocketAddr`], [`SocketAddrV4`], [`SocketAddrV6`] | /// | [`TempFile`] | _inherit_ | **no default** | Yes | Yes | Data limits apply. See [`TempFile`]. | -/// | [`Capped`] | _inherit_ | **no default** | Yes | Yes | `C` is `&str`, `String`, `&[u8]` or `TempFile`. | +/// | [`Capped`] | _inherit_ | **no default** | Yes | Yes | `C` is `&str`, `String`, `&[u8]` or `TempFile`. | /// | [`time::Date`] | _inherit_ | **no default** | No | Yes | `%F` (`YYYY-MM-DD`). HTML "date" input. | /// | [`time::DateTime`] | _inherit_ | **no default** | No | Yes | `%FT%R` or `%FT%T` (`YYYY-MM-DDTHH:MM[:SS]`) | /// | [`time::Time`] | _inherit_ | **no default** | No | Yes | `%R` or `%T` (`HH:MM[:SS]`) |