mcp-postgresql-ops 3.3.9__tar.gz → 3.4.1__tar.gz

{mcp_postgresql_ops-3.3.9 → mcp_postgresql_ops-3.4.1}/.github/workflows/pypi-publish.yml

@@ -1,7 +1,4 @@
-# This workflow will install Python dependencies, run tests and lint with a variety of Python versions
-# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python
-
-name: Publish to PyPI on tag
+name: Publish Packages and GitHub Release on Tag
 
 on:
   push:
@@ -9,7 +6,6 @@ on:
 
 permissions:
   contents: read
-  id-token: write
 
 jobs:
   build:
@@ -26,10 +22,15 @@ jobs:
         run: pip install --upgrade build
       - name: Build distributions
         run: python -m build
+      - name: Verify tag and distribution versions
+        env:
+          RELEASE_TAG: ${{ github.ref_name }}
+        run: python -m scripts.check_release "$RELEASE_TAG" dist
       - uses: actions/upload-artifact@v7
         with:
           name: dist
           path: dist/
+          if-no-files-found: error
 
   publish-to-testpypi:
     name: Publish to TestPyPI
@@ -55,8 +56,7 @@ jobs:
     name: Publish to PyPI
     if: startsWith(github.ref, 'refs/tags/')
     runs-on: ubuntu-latest
-    needs: build
-    #needs: publish-to-testpypi
+    needs: publish-to-testpypi
     permissions:
       id-token: write
     environment:
@@ -70,4 +70,29 @@ jobs:
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
         with:
-          repository-url: https://upload.pypi.org/legacy/
+          repository-url: https://upload.pypi.org/legacy/
+
+  release:
+    name: Publish GitHub Release
+    needs: publish-to-pypi
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    permissions:
+      contents: write
+    concurrency:
+      group: github-release-${{ github.repository }}
+      cancel-in-progress: false
+      queue: max
+    env:
+      GH_TOKEN: ${{ github.token }}
+      RELEASE_TAG: ${{ github.ref_name }}
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12.x"
+      - name: Publish release with commit messages
+        run: python -m scripts.publish_release "$RELEASE_TAG"

{mcp_postgresql_ops-3.3.9 → mcp_postgresql_ops-3.4.1}/.github/workflows/test.yml

@@ -32,7 +32,7 @@ jobs:
         run: uv sync --extra dev
 
       - name: Run unit tests
-        run: uv run pytest tests/test_version_compat.py -v --tb=short
+        run: uv run pytest tests/test_version_compat.py tests/test_tool_schema_null_defaults.py tests/test_release.py -v --tb=short
   integration-tests:
     name: Integration Tests (PG 12-18)
     runs-on: ubuntu-latest

