helius-python 0.0.1__tar.gz → 0.0.3__tar.gz

{helius_python-0.0.1 → helius_python-0.0.3}/AGENTS.md

@@ -169,7 +169,7 @@ Skeleton:
 import json
 import httpx
 import respx
-from helius import HeliusClient
+from helius.client import HeliusClient
 
 @respx.mock
 def test_get_balance():

{helius_python-0.0.1 → helius_python-0.0.3}/CONTRIBUTING.md

@@ -105,6 +105,12 @@ basedpyright src
 Make sure your change at least imports cleanly and the method you added
 actually works against a real Helius endpoint.
 
+Run the test suite with the local `src` package on the import path:
+
+```bash
+PYTHONPATH=src .venv/bin/pytest
+```
+
 ## Pull Requests
 
 - Keep PRs focused. One method, one bug fix, or one refactor per PR.

{helius_python-0.0.1 → helius_python-0.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: helius-python
-Version: 0.0.1
+Version: 0.0.3
 Summary: Typed Python client for the Helius API
 Project-URL: Homepage, https://github.com/markosnarinian/helius-python
 Project-URL: Issues, https://github.com/markosnarinian/helius-python/issues
@@ -10,6 +10,9 @@ License-File: LICENSE
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.9
+Requires-Dist: httpx
+Requires-Dist: pydantic
+Requires-Dist: python-dotenv
 Provides-Extra: dev
 Requires-Dist: pytest; extra == 'dev'
 Requires-Dist: respx; extra == 'dev'
@@ -61,27 +64,42 @@ type checking.
 pip install helius-python
 ```
 
+This installs the runtime dependencies automatically:
+
+- `httpx` for HTTP transport
+- `pydantic` for typed response models and argument validation
+- `python-dotenv` for optional `.env` loading of `HELIUS_API_KEY`
+
+You do not need to install these separately unless your environment disables
+dependency installation.
+
 ## Authentication
 
 Pass your Helius API key explicitly:
 
 ```python
-from helius import HeliusClient
+from helius.client import HeliusClient
 
 client = HeliusClient(api_key="YOUR_HELIUS_API_KEY")
 ```
 
-or set it in a `.env` file at the project root and let the client pick it up
-automatically:
+or set `HELIUS_API_KEY` as an environment variable:
+
+```bash
+export HELIUS_API_KEY=your_helius_api_key
+```
+
+You can also set it in a `.env` file at the project root and let the client
+pick it up automatically:
 
 ```env
 HELIUS_API_KEY=your_helius_api_key
 ```
 
 ```python
-from helius import HeliusClient
+from helius.client import HeliusClient
 
-client = HeliusClient()  # reads HELIUS_API_KEY from .env
+client = HeliusClient()  # reads HELIUS_API_KEY from the environment or .env
 ```
 
 ## Usage
@@ -89,7 +107,7 @@ client = HeliusClient()  # reads HELIUS_API_KEY from .env
 ### As a context manager (recommended)
 
 ```python
-from helius import HeliusClient
+from helius.client import HeliusClient
 
 with HeliusClient(api_key="YOUR_HELIUS_API_KEY") as client:
     balance = client.get_balance("So11111111111111111111111111111111111111112")
@@ -109,7 +127,7 @@ If a `with` block doesn't fit your code structure (e.g. the client lives on
 a long-lived object), call `close()` yourself when you're done:
 
 ```python
-from helius import HeliusClient
+from helius.client import HeliusClient
 
 client = HeliusClient(api_key="YOUR_HELIUS_API_KEY")
 try:
@@ -133,7 +151,7 @@ instance is garbage-collected. Prefer `with` or `close()` regardless.
 | Argument  | Default                              | Notes                                                                                         |
 | --------- | ------------------------------------ | --------------------------------------------------------------------------------------------- |
 | `base_url`| `"https://mainnet.helius-rpc.com"`   | Override to point at devnet, staging, or a custom Helius endpoint.                            |
-| `api_key` | `None` → falls back to `HELIUS_API_KEY` in a `.env` file | If neither is provided, the constructor raises `ValueError`.   |
+| `api_key` | `None` → falls back to `HELIUS_API_KEY` from the environment, then `.env` | If none is provided, the constructor raises `ValueError`.   |
 
 Per-method RPC parameters (`commitment`, `encoding`, `min_context_slot`, etc.)
 are left unset by default — the Helius/Solana server defaults apply unless you
@@ -207,7 +225,7 @@ docstring that is the source of truth for that symbol. You can read it
 straight from a REPL:
 
 ```python
