Add Python Emitter Framework implementation

.chronus/changes/feature-ef-python-2025-11-19-1-26-8.md

@@ -0,0 +1,7 @@
+---
+changeKind: feature
+packages:
+  - "@typespec/emitter-framework"
+---
+
+Add Python Emitter Framework implementation

packages/emitter-framework/CHANGELOG.md

@@ -14,7 +14,6 @@ No changes, version bump only.
 
 - [#8823](https://github.com/microsoft/typespec/pull/8823) Upgrade dependencies
 
-
 ## 0.12.0
 
 ### Features
@@ -29,7 +28,6 @@ No changes, version bump only.
 
 - [#8474](https://github.com/microsoft/typespec/pull/8474) Remove development exports from published package
 
-
 ## 0.11.0
 
 ### Features
@@ -53,15 +51,13 @@ No changes, version bump only.
 - [#8302](https://github.com/microsoft/typespec/pull/8302) [c#] Avoid generating double '?' after property name when the property is nullable union and it's prop.optional is true in the meantime
 - [#8362](https://github.com/microsoft/typespec/pull/8362) Upgrade alloy to 0.20
 
-
 ## 0.10.0
 
 ### Bump dependencies
 
 - [#8050](https://github.com/microsoft/typespec/pull/8050) Upgrade alloy 0.19
 - [#7978](https://github.com/microsoft/typespec/pull/7978) Upgrade dependencies
 
-
 ## 0.9.0
 
 ### Features
@@ -79,7 +75,6 @@ No changes, version bump only.
 
 - [#7650](https://github.com/microsoft/typespec/pull/7650) Adds subpath export for csharp emitter-framework components
 
-
 ## 0.8.0
 
 ### Features
@@ -94,7 +89,6 @@ No changes, version bump only.
 
 - [#7369](https://github.com/microsoft/typespec/pull/7369) Render discriminated unions correctly
 
-
 ## 0.7.1
 
 ### Bump dependencies
@@ -105,21 +99,19 @@ No changes, version bump only.
 
 - [#7321](https://github.com/microsoft/typespec/pull/7321) Use wasm version of tree sitter for snippet extractor
 
-
 ## 0.7.0
 
 ### Bump dependencies
 
 - [#7186](https://github.com/microsoft/typespec/pull/7186) Upgrade to alloy 15
 
-
 ## 0.6.0
 
 ### Features
 
 - [#7017](https://github.com/microsoft/typespec/pull/7017) [TypeScript] Add various function-related components - FunctionType, FunctionExpression, ArrowFunction, and InterfaceMethod.
 - [#6972](https://github.com/microsoft/typespec/pull/6972) Add support for rendering a Value Expression
-- [#7018](https://github.com/microsoft/typespec/pull/7018) Adds the `TspContextProvider` and `useTsp()` hook for providing and accessing TypeSpec context and the Typekit APIs (e.g. `# Changelog - @typespec/emitter-framework). Adds a new `Output` component that accepts a TypeSpec `Program` and automatically wraps children components with the `TspContextProvider`.
+- [#7018](https://github.com/microsoft/typespec/pull/7018) Adds the `TspContextProvider` and `useTsp()` hook for providing and accessing TypeSpec context and the Typekit APIs (e.g. `# Changelog - @typespec/emitter-framework). Adds a new `Output`component that accepts a TypeSpec`Program`and automatically wraps children components with the`TspContextProvider`.
 
 ### Bump dependencies
 
@@ -129,21 +121,18 @@ No changes, version bump only.
 
 - [#6951](https://github.com/microsoft/typespec/pull/6951) InterfaceMember should use Alloy
 
-
 ## 0.5.0
 
 ### Features
 
 - [#6875](https://github.com/microsoft/typespec/pull/6875) Upgrade to alloy 0.10.0
 
-
 ## 0.4.0
 
 ### Bump dependencies
 
 - [#6595](https://github.com/microsoft/typespec/pull/6595) Upgrade dependencies
 
-
 ## 0.3.0
 
 ### Bump dependencies
@@ -155,12 +144,8 @@ No changes, version bump only.
 - [#6178](https://github.com/microsoft/typespec/pull/6178) Improvements on the TestHarness
 - [#6460](https://github.com/microsoft/typespec/pull/6460) Update dependency structure for EmitterFramework, HttpClient and JS Emitter
 
-
-
-
 ## 0.2.0
 
 ### Features
 
 - [#5996](https://github.com/microsoft/typespec/pull/5996) Adding Emitter Framework and Http Client packages
-

packages/emitter-framework/package.json

@@ -31,6 +31,9 @@
     "./typescript": {
       "import": "./dist/src/typescript/index.js"
     },
+    "./python": {
+      "import": "./dist/src/python/index.js"
+    },
     "./testing": {
       "import": "./dist/src/testing/index.js"
     }
@@ -48,6 +51,10 @@
     "#typescript/*": {
       "development": "./src/typescript/*",
       "default": "./dist/src/typescript/*"
+    },
+    "#python/*": {
+      "development": "./src/python/*",
+      "default": "./dist/src/python/*"
     }
   },
   "keywords": [],
@@ -57,12 +64,14 @@
   "peerDependencies": {
     "@alloy-js/core": "^0.22.0",
     "@alloy-js/csharp": "^0.22.0",
+    "@alloy-js/python": "^0.3.0",
     "@alloy-js/typescript": "^0.22.0",
     "@typespec/compiler": "workspace:^"
   },
   "devDependencies": {
     "@alloy-js/cli": "^0.22.0",
     "@alloy-js/core": "^0.22.0",
+    "@alloy-js/python": "^0.3.0",
     "@alloy-js/rollup-plugin": "^0.1.0",
     "@alloy-js/typescript": "^0.22.0",
     "@typespec/compiler": "workspace:^",

packages/emitter-framework/src/python/builtins.ts

@@ -0,0 +1,43 @@
+import type { SymbolCreator } from "@alloy-js/core";
+import { createModule } from "@alloy-js/python";
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+type dummy = SymbolCreator;
+
+export const abcModule = createModule({
+  name: "abc",
+  descriptor: {
+    ".": ["ABC"],
+  },
+});
+
+export const datetimeModule = createModule({
+  name: "datetime",
+  descriptor: {
+    ".": ["datetime", "date", "time", "timedelta", "timezone"],
+  },
+});
+
+export const decimalModule = createModule({
+  name: "decimal",
+  descriptor: {
+    ".": ["Decimal"],
+  },
+});
+
+export const typingModule = createModule({
+  name: "typing",
+  descriptor: {
+    ".": [
+      "Any",
+      "Callable",
+      "Generic",
+      "Literal",
+      "Never",
+      "Optional",
+      "Protocol",
+      "TypeAlias",
+      "TypeVar",
+    ],
+  },
+});

packages/emitter-framework/src/python/components/array-expression/array-expression.test.tsx

@@ -0,0 +1,14 @@
+import { Tester } from "#test/test-host.js";
+import { d } from "@alloy-js/core/testing";
+import { t } from "@typespec/compiler/testing";
+import { expect, it } from "vitest";
+import { getOutput } from "../../test-utils.js";
+import { TypeExpression } from "../type-expression/type-expression.js";
+
+it("maps array expression to Python list", async () => {
+  const { program, TestArray } = await Tester.compile(t.code`
+    alias ${t.type("TestArray")} = string[];
+  `);
+
+  expect(getOutput(program, [<TypeExpression type={TestArray} />])).toRenderTo(d`list[str]`);
+});

packages/emitter-framework/src/python/components/array-expression/array-expression.tsx

@@ -0,0 +1,11 @@
+import { code } from "@alloy-js/core";
+import type { Type } from "@typespec/compiler";
+import { TypeExpression } from "../type-expression/type-expression.js";
+
+export interface ArrayExpressionProps {
+  elementType: Type;
+}
+
+export function ArrayExpression({ elementType }: ArrayExpressionProps) {
+  return code`list[${(<TypeExpression type={elementType} />)}]`;
+}

packages/emitter-framework/src/python/components/array-expression/index.ts

@@ -0,0 +1 @@
+export * from "./array-expression.js";