Refactor individual extensions into traits

Package.swift

@@ -113,6 +113,7 @@ let package = Package(
 			name: "CSQLite",
 			targets: [
 				"CSQLite",
+				"CSQLiteExtensions",
 			]),
 	],
 	traits: [
@@ -261,6 +262,27 @@ let package = Package(
 			name: "ENABLE_STAT4",
 			description: "Enables the sqlite_stat4 table"
 		),
+		// Statically linked extensions
+		.trait(
+			name: "CSQLITE_ENABLE_DECIMAL_EXTENSION",
+			description: "Enables the statically linked decimal extension"
+		),
+		.trait(
+			name: "CSQLITE_ENABLE_IEEE754_EXTENSION",
+			description: "Enables the statically linked ieee754 extension"
+		),
+		.trait(
+			name: "CSQLITE_ENABLE_SERIES_EXTENSION",
+			description: "Enables the statically linked series extension"
+		),
+		.trait(
+			name: "CSQLITE_ENABLE_SHA3_EXTENSION",
+			description: "Enables the statically linked sha3 extension"
+		),
+		.trait(
+			name: "CSQLITE_ENABLE_UUID_EXTENSION",
+			description: "Enables the statically linked uuid extension"
+		),
 		// Default traits
 		.default(enabledTraits: [
 			"DQS_0",
@@ -284,26 +306,96 @@ let package = Package(
 			"ENABLE_SNAPSHOT",
 			"ENABLE_STMTVTAB",
 			"ENABLE_STAT4",
+			"CSQLITE_ENABLE_DECIMAL_EXTENSION",
+			"CSQLITE_ENABLE_IEEE754_EXTENSION",
+			"CSQLITE_ENABLE_SERIES_EXTENSION",
+			"CSQLITE_ENABLE_SHA3_EXTENSION",
+			"CSQLITE_ENABLE_UUID_EXTENSION",
 		]),
 	],
 	targets: [
 		// Targets are the basic building blocks of a package, defining a module or a test suite.
 		// Targets can depend on other targets in this package and products from dependencies.
 		.target(
 			name: "CSQLite",
-			cSettings: compileTimeOptions + platformConfiguration + features + [
+			cSettings: compileTimeOptions + platformConfiguration + features,
+			linkerSettings: [
+				.linkedLibrary("m"),
+			]),
+		.target(
+			name: "CSQLiteExtensions",
+			dependencies: [
+				.targetItem(name: "CSQLiteDecimalExtension", condition: .when(traits: ["CSQLITE_ENABLE_DECIMAL_EXTENSION"])),
+				.targetItem(name: "CSQLiteIEEE754Extension", condition: .when(traits: ["CSQLITE_ENABLE_IEEE754_EXTENSION"])),
+				.targetItem(name: "CSQLiteSeriesExtension", condition: .when(traits: ["CSQLITE_ENABLE_SERIES_EXTENSION"])),
+				.targetItem(name: "CSQLiteSHA3Extension", condition: .when(traits: ["CSQLITE_ENABLE_SHA3_EXTENSION"])),
+				.targetItem(name: "CSQLiteUUIDExtension", condition: .when(traits: ["CSQLITE_ENABLE_UUID_EXTENSION"])),
+			]),
+		.target(
+			name: "CSQLiteDecimalExtension",
+			dependencies: [
+				"CSQLite",
+			],
+			path: "Sources/extensions/decimal",
+			cSettings: [
 				// For statically linking extensions
 				// https://sqlite.org/loadext.html#statically_linking_a_run_time_loadable_extension
 				.define("SQLITE_CORE", to: "1"),
+			]),
+		.target(
+			name: "CSQLiteIEEE754Extension",
+			dependencies: [
+				"CSQLite",
 			],
-			linkerSettings: [
-				.linkedLibrary("m"),
+			path: "Sources/extensions/ieee754",
+			cSettings: [
+				// For statically linking extensions
+				// https://sqlite.org/loadext.html#statically_linking_a_run_time_loadable_extension
+				.define("SQLITE_CORE", to: "1"),
+			]),
+		.target(
+			name: "CSQLiteSeriesExtension",
+			dependencies: [
+				"CSQLite",
+			],
+			path: "Sources/extensions/series",
+			cSettings: [
+				// For statically linking extensions
+				// https://sqlite.org/loadext.html#statically_linking_a_run_time_loadable_extension
+				.define("SQLITE_CORE", to: "1"),
+			]),
+		.target(
+			name: "CSQLiteSHA3Extension",
+			dependencies: [
+				"CSQLite",
+			],
+			path: "Sources/extensions/sha3",
+			cSettings: [
+				// For statically linking extensions
+				// https://sqlite.org/loadext.html#statically_linking_a_run_time_loadable_extension
+				.define("SQLITE_CORE", to: "1"),
+			]),
+		.target(
+			name: "CSQLiteUUIDExtension",
+			dependencies: [
+				"CSQLite",
+			],
+			path: "Sources/extensions/uuid",
+			cSettings: [
+				// For statically linking extensions
+				// https://sqlite.org/loadext.html#statically_linking_a_run_time_loadable_extension
+				.define("SQLITE_CORE", to: "1"),
 			]),
 		.testTarget(
 			name: "CSQLiteTests",
 			dependencies: [
 				"CSQLite",
-			])
+			]),
+		.testTarget(
+			name: "CSQLiteExtensionsTests",
+			dependencies: [
+				"CSQLiteExtensions",
+			]),
 	],
 	cLanguageStandard: .gnu11
 )

