Metadata-Version: 2.5
Name: create-promptex-py
Version: 1.0.1
Summary: Scaffold a promptex Python project, plugin or adapter.
Project-URL: Homepage, https://github.com/promptex-ai/promptex
Project-URL: Repository, https://github.com/promptex-ai/promptex
Project-URL: Issues, https://github.com/promptex-ai/promptex/issues
Project-URL: Changelog, https://github.com/promptex-ai/promptex/blob/main/CHANGELOG.md
License-Expression: MIT OR Apache-2.0
License-File: LICENSE-APACHE
License-File: LICENSE-MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# create-promptex-py

Scaffold a [promptex](https://github.com/promptex-ai/promptex) Python project,
plugin or adapter from the
starter templates bundled with this package.

```console
uvx create-promptex-py
```

Interactive by default; every answer has a flag for non-interactive use:

```console
uvx create-promptex-py my-prompts --template project --name my-prompts --no-git --yes
```

| Flag | Meaning |
| :--- | :--- |
| `--template <t>` | `project`（消費專案）、`plugin`、`adapter` |
| `--name <n>` | kebab-case 名稱；預設取目標目錄名正規化 |
| `--source <p>` | 改讀本地模板目錄（含各 `*-starter` 的那一層），開發模板時用 |
| `--git` / `--no-git` | 是否 `git init`；互動預設是 |
| `--install` | 鷹架後直接 `uv sync`；預設只印下一步 |
| `--yes` | 跳過互動，全部取預設或旗標值 |
| `--locale <l>` | 訊息與範例資源的語系：`en`（預設）或 `zh-Hant` |

語系未以 `--locale` 指定時，依序讀 `PROMPTEX_LOCALE`、`LANGUAGE`、`LC_ALL`、
`LC_MESSAGES`、`LANG`，都沒有就用英文；`LC_ALL=C` 意為關掉在地化。`zh-TW`、
`zh-HK`、`zh-MO` 與 `zh-Hant-*` 都對到 `zh-Hant`。它同時決定鋪出來的範例資源
用哪個語系寫（[ADR-030](https://github.com/promptex-ai/ssot)）：那份內容從產出
當下起就歸你，框架不再改寫它。plugin 與 adapter 骨架裡教你怎麼填的註解維持英文。

目標目錄非空時列出既有項目、零寫入退出。模板隨本套件一起發布，
鷹架時不需要網路，每個版本具現化的都是它發布時的模板。`{{promptexVersion}}`
於鷹架當下以本套件版本填入，三套件與 SDK 同版發布。

`promptex init` 與本工具的分工：init 在既有專案就地補上 promptex（非互動、
極簡骨架）；本工具從零開一個 repo（互動、三種模板、git init）。
