xwsyntax 0.6.0.4__tar.gz

xwsyntax-0.6.0.4/.github/workflows/check-versions.yml

@@ -0,0 +1,32 @@
+# NOTE: AUTO-GENERATED FILE
+# This workflow was generated by tools/ci/python_scripts/generate_workflows.py.
+# Do NOT edit this file manually – changes will be overwritten.
+
+name: Check for Hardcoded Versions
+
+on:
+  pull_request:
+    paths:
+      - 'src/**/*.py'
+      - 'tests/**/*.py'
+      - 'docs/**/*.md'
+      - '*.md'
+      - '*.txt'
+  push:
+    branches: [main, develop]
+
+jobs:
+  check-versions:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.12'
+
+      - name: Verify version.py is the source of truth
+        run: |
+          python .github/workflows/check_version_source_of_truth.py
+

xwsyntax-0.6.0.4/.github/workflows/check_version_source_of_truth.py

@@ -0,0 +1,97 @@
+#!/usr/bin/env python3
+"""
+Verify that the version configured in pyproject.toml ultimately comes from a
+single source-of-truth version location (file or attribute) and print it.
+
+This is extracted from the GitHub Actions check-versions workflow so it can be
+tested and reused outside of CI.
+"""
+
+from __future__ import annotations
+
+import importlib
+import re
+import sys
+from pathlib import Path
+
+
+def _read_pyproject() -> str:
+    path = Path("pyproject.toml")
+    if not path.exists():
+        print("No pyproject.toml", file=sys.stderr)
+        sys.exit(2)
+    return path.read_text(encoding="utf-8")
+
+
+def main() -> None:
+    text = _read_pyproject()
+
+    # 1) Hatchling: [tool.hatch.version] path = ".../version.py"
+    m = re.search(
+        r"\[tool\.hatch\.version\][^\n]*\n\s*path\s*=\s*[\"']([^\"']+)[\"']",
+        text,
+        re.DOTALL,
+    )
+    if m:
+        version_file = Path(m.group(1).strip())
+        if not version_file.exists():
+            print(f"Version file not found: {version_file}", file=sys.stderr)
+            sys.exit(2)
+        ns: dict[str, object] = {}
+        exec(version_file.read_text(encoding="utf-8"), ns)
+        version = ns.get("__version__")
+        if not isinstance(version, str) or not version:
+            print(f"__version__ missing or empty in {version_file}", file=sys.stderr)
+            sys.exit(2)
+        print("Current version:", version)
+        sys.exit(0)
+
+    # 2) Setuptools dynamic (file=...) -> open version file and exec
+    m = re.search(
+        r'version\s*=\s*\{\s*file\s*=\s*["\']([^"\']+)["\']',
+        text,
+        re.DOTALL,
+    )
+    if m:
+        version_file = Path(m.group(1).strip())
+        if not version_file.exists():
+            print(f"Version file not found: {version_file}", file=sys.stderr)
+            sys.exit(2)
+        ns: dict[str, object] = {}
+        exec(version_file.read_text(encoding="utf-8"), ns)
+        version = ns.get("__version__")
+        if not isinstance(version, str) or not version:
+            print(f"__version__ missing or empty in {version_file}", file=sys.stderr)
+            sys.exit(2)
+        print("Current version:", version)
+        sys.exit(0)
+
+    # 3) Setuptools dynamic (attr="pkg.module.__version__") -> import and read __version__
+    m = re.search(
+        r'version\s*=\s*\{\s*attr\s*=\s*["\']([^"\']+)["\']',
+        text,
+        re.DOTALL,
+    )
+    if m:
+        attr_path = m.group(1).strip()
+        module_name, _, attr = attr_path.rpartition(".")
+        if not module_name or not attr:
+            sys.exit(2)
+        mod = importlib.import_module(module_name)
+        version = getattr(mod, attr, None)
+        if not isinstance(version, str) or not version:
+            print(
+                f"Attribute {attr_path} is missing or empty",
+                file=sys.stderr,
+            )
+            sys.exit(2)
+        print("Current version:", version)
+        sys.exit(0)
+
+    # If none of the patterns matched, exit with a non-success status expected by CI.
+    sys.exit(2)
+
+
+if __name__ == "__main__":
+    main()
+

xwsyntax-0.6.0.4/.github/workflows/publish.yml

