I promise I'm not deleting your code

CHANGELOG.md

@@ -1,5 +1,18 @@
 # CHANGELOG
 
+## Unreleased
+
+- Before writing the generated queries, Squirrel will make sure to not overwrite
+  any file that was not automatically generated.
+  In case a file with the same name already exists, Squirrel will refuse to
+  overwrite it and prompt the used to first rename the existing file.
+  ([Giacomo Cavalieri](https://github.com/giacomocavalieri))
+
+- Squirrel will now include a doc comment at the beginning of each generated
+  module, explaining where the queries come from and what version of squirrel
+  was used to generate the code.
+  ([Giacomo Cavalieri](https://github.com/giacomocavalieri))
+
 ## 4.1.0 - 2025-07-28
 
 - Squirrel will now pick files under a project's `test` and `dev` directories.

birdie_snapshots/array_decoding.accepted

@@ -1,9 +1,16 @@
 ---
-version: 1.3.0
+version: 1.3.2
 title: array decoding
 file: ./test/squirrel_test.gleam
 test_name: array_decoding_test
 ---
+
+//// This module contains the code to run the sql queries defined in
+//// `./test-directory`.
+//// > 🐿️ This module was generated automatically using v-test of
+//// > the [squirrel package](https://github.com/giacomocavalieri/squirrel).
+////
+
 import gleam/dynamic/decode
 import pog
 

birdie_snapshots/array_encoding.accepted

@@ -1,9 +1,16 @@
 ---
-version: 1.3.0
+version: 1.3.2
 title: array encoding
 file: ./test/squirrel_test.gleam
 test_name: array_encoding_test
 ---
+
+//// This module contains the code to run the sql queries defined in
+//// `./test-directory`.
+//// > 🐿️ This module was generated automatically using v-test of
+//// > the [squirrel package](https://github.com/giacomocavalieri/squirrel).
+////
+
 import gleam/dynamic/decode
 import pog
 

birdie_snapshots/bool_decoding.accepted

@@ -1,9 +1,16 @@
 ---
-version: 1.3.0
+version: 1.3.2
 title: bool decoding
 file: ./test/squirrel_test.gleam
 test_name: bool_decoding_test
 ---
+
+//// This module contains the code to run the sql queries defined in
+//// `./test-directory`.
+//// > 🐿️ This module was generated automatically using v-test of
+//// > the [squirrel package](https://github.com/giacomocavalieri/squirrel).
+////
+
 import gleam/dynamic/decode
 import pog
 

birdie_snapshots/bool_encoding.accepted

@@ -1,9 +1,16 @@
 ---
-version: 1.3.0
+version: 1.3.2
 title: bool encoding
 file: ./test/squirrel_test.gleam
 test_name: bool_encoding_test
 ---
+
+//// This module contains the code to run the sql queries defined in
+//// `./test-directory`.
+//// > 🐿️ This module was generated automatically using v-test of
+//// > the [squirrel package](https://github.com/giacomocavalieri/squirrel).
+////
+
 import gleam/dynamic/decode
 import pog
 

birdie_snapshots/bytea_decoding.accepted

@@ -1,9 +1,16 @@
 ---
-version: 1.3.0
+version: 1.3.2
 title: bytea decoding
 file: ./test/squirrel_test.gleam
 test_name: bytea_decoding_test
 ---
+
+//// This module contains the code to run the sql queries defined in
+//// `./test-directory`.
+//// > 🐿️ This module was generated automatically using v-test of
+//// > the [squirrel package](https://github.com/giacomocavalieri/squirrel).
+////
+
 import gleam/dynamic/decode
 import pog
 

birdie_snapshots/bytea_encoding.accepted

@@ -1,9 +1,16 @@
 ---
-version: 1.3.0
+version: 1.3.2
 title: bytea encoding
 file: ./test/squirrel_test.gleam
 test_name: bytea_encoding_test
 ---
+
+//// This module contains the code to run the sql queries defined in
+//// `./test-directory`.
+//// > 🐿️ This module was generated automatically using v-test of
+//// > the [squirrel package](https://github.com/giacomocavalieri/squirrel).
+////
+
 import gleam/dynamic/decode
 import pog
 

birdie_snapshots/char_decoding.accepted

@@ -1,9 +1,16 @@
 ---
-version: 1.3.0
+version: 1.3.2
 title: char decoding
 file: ./test/squirrel_test.gleam
 test_name: char_decoding_test
 ---
+
+//// This module contains the code to run the sql queries defined in
+//// `./test-directory`.
+//// > 🐿️ This module was generated automatically using v-test of
+//// > the [squirrel package](https://github.com/giacomocavalieri/squirrel).
+////
+
 import gleam/dynamic/decode
 import pog
 

birdie_snapshots/char_encoding.accepted

@@ -1,9 +1,16 @@
 ---
-version: 1.3.0
+version: 1.3.2
 title: char encoding
 file: ./test/squirrel_test.gleam
 test_name: char_encoding_test
 ---
+
+//// This module contains the code to run the sql queries defined in
+//// `./test-directory`.
+//// > 🐿️ This module was generated automatically using v-test of
+//// > the [squirrel package](https://github.com/giacomocavalieri/squirrel).
+////
+
 import gleam/dynamic/decode
 import pog
 

birdie_snapshots/date_decoding.accepted

@@ -1,9 +1,16 @@
 ---
-version: 1.3.1
+version: 1.3.2
 title: date decoding
 file: ./test/squirrel_test.gleam
 test_name: date_decoding_test
 ---
+
+//// This module contains the code to run the sql queries defined in
+//// `./test-directory`.
+//// > 🐿️ This module was generated automatically using v-test of
+//// > the [squirrel package](https://github.com/giacomocavalieri/squirrel).
+////
+
 import gleam/dynamic/decode
 import gleam/time/calendar.{type Date}
 import pog

birdie_snapshots/date_encoding.accepted

@@ -1,9 +1,16 @@
 ---
-version: 1.3.1
+version: 1.3.2
 title: date encoding
 file: ./test/squirrel_test.gleam
 test_name: date_encoding_test
 ---
+
+//// This module contains the code to run the sql queries defined in
+//// `./test-directory`.
+//// > 🐿️ This module was generated automatically using v-test of
+//// > the [squirrel package](https://github.com/giacomocavalieri/squirrel).
+////
+
 import gleam/dynamic/decode
 import pog
 

birdie_snapshots/decode_success_with_long_builder_close_to_80_chars_is_properly_formatted_not_breaking_it_on_a_different_line.accepted

@@ -1,9 +1,16 @@
 ---
-version: 1.3.0
+version: 1.3.2
 title: decode.success with long builder close to 80 chars is properly formatted not breaking it on a different line
 file: ./test/squirrel_test.gleam
 test_name: decode_success_with_long_builder_close_to_80_chars_is_properly_formatted_not_breaking_it_on_a_different_line_test
 ---
+
+//// This module contains the code to run the sql queries defined in
+//// `./test-directory`.
+//// > 🐿️ This module was generated automatically using v-test of
+//// > the [squirrel package](https://github.com/giacomocavalieri/squirrel).
+////
+
 import gleam/dynamic/decode
 import pog
 

birdie_snapshots/decode_success_with_long_builder_is_properly_formatted_not_breaking_it_on_a_different_line.accepted

@@ -1,9 +1,16 @@
 ---
-version: 1.3.0
+version: 1.3.2
 title: decode.success with long builder is properly formatted not breaking it on a different line
 file: ./test/squirrel_test.gleam
 test_name: decode_success_with_long_builder_is_properly_formatted_not_breaking_it_on_a_different_line_test
 ---
+
+//// This module contains the code to run the sql queries defined in
+//// `./test-directory`.
+//// > 🐿️ This module was generated automatically using v-test of
+//// > the [squirrel package](https://github.com/giacomocavalieri/squirrel).
+////
+
 import gleam/dynamic/decode
 import pog
 

birdie_snapshots/enum_array_decoding.accepted

@@ -1,9 +1,16 @@
 ---
-version: 1.3.0
+version: 1.3.2
 title: enum array decoding
 file: ./test/squirrel_test.gleam
 test_name: enum_array_decoding_test
 ---
+
+//// This module contains the code to run the sql queries defined in
+//// `./test-directory`.
+//// > 🐿️ This module was generated automatically using v-test of
+//// > the [squirrel package](https://github.com/giacomocavalieri/squirrel).
+////
+
 import gleam/dynamic/decode
 import pog
 

birdie_snapshots/enum_decoding.accepted

@@ -1,9 +1,16 @@
 ---
-version: 1.3.0
+version: 1.3.2
 title: enum decoding
 file: ./test/squirrel_test.gleam
 test_name: enum_decoding_test
 ---
+
+//// This module contains the code to run the sql queries defined in
+//// `./test-directory`.
+//// > 🐿️ This module was generated automatically using v-test of
+//// > the [squirrel package](https://github.com/giacomocavalieri/squirrel).
+////
+
 import gleam/dynamic/decode
 import pog
 

birdie_snapshots/enum_encoding.accepted

@@ -1,9 +1,16 @@
 ---
-version: 1.3.0
+version: 1.3.2
 title: enum encoding
 file: ./test/squirrel_test.gleam
 test_name: enum_encoding_test
 ---
+
+//// This module contains the code to run the sql queries defined in
+//// `./test-directory`.
+//// > 🐿️ This module was generated automatically using v-test of
+//// > the [squirrel package](https://github.com/giacomocavalieri/squirrel).
+////
+
 import gleam/dynamic/decode
 import pog
 

birdie_snapshots/fields_appear_in_the_order_they_have_in_the_select_list.accepted

@@ -1,9 +1,16 @@
 ---
-version: 1.3.0
+version: 1.3.2
 title: fields appear in the order they have in the select list
 file: ./test/squirrel_test.gleam
 test_name: fields_appear_in_the_order_they_have_in_the_select_list_test
 ---
+
+//// This module contains the code to run the sql queries defined in
+//// `./test-directory`.
+//// > 🐿️ This module was generated automatically using v-test of
+//// > the [squirrel package](https://github.com/giacomocavalieri/squirrel).
+////
+
 import gleam/dynamic/decode
 import pog
 

birdie_snapshots/float4_decoding.accepted

@@ -1,9 +1,16 @@
 ---
-version: 1.3.1
+version: 1.3.2
 title: float4 decoding
 file: ./test/squirrel_test.gleam
 test_name: float4_decoding_test
 ---
+
+//// This module contains the code to run the sql queries defined in
+//// `./test-directory`.
+//// > 🐿️ This module was generated automatically using v-test of
+//// > the [squirrel package](https://github.com/giacomocavalieri/squirrel).
+////
+
 import gleam/dynamic/decode
 import pog
 

birdie_snapshots/float4_encoding.accepted

@@ -1,9 +1,16 @@
 ---
-version: 1.3.1
+version: 1.3.2
 title: float4 encoding
 file: ./test/squirrel_test.gleam
 test_name: float4_encoding_test
 ---
+
+//// This module contains the code to run the sql queries defined in
+//// `./test-directory`.
+//// > 🐿️ This module was generated automatically using v-test of
+//// > the [squirrel package](https://github.com/giacomocavalieri/squirrel).
+////
+
 import gleam/dynamic/decode
 import pog
 

birdie_snapshots/float8_decoding.accepted

@@ -1,9 +1,16 @@
 ---
-version: 1.3.1
+version: 1.3.2
 title: float8 decoding
 file: ./test/squirrel_test.gleam
 test_name: float8_decoding_test
 ---
+
+//// This module contains the code to run the sql queries defined in
+//// `./test-directory`.
+//// > 🐿️ This module was generated automatically using v-test of
+//// > the [squirrel package](https://github.com/giacomocavalieri/squirrel).
+////
+
 import gleam/dynamic/decode
 import pog
 

birdie_snapshots/float8_encoding.accepted

@@ -1,9 +1,16 @@
 ---
-version: 1.3.1
+version: 1.3.2
 title: float8 encoding
 file: ./test/squirrel_test.gleam
 test_name: float8_encoding_test
 ---
+
+//// This module contains the code to run the sql queries defined in
+//// `./test-directory`.
+//// > 🐿️ This module was generated automatically using v-test of
+//// > the [squirrel package](https://github.com/giacomocavalieri/squirrel).
+////
+
 import gleam/dynamic/decode
 import pog
 

birdie_snapshots/full_join_columns_are_optional.accepted

@@ -1,9 +1,16 @@
 ---
-version: 1.3.0
+version: 1.3.2
 title: full join columns are optional
 file: ./test/squirrel_test.gleam
 test_name: full_join_columns_are_optional_test
 ---
+
+//// This module contains the code to run the sql queries defined in
+//// `./test-directory`.
+//// > 🐿️ This module was generated automatically using v-test of
+//// > the [squirrel package](https://github.com/giacomocavalieri/squirrel).
+////
+
 import gleam/dynamic/decode
 import gleam/option.{type Option}
 import pog