introducing renovate and update a first group of workflows

.github/renovate.json

@@ -0,0 +1,25 @@
+{
+  "extends": [
+    "config:recommended",
+    ":enablePreCommit",
+    ":automergeMinor",
+    ":dependencyDashboard",
+    ":semanticCommits",
+    ":pinDevDependencies"
+  ],
+  "enabledManagers": [
+    "github-actions",
+    "pep621",
+    "pre-commit"
+  ],
+  "packageRules": [
+    {
+      "matchManagers": ["pre-commit"],
+      "matchPaths": ["src/py/.pre-commit-config.yaml"]
+    },
+    {
+      "matchManagers": ["pep621"],
+      "matchPaths": ["src/py/pyproject.toml"]
+    }
+  ]
+}

.github/workflows/publish_testpypi.yml

@@ -21,7 +21,7 @@ jobs:
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v4
-      - uses: astral-sh/setup-uv@v4
+      - uses: astral-sh/setup-uv@v5
       - name: Install Dependencies
         if: ${{ matrix.os == 'ubuntu-latest' }}
         run: sudo apt-get update && sudo apt-get install xvfb
@@ -95,7 +95,7 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
-      - uses: astral-sh/setup-uv@v4
+      - uses: astral-sh/setup-uv@v5
       - uses: actions/setup-python@v5
         with:
           python-version-file: "./src/py/pyproject.toml"

.github/workflows/test.yml

@@ -16,7 +16,7 @@ jobs:
         working-directory: ./src/py/
     steps:
       - uses: actions/checkout@v4
-      - uses: astral-sh/setup-uv@v4
+      - uses: astral-sh/setup-uv@v5
       - uses: actions/setup-python@v5
         with:
           python-version-file: "./src/py/pyproject.toml"

.gitignore

@@ -23,3 +23,6 @@ src/py/integration_tests/report*
 # avoid ignore .gitkeep
 !src/py/integration_tests/renders/.gitkeep
 node_modules/
+
+# IDE
+.idea

Makefile

@@ -0,0 +1,24 @@
+.DEFAULT_GOAL := help
+
+venv:
+	@curl -LsSf https://astral.sh/uv/install.sh | sh
+	@uv venv --python '3.12'
+
+
+.PHONY: install
+install: venv ## Install a virtual environment
+	@uv pip install --upgrade pip
+	@uv sync --all-extras --dev --frozen
+
+
+.PHONY: fmt
+fmt: venv ## Run autoformatting and linting
+	@uv pip install pre-commit
+	@uv run pre-commit install --config src/py/.pre-commit-config.yaml
+	@uv run pre-commit run --config src/py/.pre-commit-config.yaml --all-files
+
+
+.PHONY: help
+help:  ## Display this help screen
+	@echo -e "\033[1mAvailable commands:\033[0m"
+	@grep -E '^[a-z.A-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-18s\033[0m %s\n", $$1, $$2}' | sort

src/py/.pre-commit-config.yaml

@@ -1,20 +1,18 @@
 # See https://pre-commit.com for more information
 # See https://pre-commit.com/hooks.html for more hooks
-%YAML 1.2
----
 exclude: |
   (?x)(
   src/py/site/.*|
   src/py/integration_tests/mocks/.*|
-  src/py/intergation_tests/renders/.*|
+  src/py/integration_tests/renders/.*|
   src/js/.*|
   \.js$
   )
 default_install_hook_types: [pre-commit, commit-msg]
 default_stages: [pre-commit]
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v3.2.0
+    rev: v5.0.0
     hooks:
       - id: trailing-whitespace
       - id: end-of-file-fixer
@@ -30,7 +28,7 @@ repos:
       - id: add-trailing-comma
   - repo: https://github.com/astral-sh/ruff-pre-commit
     #  Ruff version.
-    rev: v0.8.2
+    rev: v0.11.10
     hooks:
       #  Run the linter.
       - id: ruff
@@ -39,23 +37,22 @@ repos:
       - id: ruff-format
         types_or: [python, pyi]
         #  options: ignore one line things [E701]
-  - repo: https://github.com/adrienverge/yamllint
-    rev: v1.35.1
-    hooks:
-      - id: yamllint
-        name: yamllint
-        description: This hook runs yamllint.
-        entry: yamllint
-        language: python
-        types: [file, yaml]
-        args: ['-d', "{\
-          extends: default,\
-          rules: {\
-            colons: { max-spaces-after: -1 }\
-          }\
-        }"]
+
+  # you check the actions below
+  #- repo: https://github.com/adrienverge/yamllint
+  #  rev: v1.35.1
+  #  hooks:
+  #    - id: yamllint
+  #      name: yamllint
+  #      description: This hook runs yamllint.
+  #      entry: yamllint
+  #      language: python
+  #      types: [file, yaml]
+  #      args: ['-d', '{"extends": "default",
+  #                     "rules": {"colons": {"max-spaces-after": -1}}}']
+
   - repo: https://github.com/rhysd/actionlint
