iris-pgwire 1.5.8__tar.gz → 1.7.0__tar.gz

{iris_pgwire-1.5.8 → iris_pgwire-1.7.0}/.gitignore

@@ -79,3 +79,39 @@ docs/articles/developer-community-article.md
 docs/presentations/
 docs/articles/
 /.opencode
+
+# Build / coverage artifacts
+coverage.json
+coverage.xml
+interrogate_badge.svg
+test_failures.jsonl
+htmlcov/
+pgwire.log
+server_log.txt
+
+# Docker runtime files (not for source control)
+merge.cpf
+iris_pgwire.json
+
+# AI tooling files (not for public repo)
+CODEX.md
+TABNINE.md
+
+# Root-level debug/scratch scripts (use scripts/ directory instead)
+check_intersystems.py
+check_iris.py
+check_resolve.py
+find_shadowing.py
+inspect_monkeypatch.py
+repro_scoping.py
+test_conn.py
+test_connection_stability.py
+test_pg_type.py
+test_scope.py
+update_article.py
+verify_demo.sql
+
+# iris-agentic-dev local connection config (per-developer: host, port, container
+# name and credentials vary by machine). Template is committed at
+# specs/043-local-first-sync/spikes/iris-agentic-dev.toml.example
+.iris-agentic-dev.toml

iris_pgwire-1.7.0/PKG-INFO

