Add release notes for v6.0.2

Also add relase notes section at index.
This commit is contained in:
steve-chavez
2019-08-26 10:28:03 -05:00
committed by Steve Chávez
parent b9c9aee645
commit 0d4b1d8f92
8 changed files with 169 additions and 19 deletions
+20
View File
@@ -21,3 +21,23 @@ div.line-block {
#sponsors img{
margin: 10px;
}
#thanks{
text-align: center;
}
#thanks img{
margin: 10px;
}
#thanks h2{
text-align: left;
}
#thanks p{
text-align: left;
}
#thanks ul{
text-align: left;
}
+6
View File
@@ -45,6 +45,8 @@ Complex logic can also be applied:
GET /people?and=(grade.gte.90,student.is.true,or(age.gte.14,age.is.null)) HTTP/1.1
.. _operators:
Operators
~~~~~~~~~
@@ -773,6 +775,8 @@ PostgREST will detect if the function is scalar or table-valued and will shape t
{ "title": "Blade Runner 2049", "rating": 8.1}
]
.. _bulk_call:
Bulk Call
---------
@@ -1147,6 +1151,8 @@ If the stored procedure returns non-scalar values, you need to do a :code:`selec
If more than one row would be returned the binary results will be concatenated with no delimiter.
.. _plain_text_output:
Plain Text Output
-----------------
+6 -1
View File
@@ -90,10 +90,13 @@ db-pool
Number of connections to keep open in PostgREST's database pool. Having enough here for the maximum expected simultaneous client connections can improve performance. Note it's pointless to set this higher than the :code:`max_connections` GUC in your database.
.. _db-pool-timeout:
db-pool-timeout
---------------
Time to live for an idle database pool connection.
Time to live for an idle database pool connection. If the timeout is reached the connection will be closed.
Once a new request arrives a new connection will be started.
.. _db-extra-search-path:
@@ -126,6 +129,8 @@ server-port
The TCP port to bind the web server.
.. _server-unix-socket:
server-unix-socket
------------------
+29 -16
View File
@@ -65,11 +65,13 @@ Getting Support
The project has a friendly and growing community. Join our `chat room <https://gitter.im/begriffs/postgrest>`_ for discussion and help. You can also report or search for bugs/features on the Github `issues <https://github.com/begriffs/postgrest/issues>`_ page.
.. toctree::
:glob:
:reversed:
:caption: Release Notes
:titlesonly:
:hidden:
release_notes.rst
releases/*
Tutorials
---------
@@ -88,21 +90,6 @@ Are you new to PostgREST? This is the place to start!
Also have a look at :doc:`Installation <install>`.
How-to guides
-------------
These are recipes that'll help you address specific use-cases.
.. toctree::
:glob:
:caption: How-to guides
:hidden:
how-tos/*
- :doc:`how-tos/embedding-table-from-another-schema`
- :doc:`how-tos/casting-type-to-custom-json`
Reference guides
----------------
@@ -123,6 +110,23 @@ Technical references for PostgREST's functionality.
- :doc:`API <api>`
- :doc:`configuration`
.. _how_tos:
How-to guides
-------------
These are recipes that'll help you address specific use-cases.
.. toctree::
:glob:
:caption: How-to guides
:hidden:
how-tos/*
- :doc:`how-tos/embedding-table-from-another-schema`
- :doc:`how-tos/casting-type-to-custom-json`
Topic guides
------------
@@ -167,6 +171,15 @@ PostgREST has a growing ecosystem of examples, libraries, and experiments. Here
* :ref:`clientside_libraries`
* :ref:`eco_commercial`
Release Notes
-------------
Here we'll include the most relevant changes so you can migrate to newer versions easily.
You can see the full changelog of each release in the `PostgREST repository <https://github.com/PostgREST/postgrest/releases>`_.
- :doc:`releases/v6.0.2`
- :doc:`releases/v5.2.0`
In Production
-------------
+3 -2
View File
@@ -7,6 +7,7 @@ server = Server()
server.watch('*.rst', shell('sphinx-build -b html -a -n . _build'))
server.watch('tutorials/*.rst', shell('sphinx-build -b html -a -n . _build'))
server.watch('how-tos/*.rst', shell('sphinx-build -b html -a -n . _build'))
server.watch('releases/*.rst', shell('sphinx-build -b html -a -n . _build'))
# For custom port and host
# server.serve(port=8080, host='192.168.1.2')
server.serve(root='_build/')
server.serve(root='_build/', host='192.168.1.2')
# server.serve(root='_build/')
View File
+26
View File
@@ -0,0 +1,26 @@
v5.2.0
======
* `Explicit qualification <http://postgrest.org/en/v5.0/api.html#explicit-qualification>`_ introduced in ``v5.0`` is no longer necessary, this section will not be included from this version onwards. A :ref:`db-extra-search-path` configuration parameter was introduced to avoid the need to explictly qualify database objects. If you install PostgreSQL extensions on the ``public`` schema, they'll work normally from now on.
* Now you can filter :ref:`tabs-cols-w-spaces`.
* Included the ability to quote columns that have :ref:`reserved-chars`.
* Thanks to `Zhou Feng <https://github.com/zhoufeng1989>`_, now is possible to reference an external file in :ref:`db-uri`.
* Thanks to `Russell Davies <https://github.com/russelldavies>`_, Json Web Key Sets are now accepted by :ref:`jwt-secret`.
Thanks
------
This release was made possible thanks to:
* `Daniel Babiak <https://github.com/d-babiak>`_
* `Michel Pelletier <https://github.com/michelp>`_
* Tsingson Qin
* Jay Hannah
* Victor Adossi
* Petr Beles
If you like to join them please consider `supporting PostgREST development <https://github.com/PostgREST/postgrest#supporting-development>`_.
+79
View File
@@ -0,0 +1,79 @@
.. |br| raw:: html
<br />
v6.0.2
======
Full changelog is available at `PostgREST releases page <https://github.com/PostgREST/postgrest/releases>`_.
Added
-----
* Ignoring payload keys for insert/update can be now done with the ``?columns`` query parameter. See :ref:`specify_columns`.
|br| -- `@steve-chavez <https://github.com/steve-chavez>`_
* `websearch_to_tsquery <https://www.postgresql.org/docs/11/functions-textsearch.html#id-1.5.8.18.8.2.2.7.1.1>`_ can now be used
through the ``wfts`` operator. See :ref:`fts`.
|br| -- `@herulume <https://github.com/herulume>`_
* Resource Embedding on materialized views is now possible. See :ref:`embedding_views`.
|br| -- `@vitorbaptista <https://github.com/vitorbaptista>`_
* Bulk calling an RPC is now allowed. See :ref:`bulk_call`.
|br| -- `@steve-chavez <https://github.com/steve-chavez>`_
* It's now possible to request a ``text/plain`` output. See :ref:`plain_text_output`.
|br| -- `@steve-chavez <https://github.com/steve-chavez>`_
* Config option for specifying PostgREST database pool timeout. See :ref:`db-pool-timeout`.
|br| -- `@Qu4tro <https://github.com/Qu4tro>`_
* Config option for binding the PostgREST web server to an unix socket. See :ref:`server-unix-socket`.
|br| -- `@Dansvidania <https://github.com/Dansvidania>`_
* Config option for extending the supported media types. See :ref:`raw-media-types`.
|br| -- `@Dansvidania <https://github.com/Dansvidania>`_
* We now offer an statically linked binary for Linux. Look for **postgrest-<version>-linux-x64-static.tar.xz** on the
`releases page <https://github.com/PostgREST/postgrest/releases>`_.
|br| -- `@clojurians-org <https://github.com/clojurians-org>`_
* A :ref:`how_tos` section was added to the documentation.
Changed
-------
* ``SIGHUP`` support was removed. You should use ``SIGUSR1`` instead. See :ref:`schema_reloading`.
* server-host default of ``127.0.0.1`` was changed to ``!4``. See :ref:`server-host`.
Thanks
------
This release was sponsored by:
.. image:: ../_static/cybertec.png
:target: https://www.cybertec-postgresql.com/en/
:width: 13em
.. image:: ../_static/2ndquadrant.png
:target: https://www.2ndquadrant.com/en/?utm_campaign=External%20Websites&utm_source=PostgREST&utm_medium=Logo
:width: 13em
.. image:: ../_static/retool.png
:target: https://tryretool.com/?utm_source=sponsor&utm_campaign=postgrest
:width: 13em
* Daniel Babiak
* Evans Fernandes
* Tsingson Qin
* Michel Pelletier
* Jay Hannah
* Robert Stolarz
* Kofi Gumbs
* Nicholas DiBiase
* Christopher Reid
* Nathan Bouscal
If you like to join them please consider `supporting PostgREST development <https://github.com/PostgREST/postgrest#supporting-development>`_.