east-py-io
I/O platform functions for the East programming language in Python.
Python equivalent of @elaraai/east-node-io - provides platform functions for S3 object storage and SQLite database operations.
Installation
pip install east-py-io
Quick Start
import asyncio
from east.runtime.compiler import compile_async
from east_py_io import python_io_platform
# Assuming you have East IR from the TypeScript compiler
# compiled_fn = compile_async(ir, python_io_platform)
# await compiled_fn()
Platform Functions
S3 Operations (s3_impl)
6 functions for AWS S3 and S3-compatible object storage (MinIO, Backblaze, etc.):
s3_put_object(config: S3Config, key: String, data: Blob) -> Null- Upload object (async)s3_get_object(config: S3Config, key: String) -> Blob- Download object (async)s3_head_object(config: S3Config, key: String) -> S3ObjectMetadata- Get metadata without downloading (async)s3_delete_object(config: S3Config, key: String) -> Null- Delete object, idempotent (async)s3_list_objects(config: S3Config, prefix: String, maxKeys: Integer) -> S3ListResult- List with pagination (async)s3_presign_url(config: S3Config, key: String, expiresIn: Integer) -> String- Generate presigned URL (async)
S3Config structure:
{
region: String,
bucket: String,
accessKeyId: Option<String>,
secretAccessKey: Option<String>,
endpoint: Option<String> // For S3-compatible services
}
S3ObjectMetadata structure:
{
key: String,
size: Integer,
lastModified: DateTime,
contentType: Option<String>,
etag: Option<String>
}
S3ListResult structure:
{
objects: Array<S3ObjectMetadata>,
isTruncated: Boolean,
continuationToken: Option<String>
}
SQLite Database (sqlite_impl)
4 functions for SQLite database operations with connection pooling:
sqlite_connect(config: SqliteConfig) -> ConnectionHandle- Connect to database, returns handle (async)sqlite_query(handle: ConnectionHandle, sql: String, params: Array<SqlParameter>) -> SqlResult- Execute parameterized query (async)sqlite_close(handle: ConnectionHandle) -> Null- Close connection (async)sqlite_close_all() -> Null- Close all connections, useful for cleanup (async)
SqliteConfig structure:
{
path: String,
readOnly: Option<Boolean>,
memory: Option<Boolean>
}
SqlParameter variant:
String(String) | Integer(Integer) | Float(Float) | Boolean(Boolean) |
Null(Null) | Blob(Blob) | DateTime(DateTime)
SqlResult variant:
select({ rows: Array<Dict<String, SqlParameter>> }) |
insert({ rowsAffected: Integer, lastInsertId: Option<Integer> }) |
update({ rowsAffected: Integer }) |
delete({ rowsAffected: Integer })
Usage
Full Platform (Async)
from east_py_io import python_io_platform
from east.runtime.compiler import compile_async
# Use all I/O platform functions (all are async)
compiled_fn = compile_async(ir, python_io_platform)
await compiled_fn()
Individual Modules
from east_py_io import s3_impl, sqlite_impl
# Use specific platform function groups
platform = [*s3_impl, *sqlite_impl]
compiled_fn = compile_async(ir, platform)
# Or just one module
platform = [*sqlite_impl]
compiled_fn = compile_async(ir, platform)
Type Definitions
from east_py_io import (
S3ConfigType,
S3ObjectMetadataType,
S3ListResultType,
SqliteConfigType,
SqlParameterType,
SqlResultType,
)
# Use type definitions in your platform functions
Development
# First-time setup (installs dependencies)
make install
# Development workflow
make test # Run test suite (17 tests)
make lint # Run linter (ruff)
make lint-fix # Auto-fix linting issues
make typecheck # Type check with mypy
make check # Run all checks (lint + typecheck + test)
# Other useful commands
make coverage # Generate HTML coverage report
make clean # Clean build artifacts
Claude Code plugin
The East ecosystem also ships a Claude Code plugin — East language skills, example search, and preemptive diagnostics for East code — installed separately from the elaraai marketplace:
# Inside Claude Code
/plugin marketplace add elaraai/east-workspace
/plugin install east@elaraai
# From a terminal
claude plugin marketplace add elaraai/east-workspace
claude plugin install east@elaraai
License
BSL 1.1 (Business Source License):
- Non-production use (evaluation, testing, development) is free
- Production use by or on behalf of for-profit entities requires a commercial license
- Code becomes AGPL-3.0 four years after each release
See LICENSE.md for full details.
Commercial licensing: support@elara.ai
Ecosystem
-
East: Statically typed, expression-based language with serializable IR. Run portable logic across TypeScript, Python, C, and other runtimes.
- @elaraai/east: Core language SDK with type system, expressions, and reference JS compiler
-
East Node: Node.js platform functions for I/O, databases, and system operations.
- @elaraai/east-node-std: Console, FileSystem, Fetch, Crypto, Time, Path, Random
- @elaraai/east-node-io: SQLite, PostgreSQL, MySQL, MongoDB, Redis, S3, FTP, SFTP, XLSX, XML, compression
- @elaraai/east-node-cli: CLI for running East IR programs in Node.js
-
East C: C11 native runtime for executing East IR. Distributed via npm (launcher + per-platform optional dependencies) and as tarballs on each GitHub Release.
- @elaraai/east-c-cli: npm launcher — installs the matching native binary as an optional dependency
east-c: Core runtime — type system, IR interpreter, builtins, serialization (Beast2, JSON, CSV, East text)east-c-std: Console, FileSystem, Fetch, Crypto, Time, Path, Randomeast-c-cli: CLI for running East IR programs natively
-
East Python: Python runtime, standard platform, I/O, and data-science platform functions. Published to PyPI.
- east-py: Core Python runtime — type system, IR compiler, 212+ builtins, Cython-accelerated hot paths
- east-py-std: Console, FileSystem, Fetch, Crypto, Time, Path, Random
- east-py-io: SQLite, PostgreSQL, MySQL, MongoDB, Redis, S3, FTP, SFTP, XLSX, XML, compression
- east-py-cli: CLI for running East IR programs in Python
- east-py-datascience (PyPI) + @elaraai/east-py-datascience (npm): Optimization (MADS, Optuna, ALNS, GoogleOR), ML (XGBoost, LightGBM, NGBoost, PyTorch, Lightning, GP), Bayesian inference (PyMC), explainability (SHAP), conformal prediction (MAPIE)
-
East UI: Typed UI component definitions and React renderer, plus VS Code preview.
- @elaraai/east-ui: 50+ typed UI components for layouts, forms, charts, tables, dialogs
- @elaraai/east-ui-components: React renderer with Chakra UI v3 styling
- @elaraai/e3-ui: e3 + UI bridge — Data bindings,
e3.ui()task, manifest - @elaraai/e3-ui-components: React Query hooks and preview components for the e3 API
- east-ui-preview: VS Code extension for live East UI component preview
-
e3 — East Execution Engine: Durable execution engine for running East pipelines at scale. Git-like content-addressable storage, automatic memoization, reactive dataflow, real-time monitoring.
- @elaraai/e3: SDK for authoring e3 packages with typed tasks and pipelines
- @elaraai/e3-core: Object store, dataflow orchestrator, execution state
- @elaraai/e3-types: Shared type definitions for e3 packages
- @elaraai/e3-cli:
e3 repo,e3 package,e3 workspace,e3 dataflow run,e3 watch,e3 task logscommands - @elaraai/e3-api-client: HTTP client for remote e3 repositories
- @elaraai/e3-api-server: REST API server for e3 repositories
- @elaraai/e3-api-tests: Shared API compliance test suites
Links
- Website: https://elaraai.com/
- East Repository: https://github.com/elaraai/east-workspace/tree/main/libs/east
- Issues: https://github.com/elaraai/east-workspace/issues
- Email: support@elara.ai
About Elara
East is developed by Elara AI Pty Ltd, an AI-powered platform that creates economic digital twins of businesses that optimize performance. Elara combines business objectives, decisions and data to help organizations make data-driven decisions across operations, purchasing, sales and customer engagement, and project and investment planning. East powers the computational layer of Elara solutions, enabling the expression of complex business logic and data in a simple, type-safe and portable language.
Developed by Elara AI Pty Ltd.
Developed by Elara AI Pty Ltd
1 maintainer
Metadata
1 maintainer
Release files for elaraai-east-py-io 1.0.94
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| elaraai_east_py_io-1.0.94.tar.gz | 49.8 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| elaraai_east_py_io-1.0.94-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 119.1 kB
Release files / elaraai_east_py_io-1.0.94.tar.gz
| Download URL | elaraai_east_py_io-1.0.94.tar.gz |
|---|---|
| Size | 49.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dad8f35847fcaff7bbaae2583d627157e45653569d69c6bdbcffb68bfa7ae9f7
|
|
BLAKE2b-256 checksum How to use checksums |
3f099e962bd538d809c026d621a74e2cbf1c0c7d83ff8eedffa34a999847d955
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / elaraai_east_py_io-1.0.94-py3-none-any.whl
| Download URL | elaraai_east_py_io-1.0.94-py3-none-any.whl |
|---|---|
| Size | 69.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c42f48984f246ac6b59f9cc32d45e64f6b82cc191b500927ca37c0bb753ba695
|
|
BLAKE2b-256 checksum How to use checksums |
20bda8e94d5d030375817b93f43bb4e3b856b7044c1938067df3e5598585964e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Security for elaraai-east-py-io 1.0.94
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