Package@swift-5.3.swift

@@ -96,26 +96,92 @@ let package = Package(
 			name: "CSQLite",
 			targets: [
 				"CSQLite",
+				"CSQLiteExtensions",
 			]),
 	],
 	targets: [
 		// Targets are the basic building blocks of a package, defining a module or a test suite.
 		// Targets can depend on other targets in this package and products from dependencies.
 		.target(
 			name: "CSQLite",
-			cSettings: compileTimeOptions + platformConfiguration + features + [
+			cSettings: compileTimeOptions + platformConfiguration + features,
+			linkerSettings: [
+				.linkedLibrary("m"),
+			]),
+		.target(
+			name: "CSQLiteExtensions",
+			dependencies: [
+				"CSQLiteDecimalExtension",
+				"CSQLiteIEEE754Extension",
+				"CSQLiteSeriesExtension",
+				"CSQLiteSHA3Extension",
+				"CSQLiteUUIDExtension",
+			]),
+		.target(
+			name: "CSQLiteDecimalExtension",
+			dependencies: [
+				"CSQLite",
+			],
+			path: "Sources/extensions/decimal",
+			cSettings: [
 				// For statically linking extensions
 				// https://sqlite.org/loadext.html#statically_linking_a_run_time_loadable_extension
 				.define("SQLITE_CORE", to: "1"),
+			]),
+		.target(
+			name: "CSQLiteIEEE754Extension",
+			dependencies: [
+				"CSQLite",
 			],
-			linkerSettings: [
-				.linkedLibrary("m"),
+			path: "Sources/extensions/ieee754",
+			cSettings: [
+				// For statically linking extensions
+				// https://sqlite.org/loadext.html#statically_linking_a_run_time_loadable_extension
+				.define("SQLITE_CORE", to: "1"),
+			]),
+		.target(
+			name: "CSQLiteSeriesExtension",
+			dependencies: [
+				"CSQLite",
+			],
+			path: "Sources/extensions/series",
+			cSettings: [
+				// For statically linking extensions
+				// https://sqlite.org/loadext.html#statically_linking_a_run_time_loadable_extension
+				.define("SQLITE_CORE", to: "1"),
+			]),
+		.target(
+			name: "CSQLiteSHA3Extension",
+			dependencies: [
+				"CSQLite",
+			],
+			path: "Sources/extensions/sha3",
+			cSettings: [
+				// For statically linking extensions
+				// https://sqlite.org/loadext.html#statically_linking_a_run_time_loadable_extension
+				.define("SQLITE_CORE", to: "1"),
+			]),
+		.target(
+			name: "CSQLiteUUIDExtension",
+			dependencies: [
+				"CSQLite",
+			],
+			path: "Sources/extensions/uuid",
+			cSettings: [
+				// For statically linking extensions
+				// https://sqlite.org/loadext.html#statically_linking_a_run_time_loadable_extension
+				.define("SQLITE_CORE", to: "1"),
 			]),
 		.testTarget(
 			name: "CSQLiteTests",
 			dependencies: [
 				"CSQLite",
-			])
+			]),
+		.testTarget(
+			name: "CSQLiteExtensionsTests",
+			dependencies: [
+				"CSQLiteExtensions",
+			]),
 	],
 	cLanguageStandard: .gnu11
 )

