Merge pull request #9 from ZGCA-Forge/dependabot/github_actions/actions/checkout-6

ci(deps): bump actions/checkout from 5 to 6

.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.0.3
+current_version = 0.1.4
 commit = True
 tag = True
 tag_name = v{new_version}

.github/workflows/ci.yml

@@ -16,10 +16,10 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.10" # Use minimum version for consistency
 
@@ -40,10 +40,10 @@ jobs:
     needs: [code-format] # Only run after code formatting passes
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Python 3.10
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.10"
 
@@ -72,7 +72,7 @@ jobs:
     needs: [basic-build] # Only run after basic build passes
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Setup Miniconda
         uses: conda-incubator/setup-miniconda@v3
@@ -112,23 +112,17 @@ jobs:
     needs: [basic-build] # Run in parallel with ROS2 test after basic build
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
-      - name: Set up Python
+      - name: Run Safety CLI to check for vulnerabilities
-        uses: actions/setup-python@v5
+        uses: pyupio/safety-action@v1
         with:
-          python-version: "3.10" # Use minimum version for consistency
+          api-key: ${{ secrets.SAFETY_CHECK }}
-
+          output-format: json
-      - name: Install security tools
+          args: --detailed-output --output-format json
-        run: |
-          python -m pip install --upgrade pip
-          pip install "safety>=3.0.0" "typer<0.12.0" "marshmallow<4.0.0"
-
-      - name: Run safety security scan
-        run: safety check --output json > safety-report.json
 
       - name: Upload security reports
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v5
         with:
           name: security-reports
           path: |
@@ -142,10 +136,10 @@ jobs:
     needs: [basic-build] # Run in parallel with other checks
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.10" # Use minimum version for consistency
 
