mirror of
https://github.com/status-im/spiff-arena.git
synced 2025-01-20 23:08:55 +00:00
137e8a8232
* Just some notes from getting my dev environnent set up again. * fix readme link * fixing black configuration. * Black config settings in pre-commit. * Update README.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update README.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update spiffworkflow-backend/docs/pycharm.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update spiffworkflow-backend/docs/pycharm.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update spiffworkflow-backend/docs/pycharm.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update spiffworkflow-backend/docs/pycharm.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> --------- Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
55 lines
2.2 KiB
Markdown
55 lines
2.2 KiB
Markdown
# PyCharm Setup Instructions
|
|
|
|
## Pre-Requisites
|
|
* Before starting, be sure you can run bin/run_server_locally script successfully.
|
|
This will prove that your libraries are properly configured.
|
|
* Checkout a git repository with sample process models such as our [Sample Process Models](https://github.com/sartography/sample-process-models)
|
|
|
|
|
|
## Step 1 - Python Interpreter
|
|
In the settings, ensure that you have configured your Python interpreter to use the poetry environment you have created.
|
|
|
|
## Step 2 - Configuration Settings
|
|
Create a config.py file in the src/instance directory, with the following base settings
|
|
```python
|
|
FLASK_SESSION_SECRET_KEY="[PUT SOME RANDOM STUFF HERE]"
|
|
SPIFFWORKFLOW_BACKEND_APPLICATION_ROOT="/"
|
|
SPIFFWORKFLOW_BACKEND_BPMN_SPEC_ABSOLUTE_DIR="[FULL PATH TO SAMPLE PROCESS MODEL GIT CLONE]"
|
|
|
|
# This will configure your application to use a built in login rather than
|
|
# relying on keycloak etc...
|
|
SPIFFWORKFLOW_BACKEND_AUTH_CONFIGS = [
|
|
{
|
|
"identifier":"default",
|
|
"label":"internal openid",
|
|
"uri":"http://localhost:7000/openid",
|
|
"client_id":"spiffworkflow-backend",
|
|
"client_secret":"JXeQExm0JhQPLumgHtIIqf52bDalHz0q"
|
|
}
|
|
]
|
|
|
|
# You can modify the permissions by creating your owm permissions file and setting it here. See [example.yml](../src/spiffworkflow_backend/config/permissions/example.yml)
|
|
SPIFFWORKFLOW_BACKEND_PERMISSIONS_FILE_NAME="example.yml"
|
|
```
|
|
|
|
|
|
Checkout [the default.py config file](./src/spiffworkflow_backend/config/default.py) for more options you can specify here as needed.
|
|
|
|
## Step 3 - Run Configuration
|
|
|
|
Configure your Run configuration with the following settings:
|
|
* select Flask Server as the run type
|
|
* set the target to: spiffworkflow_backend
|
|
* set the port to 7000 (-p 7000)
|
|
* 
|
|
* 
|
|
|
|
|
|
## Step 4 - Code Formatting
|
|
|
|
We are using [Black](https://black.readthedocs.io/en/stable/) for code formatting.
|
|
To avoid the madness of having Black enforce one style, and your editor enforcing another, you should follow [the directions outlined here](https://black.readthedocs.io/en/stable/integrations/editors.html#pycharm-intellij-idea).
|
|
|
|
|
|
Start it up using the play / debug buttons.~~
|