Podnapisi-NET / flask-phpbb3

Connector for Flask with phpBB3
Other
1 stars 1 forks source link
flask phpbb3 python

Flask-phpBB3

Connector for Flask with phpBB3. Do note, this connector does not use any caches and is read-only.

Supported drivers

Supported phpBB3 versions

Configuration

To configure this extension, you have to specify PHPBB3 and one of access modes configs. All of them are dicts.

Settings ++++++++++++++++

Example +++++++

.. code:: python

PHPBB3 = { 'DRIVER': 'psycopg2', } PHPBB3_DATABASE = { 'DATABASE': 'mydb', 'USER': 'myuser', }

API

Usage of this connector is simple, just create it as any extension ::

phpbb3 = PhpBB3(app)

And in your views just call the apropriate API call:

.. code:: python

@app.route('/my/view') def view(...):

...

latest_posts = phpbb3.fetch_latest_posts()
# ...

IMPORTANT: Use only keyword paramaters!

Predefined prefixes

A prefix of a function can define it's behaviour if declared with SQL query.

get_ +++++

It will return only one value or None.

fetch_ +++++++

Returns a list. If defining your own functions, do not use OFFSET and LIMIT, it will be appended by the extension.

has_ +++++

Returns a bool, true or false. Query must return a single value!

Common keyword arguments

With all prepared queries, you may use cache (True/False) and cache_ttl arguments to control result caching. TTL is specified in seconds.

List of functions

get_autologin(key) ++++++++++++++++++

Gets autologin information. Used by session integration.

get_session(session_id) +++++++++++++++++++++++

Gets user session. Usable for integrating with phpBB3 sessions.

Remember to check user id and session id! Currenlty only database session storage is supported.

get_user(user_id) +++++++++++++++++

Gets user settings and profile.

Use string named interpolation format (the psycopg one) to specify kwargs of a function. Do not forget to use {TABLE_PREFIX} variable, to add specific table prefix. (First, the python variables from config get evaluated, and then psycopg variables).

has_membership(user_id, group_id) +++++++++++++++++++++++++++++++++

Checks if user belongs to a group.

has_membership_resolve(user_id, group_name) +++++++++++++++++++++++++++++++++++++++++++

Same as has_membership, only it works with group name.

fetch_acl_options() +++++++++++++++++++

Fetches ACL data. Used by session integration.

get_unread_notifications_count(user_id) +++++++++++++++++++

Retrieves user's unread notifications count. Used by session integration.

Sessions integration

When using this extension, it will install it's own session interface. Also, all properties not present in phpBB3 session, will be stored in session backend.

And you can use session's is_authenticated property to test if user is authenticated.

.. code:: python

from flask import session

...

if session.is_authenticated: print 'User is authenticated!'

Available is also the following API:

Caching

By default, it configures werkzeug's cache using the configuration set in PHPBB3_SESSION_BACKEND. If you are using Flask-cache extension, you may pass it along when instantiating this extension to use the common cache using the keyword parameter cache.