@an5/orm 1.0.8 → 1.0.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +167 -175
- package/dist/an5Metadata.js +64 -0
- package/dist/an5Orm.d.ts +92 -3
- package/dist/an5Orm.js +697 -206
- package/dist/errors.d.ts +1 -1
- package/dist/errors.js +1 -1
- package/dist/generator/src/code-generator.d.ts +14 -13
- package/dist/generator/src/code-generator.js +249 -225
- package/dist/generator/src/dotnet-generator.d.ts +13 -11
- package/dist/generator/src/dotnet-generator.js +872 -546
- package/dist/generator/src/index.d.ts +1 -1
- package/dist/generator/src/index.js +104 -88
- package/dist/generator/src/metadata-generator.d.ts +11 -8
- package/dist/generator/src/metadata-generator.js +104 -90
- package/dist/generator/src/parser.d.ts +11 -11
- package/dist/generator/src/parser.js +206 -206
- package/dist/generator/src/python-generator.d.ts +19 -9
- package/dist/generator/src/python-generator.js +345 -105
- package/dist/generator/src/types.d.ts +27 -27
- package/dist/generator/src/types.js +2 -2
- package/dist/index.d.ts +3 -2
- package/dist/index.js +19 -8
- package/dist/logger.js +1 -1
- package/dist/migration-core.d.ts +87 -0
- package/dist/migration-core.js +692 -0
- package/dist/scripts/release-cli.d.ts +2 -2
- package/dist/scripts/release-cli.js +115 -115
- package/dist/sql-utils.d.ts +3 -1
- package/dist/sql-utils.js +94 -24
- package/generator/src/code-generator.ts +259 -230
- package/generator/src/dotnet-generator.ts +882 -544
- package/generator/src/golang-generator.ts +1242 -0
- package/generator/src/index.ts +111 -116
- package/generator/src/metadata-generator.ts +116 -101
- package/generator/src/parser.ts +202 -202
- package/generator/src/python-generator.ts +424 -114
- package/generator/src/types.ts +29 -29
- package/package.json +12 -6
|
@@ -1,114 +1,424 @@
|
|
|
1
|
-
import fs from 'fs';
|
|
2
|
-
import path from 'path';
|
|
3
|
-
import { Model } from './types';
|
|
4
|
-
|
|
5
|
-
export class PythonGenerator {
|
|
6
|
-
constructor(private outputPath: string) {}
|
|
7
|
-
|
|
8
|
-
public generate(models: Model[]) {
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
}
|
|
1
|
+
import fs from 'fs';
|
|
2
|
+
import path from 'path';
|
|
3
|
+
import { Model } from './types';
|
|
4
|
+
|
|
5
|
+
export class PythonGenerator {
|
|
6
|
+
constructor(private outputPath: string) {}
|
|
7
|
+
|
|
8
|
+
public generate(models: Model[]) {
|
|
9
|
+
const outputDir = path.dirname(this.outputPath);
|
|
10
|
+
if (!fs.existsSync(outputDir)) {
|
|
11
|
+
fs.mkdirSync(outputDir, { recursive: true });
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
// 1. Generate an5_metadata.py
|
|
15
|
+
this.generateMetadata(models);
|
|
16
|
+
|
|
17
|
+
// 2. Generate an5_models.py
|
|
18
|
+
this.generateModels(models, outputDir);
|
|
19
|
+
|
|
20
|
+
// 3. Generate an5_orm_types.py - type-safe ORM filter/args dataclasses
|
|
21
|
+
this.generateOrmTypes(models, outputDir);
|
|
22
|
+
|
|
23
|
+
// 4. Generate an5_client.py
|
|
24
|
+
this.generateClient(models, outputDir);
|
|
25
|
+
|
|
26
|
+
// 5. Generate __init__.py
|
|
27
|
+
this.generateInit(models, outputDir);
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
private getPyFilterType(fieldType: string): string {
|
|
31
|
+
const lower = fieldType.toLowerCase();
|
|
32
|
+
if (['datetime', 'datetime2', 'date', 'smalldatetime', 'datetimeoffset', 'timestamp'].includes(lower)) return 'DateTimeFilter';
|
|
33
|
+
if (['bool', 'boolean', 'bit'].includes(lower)) return 'BoolFilter';
|
|
34
|
+
if (['int', 'integer', 'smallint', 'tinyint', 'bigint', 'number'].includes(lower)) return 'IntFilter';
|
|
35
|
+
if (['float', 'real', 'double', 'decimal', 'numeric', 'money'].includes(lower)) return 'NumberFilter';
|
|
36
|
+
return 'StringFilter';
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
private generateOrmTypes(models: Model[], outputDir: string) {
|
|
40
|
+
let content = '# This file is auto-generated. Do not edit directly.\n';
|
|
41
|
+
content += '"""\nAN5 ORM typed filter/args dataclasses for type-safe queries.\n\nUsage example::\n\n db.user.find_many(where=UserWhereInput(name=StringFilter(contains="John")),\n order_by=UserOrderByInput(created_at="desc"),\n take=10)\n"""\n';
|
|
42
|
+
content += 'from __future__ import annotations\n';
|
|
43
|
+
content += 'from dataclasses import dataclass, field\n';
|
|
44
|
+
content += 'from typing import List, Optional, Any\n';
|
|
45
|
+
content += 'from datetime import datetime\n\n';
|
|
46
|
+
|
|
47
|
+
// Base filter types
|
|
48
|
+
content += '# ─── Base filter types ────────────────────────────────────────────────────────\n\n';
|
|
49
|
+
content += `@dataclass\nclass StringFilter:\n """Type-safe filter for string fields."""\n equals: Optional[str] = None\n not_: Optional[str] = None\n contains: Optional[str] = None\n starts_with: Optional[str] = None\n ends_with: Optional[str] = None\n in_: Optional[List[str]] = None\n not_in: Optional[List[str]] = None\n gt: Optional[str] = None\n gte: Optional[str] = None\n lt: Optional[str] = None\n lte: Optional[str] = None\n\n`;
|
|
50
|
+
|
|
51
|
+
content += `@dataclass\nclass IntFilter:\n """Type-safe filter for integer fields."""\n equals: Optional[int] = None\n not_: Optional[int] = None\n in_: Optional[List[int]] = None\n not_in: Optional[List[int]] = None\n gt: Optional[int] = None\n gte: Optional[int] = None\n lt: Optional[int] = None\n lte: Optional[int] = None\n\n`;
|
|
52
|
+
|
|
53
|
+
content += `@dataclass\nclass NumberFilter:\n """Type-safe filter for float/decimal fields."""\n equals: Optional[float] = None\n not_: Optional[float] = None\n in_: Optional[List[float]] = None\n not_in: Optional[List[float]] = None\n gt: Optional[float] = None\n gte: Optional[float] = None\n lt: Optional[float] = None\n lte: Optional[float] = None\n\n`;
|
|
54
|
+
|
|
55
|
+
content += `@dataclass\nclass BoolFilter:\n """Type-safe filter for boolean fields."""\n equals: Optional[bool] = None\n\n`;
|
|
56
|
+
|
|
57
|
+
content += `@dataclass\nclass DateTimeFilter:\n """Type-safe filter for datetime fields."""\n equals: Optional[datetime] = None\n not_: Optional[datetime] = None\n in_: Optional[List[datetime]] = None\n not_in: Optional[List[datetime]] = None\n gt: Optional[datetime] = None\n gte: Optional[datetime] = None\n lt: Optional[datetime] = None\n lte: Optional[datetime] = None\n\n`;
|
|
58
|
+
|
|
59
|
+
// Per-model types
|
|
60
|
+
for (const model of models) {
|
|
61
|
+
const name = this.capitalize(model.name);
|
|
62
|
+
content += `# ─── ${name} ORM Types ────────────────────────────────────────────────────────\n\n`;
|
|
63
|
+
|
|
64
|
+
// WhereInput
|
|
65
|
+
content += `@dataclass\nclass ${name}WhereInput:\n """Type-safe WHERE filter for ${name} queries."""\n`;
|
|
66
|
+
content += ` AND: Optional[List['${name}WhereInput']] = None\n`;
|
|
67
|
+
content += ` OR: Optional[List['${name}WhereInput']] = None\n`;
|
|
68
|
+
content += ` NOT: Optional['${name}WhereInput'] = None\n`;
|
|
69
|
+
for (const f of model.fields) {
|
|
70
|
+
const ft = this.getPyFilterType(f.type);
|
|
71
|
+
content += ` ${this.toSnakeCase(f.name)}: Optional[${ft}] = None\n`;
|
|
72
|
+
}
|
|
73
|
+
content += '\n';
|
|
74
|
+
|
|
75
|
+
// OrderByInput
|
|
76
|
+
content += `@dataclass\nclass ${name}OrderByInput:\n """Type-safe ORDER BY for ${name} queries. Value: 'asc' or 'desc'."""\n`;
|
|
77
|
+
for (const f of model.fields) {
|
|
78
|
+
content += ` ${this.toSnakeCase(f.name)}: Optional[str] = None\n`;
|
|
79
|
+
}
|
|
80
|
+
content += '\n';
|
|
81
|
+
|
|
82
|
+
// CreateInput
|
|
83
|
+
const requiredFields = model.fields.filter(f => !f.isId && !f.isOptional && !f.hasDefault);
|
|
84
|
+
const optionalFields = model.fields.filter(f => !f.isId && (f.isOptional || f.hasDefault));
|
|
85
|
+
content += `@dataclass\nclass ${name}CreateInput:\n """Typed data for creating a new ${name} record."""\n`;
|
|
86
|
+
for (const f of requiredFields) {
|
|
87
|
+
content += ` ${this.toSnakeCase(f.name)}: ${this.mapPyType(f.type)}\n`;
|
|
88
|
+
}
|
|
89
|
+
for (const f of optionalFields) {
|
|
90
|
+
content += ` ${this.toSnakeCase(f.name)}: Optional[${this.mapPyType(f.type)}] = None\n`;
|
|
91
|
+
}
|
|
92
|
+
if (requiredFields.length === 0 && optionalFields.length === 0) content += ' pass\n';
|
|
93
|
+
content += '\n';
|
|
94
|
+
|
|
95
|
+
// UpdateInput
|
|
96
|
+
const updateFields = model.fields.filter(f => !f.isId);
|
|
97
|
+
content += `@dataclass\nclass ${name}UpdateInput:\n """Typed data for updating an existing ${name} record."""\n`;
|
|
98
|
+
for (const f of updateFields) {
|
|
99
|
+
content += ` ${this.toSnakeCase(f.name)}: Optional[${this.mapPyType(f.type)}] = None\n`;
|
|
100
|
+
}
|
|
101
|
+
if (updateFields.length === 0) content += ' pass\n';
|
|
102
|
+
content += '\n';
|
|
103
|
+
|
|
104
|
+
// FindManyArgs
|
|
105
|
+
content += `@dataclass\nclass ${name}FindManyArgs:\n """ORM-style args for ${name}.find_many()."""\n`;
|
|
106
|
+
content += ` where: Optional[${name}WhereInput] = None\n`;
|
|
107
|
+
content += ` order_by: Optional[${name}OrderByInput] = None\n`;
|
|
108
|
+
content += ` take: Optional[int] = None\n`;
|
|
109
|
+
content += ` skip: int = 0\n`;
|
|
110
|
+
content += ` select: Optional[List[str]] = None\n\n`;
|
|
111
|
+
|
|
112
|
+
// FindFirstArgs
|
|
113
|
+
content += `@dataclass\nclass ${name}FindFirstArgs:\n """ORM-style args for ${name}.find_first()."""\n`;
|
|
114
|
+
content += ` where: Optional[${name}WhereInput] = None\n`;
|
|
115
|
+
content += ` order_by: Optional[${name}OrderByInput] = None\n`;
|
|
116
|
+
content += ` select: Optional[List[str]] = None\n\n`;
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
fs.writeFileSync(path.join(outputDir, 'an5_orm_types.py'), content);
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
private generateMetadata(models: Model[]) {
|
|
123
|
+
let pyContent = '# This file is auto-generated. Do not edit directly.\n\n';
|
|
124
|
+
|
|
125
|
+
// 1. MODEL_TO_TABLE
|
|
126
|
+
pyContent += 'MODEL_TO_TABLE = {\n';
|
|
127
|
+
for (const model of models) {
|
|
128
|
+
const props = this.getAllPropertyVariations(model.name);
|
|
129
|
+
const fullTableName = `[${model.schemaName}].[${model.tableName}]`;
|
|
130
|
+
for (const prop of props) {
|
|
131
|
+
pyContent += ` "${prop}": "${fullTableName}",\n`;
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
pyContent += '}\n\n';
|
|
135
|
+
|
|
136
|
+
// 2. MODEL_DESCRIPTIONS
|
|
137
|
+
pyContent += 'MODEL_DESCRIPTIONS = {\n';
|
|
138
|
+
for (const model of models) {
|
|
139
|
+
const props = this.getAllPropertyVariations(model.name);
|
|
140
|
+
for (const prop of props) {
|
|
141
|
+
pyContent += ` "${prop}": ${this.pyString(model.description)},\n`;
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
pyContent += '}\n\n';
|
|
145
|
+
|
|
146
|
+
// 3. MODEL_FIELDS
|
|
147
|
+
pyContent += 'MODEL_FIELDS = {\n';
|
|
148
|
+
for (const model of models) {
|
|
149
|
+
const props = this.getAllPropertyVariations(model.name);
|
|
150
|
+
const fieldsStr = this.formatFields(model);
|
|
151
|
+
for (const prop of props) {
|
|
152
|
+
pyContent += ` "${prop}": ${fieldsStr},\n`;
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
pyContent += '}\n\n';
|
|
156
|
+
|
|
157
|
+
// 4. RELATION_MAP
|
|
158
|
+
pyContent += 'RELATION_MAP = {\n';
|
|
159
|
+
for (const model of models) {
|
|
160
|
+
const props = this.getAllPropertyVariations(model.name);
|
|
161
|
+
let relationsContent = `{\n`;
|
|
162
|
+
for (const rel of model.relations) {
|
|
163
|
+
relationsContent += ` "${rel.name}": {\n`;
|
|
164
|
+
relationsContent += ` "modelName": "${this.toCamelCase(rel.type)}",\n`;
|
|
165
|
+
relationsContent += ` "relationType": "${rel.isArray ? 'many' : 'one'}",\n`;
|
|
166
|
+
relationsContent += ` "foreignKey": "${rel.foreignKey || 'id'}",\n`;
|
|
167
|
+
relationsContent += ` "localKey": "${rel.localKey || 'id'}"\n`;
|
|
168
|
+
relationsContent += ` },\n`;
|
|
169
|
+
}
|
|
170
|
+
relationsContent += ` }`;
|
|
171
|
+
|
|
172
|
+
for (const prop of props) {
|
|
173
|
+
pyContent += ` "${prop}": ${relationsContent},\n`;
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
pyContent += '}\n';
|
|
177
|
+
|
|
178
|
+
fs.writeFileSync(this.outputPath, pyContent);
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
private mapPyType(fieldType: string): string {
|
|
182
|
+
const lower = fieldType.toLowerCase();
|
|
183
|
+
if (['int', 'integer', 'smallint', 'tinyint', 'bigint', 'number'].includes(lower)) {
|
|
184
|
+
return 'int';
|
|
185
|
+
}
|
|
186
|
+
if (['float', 'real', 'double', 'decimal', 'numeric', 'money'].includes(lower)) {
|
|
187
|
+
return 'float';
|
|
188
|
+
}
|
|
189
|
+
if (['bool', 'boolean', 'bit'].includes(lower)) {
|
|
190
|
+
return 'bool';
|
|
191
|
+
}
|
|
192
|
+
if (['datetime', 'datetime2', 'date', 'smalldatetime', 'datetimeoffset', 'timestamp'].includes(lower)) {
|
|
193
|
+
return 'datetime';
|
|
194
|
+
}
|
|
195
|
+
if (['bytes', 'binary', 'varbinary'].includes(lower)) {
|
|
196
|
+
return 'bytes';
|
|
197
|
+
}
|
|
198
|
+
return 'str';
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
private generateModels(models: Model[], outputDir: string) {
|
|
202
|
+
let content = '# This file is auto-generated. Do not edit directly.\n';
|
|
203
|
+
content += 'from dataclasses import dataclass, field\n';
|
|
204
|
+
content += 'from typing import Optional, List, Any, TypedDict\n';
|
|
205
|
+
content += 'from datetime import datetime\n\n';
|
|
206
|
+
|
|
207
|
+
for (const model of models) {
|
|
208
|
+
if (model.description) {
|
|
209
|
+
content += `"""${model.description}"""\n`;
|
|
210
|
+
}
|
|
211
|
+
content += `@dataclass\nclass ${model.name}:\n`;
|
|
212
|
+
|
|
213
|
+
if (model.fields.length === 0 && model.relations.length === 0) {
|
|
214
|
+
content += ' pass\n\n';
|
|
215
|
+
continue;
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
// Required fields first
|
|
219
|
+
const required = model.fields.filter(f => !f.isOptional && !f.hasDefault);
|
|
220
|
+
const optionals = model.fields.filter(f => f.isOptional || f.hasDefault);
|
|
221
|
+
|
|
222
|
+
for (const f of required) {
|
|
223
|
+
const pyType = this.mapPyType(f.type);
|
|
224
|
+
const snakeName = this.toSnakeCase(f.name);
|
|
225
|
+
content += ` ${snakeName}: ${pyType}\n`;
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
for (const f of optionals) {
|
|
229
|
+
const pyType = this.mapPyType(f.type);
|
|
230
|
+
const snakeName = this.toSnakeCase(f.name);
|
|
231
|
+
content += ` ${snakeName}: Optional[${pyType}] = None\n`;
|
|
232
|
+
}
|
|
233
|
+
|
|
234
|
+
// Relations
|
|
235
|
+
for (const rel of model.relations) {
|
|
236
|
+
const relName = this.toSnakeCase(rel.name);
|
|
237
|
+
if (rel.isArray) {
|
|
238
|
+
content += ` ${relName}: List[Any] = field(default_factory=list)\n`;
|
|
239
|
+
} else {
|
|
240
|
+
content += ` ${relName}: Optional[Any] = None\n`;
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
content += '\n';
|
|
245
|
+
|
|
246
|
+
// TypedDict row shape: mirrors what the runtime actually returns
|
|
247
|
+
// (plain dicts), so `AdapterTableClient["<Model>Row"]` delegates
|
|
248
|
+
// type-check. Required keys stay required via a total=True base;
|
|
249
|
+
// everything else is optional (total=False), keeping partial
|
|
250
|
+
// selects valid without extra dependencies.
|
|
251
|
+
const rowRequired = model.fields.filter(f => !f.isOptional && !f.hasDefault);
|
|
252
|
+
const rowOptional = model.fields.filter(f => f.isOptional || f.hasDefault);
|
|
253
|
+
content += `class _${model.name}Required(TypedDict):\n`;
|
|
254
|
+
content += ` """Required keys of a ${model.name} row."""\n`;
|
|
255
|
+
if (rowRequired.length === 0) {
|
|
256
|
+
content += ' pass\n';
|
|
257
|
+
}
|
|
258
|
+
for (const f of rowRequired) {
|
|
259
|
+
content += ` ${this.toSnakeCase(f.name)}: ${this.mapPyType(f.type)}\n`;
|
|
260
|
+
}
|
|
261
|
+
content += `\nclass ${model.name}Row(_${model.name}Required, total=False):\n`;
|
|
262
|
+
content += ` """Row shape returned for ${model.name} queries."""\n`;
|
|
263
|
+
if (rowOptional.length === 0 && model.relations.length === 0) {
|
|
264
|
+
content += ' pass\n';
|
|
265
|
+
}
|
|
266
|
+
for (const f of rowOptional) {
|
|
267
|
+
content += ` ${this.toSnakeCase(f.name)}: ${this.mapPyType(f.type)}\n`;
|
|
268
|
+
}
|
|
269
|
+
for (const rel of model.relations) {
|
|
270
|
+
const relName = this.toSnakeCase(rel.name);
|
|
271
|
+
content += rel.isArray ? ` ${relName}: List[Any]\n` : ` ${relName}: Any\n`;
|
|
272
|
+
}
|
|
273
|
+
content += '\n';
|
|
274
|
+
}
|
|
275
|
+
|
|
276
|
+
fs.writeFileSync(path.join(outputDir, 'an5_models.py'), content);
|
|
277
|
+
}
|
|
278
|
+
|
|
279
|
+
private generateClient(models: Model[], outputDir: string) {
|
|
280
|
+
let content = '# This file is auto-generated. Do not edit directly.\n';
|
|
281
|
+
content += 'import os\n';
|
|
282
|
+
content += 'from typing import Dict, List, Optional, Any, Callable, TYPE_CHECKING\n\n';
|
|
283
|
+
|
|
284
|
+
content += 'try:\n';
|
|
285
|
+
content += ' from an5_adapter import An5Adapter, AdapterTableClient, create_an5_adapter, set_adapter_metadata\n';
|
|
286
|
+
content += 'except ImportError:\n';
|
|
287
|
+
content += ' from .an5_adapter import An5Adapter, AdapterTableClient, create_an5_adapter, set_adapter_metadata\n\n';
|
|
288
|
+
|
|
289
|
+
content += 'try:\n';
|
|
290
|
+
content += ' from .an5_metadata import MODEL_TO_TABLE, MODEL_FIELDS\n';
|
|
291
|
+
content += 'except ImportError:\n';
|
|
292
|
+
content += ' from an5_metadata import MODEL_TO_TABLE, MODEL_FIELDS\n\n';
|
|
293
|
+
|
|
294
|
+
if (models.length > 0) {
|
|
295
|
+
const rowTypes = models.map(m => `${m.name}Row`).join(', ');
|
|
296
|
+
content += 'if TYPE_CHECKING:\n';
|
|
297
|
+
content += ' try:\n';
|
|
298
|
+
content += ` from an5_models import ${rowTypes}\n`;
|
|
299
|
+
content += ' except ImportError:\n';
|
|
300
|
+
content += ` from .an5_models import ${rowTypes}\n\n`;
|
|
301
|
+
}
|
|
302
|
+
|
|
303
|
+
content += 'class An5Client:\n';
|
|
304
|
+
content += ' """AN5 Python ORM Client - type-safe database access.\n\n';
|
|
305
|
+
content += ' Usage:\n';
|
|
306
|
+
content += ' db = An5Client()\n';
|
|
307
|
+
content += ' users = db.user.find_many(where={"name": {"contains": "John"}}, order_by={"created_at": "asc"}, take=10)\n';
|
|
308
|
+
content += ' user = db.user.find_first(where={"id": "abc"})\n';
|
|
309
|
+
content += ' new = db.user.create(data={"name": "Alice", "email": "alice@example.com"})\n';
|
|
310
|
+
content += ' """\n';
|
|
311
|
+
content += ' def __init__(self, connection_string: Optional[str] = None):\n';
|
|
312
|
+
content += ' conn_str = (connection_string or \n';
|
|
313
|
+
content += ' os.getenv("DATABASE_URL") or \n';
|
|
314
|
+
content += ' "Server=localhost;Database=master;Trusted_Connection=True;TrustServerCertificate=True;")\n';
|
|
315
|
+
content += ' set_adapter_metadata({"model_to_table": MODEL_TO_TABLE, "model_fields": MODEL_FIELDS})\n';
|
|
316
|
+
content += ' self.adapter: An5Adapter = create_an5_adapter(conn_str)\n\n';
|
|
317
|
+
|
|
318
|
+
for (const model of models) {
|
|
319
|
+
const propName = this.toSnakeCase(model.name) + 's';
|
|
320
|
+
const singleName = this.toSnakeCase(model.name);
|
|
321
|
+
content += ` client = AdapterTableClient(self.adapter, "${model.name}")\n`;
|
|
322
|
+
content += ` self.${model.name}: AdapterTableClient["${model.name}Row"] = client\n`;
|
|
323
|
+
content += ` self.${model.name}s: AdapterTableClient["${model.name}Row"] = client\n`;
|
|
324
|
+
content += ` self.${singleName}: AdapterTableClient["${model.name}Row"] = client\n`;
|
|
325
|
+
content += ` self.${propName}: AdapterTableClient["${model.name}Row"] = client\n`;
|
|
326
|
+
}
|
|
327
|
+
|
|
328
|
+
content += '\n';
|
|
329
|
+
content += ' def __getattr__(self, name: str) -> AdapterTableClient[Any]:\n';
|
|
330
|
+
content += ' return self.adapter.table(name)\n\n';
|
|
331
|
+
content += ' def query_raw(self, sql: str, *params) -> List[Dict]:\n';
|
|
332
|
+
content += ' return self.adapter.query_raw(sql, *params)\n\n';
|
|
333
|
+
content += ' def execute_raw(self, sql: str, *params) -> int:\n';
|
|
334
|
+
content += ' return self.adapter.execute_raw(sql, *params)\n\n';
|
|
335
|
+
content += ' def transaction(self, fn: Callable) -> Any:\n';
|
|
336
|
+
content += ' return self.adapter.transaction(fn)\n';
|
|
337
|
+
|
|
338
|
+
fs.writeFileSync(path.join(outputDir, 'an5_client.py'), content);
|
|
339
|
+
}
|
|
340
|
+
|
|
341
|
+
private generateInit(models: Model[], outputDir: string) {
|
|
342
|
+
let content = '# This file is auto-generated. Do not edit directly.\n';
|
|
343
|
+
content += 'from .an5_metadata import MODEL_TO_TABLE, MODEL_DESCRIPTIONS, MODEL_FIELDS, RELATION_MAP\n';
|
|
344
|
+
content += 'from .an5_models import *\n';
|
|
345
|
+
content += 'from .an5_orm_types import (\n';
|
|
346
|
+
content += ' StringFilter, IntFilter, NumberFilter, BoolFilter, DateTimeFilter,\n';
|
|
347
|
+
for (const m of models) {
|
|
348
|
+
const name = this.capitalize(m.name);
|
|
349
|
+
content += ` ${name}WhereInput, ${name}OrderByInput,\n`;
|
|
350
|
+
content += ` ${name}CreateInput, ${name}UpdateInput,\n`;
|
|
351
|
+
content += ` ${name}FindManyArgs, ${name}FindFirstArgs,\n`;
|
|
352
|
+
}
|
|
353
|
+
content += ')\n';
|
|
354
|
+
content += 'from .an5_client import An5Client\n\n';
|
|
355
|
+
content += '__all__ = [\n';
|
|
356
|
+
content += ' "MODEL_TO_TABLE",\n';
|
|
357
|
+
content += ' "MODEL_DESCRIPTIONS",\n';
|
|
358
|
+
content += ' "MODEL_FIELDS",\n';
|
|
359
|
+
content += ' "RELATION_MAP",\n';
|
|
360
|
+
content += ' "An5Client",\n';
|
|
361
|
+
content += ' "StringFilter", "IntFilter", "NumberFilter", "BoolFilter", "DateTimeFilter",\n';
|
|
362
|
+
|
|
363
|
+
for (const m of models) {
|
|
364
|
+
const name = this.capitalize(m.name);
|
|
365
|
+
content += ` "${m.name}",\n`;
|
|
366
|
+
content += ` "${name}WhereInput", "${name}OrderByInput",\n`;
|
|
367
|
+
content += ` "${name}CreateInput", "${name}UpdateInput",\n`;
|
|
368
|
+
content += ` "${name}FindManyArgs", "${name}FindFirstArgs",\n`;
|
|
369
|
+
}
|
|
370
|
+
content += ']\n';
|
|
371
|
+
|
|
372
|
+
fs.writeFileSync(path.join(outputDir, '__init__.py'), content);
|
|
373
|
+
}
|
|
374
|
+
|
|
375
|
+
private getAllPropertyVariations(modelName: string): string[] {
|
|
376
|
+
const variations = new Set<string>();
|
|
377
|
+
|
|
378
|
+
variations.add(this.toCamelCase(modelName));
|
|
379
|
+
variations.add(this.toSnakeCase(modelName));
|
|
380
|
+
|
|
381
|
+
const acronyms = ['LLM', 'AI', 'MCP', 'IT', 'QC', 'HR', 'MR', 'WH', 'SSIS', 'API', 'URL', 'ID', 'JSON'];
|
|
382
|
+
for (const acronym of acronyms) {
|
|
383
|
+
if (modelName.startsWith(acronym)) {
|
|
384
|
+
variations.add(acronym.toLowerCase() + modelName.slice(acronym.length));
|
|
385
|
+
variations.add(acronym[0].toLowerCase() + acronym.slice(1) + modelName.slice(acronym.length));
|
|
386
|
+
variations.add(this.toSnakeCase(acronym.toLowerCase() + modelName.slice(acronym.length)));
|
|
387
|
+
}
|
|
388
|
+
}
|
|
389
|
+
|
|
390
|
+
return Array.from(variations);
|
|
391
|
+
}
|
|
392
|
+
|
|
393
|
+
private formatFields(model: Model): string {
|
|
394
|
+
if (model.fields.length === 0) return '[]';
|
|
395
|
+
|
|
396
|
+
const fields = model.fields.map(f => {
|
|
397
|
+
return ` { "name": "${f.name}", "type": "${f.type}${f.isOptional ? '?' : ''}", "sql": "${f.sqlType}", "isOptional": ${f.isOptional ? 'True' : 'False'}, "hasDefault": ${f.hasDefault ? 'True' : 'False'}, "isId": ${f.isId ? 'True' : 'False'}, "description": ${this.pyString(f.description)} }`;
|
|
398
|
+
});
|
|
399
|
+
|
|
400
|
+
return `[\n${fields.join(',\n')}\n ]`;
|
|
401
|
+
}
|
|
402
|
+
|
|
403
|
+
private pyString(value?: string): string {
|
|
404
|
+
return value ? JSON.stringify(value) : 'None';
|
|
405
|
+
}
|
|
406
|
+
|
|
407
|
+
private toCamelCase(str: string): string {
|
|
408
|
+
if (!str) return '';
|
|
409
|
+
return str[0].toLowerCase() + str.slice(1);
|
|
410
|
+
}
|
|
411
|
+
|
|
412
|
+
private toSnakeCase(str: string): string {
|
|
413
|
+
if (!str) return '';
|
|
414
|
+
return str
|
|
415
|
+
.replace(/([A-Z]+)([A-Z][a-z])/g, '$1_$2')
|
|
416
|
+
.replace(/([a-z\d])([A-Z])/g, '$1_$2')
|
|
417
|
+
.toLowerCase();
|
|
418
|
+
}
|
|
419
|
+
|
|
420
|
+
private capitalize(str: string): string {
|
|
421
|
+
if (!str) return '';
|
|
422
|
+
return str[0].toUpperCase() + str.slice(1);
|
|
423
|
+
}
|
|
424
|
+
}
|
package/generator/src/types.ts
CHANGED
|
@@ -1,29 +1,29 @@
|
|
|
1
|
-
export interface Field {
|
|
2
|
-
name: string;
|
|
3
|
-
type: string; // TypeScript type (string, number, boolean, Date, etc.)
|
|
4
|
-
sqlType: string; // SQL Server type (NVARCHAR(255), INT, DATETIME2, etc.)
|
|
5
|
-
isOptional: boolean;
|
|
6
|
-
hasDefault: boolean;
|
|
7
|
-
isId: boolean;
|
|
8
|
-
description?: string;
|
|
9
|
-
}
|
|
10
|
-
|
|
11
|
-
export interface Relation {
|
|
12
|
-
name: string;
|
|
13
|
-
type: string;
|
|
14
|
-
isArray: boolean;
|
|
15
|
-
isOptional: boolean;
|
|
16
|
-
foreignKey: string;
|
|
17
|
-
localKey: string;
|
|
18
|
-
relationName: string;
|
|
19
|
-
}
|
|
20
|
-
|
|
21
|
-
export interface Model {
|
|
22
|
-
name: string;
|
|
23
|
-
tableName: string;
|
|
24
|
-
schemaName: string;
|
|
25
|
-
fields: Field[];
|
|
26
|
-
relations: Relation[];
|
|
27
|
-
compoundUniques?: string[][];
|
|
28
|
-
description?: string;
|
|
29
|
-
}
|
|
1
|
+
export interface Field {
|
|
2
|
+
name: string;
|
|
3
|
+
type: string; // TypeScript type (string, number, boolean, Date, etc.)
|
|
4
|
+
sqlType: string; // SQL Server type (NVARCHAR(255), INT, DATETIME2, etc.)
|
|
5
|
+
isOptional: boolean;
|
|
6
|
+
hasDefault: boolean;
|
|
7
|
+
isId: boolean;
|
|
8
|
+
description?: string;
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
export interface Relation {
|
|
12
|
+
name: string;
|
|
13
|
+
type: string;
|
|
14
|
+
isArray: boolean;
|
|
15
|
+
isOptional: boolean;
|
|
16
|
+
foreignKey: string;
|
|
17
|
+
localKey: string;
|
|
18
|
+
relationName: string;
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
export interface Model {
|
|
22
|
+
name: string;
|
|
23
|
+
tableName: string;
|
|
24
|
+
schemaName: string;
|
|
25
|
+
fields: Field[];
|
|
26
|
+
relations: Relation[];
|
|
27
|
+
compoundUniques?: string[][];
|
|
28
|
+
description?: string;
|
|
29
|
+
}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@an5/orm",
|
|
3
|
-
"version": "1.0.
|
|
4
|
-
"description": "The lightweight ORM for SQL Server with support for TypeScript, Python,
|
|
3
|
+
"version": "1.0.9",
|
|
4
|
+
"description": "The lightweight ORM for SQL Server with support for TypeScript, Python, .NET (C#), and Go.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"main": "dist/index.js",
|
|
7
7
|
"types": "dist/index.d.ts",
|
|
@@ -17,6 +17,9 @@
|
|
|
17
17
|
"url": "https://github.com/an5ORM/an5Orm.git"
|
|
18
18
|
},
|
|
19
19
|
"scripts": {
|
|
20
|
+
"build": "tsc -p tsconfig.json",
|
|
21
|
+
"pretest": "npm run build",
|
|
22
|
+
"prepack": "npm run build",
|
|
20
23
|
"generate": "npx tsx generator/src/index.ts",
|
|
21
24
|
"db:push": "npx tsx push.ts",
|
|
22
25
|
"db:pull": "npx tsx pull.ts",
|
|
@@ -25,15 +28,18 @@
|
|
|
25
28
|
"db:migrate": "npx tsx migrate.ts",
|
|
26
29
|
"db:migrate:diff": "npx tsx migrate.ts diff",
|
|
27
30
|
"db:migrate:generate": "npx tsx migrate.ts generate",
|
|
31
|
+
"db:migrate:apply": "npx tsx migrate.ts apply",
|
|
32
|
+
"db:migrate:rollback": "npx tsx migrate.ts rollback",
|
|
28
33
|
"db:migrate:status": "npx tsx migrate.ts status",
|
|
29
34
|
"release:cli": "npx tsx scripts/release-cli.ts",
|
|
30
35
|
"release": "node scripts/release.js",
|
|
31
|
-
"test": "node test/smoke.test.js",
|
|
36
|
+
"test": "node test/smoke.test.js && node test/unit.test.js",
|
|
32
37
|
"test:unit": "node test/unit.test.js",
|
|
33
|
-
"test:generator": "npm run generate && node test/generator.test.js"
|
|
38
|
+
"test:generator": "npm run generate && node test/generator.test.js",
|
|
39
|
+
"test:integration:live": "node test/live-db.integration.test.js"
|
|
34
40
|
},
|
|
35
41
|
"dependencies": {
|
|
36
|
-
"@an5/adapters": "^0.2.
|
|
42
|
+
"@an5/adapters": "^0.2.6",
|
|
37
43
|
"bcryptjs": "^2.4.3",
|
|
38
44
|
"dotenv": "^16.4.5",
|
|
39
45
|
"mssql": "^12.5.5"
|
|
@@ -43,7 +49,7 @@
|
|
|
43
49
|
"@types/mssql": "^9.1.8",
|
|
44
50
|
"@types/node": "^20.19.43",
|
|
45
51
|
"tsx": "^4.7.1",
|
|
46
|
-
"typescript": "^
|
|
52
|
+
"typescript": "^7.0.2"
|
|
47
53
|
},
|
|
48
54
|
"publishConfig": {
|
|
49
55
|
"access": "public"
|