README.md

@@ -83,6 +83,18 @@ The following traits enable commonly-used SQLite features:
 > [!NOTE]
 > The `ENABLE_SESSION` trait also sets the `ENABLE_PREUPDATE_HOOK` trait.
 
+### Statically Linked Extensions
+
+The following traits enable statically linked SQLite extensions and helper functions for automatic extension registration:
+
+| Package Trait | Default | SQLite Extension |
+| --- | :---: | --- |
+| CSQLITE_ENABLE_DECIMAL_EXTENSION | Y | [decimal](https://sqlite.org/floatingpoint.html#the_decimal_c_extension) |
+| CSQLITE_ENABLE_IEEE754_EXTENSION | Y | [ieee754](https://sqlite.org/floatingpoint.html#the_ieee754_c_extension) |
+| CSQLITE_ENABLE_SERIES_EXTENSION | Y | [series](https://www.sqlite.org/src/file/ext/misc/series.c) |
+| CSQLITE_ENABLE_SHA3_EXTENSION | Y | [sha3](https://www.sqlite.org/src/file/ext/misc/shathree.c) |
+| CSQLITE_ENABLE_UUID_EXTENSION | Y | [uuid](https://www.sqlite.org/src/file/ext/misc/uuid.c) |
+
 ## License
 
 SQLite is in the [public domain](https://sqlite.org/copyright.html).

Sources/CSQLite/csqlite_shims.c

@@ -295,60 +295,3 @@ int csqlite_sqlite3_vtab_uses_all_schemas(sqlite3 *db)
 {
 	return sqlite3_vtab_config(db, SQLITE_VTAB_USES_ALL_SCHEMAS);
 }
-
-// MARK: - Database extensions
-
-void sqlite3_decimal_init(void);
-int csqlite_sqlite3_auto_extension_decimal()
-{
-	return sqlite3_auto_extension(sqlite3_decimal_init);
-}
-
-int csqlite_sqlite3_cancel_auto_extension_decimal()
-{
-	return sqlite3_cancel_auto_extension(sqlite3_decimal_init);
-}
-
-void sqlite3_ieee_init(void);
-int csqlite_sqlite3_auto_extension_ieee754()
-{
-	return sqlite3_auto_extension(sqlite3_ieee_init);
-}
-
-int csqlite_sqlite3_cancel_auto_extension_ieee754()
-{
-	return sqlite3_cancel_auto_extension(sqlite3_ieee_init);
-}
-
-void sqlite3_series_init(void);
-int csqlite_sqlite3_auto_extension_series()
-{
-	return sqlite3_auto_extension(sqlite3_series_init);
-}
-
-int csqlite_sqlite3_cancel_auto_extension_series()
-{
-	return sqlite3_cancel_auto_extension(sqlite3_series_init);
-}
-
-void sqlite3_shathree_init(void);
-int csqlite_sqlite3_auto_extension_sha3()
-{
-	return sqlite3_auto_extension(sqlite3_shathree_init);
-}
-
-int csqlite_sqlite3_cancel_auto_extension_sha3()
-{
-	return sqlite3_cancel_auto_extension(sqlite3_shathree_init);
-}
-
-void sqlite3_uuid_init(void);
-int csqlite_sqlite3_auto_extension_uuid()
-{
-	return sqlite3_auto_extension(sqlite3_uuid_init);
-}
-
-int csqlite_sqlite3_cancel_auto_extension_uuid()
-{
-	return sqlite3_cancel_auto_extension(sqlite3_uuid_init);
-}

Sources/CSQLite/include/csqlite_shims.h

@@ -141,31 +141,3 @@ int csqlite_sqlite3_vtab_config_innocuous(sqlite3 *db);
 int csqlite_sqlite3_vtab_config_directonly(sqlite3 *db);
 /// Equivalent to `sqlite3_vtab_config(db, SQLITE_VTAB_USES_ALL_SCHEMAS)`
 int csqlite_sqlite3_vtab_uses_all_schemas(sqlite3 *db);
-
-// MARK: - Database extensions
-// See https://sqlite.org/loadext.html
-
-/// Equivalent to `sqlite3_auto_extension(sqlite3_decimal_init)`
-int csqlite_sqlite3_auto_extension_decimal(void);
-/// Equivalent to `sqlite3_cancel_auto_extension(sqlite3_decimal_init)`
-int csqlite_sqlite3_cancel_auto_extension_decimal(void);
-
-/// Equivalent to `sqlite3_auto_extension(sqlite3_ieee_init)`
-int csqlite_sqlite3_auto_extension_ieee754(void);
-/// Equivalent to `sqlite3_cancel_auto_extension(sqlite3_ieee_init)`
-int csqlite_sqlite3_cancel_auto_extension_ieee754(void);
-
-/// Equivalent to `sqlite3_auto_extension(sqlite3_series_init)`
-int csqlite_sqlite3_auto_extension_series(void);
-/// Equivalent to `sqlite3_cancel_auto_extension(sqlite3_series_init)`
-int csqlite_sqlite3_cancel_auto_extension_series(void);
-
-/// Equivalent to `sqlite3_auto_extension(sqlite3_shathree_init)`
-int csqlite_sqlite3_auto_extension_sha3(void);
-/// Equivalent to `sqlite3_cancel_auto_extension(sqlite3_shathree_init)`
-int csqlite_sqlite3_cancel_auto_extension_sha3(void);
-
-/// Equivalent to `sqlite3_auto_extension(sqlite3_uuid_init)`
-int csqlite_sqlite3_auto_extension_uuid(void);
-/// Equivalent to `sqlite3_cancel_auto_extension(sqlite3_uuid_init)`
-int csqlite_sqlite3_cancel_auto_extension_uuid(void);

Sources/CSQLiteExtensions/CSQLiteExtensions.swift

@@ -0,0 +1,38 @@
+/*
+ ** 2025-05-30
+ **
+ ** The author disclaims copyright to this source code.  In place of
+ ** a legal notice, here is a blessing:
+ **
+ **    May you do good and not evil.
+ **    May you find forgiveness for yourself and forgive others.
+ **    May you share freely, never taking more than you give.
+ **
+ ******************************************************************************
+ **
+ ** Functions to manage automatic database extension registration from Swift.
+ */
+
+#if false
+@_exported import CSQLite
+#endif
+
+#if swift(<6.1) || CSQLITE_ENABLE_DECIMAL_EXTENSION
+@_exported import CSQLiteDecimalExtension
+#endif
+
+#if swift(<6.1) || CSQLITE_ENABLE_IEEE754_EXTENSION
+@_exported import CSQLiteIEEE754Extension
+#endif
+
+#if swift(<6.1) || CSQLITE_ENABLE_SERIES_EXTENSION
+@_exported import CSQLiteSeriesExtension
+#endif
+
+#if swift(<6.1) || CSQLITE_ENABLE_SHA3_EXTENSION
+@_exported import CSQLiteSHA3Extension
+#endif
+
+#if swift(<6.1) || CSQLITE_ENABLE_UUID_EXTENSION
+@_exported import CSQLiteUUIDExtension
+#endif