-    rev: v1.7.4
+    rev: v1.7.7
     hooks:
       - id: actionlint
         name: Lint GitHub Actions workflow files
@@ -64,6 +61,7 @@ repos:
         types: ["yaml"]
         files: ^\.github/workflows/
         entry: actionlint
+
   - repo: https://github.com/jorisroovers/gitlint
     rev: v0.19.1
     hooks:
@@ -75,19 +73,28 @@ repos:
         entry: gitlint
         args: [--staged, -c, "general.ignore=B6,T3", --msg-filename]
         stages: [commit-msg]
+
   - repo: https://github.com/crate-ci/typos
-    rev: v1.28.2
+    rev: v1.32.0
     hooks:
       - id: typos
-  - repo: https://github.com/markdownlint/markdownlint
-    rev: v0.13.0
+
+  # - repo: https://github.com/markdownlint/markdownlint
+  #   rev: v0.13.0
+  #   hooks:
+  #     - id: markdownlint
+  #       name: Markdownlint
+  #       description: Run markdownlint on your Markdown files
+  #       entry: mdl --rules ~MD026 --style .markdown.rb
+  #       language: ruby
+  #       files: \.(md|mdown|markdown)$
+
+  # no ruby acrobatic needed
+  - repo: https://github.com/igorshubovych/markdownlint-cli
+    rev: v0.45.0
     hooks:
       - id: markdownlint
-        name: Markdownlint
-        description: Run markdownlint on your Markdown files
-        entry: mdl --rules ~MD026 --style .markdown.rb
-        language: ruby
-        files: \.(md|mdown|markdown)$
+
   - repo: https://github.com/Yelp/detect-secrets
     rev: v1.5.0
     hooks:

src/py/REFACTOR_INSTRUCTIONS.md

@@ -1,8 +1,9 @@
+# Techdebt
+
 We are just at the line of techdebt:
 
 How to refactor:
 
-
 1. We need more thoughtful design of how to manage parallel tasking with async/await
    a. We are beginning to look a bit like callback hell.
 2. The above would probably accompany a switch from inheritance of choreo to composition

src/py/docs/examples.md

@@ -1,7 +1,6 @@
 # Kaleido Code Snippets
 
-
-### Basic
+## Basic
 
 ```python
 import plotly.express as px
@@ -31,7 +30,6 @@ figures = [fig, fig2]
 
 kaleido.write_fig_sync(fig, path="./output/")
 
-
 ## Multiple image write with error collection
 
 error_log = []
@@ -50,7 +48,6 @@ if error_log:
     print(str(e))
   raise RuntimeError("{len(error_log)} images failed.")
 
-
 ## async/await style of above
 
 await kaleido.write_fig(
@@ -61,12 +58,11 @@ await kaleido.write_fig(
   )
 ```
 
-### Generator (for batch processing)
+## Generator (for batch processing)
 
 Generating all of the plotly figures can take too much memory depending on the
 number of figures, so use a generator:
 
-
 ```python
 import plotly.express as px
 import kaleido
@@ -88,7 +84,6 @@ def generate_figures(): # can be async as well
 kaleido.write_fig_sync(generate_figures(), path="./output/", n=4)
 # file names will be taken from figure title
 
-
 ### If you need more control, use an object
 
 def generate_figure_objects():

src/py/pyproject.toml

@@ -14,7 +14,7 @@ kaleido = ['vendor/**']
 [project]
 name = "kaleido"
 description = "Plotly graph export library"
-license = {file = "LICENSE.md"}
+license = {file = "LICENSE"}
 readme = "README.md"
 requires-python = ">=3.8"
 dynamic = ["version"]
@@ -39,7 +39,7 @@ Repository = "https://github.com/plotly/kaleido"
 kaleido_mocker = "kaleido._mocker:build_mocks"
 kaleido_get_chrome = "choreographer.cli._cli_utils:get_chrome_cli"
 
-[dependency-groups]
+[project.optional-dependencies]
 dev = [
   "pytest",
   "pytest-asyncio",
@@ -52,17 +52,6 @@ dev = [
   "pandas>=2.0.3",
 ]
 
-#docs = [
-#    "mkquixote @ git+ssh://[email protected]/geopozo/mkquixote; python_version>= '3.11'",
-#    "mkdocs>=1.6.1",
-#    "mkdocs-material>=9.5.49",
-#]
-
-#[tool.uv.sources]
-#mkquixote = { path = "../../../mkquixote", editable = true }
-#choreographer = { path = "../../../devtools_protocol", editable = true }
-#logistro = { path = "../../../logistro", editable = true }
-
 [tool.ruff.lint]
 select = ["ALL"]
 ignore = [