geo-calcite 0.3.0

Python client for Geo-Calcite data service

Geo-Calcite Python Client

A lightweight Python client for interacting with the Geo-Calcite API.
Provides helpers for connecting to, refreshing, querying, and disconnecting from Geo-Calcite data sources over HTTP, and returns results as native Python objects or pandas DataFrames.

---

Features

• Connect to one or more Geo-Calcite data sources by DID (data identifier)
• Refresh existing connections
• Disconnect from data sources
• List Tables from the latest connect/refresh cache via list_tables()
• Query connected sources via SQL and return results as a pandas DataFrame

---

Table of Contents

• Geo-Calcite Python Client
  • Features
  • Table of Contents
  • Installation
  • Quickstart
  • Contributing
  • License

---

Installation

Install via pip:

pip install geo_calcite

---

Quickstart

# Import and create a GeoCalcite client, ignore if already created.
from geo_calcite import GeoCalciteClient

# verbose=False by default. Set verbose=True to print runtime logs.
client = GeoCalciteClient(verbose=True)

# Connect to datasource, like "pbdb" with its DID "1"
dids = [1]
client.connect(dids)

# Print and return currently cached tables from latest connect/refresh.
tables = client.list_tables()
print(tables)

# SQL query for data entity, remove "LIMIT 5" to get full data. 
sql = "SELECT * FROM pbdb.gx_8260001_pbdb LIMIT 5"
df = client.query(sql)
print(df)

# Disconnect from datasource after use.
client.disconnect(dids)

---

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/foo
3. Commit your changes: git commit -am 'Add foo feature'
4. Push to the branch: git push origin feature/foo
5. Open a Pull Request

---

License

This project is licensed under the Apache License, Version 2.0. See the LICENSE file for details.