-from helius import HeliusClient
+from helius.client import HeliusClient
 help(HeliusClient.get_balance)
 ```
 

{helius_python-0.0.1 → helius_python-0.0.3}/README.md

@@ -44,27 +44,42 @@ type checking.
 pip install helius-python
 ```
 
+This installs the runtime dependencies automatically:
+
+- `httpx` for HTTP transport
+- `pydantic` for typed response models and argument validation
+- `python-dotenv` for optional `.env` loading of `HELIUS_API_KEY`
+
+You do not need to install these separately unless your environment disables
+dependency installation.
+
 ## Authentication
 
 Pass your Helius API key explicitly:
 
 ```python
-from helius import HeliusClient
+from helius.client import HeliusClient
 
 client = HeliusClient(api_key="YOUR_HELIUS_API_KEY")
 ```
 
-or set it in a `.env` file at the project root and let the client pick it up
-automatically:
+or set `HELIUS_API_KEY` as an environment variable:
+
+```bash
+export HELIUS_API_KEY=your_helius_api_key
+```
+
+You can also set it in a `.env` file at the project root and let the client
+pick it up automatically:
 
 ```env
 HELIUS_API_KEY=your_helius_api_key
 ```
 
 ```python
-from helius import HeliusClient
+from helius.client import HeliusClient
 
-client = HeliusClient()  # reads HELIUS_API_KEY from .env
+client = HeliusClient()  # reads HELIUS_API_KEY from the environment or .env
 ```
 
 ## Usage
@@ -72,7 +87,7 @@ client = HeliusClient()  # reads HELIUS_API_KEY from .env
 ### As a context manager (recommended)
 
 ```python
-from helius import HeliusClient
+from helius.client import HeliusClient
 
 with HeliusClient(api_key="YOUR_HELIUS_API_KEY") as client:
     balance = client.get_balance("So11111111111111111111111111111111111111112")
@@ -92,7 +107,7 @@ If a `with` block doesn't fit your code structure (e.g. the client lives on
 a long-lived object), call `close()` yourself when you're done:
 
 ```python
-from helius import HeliusClient
+from helius.client import HeliusClient
 
 client = HeliusClient(api_key="YOUR_HELIUS_API_KEY")
 try:
@@ -116,7 +131,7 @@ instance is garbage-collected. Prefer `with` or `close()` regardless.
 | Argument  | Default                              | Notes                                                                                         |
 | --------- | ------------------------------------ | --------------------------------------------------------------------------------------------- |
 | `base_url`| `"https://mainnet.helius-rpc.com"`   | Override to point at devnet, staging, or a custom Helius endpoint.                            |
-| `api_key` | `None` → falls back to `HELIUS_API_KEY` in a `.env` file | If neither is provided, the constructor raises `ValueError`.   |
+| `api_key` | `None` → falls back to `HELIUS_API_KEY` from the environment, then `.env` | If none is provided, the constructor raises `ValueError`.   |
 
 Per-method RPC parameters (`commitment`, `encoding`, `min_context_slot`, etc.)
 are left unset by default — the Helius/Solana server defaults apply unless you
@@ -190,7 +205,7 @@ docstring that is the source of truth for that symbol. You can read it
 straight from a REPL:
 
 ```python
-from helius import HeliusClient
+from helius.client import HeliusClient
 help(HeliusClient.get_balance)
 ```
 

{helius_python-0.0.1 → helius_python-0.0.3}/pyproject.toml

@@ -10,13 +10,18 @@ build-backend = "hatchling.build"
 
 [project]
 name = "helius-python"
-version = "0.0.1"
+version = "0.0.3"
 authors = [
   { name="Markos Narinian", email="manarinian@gmail.com" },
 ]
 description = "Typed Python client for the Helius API"
 readme = "README.md"
 requires-python = ">=3.9"
+dependencies = [
+  "httpx",
+  "pydantic",
+  "python-dotenv",
+]
 classifiers = [
     "Programming Language :: Python :: 3",
     "Operating System :: OS Independent",

{helius_python-0.0.1 → helius_python-0.0.3}/src/helius/client.py

@@ -1,3 +1,4 @@
+import os
 from typing import Annotated, Any, Literal
 
 import httpx
@@ -38,7 +39,11 @@ class HeliusClient:
         api_key: str | None = None,
     ) -> None:
         self.base_url = base_url
-        self.api_key = api_key or dotenv_values().get("HELIUS_API_KEY")
+        self.api_key = (
+            api_key
+            or os.environ.get("HELIUS_API_KEY")
+            or dotenv_values().get("HELIUS_API_KEY")
+        )
         if not self.api_key:
             raise ValueError("No API key provided.")
         self._client = httpx.Client(