asyncio REST API Resource database
Project description
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 git@github.com: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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.