datus-postgresql 0.1.0__tar.gz

datus_postgresql-0.1.0/.gitignore

@@ -0,0 +1,137 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.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/
+
+# 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
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# uv
+uv.lock
+
+# PEP 582
+__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/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db

datus_postgresql-0.1.0/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: datus-postgresql
+Version: 0.1.0
+Summary: PostgreSQL database adapter for Datus
+Project-URL: Homepage, https://github.com/Datus-ai/datus-db-adapters
+Project-URL: Repository, https://github.com/Datus-ai/datus-db-adapters
+Project-URL: Issues, https://github.com/Datus-ai/datus-db-adapters/issues
+Author-email: DatusAI <support@datus.ai>
+License: Apache-2.0
+Keywords: adapter,database,datus,postgresql
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.12
+Requires-Dist: datus-agent>0.2.1
+Requires-Dist: datus-sqlalchemy>=0.1.2
+Requires-Dist: psycopg2-binary>=2.9.11
+Requires-Dist: pydantic>=2.0.0
+Description-Content-Type: text/markdown
+
+# datus-postgresql
+
+PostgreSQL database adapter for Datus.
+
+## Installation
+
+```bash
+pip install datus-postgresql
+```
+
+## Usage
+
+```python
+from datus_postgresql import PostgreSQLConnector, PostgreSQLConfig
+
+# Using config object
+config = PostgreSQLConfig(
+    host="localhost",
+    port=5432,
+    username="postgres",
+    password="password",
+    database="mydb",
+    schema_name="public",
+)
+
+connector = PostgreSQLConnector(config)
+
+# Or using dict
+connector = PostgreSQLConnector({
+    "host": "localhost",
+    "port": 5432,
+    "username": "postgres",
+    "password": "password",
+    "database": "mydb",
+})
+
+# Test connection
+connector.test_connection()
+
+# Execute queries
+result = connector.execute({"sql_query": "SELECT * FROM users"})
+```
+
+## Configuration Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| host | str | "127.0.0.1" | PostgreSQL server host |
+| port | int | 5432 | PostgreSQL server port |
+| username | str | required | PostgreSQL username |
+| password | str | "" | PostgreSQL password |
+| database | str | None | Default database name |
+| schema | str | "public" | Default schema name |
+| sslmode | str | "prefer" | SSL mode |
+| timeout_seconds | int | 30 | Connection timeout |
+
+## License
+
+Apache-2.0

datus_postgresql-0.1.0/README.md

@@ -0,0 +1,59 @@
+# datus-postgresql
+
+PostgreSQL database adapter for Datus.
+
+## Installation
+
+```bash
+pip install datus-postgresql
+```
+
+## Usage
+
+```python
+from datus_postgresql import PostgreSQLConnector, PostgreSQLConfig
+
+# Using config object
+config = PostgreSQLConfig(
+    host="localhost",
+    port=5432,
+    username="postgres",
+    password="password",
+    database="mydb",
+    schema_name="public",
+)
+
+connector = PostgreSQLConnector(config)
+
+# Or using dict
+connector = PostgreSQLConnector({
+    "host": "localhost",
+    "port": 5432,
+    "username": "postgres",
+    "password": "password",
+    "database": "mydb",
+})
+
+# Test connection
+connector.test_connection()
+
+# Execute queries
+result = connector.execute({"sql_query": "SELECT * FROM users"})
+```
+
+## Configuration Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| host | str | "127.0.0.1" | PostgreSQL server host |
+| port | int | 5432 | PostgreSQL server port |
+| username | str | required | PostgreSQL username |
+| password | str | "" | PostgreSQL password |
+| database | str | None | Default database name |
+| schema | str | "public" | Default schema name |
+| sslmode | str | "prefer" | SSL mode |
+| timeout_seconds | int | 30 | Connection timeout |
+
+## License
+
+Apache-2.0

datus_postgresql-0.1.0/datus_postgresql/__init__.py

@@ -0,0 +1,16 @@
+# Copyright 2025-present DatusAI, Inc.
+# Licensed under the Apache License, Version 2.0.
+# See http://www.apache.org/licenses/LICENSE-2.0 for details.
+
+from .config import PostgreSQLConfig
+from .connector import PostgreSQLConnector
+
+__version__ = "0.1.0"
+__all__ = ["PostgreSQLConnector", "PostgreSQLConfig", "register"]
+
+
+def register():
+    """Register PostgreSQL connector with Datus registry."""
+    from datus.tools.db_tools import connector_registry
+
+    connector_registry.register("postgresql", PostgreSQLConnector, config_class=PostgreSQLConfig)

datus_postgresql-0.1.0/datus_postgresql/config.py

@@ -0,0 +1,24 @@
+# Copyright 2025-present DatusAI, Inc.
+# Licensed under the Apache License, Version 2.0.
+# See http://www.apache.org/licenses/LICENSE-2.0 for details.
+
+from typing import Optional
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class PostgreSQLConfig(BaseModel):
+    """PostgreSQL-specific configuration."""
+
+    model_config = ConfigDict(extra="forbid", populate_by_name=True)
+
+    host: str = Field(default="127.0.0.1", description="PostgreSQL server host")
+    port: int = Field(default=5432, description="PostgreSQL server port")
+    username: str = Field(..., description="PostgreSQL username")
+    password: str = Field(default="", description="PostgreSQL password", json_schema_extra={"input_type": "password"})
+    database: Optional[str] = Field(default=None, description="Default database name")
+    schema_name: Optional[str] = Field(default="public", alias="schema", description="Default schema name")
+    sslmode: str = Field(
+        default="prefer", description="SSL mode (disable, allow, prefer, require, verify-ca, verify-full)"
+    )
+    timeout_seconds: int = Field(default=30, description="Connection timeout in seconds")