waveassist 0.1.3

WaveAssist Python SDK for storing and retrieving structured data

WaveAssist SDK & CLI 🌊

WaveAssist makes it simple to store and retrieve data in your automation workflows. Access your projects through our Python SDK or CLI.

---

✨ Features

• 🔐 One-line init() to connect with your WaveAssist project
• ⚙️ Automatically works on local and WaveAssist Cloud (worker) environments
• 📦 Store and retrieve data (DataFrames, JSON, strings)
• 🧠 LLM-friendly function names (init, store_data, fetch_data)
• 📁 Auto-serialization for common Python objects
• 🖥️ Command-line interface for project management
• ✅ Built for automation workflows, cron jobs, and AI pipelines

---

🚀 Getting Started

1. Install

pip install waveassist

---

2. Initialize the SDK

import waveassist

# Option 1: Use no arguments (recommended)
waveassist.init()

# Will auto-resolve from:
# 1. Explicit args (if passed)
# 2. .env file (WA_UID, WA_PROJECT_KEY, WA_ENV_KEY)
# 3. Worker-injected credentials (on [WaveAssist Cloud](https://waveassist.io))

🛠 Setting up .env (for local runs)

uid=your-user-id
project_key=your-project-key

# optional
environment_key=your-env-key

This file will be ignored by Git if you use our default .gitignore.

---

3. Store Data

🧾 Store a string

waveassist.store_data("welcome_message", "Hello, world!")

📊 Store a DataFrame

import pandas as pd

df = pd.DataFrame({"name": ["Alice", "Bob"], "score": [95, 88]})
waveassist.store_data("user_scores", df)

🧠 Store JSON/dict/array

profile = {"name": "Alice", "age": 30}
waveassist.store_data("profile_data", profile)

---

4. Fetch Data

result = waveassist.fetch_data("user_scores")

# Will return:
# - A DataFrame (if stored as one)
# - A dict/list (if stored as JSON)
# - A string (if stored as text)

---

🖥️ Command Line Interface

WaveAssist CLI comes bundled with the Python package. After installation, you can use the following commands:

🔑 Authentication

waveassist login

This will open your browser for authentication and store the token locally.

📤 Push Code

waveassist push PROJECT_KEY [--force]

Push your local Python code to a WaveAssist project.

📥 Pull Code

waveassist pull PROJECT_KEY [--force]

Pull Python code from a WaveAssist project to your local machine.

ℹ️ Version Info

waveassist version

Display CLI version and environment information.

---

🧪 Running Tests

If you’re not using pytest, just run the test script directly:

python tests/run_tests.py

✅ Includes tests for:

• String roundtrip
• JSON/dict roundtrip
• DataFrame roundtrip
• Error if init() is not called

---

🛠 Project Structure

WaveAssist/
├── waveassist/
│   ├── __init__.py          # init(), store_data(), fetch_data()
│   ├── _config.py           # Global config vars
│   └── ...
├── tests/
│   └── run_tests.py         # Manual test runner

---

📌 Notes

• Data is stored in your WaveAssist backend (e.g. MongoDB) as serialized content
• store_data() auto-detects the object type and serializes it (CSV/JSON/text)
• fetch_data() deserializes it back to the right Python object

---

🧠 Example Use Case

import waveassist
waveassist.init()  # Auto-initialized from .env or worker

# Store GitHub PR data
waveassist.store_data("latest_pr", {
    "title": "Fix bug in auth",
    "author": "alice",
    "status": "open"
})

# Later, fetch it for further processing
pr = waveassist.fetch_data("latest_pr")
print(pr["title"])

---

🤝 Contributing

Want to add formats, features, or cloud extensions? PRs welcome!

---

📬 Contact

Need help or have feedback? Reach out at [e-mail], visit WaveAssist.io, or open an issue.

---

© 2025 WaveAssist