@@ -0,0 +1,297 @@
+Metadata-Version: 2.5
+Name: iris-pgwire
+Version: 1.7.0
+Summary: PostgreSQL Wire Protocol Server for InterSystems IRIS - Connect BI tools, Python frameworks, and PostgreSQL clients to IRIS databases
+Project-URL: Homepage, https://github.com/intersystems-community/iris-pgwire
+Project-URL: Documentation, https://github.com/intersystems-community/iris-pgwire#readme
+Project-URL: Repository, https://github.com/intersystems-community/iris-pgwire
+Project-URL: Issues, https://github.com/intersystems-community/iris-pgwire/issues
+Project-URL: Changelog, https://github.com/intersystems-community/iris-pgwire/releases
+Author-email: Thomas Dyar <thomas.dyar@intersystems.com>
+Maintainer-email: Thomas Dyar <thomas.dyar@intersystems.com>
+License: MIT License
+        
+        Copyright (c) 2025 Thomas Dyar <thomas.dyar@intersystems.com>
+        
+        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.
+License-File: LICENSE
+Keywords: async,bi-tools,database,fastapi,intersystems,iris,llm,pgvector,postgres,postgresql,rag,sql,sqlalchemy,vector-database,wire-protocol
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Framework :: AsyncIO
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Database
+Classifier: Topic :: Database :: Database Engines/Servers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Networking
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: cryptography>=41.0.0
+Requires-Dist: intersystems-irispython>=5.1.2
+Requires-Dist: opentelemetry-api>=1.20.0
+Requires-Dist: opentelemetry-exporter-otlp>=1.20.0
+Requires-Dist: opentelemetry-instrumentation-asyncio>=0.41b0
+Requires-Dist: opentelemetry-sdk>=1.20.0
+Requires-Dist: prometheus-client>=0.17.0
+Requires-Dist: psycopg2-binary>=2.9.10
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: sqlparse>=0.4.0
+Requires-Dist: structlog>=23.0.0
+Provides-Extra: ai
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.5.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: iris
+Provides-Extra: kerberos
+Requires-Dist: gssapi>=1.8.0; extra == 'kerberos'
+Provides-Extra: test
+Requires-Dist: docker>=6.0.0; extra == 'test'
+Requires-Dist: iris-devtester>=0.1.0; extra == 'test'
+Requires-Dist: k5test>=0.10.3; extra == 'test'
+Requires-Dist: psycopg[binary]>=3.1.0; extra == 'test'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'test'
+Requires-Dist: pytest-benchmark>=4.0.0; extra == 'test'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'test'
+Requires-Dist: pytest-fixtures>=3.0.0; extra == 'test'
+Requires-Dist: pytest-timeout>=2.2.0; extra == 'test'
+Requires-Dist: pytest>=7.0.0; extra == 'test'
+Requires-Dist: sqlparse>=0.4.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# iris-pgwire
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![Coverage: 92%](https://img.shields.io/badge/coverage-92%25-brightgreen.svg)](https://github.com/intersystems-community/iris-pgwire)
+
+PostgreSQL wire protocol server for InterSystems IRIS. Connects BI tools, Python frameworks, data pipelines, and any PostgreSQL-compatible client to IRIS databases — no IRIS-specific drivers needed.
+
+**Connection string**: `postgresql://user:pass@localhost:5432/USER`
+
+---
+
+## Quick Start
+
+### Docker (recommended)
+
+```bash
+git clone https://github.com/intersystems-community/iris-pgwire.git
+cd iris-pgwire
+docker compose up -d
+
+# Test it (PGWire runs on port 5432 inside the IRIS container)
+psql -h localhost -p 5432 -U _SYSTEM -d USER -c "SELECT 'Hello from IRIS!'"
+```
+
+### Python package
+
+```bash
+pip install iris-pgwire psycopg[binary]
+
+export IRIS_HOST=localhost IRIS_PORT=1972 \
+       IRIS_USERNAME=_SYSTEM IRIS_PASSWORD=SYS IRIS_NAMESPACE=USER
+
+python -m iris_pgwire.server
+```
+
+### First query
+
+```python
+import psycopg
+
+with psycopg.connect("host=localhost port=5432 dbname=USER user=_SYSTEM password=SYS") as conn:
+    with conn.cursor() as cur:
+        cur.execute("SELECT COUNT(*) FROM MyTable")
+        print(cur.fetchone()[0])
+```
+
+---
+
+## Verified Client Compatibility
+
+Tested against real IRIS instances via the wire protocol:
+
+| Language | Clients                                      |
+| -------- | -------------------------------------------- |
+| Python   | psycopg3, asyncpg, SQLAlchemy (sync + async) |
+| Node.js  | pg (node-postgres)                           |
+| Java     | PostgreSQL JDBC                              |
+| .NET     | Npgsql                                       |
+| Go       | pgx v5                                       |
+| Ruby     | pg gem                                       |
+| Rust     | tokio-postgres                               |
+| PHP      | PDO PostgreSQL                               |
+
+**ORMs**: SQLAlchemy, Prisma, Drizzle, Sequelize, Hibernate  
+**BI tools**: Apache Superset, Metabase, Grafana (standard PostgreSQL driver)
+
+See [Client Compatibility Guide](docs/CLIENT_RECOMMENDATIONS.md) for setup examples.
+
+---
+
+## Key Features
+
+**pgvector operators** — `<=>` (cosine), `<#>` (dot product), `<->` (L2) auto-translate to IRIS `VECTOR_COSINE`/`VECTOR_DOT_PRODUCT`. HNSW indexes give 5× speedup at 100K+ vectors. See [Vector Operations](docs/VECTOR_PARAMETER_BINDING.md).
+
+**DDL compatibility** — Automatic `public` ↔ `SQLUser` schema mapping; strips `fillfactor`, `GENERATED` columns, `USING btree`, `IF NOT EXISTS` guards, and other PostgreSQL-specific DDL so ORM migrations run cleanly. See [DDL Compatibility](docs/DDL_COMPATIBILITY.md).
+
+**SQL translation** — `RETURNING` emulation, `ON CONFLICT`, boolean literals, `pg_catalog` → `INFORMATION_SCHEMA` rewrites, JSON operators (`->` / `->>` → `JSON_EXTRACT`), parameterized queries.
+
+**Authentication** — SCRAM-SHA-256, OAuth 2.0 (RFC 6749), IRIS Wallet credentials.
+
+**Dual backend** — Embedded Python (irispython, lowest latency) or external DBAPI (standard TCP connection). Selectable via `IRIS_BACKEND` env var.
+
+**COPY protocol** — Bulk load via `COPY … FROM STDIN` (~600 rows/sec on DBAPI path).
+
+---
+
+## Usage Examples
+
+### Parameterized queries (psycopg3)
+
+```python
+import psycopg
+
+with psycopg.connect("host=localhost port=5432 dbname=USER user=_SYSTEM password=SYS") as conn:
+    with conn.cursor() as cur:
+        cur.execute("SELECT * FROM MyTable WHERE id = %s", (42,))
+        row = cur.fetchone()
+```
+
+### Vector similarity search
+
+```python
+query_vector = [0.1, 0.2, 0.3]
+with conn.cursor() as cur:
+    cur.execute("""
+        SELECT id, embedding <=> %s::vector AS score
+        FROM vectors
+        ORDER BY score
+        LIMIT 5
+    """, (query_vector,))
+    results = cur.fetchall()
+```
+
+### Async SQLAlchemy
+
+```python
+from sqlalchemy.ext.asyncio import create_async_engine, AsyncSession, async_sessionmaker
+from sqlalchemy import text
+
+engine = create_async_engine("postgresql+psycopg://localhost:5432/USER")
+SessionLocal = async_sessionmaker(engine, class_=AsyncSession)
+
+async def query():
+    async with SessionLocal() as session:
+        result = await session.execute(text("SELECT * FROM MyTable"))
+        return result.fetchall()
+```
+
+### COPY bulk load
+
+```python
+with conn.cursor() as cur:
+    with cur.copy("COPY MyTable (col1, col2) FROM STDIN") as copy:
+        for row in data:
+            copy.write_row(row)
+```
+
+---
+
+## Documentation
+
+| Guide                                                  | Description                                |
+| ------------------------------------------------------ | ------------------------------------------ |
+| [Installation](docs/INSTALLATION.md)                   | Docker, PyPI, Embedded Python deployment   |
+| [Architecture](docs/ARCHITECTURE.md)                   | System design, dual backend, request flow  |
+| [DDL Compatibility](docs/DDL_COMPATIBILITY.md)         | PostgreSQL DDL transformations             |
+| [Vector Operations](docs/VECTOR_PARAMETER_BINDING.md)  | pgvector syntax, HNSW indexes              |
+| [Client Compatibility](docs/CLIENT_RECOMMENDATIONS.md) | Per-language setup and caveats             |
+| [Deployment](docs/DEPLOYMENT.md)                       | Production setup, SSL/TLS, auth            |
+| [Performance](docs/PERFORMANCE.md)                     | Benchmarks, tuning                         |
+| [Developer Guide](docs/developer_guide.md)             | Development setup, contribution guidelines |
+
+---
+
+## Development
+
+```bash
+# Install dependencies
+uv sync --frozen
+
+# Run unit + contract tests (no IRIS needed)
+pytest tests/unit/ tests/contract/ -v
+
+# Run with live IRIS (container must be up)
+docker compose up -d
+PGWIRE_BACKEND_TYPE=dbapi PGWIRE_POOL_SIZE=1 pytest tests/ -v
+
+# Code quality check
+python -m iris_pgwire.quality
+```
+
+**Test coverage**: 92% (5349 tests)  
+**Code quality**: black (formatter), ruff (linter), bandit (security)
+
+---
+
+## Known Limitations
+
+See [KNOWN_LIMITATIONS.md](KNOWN_LIMITATIONS.md) for the full list. Key items:
+
+- IRIS Community Edition: 5-user connection limit — use `PGWIRE_POOL_SIZE=1` for dev
+- No native SSL termination — use nginx/HAProxy in front for TLS
+- Kerberos/GSSAPI auth wiring deferred (OAuth 2.0 is the recommended enterprise auth)
+- `INFORMATION_SCHEMA` only, no `pg_catalog` tables (translated automatically)
+
+---
+
+## Contributing
+
+```bash
+git clone https://github.com/intersystems-community/iris-pgwire.git
+cd iris-pgwire
+uv sync --frozen
+docker compose up -d
+pytest tests/unit/ tests/contract/ -v
+```
+
+Open an issue or PR on [GitHub](https://github.com/intersystems-community/iris-pgwire/issues).
+
+---
+
+## Links
+
+- [InterSystems IRIS](https://www.intersystems.com/products/intersystems-iris/)
+- [IRIS Documentation](https://docs.intersystems.com/iris/)
+- [PostgreSQL Protocol Spec](https://www.postgresql.org/docs/current/protocol.html)
+- [pgvector](https://github.com/pgvector/pgvector)
+
+---
+
+MIT License — see [LICENSE](LICENSE)

iris_pgwire-1.7.0/README.md

@@ -0,0 +1,212 @@
+# iris-pgwire
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![Coverage: 92%](https://img.shields.io/badge/coverage-92%25-brightgreen.svg)](https://github.com/intersystems-community/iris-pgwire)
+
+PostgreSQL wire protocol server for InterSystems IRIS. Connects BI tools, Python frameworks, data pipelines, and any PostgreSQL-compatible client to IRIS databases — no IRIS-specific drivers needed.
+
+**Connection string**: `postgresql://user:pass@localhost:5432/USER`
+
+---
+
+## Quick Start
+
+### Docker (recommended)
+
+```bash
+git clone https://github.com/intersystems-community/iris-pgwire.git
+cd iris-pgwire
+docker compose up -d
+
+# Test it (PGWire runs on port 5432 inside the IRIS container)
+psql -h localhost -p 5432 -U _SYSTEM -d USER -c "SELECT 'Hello from IRIS!'"
+```
+
+### Python package
+
+```bash
+pip install iris-pgwire psycopg[binary]
+
+export IRIS_HOST=localhost IRIS_PORT=1972 \
+       IRIS_USERNAME=_SYSTEM IRIS_PASSWORD=SYS IRIS_NAMESPACE=USER
+
+python -m iris_pgwire.server
+```
+
+### First query
+
+```python
+import psycopg
+
+with psycopg.connect("host=localhost port=5432 dbname=USER user=_SYSTEM password=SYS") as conn:
+    with conn.cursor() as cur:
+        cur.execute("SELECT COUNT(*) FROM MyTable")
+        print(cur.fetchone()[0])
+```
+
+---
+
+## Verified Client Compatibility
+
+Tested against real IRIS instances via the wire protocol:
+
+| Language | Clients                                      |
+| -------- | -------------------------------------------- |
+| Python   | psycopg3, asyncpg, SQLAlchemy (sync + async) |
+| Node.js  | pg (node-postgres)                           |
+| Java     | PostgreSQL JDBC                              |
+| .NET     | Npgsql                                       |
+| Go       | pgx v5                                       |
+| Ruby     | pg gem                                       |
+| Rust     | tokio-postgres                               |
+| PHP      | PDO PostgreSQL                               |
+
+**ORMs**: SQLAlchemy, Prisma, Drizzle, Sequelize, Hibernate  
+**BI tools**: Apache Superset, Metabase, Grafana (standard PostgreSQL driver)
+
+See [Client Compatibility Guide](docs/CLIENT_RECOMMENDATIONS.md) for setup examples.
+
+---
+
+## Key Features
+
+**pgvector operators** — `<=>` (cosine), `<#>` (dot product), `<->` (L2) auto-translate to IRIS `VECTOR_COSINE`/`VECTOR_DOT_PRODUCT`. HNSW indexes give 5× speedup at 100K+ vectors. See [Vector Operations](docs/VECTOR_PARAMETER_BINDING.md).
+
+**DDL compatibility** — Automatic `public` ↔ `SQLUser` schema mapping; strips `fillfactor`, `GENERATED` columns, `USING btree`, `IF NOT EXISTS` guards, and other PostgreSQL-specific DDL so ORM migrations run cleanly. See [DDL Compatibility](docs/DDL_COMPATIBILITY.md).
+
+**SQL translation** — `RETURNING` emulation, `ON CONFLICT`, boolean literals, `pg_catalog` → `INFORMATION_SCHEMA` rewrites, JSON operators (`->` / `->>` → `JSON_EXTRACT`), parameterized queries.
+
+**Authentication** — SCRAM-SHA-256, OAuth 2.0 (RFC 6749), IRIS Wallet credentials.
+
+**Dual backend** — Embedded Python (irispython, lowest latency) or external DBAPI (standard TCP connection). Selectable via `IRIS_BACKEND` env var.
+
+**COPY protocol** — Bulk load via `COPY … FROM STDIN` (~600 rows/sec on DBAPI path).
+
+---
+
+## Usage Examples
+
+### Parameterized queries (psycopg3)
+
+```python
+import psycopg
+
+with psycopg.connect("host=localhost port=5432 dbname=USER user=_SYSTEM password=SYS") as conn:
+    with conn.cursor() as cur:
+        cur.execute("SELECT * FROM MyTable WHERE id = %s", (42,))
+        row = cur.fetchone()
+```
+
+### Vector similarity search
+
+```python
+query_vector = [0.1, 0.2, 0.3]
+with conn.cursor() as cur:
+    cur.execute("""
+        SELECT id, embedding <=> %s::vector AS score
+        FROM vectors
+        ORDER BY score
+        LIMIT 5
+    """, (query_vector,))
+    results = cur.fetchall()
+```
+
+### Async SQLAlchemy
+
+```python
+from sqlalchemy.ext.asyncio import create_async_engine, AsyncSession, async_sessionmaker
+from sqlalchemy import text
+
+engine = create_async_engine("postgresql+psycopg://localhost:5432/USER")
+SessionLocal = async_sessionmaker(engine, class_=AsyncSession)
+
+async def query():
+    async with SessionLocal() as session:
+        result = await session.execute(text("SELECT * FROM MyTable"))
+        return result.fetchall()
+```
+
+### COPY bulk load
+
+```python
+with conn.cursor() as cur:
+    with cur.copy("COPY MyTable (col1, col2) FROM STDIN") as copy:
+        for row in data:
+            copy.write_row(row)
+```
+
+---
+
+## Documentation
+
+| Guide                                                  | Description                                |
+| ------------------------------------------------------ | ------------------------------------------ |
+| [Installation](docs/INSTALLATION.md)                   | Docker, PyPI, Embedded Python deployment   |
+| [Architecture](docs/ARCHITECTURE.md)                   | System design, dual backend, request flow  |
+| [DDL Compatibility](docs/DDL_COMPATIBILITY.md)         | PostgreSQL DDL transformations             |
+| [Vector Operations](docs/VECTOR_PARAMETER_BINDING.md)  | pgvector syntax, HNSW indexes              |
+| [Client Compatibility](docs/CLIENT_RECOMMENDATIONS.md) | Per-language setup and caveats             |
+| [Deployment](docs/DEPLOYMENT.md)                       | Production setup, SSL/TLS, auth            |
+| [Performance](docs/PERFORMANCE.md)                     | Benchmarks, tuning                         |
+| [Developer Guide](docs/developer_guide.md)             | Development setup, contribution guidelines |
+
+---
+
+## Development
+
+```bash
+# Install dependencies
+uv sync --frozen
+
+# Run unit + contract tests (no IRIS needed)
+pytest tests/unit/ tests/contract/ -v
+
+# Run with live IRIS (container must be up)
+docker compose up -d
+PGWIRE_BACKEND_TYPE=dbapi PGWIRE_POOL_SIZE=1 pytest tests/ -v
+
+# Code quality check
+python -m iris_pgwire.quality
+```
+
+**Test coverage**: 92% (5349 tests)  
+**Code quality**: black (formatter), ruff (linter), bandit (security)
+
+---
+
+## Known Limitations
+
+See [KNOWN_LIMITATIONS.md](KNOWN_LIMITATIONS.md) for the full list. Key items:
+
+- IRIS Community Edition: 5-user connection limit — use `PGWIRE_POOL_SIZE=1` for dev
+- No native SSL termination — use nginx/HAProxy in front for TLS
+- Kerberos/GSSAPI auth wiring deferred (OAuth 2.0 is the recommended enterprise auth)
+- `INFORMATION_SCHEMA` only, no `pg_catalog` tables (translated automatically)
+
+---
+
+## Contributing
+
+```bash
+git clone https://github.com/intersystems-community/iris-pgwire.git
+cd iris-pgwire
+uv sync --frozen
+docker compose up -d
+pytest tests/unit/ tests/contract/ -v
+```
+
+Open an issue or PR on [GitHub](https://github.com/intersystems-community/iris-pgwire/issues).
+
+---
+
+## Links
+
+- [InterSystems IRIS](https://www.intersystems.com/products/intersystems-iris/)
+- [IRIS Documentation](https://docs.intersystems.com/iris/)
+- [PostgreSQL Protocol Spec](https://www.postgresql.org/docs/current/protocol.html)
+- [pgvector](https://github.com/pgvector/pgvector)
+
+---
+
+MIT License — see [LICENSE](LICENSE)

{iris_pgwire-1.5.8 → iris_pgwire-1.7.0}/pyproject.toml

@@ -99,6 +99,15 @@ iris = [
     # IRIS embedded Python (when available)
     # "intersystems-iris>=3.6.0",
 ]
+ai = [
+    # IRIS-aware agent tooling. iris-agentic-dev is a Rust binary and is NOT
+    # published on PyPI, so it cannot be declared as a dependency here — doing
+    # so made `pip install iris-pgwire[ai]` fail outright. Install it directly:
+    #   Linux:  curl -fsSL https://github.com/intersystems-community/iris-agentic-dev/releases/latest/download/iris-agentic-dev-linux-x86_64 \
+    #             -o /usr/local/bin/iris-agentic-dev && chmod +x /usr/local/bin/iris-agentic-dev
+    #   macOS:  brew install https://raw.githubusercontent.com/intersystems-community/iris-agentic-dev/master/Formula/iris-agentic-dev.rb
+    # See docs/iris-pgwire-iad-setup-issues.md and AGENTS.md.
+]
 kerberos = [
     # Kerberos GSSAPI authentication (optional - not implemented in wire protocol yet)
     # Install with: pip install iris-pgwire[kerberos]

{iris_pgwire-1.5.8 → iris_pgwire-1.7.0}/src/iris_pgwire/__init__.py

@@ -6,7 +6,7 @@ Based on the specification from docs/iris_pgwire_plan.md and proven patterns fro
 caretdev/sqlalchemy-iris.
 """
 
-__version__ = "1.5.8"
+__version__ = "1.7.0"
 __author__ = "Thomas Dyar <thomas.dyar@intersystems.com>"
 
 # Don't import server/protocol in __init__ to avoid sys.modules conflicts

iris_pgwire-1.7.0/src/iris_pgwire/catalog/_reentrancy.py

@@ -0,0 +1,27 @@
+"""Re-entrancy guard for catalog query handling.
+
+Lives in its own module because two things need it and importing it from
+`catalog_router` creates a cycle: the router imports the view registry, and the
+view installer needs the guard.
+
+Some handlers answer a catalog query by issuing their own SQL through the
+executor — `_build_pg_class_response` asks IRIS for `INFORMATION_SCHEMA.TABLES`.
+That inner query re-enters the router, which would intercept it and return zero
+rows, leaving the handler with nothing to report. The view installer has the
+same problem in a sharper form: its `CREATE VIEW pg_catalog.pg_class AS ...` was
+handed to the pg_class handler, which answered it with a synthetic success — so
+installation reported success while creating nothing.
+
+A ContextVar rather than a flag, so the guard is scoped to the asyncio task and
+one session's internal query cannot suppress interception for a concurrent one.
+"""
+
+from __future__ import annotations
+
+import contextvars
+
+_IN_CATALOG_HANDLER: contextvars.ContextVar[bool] = contextvars.ContextVar(
+    "iris_pgwire_in_catalog_handler", default=False
+)
+
+__all__ = ["_IN_CATALOG_HANDLER"]