@@ -0,0 +1,86 @@
+# NOTE: AUTO-GENERATED FILE
+# This workflow was generated by tools/ci/python_scripts/generate_workflows.py.
+# Do NOT edit this file manually – changes will be overwritten.
+
+name: Dual PyPI Publish - exonware-xwsyntax & xwsyntax
+
+on:
+  push:
+    tags:
+      - 'v*'  # Triggers on version tags like v0.0.2, v1.0.0, etc.
+  workflow_dispatch:  # Allows manual trigger of the workflow
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.12'
+
+    - name: Verify tag matches version.py
+      run: |
+        python .github/workflows/verify_tag_matches_version.py
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+
+    - name: Set release date to today
+      run: |
+        python .github/workflows/update_release_date_from_version_file.py
+
+    - name: Build exonware-xwsyntax package
+      run: |
+        echo "Building exonware-xwsyntax package..."
+        python -m build
+
+    - name: Build xwsyntax package
+      run: |
+        echo "Building xwsyntax package..."
+        cp pyproject.toml pyproject.backup.toml
+        cp pyproject.xwsyntax.toml pyproject.toml
+        python -m build
+        mv pyproject.backup.toml pyproject.toml
+
+    - name: List built packages
+      run: |
+        echo "Built packages:"
+        find dist -name "*.whl" -o -name "*.tar.gz" | sort
+
+    - name: Publish exonware-xwsyntax to PyPI
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+      run: |
+        echo "Publishing exonware-xwsyntax to PyPI..."
+        ls -la dist/
+        twine upload dist/exonware_xwsyntax-*.whl dist/exonware_xwsyntax-*.tar.gz
+
+    - name: Publish xwsyntax to PyPI
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+      run: |
+        echo "Publishing xwsyntax to PyPI..."
+        twine upload dist/xwsyntax-*.whl dist/xwsyntax-*.tar.gz
+
+    - name: Success notification
+      run: |
+        echo "Successfully published both packages:"
+        echo "   exonware-xwsyntax v${{ github.ref_name }}"
+        echo "   xwsyntax v${{ github.ref_name }}"
+        echo ""
+        echo "PyPI URLs:"
+        echo "   https://pypi.org/project/exonware-xwsyntax/"
+        echo "   https://pypi.org/project/xwsyntax/"
+        echo ""
+        echo "Install with:"
+        echo "   pip install exonware-xwsyntax"
+        echo "   pip install xwsyntax"
+

xwsyntax-0.6.0.4/.github/workflows/update_release_date_from_version_file.py

@@ -0,0 +1,60 @@
+#!/usr/bin/env python3
+"""
+Update a __date__ literal in the version file referenced from pyproject.toml
+to today's ISO date (YYYY-MM-DD), when present as a string literal.
+
+This is extracted from the GitHub Actions publish workflow so it can be reused
+and tested outside of CI.
+"""
+
+from __future__ import annotations
+
+import re
+import sys
+from datetime import date
+from pathlib import Path
+
+
+def main() -> None:
+    pyproject_path = Path("pyproject.toml")
+    if not pyproject_path.exists():
+        print("No pyproject.toml; skipping __date__ update")
+        sys.exit(0)
+
+    pyproject = pyproject_path.read_text(encoding="utf-8")
+    m = re.search(
+        r"\[tool\.hatch\.version\][^\n]*\n\s*path\s*=\s*[\"']([^\"']+)[\"']",
+        pyproject,
+        re.DOTALL,
+    )
+    if not m:
+        print("No [tool.hatch.version] path; skipping __date__ update")
+        sys.exit(0)
+
+    version_file = Path(m.group(1).strip())
+    if not version_file.exists():
+        print(f"Version file not found: {version_file}; skipping __date__ update")
+        sys.exit(0)
+
+    text = version_file.read_text(encoding="utf-8")
+    literal_match = re.search(
+        r"__date__\s*=\s*[\"'][^\"']*[\"']",
+        text,
+    )
+    if not literal_match:
+        print("__date__ is dynamic or missing; no update needed")
+        sys.exit(0)
+
+    today = date.today().isoformat()
+    new_text = re.sub(
+        r"(__date__\s*=\s*)[\"'][^\"']*[\"']",
+        r'\1"' + today + '"',
+        text,
+    )
+    version_file.write_text(new_text, encoding="utf-8")
+    print("Set __date__ to", today, "in", version_file)
+
+
+if __name__ == "__main__":
+    main()
+

xwsyntax-0.6.0.4/.github/workflows/verify_tag_matches_version.py

