liquid-xml-objects-runtime 21.6.2__tar.gz

liquid_xml_objects_runtime-21.6.2/.gitattributes

@@ -0,0 +1,2 @@
+* text=auto eol=lf
+*.png binary

liquid_xml_objects_runtime-21.6.2/.github/workflows/ci.yml

@@ -0,0 +1,55 @@
+name: CI
+
+# Runs on demand : Actions > CI > Run workflow (choose the branch to build).
+on:  
+  workflow_dispatch:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Python ${{ matrix.python-version }} on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0      
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+          cache-dependency-path: |
+            pyproject.toml
+            requirements-dev.txt
+      - name: Install
+        run: python -m pip install -e . -r requirements-dev.txt
+      - name: Lint
+        run: |
+          python -m ruff check src tests
+          python -m ruff format --check src tests
+      - name: Type check
+        run: python -m mypy src
+      - name: Test
+        run: python -m pytest -q
+
+  build:
+    name: Build the distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0      
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: python -m pip install build twine
+      - run: python -m build
+      - run: python -m twine check dist/*

liquid_xml_objects_runtime-21.6.2/.github/workflows/release.yml

@@ -0,0 +1,137 @@
+name: Build and publish
+
+# Runs on demand : Actions > Build and publish > Run workflow (choose the branch to build).
+#
+# It checks the code (lint, types, tests) and builds the distribution, which is attached to the run as the artifact 'dist'. Then, if you ask for them :
+#   publish          uploads the distribution to the package index
+#   github_release   creates the GitHub release (and the tag) v<version> with the distribution attached
+# The version is the one in src/liquid_xml_objects/_version.py (the only place it is written), change it before you publish :
+# an index does not accept the same version twice.
+#
+# Configuration (repository settings > Secrets and variables > Actions)
+#   Variables
+#     PYPI_REPOSITORY_URL   where to publish, i.e. https://test.pypi.org/legacy/   (https://upload.pypi.org/legacy/ for the real PyPI)
+#     PYPI_PROJECT_URL      optional, shown as the environment url, i.e. https://test.pypi.org/project/liquid-xml-objects/
+#   Secrets
+#     PYPI_API_TOKEN        the API token for the index named by PYPI_REPOSITORY_URL (it must be a token of that index: a token from
+#                           pypi.org does not work on test.pypi.org, and a token limited to one project can only be created after
+#                           the first upload, so the first upload needs a token with the scope 'Entire account').
+#                           If it is not set the upload uses Trusted Publishing.
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+    inputs:
+      publish:
+        description: Publish the distribution to the package index (PYPI_REPOSITORY_URL)
+        type: boolean
+        default: true
+      github_release:
+        description: Create the GitHub release v<version> with the distribution attached
+        type: boolean
+        default: true
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Check and build the distribution
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+          cache-dependency-path: |
+            pyproject.toml
+            requirements-dev.txt
+      - name: Tag Reader
+        if: github.ref_type == 'tag'
+        run: echo "Tag ${{ github.ref_name }}"        
+      - name: Install
+        run: python -m pip install -e . -r requirements-dev.txt build twine
+      - name: Lint
+        run: |
+          python -m ruff check src tests
+          python -m ruff format --check src tests
+      - name: Type check
+        run: python -m mypy src
+      - name: Test
+        run: python -m pytest -q
+      - name: Version
+        id: version
+        run: echo "version=$(python -c 'import liquid_xml_objects; print(liquid_xml_objects.__version__)')" >> "$GITHUB_OUTPUT"
+      - name: Build
+        run: |
+          python -m build
+          python -m twine check dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    name: Publish to the package index
+    needs: build
+    if: ${{ inputs.publish || github.ref_type == 'tag' }}
+    runs-on: ubuntu-latest
+    environment:
+      name: package-index
+      url: ${{ vars.PYPI_PROJECT_URL }}
+    permissions:
+      contents: read
+      id-token: write # Trusted Publishing
+    env:
+      HAS_TOKEN: ${{ secrets.PYPI_API_TOKEN != '' }}
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      # Trusted Publishing (preferred, no secret): register this workflow (release.yml) and the environment (package-index) as a trusted
+      # publisher for the project on the index, and do not set PYPI_API_TOKEN.
+      # API token : set PYPI_API_TOKEN. The user name for a token is always __token__, so it is not configurable.
+      - name: Publish (API token)
+        if: ${{ env.HAS_TOKEN == 'true' }}
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: ${{ vars.PYPI_REPOSITORY_URL }}
+          user: __token__
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          attestations: false
+          verbose: true
+      - name: Publish (Trusted Publishing)
+        if: ${{ env.HAS_TOKEN != 'true' }}
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: ${{ vars.PYPI_REPOSITORY_URL }}
+          verbose: true
+
+  github-release:
+    name: Create the GitHub release
+    needs: [build, publish]
+    # (after the publish, so there is no release for a version that failed to publish, whether or not it was asked for)
+    if: ${{ always() && (inputs.github_release || github.ref_type == 'tag') && needs.build.result == 'success' && needs.publish.result != 'failure' && needs.publish.result != 'cancelled' }}
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Create the release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: >
+          gh release create "v${{ needs.build.outputs.version }}" dist/*
+          --repo "${{ github.repository }}"
+          --target "${{ github.sha }}"
+          --title "v${{ needs.build.outputs.version }}"
+          --generate-notes

liquid_xml_objects_runtime-21.6.2/.gitignore

@@ -0,0 +1,221 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+src/liquid_xml_objects/_version.py
+
+# PyInstaller
+#   Usually these files are written by a python script from a template
+#   before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+*.lcov
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+# Pipfile.lock
+
+# uv
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+# uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+# poetry.lock
+# poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+# pdm.lock
+# pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+# pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi/*
+!.pixi/config.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule*
+celerybeat.pid
+
+# Redis
+*.rdb
+*.aof
+*.pid
+
+# RabbitMQ
+mnesia/
+rabbitmq/
+rabbitmq-data/
+
+# ActiveMQ
+activemq-data/
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs/Zensical documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#   JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#   be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#   and can be added to the global gitignore or merged into this file.  For a more nuclear
+#   option (not recommended) you can uncomment the following to ignore the entire idea folder.
+# .idea/
+
+# Abstra
+#   Abstra is an AI-powered process automation framework.
+#   Ignore directories containing user credentials, local state, and settings.
+#   Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#   Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore that
+#   can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#   and can be added to the global gitignore or merged into this file. However, if you prefer, you
+#   could uncomment the following to ignore the entire vscode folder
+# .vscode/
+# Temporary file for partial code execution
+tempCodeRunnerFile.py
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Streamlit
+.streamlit/secrets.toml

liquid_xml_objects_runtime-21.6.2/.vscode/extensions.json

@@ -0,0 +1,9 @@
+{
+    "recommendations": [
+        "ms-python.python",
+        "ms-python.debugpy",
+        "charliermarsh.ruff",
+        "ms-python.mypy-type-checker",
+        "redhat.vscode-yaml"
+    ]
+}

liquid_xml_objects_runtime-21.6.2/.vscode/launch.json

@@ -0,0 +1,85 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Python: current file",
+            "type": "debugpy",
+            "request": "launch",
+            "program": "${file}",
+            "console": "integratedTerminal",
+            "cwd": "${workspaceFolder}",
+            "env": { "PYTHONPATH": "${workspaceFolder}/src" },
+            "justMyCode": false
+        },
+        {
+            "name": "pytest: all tests",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "pytest",
+            "args": ["-x", "-q", "tests"],
+            "console": "integratedTerminal",
+            "cwd": "${workspaceFolder}",
+            "env": { "PYTHONPATH": "${workspaceFolder}/src" },
+            "justMyCode": false
+        },
+        {
+            "name": "pytest: current file",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "pytest",
+            "args": ["-x", "-q", "${file}"],
+            "console": "integratedTerminal",
+            "cwd": "${workspaceFolder}",
+            "env": { "PYTHONPATH": "${workspaceFolder}/src" },
+            "justMyCode": false
+        },
+        {
+            "name": "pytest: test by name (-k)",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "pytest",
+            "args": ["-x", "-q", "tests", "-k", "${input:testName}"],
+            "console": "integratedTerminal",
+            "cwd": "${workspaceFolder}",
+            "env": { "PYTHONPATH": "${workspaceFolder}/src" },
+            "justMyCode": false
+        },
+        {
+            "name": "Generated projects: round trip all (run_generated.py)",
+            "type": "debugpy",
+            "request": "launch",
+            "program": "${workspaceFolder}/tests/run_generated.py",
+            "args": [],
+            "console": "integratedTerminal",
+            "cwd": "${workspaceFolder}",
+            "env": { "PYTHONPATH": "${workspaceFolder}/src" },
+            "justMyCode": false
+        },
+        {
+            "name": "Generated projects: round trip one (run_generated.py)",
+            "type": "debugpy",
+            "request": "launch",
+            "program": "${workspaceFolder}/tests/run_generated.py",
+            // --worker runs the project in this process, so breakpoints in the runtime and in the generated code are hit.
+            // The folder is one written by PythonGeneratorTest (RegressionTests\Temp\PythonSampleGenerator\<schema>_<model>)
+            "args": ["--worker", "${input:generatedProjectFolder}", "--verbose"],
+            "console": "integratedTerminal",
+            "cwd": "${workspaceFolder}",
+            "env": { "PYTHONPATH": "${workspaceFolder}/src" },
+            "justMyCode": false
+        }
+    ],
+    "inputs": [
+        {
+            "id": "testName",
+            "type": "promptString",
+            "description": "pytest -k expression (part of the name of the test)"
+        },
+        {
+            "id": "generatedProjectFolder",
+            "type": "promptString",
+            "description": "The generated project folder",
+            "default": "${workspaceFolder}/../LiquidTechnologies.XmlObjects.RegressionTests/Temp/PythonSampleGenerator/Choice001_Simple"
+        }
+    ]
+}

liquid_xml_objects_runtime-21.6.2/.vscode/settings.json

@@ -0,0 +1,41 @@
+{
+    // The interpreter is the virtual environment in the project (python -m venv .venv), VS Code finds it by itself.
+    "python.terminal.activateEnvironment": true,
+    "python.analysis.extraPaths": ["${workspaceFolder}/src"],
+    "python.analysis.typeCheckingMode": "standard",
+    "terminal.integrated.env.windows": { "PYTHONPATH": "${workspaceFolder}\\src" },
+    "terminal.integrated.env.linux": { "PYTHONPATH": "${workspaceFolder}/src" },
+    "terminal.integrated.env.osx": { "PYTHONPATH": "${workspaceFolder}/src" },
+
+    // Tests (the Testing view): pytest, the settings are in pyproject.toml
+    "python.testing.pytestEnabled": true,
+    "python.testing.unittestEnabled": false,
+    "python.testing.pytestArgs": ["tests"],
+
+    // Lint and format : ruff (settings in pyproject.toml), types : mypy (strict, settings in pyproject.toml)
+    "mypy-type-checker.args": ["--config-file=${workspaceFolder}/pyproject.toml"],
+    "mypy-type-checker.importStrategy": "fromEnvironment",
+    "ruff.importStrategy": "fromEnvironment",
+    "[python]": {
+        "editor.defaultFormatter": "charliermarsh.ruff",
+        "editor.formatOnSave": true,
+        "editor.rulers": [140],
+        "editor.codeActionsOnSave": {
+            "source.fixAll.ruff": "explicit",
+            "source.organizeImports.ruff": "explicit"
+        }
+    },
+
+    "files.eol": "\n",
+    "files.exclude": {
+        "**/__pycache__": true,
+        "**/.mypy_cache": true,
+        "**/.pytest_cache": true,
+        "**/.ruff_cache": true,
+        "**/*.egg-info": true
+    },
+    "search.exclude": {
+        "**/.venv": true,
+        "dist": true
+    }
+}

