guillotina 6.4.0

asyncio REST API Resource database

Introduction

Please read the detailed docs

This is the working project of the next generation Guillotina server based on asyncio.

Dependencies

• Python >= 3.7
• PostgreSQL >= 9.6

Quickstart

We use pip

pip install guillotina

Run PostgreSQL

If you don’t have a PostgreSQL server to play with, you can run one with Docker.

Download and start the Docker container by running

make run-postgres

Run the server

To run the server

g

Then…

curl http://localhost:8080

Or, better yet, use Postman to start playing with API.

You can also navigate in your Guillotina server with its built-in web admin interface by visiting http://localhost:8080/+admin/.

Deploy on Heroku

Read more Guillotina-Heroku.

Getting started with development

Using pip (requires Python > 3.7)

git clone [e-mail]:plone/guillotina.git
cd guillotina
python3.7 -m venv .
./bin/pip install -r requirements.txt
./bin/pip install -r contrib-requirements.txt
./bin/pip install -e '.[test]'
./bin/pre-commit install

Run tests

We’re using pytest

./bin/pytest guillotina

and for test coverage

./bin/pytest --cov=guillotina guillotina/

With file watcher…

./bin/ptw guillotina --runner=./bin/py.test

To run tests with cockroach db

USE_COCKROACH=true ./bin/pytest guillotina

Default

Default root access can be done with AUTHORIZATION header : Basic root:root

Docker

You can also run Guillotina with Docker!

First, run PostgreSQL

docker run --rm \
    -e POSTGRES_DB=guillotina \
    -e POSTGRES_USER=guillotina \
    -p 127.0.0.1:5432:5432 \
    --name postgres \
    postgres:9.6

Then, run Guillotina

docker run --rm -it \
    --link=postgres -p 127.0.0.1:8080:8080 \
    plone/guillotina:latest \
    g -c '{"databases": [{"db": {"storage": "postgresql", "dsn": "postgres://guillotina:@postgres/guillotina"}}], "root_user": {"password": "root"}}'

This assumes you have a config.yaml in your current working directory

Chat

Join us to talk about Guillotina at https://gitter.im/plone/guillotina

CHANGELOG

6.4.0 (2022-04-12)

• Fix PubSub utility stuck in infinite loop when Redis connection is interrupted [masipcat]

6.4.0rc3 (2022-03-16)

• Fix Pillow dependency [bloodbare]
• Breaking change: guillotina futures won’t have the txn set anymore. [masipcat]
• Fix @pytest.mark.app_settings modified original settings dictionary [masipcat]
• Fix previous change in mailer utility [masipcat]
• Improve error logging in futures [masipcat]
• Documentation: Enhance search endpoint documentation [ksuess]
• Documentation: Add info about catalog_max_results [ksuess]
• Add a dict parameter render_options to pass custom values to rendered template in EmailValidationUtility [jotare]

6.4.0rc2 (2021-11-22)

• Nothing changed yet.

6.4.0rc1 (2021-11-22)

• Some fixes and improvements to the new TransactionConnectionContextManager [masipcat]
• Port the following changes:
• Remove db transaction strategy support
• Try not to reserve connection when possible [vangheem]
• Black to 21.10b0 version [bloodbare]
• Add the possibility of configuring the ttl of the email_validation using app_settings[“ttl_email_validation”] in the utility of the email_validation. By default is 3660s. [nilbacardit26]
• Fix docs: Create group with id/name [ksuess]
• doc: installation: fix duplicated line and link to contrib/dbusers [jotare]

6.4.0rc0 (2021-10-20)

• Add support for Python 3.10 [masipcat]
• Reimplemented IRedisUtility to adapt to aioredis v2.0 breaking changes [masipcat]
• Removed argument ‘loop’ from utilities initialization (following Python 3.10 changes) [masipcat]
• Upgraded dev dependencies [masipcat]
• Fix searching by SearchableText [frapell]
• Fix vocabulray country code AN

6.3.15 (2021-08-05)

• fix: Add MIMEMultipart(‘alternative’) to attach message in parent MIMEMultipart to render only html body. [rboixaderg]

6.3.14 (2021-08-04)

• feat: Change MIMEMultipart ‘alternative’ to ‘mixed’. Outlook and Thunderbird not recieve attachment when use ‘alternative’
• chore: fix version aioredis 1.3.1 [rboixaderg]

6.3.13 (2021-07-05)

• Mask Textline field to recover masked values on get [bloodbare]
• Fix navigate_to() crashes with ‘AttributeError’ when traversing to a non-folderish object [masipcat]

6.3.12 (2021-07-01)

• shell: import ‘app_settings’. Fix typo
• doc: Fix example app and other small fixes [jianaijun]
• feat: Add null and not null operator in int, float and timestamp types in pgcatalog [rboixaderg]

6.3.11 (2021-06-10)

• Add is not null operator Search pgcatalog
• Fix order by int and float Search pgcatalog [rboixaderg]

6.3.10 (2021-06-07)

• Fix unrestricted Search pgcatalog
• Add filter is null Search pgcatalog [rboixaderg]

6.3.9 (2021-05-31)

• Allow to define custom validate url and custom template on email actions [bloodbare]
• Add @ in allowed chars in IIDChecker [rboixaderg]

6.3.8 (2021-05-21)

• Fixing status code on range request [bloodbare]

6.3.7 (2021-05-21)

• Fix potential pg connection leaks
• PG Catalog unrestricted search build count query
• PG Catalog __or, __and operators [rboixaderg]

6.3.6 (2021-05-10)

• Fix error on unrestricted Search [bloodbare]

6.3.5 (2021-05-10)

• PG Catalog unrestricted search [bloodbare]

6.3.4 (2021-05-06)

• Adding image with scale previews field [bloodbare]

6.3.3 (2021-05-04)

• Command: Implement graceful stop (like in asyncio.run()) [masipcat]
• Command: Fix same txn copied to all tasks/requests [masipcat]

6.3.2 (2021-04-30)

• Command: fix typo introduced in #1125 [masipcat]

…

You are seeing a truncated changelog.

You can read the changelog file for a complete list.