@@ -0,0 +1,76 @@
+#!/usr/bin/env python3
+"""
+Verify that the current Git reference (tag) matches the library version defined
+in the version file referenced from pyproject.toml.
+
+This script is extracted from the GitHub Actions publish workflow so it can be
+reused and tested outside of CI.
+"""
+
+from __future__ import annotations
+
+import os
+import re
+import sys
+from pathlib import Path
+
+
+def _load_version_from_pyproject() -> str | None:
+    pyproject_path = Path("pyproject.toml")
+    if not pyproject_path.exists():
+        print("No pyproject.toml; skipping", file=sys.stderr)
+        return None
+
+    text = pyproject_path.read_text(encoding="utf-8")
+    m = re.search(
+        r"\[tool\.hatch\.version\][^\n]*\n\s*path\s*=\s*[\"']([^\"']+)[\"']",
+        text,
+        re.DOTALL,
+    )
+    if not m:
+        print("No [tool.hatch.version] path; skipping", file=sys.stderr)
+        return None
+
+    version_file = Path(m.group(1).strip())
+    if not version_file.exists():
+        print(f"Version file not found: {version_file}", file=sys.stderr)
+        sys.exit(1)
+
+    ns: dict[str, object] = {}
+    exec(version_file.read_text(encoding="utf-8"), ns)
+    version = ns.get("__version__")
+    if not isinstance(version, str) or not version:
+        print(f"__version__ missing or empty in {version_file}", file=sys.stderr)
+        sys.exit(1)
+    return version
+
+
+def main() -> None:
+    file_ver = _load_version_from_pyproject()
+    if not file_ver:
+        # Nothing to check; treat as non-fatal.
+        sys.exit(0)
+
+    ref = os.environ.get("GITHUB_REF", "")
+    if not ref.startswith("refs/tags/"):
+        print(f"Not a tag build; version: {file_ver}")
+        sys.exit(0)
+
+    # Python 3.8 compatibility: str.removeprefix is not available
+    if ref.startswith("refs/tags/"):
+        tag_name = ref[len("refs/tags/") :]
+    else:
+        tag_name = ref
+    tag_ver = tag_name[1:] if tag_name.startswith("v") else tag_name
+
+    if tag_ver != file_ver:
+        print(f"ERROR: Tag {tag_ver} != version.py {file_ver}", file=sys.stderr)
+        sys.exit(1)
+
+    print("OK: tag and version match:", file_ver)
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()
+

xwsyntax-0.6.0.4/.github/workflows-config.yaml

@@ -0,0 +1,9 @@
+projects:
+  xwsyntax:
+    repo: xwsyntax
+    package_main: exonware-xwsyntax
+    package_wrapper: xwsyntax
+    python_version: "3.12"
+    has_wrapper: true
+    uses_check_versions: true
+

xwsyntax-0.6.0.4/.gitignore

@@ -0,0 +1,290 @@
+# ========================================
+# eXonware xSystem .gitignore (base)
+# ========================================
+
+# CI/CD Tools (keep private)
+.ci/
+
+# Migration/legacy directories (may contain paths too long for Windows)
+MIGRAT/
+MIGRATE/
+
+# ========================================
+# Python
+# ========================================
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.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
+.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
+
+# 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
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.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
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# ========================================
+# IDEs and Editors
+# ========================================
+
+# Visual Studio Code
+.vscode/
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+!.vscode/*.code-snippets
+
+# Local History for Visual Studio Code
+.history/
+
+# Built Visual Studio Code Extensions
+*.vsix
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that 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/
+
+# Sublime Text
+*.tmlanguage.cache
+*.tmPreferences.cache
+*.stTheme.cache
+*.sublime-workspace
+*.sublime-project
+
+# Vim
+*~
+*.swp
+*.swo
+*tmp
+
+# Emacs
+*~
+\#*\#
+/.emacs.desktop
+/.emacs.desktop.lock
+*.elc
+auto-save-list
+tramp
+.\#*
+
+# ========================================
+# Operating Systems
+# ========================================
+
+# Windows
+Thumbs.db
+Thumbs.db:encryptable
+ehthumbs.db
+ehthumbs_vista.db
+*.stackdump
+[Dd]esktop.ini
+$RECYCLE.BIN/
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
+*.lnk
+
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+Icon
+._*
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+# Linux
+*~
+.fuse_hidden*
+.directory
+.Trash-*
+.nfs*
+
+# ========================================
+# Development Tools
+# ========================================
+
+# Backup files
+*.bak
+*.backup
+*.tmp
+*.temp
+
+# Log files (top-level only; docs/logs/ is tracked per GUIDE_00_MASTER)
+*.log
+/logs/
+
+# Database files
+*.sqlite
+*.sqlite3
+*.db
+
+# Configuration files with secrets
+config.ini
+secrets.json
+.secrets
+.archieve/
+credentials.json
+
+# Local environment files
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# xwlazy generated files (should be in ~/.xwlazy/ but ignore in case of old behavior)
+xwlazy.lock.toml
+xwlazy_sbom.toml
+

xwsyntax-0.6.0.4/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 eXonware.com - eXonware Backend Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

xwsyntax-0.6.0.4/MANIFEST.in

@@ -0,0 +1,24 @@
+#exonware/xwsyntax/MANIFEST.in
+
+include README.md
+include LICENSE
+include requirements.txt
+include pytest.ini
+
+recursive-include src *.py
+recursive-include src *.grammar
+recursive-exclude src *.pyc
+recursive-exclude src __pycache__
+
+recursive-include tests *.py
+recursive-exclude tests *.pyc
+recursive-exclude tests __pycache__
+
+recursive-include docs *.md
+recursive-include examples *.py *.html
+recursive-include benchmarks *.py
+
+prune build
+prune dist
+prune *.egg-info
+