🔀 Merge feature/set-theory.

Author: rafalkrupinski

.config/mkdocs.yml

@@ -7,3 +7,4 @@ nav:
 - index.md
 - plugins.md
 - openapi.md
+- json-schema.md

.pre-commit-config.yaml

@@ -13,9 +13,10 @@ repos:
   - id: check-yaml
   - id: debug-statements
   - id: end-of-file-fixer
-    exclude: ^src/lapidary/render/templates/render/includes/header.txt$|^tests/e2e/expected/
   - id: no-commit-to-branch
   - id: trailing-whitespace
+    # keep whitespaces as generated by libCST for e2e tests
+    exclude: ^tests/e2e/expected/
 - repo: https://github.com/astral-sh/ruff-pre-commit
   rev: v0.7.0
   hooks:
@@ -25,14 +26,11 @@ repos:
     args:
     - --fix
   - id: ruff-format
-    pass_filenames: false
 - repo: https://github.com/python-poetry/poetry
-  rev: 1.8.3
+  rev: 2.0.1
   hooks:
   - id: poetry-check
   - id: poetry-lock
-    args:
-    - --no-update
 - repo: https://github.com/pre-commit/mirrors-mypy
   rev: v1.12.1
   hooks:

docs/index.md

@@ -9,7 +9,11 @@ Lapidary-render is a code generator that creates client code from an OpenAPI doc
 
 - [x] The generator code should be simple.
 
-    Lapidary-render does most of the processing in Python, only leaving the rendering to Jinja templates.
+    Generator processes data in three stages
+
+    1. Enhance and transform OpenAPI to a structure more close resembling python model structure
+    2. Convert the enhanced OpenAPI to a metamodel
+    3. Convert the metamodel to a syntax tree
 
 - [x] Client code should be simple.
 
@@ -61,7 +65,7 @@ origin
 : URL of the OpenAPI document, used when document_path is missing, or when `servers` is not defined, or the first server URL is a relative path.
 
 extra_sources
-: list of additional source roots for manually written code. The files will be interpreted as templates, but non-template files will also work.
+: list of additional source roots for manually written python files.
 
 plugins
 : list of plugin classes. See [the section on plug-ins](/plugins)