added some base stuff to get pyl working

.darglint

@@ -0,0 +1,2 @@
+[darglint]
+strictness = long

.flake8

@@ -0,0 +1,29 @@
+[flake8]
+select = B,B9,C,D,DAR,E,F,N,RST,S,W
+ignore = E203,E501,RST201,RST203,RST301,W503,S410,S320
+max-line-length = 120
+max-complexity = 30
+docstring-convention = google
+rst-roles = class,const,func,meth,mod,ref
+rst-directives = deprecated
+
+per-file-ignores =
+    # prefer naming tests descriptively rather than forcing comments
+    spiffworkflow-backend/tests/*:S101,D103
+
+    spiffworkflow-backend/bin/keycloak_test_server.py:B950,D
+    spiffworkflow-backend/conftest.py:S105
+    spiffworkflow-backend/wsgi.py:S104
+
+    # allow writing to /tmp for throwaway script output
+    spiffworkflow-backend/bin/get_bpmn_json_for_process_instance:S108
+
+    # the exclude=./migrations option doesn't seem to work with pre-commit
+    # migrations are autogenerated from "flask db migration" so ignore them
+    spiffworkflow-backend/migrations/*:D
+    spiffworkflow-backend/src/spiffworkflow_backend/config/testing.py:S105
+    spiffworkflow-backend/src/spiffworkflow_backend/load_database_models.py:F401
+
+    # this file overwrites methods from the logging library so we can't change them
+    # and ignore long comment line
+    spiffworkflow-backend/src/spiffworkflow_backend/services/logging_service.py:N802,B950

.pre-commit-config.yaml

@@ -0,0 +1,75 @@
+repos:
+  - repo: local
+    hooks:
+      - id: black
+        name: black
+        # entry: bash -c 'cd spiffworkflow-backend && black'
+        entry: black
+        language: system
+        files: ^spiffworkflow-backend/
+        types: [python]
+        require_serial: true
+        # exclude: ^migrations/
+        exclude: "/migrations/"
+      - id: check-added-large-files
+        files: ^spiffworkflow-backend/
+        name: Check for added large files
+        entry: check-added-large-files
+        language: system
+      - id: check-toml
+        files: ^spiffworkflow-backend/
+        name: Check Toml
+        entry: check-toml
+        language: system
+        types: [toml]
+      - id: check-yaml
+        files: ^spiffworkflow-backend/
+        name: Check Yaml
+        entry: check-yaml
+        language: system
+        types: [yaml]
+      - id: end-of-file-fixer
+        files: ^spiffworkflow-backend/
+        name: Fix End of Files
+        entry: end-of-file-fixer
+        language: system
+        types: [text]
+        stages: [commit, push, manual]
+      - id: flake8
+        files: ^spiffworkflow-backend/
+        name: flake8
+        entry: flake8
+        language: system
+        types: [python]
+        require_serial: true
+        exclude: "/migrations/"
+      - id: pyupgrade
+        files: ^spiffworkflow-backend/
+        name: pyupgrade
+        description: Automatically upgrade syntax for newer versions.
+        entry: pyupgrade
+        language: system
+        types: [python]
+        args: [--py37-plus]
+      - id: reorder-python-imports
+        files: ^spiffworkflow-backend/
+        name: Reorder python imports
+        entry: reorder-python-imports
+        language: system
+        types: [python]
+        args: [--application-directories=src]
+        exclude: "(/migrations/|load_database_models)"
+      - id: trailing-whitespace
+        files: ^spiffworkflow-backend/
+        name: Trim Trailing Whitespace
+        entry: trailing-whitespace-fixer
+        language: system
+        types: [text]
+        stages: [commit, push, manual]
+        exclude: "/migrations/"
+  # - repo: https://github.com/pre-commit/mirrors-prettier
+  #   rev: v2.4.1
+  #   hooks:
+  #     - id: prettier
+  #       files: ^spiffworkflow-backend/
+  #       exclude_types: [html]

README.md

@@ -3,5 +3,11 @@
 
 git subtree push --prefix=spiffworkflow-frontend git@github.com:sartography/spiffworkflow-frontend.git add_md_file
 
+# run pyl
+`./bin/run_pyl`
 
-
+Requires at root:
+- .darglint
+- .flake8
+- .pre-commit-config.yaml
+- pyproject.toml

bin/run_pyl

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+
+function error_handler() {
+  >&2 echo "Exited with BAD EXIT CODE '${2}' in ${0} script at line: ${1}."
+  exit "$2"
+}
+trap 'error_handler ${LINENO} $?' ERR
+set -o errtrace -o errexit -o nounset -o pipefail
+
+python_projects=(
+  flask-bpmn
+  spiffworkflow-backend
+)
+
+function run_fix_docstrings() {
+  fix_python_docstrings  $(get_top_level_directories_containing_python_files)
+}
+
+function run_pre_commmit() {
+  poetry run pre-commit run --verbose --all-files
+}
+
+for python_project in "${python_projects[@]}" ; do
+  pushd "$python_project"
+  run_fix_docstrings || run_fix_docstrings
+  popd
+done
+run_pre_commmit || run_pre_commmit
+
+for python_project in  "${python_projects[@]}"; do
+  pushd "$python_project"
+  poet i
+  poet mypy
+  poet test
+  popd
+done

pyproject.toml

@@ -0,0 +1,158 @@
+[tool.poetry]
+name = "spiffworkflow-arean"
+version = "0.0.0"
+description = "Spiffworkflow Arena"
+authors = ["Jason Lantz <sartography@users.noreply.github.com>"]
+license = "MIT"
+readme = "README.rst"
+homepage = "https://github.com/sartography/spiffworkflow-arena"
+repository = "https://github.com/sartography/spiffworkflow-arena"
+classifiers = [
+    "Development Status :: 1 - Planning",
+]
+
+[tool.poetry.dependencies]
+python = ">=3.9,<3.11"
+click = "^8.0.1"
+flask = "2.2.2"
+flask-admin = "*"
+flask-bcrypt = "*"
+flask-cors = "*"
+flask-mail = "*"
+flask-marshmallow = "*"
+flask-migrate = "*"
+flask-restful = "*"
+werkzeug = "*"
+# go back to main once https://github.com/sartography/SpiffWorkflow/pull/241 is merged
+SpiffWorkflow = {git = "https://github.com/sartography/SpiffWorkflow", rev = "main"}
+# SpiffWorkflow = {develop = true, path = "/Users/kevin/projects/github/sartography/SpiffWorkflow"}
+# SpiffWorkflow = {develop = true, path = "/home/jason/projects/github/sartography/SpiffWorkflow"}
+sentry-sdk = "^1.10"
+sphinx-autoapi = "^2.0"
+# flask-bpmn = {develop = true, path = "/home/jason/projects/github/sartography/flask-bpmn"}
+# flask-bpmn = {develop = true, path = "/Users/kevin/projects/github/sartography/flask-bpmn"}
+flask-bpmn = {git = "https://github.com/sartography/flask-bpmn", rev = "main"}
+mysql-connector-python = "^8.0.29"
+pytest-flask = "^1.2.0"
+pytest-flask-sqlalchemy = "^1.1.0"
+psycopg2 = "^2.9.3"
+typing-extensions = "^4.4.0"
+connexion = {extras = [ "swagger-ui",], version = "^2"}
+lxml = "^4.9.1"
+marshmallow-enum = "^1.5.1"
+marshmallow-sqlalchemy = "^0.28.0"
+PyJWT = "^2.6.0"
+gunicorn = "^20.1.0"
+python-keycloak = "^2.5.0"
+APScheduler = "^3.9.1"
+Jinja2 = "^3.1.2"
+RestrictedPython = "^5.2"
+Flask-SQLAlchemy = "^3"
+orjson = "^3.8.0"
+
+# type hinting stuff
+# these need to be in the normal (non dev-dependencies) section
+# because if not then poetry export won't have them and nox -s mypy --pythons 3.10
+# will fail
+types-Werkzeug = "^1.0.9"
+types-PyYAML = "^6.0.12"
+types-Flask = "^1.1.6"
+types-requests = "^2.28.6"
+types-pytz = "^2022.1.1"
+
+# https://github.com/dropbox/sqlalchemy-stubs/pull/251
+# someday get off github
+# sqlalchemy-stubs = "^0.4"
+# sqlalchemy-stubs = { git = "https://github.com/dropbox/sqlalchemy-stubs.git", rev = "master" }
+# sqlalchemy-stubs = {develop = true, path = "/Users/kevin/projects/github/sqlalchemy-stubs"}
+# for now use my fork
+sqlalchemy-stubs = { git = "https://github.com/burnettk/sqlalchemy-stubs.git", rev = "scoped-session-delete" }
+simplejson = "^3.17.6"
+
+
+[tool.poetry.dev-dependencies]
+pytest = "^7.1.2"
+coverage = {extras = ["toml"], version = "^6.1"}
+safety = "^2.3.1"
+mypy = ">=0.961"
+typeguard = "^2.13.2"
+xdoctest = {extras = ["colors"], version = "^1.0.1"}
+sphinx = "^5.0.2"
+sphinx-autobuild = ">=2021.3.14"
+pre-commit = "^2.20.0"
+flake8 = "^4.0.1"
+black = ">=21.10b0"
+flake8-bandit = "^2.1.2"
+
+# 1.7.3 broke us. https://github.com/PyCQA/bandit/issues/841
+bandit = "1.7.2"
+
+flake8-bugbear = "^22.10.25"
+flake8-docstrings = "^1.6.0"
+flake8-rst-docstrings = "^0.2.7"
+# flask-sqlalchemy-stubs = "^0.2"
+pep8-naming = "^0.13.2"
+darglint = "^1.8.1"
+reorder-python-imports = "^3.9.0"
+pre-commit-hooks = "^4.0.1"
+sphinx-click = "^4.3.0"
+Pygments = "^2.10.0"
+pyupgrade = "^3.1.0"
+furo = ">=2021.11.12"
+MonkeyType = "^22.2.0"
+
+[tool.poetry.scripts]
+spiffworkflow-backend = "spiffworkflow_backend.__main__:main"
+
+[tool.pytest.ini_options]
+# ignore deprecation warnings from various packages that we don't control
+filterwarnings = [
+    # note the use of single quote below to denote "raw" strings in TOML
+    # kombu/utils/compat.py:82
+    'ignore:SelectableGroups dict interface is deprecated. Use select.',
+    # flask_marshmallow/__init__.py:34
+    # marshmallow_sqlalchemy/convert.py:17
+    'ignore:distutils Version classes are deprecated. Use packaging.version instead.',
+    # connexion/spec.py:50
+    'ignore:Passing a schema to Validator.iter_errors is deprecated and will be removed in a future release',
+    # connexion/decorators/validation.py:16
+    'ignore:Accessing jsonschema.draft4_format_checker is deprecated and will be removed in a future release.',
+    # connexion/apis/flask_api.py:236
+    "ignore:'_request_ctx_stack' is deprecated and will be removed in Flask 2.3",
+    "ignore:Setting 'json_encoder' on the app or a blueprint is deprecated and will be removed in Flask 2.3",
+    "ignore:'JSONEncoder' is deprecated and will be removed in Flask 2.3",
+    "ignore:'app.json_encoder' is deprecated and will be removed in Flask 2.3"
+]
+
+[tool.coverage.paths]
+source = ["src", "*/site-packages"]
+tests = ["tests", "*/tests"]
+
+[tool.coverage.run]
+branch = true
+source = ["spiffworkflow_backend", "tests"]
+
+[tool.coverage.report]
+show_missing = true
+fail_under = 50
+
+[tool.mypy]
+strict = true
+disallow_any_generics = false
+warn_unreachable = true
+pretty = true
+show_column_numbers = true
+show_error_codes = true
+show_error_context = true
+plugins = "sqlmypy"
+
+# We get 'error: Module has no attribute "set_context"' for sentry-sdk without this option
+implicit_reexport = true
+
+# allow for subdirs to NOT require __init__.py
+namespace_packages = true
+explicit_package_bases = false
+
+[build-system]
+requires = ["poetry-core>=1.0.0"]
+build-backend = "poetry.core.masonry.api"