{mcp_postgresql_ops-3.3.9 → mcp_postgresql_ops-3.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-postgresql-ops
-Version: 3.3.9
+Version: 3.4.1
 Summary: Add your description here
 Author-email: JungJungIn <call518@gmail.com>
 Requires-Python: >=3.12
@@ -34,7 +34,7 @@ Dynamic: license-file
 
 ## Architecture & Internal (DeepWiki)
 
-[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/call518/MCP-PostgreSQL-Ops)
+[![Ask DeepWiki](https://img.shields.io/badge/Ask-DeepWiki-blue)](https://deepwiki.com/call518/MCP-PostgreSQL-Ops)
 
 ---
 
@@ -71,7 +71,7 @@ Dynamic: license-file
 
 ## Tool Usage Examples
 
-### 📸 **[More Examples with Screenshots →](https://github.com/call518/MCP-PostgreSQL-Ops/wiki/Tool-Usage-Example)**
+### 📸 **[More Examples with Screenshots →](https://github.com/call518/MCP-PostgreSQL-Ops/wiki)**
 
 ---
 
@@ -147,7 +147,8 @@ docker-compose logs -f
 docker-compose ps
 
 # Verify PostgreSQL is ready
-docker-compose logs postgres | grep "ready to accept connections"
+docker compose exec -T postgres sh -c \
+  'pg_isready -h 127.0.0.1 -p 5432 -U "$POSTGRES_USER" -d "$POSTGRES_DB"'
 ```
 
 ### 3. Access to OpenWebUI
@@ -180,7 +181,7 @@ http://localhost:3003/
 
 #### 📖 **Next Steps:**
 - Browse the **[Example Queries section](#usage-examples)** below for more query examples
-- Check out **[Tool Usage Examples with Screenshots](https://github.com/call518/MCP-PostgreSQL-Ops/wiki/Tool-Usage-Example)** for visual guides
+- Check out **[Tool Usage Examples with Screenshots](https://github.com/call518/MCP-PostgreSQL-Ops/wiki)** for visual guides
 - Explore the **[Tool Compatibility Matrix](#tool-compatibility-matrix)** to understand available features
 
 ---
@@ -308,6 +309,20 @@ The `create-test-data.sql` script is executed by the `postgres-init-extensions`
 
 ---
 
+## Tagged Releases
+
+The GitHub Actions workflow publishes a pushed version tag (for example,
+`v1.2.3`, `1.2.3`, or `1.2.3rc1`) to TestPyPI, then PyPI, and finally creates
+a GitHub Release with the tag as its title. Both distribution versions must match
+the tag. The existing `testpypi` and `pypi` GitHub environments must have Trusted
+Publishing configured on their respective package indexes.
+
+Release notes include full commit messages since the most recently published
+GitHub Release, or all commits for the first release. The previous release tag
+must be an ancestor of the new tag. Alpha, beta, and release candidate tags create
+prereleases. Existing published releases are preserved; an existing draft requires
+manual review. A failed publication prevents subsequent publication jobs.
+
 ## Installation
 
 ### From PyPI (Recommended)
@@ -952,11 +967,12 @@ mcp-postgresql-ops --log-level DEBUG
 
 ### Running Tests
 
-Two test suites are available:
+The following test suites are available:
 
 | Suite | File | Requires Docker |
 |-------|------|----------------|
 | Unit tests (version compatibility logic) | `tests/test_version_compat.py` | No |
+| Unit tests (null-default tool argument schemas) | `tests/test_tool_schema_null_defaults.py` | No |
 | Integration tests (all tools × PG 12–18) | `tests/test_tools_integration.py` | Yes |
 
 `uv run pytest` automatically starts the Docker test containers (PG 12–18), waits for them to be fully initialized, runs all tests, then tears everything down.
@@ -965,14 +981,17 @@ Two test suites are available:
 # Run all tests (unit + integration) — Docker is managed automatically
 uv run pytest -v
 
-# Unit tests only (no Docker needed)
-uv run pytest tests/test_version_compat.py -v
+# Unit tests only (no Docker or PostgreSQL needed)
+uv run pytest tests/test_version_compat.py tests/test_tool_schema_null_defaults.py -v
+
+# Tool argument schema tests only (no Docker or PostgreSQL needed)
+uv run pytest tests/test_tool_schema_null_defaults.py -v
 
 # Integration tests only
 uv run pytest tests/test_tools_integration.py -v
 ```
 
-> **Note**: Docker must be running. The test stack uses ports 5412–5418 (PG 12–18).
+> **Note**: Docker must be running for integration tests. The test stack uses ports 5412–5418 (PG 12–18).
 
 ### Version Compatibility Testing
 

{mcp_postgresql_ops-3.3.9 → mcp_postgresql_ops-3.4.1}/README.md

@@ -16,7 +16,7 @@
 
 ## Architecture & Internal (DeepWiki)
 
-[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/call518/MCP-PostgreSQL-Ops)
+[![Ask DeepWiki](https://img.shields.io/badge/Ask-DeepWiki-blue)](https://deepwiki.com/call518/MCP-PostgreSQL-Ops)
 
 ---
 
@@ -53,7 +53,7 @@
 
 ## Tool Usage Examples
 
-### 📸 **[More Examples with Screenshots →](https://github.com/call518/MCP-PostgreSQL-Ops/wiki/Tool-Usage-Example)**
+### 📸 **[More Examples with Screenshots →](https://github.com/call518/MCP-PostgreSQL-Ops/wiki)**
 
 ---
 
@@ -129,7 +129,8 @@ docker-compose logs -f
 docker-compose ps
 
 # Verify PostgreSQL is ready
-docker-compose logs postgres | grep "ready to accept connections"
+docker compose exec -T postgres sh -c \
+  'pg_isready -h 127.0.0.1 -p 5432 -U "$POSTGRES_USER" -d "$POSTGRES_DB"'
 ```
 
 ### 3. Access to OpenWebUI
@@ -162,7 +163,7 @@ http://localhost:3003/
 
 #### 📖 **Next Steps:**
 - Browse the **[Example Queries section](#usage-examples)** below for more query examples
-- Check out **[Tool Usage Examples with Screenshots](https://github.com/call518/MCP-PostgreSQL-Ops/wiki/Tool-Usage-Example)** for visual guides
+- Check out **[Tool Usage Examples with Screenshots](https://github.com/call518/MCP-PostgreSQL-Ops/wiki)** for visual guides
 - Explore the **[Tool Compatibility Matrix](#tool-compatibility-matrix)** to understand available features
 
 ---
@@ -290,6 +291,20 @@ The `create-test-data.sql` script is executed by the `postgres-init-extensions`
 
 ---
 
+## Tagged Releases
+
+The GitHub Actions workflow publishes a pushed version tag (for example,
+`v1.2.3`, `1.2.3`, or `1.2.3rc1`) to TestPyPI, then PyPI, and finally creates
+a GitHub Release with the tag as its title. Both distribution versions must match
+the tag. The existing `testpypi` and `pypi` GitHub environments must have Trusted
+Publishing configured on their respective package indexes.
+
+Release notes include full commit messages since the most recently published
+GitHub Release, or all commits for the first release. The previous release tag
+must be an ancestor of the new tag. Alpha, beta, and release candidate tags create
+prereleases. Existing published releases are preserved; an existing draft requires
+manual review. A failed publication prevents subsequent publication jobs.
+
 ## Installation
 
 ### From PyPI (Recommended)
@@ -934,11 +949,12 @@ mcp-postgresql-ops --log-level DEBUG
 
 ### Running Tests
 
-Two test suites are available:
+The following test suites are available:
 
 | Suite | File | Requires Docker |
 |-------|------|----------------|
 | Unit tests (version compatibility logic) | `tests/test_version_compat.py` | No |
+| Unit tests (null-default tool argument schemas) | `tests/test_tool_schema_null_defaults.py` | No |
 | Integration tests (all tools × PG 12–18) | `tests/test_tools_integration.py` | Yes |
 
 `uv run pytest` automatically starts the Docker test containers (PG 12–18), waits for them to be fully initialized, runs all tests, then tears everything down.
@@ -947,14 +963,17 @@ Two test suites are available:
 # Run all tests (unit + integration) — Docker is managed automatically
 uv run pytest -v
 
-# Unit tests only (no Docker needed)
-uv run pytest tests/test_version_compat.py -v
+# Unit tests only (no Docker or PostgreSQL needed)
+uv run pytest tests/test_version_compat.py tests/test_tool_schema_null_defaults.py -v
+
+# Tool argument schema tests only (no Docker or PostgreSQL needed)
+uv run pytest tests/test_tool_schema_null_defaults.py -v
 
 # Integration tests only
 uv run pytest tests/test_tools_integration.py -v
 ```
 
-> **Note**: Docker must be running. The test stack uses ports 5412–5418 (PG 12–18).
+> **Note**: Docker must be running for integration tests. The test stack uses ports 5412–5418 (PG 12–18).
 
 ### Version Compatibility Testing
 

mcp_postgresql_ops-3.4.1/scripts/check_release.py

@@ -0,0 +1,72 @@
+"""Require both distribution metadata versions to match the release tag."""
+
+import argparse
+import re
+import tarfile
+import zipfile
+from email.parser import BytesParser
+from pathlib import Path
+
+
+def release_version(tag: str) -> str:
+    """Validate a canonical release tag and return its package version."""
+    version = tag.removeprefix("v")
+    number = r"(?:0|[1-9][0-9]*)"
+    if not re.fullmatch(
+        rf"{number}\.{number}\.{number}(?:(?:a|b|rc){number})?", version
+    ):
+        raise ValueError("Use a tag such as 0.5.7, v0.5.7, or 0.5.7rc1")
+    return version
+
+
+def check_release(tag: str, directory: Path) -> None:
+    """Validate a canonical release tag and the wheel/sdist prepared for upload."""
+    version = release_version(tag)
+    wheels = list(directory.glob("*.whl"))
+    sdists = list(directory.glob("*.tar.gz"))
+    if len(wheels) != 1 or len(sdists) != 1:
+        raise ValueError("Expected exactly one wheel and one source distribution")
+
+    with zipfile.ZipFile(wheels[0]) as archive:
+        metadata_files = [
+            name for name in archive.namelist() if name.endswith(".dist-info/METADATA")
+        ]
+        if len(metadata_files) != 1:
+            raise ValueError("Expected one wheel metadata file")
+        wheel_metadata = archive.read(metadata_files[0])
+    with tarfile.open(sdists[0], "r:gz") as archive:
+        metadata_files = [
+            item
+            for item in archive.getmembers()
+            if len(Path(item.name).parts) == 2 and item.name.endswith("/PKG-INFO")
+        ]
+        if len(metadata_files) != 1:
+            raise ValueError("Expected one source distribution metadata file")
+        stream = archive.extractfile(metadata_files[0])
+        if stream is None:
+            raise ValueError("Source distribution metadata is not a file")
+        with stream:
+            sdist_metadata = stream.read()
+
+    for path, raw in zip((wheels[0], sdists[0]), (wheel_metadata, sdist_metadata)):
+        metadata = BytesParser().parsebytes(raw)
+        if metadata.get("Name") != "mcp-postgresql-ops" or metadata.get("Version") != version:
+            raise ValueError(f"{path.name}: expected mcp-postgresql-ops {version}")
+        print(f"Verified {path.name}: mcp-postgresql-ops {version}")
+
+
+def main() -> None:
+    """Check release artifacts without uploading or modifying them."""
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("tag")
+    parser.add_argument("directory", type=Path)
+    args = parser.parse_args()
+    try:
+        check_release(args.tag, args.directory)
+    except ValueError as exc:
+        parser.exit(1, f"Release validation failed: {exc}\n")
+
+
+if __name__ == "__main__":
+    main()
+

mcp_postgresql_ops-3.4.1/scripts/publish_release.py

@@ -0,0 +1,141 @@
+"""Publish a tag's GitHub Release after package publication has succeeded."""
+
+import argparse
+import json
+import os
+import re
+import subprocess
+import tempfile
+from pathlib import Path
+from typing import Any
+from urllib.parse import quote
+
+from scripts.check_release import release_version
+
+
+def command(*args: str) -> str:
+    """Run an argument list without interpreting commit messages as shell code."""
+    return subprocess.run(
+        args, check=True, capture_output=True, text=True
+    ).stdout.strip()
+
+
+def release_notes(repository: str, tag: str, previous: str | None) -> str:
+    """Collect full commit messages in oldest-first topological order."""
+    current = command("git", "rev-parse", "--verify", f"refs/tags/{tag}^{{commit}}")
+    revision = current
+    if previous:
+        base = command(
+            "git", "rev-parse", "--verify", f"refs/tags/{previous}^{{commit}}"
+        )
+        command("git", "merge-base", "--is-ancestor", base, current)
+        revision = f"{base}..{current}"
+    raw = command(
+        "git",
+        "log",
+        "--reverse",
+        "--topo-order",
+        "--format=%H%x00%B%x00",
+        revision,
+        "--",
+    )
+    parts = raw.split("\0")
+    notes = [
+        f"## {tag}",
+        f"Changes since {previous}." if previous else "Initial release.",
+        "",
+    ]
+    for index in range(0, len(parts) - 1, 2):
+        sha, message = parts[index].strip(), parts[index + 1].strip()
+        # A longer fence preserves messages containing Markdown code fences.
+        fence = "`" * max(
+            3, max((len(m) + 1 for m in re.findall(r"`+", message)), default=3)
+        )
+        notes.extend(
+            [
+                f"### [{sha[:7]}](https://github.com/{repository}/commit/{sha})",
+                f"{fence}text",
+                message,
+                fence,
+                "",
+            ]
+        )
+    if previous:
+        notes.append(
+            f"[Full Changelog](https://github.com/{repository}/compare/{quote(previous, safe='')}...{quote(tag, safe='')})"
+        )
+    return "\n".join(notes) + "\n"
+
+
+def publish_release(repository: str, tag: str) -> None:
+    """Create a release once, using the last published release as the baseline."""
+    version = release_version(tag)
+    current = command("git", "rev-parse", "--verify", f"refs/tags/{tag}^{{commit}}")
+    remote = command("gh", "api", f"repos/{repository}/commits/{tag}", "--jq", ".sha")
+    if current != remote or current != command("git", "rev-parse", "HEAD"):
+        raise ValueError(
+            "The remote tag, local tag, and checked-out commit must match."
+        )
+    pages = json.loads(
+        command(
+            "gh",
+            "api",
+            "--paginate",
+            "--slurp",
+            f"repos/{repository}/releases?per_page=100",
+        )
+    )
+    releases: list[dict[str, Any]] = [release for page in pages for release in page]
+    existing = next(
+        (release for release in releases if release["tag_name"] == tag), None
+    )
+    if existing:
+        if existing["draft"]:
+            raise ValueError("A draft already exists for this tag; review it manually.")
+        print(f"Release {tag} already exists; leaving its content unchanged.")
+        return
+    published = [release for release in releases if not release["draft"]]
+    previous = (
+        max(published, key=lambda release: release["published_at"])["tag_name"]
+        if published
+        else None
+    )
+    notes = release_notes(repository, tag, previous)
+    with tempfile.TemporaryDirectory(prefix="mcp-postgresql-ops-release-") as temporary:
+        path = Path(temporary) / "release-notes.md"
+        path.write_text(notes, encoding="utf-8")
+        args = [
+            "gh",
+            "release",
+            "create",
+            tag,
+            "--repo",
+            repository,
+            "--verify-tag",
+            "--title",
+            tag,
+            "--notes-file",
+            str(path),
+        ]
+        if re.search(r"(?:a|b|rc)\d+$", version):
+            args.extend(["--prerelease", "--latest=false"])
+        command(*args)
+    print(f"Published GitHub Release {tag} (previous release: {previous or 'none'}).")
+
+
+def main() -> None:
+    """Publish only when explicitly called by the final release job."""
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("tag")
+    args = parser.parse_args()
+    try:
+        publish_release(os.environ["GITHUB_REPOSITORY"], args.tag)
+    except subprocess.CalledProcessError as error:
+        parser.exit(1, f"Release command failed: {error.stderr or error}\n")
+    except (ValueError, KeyError, OSError) as error:
+        parser.exit(1, f"GitHub Release failed: {error}\n")
+
+
+if __name__ == "__main__":
+    main()
+