Metadata-Version: 2.4
Name: esimu-core
Version: 0.4.0b2
Summary: Theme-driven core and project tooling for the esimu simulator framework.
Author: pirate-608
License-Expression: MIT
Project-URL: Homepage, https://esimu.67656.fun/
Project-URL: Documentation, https://esimu.67656.fun/
Project-URL: Repository, https://github.com/pirate-608/esimu
Project-URL: Issues, https://github.com/pirate-608/esimu/issues
Keywords: simulation,game,framework,theme-pack
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2
Provides-Extra: ai
Requires-Dist: openai>=1.12; extra == "ai"
Provides-Extra: dev
Requires-Dist: aiosqlite>=0.20; extra == "dev"
Requires-Dist: fastapi>=0.115; extra == "dev"
Requires-Dist: httpx2>=2.7; extra == "dev"
Requires-Dist: pytest>=8; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Requires-Dist: ruff==0.16.2; extra == "dev"
Dynamic: license-file

# esimu-core

`esimu-core` is the typed, I/O-independent core and project CLI for esimu.

```powershell
python -m pip install "esimu-core[ai]==0.4.0b2"
esimu version
esimu new D:\projects\my-simulator --theme-id my-simulator
esimu validate --root D:\projects\my-simulator --theme my-simulator
esimu doctor --root D:\projects\my-simulator --theme my-simulator
esimu inspect --root D:\projects\my-simulator --theme my-simulator
esimu sync --root D:\projects\my-simulator --theme my-simulator
esimu dev --root D:\projects\my-simulator --theme my-simulator
esimu reload --root D:\projects\my-simulator --theme my-simulator
esimu build --root D:\projects\my-simulator --theme my-simulator
```

`esimu new` defaults to the self-contained `zju-simplified` source theme. Pass
`--source-theme demo-campus` for the neutral template.

The base dependency is Pydantic. The optional `ai` extra adds the OpenAI SDK
transport. FastAPI, SQLite, WebSocket, and Vue live in the generated Starter,
not in the core package.

Core owns:

- theme and world-data contracts;
- stat, item, effect, semester, and lifecycle rules;
- runtime timing, state, payload, cooldown, and task helpers;
- neutral event, forum, and messenger content contracts;
- optional AI configuration, parsing, generation, and fallback policy;
- the self-contained `esimu new` scaffold bundle.
- installed diagnostics, metadata sync, and safe world-entry authoring commands.

See `https://esimu.67656.fun/` for the authoring and compatibility guides.
