master > master: code py - scripts, doc-building

- `just build-documentation` vom `just build` Befehl jetzt getrennt
- wird nur mit `just dist` Befehl ausgeführt
This commit is contained in:
RD 2022-06-12 10:27:57 +02:00
parent 2a5986d490
commit 8e59bc941f
1 changed files with 16 additions and 17 deletions

View File

@ -57,15 +57,11 @@ _generate-models path name:
--input {{path}}/{{name}}-schema.yaml \ --input {{path}}/{{name}}-schema.yaml \
--output {{path}}/generated/{{name}}.py --output {{path}}/generated/{{name}}.py
_generate-models-documentation path name: _generate-models-documentation path_schema path_docs name:
@- just _delete-if-folder-exists "docs/{{name}}"
@- just _create-folder-if-not-exists "docs/{{name}}"
@- {{GEN_MODELS_DOCUMENTATION}} generate \ @- {{GEN_MODELS_DOCUMENTATION}} generate \
--input-spec {{path}}/{{name}}-schema.yaml \ --input-spec {{path_schema}}/{{name}}-schema.yaml \
--generator-name markdown \ --generator-name markdown \
--output "docs/{{name}}" --output "{{path_docs}}/{{name}}"
@- just _clean-all-files .openapi-generator*
@- just _clean-all-folders .openapi-generator*
# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# TARGETS # TARGETS
@ -75,27 +71,30 @@ _generate-models-documentation path name:
# TARGETS: build # TARGETS: build
# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
build: _build-requirements _build-skip-requirements build:
_build-skip-requirements: build-models @just build-requirements
_build-requirements: @just _check-system-requirements
@just build-models
build-requirements:
@{{PYTHON}} -m pip install --disable-pip-version-check -r requirements.txt @{{PYTHON}} -m pip install --disable-pip-version-check -r requirements.txt
build-models: build-models:
@just _check-system-requirements
@just _build-models
@just _build-models-documentation
_build-models:
@echo "Generate data models from schemata." @echo "Generate data models from schemata."
@just _delete-if-folder-exists "models/generated" @just _delete-if-folder-exists "models/generated"
@just _create-folder-if-not-exists "models/generated" @just _create-folder-if-not-exists "models/generated"
@- just _generate-models "models" "config" @- just _generate-models "models" "config"
@- just _generate-models "models" "commands" @- just _generate-models "models" "commands"
_build-models-documentation: build-documentation:
@echo "Generate documentations data models from schemata." @echo "Generate documentations data models from schemata."
@just _delete-if-folder-exists "docs" @just _delete-if-folder-exists "docs"
@just _create-folder-if-not-exists "docs" @just _create-folder-if-not-exists "docs"
@- just _generate-models-documentation "models" "config" @- just _generate-models-documentation "models" "docs" "config"
@- just _generate-models-documentation "models" "commands" @- just _generate-models-documentation "models" "docs" "commands"
@- just _clean-all-files ".openapi-generator*"
@- just _clean-all-folders ".openapi-generator*"
dist:
@just build
@just build-documentation
# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# TARGETS: run # TARGETS: run