uofast-orm

Simple, fast ORM for U2 Unidata/UniVerse databases via uopy.

Install

pip install uofast-orm

Quick Start

import uopy
from uofast_orm import UopyModel

class Customer(UopyModel):
    _file_name = "CUSTOMERS"
    _field_names = ["NAME", "EMAIL", "PHONE", "ADDRESS"]
    _field_map = {
        "full_name": "NAME",
        "email_address": "EMAIL",
        "phone_number": "PHONE",
        "street_address": "ADDRESS",
    }

with uopy.connect(host="...", user="...", password="...", account="...") as session:
    # Create
    c = Customer(session)
    c.full_name = "Jane Smith"
    c.email_address = "jane@example.com"
    c.create("CUST001")

    # Read
    c = Customer(session, record_id="CUST001")
    print(c.full_name)

    # Update
    c.phone_number = "555-1234"
    c.update()

    # Query
    results = c.select('NAME = "Jane Smith"')

    # Delete
    c.delete()

Models

Subclass UopyModel and set class attributes:

* Can be omitted when _field_map is provided.

Named Fields with Alternative DICT

When multiple data files share a single DICT:

from uofast_orm import SmartFile, patch_uopy_file

# Option A: monkey-patch uopy.File globally (zero call-site changes)
patch_uopy_file()

# Option B: use SmartFile directly
with SmartFile("ORDERS") as f:
    rec = f.read_named_fields("ORD001", ["CUSTNO", "AMOUNT"],
                              dict_file="SHARED_DICT")
    f.write_named_fields("ORD001", {"AMOUNT": 999}, dict_file="SHARED_DICT")

Code Generator

Auto-generate model classes from U2 DICT definitions (requires Ollama):

uofast-generate CUSTOMERS \
  --host 192.168.1.10 --user admin --password secret \
  --account /u2/MYACCOUNT \
  --output customer_model.py

Falls back to template-based generation if Ollama is unavailable.

API Reference

UopyModel

Requirements

• Python 3.8+
• uopy (U2 Unidata/UniVerse client)
• requests (for code generator Ollama calls)

License

MIT