bumped version

Author: dantownsend

CHANGES.rst

@@ -1,6 +1,48 @@
 Changes
 =======
 
+1.31.0
+------
+
+* Added official Postgres 18 support.
+* Removed graphlib backport (no longer needed in supported Python versions).
+* Improved documentation for column kwargs.
+* Updated README to mention other parts of the Piccolo ecosystem (thanks to
+  @sinisaos for this).
+* Table instances can now be compared using the ``==`` operator, and will
+  return ``True`` if they have the same primary key value (thanks to @aarcex3
+  and @Skelmis for this).
+* Fixed missing import for auto migrations when tables use
+  ``LazyTableReference`` (thanks to @sinisaos for this).
+* Improved docs for the auto generated primary key (thanks to @badlydrawnrob
+  for this).
+* Improved ``Table._table_str`` (this is most obvious in the playground, where
+  the table definitions printed out now show more information - thanks to
+  @badlydrawnrob for raising this issue).
+* Fixed a bug with ``ModelBuilder`` when using ``Array`` columns with
+  ``choices`` defined.
+* ``add_m2m`` now returns the id of the joining table row, to match the docs
+  (thanks to @diklios5768 for reporting this).
+* Improved the docs for ``UUID`` columns (what the ``UUID4`` default value
+  does).
+* Moved connection pooling to its own page in the docs.
+* Improved the ``on_conflict`` clause - a ``target`` must be specified if
+  using ``DO UPDATE`` (thanks to @mafuyuuu1 for raising this issue, and
+  @sinisaos for this fix).
+* Changed Esmerald to Ravyn in the ASGI templates (thanks to @sinisaos for
+  this).
+* Fixed a bug with auto migrations when changing a column to a foreign key - an
+  exception was being raised (thanks to @gsavchuk for raising this issue and
+  @sinisaos for this fix).
+* ``Array(Numeric())`` columns now work with SQLite (thanks to @sinisaos for
+  this).
+* UUID columns now use the built-in ``gen_random_uuid()`` function in Postgres
+  to generate a default value, instead of using the ``uuid-ossp`` extension
+  (thanks to @sinisaos for this). See
+  :ref:`this tutorial <UUIDColumnsMigrationTutorial>` for more details.
+
+-------------------------------------------------------------------------------
+
 1.30.0
 ------
 

docs/src/piccolo/engines/sqlite_engine.rst

@@ -30,4 +30,4 @@ Production tips
 ---------------
 
 If you're planning on using SQLite in production with Piccolo, with lots of
-concurrent queries, then here are some :ref:`useful tips <UsingSQLitAndAsyncioEffectively>`.
+concurrent queries, then here are some :ref:`useful tips <UsingSQLiteAndAsyncioEffectively>`.

docs/src/piccolo/tutorials/index.rst

@@ -13,3 +13,4 @@ help you solve common problems:
     ./fastapi
     ./avoiding_circular_imports
     ./moving_table_between_apps
+    ./uuid_columns_in_piccolo_1.31.0

docs/src/piccolo/tutorials/using_sqlite_and_asyncio_effectively.rst

@@ -1,4 +1,4 @@
-.. _UsingSQLitAndAsyncioEffectively:
+.. _UsingSQLiteAndAsyncioEffectively:
 
 Using SQLite and asyncio effectively
 ====================================

docs/src/piccolo/tutorials/uuid_columns_in_piccolo_1.31.0.rst

@@ -0,0 +1,33 @@
+.. _UUIDColumnsMigrationTutorial:
+
+UUID columns in Piccolo >= 1.31.0
+=================================
+
+Prior to ``piccolo==1.31.0``, Postgres
+:class:`UUID<piccolo.columns.column_types.UUID>` columns generated their
+default values using ``uuid_generate_v4()``, which is part of the
+``uuid-ossp`` extension.
+
+In all the versions of Posgres that Piccolo supports, there is now a
+``gen_random_uuid()`` function built in, which Piccolo now uses for all new
+``UUID`` columns for generating default values in the database.
+
+Your existing ``UUID`` columns will be left alone, and will continue to use the
+``uuid-ossp`` extension.
+
+Note that :class:`PostgresEngine<piccolo.engine.postgres.PostgresEngine>` has
+an ``extensions`` argument. These are Postgres extensions which Piccolo will
+try to enable when starting up. This used to include ``uuid-ossp`` by default,
+but this is no longer the case. If you want to maintain the old behaviour,
+simply do this:
+
+.. code-block:: python
+
+    DB = PostgresEngine(extensions=['uuid-ossp'])
+
+If you want to migrate an existing ``UUID`` columns over to use
+``gen_random_uuid()`` then run this script:
+
+.. code-block:: sql
+
+    ALTER TABLE my_table ALTER COLUMN my_uuid_column SET DEFAULT gen_random_uuid();

piccolo/__init__.py

@@ -1 +1 @@
-__VERSION__ = "1.30.0"
+__VERSION__ = "1.31.0"