liquid_xml_objects_runtime-21.6.2/.vscode/tasks.json

@@ -0,0 +1,112 @@
+{
+    "version": "2.0.0",
+    "options": {
+        "env": { "PYTHONPATH": "${workspaceFolder}/src" }
+    },
+    "tasks": [
+        {
+            "label": "Install (editable, with the dev tools)",
+            "type": "shell",
+            "command": "${command:python.interpreterPath}",
+            "args": ["-m", "pip", "install", "-e", ".", "-r", "requirements-dev.txt"],
+            "problemMatcher": []
+        },
+        {
+            "label": "Compile (byte compile the sources)",
+            "type": "shell",
+            "command": "${command:python.interpreterPath}",
+            "args": ["-m", "compileall", "-q", "src", "tests"],
+            "group": "build",
+            "problemMatcher": "$python"
+        },
+        {
+            "label": "Type check (mypy --strict)",
+            "type": "shell",
+            "command": "${command:python.interpreterPath}",
+            "args": ["-m", "mypy", "src"],
+            "group": "build",
+            "problemMatcher": {
+                "owner": "mypy",
+                "fileLocation": ["relative", "${workspaceFolder}"],
+                "pattern": {
+                    "regexp": "^(.+?):(\\d+):(?:(\\d+):)?\\s+(error|warning|note):\\s+(.*)$",
+                    "file": 1,
+                    "line": 2,
+                    "column": 3,
+                    "severity": 4,
+                    "message": 5
+                }
+            }
+        },
+        {
+            "label": "Lint (ruff)",
+            "type": "shell",
+            "command": "${command:python.interpreterPath}",
+            "args": ["-m", "ruff", "check", "--output-format", "concise", "src", "tests"],
+            "group": "build",
+            "problemMatcher": {
+                "owner": "ruff",
+                "fileLocation": ["relative", "${workspaceFolder}"],
+                "pattern": {
+                    "regexp": "^(.+?):(\\d+):(\\d+):\\s+(\\S+)\\s+(.*)$",
+                    "file": 1,
+                    "line": 2,
+                    "column": 3,
+                    "code": 4,
+                    "message": 5
+                }
+            }
+        },
+        {
+            "label": "Format check (ruff format)",
+            "type": "shell",
+            "command": "${command:python.interpreterPath}",
+            "args": ["-m", "ruff", "format", "--check", "src", "tests"],
+            "problemMatcher": []
+        },
+        {
+            "label": "Format (ruff format)",
+            "type": "shell",
+            "command": "${command:python.interpreterPath}",
+            "args": ["-m", "ruff", "format", "src", "tests"],
+            "problemMatcher": []
+        },
+        {
+            "label": "Test (pytest)",
+            "type": "shell",
+            "command": "${command:python.interpreterPath}",
+            "args": ["-m", "pytest", "-q"],
+            "group": { "kind": "test", "isDefault": true },
+            "problemMatcher": "$python"
+        },
+        {
+            "label": "Round trip the generated projects (run_generated.py)",
+            "type": "shell",
+            "command": "${command:python.interpreterPath}",
+            "args": ["tests/run_generated.py"],
+            "group": "test",
+            "problemMatcher": []
+        },
+        {
+            "label": "Build the distribution (wheel + sdist)",
+            "type": "shell",
+            "command": "${command:python.interpreterPath}",
+            "args": ["-m", "build"],
+            "group": "build",
+            "problemMatcher": []
+        },
+        {
+            "label": "Check (compile, lint, format, types, tests)",
+            "dependsOrder": "sequence",
+            "dependsOn": [
+                "Compile (byte compile the sources)",
+                "Lint (ruff)",
+                "Format check (ruff format)",
+                "Type check (mypy --strict)",
+                "Test (pytest)"
+            ],
+            "group": { "kind": "build", "isDefault": true },
+            "problemMatcher": []
+        }
+    ]
+}