From f4b181a20180f1853351be53a32865b6209d0ab4 Mon Sep 17 00:00:00 2001
From: jaydenelliott <jayden.elliott@outlook.com>
Date: Tue, 28 Mar 2023 22:25:50 +1100
Subject: [PATCH] Rename_all attribute documentation

---
 postgres-derive-test/src/enums.rs | 10 +++++-----
 postgres-derive/src/fromsql.rs    |  4 ++--
 postgres-derive/src/tosql.rs      |  4 ++--
 postgres-types/src/lib.rs         | 31 +++++++++++++++++++++++++++++++
 4 files changed, 40 insertions(+), 9 deletions(-)

diff --git a/postgres-derive-test/src/enums.rs b/postgres-derive-test/src/enums.rs
index e44f3761..36d42843 100644
--- a/postgres-derive-test/src/enums.rs
+++ b/postgres-derive-test/src/enums.rs
@@ -58,15 +58,15 @@ fn rename_all_overrides() {
     #[derive(Debug, ToSql, FromSql, PartialEq)]
     #[postgres(name = "mood", rename_all = "snake_case")]
     enum Mood {
-        Sad,
+        VerySad,
         #[postgres(name = "okay")]
         Ok,
-        Happy,
+        VeryHappy,
     }
 
     let mut conn = Client::connect("user=postgres host=localhost port=5433", NoTls).unwrap();
     conn.execute(
-        "CREATE TYPE pg_temp.mood AS ENUM ('sad', 'okay', 'happy')",
+        "CREATE TYPE pg_temp.mood AS ENUM ('very_sad', 'okay', 'very_happy')",
         &[],
     )
     .unwrap();
@@ -75,9 +75,9 @@ fn rename_all_overrides() {
         &mut conn,
         "mood",
         &[
-            (Mood::Sad, "'sad'"),
+            (Mood::VerySad, "'very_sad'"),
             (Mood::Ok, "'okay'"),
-            (Mood::Happy, "'happy'"),
+            (Mood::VeryHappy, "'very_happy'"),
         ],
     );
 }
diff --git a/postgres-derive/src/fromsql.rs b/postgres-derive/src/fromsql.rs
index 4deb23ed..a9150411 100644
--- a/postgres-derive/src/fromsql.rs
+++ b/postgres-derive/src/fromsql.rs
@@ -17,10 +17,10 @@ use crate::overrides::Overrides;
 pub fn expand_derive_fromsql(input: DeriveInput) -> Result<TokenStream, Error> {
     let overrides = Overrides::extract(&input.attrs, true)?;
 
-    if overrides.name.is_some() && overrides.transparent {
+    if (overrides.name.is_some() || overrides.rename_all.is_some()) && overrides.transparent {
         return Err(Error::new_spanned(
             &input,
-            "#[postgres(transparent)] is not allowed with #[postgres(name = \"...\")]",
+            "#[postgres(transparent)] is not allowed with #[postgres(name = \"...\")] or #[postgres(rename_all = \"...\")]",
         ));
     }
 
diff --git a/postgres-derive/src/tosql.rs b/postgres-derive/src/tosql.rs
index dbeeb16c..ec760231 100644
--- a/postgres-derive/src/tosql.rs
+++ b/postgres-derive/src/tosql.rs
@@ -15,10 +15,10 @@ use crate::overrides::Overrides;
 pub fn expand_derive_tosql(input: DeriveInput) -> Result<TokenStream, Error> {
     let overrides = Overrides::extract(&input.attrs, true)?;
 
-    if overrides.name.is_some() && overrides.transparent {
+    if (overrides.name.is_some() || overrides.rename_all.is_some()) && overrides.transparent {
         return Err(Error::new_spanned(
             &input,
-            "#[postgres(transparent)] is not allowed with #[postgres(name = \"...\")]",
+            "#[postgres(transparent)] is not allowed with #[postgres(name = \"...\")] or #[postgres(rename_all = \"...\")]",
         ));
     }
 
diff --git a/postgres-types/src/lib.rs b/postgres-types/src/lib.rs
index fa49d99e..5fca049a 100644
--- a/postgres-types/src/lib.rs
+++ b/postgres-types/src/lib.rs
@@ -125,6 +125,37 @@
 //!     Happy,
 //! }
 //! ```
+//!
+//! Alternatively, the `#[postgres(rename_all = "...")]` attribute can be used to rename all fields or variants
+//! with the chosen casing convention. This will not affect the struct or enum's type name. Note that
+//! `#[postgres(name = "...")]` takes precendence when used in conjunction with `#[postgres(rename_all = "...")]`:
+//!
+//! ```rust
+//! # #[cfg(feature = "derive")]
+//! use postgres_types::{ToSql, FromSql};
+//!
+//! # #[cfg(feature = "derive")]
+//! #[derive(Debug, ToSql, FromSql)]
+//! #[postgres(name = "mood", rename_all = "snake_case")]
+//! enum Mood {
+//!     VerySad,        // very_sad
+//!     #[postgres(name = "ok")]
+//!     Ok,             // ok
+//!     VeryHappy,      // very_happy
+//! }
+//! ```
+//!
+//! The following case conventions are supported:
+//! - `"lowercase"`
+//! - `"UPPERCASE"`
+//! - `"PascalCase"`
+//! - `"camelCase"`
+//! - `"snake_case"`
+//! - `"SCREAMING_SNAKE_CASE"`
+//! - `"kebab-case"`
+//! - `"SCREAMING-KEBAB-CASE"`
+//! - `"Train-Case"`
+
 #![doc(html_root_url = "https://docs.rs/postgres-types/0.2")]
 #![warn(clippy::all, rust_2018_idioms, missing_docs)]