open up 3.1 for development

Author: pgplatform-io

CHANGELOG

@@ -1,5 +1,14 @@
-3.0:
+3.1:
 done so far:
+   - opened up for development
+   - drop support for Postgres versions prior to 13
+
+to do:
+   - confirm support for Python 3.12
+   - confirm support for pg17
+
+
+3.0:
    - drop support for Python 3 versions prior to 3.9
    - drop support for Postgres versions prior to 12
    - PG14: fix DELETE to not passing rowid_column to the FDW (https://github.com/pgsql-io/multicorn2/pull/41)
@@ -14,10 +23,6 @@ done so far:
    - Support Python 3.11 (https://github.com/pgsql-io/multicorn2/pull/59)
    - Behavior change: When log_to_postgres with level ERROR or FATAL is invoked, a specialized Python exception will be thrown and the stack unwound, allowing `catch` and `finally` blocks, and other things like context handler exits, to be invoked in the FDW.  (https://github.com/pgsql-io/multicorn2/pull/59)
 
-to do:
-   - confirm support for Python 3.11 & 3.12
-   - confirm support for pg16 & pg17
-
 2.0:
    - drop support for Postgres versions prior to 10
    - drop support for Python 2

README.md

@@ -2,7 +2,7 @@
 Multicorn2
 ==========
 
-Multicorn Python3 Foreign Data Wrapper (FDW) for Postgresql.  Tested on Linux w/ Python 3.9-3.11 & Postgres 12-17.
+Multicorn Python3 Foreign Data Wrapper (FDW) for Postgresql.  Tested on Linux w/ Python 3.9-3.12 & Postgres 13-17.
 
 The Multicorn Foreign Data Wrapper allows you to fetch foreign data in Python in your PostgreSQL server.
 
@@ -14,8 +14,8 @@ details.
 In use, Multicorn includes a Python package which contains:
 
 - A `__init__.py` which provides a base class from which your new,
-  custom, FDW will derive.
-- A `utils.py` containing diagnostic support code your FDW can use.
+  custom, Extension will derive.
+- A `utils.py` containing diagnostic support code your Extension can use.
 - Several useful example FDW implementations.
 
 Multicorn also includes, under the covers, **two** shared libraries:
@@ -32,14 +32,13 @@ Multicorn also includes, under the covers, **two** shared libraries:
 2.) Change into the pgedge directory and install pgXX
 ```bash
 cd pgedge
-./pgedge install pg16 --start
+./pgedge install pg17 --start
 ./pgedge install multicorn2
 ```
 
 3.) Use multicorn as you normally would AND you can install popular FDW's that use multicorn such as ElasticSerachFDW & BigQueryFDW
 ```bash
-      ./io install esfdw
-      ./io install bqfdw
+      ./pgedge install mqttclient
 ```
 
 ## Building Multicorn2 against Postgres from Source
@@ -64,17 +63,16 @@ sudo yum -y install git python3 python3-devel python3-pip
 ### Upgrade to latest PIP (recommended)
 ```bash
 cd ~
-wget https://bootstrap.pypa.io/get-pip.py
-sudo python3 get-pip.py
-rm get-pip.py
+python3 -m venv venv
+source venv/bin/activate
 ```
 
-### Download & Compile Postgres 12+ source code
+### Download & Compile Postgres 13+ source code
 ```bash
 cd ~
-wget https://ftp.postgresql.org/pub/source/v14.3/postgresql-14.3.tar.gz
-tar -xvf postgresql-14.3.tar.gz
-cd postgresql-14.3
+wget https://ftp.postgresql.org/pub/source/v17.0/postgresql-17.0.tar.gz
+tar -xvf postgresql-17.0.tar.gz
+cd postgresql-17.0
 ./configure
 make
 sudo make install
@@ -83,10 +81,10 @@ sudo make install
 ### Download & Compile Multicorn2
 ```bash
 set PATH=/usr/local/pgsql/bin:$PATH
-cd ~/postgresql-14.3/contrib
-wget https://github.com/pgsql-io/multicorn2/archive/refs/tags/v2.3.tar.gz
-tar -xvf v2.3.tar.gz
-cd multicorn2-2.3
+cd ~/postgresql-17.0/contrib
+wget https://github.com/pgsql-io/multicorn2/archive/refs/tags/v3.0.tar.gz
+tar -xvf v3.0.tar.gz
+cd multicorn2-3.0
 make
 sudo make install
 ```
@@ -117,9 +115,9 @@ sudo yum -y install git python3 python3-devel python3-pip
 
 ### Download & Compile Multicorn2
 ```bash
-wget https://github.com/pgsql-io/multicorn2/archive/refs/tags/v2.5.tar.gz
-tar -xvf v2.5.tar.gz
-cd multicorn2-2.5
+wget https://github.com/pgsql-io/multicorn2/archive/refs/tags/v3.0.tar.gz
+tar -xvf v3.0.tar.gz
+cd multicorn2-3.0
 make
 sudo make install
 ```
@@ -147,18 +145,18 @@ This can be slow to run when it is first executed (15-30 minutes) due to the nee
 To run a faster test suite against a specific version of Python and PostgreSQL, run:
 
 ```bash
-nix build .#testSuites.test_pg12_py39
+nix build .#testSuites.test_pg13_py39
 ```
 
 **Known issues:**
-- The tests cover only the supported range of Python & PostgreSQL combinations; in particular, Python releases 3.12 and later are disabled due to failures that have not been addressed.
+- The tests cover the supported range of Python & PostgreSQL combinations;
 
 ### Adding new Python or PostgreSQL versions to the test suite
 
 1. Perform a `nix flake update` in order to provide access to the latest packages available from the Nix package manager.
 
 2. Update the supported list of versions in flake.nix under the variable `testPythonVersions` or `testPostgresVersions`.
 
-3. For new Python versions, create a new symlink to test-3.6 with the version number of the new Python version; and update the list of test directories in `makeTestSuite` in flake.nix.
+3. For new Python versions, create a new symlink to test-3.9 with the version number of the new Python version; and update the list of test directories in `makeTestSuite` in flake.nix.
 
 4. Run the tests with `nix build .#allTestSuites` to ensure that the new versions are supported.

multicorn.control

@@ -1,4 +1,4 @@
-comment = 'Multicorn2 Python3.9+ bindings for Postgres 12++ Foreign Data Wrapper'
-default_version = '3.0'
+comment = 'Multicorn2 Python3.9+ bindings for Postgres 13++ Foreign Data Wrapper'
+default_version = '3.1'
 module_pathname = '$libdir/multicorn'
 relocatable = true