Metadata-Version: 2.4
Name: ultipa
Version: 6.0.1
Summary: Pure Python Ultipa Driver
Home-page: https://github.com/ultipa/gqldb-drivers
Author: Ultipa Team
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: grpcio>=1.60.0
Requires-Dist: protobuf>=4.25.0
Provides-Extra: dev
Requires-Dist: grpcio-tools>=1.60.0; extra == "dev"
Requires-Dist: pytest>=7.4.0; extra == "dev"
Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Ultipa Python Driver

Official Python driver for Ultipa graph database (GQL).

## Requirements

- Python 3.9+

## Installation

```bash
pip install ultipa
```

> **Note:** This is the v6.x driver for Ultipa GQL. If you are using Ultipa v4.x, please install [ultipa==4.5.2](https://pypi.org/project/ultipa/4.5.2/). If you are using Ultipa v5.x, please install [ultipa==5.2.1](https://pypi.org/project/ultipa/5.2.1/).

## Quick Start

```python
from gqldb import GqldbClient
from gqldb.config import GqldbConfig

# Create client
config = GqldbConfig(
    hosts=["localhost:60061"],
    username="admin",
    password="password",
    default_graph="myGraph"
)
client = GqldbClient(config)
client.login("admin", "password")

# Execute query
response = client.gql("MATCH (n) RETURN n LIMIT 10")

print(f"Rows: {len(response.rows)}")
print(f"Columns: {response.columns}")

# Close
client.close()
```

## Features

- GQL query execution with parameters
- Streaming results for large datasets
- Transaction support (begin, commit, rollback)
- Graph management (create, drop, list)
- Bulk import for high-throughput loading
- Algorithm support (CALL algo.pagerank, algo.degree, etc.)
- Type hints support
- Health checks

## Documentation

See [GUIDE.md](GUIDE.md) for detailed usage.

## License

[MIT License](LICENSE)
