Release 0.3.0

[Hoverbear]

Prepare our 0.3.0 release.

Notes:

---

v0.3.0

Upgrading

Please make sure to run cargo install cargo-pgx and update all the pgx extension Cargo.toml's pgx*versions to 0.3.0.

We do not expect users to require additional actions on upgrade, but we recommend any usage of the pgxsql be converted to use the new sql = "some string" available on the macros. We expect pgxsql support to be removed in the future, before 1.0.0.

Features

• Aggregates are now supported. Explore the Rustdocs of pgx::Aggregate and pgx::pg_aggregate, or the aggregate example to learn more. (First Class Aggregate Support #230, Refine Aggregate docs #406, Tidy a missing newline in some aggregate output #418, Support Ordered Sets better #428)
• cargo pgx has a new coat of paint as Clap was upgraded to 3.0. (Upgrade deps (and clap 3) #368)
• cargo pgx will now do some validation that it is being run on a crate which uses a compatible pgx version. (Validate cargo-pgx and pgx crates are compatible using semver #389)
• cargo pgx and the sql-generator have more observability and improved error handling. Try exploring --verbose! (Eyre and tracing #372)
• cargo pgx related commands now treat the pgversion as optional if some pgversion is part of the extension's default features. (Make the pgversion optional when set in features. #402)
• You can now have extensions which are #[no_std]. While pgx still uses std, this can be a partial measure to limiting what an extension (or, for example plrust) might be able to do on a system. (support a pgx extension compiling with no_std #385)
• pgx::Internal has an expanded API like get_or_insert_default(). (Expand pgx::Internal API #419)
• Most pgx related attribute macros now support sql = false, sql = "string", or sql = some::func::path to configure how they generate SQL. (feat: extend sql generation via to_sql attribute #410, Add sql anchor comments #422)
• Nix users will find lib.buildPgxExtension in the flake.nix. (nix: Provide lib in flakes with buildPgxExtension #358, nix: Allow additionalFeatures in buildPgxExtension #360, Nix: tests use the correct schema #361)

Other changes

• PgBox acquired new() and new_in_context() functions. (Add PgBox::new #421)
• The pg_sys::TimestampTz type alias now has an SQL mapping. (Add type mapping for 'pg_sys::TimestampTz' to 'timestamp with time zone' #400)
• pgx::memcxt::PgMemoryContexts related closures now take a FnOnce, this makes them considerably more flexible as they can capture their environment. (Relax memctx closures from Fn to FnOnce #390)
• pgx-pg-sys should hopefully be able to build on Docs.rs! (Allow pgx-pg-sys docs to build on docs.rs #386)
• default!() macros can now handle negative values. (63f5e6e)
• The new cargo pgx schema --skip-build flag uses existing artifacts. (feat: Support cargo pgx schema --skip-build #255)
• @CARGO_VERSION@ in the .control file is now supported in the SQL generation. (Correctly transform control file version number in sql entity graph #409)
• Fixed some help text in cargo pgx init. (https://github.com/zombodb/pgx/pull/415)\
• For users who already have PGUSER set, it was previously possible to encounter some issues during cargo pgx use. (Disable PGUSER env when checking for existing database #380)
• For x86_64-unknown-linux-musl and aarch64-unknown-linux-musl users, schema generation is now supported. (Fix schema generation on alpine #362, Update cargo config for all examples #365)
• For Nix users, debug and doCheck are now supported. (Nix debug option #349, nix: inherit doCheck #401)
• For Mac Nix users, glibc was broken, it's no longer include it on Mac. (Nix repair darwin compat #335)
• For Mac ARM users, cargo pgx will now handle removing libraries when needed due to code-signing. (Remove old .so before copying new one into place #333, Fix install copy issues #420)
• For CentOS 7 or other older-distro users, some problems were noted with GCC 4. (Add note about gcc 4 not working #387)
• General dependency updates and lint fixing. (Upgrade some dependencies #339, Resolve some lints #364, Quiet some unread fields #405, Upgrade deps #414)