@@ -161,7 +155,7 @@ jobs:
         run: twine check dist/*
 
       - name: Upload build artifacts
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v5
         with:
           name: dist
           path: dist/
@@ -182,10 +176,10 @@ jobs:
             python-version: "3.10"
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
 
@@ -201,20 +195,9 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          python -m pip install flake8 pytest
+          python -m pip install pytest
           pip install -e .[dev]
 
-      - name: Lint with flake8
-        run: |
-          # stop the build if there are Python syntax errors or undefined names
-          flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
-          # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
-          flake8 . --count --exit-zero --max-line-length=200 --extend-ignore=E203,W503,F401,E402,E721,F841 --statistics
-
-      - name: Type checking with mypy
-        run: |
-          mypy msgcenterpy --disable-error-code=unused-ignore
-
       - name: Test with pytest
         run: |
           pytest

.github/workflows/docs.yml

@@ -36,12 +36,12 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           ref: ${{ github.event.inputs.branch || github.ref }}
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.10"
 
@@ -55,7 +55,7 @@ jobs:
 
       - name: Setup Pages
         id: pages
-        uses: actions/configure-pages@v4
+        uses: actions/configure-pages@v5
         if: github.ref == 'refs/heads/main' || (github.event_name == 'workflow_dispatch' && github.event.inputs.deploy_to_pages == 'true')
 
       - name: Build Sphinx documentation
@@ -64,7 +64,7 @@ jobs:
           make html
 
       - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
+        uses: actions/upload-pages-artifact@v4
         if: github.ref == 'refs/heads/main' || (github.event_name == 'workflow_dispatch' && github.event.inputs.deploy_to_pages == 'true')
         with:
           path: docs/_build/html

.github/workflows/publish.yml

@@ -10,7 +10,7 @@ name: Upload PyPI package
 
 on:
   release:
-    types: [published]
+    types: [published, edited]
   workflow_dispatch:
     inputs:
       test_pypi:
@@ -29,10 +29,10 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.10" # Use minimum version for consistency
 
@@ -53,10 +53,10 @@ jobs:
     needs: [code-format] # Only run after code formatting passes
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Python 3.10
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.10"
 
@@ -85,7 +85,7 @@ jobs:
     needs: [basic-build] # Only run after basic build passes
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Setup Miniconda
         uses: conda-incubator/setup-miniconda@v3
@@ -125,23 +125,17 @@ jobs:
     needs: [basic-build] # Run in parallel with ROS2 test after basic build
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
-      - name: Set up Python
+      - name: Run Safety CLI to check for vulnerabilities
-        uses: actions/setup-python@v5
+        uses: pyupio/safety-action@v1
         with:
-          python-version: "3.10" # Use minimum version for consistency
+          api-key: ${{ secrets.SAFETY_CHECK }}
-
+          output-format: json
-      - name: Install security tools
+          args: --detailed-output --output-format json
-        run: |
-          python -m pip install --upgrade pip
-          pip install "safety>=3.0.0" "typer<0.12.0" "marshmallow<4.0.0"
-
-      - name: Run safety security scan
-        run: safety check --output json > safety-report.json
 
       - name: Upload security reports
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v5
         with:
           name: security-reports
           path: |
@@ -154,10 +148,10 @@ jobs:
     needs: [test-with-ros2]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.10" # Use minimum version for consistency
 
@@ -167,15 +161,33 @@ jobs:
           python -m pip install build twine
 
       - name: Verify version consistency
-        if: github.event_name == 'release'
+        if: github.event_name == 'release' && (github.event.action == 'published' || (github.event.action == 'edited' && !github.event.release.prerelease))
         run: |
-          VERSION=$(python -c "import msgcenterpy; print(msgcenterpy.__version__)" 2>/dev/null || echo "unknown")
+          # Install package first
-          TAG_VERSION="${GITHUB_REF#refs/tags/v}"
+          pip install -e .
+
+          # Get package version (fail fast if not available)
+          VERSION=$(python -c "import msgcenterpy; print(msgcenterpy.__version__)")
+
+          # Handle both v0.0.3 and 0.0.3 tag formats
+          RAW_TAG="${GITHUB_REF#refs/tags/}"
+          if [[ "$RAW_TAG" == v* ]]; then
+            TAG_VERSION="${RAW_TAG#v}"
+          else
+            TAG_VERSION="$RAW_TAG"
+          fi
+
+          echo "Package version: $VERSION"
+          echo "Tag version: $TAG_VERSION"
+
           if [ "$VERSION" != "$TAG_VERSION" ]; then
-            echo "Version mismatch: package=$VERSION, tag=$TAG_VERSION"
+            echo "❌ Version mismatch: package=$VERSION, tag=$TAG_VERSION"
+            echo "Please ensure the package version matches the git tag"
             exit 1
           fi
 
+          echo "✅ Version verification passed: $VERSION"
+
       - name: Build release distributions
         run: |
           python -m build
@@ -185,7 +197,7 @@ jobs:
           twine check dist/*
 
       - name: Upload distributions
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v5
         with:
           name: release-dists
           path: dist/
@@ -195,7 +207,7 @@ jobs:
     runs-on: ubuntu-latest
     needs:
       - release-build
-    if: github.event_name == 'release' && !github.event.release.prerelease && github.event.inputs.test_pypi != 'true'
+    if: github.event_name == 'release' && !github.event.release.prerelease && github.event.inputs.test_pypi != 'true' && (github.event.action == 'published' || github.event.action == 'edited')
     permissions:
       # IMPORTANT: this permission is mandatory for trusted publishing
       id-token: write
@@ -205,7 +217,7 @@ jobs:
 
     steps:
       - name: Retrieve release distributions
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v6
         with:
           name: release-dists
           path: dist/
@@ -218,7 +230,7 @@ jobs:
     runs-on: ubuntu-latest
     needs:
       - release-build
-    if: github.event.inputs.test_pypi == 'true' || (github.event_name == 'release' && github.event.release.prerelease)
+    if: github.event.inputs.test_pypi == 'true' || (github.event_name == 'release' && github.event.release.prerelease && (github.event.action == 'published' || github.event.action == 'edited'))
     permissions:
       # IMPORTANT: this permission is mandatory for trusted publishing
       id-token: write
@@ -228,7 +240,7 @@ jobs:
 
     steps:
       - name: Retrieve release distributions
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v6
         with:
           name: release-dists
           path: dist/
@@ -242,17 +254,19 @@ jobs:
     name: Add assets to GitHub release
     runs-on: ubuntu-latest
     needs: release-build
-    if: github.event_name == 'release'
+    if: github.event_name == 'release' && (github.event.action == 'published' || github.event.action == 'edited')
+    permissions:
+      contents: write # Need write access to upload release assets
 
     steps:
       - name: Retrieve release distributions
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v6
         with:
           name: release-dists
           path: dist/
 
       - name: Upload release assets
-        uses: softprops/action-gh-release@v1
+        uses: softprops/action-gh-release@v2
         with:
           files: dist/*
         env:
@@ -265,7 +279,7 @@ jobs:
     if: always() && (needs.pypi-publish.result == 'success' || needs.test-pypi-publish.result == 'success')
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Create deployment summary
         run: |

.gitignore

@@ -48,6 +48,9 @@ docs/_static/
 
 # Visual Studio Code
 .vscode/
+.cursor/
+.cursorignore
+pyrightconfig.json
 
 # ================================
 # Operating System files

LICENSE

@@ -184,7 +184,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2025 ZGCA-Forge/MsgCenterPy
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

README.md

@@ -4,6 +4,7 @@
 
 [![PyPI version](https://badge.fury.io/py/msgcenterpy.svg)](https://badge.fury.io/py/msgcenterpy)
 [![Python versions](https://img.shields.io/pypi/pyversions/msgcenterpy.svg)](https://pypi.org/project/msgcenterpy/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/msgcenterpy.svg)](https://pypi.org/project/msgcenterpy/)
 [![Build Status](https://github.com/ZGCA-Forge/MsgCenterPy/actions/workflows/ci.yml/badge.svg)](https://github.com/ZGCA-Forge/MsgCenterPy/actions)
 [![Documentation](https://img.shields.io/badge/docs-GitHub%20Pages-brightgreen)](https://zgca-forge.github.io/MsgCenterPy/)
 
@@ -59,7 +60,25 @@ Please visit: [https://zgca-forge.github.io/MsgCenterPy/](https://zgca-forge.git
 
 ## Development
 
-### Development Environment Setup
+### Quick Development Setup
+
+For **Linux/macOS**:
+
+```bash
+git clone https://github.com/ZGCA-Forge/MsgCenterPy.git
+cd MsgCenterPy
+./scripts/setup-dev.sh
+```
+
+For **Windows**:
+
+```powershell
+git clone https://github.com/ZGCA-Forge/MsgCenterPy.git
+cd MsgCenterPy
+.\scripts\setup-dev.ps1
+```
+
+### Manual Development Setup
 
 ```bash
 git clone https://github.com/ZGCA-Forge/MsgCenterPy.git
@@ -70,6 +89,10 @@ pre-commit install
 
 For API documentation, please refer to Quick Start
 
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=ZGCA-Forge/MsgCenterPy&type=Date)](https://star-history.com/#ZGCA-Forge/MsgCenterPy&Date)
+
 ## License
 
 This project is licensed under Apache-2.0 License - see the [LICENSE](LICENSE) file for details.

msgcenterpy/__init__.py

@@ -5,7 +5,7 @@ A multi-format message conversion system supporting seamless conversion
 between ROS2, Pydantic, Dataclass, JSON, Dict, YAML and JSON Schema.
 """
 
-__version__ = "0.0.3"
+__version__ = "0.1.4"
 __license__ = "Apache-2.0"
 
 from msgcenterpy.core.envelope import MessageEnvelope, create_envelope

pyproject.toml

@@ -72,7 +72,7 @@ version = {attr = "msgcenterpy.__version__"}
 
 [tool.black]
 line-length = 120
-target-version = ['py310']
+target-version = ['py310', 'py311', 'py312']
 
 [tool.isort]
 profile = "black"