v0.0.14

This is pgx v0.0.14. It is an important update as it resolves incompatibilities with recent changes to upstream dependencies.

Please make sure to run cargo install cargo-pgx to update your cargo-pgx version. While always important for a new version of pgx, it's doubly important for this release as it's the cargo subcommand that exhibits most of the incompatibility problems.

Bugs Fixed

• Issue #42: Resolve issues with a breaking change in proc-macro2
• Issue #40: bgworker example works now. Also don't pass Postgres' various PGXXX environment variables through during cargo pgx run/test

Other Changes

• minor documentation updates
• Add libpq/auth.h to bindings generation
• 82461d1: if a non-main thread tries to call a function under #[pg_guard], we now panic
• 415b83e: extern "C" functions don't need #[no_mangle] unless it's _PG_init
• 40010be: add a function to PgRelation to open a relation with a share lock

Please Sponsor Our Work

Please consider sponsoring our work on pgx through GitHub's Sponsorship Program. Sponsorship keeps this project alive and moving forward. Thank you!

v0.0.13

This is pgx v0.0.13. It's a feature and bug fix/cleanup release.

When upgrading, please ensure to run cargo install cargo-pgx to update its cargo subcommand.

New Features

• The PostgresType trait can now project Rust Copy + Sized types from a Postgres "varlena", providing for zero-copy types between Postgres<-->Rust boundaries. See the documentation and examples for details.

Bug Fixes/Cleanups

• Fix cargo pgx run reload order to avoid possible Postgres segfaults
• Fix ^C passthrough to psql via cargo pgx run
• Fix Postgres v10 incompatibility when autogenerating CREATE OPERATOR DDL
• Cleanup pgx-tests crate so that its tests don't interfere with 3rd-party tests
• Cleanup code generation for wrapped functions, including multiple unnecessary levels of pg_sys::guard::guard()
• Removed the DetoastedVarlena and OwnedVarlena types -- these were ill-conceived and otherwise dead code. You probably want the new PgVarlena type.

Thanks!

Thanks to everyone using pgx, reporting issues, and especially submitting pull requests.

Sponsor our Work

Please consider sponsoring our work on pgx (and ZomboDB, by choosing a sponsorship tier. Your sponsorship, at any tier, is greatly appreciated and helps keep pgx and ZomboDB free and actively developed!

v0.0.12

A quick bugfix release to fix a problem with cargo pgx new failing to properly create a new extension project.

v0.0.11

This is a minor update from v0.0.9 that gets pgx's documentation building on docs.rs. No user-facing changes have been made.

v0.0.9

This is pgx v0.0.9. It is a bugfix and new feature release. Primarily, it brings support for safely creating Postgres Background Workers.

New Features

• PRs #5 & #26: Background worker support. See pgx-examples/bgworker for an example.

  • There's also a new flag named --bgworker to cargo pgx new <extname> to automatically create a template Background Worker extension crate
  • Thanks @jamessewell!

• Issue #23: #[pg_extern] functions can now return Rust tuples, which translate into an UDF that RETURNS TABLE (..., ...).

• Issue #28: #[pg_operator] macro now exists, which works exactly like #[pg_extern], but will auto generate the CREATE OPERATOR DDL for you. This is useful when defining operators for custom data types. See pgx-examples/operators.

• PR #27: cargo pgx init now honors http proxy settings from your environment. Thanks @diegopy!

• PR #30: cargo pgx start <PGVER> now specifies the "unix_socket_directories" when starting Postgres, which is simply ~/.pgx/. Thanks @jamessewell!

Other Changes/Fixes

• Properly detoast arrays. This was a regression from v0.0.8
• Add a FromDatum implementation for pgx::Numeric
• Add ability to create a pgx::PgTupleDesc from a composite pgx::pg_sys::Datum
• Add a --release flag to cargo pgx run for interactively testing a release build of your extension
• cargo pgx run spawns psql using execvp(), which means it'll properly handle, among other things, ^C
• Ensure SPI_finish() always gets called, even in the face of errors/panics
• Fix PgTryResult::unwrap_or()/unwrap_or_else() to call Postgres' FlushErrorState()
• Make GitHubActions build much faster

Sponsor our Work

Please consider sponsoring our work on pgx (and ZomboDB, by choosing a sponsorship tier. Your sponsorship, at any tier, is greatly appreciated and helps keep pgx and ZomboDB free and actively developed!

Thanks!

Thanks to all y'all that have been using pgx, reporting issues, and especially submitting pull requests.

v0.0.8

pgx v0.0.8 has been released. This is a bugfix and feature release.

New Features

• Issue #18: #[derive(PostgresType)] now works for structs that contain borrowed data (ie, they have lifetimes). These are encoded as JSON, whereas fully-owned structs are encoded as CBOR
• Issue #19: pgx now supports Postgres' bytea type, which can be represented in Rust as &[u8] or Vec<u8>. There's also an example for this that demonstrates gzipping bytea data

Bug Fixes

• Issue #21: Rust's unit type (()) is now translated into a Postgres void
• Issue #21: Rust's char type is now translated into a Postgres varchar
• Issue #21: Postgres' "char" type (note the quotes!) is now translated into a Rust i8

Upgrading

When upgrading to this version, please ensure to run cargo install cargo-pgx in addition to updating your Cargo.toml files.

Sponsor Our Work

Please consider sponsoring our work on pgx. Sponsorships help keep pgx open-source and actively developed. Thanks for your consideration!

v0.0.7

This is pgx v0.0.7. The version was bumped from v0.0.3 so that the various dependency crates and the cargo-pgx subcommand can track with the same version numbers going forward.

This release brings lots of new features to cargo-pgx, some bugfixes around SPI support, inclusion of Postgres' FDW APIs, and more documenation.

Please make sure to update your Cargo.toml pgx dependency versions to 0.0.7!

What's New?

• Significant reworking of the cargo-pgx subcommand.

  • execute cargo install cargo-pgx again to upgrade it to v0.0.7.
  • contains many new command such as 'init', 'run', 'package', 'start/stop/status'. See its README for details, screenshots, and a link to an instructional video
  • Regardless of if this is your first time using pgx, you now need to run cargo pgx init at least once
  • Our hope is that these cargo-pgx changes bring major QoL improvements. If you see anything else it needs, please create an issue.

• include Postgres' Foreign Data Wrapper API headers in the pgx::pg_sys module

Bugfixes

• fix use-after-free bugs with SPI when returning &str or PgBox<T> values

Support Our Work

Please consider sponsoring our work at our GitHub Sponsors Page.