oarepo-fsm 1.0.1

OArepo FSM library for record state transitions

OArepo FSM library for record state transitions built on top of the https://pypi.org/project/sqlalchemy-fsm/ library.

Quickstart

Run the following commands to bootstrap your environment

git clone https://github.com/oarepo/oarepo-fsm
cd oarepo-fsm
pip install -e .[devel]

Configuration

Check that correct record_class is being used on the RECORDS_REST_ENDPOINT’s item_route

item_route='/records/<pid(recid,record_class="yourapp.models:RecordModelFSM"):pid_value>',

To automatically add a link to the FSM endpoint to your record links, use the following links_factory_imp in your RECORDS_REST_ENDPOINTS config

links_factory_imp='oarepo_fsm.links:record_fsm_links_factory',

If you wish to activate FSM on a certain Record enpoints only, put in your config

OAREPO_FSM_ENABLED_REST_ENDPOINTS = ['recid']

Where recid is the prefix key into your RECORDS_REST_ENDPOINTS configuration. This library activates FSM on all endpoints using record_class inherited from FSMMixin otherwise.

Usage

In order to use this library, you need to define a Record model in your app, that inherits from a FSMMixin column

from invenio_records import Record
from oarepo_fsm.mixins import FSMMixin

class RecordModelFSM(FSMMixin, Record):
...

To define FSM transitions on this class, create methods decorated with @transition(..) e.g.

@transition(Transition(
    src=['open', 'archived'],
    dest='published',
    required=['id'],
    permissions=[editor_permission]))
def publish(self, **kwargs):
    print('record published')

Where Transition is defined as:

• src: record must be in one of the source states before transition could happen

• dest: target state of the transition

• required: a list of required **kwargs that must be passed to the @transition decorated function

• permissions: currently logged user must have at least one of the permissions to execute the transition

REST API Usage

To get current record state and possible transitions (only actions that you have permission to invoke will be returned)

GET <record_rest_item_endpoint>
>>>
{
    metadata: {
        state: <current state of the record>
        ... other record metadata
    }
    links: {
        self: ...
        <fsm_action1_name>: <action_url>,
        <fsm_action2_name>: <action_url>,
        ...
    }
}

To invoke a specific transition action, do

POST <record_rest_endpoint>/<fsm_action_name>

Further documentation is available on https://oarepo-fsm.readthedocs.io/

Changes

Version 0.1.0 (released TBD)

• Initial public release.