an5-orm 1.0.6__py3-none-any.whl

an5_orm-1.0.6.dist-info/METADATA

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: an5-orm
+Version: 1.0.6
+Summary: Lightweight ORM for SQL Server with Python support.
+Author: an5ORM
+License: MIT
+Keywords: an5,orm,sqlserver
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: an5-adapters>=0.2.0
+
+# @an5/orm
+
+SQL Server ORM. Proxy client. CRUD. Vector search. Middleware. Raw queries. Transactions.
+
+## Features
+
+-   **Proxy Client.** Model access. `db.modelName` syntax.
+-   **CRUD.** `findMany`, `findFirst`, `findUnique`, `create`, `update`, `delete`, `upsert`.
+-   **Advanced Queries.** OR/AND, nested relations, aggregates, `groupBy`.
+-   **Vector Search.** Native SQL Server `VECTOR_DISTANCE`. In-memory fallback.
+-   **Middleware.** Hook ORM operations: logging, auth, validation.
+-   **Raw Queries.** `$queryRaw`, `$executeRaw`. Auto `NOLOCK`.
+-   **Transactions.** `$transaction`. Rollback support.
+-   **Schema Generator.** Parse `.an5` files. Generate TypeScript/Python/.NET code.
+
+## Quick Start
+
+### Installation
+
+```bash
+npm install @an5/orm
+```
+
+### Configuration
+
+```bash
+cp .env.example .env
+# Edit .env. Set DATABASE_URL.
+```
+
+### Development Commands
+
+```bash
+# Generate code from schema
+npx an5 generate
+
+# Push schema to database
+npx an5 db:push
+
+# Pull schema from database
+npx an5 db:pull
+
+# Seed database
+npx an5 db:seed
+
+# Compare schema with database
+npx an5 db:migrate diff
+
+# Run tests
+npm test
+```
+
+## Usage
+
+```typescript
+import { An5ORM } from '@an5/orm';
+
+const db = new An5ORM();
+
+// CRUD Operations
+const users = await db.user.findMany({
+  where: { email: { contains: '@example.com' } },
+  orderBy: { createdAt: 'desc' },
+  take: 10,
+});
+
+const user = await db.user.create({
+  data: { email: 'john@example.com', name: 'John' },
+});
+
+// Relations
+const orders = await db.user.findMany({
+  include: { orders: true },
+});
+
+// Vector Search
+const similar = await db.document.vectorSearch({
+  vector: [0.1, 0.2, 0.3],
+  take: 5,
+  distanceMetric: 'cosine',
+});
+
+// Transactions
+await db.$transaction(async (tx) => {
+  const user = await tx.user.create({ data: { email: 'jane@example.com' } });
+  await tx.order.create({ data: { userId: user.id, total: 100 } });
+});
+
+// Raw Queries
+const results = await db.$queryRaw`SELECT * FROM users WHERE id = ${id}`;
+```
+
+## Schema Definition
+
+Schema files: `.an5`. Path: `an5Schema/`. SQL Server types.
+
+```an5
+model User {
+  id        NVARCHAR(1000) @id @default(uuid())
+  email     NVARCHAR(255)  @unique
+  name      NVARCHAR(255)?
+  createdAt DATETIME2      @default(now())
+  orders    Order[]
+
+  @@map("users")
+}
+
+model Order {
+  id        NVARCHAR(1000) @id @default(uuid())
+  userId    NVARCHAR(1000)
+  total     INT            @default(0)
+  user      User           @relation(fields: [userId], references: [id])
+
+  @@map("orders")
+}
+```
+
+## Supported SQL Server Types
+
+Type mapping: `.an5` to TypeScript.
+
+| Schema Type | TypeScript |
+|-------------|------------|
+| `NVARCHAR(n)`, `VARCHAR(n)`, `CHAR(n)`, `TEXT` | `string` |
+| `INT`, `SMALLINT`, `TINYINT`, `FLOAT`, `REAL`, `DECIMAL`, `NUMERIC` | `number` |
+| `BIGINT` | `number \| bigint` |
+| `BIT` | `boolean` |
+| `DATETIME`, `DATETIME2`, `DATE`, `TIME` | `Date` |
+| `UNIQUEIDENTIFIER` | `string` |
+| `VARBINARY`, `BINARY`, `IMAGE` | `Buffer` |
+
+## Testing
+
+```bash
+# Unit tests
+node test/unit.test.js
+
+# Generator tests
+node test/generator.test.js
+
+# Smoke test
+npm test
+```
+
+## License
+
+MIT

an5_orm-1.0.6.dist-info/RECORD

@@ -0,0 +1,5 @@
+an5_orm.py,sha256=KDUYSQ5d2INkpi8zNmKQbg6EZ676tTmmDEvUPsCSvMI,841
+an5_orm-1.0.6.dist-info/METADATA,sha256=gBjstZ9p5Vv9S7ljeAgqsy88gnMKZvdnZocOs7LN7yg,3651
+an5_orm-1.0.6.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+an5_orm-1.0.6.dist-info/top_level.txt,sha256=IroQMc2qhf8XQUT53laenhLVLoSJOj96G3CPScjBLWQ,8
+an5_orm-1.0.6.dist-info/RECORD,,

an5_orm-1.0.6.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

an5_orm-1.0.6.dist-info/top_level.txt

@@ -0,0 +1 @@
+an5_orm

an5_orm.py

@@ -0,0 +1,24 @@
+"""
+AN5 ORM Python Entrypoint
+"""
+import os
+import sys
+
+# Ensure local monorepo adapter path is available for source execution & IDE linting
+_local_adapters_dir = os.path.abspath(
+    os.path.join(os.path.dirname(__file__), "..", "..", "an5Adapters", "python")
+)
+if os.path.exists(_local_adapters_dir) and _local_adapters_dir not in sys.path:
+    sys.path.insert(0, _local_adapters_dir)
+
+try:
+    from an5_adapter import An5Adapter, create_an5_adapter, AdapterTableClient
+except ImportError:  # pragma: no cover
+    try:
+        from .an5_adapter import An5Adapter, create_an5_adapter, AdapterTableClient
+    except ImportError:
+        An5Adapter = None  # type: ignore
+        create_an5_adapter = None  # type: ignore
+        AdapterTableClient = None  # type: ignore
+
+__all__ = ["An5Adapter", "create_an5_adapter", "AdapterTableClient"]